{ "schemaVersion": 1, "revision": "47142a1a618af0ac75939457cf8596169e7bf622ca3101f114ef8a2179fb743e", "visibility": "public", "documents": [ { "id": "home", "owner": "BestBuds", "kind": "overview", "summary": "Design briefs, architecture, runtime modules, operations, and product docs for the Reaktor framework.", "use": "Read the private design or operating guide in its authenticated context.", "region": "start-here-core", "order": -1, "title": "Reaktor Documentation", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/home", "revision": "f18329900ca278b9339b6963a06c9765ea8e8d4838afc3b3a7ddf4d9d98d5f3b", "status": "unverified", "renderingRevision": "f1777bad0bad91eb0e4f5e59e7fa665c9b2a70bc3103b02ca69f7b8d4982e849", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "map", "rk-docs-graph", "featured", "paths", "start-here", "theory", "architecture-atlas", "engine-preprint", "data", "framework", "flexbuffers-ffi", "graph", "ship", "operations", "workbench", "agents", "products", "background" ], "externalLinks": [ "https://manna.ac/documentation" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/home", "polarity": "Neutral" }, { "id": "section-map", "anchor": "map", "label": "map", "profile": "section", "contract": "https://reaktor.build/docs/home#map", "polarity": "Neutral" }, { "id": "section-background", "anchor": "background", "label": "background", "profile": "section", "contract": "https://reaktor.build/docs/home#background", "polarity": "Neutral" } ], "relations": [ { "id": "home:references-documentation-library", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "documentation-library", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-framework-overview", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-desktop-master-plan", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-service", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-auth-analysis", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-flexbuffer-implementation", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-cloud-pane", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-unified-system-graph", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-formal-methods", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-conductor", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-essays", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-contributing", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "contributing", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-core", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-graph-kernel-analysis", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-reaktor-build-tools", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "home:references-documentation-audit", "kind": "references", "owner": "home", "incidences": [ { "node": "home", "port": "page", "role": "source", "ordinal": 0 }, { "node": "documentation-audit", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "home.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Documentation", "level": 0 } ], "links": [ { "id": "documentation-library", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "contributing", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "documentation-library", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "contributing", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "documentation-audit", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "documentation-graph-markers", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "" } ] }, { "id": "architecture-atlas-evolution", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: shadow, evidence and region releases. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "shadow", "src": "/docs/img/architecture-atlas/shadow.svg", "alt": "Shadow should answer a named counterfactual question", "text": "COUNTERFACTUAL EXECUTION • PIN WHAT CHANGES AND WHAT DOES NOT\nApproved base + workload + environment\nSame defined capture cut and nondeterminism\nschedule\nBaseline world\nGraph r10 + artifact A\nShadow-owned state authority\nExplicit real/recorded/simulated effects\nCandidate world\nGraph r11 + artifact B\nIsolated copy of the same approved base\nNo accidental production side effects\nContract assertions + controlled comparison\nChanged requirements are judged against acceptance—not blind byte equality.\nA trace is not automatically a replay journal. Suppression, capture loss and substitution ownership stay explicit.", "inspectors": [] }, { "id": "evidence", "src": "/docs/img/architecture-atlas/evidence.svg", "alt": "A claim chooses its evidence—not the other way around", "text": "VERIFICATION THEORY • EVIDENCE IS A MATRIX, NOT AN ORDINAL LADDER\nTypes\nBMC\nReplay\nProduction\nNo illegal schema value\nRelevant*\nNot inferred\nNot inferred\nNot inferred\nNo deadlock within bounds\nNot inferred\nRelevant*\nNot inferred\nNot inferred\nThis workload preserves outcomes\nNot inferred\nNot inferred\nRelevant*\nNot inferred\nObserved latency under load\nNot inferred\nNot inferred\nNot inferred\nRelevant*\n*Illustrative matches, not exclusions. Richer models and combined evidence can support additional claims.", "inspectors": [] }, { "id": "update-cut", "src": "/docs/img/architecture-atlas/update-cut.svg", "alt": "A selected subgraph expands only when compatibility requires it", "text": "Stable client boundary\nrequest : RankInput\nresult : RankedItems\nconsumer stays at v1\nEDITED REGION: matching.rank\nRank function v2\nChanged pure scoring logic\nSelected subgraph S\nShared feature schema\nInclude if format changes\nCoupled definition\nSession state / continuation\nInclude only if migration couples it\nOld writers require fencing\nInstalled native host\nNative ABI remains outside\nCompatible exports only\nNew native API → host build\nBoundary = every crossing incidence, including multiparty relations.\nClosure: C₀ = S; Cₙ₊₁ = Cₙ ∪ RequiredTogether(Cₙ)\nKeep stable external contracts as pinned imports. Widen for shared state, protocol evolution or indivisible compiled artifacts.\nA runtime cut may be larger than the selected canvas region. Semantic granularity is not necessarily download granularity.\nThe closure algorithm is driven by declared coupling/compatibility rules; ordinary dependency reachability alone is too broad.", "inspectors": [] }, { "id": "release", "src": "/docs/img/architecture-atlas/release.svg", "alt": "Signed region release: publish intent, then admit and activate per host", "text": "Package\nImmutable region bundle\nVerify\nShadow + independent gate\nPromote\nDurable desired revision\nStage\nDownload + host admission\nActivate\nSafe local root switch\nSigned RegionRelease\ndefinition + artifact digests\nboundary + dependency vector\ninstalled-host requirements\nstate schema + migrator\npolicy + evidence + rollout\nbase revision + publisher scope\nAdmission is conjunctive—not “the signature passed”\nTrusted bytes ∧ compatible host ∧ valid boundary ∧ current grants ∧ safe state plan\n∧ pinned dependencies ∧ fresh evidence ∧ allowed distribution policy\nOld activation: epoch 42\nExisting sessions stay pinned\nLeases / callbacks drain\nNo new writes after fencing\nNew activation: epoch 43\nPrepared before publication\nNew calls use one image\nState migration is explicit\none root\nAcross hosts: compatible release vector + recoverable reconciliation\nA phone can remain on the old version while a server is new. Bind sessions to compatible protocol versions.\nLost activation reply → retry operation identity and retrieve the receipt, not blindly perform the mutation again.\nRollback selects an older compatible artifact under a NEW authorized epoch; it cannot undo arbitrary external effects.\nIllustrative state machine only. Staging/activation require a qualified loader and do not bypass store or operating-system rules.", "inspectors": [] }, { "id": "host-matrix", "src": "/docs/img/architecture-atlas/host-matrix.svg", "alt": "Update classes depend on the installed host and distribution policy", "text": "Runtime host\nData / graph / script update\nNew native capability\nActivation contract\nBrowser\nVersioned modules/assets or a\nsupported interpreter\nHost/browser capability limits still\napply\nRefresh, worker replacement or qualified\nlive region\nReact Native host\nCompatible JS/assets; graph loader if\ninstalled\nNew native module → new app binary\nUsually host-defined restart/reload; region\nswap is extra work\nK/N / Compose host\nConfig/assets; installed graph VM\nwhere qualified\nNo assumed arbitrary native Kotlin\nOTA\nNew binary, or safe point in an installed\ninterpreter\nJVM / desktop host\nQualified loaders/processes or graph\nprograms\nNative library / ABI upgrades need\nhost handling\nResource/class compatibility; drain or\nprocess restart\nWorker / server\nNew immutable artifact, versioned\nrelease or loader\nRebuild/deploy to the host runtime\nprofile\nProvider deployment plus compatible session\nrollout\nUnity / Unreal host\nSupported data/script/plugin path\nonly\nNative engine/plugin change follows\nplatform build rules\nNew matches/instances first; engine state\nis separately owned\nTechnical loadability ≠ authorization ≠ distribution-policy permission\nDownloaded graph data or bytecode is not an App Store / Play policy loophole. Native capability sets do not expand by manifest request.\nThis matrix is a proposed qualification model, not a claim that all host loaders or live-update paths already exist.", "inspectors": [] } ], "region": "architecture-atlas-book", "order": 4, "title": "Shadow, evidence and region releases", "nav": "Shadow, evidence and region releases", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-evolution", "revision": "5634e817df860fa72b4918fcf69ffec6e2e6948f4858c9502de9b5084b716b6d", "status": "design", "renderingRevision": "c0184482283ae0c83a78ca27ae9ecd98d1598d703434ef6387fec52394f990d6", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-shadow", "panel-evidence", "panel-update-cut", "panel-release", "panel-host-matrix" ] } ], "anchors": [], "externalLinks": [ "https://www.foundationdb.org/files/fdb-paper.pdf", "https://docs.expo.dev/eas-update/runtime-versions/", "https://docs.expo.dev/eas-update/code-signing/", "https://docs.expo.dev/eas-update/rollouts/", "https://developer.apple.com/app-store/review/guidelines/", "https://support.google.com/googleplay/android-developer/answer/16559646?hl=en", "https://lamport.azurewebsites.net/tla/high-level-view.html", "https://docs.expo.dev/eas-update/how-it-works/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-evolution", "polarity": "Neutral" }, { "id": "section-11-shadow-claims-and-evidence", "anchor": "11-shadow-claims-and-evidence", "label": "11. Shadow, claims and evidence", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#11-shadow-claims-and-evidence", "polarity": "Neutral" }, { "id": "section-12-region-releases-and-subgraph-level-code-push", "anchor": "12-region-releases-and-subgraph-level-code-push", "label": "12. Region releases and subgraph-level code push", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#12-region-releases-and-subgraph-level-code-push", "polarity": "Neutral" }, { "id": "section-panel-shadow", "anchor": "panel-shadow", "label": "Shadow should answer a named counterfactual question", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#panel-shadow", "polarity": "Neutral" }, { "id": "section-panel-evidence", "anchor": "panel-evidence", "label": "A claim chooses its evidence—not the other way around", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#panel-evidence", "polarity": "Neutral" }, { "id": "section-panel-update-cut", "anchor": "panel-update-cut", "label": "Compatibility-closed region updates", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#panel-update-cut", "polarity": "Neutral" }, { "id": "section-panel-release", "anchor": "panel-release", "label": "Region release and activation", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#panel-release", "polarity": "Neutral" }, { "id": "section-cross-document-contract-obligations", "anchor": "cross-document-contract-obligations", "label": "Cross-document contract obligations", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#cross-document-contract-obligations", "polarity": "Neutral" }, { "id": "section-boundary--caveat", "anchor": "boundary--caveat", "label": "Boundary / caveat", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-evolution#boundary--caveat", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-evolution:references-architecture-atlas-foundations", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-architecture-atlas-vocabulary", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-architecture-atlas-semantics", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-architecture-atlas-language", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-architecture-atlas-workbench", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-architecture-atlas-scenarios", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-scenarios", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-architecture-atlas-qualification", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-shadow-foundations", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-11-shadow-claims-and-evidence", "role": "source", "ordinal": 0 }, { "node": "shadow-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-shadow-capture-replay", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-11-shadow-claims-and-evidence", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-shadow-verification", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-11-shadow-claims-and-evidence", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-operations-graph-evidence", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-11-shadow-claims-and-evidence", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-shadow-workspaces", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-11-shadow-claims-and-evidence", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-capability", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-formal-methods", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-surface-contracts-and-interaction", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-graph-protocol", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-work", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-ffi", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-conductor", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-cross-document-contract-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-evolution:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-evolution", "incidences": [ { "node": "architecture-atlas-evolution", "port": "section-boundary--caveat", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-evolution.json", "sections": [ { "id": "shadow-evidence-and-region-releases", "anchor": "shadow-evidence-and-region-releases", "title": "Shadow, evidence and region releases", "level": 1 }, { "id": "11-shadow-claims-and-evidence", "anchor": "11-shadow-claims-and-evidence", "title": "11. Shadow, claims and evidence", "level": 2 }, { "id": "cross-document-contract-obligations", "anchor": "cross-document-contract-obligations", "title": "Cross-document contract obligations", "level": 3 }, { "id": "12-region-releases-and-subgraph-level-code-push", "anchor": "12-region-releases-and-subgraph-level-code-push", "title": "12. Region releases and subgraph-level code push", "level": 2 }, { "id": "admission-and-activation", "anchor": "admission-and-activation", "title": "Admission and activation", "level": 3 }, { "id": "runtime-update-classes", "anchor": "runtime-update-classes", "title": "Runtime update classes", "level": 3 }, { "id": "panel-shadow", "anchor": "panel-shadow", "title": "Shadow should answer a named counterfactual question", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish", "anchor": "what-this-does-not-establish", "title": "What this does not establish", "level": 3 }, { "id": "panel-evidence", "anchor": "panel-evidence", "title": "A claim chooses its evidence—not the other way around", "level": 2 }, { "id": "reaktor-design-decision-1", "anchor": "reaktor-design-decision-1", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-1", "anchor": "what-this-does-not-establish-1", "title": "What this does not establish", "level": 3 }, { "id": "panel-update-cut", "anchor": "panel-update-cut", "title": "Compatibility-closed region updates", "level": 2 }, { "id": "reaktor-design-decision-2", "anchor": "reaktor-design-decision-2", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat", "anchor": "boundary--caveat", "title": "Boundary / caveat", "level": 3 }, { "id": "panel-release", "anchor": "panel-release", "title": "Region release and activation", "level": 2 }, { "id": "reaktor-design-decision-3", "anchor": "reaktor-design-decision-3", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-1", "anchor": "boundary--caveat-1", "title": "Boundary / caveat", "level": 3 }, { "id": "panel-host-matrix", "anchor": "panel-host-matrix", "title": "Runtime-specific update classes", "level": 2 }, { "id": "reaktor-design-decision-4", "anchor": "reaktor-design-decision-4", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-2", "anchor": "boundary--caveat-2", "title": "Boundary / caveat", "level": 3 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "11-shadow-claims-and-evidence" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "11-shadow-claims-and-evidence" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "11-shadow-claims-and-evidence" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "11-shadow-claims-and-evidence" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "11-shadow-claims-and-evidence" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "11-shadow-claims-and-evidence" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "cross-document-contract-obligations" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-1" } ] }, { "id": "architecture-atlas-foundations", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: architecture thesis and invariants. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "system", "src": "/docs/img/architecture-atlas/system.svg", "alt": "A common system language, not a universal runtime", "text": "AUTHORED MEANING • ONE OWNER PER REGION\nSource / Blueprint\nModule contributions\nBuild facts\nREVISIONED SEMANTIC AUTHORITY\nTyped port hypergraph\nIdentity + schemas + protocols\nRegions + effects + ownership\nQueries and legal changes\nMaps + analyses + patches\nScoped authority + obligations\nCLAIMS AND EVIDENCE\nShadow + qualification\nPinned candidate and assumptions\nNo universal “verified” state\nSPECIALIZED EXECUTION • NO GRAPH DATABASE LOOKUP REQUIRED ON EVERY CALL\nCompiled images\nDirect bindings; typed value paths\nQualified runtime profiles\nActors · streams · Work · native\nRealization and observation\nRelease vector; receipts; provenance\nIntegration is semantic accountability—not one global store, process, scheduler or universal representation.", "inspectors": [] }, { "id": "contracts", "src": "/docs/img/architecture-atlas/contracts.svg", "alt": "A reusable feature should expose what makes it safe", "text": "COMPOSITIONAL REASONING • REUSE TRANSFERS CONDITIONS, NOT MAGIC\nEnvironment assumptions\nA: authenticated principal\nB: serial state owner\nC: durable conditional commit\nComponent contract\nUnder A ∧ B ∧ C,\nguarantee one logical result.\nName the observation boundary.\nSystem obligation\nProve/bind assumptions\nor weaken the guarantee.\nAttach qualifying evidence.\nAn adapter must preserve the assumptions it relies on\nA local mutex is not a distributed compare-and-swap.\nA signed tenant label is not permission to every resource.\nCompositional verification works only when contracts, environment assumptions and refinement boundaries align.", "inspectors": [] }, { "id": "incidence", "src": "/docs/img/architecture-atlas/incidence.svg", "alt": "Store the relation once; preserve each participant’s role", "text": "GRAPH THEORY • ROLE-LABELLED INCIDENCES\nClient A\nsession port\nClient B\nsession port\nAuthority\nsession port\nObserver\nsession port\nH₁\nparticipant\nparticipant\nauthority\nobserver\nRELATIONAL STORAGE • SAME MEANING\nIncidence(h, port, role, ordinal)\nedge\nport\nrole\nH₁\nA.session\nparticipant\nH₁\nB.session\nparticipant\nH₁\nS.session\nauthority\nH₁\nO.session\nobserver\nOne authority; many participants.\nBinary connect() is a specialization.\nA hyperedge records a relationship. Delivery, scheduling and coordination are separate protocol laws.", "inspectors": [] }, { "id": "layers", "src": "/docs/img/architecture-atlas/layers.svg", "alt": "An edge’s meaning survives the map", "text": "MULTILAYER NETWORKS • DO NOT FLATTEN RELATION MEANING\nInvocation\nUI\nService\nStore\ncall\nwrite\nPlacement\nUI\nService\nStore\nsame device / runtime?\nAuthority\nUI\nService\nStore\nprincipal grant\ntenant grant\nShared identity across layers does not imply identical edges, reachability, timestamps or visibility.", "inspectors": [] } ], "region": "architecture-atlas-book", "order": 0, "title": "Architecture thesis and invariants", "nav": "Architecture thesis and invariants", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-foundations", "revision": "3f0a34a1c224d361628a02f5682929e295091a528a194b6ae98c804910a5d80b", "status": "design", "renderingRevision": "202c396e1d4229d6ec260eba99495c9d7b033468af65bde9234a2679d3cf7b64", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-system", "panel-ideas", "panel-contracts", "panel-incidence", "panel-layers" ] } ], "anchors": [], "externalLinks": [ "https://www.unison-lang.org/docs/the-big-idea/", "https://mlir.llvm.org/docs/Interfaces/", "https://ptolemy.berkeley.edu/ptolemyII/ptIIfaq.htm", "https://arxiv.org/abs/1502.00872", "https://fmi-standard.org/", "https://arxiv.org/abs/1307.6780", "https://lamport.azurewebsites.net/pubs/pubs.html", "https://kubernetes.io/docs/concepts/architecture/controller/", "https://www.cis.upenn.edu/~bcpierce/papers/lenses-toplas-final.pdf", "https://www.jetbrains.com/help/mps/mps-projectional-agent-toolkit.html", "https://ptolemy.berkeley.edu/publications/papers/95/processNets/", "https://dl.acm.org/doi/10.1145/2827695", "https://drops.dagstuhl.de/entities/document/10.4230/LIPIcs.ECOOP.2025.31", "https://docs.temporal.io/workflow-execution", "https://component-model.bytecodealliance.org/design/wit.html", "https://arrow.apache.org/docs/format/CDataInterface.html", "https://koka-lang.github.io/koka/doc/book.html", "https://mlir.llvm.org/docs/DialectConversion/", "https://www.sqlite.org/isolation.html", "https://www.postgresql.org/docs/current/transaction-iso.html", "https://www.foundationdb.org/files/fdb-paper.pdf", "https://arxiv.org/html/2003.06488v3", "https://arxiv.org/abs/1402.2237", "https://www.erlang.org/doc/system/release_handling.html", "https://www.microsoft.com/en-us/research/?p=163907", "https://www.microsoft.com/en-us/research/publication/build-systems-la-carte/", "https://lamport.azurewebsites.net/tla/high-level-view.html", "https://developer.android.com/develop/ui/compose/architecture", "https://dev.epicgames.com/documentation/en-us/unreal-engine/introduction-to-blueprints-visual-scripting-in-unreal-engine" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-foundations", "polarity": "Neutral" }, { "id": "section-1-architectural-thesis", "anchor": "1-architectural-thesis", "label": "1. Architectural thesis", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#1-architectural-thesis", "polarity": "Neutral" }, { "id": "section-2-core-ideas-and-invariants", "anchor": "2-core-ideas-and-invariants", "label": "2. Core ideas and invariants", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#2-core-ideas-and-invariants", "polarity": "Neutral" }, { "id": "section-3-semantic-kernel-and-graph-substrate", "anchor": "3-semantic-kernel-and-graph-substrate", "label": "3. Semantic kernel and graph substrate", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#3-semantic-kernel-and-graph-substrate", "polarity": "Neutral" }, { "id": "section-panel-system", "anchor": "panel-system", "label": "The graph is the system language", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#panel-system", "polarity": "Neutral" }, { "id": "section-panel-ideas", "anchor": "panel-ideas", "label": "Core ideas and invariants", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#panel-ideas", "polarity": "Neutral" }, { "id": "section-panel-contracts", "anchor": "panel-contracts", "label": "Reusable feature contracts", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#panel-contracts", "polarity": "Neutral" }, { "id": "section-1-one-semantic-identity-system", "anchor": "1-one-semantic-identity-system", "label": "1. One semantic identity system", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#1-one-semantic-identity-system", "polarity": "Neutral" }, { "id": "section-2-typed-role-labelled-port-hypergraph", "anchor": "2-typed-role-labelled-port-hypergraph", "label": "2. Typed, role-labelled port hypergraph", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#2-typed-role-labelled-port-hypergraph", "polarity": "Neutral" }, { "id": "section-4-orthogonal-facets-and-semantic-layers", "anchor": "4-orthogonal-facets-and-semantic-layers", "label": "4. Orthogonal facets and semantic layers", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#4-orthogonal-facets-and-semantic-layers", "polarity": "Neutral" }, { "id": "section-5-definitions-are-not-activations-or-observations", "anchor": "5-definitions-are-not-activations-or-observations", "label": "5. Definitions are not activations or observations", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#5-definitions-are-not-activations-or-observations", "polarity": "Neutral" }, { "id": "section-6-source-and-visual-projections-share-edit-authority", "anchor": "6-source-and-visual-projections-share-edit-authority", "label": "6. Source and visual projections share edit authority", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#6-source-and-visual-projections-share-edit-authority", "polarity": "Neutral" }, { "id": "section-7-general-computation-with-qualified-execution-profiles", "anchor": "7-general-computation-with-qualified-execution-profiles", "label": "7. General computation with qualified execution profiles", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#7-general-computation-with-qualified-execution-profiles", "polarity": "Neutral" }, { "id": "section-8-protocols-not-only-payload-types", "anchor": "8-protocols-not-only-payload-types", "label": "8. Protocols, not only payload types", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#8-protocols-not-only-payload-types", "polarity": "Neutral" }, { "id": "section-9-explicit-state-lifetime-and-resource-ownership", "anchor": "9-explicit-state-lifetime-and-resource-ownership", "label": "9. Explicit state, lifetime and resource ownership", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#9-explicit-state-lifetime-and-resource-ownership", "polarity": "Neutral" }, { "id": "section-10-effects-and-authority-are-different-contracts", "anchor": "10-effects-and-authority-are-different-contracts", "label": "10. Effects and authority are different contracts", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#10-effects-and-authority-are-different-contracts", "polarity": "Neutral" }, { "id": "section-11-adaptive-capability-selection", "anchor": "11-adaptive-capability-selection", "label": "11. Adaptive capability selection", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#11-adaptive-capability-selection", "polarity": "Neutral" }, { "id": "section-13-one-interop-contract-several-physical-paths", "anchor": "13-one-interop-contract-several-physical-paths", "label": "13. One interop contract, several physical paths", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#13-one-interop-contract-several-physical-paths", "polarity": "Neutral" }, { "id": "section-14-transactional-system-definitions", "anchor": "14-transactional-system-definitions", "label": "14. Transactional system definitions", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#14-transactional-system-definitions", "polarity": "Neutral" }, { "id": "section-17-deployment-is-recoverable-realization", "anchor": "17-deployment-is-recoverable-realization", "label": "17. Deployment is recoverable realization", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#17-deployment-is-recoverable-realization", "polarity": "Neutral" }, { "id": "section-18-incremental-queries-and-transformations", "anchor": "18-incremental-queries-and-transformations", "label": "18. Incremental queries and transformations", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#18-incremental-queries-and-transformations", "polarity": "Neutral" }, { "id": "section-19-shadow-executes-controlled-counterfactuals", "anchor": "19-shadow-executes-controlled-counterfactuals", "label": "19. Shadow executes controlled counterfactuals", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#19-shadow-executes-controlled-counterfactuals", "polarity": "Neutral" }, { "id": "section-21-maps-make-one-model-legible", "anchor": "21-maps-make-one-model-legible", "label": "21. Maps make one model legible", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#21-maps-make-one-model-legible", "polarity": "Neutral" }, { "id": "section-22-human-and-agent-actions-share-commands", "anchor": "22-human-and-agent-actions-share-commands", "label": "22. Human and agent actions share commands", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#22-human-and-agent-actions-share-commands", "polarity": "Neutral" }, { "id": "section-23-interaction-semantics-are-portable-rendering-remains-specialized", "anchor": "23-interaction-semantics-are-portable-rendering-remains-specialized", "label": "23. Interaction semantics are portable, rendering remains specialized", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#23-interaction-semantics-are-portable-rendering-remains-specialized", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-1", "anchor": "what-this-does-not-establish-1", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-foundations#what-this-does-not-establish-1", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-foundations:references-architecture-atlas-vocabulary", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-architecture-atlas-semantics", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-architecture-atlas-language", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-architecture-atlas-evolution", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-architecture-atlas-workbench", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-architecture-atlas-scenarios", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-scenarios", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-architecture-atlas-qualification", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-unified-system-graph", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-1-architectural-thesis", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-1-architectural-thesis", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-ffi", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-1-architectural-thesis", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-shadow-workspaces", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-1-architectural-thesis", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-graph-sources", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-1-one-semantic-identity-system", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-2-typed-role-labelled-port-hypergraph", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-data-graph", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-2-typed-role-labelled-port-hypergraph", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-module-execution-plan", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-4-orthogonal-facets-and-semantic-layers", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-operations-graph-evidence", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-5-definitions-are-not-activations-or-observations", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-6-source-and-visual-projections-share-edit-authority", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-actor-model", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-7-general-computation-with-qualified-execution-profiles", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-service", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-8-protocols-not-only-payload-types", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-graph-protocol", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-8-protocols-not-only-payload-types", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-component-lifecycle", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-9-explicit-state-lifetime-and-resource-ownership", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-formal-methods", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-10-effects-and-authority-are-different-contracts", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-auth-analysis", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-10-effects-and-authority-are-different-contracts", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-capability", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-11-adaptive-capability-selection", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-13-one-interop-contract-several-physical-paths", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-14-transactional-system-definitions", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-data-transactions", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-14-transactional-system-definitions", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-devops", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-17-deployment-is-recoverable-realization", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor_graph_visitors_design", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-18-incremental-queries-and-transformations", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-shadow-foundations", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-19-shadow-executes-controlled-counterfactuals", "role": "source", "ordinal": 0 }, { "node": "shadow-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-shadow-capture-replay", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-19-shadow-executes-controlled-counterfactuals", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-shadow-verification", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-19-shadow-executes-controlled-counterfactuals", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-workbench-layers", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-21-maps-make-one-model-legible", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-conductor", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-22-human-and-agent-actions-share-commands", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-surface-contracts-and-interaction", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-23-interaction-semantics-are-portable-rendering-remains-specialized", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-surface-dynamic-ui-and-verification", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-23-interaction-semantics-are-portable-rendering-remains-specialized", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-surface-renderers", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-23-interaction-semantics-are-portable-rendering-remains-specialized", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-core", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-3-semantic-kernel-and-graph-substrate", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-build-tools", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-3-semantic-kernel-and-graph-substrate", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-foundations:references-reaktor-multitenancy", "kind": "references", "owner": "architecture-atlas-foundations", "incidences": [ { "node": "architecture-atlas-foundations", "port": "section-what-this-does-not-establish-1", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-foundations.json", "sections": [ { "id": "architecture-thesis-and-invariants", "anchor": "architecture-thesis-and-invariants", "title": "Architecture thesis and invariants", "level": 1 }, { "id": "1-architectural-thesis", "anchor": "1-architectural-thesis", "title": "1. Architectural thesis", "level": 2 }, { "id": "2-core-ideas-and-invariants", "anchor": "2-core-ideas-and-invariants", "title": "2. Core ideas and invariants", "level": 2 }, { "id": "1-one-semantic-identity-system", "anchor": "1-one-semantic-identity-system", "title": "1. One semantic identity system", "level": 3 }, { "id": "2-typed-role-labelled-port-hypergraph", "anchor": "2-typed-role-labelled-port-hypergraph", "title": "2. Typed, role-labelled port hypergraph", "level": 3 }, { "id": "3-open-hierarchical-regions", "anchor": "3-open-hierarchical-regions", "title": "3. Open hierarchical regions", "level": 3 }, { "id": "4-orthogonal-facets-and-semantic-layers", "anchor": "4-orthogonal-facets-and-semantic-layers", "title": "4. Orthogonal facets and semantic layers", "level": 3 }, { "id": "5-definitions-are-not-activations-or-observations", "anchor": "5-definitions-are-not-activations-or-observations", "title": "5. Definitions are not activations or observations", "level": 3 }, { "id": "6-source-and-visual-projections-share-edit-authority", "anchor": "6-source-and-visual-projections-share-edit-authority", "title": "6. Source and visual projections share edit authority", "level": 3 }, { "id": "7-general-computation-with-qualified-execution-profiles", "anchor": "7-general-computation-with-qualified-execution-profiles", "title": "7. General computation with qualified execution profiles", "level": 3 }, { "id": "8-protocols-not-only-payload-types", "anchor": "8-protocols-not-only-payload-types", "title": "8. Protocols, not only payload types", "level": 3 }, { "id": "9-explicit-state-lifetime-and-resource-ownership", "anchor": "9-explicit-state-lifetime-and-resource-ownership", "title": "9. Explicit state, lifetime and resource ownership", "level": 3 }, { "id": "10-effects-and-authority-are-different-contracts", "anchor": "10-effects-and-authority-are-different-contracts", "title": "10. Effects and authority are different contracts", "level": 3 }, { "id": "11-adaptive-capability-selection", "anchor": "11-adaptive-capability-selection", "title": "11. Adaptive capability selection", "level": 3 }, { "id": "12-multiple-backends-preserve-one-contract", "anchor": "12-multiple-backends-preserve-one-contract", "title": "12. Multiple backends preserve one contract", "level": 3 }, { "id": "13-one-interop-contract-several-physical-paths", "anchor": "13-one-interop-contract-several-physical-paths", "title": "13. One interop contract, several physical paths", "level": 3 }, { "id": "14-transactional-system-definitions", "anchor": "14-transactional-system-definitions", "title": "14. Transactional system definitions", "level": 3 }, { "id": "15-legal-rewrites-carry-obligations", "anchor": "15-legal-rewrites-carry-obligations", "title": "15. Legal rewrites carry obligations", "level": 3 }, { "id": "16-coordination-follows-invariants", "anchor": "16-coordination-follows-invariants", "title": "16. Coordination follows invariants", "level": 3 }, { "id": "17-deployment-is-recoverable-realization", "anchor": "17-deployment-is-recoverable-realization", "title": "17. Deployment is recoverable realization", "level": 3 }, { "id": "18-incremental-queries-and-transformations", "anchor": "18-incremental-queries-and-transformations", "title": "18. Incremental queries and transformations", "level": 3 }, { "id": "19-shadow-executes-controlled-counterfactuals", "anchor": "19-shadow-executes-controlled-counterfactuals", "title": "19. Shadow executes controlled counterfactuals", "level": 3 }, { "id": "20-claim-indexed-evidence-not-a-global-green-check", "anchor": "20-claim-indexed-evidence-not-a-global-green-check", "title": "20. Claim-indexed evidence, not a global green check", "level": 3 }, { "id": "21-maps-make-one-model-legible", "anchor": "21-maps-make-one-model-legible", "title": "21. Maps make one model legible", "level": 3 }, { "id": "22-human-and-agent-actions-share-commands", "anchor": "22-human-and-agent-actions-share-commands", "title": "22. Human and agent actions share commands", "level": 3 }, { "id": "23-interaction-semantics-are-portable-rendering-remains-specialized", "anchor": "23-interaction-semantics-are-portable-rendering-remains-specialized", "title": "23. Interaction semantics are portable, rendering remains specialized", "level": 3 }, { "id": "24-reusable-features-include-operational-obligations", "anchor": "24-reusable-features-include-operational-obligations", "title": "24. Reusable features include operational obligations", "level": 3 }, { "id": "25-privacy-and-trust-survive-inspection-and-replay", "anchor": "25-privacy-and-trust-survive-inspection-and-replay", "title": "25. Privacy and trust survive inspection and replay", "level": 3 }, { "id": "26-adoption-and-qualification-are-part-of-the-architecture", "anchor": "26-adoption-and-qualification-are-part-of-the-architecture", "title": "26. Adoption and qualification are part of the architecture", "level": 3 }, { "id": "3-semantic-kernel-and-graph-substrate", "anchor": "3-semantic-kernel-and-graph-substrate", "title": "3. Semantic kernel and graph substrate", "level": 2 }, { "id": "open-world-node-port-and-relation-grammar", "anchor": "open-world-node-port-and-relation-grammar", "title": "Open-world node, port and relation grammar", "level": 3 }, { "id": "panel-system", "anchor": "panel-system", "title": "The graph is the system language", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish", "anchor": "what-this-does-not-establish", "title": "What this does not establish", "level": 3 }, { "id": "panel-ideas", "anchor": "panel-ideas", "title": "Core ideas and invariants", "level": 2 }, { "id": "panel-contracts", "anchor": "panel-contracts", "title": "Reusable feature contracts", "level": 2 }, { "id": "reaktor-design-decision-1", "anchor": "reaktor-design-decision-1", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-1", "anchor": "what-this-does-not-establish-1", "title": "What this does not establish", "level": 3 }, { "id": "panel-incidence", "anchor": "panel-incidence", "title": "Store the relation once; preserve each participant’s role", "level": 2 }, { "id": "reaktor-design-decision-2", "anchor": "reaktor-design-decision-2", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-2", "anchor": "what-this-does-not-establish-2", "title": "What this does not establish", "level": 3 }, { "id": "panel-layers", "anchor": "panel-layers", "title": "An edge’s meaning survives the map", "level": 2 }, { "id": "reaktor-design-decision-3", "anchor": "reaktor-design-decision-3", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-3", "anchor": "what-this-does-not-establish-3", "title": "What this does not establish", "level": 3 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "1-architectural-thesis" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "1-architectural-thesis" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "1-architectural-thesis" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "1-architectural-thesis" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "1-one-semantic-identity-system" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "1-one-semantic-identity-system" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "2-typed-role-labelled-port-hypergraph" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "2-typed-role-labelled-port-hypergraph" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "3-open-hierarchical-regions" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "4-orthogonal-facets-and-semantic-layers" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "5-definitions-are-not-activations-or-observations" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "5-definitions-are-not-activations-or-observations" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "6-source-and-visual-projections-share-edit-authority" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "6-source-and-visual-projections-share-edit-authority" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "7-general-computation-with-qualified-execution-profiles" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "7-general-computation-with-qualified-execution-profiles" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "8-protocols-not-only-payload-types" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "8-protocols-not-only-payload-types" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "9-explicit-state-lifetime-and-resource-ownership" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "9-explicit-state-lifetime-and-resource-ownership" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "9-explicit-state-lifetime-and-resource-ownership" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "10-effects-and-authority-are-different-contracts" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "10-effects-and-authority-are-different-contracts" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "11-adaptive-capability-selection" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "11-adaptive-capability-selection" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "12-multiple-backends-preserve-one-contract" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "13-one-interop-contract-several-physical-paths" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "13-one-interop-contract-several-physical-paths" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "14-transactional-system-definitions" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "14-transactional-system-definitions" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "15-legal-rewrites-carry-obligations" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "15-legal-rewrites-carry-obligations" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "16-coordination-follows-invariants" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "17-deployment-is-recoverable-realization" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "17-deployment-is-recoverable-realization" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "18-incremental-queries-and-transformations" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "18-incremental-queries-and-transformations" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "19-shadow-executes-controlled-counterfactuals" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "19-shadow-executes-controlled-counterfactuals" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "19-shadow-executes-controlled-counterfactuals" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "20-claim-indexed-evidence-not-a-global-green-check" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "20-claim-indexed-evidence-not-a-global-green-check" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "21-maps-make-one-model-legible" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "21-maps-make-one-model-legible" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "22-human-and-agent-actions-share-commands" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "22-human-and-agent-actions-share-commands" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "22-human-and-agent-actions-share-commands" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "23-interaction-semantics-are-portable-rendering-remains-specialized" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "23-interaction-semantics-are-portable-rendering-remains-specialized" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "23-interaction-semantics-are-portable-rendering-remains-specialized" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "24-reusable-features-include-operational-obligations" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "24-reusable-features-include-operational-obligations" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "25-privacy-and-trust-survive-inspection-and-replay" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "25-privacy-and-trust-survive-inspection-and-replay" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "25-privacy-and-trust-survive-inspection-and-replay" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "26-adoption-and-qualification-are-part-of-the-architecture" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "26-adoption-and-qualification-are-part-of-the-architecture" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "3-semantic-kernel-and-graph-substrate" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "3-semantic-kernel-and-graph-substrate" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "3-semantic-kernel-and-graph-substrate" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "3-semantic-kernel-and-graph-substrate" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "3-semantic-kernel-and-graph-substrate" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "3-semantic-kernel-and-graph-substrate" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "open-world-node-port-and-relation-grammar" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "panel-ideas" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-2" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-2" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-2" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" } ] }, { "id": "architecture-atlas-language", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: compiler, source publication and consistency. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "language", "src": "/docs/img/architecture-atlas/language.svg", "alt": "Compile a feature into a Reaktor distributed program bundle", "text": "Blueprint source / typed region\nfeature Checkout {\nsurface : CheckoutView\nbehavior : CheckoutStatechart\ncommand : PlaceOrder\nwork : CheckoutSaga\nauthority : OrderStore\nports : Payment, Inventory\neffect : Charge, Reserve\ntarget : Client + Core\nupdate : CompatibleRegion\n}\nIllustrative syntax, not a shipped API.\nElaborate one semantic graph\nTypes • roles • effects • ownership\nStatecharts, functions, resources\nValidate + partition + lower\nLegal profiles and host requirements\nRuntime cuts / durable boundaries\nStable IDs ↔ source maps\nProgramBundle\nGraph revision + region definitions\nPer-runtime code / interpreted plans\nService + Switchboard descriptors\nSchemas + artifact/dependency vector\nPlacement + grants + durable intent\nVerification and migration obligations\nClient region\nSurface plan + compatible logic\nNative capabilities already installed\nService region\nJVM / Worker artifact\nCommand + effect boundary\nState / Work region\nStore schema + workflow definition\nDurability and ownership profiles\nA distributed-system target, not a distributed interpreter\nDefinitions describe composition; execution runs on qualified local hosts and communicates through explicit protocols.\nGraph transactions publish desired meaning. Realization performs recoverable deployment effects.\nFlexBuffers handles structured interchange; direct calls and leased buffers retain specialized fast paths.\nA graph-owned program can generate Kotlin/JS/C++ adapters without making generated source a second edit authority.", "inspectors": [] }, { "id": "compiler", "src": "/docs/img/architecture-atlas/compiler.svg", "alt": "Lowering is an obligation to preserve meaning", "text": "COMPILER THEORY • A COMMUTING SEMANTIC SQUARE\nGraph behavior region\nTyped control + values + effects\nReference semantics\nTarget execution image\nJVM / JS / native / Wasm\nQualified lowering\nSpecified observable behavior\nChosen profile and environment\nIncludes allowed failures\nObserved target behavior\nCompare the same observations\nRetain source / graph identity\ncompile\ninterpret\nexecute\nrequired refinement relation\nThe two routes must agree under the declared observation model. Timing and failures may require refinement, not equality.", "inspectors": [] }, { "id": "incremental", "src": "/docs/img/architecture-atlas/incremental.svg", "alt": "One dependency system can serve many tools", "text": "INCREMENTAL COMPUTATION • INVALIDATE BY DEPENDENCY, INCLUDING ABSENCE\nPort contract changes\nNew field or protocol rule\nGenerated bindings\nDepends on this contract\nCompatibility query\nDepends on this contract\nVerification claim\nDepends on this contract\nUnrelated theme\nRetain cached result\nA cached “no provider exists” query depends on a predicate over membership—not just the rows it previously returned.", "inspectors": [] }, { "id": "capabilities", "src": "/docs/img/architecture-atlas/capabilities.svg", "alt": "Portability should adapt without hiding degradation", "text": "ADAPTATION • FILTER ELIGIBLE OFFERS BEFORE RANKING\nOn-device model\nData stays local\nLower capability; available\noffline\nCloud model\nPotentially higher quality\nRequires network + data\npermission\nUnavailable accelerator\nFast when hardware exists\nNot available on this host\nDecision: choose local\nPrivate-input constraint rules out the cloud offer.\nPrefer among eligible choices; keep the active session stable.\nFeature availability, provider offer, permission grant, policy verdict and actual effect are different typed facts.", "inspectors": [] }, { "id": "placement", "src": "/docs/img/architecture-atlas/placement.svg", "alt": "Placement is constrained graph partitioning", "text": "PARTITIONING • HARD CONSTRAINTS BEFORE CUT COST\nDEVICE\nEDGE\nCORE\nCamera frames\nPrivate input; native lease\nSession router\nAllowed compact events\nModel / storage\nEligible only for permitted data\nLocal inference\nQualified fallback\nmetadata\nevents\nREJECT: raw private frames cross the boundary\nOptimize weighted traffic/latency only over feasible placements. Min-cut alone cannot satisfy every system constraint.", "inspectors": [] }, { "id": "source", "src": "/docs/img/architecture-atlas/source.svg", "alt": "A lens explains round trips; it does not create cross-store ACID", "text": "BIDIRECTIONAL TRANSFORMATION • A DECLARED SUPPORTED SUBSET\nSource-owned region\nHuman source is authoritative.\nExtraction preserves identity/provenance.\nGraph projection\nStructured view and legal proposals.\nNo second independent authoring truth.\nget / extract\nput / supported edit\nPUBLICATION ACROSS AUTHORITIES • STAGE AND RECOVER\nStage source\nPin source revision\nBuild candidate\nPin artifact digest\nPromote graph\nCompare expected base\nReconcile\nRecover partial steps\nget(put(s,v)) = v and put(s,get(s)) ≈ s apply only where supported; do not promise lossless editing of arbitrary foreign code.", "inspectors": [] }, { "id": "mvcc", "src": "/docs/img/architecture-atlas/mvcc.svg", "alt": "A graph transaction protects invariants, not just records", "text": "DATABASE THEORY • DISJOINT WRITES CAN STILL VIOLATE ONE INVARIANT\nBase r10: exclusive consumer P has no provider\nInvariant: count(bindings(P)) ≤ 1. Both candidates read the same absence predicate.\nCandidate A\nRead: no binding for P\nWrite: edge(P, provider A)\nCandidate B\nRead: no binding for P\nWrite: edge(P, provider B)\nCommit A: r10 → r11\nSucceeds at one serialization point\nCommit B: expected r10\nREJECT: current head is r11\nChecking only common written records would miss the exclusive-binding violation. Whole-head CAS is conservative and safe.", "inspectors": [] }, { "id": "causal", "src": "/docs/img/architecture-atlas/causal.svg", "alt": "One global graph does not imply one global instant", "text": "DISTRIBUTED SYSTEMS • A SNAPSHOT CUT MUST RESPECT CAUSALITY\nRuntime A\nRuntime B\na₁\nsend\na₃\nb₁\nreceive\nb₃\nmessage\nBAD CUT: includes receive but excludes its send\nChoose an admissible causal cut or report a revision vector with incomplete consistency guarantees—not fictional global now.", "inspectors": [] } ], "region": "architecture-atlas-book", "order": 3, "title": "Compiler, source publication and consistency", "nav": "Compiler, source publication and consistency", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-language", "revision": "7a372d3bd6f1c196e61466c544c224b4c485f4bba39efa16da1f3ab1e0bfc279", "status": "design", "renderingRevision": "464dd6e83819a44c761345b491801b23eff209e002eaa3bfd01e88d6d27c6afb", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-language", "panel-compiler", "panel-incremental", "panel-capabilities", "panel-placement", "panel-source", "panel-mvcc", "panel-causal" ] } ], "anchors": [], "externalLinks": [ "https://mlir.llvm.org/docs/Interfaces/", "https://mlir.llvm.org/docs/DialectConversion/", "https://koka-lang.github.io/koka/doc/book.html", "https://www.microsoft.com/en-us/research/?p=163907", "https://www.microsoft.com/en-us/research/publication/build-systems-la-carte/", "https://www.sqlite.org/isolation.html", "https://www.postgresql.org/docs/current/transaction-iso.html", "https://arxiv.org/abs/1402.2237", "https://kubernetes.io/docs/concepts/architecture/controller/", "https://www.erlang.org/doc/system/release_handling.html", "https://arxiv.org/abs/1803.05316", "https://www.cis.upenn.edu/~bcpierce/papers/lenses-toplas-final.pdf", "https://lamport.azurewebsites.net/pubs/pubs.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-language", "polarity": "Neutral" }, { "id": "section-9-compiler-incremental-analysis-and-runtime-lowering", "anchor": "9-compiler-incremental-analysis-and-runtime-lowering", "label": "9. Compiler, incremental analysis and runtime lowering", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#9-compiler-incremental-analysis-and-runtime-lowering", "polarity": "Neutral" }, { "id": "section-10-transactions-and-distributed-consistency", "anchor": "10-transactions-and-distributed-consistency", "label": "10. Transactions and distributed consistency", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#10-transactions-and-distributed-consistency", "polarity": "Neutral" }, { "id": "section-panel-language", "anchor": "panel-language", "label": "Blueprint as a distributed-system language", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#panel-language", "polarity": "Neutral" }, { "id": "section-panel-compiler", "anchor": "panel-compiler", "label": "Lowering is an obligation to preserve meaning", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#panel-compiler", "polarity": "Neutral" }, { "id": "section-panel-incremental", "anchor": "panel-incremental", "label": "One dependency system can serve many tools", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#panel-incremental", "polarity": "Neutral" }, { "id": "section-panel-capabilities", "anchor": "panel-capabilities", "label": "Portability should adapt without hiding degradation", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#panel-capabilities", "polarity": "Neutral" }, { "id": "section-boundary--caveat", "anchor": "boundary--caveat", "label": "Boundary / caveat", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#boundary--caveat", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish", "anchor": "what-this-does-not-establish", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#what-this-does-not-establish", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-1", "anchor": "what-this-does-not-establish-1", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#what-this-does-not-establish-1", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-2", "anchor": "what-this-does-not-establish-2", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#what-this-does-not-establish-2", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-3", "anchor": "what-this-does-not-establish-3", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#what-this-does-not-establish-3", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-4", "anchor": "what-this-does-not-establish-4", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#what-this-does-not-establish-4", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-6", "anchor": "what-this-does-not-establish-6", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-language#what-this-does-not-establish-6", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-language:references-architecture-atlas-foundations", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-architecture-atlas-vocabulary", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-architecture-atlas-semantics", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-architecture-atlas-evolution", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-architecture-atlas-workbench", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-architecture-atlas-scenarios", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-scenarios", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-architecture-atlas-qualification", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-ffi", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-9-compiler-incremental-analysis-and-runtime-lowering", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-work", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-10-transactions-and-distributed-consistency", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-10-transactions-and-distributed-consistency", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-10-transactions-and-distributed-consistency", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-data-transactions", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-10-transactions-and-distributed-consistency", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-boundary--caveat", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-unified-system-graph", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-boundary--caveat", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-formal-methods", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-module-execution-plan", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-1", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor_graph_visitors_design", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-1", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-capability", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-2", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-2", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-db", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-mesh", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-graph-sources", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-4", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-reaktor-devops", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-4", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-shadow-workspaces", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-6", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-language:references-operations-graph-evidence", "kind": "references", "owner": "architecture-atlas-language", "incidences": [ { "node": "architecture-atlas-language", "port": "section-what-this-does-not-establish-6", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-language.json", "sections": [ { "id": "compiler-source-publication-and-consistency", "anchor": "compiler-source-publication-and-consistency", "title": "Compiler, source publication and consistency", "level": 1 }, { "id": "9-compiler-incremental-analysis-and-runtime-lowering", "anchor": "9-compiler-incremental-analysis-and-runtime-lowering", "title": "9. Compiler, incremental analysis and runtime lowering", "level": 2 }, { "id": "10-transactions-and-distributed-consistency", "anchor": "10-transactions-and-distributed-consistency", "title": "10. Transactions and distributed consistency", "level": 2 }, { "id": "panel-language", "anchor": "panel-language", "title": "Blueprint as a distributed-system language", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat", "anchor": "boundary--caveat", "title": "Boundary / caveat", "level": 3 }, { "id": "panel-compiler", "anchor": "panel-compiler", "title": "Lowering is an obligation to preserve meaning", "level": 2 }, { "id": "reaktor-design-decision-1", "anchor": "reaktor-design-decision-1", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish", "anchor": "what-this-does-not-establish", "title": "What this does not establish", "level": 3 }, { "id": "panel-incremental", "anchor": "panel-incremental", "title": "One dependency system can serve many tools", "level": 2 }, { "id": "reaktor-design-decision-2", "anchor": "reaktor-design-decision-2", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-1", "anchor": "what-this-does-not-establish-1", "title": "What this does not establish", "level": 3 }, { "id": "panel-capabilities", "anchor": "panel-capabilities", "title": "Portability should adapt without hiding degradation", "level": 2 }, { "id": "reaktor-design-decision-3", "anchor": "reaktor-design-decision-3", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-2", "anchor": "what-this-does-not-establish-2", "title": "What this does not establish", "level": 3 }, { "id": "panel-placement", "anchor": "panel-placement", "title": "Placement is constrained graph partitioning", "level": 2 }, { "id": "reaktor-design-decision-4", "anchor": "reaktor-design-decision-4", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-3", "anchor": "what-this-does-not-establish-3", "title": "What this does not establish", "level": 3 }, { "id": "panel-source", "anchor": "panel-source", "title": "A lens explains round trips; it does not create cross-store ACID", "level": 2 }, { "id": "reaktor-design-decision-5", "anchor": "reaktor-design-decision-5", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-4", "anchor": "what-this-does-not-establish-4", "title": "What this does not establish", "level": 3 }, { "id": "panel-mvcc", "anchor": "panel-mvcc", "title": "A graph transaction protects invariants, not just records", "level": 2 }, { "id": "reaktor-design-decision-6", "anchor": "reaktor-design-decision-6", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-5", "anchor": "what-this-does-not-establish-5", "title": "What this does not establish", "level": 3 }, { "id": "panel-causal", "anchor": "panel-causal", "title": "One global graph does not imply one global instant", "level": 2 }, { "id": "reaktor-design-decision-7", "anchor": "reaktor-design-decision-7", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-6", "anchor": "what-this-does-not-establish-6", "title": "What this does not establish", "level": 3 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "9-compiler-incremental-analysis-and-runtime-lowering" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "10-transactions-and-distributed-consistency" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "10-transactions-and-distributed-consistency" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "10-transactions-and-distributed-consistency" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "10-transactions-and-distributed-consistency" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-2" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-2" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-2" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-4" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-4" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-4" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-5" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-5" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-6" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-6" } ] }, { "id": "architecture-atlas-qualification", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: impact, design obligations and qualification. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "impact", "src": "/docs/img/architecture-atlas/impact.svg", "alt": "Raise the feasible complexity frontier—not a magic multiplier", "text": "IMPACT • A SENSITIVITY MODEL, NOT AN EMPIRICAL PRODUCTIVITY CLAIM\nFixed-work cost model\nNormalized new cost = (1 − f) + f / s + h\nf = addressable fraction; s = speedup of that fraction; h = added overhead\nEffective speedup\n1.82×\nDefault illustration\n60% improved 4×, zero added overhead.\nEven an infinite improvement of that 60% caps at 2.5×.\nA safer change process may expand feasible scope,\nwhich this fixed-work formula does not measure.\nAmdahl-style reasoning disciplines speed claims; it is not a forecast of Reaktor’s adoption or economic value.", "inspectors": [] } ], "region": "architecture-atlas-book", "order": 7, "title": "Impact, design obligations and qualification", "nav": "Impact, design obligations and qualification", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-qualification", "revision": "c232430c10799d2ddf1e6a7e4e3ed45d0cba6bc1898275cbfe802df49a14a5c6", "status": "design", "renderingRevision": "238a0960d023557a75f27acc64eeb5038865504cb10109a09443467568879313", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-impact", "panel-audit", "panel-coverage", "panel-bibliography" ] } ], "anchors": [], "externalLinks": [ "https://ptolemy.berkeley.edu/ptolemyII/ptIIfaq.htm", "https://mlir.llvm.org/docs/DialectConversion/", "https://www.jetbrains.com/help/mps/mps-projectional-agent-toolkit.html", "https://kubernetes.io/docs/concepts/architecture/controller/", "https://www.erlang.org/doc/system/release_handling.html", "https://www.foundationdb.org/files/fdb-paper.pdf", "https://dl.acm.org/doi/10.1145/1465482.1465560", "https://www.microsoft.com/en-us/research/?p=163907", "https://www.microsoft.com/en-us/research/publication/build-systems-la-carte/", "https://www.postgresql.org/docs/current/transaction-iso.html", "https://arxiv.org/abs/1402.2237", "https://www.sqlite.org/isolation.html", "https://docs.reaktor.build/docs/codex-reaktor-notifications-design/", "https://docs.reaktor.build/docs/multiplatform-analysis/", "https://docs.reaktor.build/docs/react-compose/", "https://docs.reaktor.build/docs/architecture-analysis/", "https://reaktor.build/private/astra-analysis", "https://ptolemy.berkeley.edu/publications/papers/95/processNets/", "https://ptolemy.berkeley.edu/projects/summaries/11/CompositionalDataflow.htm", "https://arxiv.org/abs/1502.00872", "https://arxiv.org/abs/1803.05316", "https://arxiv.org/html/2003.06488v3", "https://www.cis.upenn.edu/~bcpierce/papers/lenses-toplas-final.pdf", "https://dl.acm.org/doi/10.1145/2827695", "https://drops.dagstuhl.de/entities/document/10.4230/LIPIcs.ECOOP.2025.31", "https://link.springer.com/article/10.1007/s00165-010-0161-4", "https://arxiv.org/abs/1307.6780", "https://ocw.mit.edu/courses/1-203j-logistical-and-transportation-planning-methods-fall-2006/resources/lec5/", "https://mlir.llvm.org/docs/Interfaces/", "https://koka-lang.github.io/koka/doc/book.html", "https://component-model.bytecodealliance.org/design/wit.html", "https://arrow.apache.org/docs/format/CDataInterface.html", "https://lamport.azurewebsites.net/pubs/pubs.html", "https://lamport.azurewebsites.net/tla/high-level-view.html", "https://docs.temporal.io/workflow-execution", "https://www.unison-lang.org/docs/the-big-idea/", "https://fmi-standard.org/", "https://dev.epicgames.com/documentation/en-us/unreal-engine/introduction-to-blueprints-visual-scripting-in-unreal-engine", "https://developer.android.com/develop/ui/compose/architecture" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-qualification", "polarity": "Neutral" }, { "id": "section-15-ecosystem-impact-and-complexity-frontier", "anchor": "15-ecosystem-impact-and-complexity-frontier", "label": "15. Ecosystem impact and complexity frontier", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#15-ecosystem-impact-and-complexity-frontier", "polarity": "Neutral" }, { "id": "section-16-design-obligations-and-open-findings", "anchor": "16-design-obligations-and-open-findings", "label": "16. Design obligations and open findings", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#16-design-obligations-and-open-findings", "polarity": "Neutral" }, { "id": "section-17-implementation-and-validation-sequence", "anchor": "17-implementation-and-validation-sequence", "label": "17. Implementation and validation sequence", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#17-implementation-and-validation-sequence", "polarity": "Neutral" }, { "id": "section-18-documentation-coverage", "anchor": "18-documentation-coverage", "label": "18. Documentation coverage", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#18-documentation-coverage", "polarity": "Neutral" }, { "id": "section-panel-impact", "anchor": "panel-impact", "label": "Complexity frontier and ecosystem impact", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#panel-impact", "polarity": "Neutral" }, { "id": "section-panel-audit", "anchor": "panel-audit", "label": "Design obligations and open findings", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#panel-audit", "polarity": "Neutral" }, { "id": "section-1-capability-tier-versus-constrained-offer", "anchor": "1-capability-tier-versus-constrained-offer", "label": "1. Capability tier versus constrained offer", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#1-capability-tier-versus-constrained-offer", "polarity": "Neutral" }, { "id": "section-2-evidence-kinds-versus-an-ordinal-ladder", "anchor": "2-evidence-kinds-versus-an-ordinal-ladder", "label": "2. Evidence kinds versus an ordinal ladder", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#2-evidence-kinds-versus-an-ordinal-ladder", "polarity": "Neutral" }, { "id": "section-3-binary-kernel-examples-versus-n-ary-relationships", "anchor": "3-binary-kernel-examples-versus-n-ary-relationships", "label": "3. Binary kernel examples versus n-ary relationships", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#3-binary-kernel-examples-versus-n-ary-relationships", "polarity": "Neutral" }, { "id": "section-4-protocol-and-completion-semantics", "anchor": "4-protocol-and-completion-semantics", "label": "4. Protocol and completion semantics", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#4-protocol-and-completion-semantics", "polarity": "Neutral" }, { "id": "section-5-lifecycle-ownership-and-handover", "anchor": "5-lifecycle-ownership-and-handover", "label": "5. Lifecycle, ownership and handover", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#5-lifecycle-ownership-and-handover", "polarity": "Neutral" }, { "id": "section-6-source-backed-transaction-publication", "anchor": "6-source-backed-transaction-publication", "label": "6. Source-backed transaction publication", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#6-source-backed-transaction-publication", "polarity": "Neutral" }, { "id": "section-7-incremental-analysis-is-more-than-visitors", "anchor": "7-incremental-analysis-is-more-than-visitors", "label": "7. Incremental analysis is more than visitors", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#7-incremental-analysis-is-more-than-visitors", "polarity": "Neutral" }, { "id": "section-8-time-scales-and-specialized-execution", "anchor": "8-time-scales-and-specialized-execution", "label": "8. Time scales and specialized execution", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#8-time-scales-and-specialized-execution", "polarity": "Neutral" }, { "id": "section-9-coordination-and-collaboration-boundaries", "anchor": "9-coordination-and-collaboration-boundaries", "label": "9. Coordination and collaboration boundaries", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#9-coordination-and-collaboration-boundaries", "polarity": "Neutral" }, { "id": "section-10-evidence-capture-and-privacy", "anchor": "10-evidence-capture-and-privacy", "label": "10. Evidence capture and privacy", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#10-evidence-capture-and-privacy", "polarity": "Neutral" }, { "id": "section-12-storage-engine-ambition", "anchor": "12-storage-engine-ambition", "label": "12. Storage engine ambition", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#12-storage-engine-ambition", "polarity": "Neutral" }, { "id": "section-14-design-truth-versus-implementation-truth", "anchor": "14-design-truth-versus-implementation-truth", "label": "14. Design truth versus implementation truth", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#14-design-truth-versus-implementation-truth", "polarity": "Neutral" }, { "id": "section-15-graph-integration-without-dependency-cycles", "anchor": "15-graph-integration-without-dependency-cycles", "label": "15. Graph integration without dependency cycles", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#15-graph-integration-without-dependency-cycles", "polarity": "Neutral" }, { "id": "section-16-external-harness-authority-is-not-graph-authority", "anchor": "16-external-harness-authority-is-not-graph-authority", "label": "16. External harness authority is not graph authority", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#16-external-harness-authority-is-not-graph-authority", "polarity": "Neutral" }, { "id": "section-panel-coverage", "anchor": "panel-coverage", "label": "Documentation coverage", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-qualification#panel-coverage", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-qualification:references-architecture-atlas-foundations", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-architecture-atlas-vocabulary", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-architecture-atlas-semantics", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-architecture-atlas-language", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-architecture-atlas-evolution", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-architecture-atlas-workbench", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-architecture-atlas-scenarios", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-scenarios", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-15-ecosystem-impact-and-complexity-frontier", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-capability", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-1-capability-tier-versus-constrained-offer", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-formal-methods", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-2-evidence-kinds-versus-an-ordinal-ladder", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-verification", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-2-evidence-kinds-versus-an-ordinal-ladder", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-3-binary-kernel-examples-versus-n-ary-relationships", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-data-graph", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-3-binary-kernel-examples-versus-n-ary-relationships", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-service", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-4-protocol-and-completion-semantics", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-graph-protocol", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-4-protocol-and-completion-semantics", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-data-workflows", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-4-protocol-and-completion-semantics", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-contracts-and-interaction", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-4-protocol-and-completion-semantics", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-component-lifecycle", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-5-lifecycle-ownership-and-handover", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-actor-model", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-5-lifecycle-ownership-and-handover", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-work", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-5-lifecycle-ownership-and-handover", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-ffi", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-5-lifecycle-ownership-and-handover", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-graph-sources", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-6-source-backed-transaction-publication", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-6-source-backed-transaction-publication", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-devops", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-6-source-backed-transaction-publication", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-module-execution-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-7-incremental-analysis-is-more-than-visitors", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor_graph_visitors_design", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-7-incremental-analysis-is-more-than-visitors", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-dynamic-ui-and-verification", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-8-time-scales-and-specialized-execution", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-performance-and-assets", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-8-time-scales-and-specialized-execution", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-performance-and-assets", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations-graph-evidence", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-8-time-scales-and-specialized-execution", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-9-coordination-and-collaboration-boundaries", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-data-transactions", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-9-coordination-and-collaboration-boundaries", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-capture-fabric", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-10-evidence-capture-and-privacy", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-capture-replay", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-10-evidence-capture-and-privacy", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-workspaces", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-10-evidence-capture-and-privacy", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-12-storage-engine-ambition", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-workbench-layers", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-14-design-truth-versus-implementation-truth", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-core", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-15-graph-integration-without-dependency-cycles", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-build-tools", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-15-graph-integration-without-dependency-cycles", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-conductor", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-16-external-harness-authority-is-not-graph-authority", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-unified-system-graph", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-graph-kernel-analysis", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-distributed-actors", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-contributing", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "contributing", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-essays", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-framework-overview", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-db", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-data-storage", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-multitenancy", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-bus-mesh", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-mesh", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-data-inspection", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-data-implementation", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-bestbuds-schema-hardening", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "bestbuds-schema-hardening", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-module-review", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-server", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-auth-analysis", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-notifications-design", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-deep-link-integration", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-koog-agents", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-desktop", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-desktop", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-webview", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-webview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-application-extensions", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-application-extensions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-application-patterns", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-application-patterns", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-foundations", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-implementation-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-implementation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-motion-and-materials", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-motion-and-materials", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-references", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-surface-renderers", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flexbuffer-implementation", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flexbuffer-improvement-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-improvement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flexbuffer-performance-review", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-kotlin-clr", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "kotlin-clr", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-ffi-design", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-cli", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-dependeasy", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-dependeasy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-cloud-pane", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-megascale-strategy", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-megascale-strategy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-secrets-management", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-security-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations-references", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-performance-observability", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations-observability", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-analytics-telemetry", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations-profiling", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations-instance-diagnostics", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations-load-resilience", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "operations-load-resilience", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-devtools", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-tooling-layer", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-backends", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "shadow-backends", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-dev-environment", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-clients-agents", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-foundations", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "shadow-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-operations-delivery", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-instrumentation-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-workbench-links", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-hangar", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "hangar", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-agent-workspace", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-cloud", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-graph-pane", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-agentic-tooling", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-browser-local-ai", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-ui-ux-audit-2026-09-08", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-desktop-master-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-koog-workbench", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-arena", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-arena", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-companyos-migration-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "companyos-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-manna-functional-designs", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "manna-functional-designs", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-manna-hld", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "manna-hld", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-claude-nexergy-appweb-analysis", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "claude-nexergy-appweb-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-codex-nexergy-appweb-analysis", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "codex-nexergy-appweb-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-manna-kotlin-surface-migration-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "manna-kotlin-surface-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-claude-critic-review", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "claude-critic-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-codex-critic-review", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "codex-critic-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-competitive-analysis", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-codex-roadmap", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "codex-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-implementation-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-implementation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-workbench-roadmap", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-claude-dev-environment", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "claude-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-codex-dev-environment", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "codex-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-performance-observability-history", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-shadow-design-history", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-engine-website-implementation-report", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "engine-website-implementation-report", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-flow-analysis", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "flow-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-architecture-analysis", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-architecture-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-graph-migration-plan", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-atlas-review-fable-5", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-review-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-desktop-v3", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-v3", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-qualification:references-reaktor-gemini-devops-agent", "kind": "references", "owner": "architecture-atlas-qualification", "incidences": [ { "node": "architecture-atlas-qualification", "port": "section-panel-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-gemini-devops-agent", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-qualification.json", "sections": [ { "id": "impact-design-obligations-and-qualification", "anchor": "impact-design-obligations-and-qualification", "title": "Impact, design obligations and qualification", "level": 1 }, { "id": "15-ecosystem-impact-and-complexity-frontier", "anchor": "15-ecosystem-impact-and-complexity-frontier", "title": "15. Ecosystem impact and complexity frontier", "level": 2 }, { "id": "16-design-obligations-and-open-findings", "anchor": "16-design-obligations-and-open-findings", "title": "16. Design obligations and open findings", "level": 2 }, { "id": "1-capability-tier-versus-constrained-offer", "anchor": "1-capability-tier-versus-constrained-offer", "title": "1. Capability tier versus constrained offer", "level": 3 }, { "id": "2-evidence-kinds-versus-an-ordinal-ladder", "anchor": "2-evidence-kinds-versus-an-ordinal-ladder", "title": "2. Evidence kinds versus an ordinal ladder", "level": 3 }, { "id": "3-binary-kernel-examples-versus-n-ary-relationships", "anchor": "3-binary-kernel-examples-versus-n-ary-relationships", "title": "3. Binary kernel examples versus n-ary relationships", "level": 3 }, { "id": "4-protocol-and-completion-semantics", "anchor": "4-protocol-and-completion-semantics", "title": "4. Protocol and completion semantics", "level": 3 }, { "id": "5-lifecycle-ownership-and-handover", "anchor": "5-lifecycle-ownership-and-handover", "title": "5. Lifecycle, ownership and handover", "level": 3 }, { "id": "6-source-backed-transaction-publication", "anchor": "6-source-backed-transaction-publication", "title": "6. Source-backed transaction publication", "level": 3 }, { "id": "7-incremental-analysis-is-more-than-visitors", "anchor": "7-incremental-analysis-is-more-than-visitors", "title": "7. Incremental analysis is more than visitors", "level": 3 }, { "id": "8-time-scales-and-specialized-execution", "anchor": "8-time-scales-and-specialized-execution", "title": "8. Time scales and specialized execution", "level": 3 }, { "id": "9-coordination-and-collaboration-boundaries", "anchor": "9-coordination-and-collaboration-boundaries", "title": "9. Coordination and collaboration boundaries", "level": 3 }, { "id": "10-evidence-capture-and-privacy", "anchor": "10-evidence-capture-and-privacy", "title": "10. Evidence capture and privacy", "level": 3 }, { "id": "11-meta-schema-and-qualification-evolution", "anchor": "11-meta-schema-and-qualification-evolution", "title": "11. Meta-schema and qualification evolution", "level": 3 }, { "id": "12-storage-engine-ambition", "anchor": "12-storage-engine-ambition", "title": "12. Storage engine ambition", "level": 3 }, { "id": "13-product-intent-and-reusable-feature-boundaries", "anchor": "13-product-intent-and-reusable-feature-boundaries", "title": "13. Product intent and reusable feature boundaries", "level": 3 }, { "id": "14-design-truth-versus-implementation-truth", "anchor": "14-design-truth-versus-implementation-truth", "title": "14. Design truth versus implementation truth", "level": 3 }, { "id": "15-graph-integration-without-dependency-cycles", "anchor": "15-graph-integration-without-dependency-cycles", "title": "15. Graph integration without dependency cycles", "level": 3 }, { "id": "16-external-harness-authority-is-not-graph-authority", "anchor": "16-external-harness-authority-is-not-graph-authority", "title": "16. External harness authority is not graph authority", "level": 3 }, { "id": "17-implementation-and-validation-sequence", "anchor": "17-implementation-and-validation-sequence", "title": "17. Implementation and validation sequence", "level": 2 }, { "id": "18-documentation-coverage", "anchor": "18-documentation-coverage", "title": "18. Documentation coverage", "level": 2 }, { "id": "panel-impact", "anchor": "panel-impact", "title": "Complexity frontier and ecosystem impact", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish", "anchor": "what-this-does-not-establish", "title": "What this does not establish", "level": 3 }, { "id": "panel-audit", "anchor": "panel-audit", "title": "Design obligations and open findings", "level": 2 }, { "id": "01-capability-tier-versus-constrained-offer", "anchor": "01-capability-tier-versus-constrained-offer", "title": "01. Capability tier versus constrained offer", "level": 3 }, { "id": "02-evidence-kinds-versus-an-ordinal-ladder", "anchor": "02-evidence-kinds-versus-an-ordinal-ladder", "title": "02. Evidence kinds versus an ordinal ladder", "level": 3 }, { "id": "03-binary-kernel-examples-versus-n-ary-relationships", "anchor": "03-binary-kernel-examples-versus-n-ary-relationships", "title": "03. Binary kernel examples versus n-ary relationships", "level": 3 }, { "id": "04-protocol-and-completion-semantics", "anchor": "04-protocol-and-completion-semantics", "title": "04. Protocol and completion semantics", "level": 3 }, { "id": "05-lifecycle-ownership-and-handover", "anchor": "05-lifecycle-ownership-and-handover", "title": "05. Lifecycle, ownership and handover", "level": 3 }, { "id": "06-source-backed-transaction-publication", "anchor": "06-source-backed-transaction-publication", "title": "06. Source-backed transaction publication", "level": 3 }, { "id": "07-incremental-analysis-is-more-than-visitors", "anchor": "07-incremental-analysis-is-more-than-visitors", "title": "07. Incremental analysis is more than visitors", "level": 3 }, { "id": "08-time-scales-and-specialized-execution", "anchor": "08-time-scales-and-specialized-execution", "title": "08. Time scales and specialized execution", "level": 3 }, { "id": "09-coordination-and-collaboration-boundaries", "anchor": "09-coordination-and-collaboration-boundaries", "title": "09. Coordination and collaboration boundaries", "level": 3 }, { "id": "10-evidence-capture-and-privacy-1", "anchor": "10-evidence-capture-and-privacy-1", "title": "10. Evidence capture and privacy", "level": 3 }, { "id": "11-meta-schema-and-qualification-evolution-1", "anchor": "11-meta-schema-and-qualification-evolution-1", "title": "11. Meta-schema and qualification evolution", "level": 3 }, { "id": "12-storage-engine-ambition-1", "anchor": "12-storage-engine-ambition-1", "title": "12. Storage engine ambition", "level": 3 }, { "id": "13-product-intent-and-reusable-feature-boundaries-1", "anchor": "13-product-intent-and-reusable-feature-boundaries-1", "title": "13. Product intent and reusable feature boundaries", "level": 3 }, { "id": "14-design-truth-versus-implementation-truth-1", "anchor": "14-design-truth-versus-implementation-truth-1", "title": "14. Design truth versus implementation truth", "level": 3 }, { "id": "15-graph-integration-without-dependency-cycles-1", "anchor": "15-graph-integration-without-dependency-cycles-1", "title": "15. Graph integration without dependency cycles", "level": 3 }, { "id": "16-external-harness-authority-is-not-graph-authority-1", "anchor": "16-external-harness-authority-is-not-graph-authority-1", "title": "16. External harness authority is not graph authority", "level": 3 }, { "id": "panel-coverage", "anchor": "panel-coverage", "title": "Documentation coverage", "level": 2 }, { "id": "additional-and-inaccessible-material", "anchor": "additional-and-inaccessible-material", "title": "Additional and inaccessible material", "level": 3 }, { "id": "panel-bibliography", "anchor": "panel-bibliography", "title": "Primary sources", "level": 2 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "15-ecosystem-impact-and-complexity-frontier" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "1-capability-tier-versus-constrained-offer" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "1-capability-tier-versus-constrained-offer" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "2-evidence-kinds-versus-an-ordinal-ladder" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "2-evidence-kinds-versus-an-ordinal-ladder" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "3-binary-kernel-examples-versus-n-ary-relationships" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "3-binary-kernel-examples-versus-n-ary-relationships" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "3-binary-kernel-examples-versus-n-ary-relationships" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "4-protocol-and-completion-semantics" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "4-protocol-and-completion-semantics" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "4-protocol-and-completion-semantics" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "4-protocol-and-completion-semantics" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "5-lifecycle-ownership-and-handover" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "5-lifecycle-ownership-and-handover" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "5-lifecycle-ownership-and-handover" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "5-lifecycle-ownership-and-handover" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "6-source-backed-transaction-publication" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "6-source-backed-transaction-publication" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "6-source-backed-transaction-publication" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "7-incremental-analysis-is-more-than-visitors" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "7-incremental-analysis-is-more-than-visitors" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "8-time-scales-and-specialized-execution" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "8-time-scales-and-specialized-execution" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "8-time-scales-and-specialized-execution" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "8-time-scales-and-specialized-execution" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "9-coordination-and-collaboration-boundaries" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "9-coordination-and-collaboration-boundaries" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "11-meta-schema-and-qualification-evolution" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "11-meta-schema-and-qualification-evolution" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "11-meta-schema-and-qualification-evolution" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "12-storage-engine-ambition" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "12-storage-engine-ambition" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "13-product-intent-and-reusable-feature-boundaries" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "13-product-intent-and-reusable-feature-boundaries" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "13-product-intent-and-reusable-feature-boundaries" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "15-graph-integration-without-dependency-cycles" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "15-graph-integration-without-dependency-cycles" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "15-graph-integration-without-dependency-cycles" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "01-capability-tier-versus-constrained-offer" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "01-capability-tier-versus-constrained-offer" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "02-evidence-kinds-versus-an-ordinal-ladder" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "02-evidence-kinds-versus-an-ordinal-ladder" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "03-binary-kernel-examples-versus-n-ary-relationships" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "03-binary-kernel-examples-versus-n-ary-relationships" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "03-binary-kernel-examples-versus-n-ary-relationships" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "04-protocol-and-completion-semantics" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "04-protocol-and-completion-semantics" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "04-protocol-and-completion-semantics" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "04-protocol-and-completion-semantics" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "05-lifecycle-ownership-and-handover" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "05-lifecycle-ownership-and-handover" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "05-lifecycle-ownership-and-handover" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "05-lifecycle-ownership-and-handover" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "06-source-backed-transaction-publication" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "06-source-backed-transaction-publication" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "06-source-backed-transaction-publication" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "07-incremental-analysis-is-more-than-visitors" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "07-incremental-analysis-is-more-than-visitors" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "08-time-scales-and-specialized-execution" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "08-time-scales-and-specialized-execution" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "08-time-scales-and-specialized-execution" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "08-time-scales-and-specialized-execution" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "09-coordination-and-collaboration-boundaries" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "09-coordination-and-collaboration-boundaries" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy-1" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy-1" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy-1" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy-1" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "10-evidence-capture-and-privacy-1" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "11-meta-schema-and-qualification-evolution-1" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "11-meta-schema-and-qualification-evolution-1" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "11-meta-schema-and-qualification-evolution-1" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "12-storage-engine-ambition-1" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "12-storage-engine-ambition-1" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "13-product-intent-and-reusable-feature-boundaries-1" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "13-product-intent-and-reusable-feature-boundaries-1" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "13-product-intent-and-reusable-feature-boundaries-1" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth-1" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth-1" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth-1" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "14-design-truth-versus-implementation-truth-1" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "15-graph-integration-without-dependency-cycles-1" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "15-graph-integration-without-dependency-cycles-1" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "15-graph-integration-without-dependency-cycles-1" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority-1" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority-1" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority-1" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "16-external-harness-authority-is-not-graph-authority-1" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "contributing", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "bestbuds-schema-hardening", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-module-review", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-desktop", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-webview", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-application-extensions", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-application-patterns", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-foundations", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-implementation-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-motion-and-materials", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-references", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flexbuffer-improvement-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "kotlin-clr", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-ffi-design", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-dependeasy", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations-references", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-instrumentation-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "hangar", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-graph-pane", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-arena", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "companyos-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "manna-functional-designs", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "manna-hld", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "claude-nexergy-appweb-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "codex-nexergy-appweb-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "manna-kotlin-surface-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "claude-critic-review", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "codex-critic-review", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "codex-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-implementation-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "claude-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "codex-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "performance-observability-history", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "shadow-design-history", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "engine-website-implementation-report", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "flow-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-architecture-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-atlas-review-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-desktop-v3", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-gemini-devops-agent", "anchor": "", "relation": "references", "sourceAnchor": "panel-coverage" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "hangar", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-dependeasy", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "panel-bibliography" } ] }, { "id": "architecture-atlas-scenarios", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: cross-runtime systems and worked scenarios. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "example", "src": "/docs/img/architecture-atlas/example.svg", "alt": "A demanding use case for the whole design", "text": "END-TO-END EXAMPLE • ONE MULTIPLAYER CAPABILITY\nUnity / Unreal client\nNative input + simulation\nFFI resource and session\ncontract\nAuthoritative match\nActor / native tick owner\nPinned protocol + state epoch\nResults authority\nCommand + durable receipt\nOutbox follows that commit\nsession\nresult\nWeb / mobile companion\nLobby + accessible interaction\nSame public operation\nidentities\nModel / matchmaking\nCapability constraints\nMeasured placement and budgets\nShadow release scenario\nDisconnect + duplicate input\nUpgrade + recover + inspect\nGame-state rewind, graph revert and deployment rollback are different operations. Integration does not replace engine internals.", "inspectors": [] }, { "id": "scenario-dispatch", "src": "/docs/img/architecture-atlas/scenario-dispatch.svg", "alt": "A ride-dispatch feature, from maps to durable assignment", "text": "A ride-dispatch feature, from maps to durable assignment\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nMOBILE / NATIVE HOSTS\nEDGE + MATCH AUTHORITY\nDATA + OPERATIONS\nE1\nE2\nE3\nE4\nE5\nE6\nH1\nH1 · Trip session [H06]\nrider: rider.session | driver: driver.session | authority: match.session\nRider map UI\nN11 / rider\nstate\nrequest\nsession\nDriver location\nN15 / driver\noffer\npositions\nsession\nIngress + geo filter\nN07 / edge\npositions\nrequest\ncandidate\nupdate\nMatch actor + ranker\nN05 / match\ncandidate\nsession\nassign\nTrip authority\nN21 / db\nassign\nreceipt\nrecord\nOperations dashboard\nN11 / ops\nrecord\nupdate\ndecision\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: driver.positions → edge.positions | H02 | sampled stream", "E2: rider.request → edge.request | H05 | request + identity", "E3: edge.candidate → match.candidate | H02 | bounded candidates", "E4: match.assign → db.assign | H05 | conditional write", "E5: db.record → ops.record | H04 | trip events", "E6: edge.update → rider.state | H04 | live map state", "Trip session | H06 | rider=rider.session; driver=driver.session; authority=match.session", "rider · Rider map UI [N11]: A map SDK is exposed through a Surface/native adapter; map internals remain external.", "driver · Driver location [N15]: Sampling and OS permissions belong to the installed host; location payloads do not become persistent graph entities.", "edge · Ingress + geo filter [N07]: Bound noisy location streams, authenticate callers and preserve trip/session correlation.", "match · Match actor + ranker [N05]: Owns assignment transitions. The replaceable ranking function is not the owner of active trip state.", "db · Trip authority [N21]: Conditional assignment writes and outbox share the real store transaction.", "ops · Operations dashboard [N11]: Observes approved trip state and issues separately authorized intervention commands." ] }, { "id": "scenario-checkout", "src": "/docs/img/architecture-atlas/scenario-checkout.svg", "alt": "Checkout: a local transaction plus an external saga", "text": "Checkout: a local transaction plus an external saga\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nCLIENT + IDENTITY\nDURABLE WORK AUTHORITY\nINDEPENDENT PROVIDERS\nE1\nE2\nE3\nE4\nE5\nE6\nE7\nE8\nH1\nH1 · Saga compensation [H17]\ncheckout: work.state | refund: payment.refund | release: stock.release\nCheckout Surface\nN14 / ui\nstatus\nsubmit\nTenant / identity gate\nN33 / auth\ncontext\ngrant\nCheckout workflow\nN06 / work\nsubmit\ngrant\nreserve\ncharge\nstate\nOrder + outbox DB\nN23 / order\nstate\nstock\nreceipt\nevents\nInventory service\nN21 / stock\nreserve\nrelease\nstock\nPayment provider\nN19 / payment\ncharge\nrefund\nreconcile\nNotification worker\nN24 / notify\nevents\ndelivery\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: ui.submit → work.submit | H05 | durable command", "E2: auth.grant → work.grant | H23 | scoped grant", "E3: work.reserve → stock.reserve | H05 | reserve", "E4: work.charge → payment.charge | H05 | charge id", "E5: stock.stock → order.stock | H02 | reserved stock", "E6: work.state → order.state | H02 | workflow state", "E7: order.events → notify.events | H04 | outbox delivery", "E8: order.receipt → ui.status | H04 | receipt / status", "Saga compensation | H17 | checkout=work.state; refund=payment.refund; release=stock.release", "ui · Checkout Surface [N14]: Draft validation stays separate from submitting durable work.", "auth · Tenant / identity gate [N33]: The client cannot mint a payment or inventory grant.", "work · Checkout workflow [N06]: Stable command identity, persisted continuation and explicit unknown-outcome handling.", "order · Order + outbox DB [N23]: Order mutation and its notification intent commit together under this authority only.", "stock · Inventory service [N21]: Reservation uses a key and expiry; remote participation is not silently part of the order DB transaction.", "payment · Payment provider [N19]: Charge idempotency and status lookup are provider-qualified requirements.", "notify · Notification worker [N24]: At-least-once delivery needs application-level deduplication or acceptable duplicate policy." ] }, { "id": "scenario-game", "src": "/docs/img/architecture-atlas/scenario-game.svg", "alt": "Multiplayer across Unreal, Unity and a shared backend", "text": "Multiplayer across Unreal, Unity and a shared backend\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nGAME + COMPANION CLIENTS\nSESSION + GAME SERVER\nPERSISTENCE + MODELS\nE1\nE2\nE3\nE4\nE5\nE6\nE7\nH1\nH1 · Match session [H06]\nplayer: engine.session | observer: lobby.session | authority: sim.session\nUnreal / Unity client\nN16 / engine\nsnapshot\ninput\nsession\nWeb / mobile lobby\nN11 / lobby\nstatus\njoin\nsession\nSession ingress\nN05 / gateway\ninput\njoin\nsession\ncommands\nAuthoritative match\nN29 / sim\ncommands\npolicy\nsnapshot\nresult\nsession\nBot / ranking model\nN18 / model\nstate\npolicy\nResults authority\nN21 / data\nresult\nreceipt\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: engine.input → gateway.input | H07 | input protocol", "E2: lobby.join → gateway.join | H05 | join match", "E3: gateway.commands → sim.commands | H02 | ordered input", "E4: sim.snapshot → engine.snapshot | H07 | state snapshots", "E5: model.policy → sim.policy | H02 | bot policy", "E6: sim.result → data.result | H05 | durable result", "E7: gateway.session → lobby.status | H04 | session state", "Match session | H06 | player=engine.session; observer=lobby.session; authority=sim.session", "engine · Unreal / Unity client [N16]: Generated Blueprint/C++ or C# boundary bindings; renderer, physics and prediction remain engine-owned.", "lobby · Web / mobile lobby [N11]: Same match identity and session contract across companion clients.", "gateway · Session ingress [N05]: Sequence validation, authentication, session pinning and admission budgets.", "sim · Authoritative match [N29]: Each match activation owns a tick loop; simulation transforms are not graph-definition commits.", "model · Bot / ranking model [N18]: Model and preprocessing artifacts have explicit device/quality requirements.", "data · Results authority [N21]: Durable result submission has match/round identity; deduplicate retried outcomes." ] }, { "id": "scenario-voice", "src": "/docs/img/architecture-atlas/scenario-voice.svg", "alt": "Private voice coaching with adaptive inference", "text": "Private voice coaching with adaptive inference\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nDEVICE / BROWSER\nOPTIONAL NETWORK PATH\nQUALIFICATION + CONTENT\nE1\nE2\nE3\nE4\nE5\nE6\nE7\nE8\nH1\nH1 · Provider choice [H24]\nprivacy/quality: route.policy | local: local.offer | remote: cloud.offer | selection: route.decision\nMicrophone + UI\nN15 / mic\nfeedback\npcm\nLocal VAD + model\nN18 / local\npcm\npolicy\nsegments\nfeedback\noffer\nCapability resolver\nN32 / route\nsegments\npolicy\nevidence\nrequest\ndecision\nRemote speech model\nN18 / cloud\nrequest\nfeedback\noffer\nPrivacy / lesson policy\nN33 / policy\nconsent\npolicy\nEvaluation corpus\nN36 / eval\ncandidate\nevidence\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: mic.pcm → local.pcm | H02 | leased audio", "E2: local.segments → route.segments | H02 | segments / metadata", "E3: route.request → cloud.request | H05 | only if eligible", "E4: local.feedback → mic.feedback | H04 | local result", "E5: cloud.feedback → mic.feedback | H04 | remote result", "E6: policy.policy → route.policy | H23 | privacy constraint", "E7: policy.policy → local.policy | H23 | local requirement", "E8: eval.evidence → route.evidence | H02 | qualification", "Provider choice | H24 | privacy/quality=route.policy; local=local.offer; remote=cloud.offer; selection=route.decision", "mic · Microphone + UI [N15]: Installed microphone adapter; permissions and audio thread remain host-specific.", "local · Local VAD + model [N18]: Owned audio buffers; local inference remains available when network or consent prohibits remote work.", "route · Capability resolver [N32]: Evaluate hard privacy, connectivity and quality requirements before preferences.", "cloud · Remote speech model [N18]: Remote speech receives only permitted payloads under a scoped data policy.", "policy · Privacy / lesson policy [N33]: Content, user consent and residency constrain eligible providers.", "eval · Evaluation corpus [N36]: Assess model output quality separately from replay of orchestration." ] }, { "id": "scenario-iot", "src": "/docs/img/architecture-atlas/scenario-iot.svg", "alt": "Industrial telemetry around a qualified control boundary", "text": "Industrial telemetry around a qualified control boundary\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nEDGE / PHYSICAL SYSTEM\nMESSAGE + ANALYTICS\nCLOUD + OPERATIONS\nE1\nE2\nE3\nE4\nE5\nE6\nE7\nH1\nH1 · Safety separation [H22]\ncontrol: plc.request | analytics: filter.config | separation: ops.config\nSensor gateway\nN15 / sensor\nsampling\nreadings\nPLC / control boundary\nN30 / plc\nrequest\nstatus\nEdge filter + detector\nN07 / filter\nreadings\nconfig\nalerts\ntelemetry\nDurable broker\nN24 / broker\ntelemetry\nstatus\nevents\nHistorian / analytics\nN21 / store\nevents\ntrend\nOperator dashboard\nN20 / ops\nalerts\ntrend\napproved request\nconfig\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: sensor.readings → filter.readings | H02 | sampled telemetry", "E2: filter.telemetry → broker.telemetry | H04 | bounded delivery", "E3: plc.status → broker.status | H04 | control status", "E4: broker.events → store.events | H04 | historian stream", "E5: filter.alerts → ops.alerts | H04 | alerts", "E6: store.trend → ops.trend | H02 | trend", "E7: ops.approved request → plc.request | H23 | approved command", "Safety separation | H22 | control=plc.request; analytics=filter.config; separation=ops.config", "sensor · Sensor gateway [N15]: Calibration, timestamps and sequence are part of the ingress contract.", "plc · PLC / control boundary [N30]: Existing qualified safety/control implementation stays opaque and independent; no generic hot code push.", "filter · Edge filter + detector [N07]: Bounded buffers and event-time semantics; telemetry update must not alter safety control.", "broker · Durable broker [N24]: Explicit retention, QoS and redelivery contract supplied by the broker.", "store · Historian / analytics [N21]: Time-series data remains in a specialized store.", "ops · Operator dashboard [N20]: Operator command has an independent authority path to the control boundary." ] }, { "id": "scenario-ml", "src": "/docs/img/architecture-atlas/scenario-ml.svg", "alt": "A reproducible model experiment and deployment pipeline", "text": "A reproducible model experiment and deployment pipeline\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nINPUT ARTIFACTS\nCOMPUTE / EXPERIMENT\nEVIDENCE + RELEASE\nE1\nE2\nE3\nE4\nE5\nE6\nE7\nE8\nH1\nH1 · Experiment provenance [H27]\ndata: dataset.dataset | features: pre.features | candidate: train.candidate | evaluation: eval.run | evidence: eval.evidence\nDataset manifest\nN26 / dataset\naccess\ndataset\nPreprocessing region\nN01 / pre\ndataset\nfeatures\nGPU training job\nN06 / train\nfeatures\nconfig\ncandidate\nmetrics\nBaseline evaluator\nN18 / base\nfeatures\nbaseline\nComparison + gates\nN36 / eval\ncandidate\nbaseline\nmetrics\nevidence\nrun\nModel release authority\nN35 / registry\nevidence\ncandidate\nrelease\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: dataset.dataset → pre.dataset | H02 | pinned dataset", "E2: pre.features → train.features | H02 | feature schema", "E3: pre.features → base.features | H02 | same evaluation inputs", "E4: train.candidate → eval.candidate | H02 | candidate digest", "E5: base.baseline → eval.baseline | H02 | baseline outputs", "E6: train.metrics → eval.metrics | H02 | run measures", "E7: eval.evidence → registry.evidence | H28 | claim-indexed evidence", "E8: train.candidate → registry.candidate | H26 | immutable artifact", "Experiment provenance | H27 | data=dataset.dataset; features=pre.features; candidate=train.candidate; evaluation=eval.run; evidence=eval.evidence", "dataset · Dataset manifest [N26]: Versioned, access-controlled references; the graph is not a duplicate of every sample.", "pre · Preprocessing region [N01]: Pin transforms, feature schema and random sources where relevant.", "train · GPU training job [N06]: Durable job lifecycle with checkpoint ownership; model internals may remain opaque source.", "base · Baseline evaluator [N18]: Same evaluation contract, not necessarily identical hardware execution.", "eval · Comparison + gates [N36]: Task-specific claims, confidence and slice coverage; no universal verified scalar.", "registry · Model release authority [N35]: Signed, immutable artifacts and approved target/runtime requirement vector." ] }, { "id": "scenario-collab", "src": "/docs/img/architecture-atlas/scenario-collab.svg", "alt": "Local-first collaborative editing with controlled publication", "text": "Local-first collaborative editing with controlled publication\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nCLIENT REPLICAS\nSYNC + PUBLICATION\nPERSISTENT OUTPUTS\nE1\nE2\nE3\nE4\nE5\nE6\nE7\nE8\nH1\nH1 · Draft replica group [H14]\nreplica A: a.edit | replica B: b.edit | merge service: sync.merged\nEditor A / local store\nN25 / a\nmerged\nedit\npublish\nEditor B / local store\nN25 / b\nmerged\nedit\npublish\nMerge / sync service\nN25 / sync\na\nb\nmerged\nPublication authority\nN23 / authority\npublish\ndocument\nversion\nevents\nVersioned documents\nN21 / store\nversion\nsnapshot\nExport / search workers\nN06 / render\nevents\nartifact\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: a.edit → sync.a | H14 | replica edits", "E2: b.edit → sync.b | H14 | replica edits", "E3: sync.merged → a.merged | H07 | merged draft", "E4: sync.merged → b.merged | H07 | merged draft", "E5: sync.merged → authority.document | H02 | draft revision", "E6: a.publish → authority.publish | H05 | publish command", "E7: authority.version → store.version | H05 | conditional commit", "E8: authority.events → render.events | H04 | durable export", "Draft replica group | H14 | replica A=a.edit; replica B=b.edit; merge service=sync.merged", "a · Editor A / local store [N25]: Local text/draft edits can use a qualified merge scheme while offline.", "b · Editor B / local store [N25]: Replica state and tombstones are application data, not architecture definitions.", "sync · Merge / sync service [N25]: CRDT or operational transformation where the chosen invariant permits it.", "authority · Publication authority [N23]: Exclusive release/publication invariants use a serializable decision, not unconstrained merging.", "store · Versioned documents [N21]: Versioned content and access policy support later retrieval and deletion constraints.", "render · Export / search workers [N06]: Durable downstream processing with source-version identity." ] }, { "id": "scenario-media", "src": "/docs/img/architecture-atlas/scenario-media.svg", "alt": "A low-copy camera and GPU processing pipeline", "text": "A low-copy camera and GPU processing pipeline\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nNATIVE ACQUISITION\nLOCAL COMPUTE + UI\nOPTIONAL REMOTE OUTPUT\nE1\nE2\nE3\nE4\nE5\nE6\nH1\nH1 · Lifetime constraint [H22]\nowner lease: pool.lease | GPU borrower: gpu.frame lease | UI borrower: ui.preview lease\nNative camera resource\nN16 / camera\nconfiguration\nframe lease\nBuffer / resource owner\nN26 / pool\nrelease\nlease\nGPU crop + inference\nN17 / gpu\nframe lease\nmodel\nresult\npreview lease\nPreview Surface\nN11 / ui\npreview lease\nresult\nreleased\nEncoder / upload region\nN17 / encoder\nframe lease\nchunks\nMedia object store\nN26 / store\nchunks\nartifact\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: camera.frame lease → gpu.frame lease | H02 | borrow / lease", "E2: gpu.preview lease → ui.preview lease | H02 | GPU fence + view", "E3: gpu.result → ui.result | H04 | structured metadata", "E4: camera.frame lease → encoder.frame lease | H02 | qualified sharing", "E5: encoder.chunks → store.chunks | H02 | encoded stream", "E6: ui.released → pool.release | H02 | release token", "Lifetime constraint | H22 | owner lease=pool.lease; GPU borrower=gpu.frame lease; UI borrower=ui.preview lease", "camera · Native camera resource [N16]: Frame metadata and backing resource have separate lifetime/representation contracts.", "pool · Buffer / resource owner [N26]: Generational handles; release belongs to the allocator/owner that created the buffer.", "gpu · GPU crop + inference [N17]: Explicit synchronization and memory-domain transitions; no unconditional zero-copy promise.", "ui · Preview Surface [N11]: Native rendering continues on its qualified host thread.", "encoder · Encoder / upload region [N17]: Remote boundaries require bytes or qualified shared-memory transport, not local pointers.", "store · Media object store [N26]: Controlled artifact references and retention; raw frame traffic is not graph metadata." ] }, { "id": "scenario-logistics", "src": "/docs/img/architecture-atlas/scenario-logistics.svg", "alt": "A multi-party allocation problem, not a web of pairwise links", "text": "A multi-party allocation problem, not a web of pairwise links\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nDEMAND + SUPPLY INPUTS\nOPTIMIZATION AUTHORITY\nAPPROVAL + EXECUTION\nE1\nE2\nE3\nE4\nE5\nH1\nH1 · Allocation relation [H09]\ndemand: demand.orders | capacity: supply.capacity | proposal: solve.proposal | assignment: dispatch.assignment\nOrders / time windows\nN22 / demand\nrefresh\norders\nWarehouses / vehicles\nN22 / supply\nrefresh\ncapacity\nTemporal input join\nN07 / join\norders\ncapacity\nsnapshot\nAllocation optimizer\nN01 / solve\nsnapshot\npolicy\nproposal\nHuman approval\nN20 / approve\nproposal\ndecision\nReservation + dispatch\nN23 / dispatch\ndecision\nassignment\nreceipt\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: demand.orders → join.orders | H11 | versioned demand", "E2: supply.capacity → join.capacity | H11 | versioned supply", "E3: join.snapshot → solve.snapshot | H02 | aligned input cut", "E4: solve.proposal → approve.proposal | H02 | proposal + assumptions", "E5: approve.decision → dispatch.decision | H23 | scoped approval", "Allocation relation | H09 | demand=demand.orders; capacity=supply.capacity; proposal=solve.proposal; assignment=dispatch.assignment", "demand · Orders / time windows [N22]: Authoritative availability and requested delivery windows are versioned inputs.", "supply · Warehouses / vehicles [N22]: Capacity, stock and location constraints come from separate qualified sources.", "join · Temporal input join [N07]: Align by a declared cut/window and mark missing or stale observations.", "solve · Allocation optimizer [N01]: Solver profile, objective and limits are explicit; infeasible is a legitimate outcome.", "approve · Human approval [N20]: Approval is revision-scoped and does not waive current availability checks.", "dispatch · Reservation + dispatch [N23]: Revalidate and reserve at the actual inventory/dispatch authority before emitting work." ] }, { "id": "scenario-selfhost", "src": "/docs/img/architecture-atlas/scenario-selfhost.svg", "alt": "Reaktor improves a Reaktor system without approving itself", "text": "Reaktor improves a Reaktor system without approving itself\nNamed ports • explicit relation roles • specialized runtime lanes • candidate update boundary\nHUMAN + AGENT WORKSPACE\nBUILD + SHADOW\nTRUSTED RELEASE AUTHORITY\nE1\nE2\nE3\nE4\nE5\nE6\nE7\nE8\nH1\nH1 · Acceptance claim [H28]\nrelease claim: draft.claim | evidence: shadow.evidence | independent verifier: approve.verifier\nAgent + source editor\nN39 / agent\nfindings\npatch\nCandidate graph branch\nN23 / draft\npatch\ncandidate\nclaim\nCompiler / packager\nN34 / build\ncandidate\nartifacts\nfindings\nShadow scenario runner\nN36 / shadow\ncandidate\nartifacts\nevidence\nIndependent policy gate\nN33 / approve\ncandidate\nevidence\ndecision\nverifier\nRegion rollout controller\nN40 / rollout\ndecision\nreceipt\nobserved\nPURPLE DASH = update candidate / semantic relation overlay; this is not an implicit network protocol.", "inspectors": [ "E1: agent.patch → draft.patch | H25 | typed edit", "E2: draft.candidate → build.candidate | H26 | pinned revision", "E3: draft.candidate → shadow.candidate | H26 | exact candidate", "E4: build.artifacts → shadow.artifacts | H26 | artifact vector", "E5: shadow.evidence → approve.evidence | H28 | claims / coverage", "E6: draft.candidate → approve.candidate | H26 | candidate digest", "E7: approve.decision → rollout.decision | H23 | release authority", "E8: build.findings → agent.findings | H04 | source-linked findings", "Acceptance claim | H28 | release claim=draft.claim; evidence=shadow.evidence; independent verifier=approve.verifier", "agent · Agent + source editor [N39]: A bounded task context identifies region, code, grants and unresolved obligations.", "draft · Candidate graph branch [N23]: Save typed holes during drafting; base revision and mutation authority remain explicit.", "build · Compiler / packager [N34]: Generate region images, source maps and semantic dependency closure.", "shadow · Shadow scenario runner [N36]: Isolated pre-state, prescribed workload and failure injection. Capture is not unrestricted execution authority.", "approve · Independent policy gate [N33]: Agent cannot weaken required tests and approve the same release; trusted verifier boundary is outside the patch.", "rollout · Region rollout controller [N40]: Signed bundle distribution, host admission, atomic local publication and cross-host reconciliation." ] } ], "region": "architecture-atlas-book", "order": 6, "title": "Cross-runtime systems and worked scenarios", "nav": "Cross-runtime systems and worked scenarios", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-scenarios", "revision": "1a16c06765f0f7d97dfff4d23d4a05f3c6d9fadb83a419e1c70266c6fa1bbf88", "status": "design", "renderingRevision": "a5802f736424b22b5ed7cef9c3059e54198f7fd484386bcf093aabe4694fc1e5", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-example", "panel-scenario-dispatch", "panel-scenario-checkout", "panel-scenario-game", "panel-scenario-voice", "panel-scenario-iot", "panel-scenario-ml", "panel-scenario-collab", "panel-scenario-media", "panel-scenario-logistics", "panel-scenario-selfhost" ] } ], "anchors": [], "externalLinks": [ "https://dev.epicgames.com/documentation/en-us/unreal-engine/introduction-to-blueprints-visual-scripting-in-unreal-engine" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios", "polarity": "Neutral" }, { "id": "section-14-concrete-system-graphs", "anchor": "14-concrete-system-graphs", "label": "14. Concrete system graphs", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#14-concrete-system-graphs", "polarity": "Neutral" }, { "id": "section-panel-example", "anchor": "panel-example", "label": "Cross-runtime reference architecture", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#panel-example", "polarity": "Neutral" }, { "id": "section-panel-scenario-dispatch", "anchor": "panel-scenario-dispatch", "label": "A ride-dispatch feature, from maps to durable assignment", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#panel-scenario-dispatch", "polarity": "Neutral" }, { "id": "section-panel-scenario-checkout", "anchor": "panel-scenario-checkout", "label": "Checkout: a local transaction plus an external saga", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#panel-scenario-checkout", "polarity": "Neutral" }, { "id": "section-panel-scenario-game", "anchor": "panel-scenario-game", "label": "Multiplayer across Unreal, Unity and a shared backend", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#panel-scenario-game", "polarity": "Neutral" }, { "id": "section-panel-scenario-voice", "anchor": "panel-scenario-voice", "label": "Private voice coaching with adaptive inference", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#panel-scenario-voice", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish", "anchor": "what-this-does-not-establish", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#what-this-does-not-establish", "polarity": "Neutral" }, { "id": "section-boundary--caveat", "anchor": "boundary--caveat", "label": "Boundary / caveat", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-scenarios#boundary--caveat", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-scenarios:references-architecture-atlas-foundations", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-architecture-atlas-vocabulary", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-architecture-atlas-semantics", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-architecture-atlas-language", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-architecture-atlas-evolution", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-architecture-atlas-workbench", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-architecture-atlas-qualification", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-reaktor-unified-system-graph", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "section-what-this-does-not-establish", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-reaktor-mesh", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "section-what-this-does-not-establish", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-reaktor-work", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "section-what-this-does-not-establish", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-reaktor-ffi", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "section-what-this-does-not-establish", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-reaktor-surface-contracts-and-interaction", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "section-what-this-does-not-establish", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-scenarios:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-scenarios", "incidences": [ { "node": "architecture-atlas-scenarios", "port": "section-boundary--caveat", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-scenarios.json", "sections": [ { "id": "cross-runtime-systems-and-worked-scenarios", "anchor": "cross-runtime-systems-and-worked-scenarios", "title": "Cross-runtime systems and worked scenarios", "level": 1 }, { "id": "14-concrete-system-graphs", "anchor": "14-concrete-system-graphs", "title": "14. Concrete system graphs", "level": 2 }, { "id": "a-ride-dispatch-feature-from-maps-to-durable-assignment", "anchor": "a-ride-dispatch-feature-from-maps-to-durable-assignment", "title": "A ride-dispatch feature, from maps to durable assignment", "level": 3 }, { "id": "checkout-a-local-transaction-plus-an-external-saga", "anchor": "checkout-a-local-transaction-plus-an-external-saga", "title": "Checkout: a local transaction plus an external saga", "level": 3 }, { "id": "multiplayer-across-unreal-unity-and-a-shared-backend", "anchor": "multiplayer-across-unreal-unity-and-a-shared-backend", "title": "Multiplayer across Unreal, Unity and a shared backend", "level": 3 }, { "id": "private-voice-coaching-with-adaptive-inference", "anchor": "private-voice-coaching-with-adaptive-inference", "title": "Private voice coaching with adaptive inference", "level": 3 }, { "id": "industrial-telemetry-around-a-qualified-control-boundary", "anchor": "industrial-telemetry-around-a-qualified-control-boundary", "title": "Industrial telemetry around a qualified control boundary", "level": 3 }, { "id": "a-reproducible-model-experiment-and-deployment-pipeline", "anchor": "a-reproducible-model-experiment-and-deployment-pipeline", "title": "A reproducible model experiment and deployment pipeline", "level": 3 }, { "id": "local-first-collaborative-editing-with-controlled-publication", "anchor": "local-first-collaborative-editing-with-controlled-publication", "title": "Local-first collaborative editing with controlled publication", "level": 3 }, { "id": "a-low-copy-camera-and-gpu-processing-pipeline", "anchor": "a-low-copy-camera-and-gpu-processing-pipeline", "title": "A low-copy camera and GPU processing pipeline", "level": 3 }, { "id": "a-multi-party-allocation-problem-not-a-web-of-pairwise-links", "anchor": "a-multi-party-allocation-problem-not-a-web-of-pairwise-links", "title": "A multi-party allocation problem, not a web of pairwise links", "level": 3 }, { "id": "reaktor-improves-a-reaktor-system-without-approving-itself", "anchor": "reaktor-improves-a-reaktor-system-without-approving-itself", "title": "Reaktor improves a Reaktor system without approving itself", "level": 3 }, { "id": "panel-example", "anchor": "panel-example", "title": "Cross-runtime reference architecture", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish", "anchor": "what-this-does-not-establish", "title": "What this does not establish", "level": 3 }, { "id": "panel-scenario-dispatch", "anchor": "panel-scenario-dispatch", "title": "A ride-dispatch feature, from maps to durable assignment", "level": 2 }, { "id": "reaktor-design-decision-1", "anchor": "reaktor-design-decision-1", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat", "anchor": "boundary--caveat", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes", "anchor": "diagram-inspection-notes", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-checkout", "anchor": "panel-scenario-checkout", "title": "Checkout: a local transaction plus an external saga", "level": 2 }, { "id": "reaktor-design-decision-2", "anchor": "reaktor-design-decision-2", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-1", "anchor": "boundary--caveat-1", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-1", "anchor": "diagram-inspection-notes-1", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-game", "anchor": "panel-scenario-game", "title": "Multiplayer across Unreal, Unity and a shared backend", "level": 2 }, { "id": "reaktor-design-decision-3", "anchor": "reaktor-design-decision-3", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-2", "anchor": "boundary--caveat-2", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-2", "anchor": "diagram-inspection-notes-2", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-voice", "anchor": "panel-scenario-voice", "title": "Private voice coaching with adaptive inference", "level": 2 }, { "id": "reaktor-design-decision-4", "anchor": "reaktor-design-decision-4", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-3", "anchor": "boundary--caveat-3", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-3", "anchor": "diagram-inspection-notes-3", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-iot", "anchor": "panel-scenario-iot", "title": "Industrial telemetry around a qualified control boundary", "level": 2 }, { "id": "reaktor-design-decision-5", "anchor": "reaktor-design-decision-5", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-4", "anchor": "boundary--caveat-4", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-4", "anchor": "diagram-inspection-notes-4", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-ml", "anchor": "panel-scenario-ml", "title": "A reproducible model experiment and deployment pipeline", "level": 2 }, { "id": "reaktor-design-decision-6", "anchor": "reaktor-design-decision-6", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-5", "anchor": "boundary--caveat-5", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-5", "anchor": "diagram-inspection-notes-5", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-collab", "anchor": "panel-scenario-collab", "title": "Local-first collaborative editing with controlled publication", "level": 2 }, { "id": "reaktor-design-decision-7", "anchor": "reaktor-design-decision-7", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-6", "anchor": "boundary--caveat-6", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-6", "anchor": "diagram-inspection-notes-6", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-media", "anchor": "panel-scenario-media", "title": "A low-copy camera and GPU processing pipeline", "level": 2 }, { "id": "reaktor-design-decision-8", "anchor": "reaktor-design-decision-8", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-7", "anchor": "boundary--caveat-7", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-7", "anchor": "diagram-inspection-notes-7", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-logistics", "anchor": "panel-scenario-logistics", "title": "A multi-party allocation problem, not a web of pairwise links", "level": 2 }, { "id": "reaktor-design-decision-9", "anchor": "reaktor-design-decision-9", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-8", "anchor": "boundary--caveat-8", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-8", "anchor": "diagram-inspection-notes-8", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-scenario-selfhost", "anchor": "panel-scenario-selfhost", "title": "Reaktor improves a Reaktor system without approving itself", "level": 2 }, { "id": "reaktor-design-decision-10", "anchor": "reaktor-design-decision-10", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-9", "anchor": "boundary--caveat-9", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-9", "anchor": "diagram-inspection-notes-9", "title": "Diagram inspection notes", "level": 3 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-1" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-1" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-1" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-2" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-2" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-2" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-3" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-3" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-3" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-4" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-4" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-4" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-5" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-5" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-5" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-6" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-6" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-6" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-7" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-7" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-7" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-8" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-8" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-8" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-9" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-9" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-9" } ] }, { "id": "architecture-atlas-semantics", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: composition and execution semantics. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "cospan", "src": "/docs/img/architecture-atlas/cospan.svg", "alt": "Composition is gluing a boundary, not drawing an arrow", "text": "CATEGORY THEORY • COMPONENTS AS OPEN SYSTEMS\nX\nF: normalize\nInput and output boundary\nInternal implementation\nY\nG: persist\nInput and output boundary\nInternal implementation\nZ\nCOMPOSITION • GLUE THE SHARED, TYPE-CHECKED BOUNDARY\nX\nG ∘ F: one reusable feature\nGlue along Y; do not duplicate Y’s semantic identity.\nHide internal wiring behind exported ports.\nZ\nFormal model: typed/decorated cospans under suitable colimits. Reaktor’s ownership restrictions need explicit laws.", "inspectors": [] }, { "id": "rewrite", "src": "/docs/img/architecture-atlas/rewrite.svg", "alt": "A safe rewrite explains what must remain", "text": "GRAPH REWRITING • MATCH, PRESERVE, REPLACE\nL: old implementation\nBoundary + obsolete internals\nK: preserved interface\nStable ports and owned identity\nR: new implementation\nBoundary + replacement internals\npreserve\npreserve\nADMISSION EXAMPLE • A REFERENCED RESOURCE CANNOT SIMPLY DISAPPEAR\nOutside region\nA still-live external\nreference\nDeleted resource\nNo replacement mapping\nRewrite result\nREJECT: dangling reference\nThe dangling condition is structural. Types, authority, state migration and behavior add separate obligations.", "inspectors": [] }, { "id": "statecharts-v2", "src": "/docs/img/architecture-atlas/statecharts-v2.svg", "alt": "Statecharts are one execution dialect inside a larger system", "text": "SESSION ACTOR / statechart profile / owned event queue\nIdle\nNo session resources\nJoining\nInvoke handshake actor\nClosed\nNo new input admitted\nActive: parallel child regions\nTransport\nConnected / reconnecting\nSynchronization\nCatching up / current\nJOIN\nACCEPT\nLEAVE\nCANCEL / FAIL\nGuards are pure.\nActions declare effects.\nA guarded transition updates\nactor state; external commands\nremain explicit operations with\ntheir own outcomes.\nInvocation-lifetime child actors\nstop when their owning scope exits\nunder the declared profile.\nStatechart inspection\nObserve event, state, child lifecycle and microsteps.\nDistinguish a definition from a running activation.\nPersist only when a durable profile actually does so.\nOther legal regions remain first class\nPure functions, recursion, streams and native code.\nNo universal finite-state or workflow-DAG restriction.\nA remote effect may outlive a local cancel transition.\nThis miniature viewer only demonstrates a local state progression; it is not an XState runtime or distributed-model checker.", "inspectors": [] }, { "id": "scc", "src": "/docs/img/architecture-atlas/scc.svg", "alt": "Allow cycles where their semantics are defined", "text": "GRAPH ALGORITHMS • STRONGLY CONNECTED COMPONENTS\nA\nB\nC\nD\nE\nCycle A–D; downstream E is outside the SCC.\nCONDENSATION GRAPH • A DAG OF COMPONENTS\nSCC {A, B, C, D}\nTreat as one analysis/scheduling unit.\nIts execution profile supplies the law.\nDownstream E\nSeparate component\nAcyclic condensation is structural. Convergence, deadlock freedom and scheduling still require profile-specific reasoning.", "inspectors": [] }, { "id": "protocol", "src": "/docs/img/architecture-atlas/protocol.svg", "alt": "A well-typed message can still be an illegal action", "text": "SESSION / PROTOCOL THEORY • THE PHASE MATTERS\nCreated\nAdmitted\nCommitted\nAcknowledged\nGLOBAL CHOREOGRAPHY → QUALIFIED LOCAL AUTOMATA\nClient role\nSubmit → await receipt → reconcile\nTimeout is not proof of failure.\nAuthority role\nCheck → commit → return receipt\nAcknowledge may be lost.\nDelivery role\nPublish retained intent → retry\nDeduplicate at the effect owner.\nA payload schema can match while completion semantics, cancellation or durable ownership are incompatible.", "inspectors": [] }, { "id": "petri", "src": "/docs/img/architecture-atlas/petri.svg", "alt": "Visualize what a workflow is waiting for", "text": "PETRI NET • PARALLEL WORK AND A JOIN\nsplit\nBranch A complete\nBranch B complete\njoin\nTokens describe a marking. The join is enabled only when both required input places contain tokens.", "inspectors": [] }, { "id": "queues", "src": "/docs/img/architecture-atlas/queues.svg", "alt": "Backpressure is a first-class network contract", "text": "QUEUEING THEORY • UTILIZATION IS NOT LINEAR LATENCY\nArrival process\nλ requests / second\nPoisson in this toy model\nOne modeled server\nμ = 100 requests / second\nExponential service; infinite queue\nSteady-state mean\nW = 1 / (μ − λ)\nOnly when λ < μ\nINTERACTIVE ILLUSTRATION • NOT REAKTOR BENCHMARK DATA\nLoad ρ =\n0.50\nMean W =\n20 ms\nMean L =\n1.0\nBackpressure bounds admission or buffering. It does not create service capacity, and a mean does not determine p99.", "inspectors": [] }, { "id": "resources", "src": "/docs/img/architecture-atlas/resources.svg", "alt": "Make resource misuse unrepresentable where possible", "text": "RESOURCE THEORY • BORROWING IS NOT COPYING OWNERSHIP\nOwner activation\nUnique camera buffer lease\nBorrowed view\nValid within the call scope\nAsync consumer\nNeeds owned transfer or\nretain\nborrow\nnot automatic\nLifetime\nacquire\nborrow starts\nborrow ends\nrelease\nowner retained\nborrowed call scope\nOwned transfer, shared retain and borrowed access are distinct. Raw pointers are not portable remote resource identities.", "inspectors": [] }, { "id": "timescales", "src": "/docs/img/architecture-atlas/timescales.svg", "alt": "Do not transact an architecture edit for every state update", "text": "MULTIPLE TIMESCALES • ONE SEMANTIC IDENTITY, DIFFERENT STATE OWNERS\nDefinition revisions\nSchemas, composition, policy\nDraft → validate → promote\nActivation epochs\nExecutable image and owned resources\nPrepare → safe cutover → drain\nDurable work\nCommands, receipts, checkpoints\nRecover according to its authority\nFrame / tick / reactive values\nPixels, transforms, local interaction\nHost-native fast path; no definition commit\nTimescales are illustrative categories, not performance promises. Identity joins the planes without equating their transactions.", "inspectors": [] } ], "region": "architecture-atlas-book", "order": 2, "title": "Composition and execution semantics", "nav": "Composition and execution semantics", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-semantics", "revision": "fd44e21b8d7f1654050f790abbb0e0b6efab5f2e99c1ff305f736696c9622a64", "status": "design", "renderingRevision": "5a7d4e7f92ae56f720c010ef71dc00ca453c727b2b695b330fb570198e06346e", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-cospan", "panel-rewrite", "panel-statecharts-v2", "panel-scc", "panel-protocol", "panel-petri", "panel-queues", "panel-resources", "panel-timescales" ] } ], "anchors": [], "externalLinks": [ "https://arxiv.org/abs/1502.00872", "https://arxiv.org/abs/1803.05316", "https://arxiv.org/html/2003.06488v3", "https://component-model.bytecodealliance.org/design/wit.html", "https://arrow.apache.org/docs/format/CDataInterface.html", "https://www.cis.upenn.edu/~bcpierce/papers/lenses-toplas-final.pdf", "https://ptolemy.berkeley.edu/ptolemyII/ptIIfaq.htm", "https://ptolemy.berkeley.edu/publications/papers/95/processNets/", "https://dl.acm.org/doi/10.1145/2827695", "https://drops.dagstuhl.de/entities/document/10.4230/LIPIcs.ECOOP.2025.31", "https://link.springer.com/article/10.1007/s00165-010-0161-4", "https://ocw.mit.edu/courses/1-203j-logistical-and-transportation-planning-methods-fall-2006/resources/lec5/", "https://stately.ai/docs/state-machines-and-statecharts", "https://stately.ai/docs/actors", "https://stately.ai/docs/inspection", "https://ptolemy.berkeley.edu/projects/summaries/11/CompositionalDataflow.htm" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-semantics", "polarity": "Neutral" }, { "id": "section-7-composition-rewriting-and-graph-theory", "anchor": "7-composition-rewriting-and-graph-theory", "label": "7. Composition, rewriting and graph theory", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#7-composition-rewriting-and-graph-theory", "polarity": "Neutral" }, { "id": "section-8-programming-and-execution-semantics", "anchor": "8-programming-and-execution-semantics", "label": "8. Programming and execution semantics", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#8-programming-and-execution-semantics", "polarity": "Neutral" }, { "id": "section-panel-cospan", "anchor": "panel-cospan", "label": "Composition is gluing a boundary, not drawing an arrow", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#panel-cospan", "polarity": "Neutral" }, { "id": "section-panel-rewrite", "anchor": "panel-rewrite", "label": "A safe rewrite explains what must remain", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#panel-rewrite", "polarity": "Neutral" }, { "id": "section-panel-statecharts-v2", "anchor": "panel-statecharts-v2", "label": "Statecharts as an execution profile", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#panel-statecharts-v2", "polarity": "Neutral" }, { "id": "section-panel-scc", "anchor": "panel-scc", "label": "Allow cycles where their semantics are defined", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#panel-scc", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish", "anchor": "what-this-does-not-establish", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#what-this-does-not-establish", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-1", "anchor": "what-this-does-not-establish-1", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#what-this-does-not-establish-1", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-3", "anchor": "what-this-does-not-establish-3", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#what-this-does-not-establish-3", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-4", "anchor": "what-this-does-not-establish-4", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#what-this-does-not-establish-4", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-5", "anchor": "what-this-does-not-establish-5", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#what-this-does-not-establish-5", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-6", "anchor": "what-this-does-not-establish-6", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#what-this-does-not-establish-6", "polarity": "Neutral" }, { "id": "section-what-this-does-not-establish-7", "anchor": "what-this-does-not-establish-7", "label": "What this does not establish", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-semantics#what-this-does-not-establish-7", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-semantics:references-architecture-atlas-foundations", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-architecture-atlas-vocabulary", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-architecture-atlas-language", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-architecture-atlas-evolution", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-architecture-atlas-workbench", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-architecture-atlas-scenarios", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-scenarios", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-architecture-atlas-qualification", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-graph-sources", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-7-composition-rewriting-and-graph-theory", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-8-programming-and-execution-semantics", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-unified-system-graph", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-formal-methods", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-1", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-1", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-graph-protocol", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-service", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-work", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-data-workflows", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-4", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-ffi", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-5", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-mesh", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-5", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-bus-mesh", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-5", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-component-lifecycle", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-6", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-surface-contracts-and-interaction", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-7", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-surface-dynamic-ui-and-verification", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-7", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-reaktor-surface-performance-and-assets", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-7", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-performance-and-assets", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-semantics:references-operations-graph-evidence", "kind": "references", "owner": "architecture-atlas-semantics", "incidences": [ { "node": "architecture-atlas-semantics", "port": "section-what-this-does-not-establish-7", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-semantics.json", "sections": [ { "id": "composition-and-execution-semantics", "anchor": "composition-and-execution-semantics", "title": "Composition and execution semantics", "level": 1 }, { "id": "7-composition-rewriting-and-graph-theory", "anchor": "7-composition-rewriting-and-graph-theory", "title": "7. Composition, rewriting and graph theory", "level": 2 }, { "id": "8-programming-and-execution-semantics", "anchor": "8-programming-and-execution-semantics", "title": "8. Programming and execution semantics", "level": 2 }, { "id": "panel-cospan", "anchor": "panel-cospan", "title": "Composition is gluing a boundary, not drawing an arrow", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish", "anchor": "what-this-does-not-establish", "title": "What this does not establish", "level": 3 }, { "id": "panel-rewrite", "anchor": "panel-rewrite", "title": "A safe rewrite explains what must remain", "level": 2 }, { "id": "reaktor-design-decision-1", "anchor": "reaktor-design-decision-1", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-1", "anchor": "what-this-does-not-establish-1", "title": "What this does not establish", "level": 3 }, { "id": "panel-statecharts-v2", "anchor": "panel-statecharts-v2", "title": "Statecharts as an execution profile", "level": 2 }, { "id": "reaktor-design-decision-2", "anchor": "reaktor-design-decision-2", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat", "anchor": "boundary--caveat", "title": "Boundary / caveat", "level": 3 }, { "id": "panel-scc", "anchor": "panel-scc", "title": "Allow cycles where their semantics are defined", "level": 2 }, { "id": "reaktor-design-decision-3", "anchor": "reaktor-design-decision-3", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-2", "anchor": "what-this-does-not-establish-2", "title": "What this does not establish", "level": 3 }, { "id": "panel-protocol", "anchor": "panel-protocol", "title": "A well-typed message can still be an illegal action", "level": 2 }, { "id": "reaktor-design-decision-4", "anchor": "reaktor-design-decision-4", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-3", "anchor": "what-this-does-not-establish-3", "title": "What this does not establish", "level": 3 }, { "id": "panel-petri", "anchor": "panel-petri", "title": "Visualize what a workflow is waiting for", "level": 2 }, { "id": "reaktor-design-decision-5", "anchor": "reaktor-design-decision-5", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-4", "anchor": "what-this-does-not-establish-4", "title": "What this does not establish", "level": 3 }, { "id": "panel-queues", "anchor": "panel-queues", "title": "Backpressure is a first-class network contract", "level": 2 }, { "id": "reaktor-design-decision-6", "anchor": "reaktor-design-decision-6", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-5", "anchor": "what-this-does-not-establish-5", "title": "What this does not establish", "level": 3 }, { "id": "panel-resources", "anchor": "panel-resources", "title": "Make resource misuse unrepresentable where possible", "level": 2 }, { "id": "reaktor-design-decision-7", "anchor": "reaktor-design-decision-7", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-6", "anchor": "what-this-does-not-establish-6", "title": "What this does not establish", "level": 3 }, { "id": "panel-timescales", "anchor": "panel-timescales", "title": "Do not transact an architecture edit for every state update", "level": 2 }, { "id": "reaktor-design-decision-8", "anchor": "reaktor-design-decision-8", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish-7", "anchor": "what-this-does-not-establish-7", "title": "What this does not establish", "level": 3 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "7-composition-rewriting-and-graph-theory" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "8-programming-and-execution-semantics" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-1" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-2" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-3" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-4" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-4" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-5" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-5" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-5" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-6" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-6" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-7" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-7" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-7" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-7" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "what-this-does-not-establish-7" } ] }, { "id": "architecture-atlas-vocabulary", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: nodes, ports and hyperedge vocabulary. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "nodes-1", "src": "/docs/img/architecture-atlas/nodes-1.svg", "alt": "Node families: Behavior", "text": "NODE = family + facets + owned ports + profile + source / activation identity\nA family is a descriptor contribution, not a new kernel subclass. Select a card for its full contract.\nN01\nPure computation\nMap, hash, score, validate\nin: value:T\nout: result:U\nNo hidden effects; cache only against declared inputs and semantic version.\nN02\nEffectful operation\nSend, reserve, write, invoke\nin: request:I, context\nout: result:O|E\nEffects and required grants are explicit; timeout does not imply no effect.\nN03\nDecision / pattern match\nGuard, switch, eligibility\nin: value:T\nout: branch:Case\nDefine exhaustive cases and defaults; guards are pure in the selected profile.\nN04\nLoop / recursive region\nFold, iterate, call itself\nin: seed:T\nout: result:U\nSpecify continuation/state semantics and resource budgets; a cycle is not a schedule.\nN05\nActor / statechart\nSession, cart, connection\nin: event:E\nout: state:S, effects\nOwns state and event ordering; hierarchy does not itself provide durability.\nN06\nWorkflow / saga\nCheckout, onboarding, import\nin: command:I\nout: receipt, outcome\nVersion durable continuations; make retries, unknown results and compensation…\nN07\nStream operator\nFilter, window, resample\nin: stream:T\nout: stream:U\nSpecify demand, buffering, event-time policy, loss and cancellation.\nN08\nFork / join / scheduler\nParallel tasks, join, race\nin: activation\nout: completion\nChoose all/any/quorum semantics, including failure and abandoned branches.\nN09\nTimer / clock source\nDeadline, interval, logical tick\nin: schedule\nout: tick, timeout\nDistinguish logical, event and wall clocks; inject clocks for replay.\nN10\nFunction / blueprint region\nReusable feature, generic subgraph\nin: boundary:In\nout: boundary:Out\nStable exported interface; instantiate fresh owned state, not copied global identity.\nOrthogonal facets include effects, lifecycle, tenancy, placement, observability, mutability and update policy.", "inspectors": [ "N01 · Pure computation: No hidden effects; cache only against declared inputs and semantic version.", "N02 · Effectful operation: Effects and required grants are explicit; timeout does not imply no effect.", "N03 · Decision / pattern match: Define exhaustive cases and defaults; guards are pure in the selected profile.", "N04 · Loop / recursive region: Specify continuation/state semantics and resource budgets; a cycle is not a schedule.", "N05 · Actor / statechart: Owns state and event ordering; hierarchy does not itself provide durability.", "N06 · Workflow / saga: Version durable continuations; make retries, unknown results and compensation explicit.", "N07 · Stream operator: Specify demand, buffering, event-time policy, loss and cancellation.", "N08 · Fork / join / scheduler: Choose all/any/quorum semantics, including failure and abandoned branches.", "N09 · Timer / clock source: Distinguish logical, event and wall clocks; inject clocks for replay.", "N10 · Function / blueprint region: Stable exported interface; instantiate fresh owned state, not copied global identity." ] }, { "id": "nodes-2", "src": "/docs/img/architecture-atlas/nodes-2.svg", "alt": "Node families: Experience", "text": "NODE = family + facets + owned ports + profile + source / activation identity\nA family is a descriptor contribution, not a new kernel subclass. Select a card for its full contract.\nN11\nSurface / view component\nScreen, card, scene overlay\nin: state, commands\nout: interaction\nInteraction semantics are shared; native renderer behavior is qualified separately.\nN12\nRoute / navigation\nDeep link, page, modal\nin: intent\nout: result, location\nMake route state, permissions and unsupported destinations explicit.\nN13\nInput / interaction source\nGesture, keyboard, controller\nin: host event\nout: typed event\nDeclare focus, sampling, ordering and host lifecycle behavior.\nN14\nForm / validation region\nAddress form, editor inspector\nin: model, edit\nout: valid value, issues\nKeep draft/invalid state saveable; effects require separately accepted values.\nN15\nDevice / platform adapter\nCamera, GPS, clipboard\nin: operation\nout: result, events\nNative implementation is bounded by OS permissions, affinity and installed…\nN16\nNative resource / engine\nMap SDK, Unity, Unreal, codec\nin: command, lease\nout: event, lease\nResource owner and release callback survive async calls; opaque internals stay…\nN17\nMedia transform\nCrop, encode, render, mix\nin: buffer lease\nout: buffer lease\nSpecify memory domain, mutability, format and synchronization; zero-copy is…\nN18\nModel inference\nRanker, speech, embedding\nin: tensor, options\nout: prediction\nPin model artifact and preprocessing; quality requires task-specific evidence.\nN19\nTool / external API adapter\nGeocoder, payments, search\nin: request\nout: result, receipt\nTreat credentials and external outcomes separately from local graph transactions.\nN20\nHuman decision / approval\nReview, moderation, release signoff\nin: proposal\nout: decision\nHuman identity, scope, policy version and expiry are part of the decision.\nOrthogonal facets include effects, lifecycle, tenancy, placement, observability, mutability and update policy.", "inspectors": [ "N11 · Surface / view component: Interaction semantics are shared; native renderer behavior is qualified separately.", "N12 · Route / navigation: Make route state, permissions and unsupported destinations explicit.", "N13 · Input / interaction source: Declare focus, sampling, ordering and host lifecycle behavior.", "N14 · Form / validation region: Keep draft/invalid state saveable; effects require separately accepted values.", "N15 · Device / platform adapter: Native implementation is bounded by OS permissions, affinity and installed capabilities.", "N16 · Native resource / engine: Resource owner and release callback survive async calls; opaque internals stay declared.", "N17 · Media transform: Specify memory domain, mutability, format and synchronization; zero-copy is conditional.", "N18 · Model inference: Pin model artifact and preprocessing; quality requires task-specific evidence.", "N19 · Tool / external API adapter: Treat credentials and external outcomes separately from local graph transactions.", "N20 · Human decision / approval: Human identity, scope, policy version and expiry are part of the decision." ] }, { "id": "nodes-3", "src": "/docs/img/architecture-atlas/nodes-3.svg", "alt": "Node families: Resources", "text": "NODE = family + facets + owned ports + profile + source / activation identity\nA family is a descriptor contribution, not a new kernel subclass. Select a card for its full contract.\nN21\nDatabase / state authority\nPostgres, SQLite, KV authority\nin: query, mutation\nout: rows, receipt\nActual store profile determines isolation and durability; rows are not architecture…\nN22\nQuery / materialized view\nProjection, lookup, aggregate\nin: query, changes\nout: snapshot, delta\nDeclare source cut, freshness and dependency coverage; no unsound negative inference.\nN23\nTransaction / unit of work\nGraph commit, local outbox\nin: candidate, expected revision\nout: commit receipt\nAtomicity applies only to the named authority and enlisted qualified resources.\nN24\nQueue / log / pubsub resource\nTopic, task queue, event journal\nin: publish\nout: delivery, ack\nDelivery, retention, offset, deduplication and redelivery laws belong to the provider.\nN25\nCache / replica / sync agent\nLocal-first replica, CDN cache\nin: changes, sync\nout: view, checkpoint\nSpecify merge/conflict policy and deletion semantics; not every invariant permits CRDT…\nN26\nBlob / buffer / asset store\nImages, model weights, snapshots\nin: put, lease\nout: artifact ref, bytes\nGraph stores descriptors and controlled references; large payloads remain in their…\nN27\nRuntime host / executor\nJVM, Hermes, browser, native\nin: activation image\nout: health, receipt\nExpose an installed capability descriptor and lifetime; target name alone is…\nN28\nPlacement / resource pool\nWorker fleet, GPU pool, region\nin: requirements\nout: reservation\nHard constraints precede optimization; placement is not proof of current availability.\nN29\nFactory / dynamic instance\nMatch factory, tenant worker\nin: create, dispose\nout: activation handle\nSeparate reusable definition from dynamic instance identity and bounded registry…\nN30\nExternal system boundary\nLegacy service, PLC, SaaS\nin: declared interface\nout: observations\nExpose integration coverage honestly; graph visibility does not sandbox external code.\nOrthogonal facets include effects, lifecycle, tenancy, placement, observability, mutability and update policy.", "inspectors": [ "N21 · Database / state authority: Actual store profile determines isolation and durability; rows are not architecture nodes.", "N22 · Query / materialized view: Declare source cut, freshness and dependency coverage; no unsound negative inference.", "N23 · Transaction / unit of work: Atomicity applies only to the named authority and enlisted qualified resources.", "N24 · Queue / log / pubsub resource: Delivery, retention, offset, deduplication and redelivery laws belong to the provider.", "N25 · Cache / replica / sync agent: Specify merge/conflict policy and deletion semantics; not every invariant permits CRDT merge.", "N26 · Blob / buffer / asset store: Graph stores descriptors and controlled references; large payloads remain in their owner.", "N27 · Runtime host / executor: Expose an installed capability descriptor and lifetime; target name alone is insufficient.", "N28 · Placement / resource pool: Hard constraints precede optimization; placement is not proof of current availability.", "N29 · Factory / dynamic instance: Separate reusable definition from dynamic instance identity and bounded registry visibility.", "N30 · External system boundary: Expose integration coverage honestly; graph visibility does not sandbox external code." ] }, { "id": "nodes-4", "src": "/docs/img/architecture-atlas/nodes-4.svg", "alt": "Node families: Governance", "text": "NODE = family + facets + owned ports + profile + source / activation identity\nA family is a descriptor contribution, not a new kernel subclass. Select a card for its full contract.\nN31\nSchema / contract definition\nRecord, protocol, resource ABI\nin: versioned definition\nout: descriptor\nRepresent as a node when independently referenced; otherwise keep it a typed…\nN32\nCapability offer / requirement\nOffline ranker, GPU offer\nin: constraints\nout: eligible offers\nAvailability and suitability do not confer authority; selection is context-scoped.\nN33\nPolicy / principal boundary\nGrant evaluator, tenant scope\nin: subject, action\nout: decision\nSecrets stay out of graph payloads; current effect-time authority is rechecked.\nN34\nBuild / compiler pass\nTypecheck, lower, package\nin: source, dependencies\nout: artifact, findings\nKey caches by semantic inputs and toolchain; preserve source maps and qualification…\nN35\nArtifact / release manifest\nSigned region bundle, runtime image\nin: content refs\nout: digest, manifest\nStable identity differs from content digest; exclude cosmetic layout from semantic…\nN36\nTest / Shadow scenario\nFault replay, baseline/candidate\nin: pinned candidate, fixture\nout: evidence\nRecord assumptions, capture gaps and runner; no generic green-check guarantee.\nN37\nClaim / evidence record\nProtocol claim, performance run\nin: subject, results\nout: attestation\nEvidence is claim-indexed, not a universal ordered strength score.\nN38\nObserver / query / visitor\nInspector, trace lens, analysis\nin: selector, snapshot\nout: finding, view\nInspection cannot mutate implicitly; coverage and authority limit conclusions.\nN39\nAgent / change proposer\nPlanner, coding harness, reviewer\nin: task, scoped context\nout: typed patch\nDrafts are not deployment; effective tool/OS authority must be controlled or…\nN40\nDeployment / migration controller\nRollout, drain, state transfer\nin: release intent\nout: receipt, observed state\nDurable reconciliation; monotonic fencing epochs and explicit mixed-version policy.\nOrthogonal facets include effects, lifecycle, tenancy, placement, observability, mutability and update policy.", "inspectors": [ "N31 · Schema / contract definition: Represent as a node when independently referenced; otherwise keep it a typed value/facet.", "N32 · Capability offer / requirement: Availability and suitability do not confer authority; selection is context-scoped.", "N33 · Policy / principal boundary: Secrets stay out of graph payloads; current effect-time authority is rechecked.", "N34 · Build / compiler pass: Key caches by semantic inputs and toolchain; preserve source maps and qualification profile.", "N35 · Artifact / release manifest: Stable identity differs from content digest; exclude cosmetic layout from semantic identity.", "N36 · Test / Shadow scenario: Record assumptions, capture gaps and runner; no generic green-check guarantee.", "N37 · Claim / evidence record: Evidence is claim-indexed, not a universal ordered strength score.", "N38 · Observer / query / visitor: Inspection cannot mutate implicitly; coverage and authority limit conclusions.", "N39 · Agent / change proposer: Drafts are not deployment; effective tool/OS authority must be controlled or disclosed.", "N40 · Deployment / migration controller: Durable reconciliation; monotonic fencing epochs and explicit mixed-version policy." ] }, { "id": "ports-1", "src": "/docs/img/architecture-atlas/ports-1.svg", "alt": "Port profiles: Values & interaction", "text": "PORT = schema × protocol × role × cardinality × lifetime × effects × authority × target\nThese are composable profiles. The product is constrained: many trait combinations are deliberately illegal.\nP01\nValue / immutable snapshot\nOut → In\nSchema, nullability, units and representation matter;…\nP02\nRequest / response\nRequire ↔ Provide\nDirection is a role; sync/async, error and timeout…\nP03\nDurable command / receipt\nSubmit → Receipt\nReceipt names the qualified completion stage, not simply…\nP04\nPush event\nEventOut → EventIn\nDeclare ordering, overflow, replay and delivery…\nP05\nPull iterator / cursor\nNext → Item|End\nCursor lifetime, backpressure, consistency cut and…\nP06\nCredit-controlled stream\nStream + Request(n)\nDemand, buffer bounds, terminal events and cancellation…\nP07\nDuplex session\nSession\nBoth endpoints follow the protocol; pin session version…\nP08\nSignal / reactive state\nSignal\nDistinguish latest-value conflation from delivery of…\nP09\nMutation / conditional update\nUpdate\nThe authority checks predicates and authorization; local…\nP10\nTransaction participant\nParticipant\nOnly qualified participants enlist; a transaction token…\nP11\nExecution / continuation\nExecIn → ExecOut\nDefines effect order within one execution profile; not a…\nP12\nBranch / guarded transition\nCase / Event[Guard]\nExhaustiveness and guard purity are checked; branch…\nA port is an owned semantic boundary. In/out drawing positions are not a substitute for protocol-role compatibility.", "inspectors": [ "P01 · Value / immutable snapshot: Schema, nullability, units and representation matter; value flow alone imposes no effect order.", "P02 · Request / response: Direction is a role; sync/async, error and timeout outcomes are part of compatibility.", "P03 · Durable command / receipt: Receipt names the qualified completion stage, not simply receipt of bytes.", "P04 · Push event: Declare ordering, overflow, replay and delivery guarantee; not implicitly durable.", "P05 · Pull iterator / cursor: Cursor lifetime, backpressure, consistency cut and resume behavior are explicit.", "P06 · Credit-controlled stream: Demand, buffer bounds, terminal events and cancellation must agree across the boundary.", "P07 · Duplex session: Both endpoints follow the protocol; pin session version and handoff semantics.", "P08 · Signal / reactive state: Distinguish latest-value conflation from delivery of every historical change.", "P09 · Mutation / conditional update: The authority checks predicates and authorization; local write locks are not distributed CAS.", "P10 · Transaction participant: Only qualified participants enlist; a transaction token is not universal ACID.", "P11 · Execution / continuation: Defines effect order within one execution profile; not a generic network message.", "P12 · Branch / guarded transition: Exhaustiveness and guard purity are checked; branch choice is separate from data encoding." ] }, { "id": "ports-2", "src": "/docs/img/architecture-atlas/ports-2.svg", "alt": "Port profiles: Lifetime & control", "text": "PORT = schema × protocol × role × cardinality × lifetime × effects × authority × target\nThese are composable profiles. The product is constrained: many trait combinations are deliberately illegal.\nP13\nCompletion / join token\nDone\nJoin rule defines required contributors and treatment of…\nP14\nCancellation / deadline\nCancel\nCancellation is cooperative unless stated otherwise;…\nP15\nClock / tick / timer\nTick\nSpecify event-time versus processing-time semantics;…\nP16\nOwned resource transfer\nOwned\nExactly one accepted owner after transfer; reject…\nP17\nBorrowed buffer / view\nBorrow\nCannot escape its declared scope; async and…\nP18\nShared read lease\nSharedRead\nReference counting alone does not make concurrent…\nP19\nCapability descriptor\nOffer / Require\nMetadata for selection, not an authorization bearer; no…\nP20\nAuthorization request / grant\nAuthorize\nBind principal, scope, expiry and issuer; recheck at use…\nP21\nLifecycle management\nPrepare / Activate / Drain / Release\nCalls may fail or be skipped on host death; required…\nP22\nCheckpoint / migration\nSnapshot → Restore\nMigration is versioned and staged; rollback depends on…\nP23\nArtifact / schema reference\nRef\nA reference is not a raw pointer; loading verifies…\nP24\nInspection / evidence\nObserve → Finding\nCarries coverage and provenance; observational access…\nA port is an owned semantic boundary. In/out drawing positions are not a substitute for protocol-role compatibility.", "inspectors": [ "P13 · Completion / join token: Join rule defines required contributors and treatment of failure/cancellation.", "P14 · Cancellation / deadline: Cancellation is cooperative unless stated otherwise; reconcile already-committed effects.", "P15 · Clock / tick / timer: Specify event-time versus processing-time semantics; clocks are dependencies for replay.", "P16 · Owned resource transfer: Exactly one accepted owner after transfer; reject duplication and invalid module epoch.", "P17 · Borrowed buffer / view: Cannot escape its declared scope; async and cross-address-space use require a qualified lease/copy.", "P18 · Shared read lease: Reference counting alone does not make concurrent mutation safe; memory rules stay explicit.", "P19 · Capability descriptor: Metadata for selection, not an authorization bearer; no implied access to the capability.", "P20 · Authorization request / grant: Bind principal, scope, expiry and issuer; recheck at use and never serialize raw credentials.", "P21 · Lifecycle management: Calls may fail or be skipped on host death; required persistence cannot rely on cleanup.", "P22 · Checkpoint / migration: Migration is versioned and staged; rollback depends on state compatibility, not old code availability.", "P23 · Artifact / schema reference: A reference is not a raw pointer; loading verifies integrity, provenance and access.", "P24 · Inspection / evidence: Carries coverage and provenance; observational access does not confer mutation authority." ] }, { "id": "relations-1", "src": "/docs/img/architecture-atlas/relations-1.svg", "alt": "Hyperedge patterns: Flow & coordination", "text": "HYPEREDGE = roles + per-role cardinality + laws + layer + optional execution interpretation\nThe oval is a relation identity. It does not secretly create a coordinator, queue, transaction manager or consensus engine.\nH01\nExclusive binding\nconsumer:1\nprovider:1\nH01\nReject a second provider where exclusivity is…\nH02\nValue flow\nsource:1\nsink:1..N\nH02\nCopy/fanout is legal only for the value ownership…\nH03\nControl precedence\nbefore:1..N\nafter:1..N\nH03\nDefines ordering under a named profile; does not…\nH04\nEvent subscription\npublisher:1..N\nsubscriber:1..N\nH04\nSubscriptions name filters, replay and delivery rules;…\nH05\nRequest / reply binding\ncaller:1\ncallee:1\nreply:0..1\nH05\nProtocol includes correlation, failure and unknown…\nH06\nMultiparty session\nauthority:1\nparticipant:1..N\nobserver:0..N\nH06\nSingle relation identity with role/cardinality checks;…\nH07\nBroadcast / fanout\nproducer:1\nconsumer:1..N\nH07\nState whether delivery waits for all, any or no…\nH08\nMerge-any\nproducer:1..N\nconsumer:1\nH08\nSpecify interleaving, fairness and order; merging is…\nH09\nJoin-all\ninput:2..N\nresult:1\nH09\nAlign values by invocation/key; define failure,…\nH10\nRace / select\ncontender:2..N\nwinner:1\nH10\nDefine first-completion versus first-success and…\nH11\nKeyed temporal join\nleft:1\nright:1..N\nresult:1\nH11\nState key, clock, lateness/watermark and window…\nH12\nBarrier / synchronization\nmember:2..N\ncontinuation:1\nH12\nSpecify membership epoch, arrival condition and…\nBinary edges are specializations; metadata constraints can add participants. Cardinality and laws are checked on the complete relation.", "inspectors": [ "H01 · Exclusive binding | consumer:1, provider:1 | Reject a second provider where exclusivity is required; dispatch can compile to a direct call.", "H02 · Value flow | source:1, sink:1..N | Copy/fanout is legal only for the value ownership profile; units and schemas must match.", "H03 · Control precedence | before:1..N, after:1..N | Defines ordering under a named profile; does not serialize unrelated graph layers.", "H04 · Event subscription | publisher:1..N, subscriber:1..N | Subscriptions name filters, replay and delivery rules; broker resources remain separate nodes.", "H05 · Request / reply binding | caller:1, callee:1, reply:0..1 | Protocol includes correlation, failure and unknown outcomes; transport is chosen independently.", "H06 · Multiparty session | authority:1, participant:1..N, observer:0..N | Single relation identity with role/cardinality checks; delivery comes from an explicit protocol.", "H07 · Broadcast / fanout | producer:1, consumer:1..N | State whether delivery waits for all, any or no receivers; slow receivers need a policy.", "H08 · Merge-any | producer:1..N, consumer:1 | Specify interleaving, fairness and order; merging is not a join of corresponding values.", "H09 · Join-all | input:2..N, result:1 | Align values by invocation/key; define failure, timeout and missing-input treatment.", "H10 · Race / select | contender:2..N, winner:1 | Define first-completion versus first-success and cleanup/reconciliation of losing effects.", "H11 · Keyed temporal join | left:1, right:1..N, result:1 | State key, clock, lateness/watermark and window policy; topology alone cannot pair records.", "H12 · Barrier / synchronization | member:2..N, continuation:1 | Specify membership epoch, arrival condition and failure handling; no hidden global clock." ] }, { "id": "relations-2", "src": "/docs/img/architecture-atlas/relations-2.svg", "alt": "Hyperedge patterns: State & structure", "text": "HYPEREDGE = roles + per-role cardinality + laws + layer + optional execution interpretation\nThe oval is a relation identity. It does not secretly create a coordinator, queue, transaction manager or consensus engine.\nH13\nQuorum requirement\nproposer:1\nvoter:1..N\nresult:1\nH13\nNames a qualified protocol and membership; counting…\nH14\nReplica group\nauthority:0..1\nreplica:1..N\nH14\nReplication/merge and fencing rules are explicit;…\nH15\nPartition / route\nrouter:1\nshard:1..N\nH15\nSpecify key function, assignment epoch and resharding;…\nH16\nAtomic authority scope\nauthority:1\nparticipant:1..N\nH16\nACID applies only where that authority/profile…\nH17\nCompensation relation\nforward:1\ncompensator:1..N\nH17\nCompensation is a new effect with its own failure…\nH18\nSupervision\nsupervisor:1\nchild:1..N\nH18\nSpecify restart budget, state/ownership effects and…\nH19\nOwnership / containment\nowner:1\nowned:1..N\nH19\nSelected ownership relation is acyclic; visual…\nH20\nInstantiation\ndefinition:1\ninstance:1..N\nH20\nFresh activation identities and scopes; shared…\nH21\nPlacement\ncomponent:1..N\nhost:1..N\nH21\nA plan expresses intended placement; observations…\nH22\nAffinity / separation\nmember:2..N\nconstraint:1\nH22\nCo-location, anti-affinity or memory-domain rule is a…\nH23\nScoped authorization\nprincipal:1\nresource:1..N\npolicy:1\nH23\nDecision is tied to action/context; visual…\nH24\nCapability resolution\nrequirement:1\noffer:1..N\ndecision:1\nH24\nFilter hard constraints and grants before preferences;…\nBinary edges are specializations; metadata constraints can add participants. Cardinality and laws are checked on the complete relation.", "inspectors": [ "H13 · Quorum requirement | proposer:1, voter:1..N, result:1 | Names a qualified protocol and membership; counting votes alone does not implement consensus.", "H14 · Replica group | authority:0..1, replica:1..N | Replication/merge and fencing rules are explicit; schema does not create consistency.", "H15 · Partition / route | router:1, shard:1..N | Specify key function, assignment epoch and resharding; preserve owner and replay semantics.", "H16 · Atomic authority scope | authority:1, participant:1..N | ACID applies only where that authority/profile implements it; not across arbitrary stores.", "H17 · Compensation relation | forward:1, compensator:1..N | Compensation is a new effect with its own failure modes, not automatic historical erasure.", "H18 · Supervision | supervisor:1, child:1..N | Specify restart budget, state/ownership effects and host-death behavior.", "H19 · Ownership / containment | owner:1, owned:1..N | Selected ownership relation is acyclic; visual grouping is not ownership.", "H20 · Instantiation | definition:1, instance:1..N | Fresh activation identities and scopes; shared definitions are not shared mutable instance state.", "H21 · Placement | component:1..N, host:1..N | A plan expresses intended placement; observations separately establish what actually runs.", "H22 · Affinity / separation | member:2..N, constraint:1 | Co-location, anti-affinity or memory-domain rule is a constraint, not an executable wire.", "H23 · Scoped authorization | principal:1, resource:1..N, policy:1 | Decision is tied to action/context; visual reachability neither proves nor grants access.", "H24 · Capability resolution | requirement:1, offer:1..N, decision:1 | Filter hard constraints and grants before preferences; pin or safely migrate running sessions." ] }, { "id": "relations-3", "src": "/docs/img/architecture-atlas/relations-3.svg", "alt": "Hyperedge patterns: Meaning & change", "text": "HYPEREDGE = roles + per-role cardinality + laws + layer + optional execution interpretation\nThe oval is a relation identity. It does not secretly create a coordinator, queue, transaction manager or consensus engine.\nH25\nImplements / source ownership\nsource:1\ncontract:1..N\nregion:1\nH25\nExactly one edit authority per region; generated…\nH26\nArtifact dependency\nconsumer:1\ndependency:1..N\nH26\nPin semantic/artifact revisions; cosmetic layout…\nH27\nDerivation / provenance\ninput:1..N\ntransform:1\noutput:1..N\nH27\nResults carry input cut and transform version; unknown…\nH28\nEvidence supports claim\nclaim:1\nevidence:1..N\nverifier:1..N\nH28\nScope assumptions and coverage; evidence does not…\nH29\nActivation cohort\nrelease:1\nimage:1..N\nlocalRoot:1\nH29\nLocal root publication can be atomic; cross-host…\nH30\nBoundary export / alias\ninternal:1..N\nexternal:1..N\nH30\nPreserve role, ownership and protocol when…\nH31\nClock / time alignment\nclock:1..N\nstream:1..N\nH31\nAlignment needs a defined transform/uncertainty;…\nH32\nTensor / algebraic operation\noperand:1..N\noperator:1\nresult:1..N\nH32\nValidate axes, units and device layout; computation…\nH33\nFallback / preference set\nrequirement:1\nalternative:1..N\nH33\nFallbacks must remain eligible and authorized; never…\nH34\nData access / lineage\noperation:1\nstore:1..N\nschema:1..N\nH34\nRecords the modeled access scope; enforce at actual…\nH35\nState migration\noldState:1\nmigrator:1\nnewState:1\nH35\nVersion checkpoints, fence writers and validate…\nH36\nNavigation / interaction route\norigin:1\nintent:1\ndestination:1..N\nH36\nChoose destination with guards and grants; back-stack…\nBinary edges are specializations; metadata constraints can add participants. Cardinality and laws are checked on the complete relation.", "inspectors": [ "H25 · Implements / source ownership | source:1, contract:1..N, region:1 | Exactly one edit authority per region; generated projections are not independently editable truth.", "H26 · Artifact dependency | consumer:1, dependency:1..N | Pin semantic/artifact revisions; cosmetic layout changes need not invalidate code.", "H27 · Derivation / provenance | input:1..N, transform:1, output:1..N | Results carry input cut and transform version; unknown dependencies widen invalidation.", "H28 · Evidence supports claim | claim:1, evidence:1..N, verifier:1..N | Scope assumptions and coverage; evidence does not promote or authorize itself.", "H29 · Activation cohort | release:1, image:1..N, localRoot:1 | Local root publication can be atomic; cross-host realization is recoverable coordination.", "H30 · Boundary export / alias | internal:1..N, external:1..N | Preserve role, ownership and protocol when hiding/expanding a reusable region.", "H31 · Clock / time alignment | clock:1..N, stream:1..N | Alignment needs a defined transform/uncertainty; timestamps do not establish causal order.", "H32 · Tensor / algebraic operation | operand:1..N, operator:1, result:1..N | Validate axes, units and device layout; computation belongs to the qualified implementation.", "H33 · Fallback / preference set | requirement:1, alternative:1..N | Fallbacks must remain eligible and authorized; never silently relax mandatory privacy or safety.", "H34 · Data access / lineage | operation:1, store:1..N, schema:1..N | Records the modeled access scope; enforce at actual storage boundary and disclose opaque access.", "H35 · State migration | oldState:1, migrator:1, newState:1 | Version checkpoints, fence writers and validate postconditions; inverse may not exist.", "H36 · Navigation / interaction route | origin:1, intent:1, destination:1..N | Choose destination with guards and grants; back-stack and cancellation semantics are explicit." ] } ], "region": "architecture-atlas-book", "order": 1, "title": "Nodes, ports and hyperedge vocabulary", "nav": "Nodes, ports and hyperedge vocabulary", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-vocabulary", "revision": "3bf155bcdb8060dac01fa91d6acd12831898dabb8297176b945f6cf9a3bd9711", "status": "design", "renderingRevision": "494c0ce4f564ad251c21e9285531c947ba19c97a1000f762b3a0e0dd2f13d0f6", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-nodes-1", "panel-nodes-2", "panel-nodes-3", "panel-nodes-4", "panel-ports-1", "panel-ports-2", "panel-relations-1", "panel-relations-2", "panel-relations-3", "panel-vocabulary" ] } ], "anchors": [], "externalLinks": [ "https://stately.ai/docs/actors", "https://docs.expo.dev/eas-update/runtime-versions/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary", "polarity": "Neutral" }, { "id": "section-4-node-families", "anchor": "4-node-families", "label": "4. Node families", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#4-node-families", "polarity": "Neutral" }, { "id": "section-5-port-profiles", "anchor": "5-port-profiles", "label": "5. Port profiles", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#5-port-profiles", "polarity": "Neutral" }, { "id": "section-6-hyperedge-patterns", "anchor": "6-hyperedge-patterns", "label": "6. Hyperedge patterns", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#6-hyperedge-patterns", "polarity": "Neutral" }, { "id": "section-panel-nodes-1", "anchor": "panel-nodes-1", "label": "Node families · behavior", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#panel-nodes-1", "polarity": "Neutral" }, { "id": "section-panel-nodes-2", "anchor": "panel-nodes-2", "label": "Node families · experience", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#panel-nodes-2", "polarity": "Neutral" }, { "id": "section-panel-nodes-3", "anchor": "panel-nodes-3", "label": "Node families · resources", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#panel-nodes-3", "polarity": "Neutral" }, { "id": "section-boundary--caveat", "anchor": "boundary--caveat", "label": "Boundary / caveat", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#boundary--caveat", "polarity": "Neutral" }, { "id": "section-boundary--caveat-4", "anchor": "boundary--caveat-4", "label": "Boundary / caveat", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-vocabulary#boundary--caveat-4", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-vocabulary:references-architecture-atlas-foundations", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-architecture-atlas-semantics", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-architecture-atlas-language", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-architecture-atlas-evolution", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-architecture-atlas-workbench", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-architecture-atlas-scenarios", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-scenarios", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-architecture-atlas-qualification", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "section-boundary--caveat", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-reaktor-unified-system-graph", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "section-boundary--caveat", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-vocabulary:references-reaktor-ffi", "kind": "references", "owner": "architecture-atlas-vocabulary", "incidences": [ { "node": "architecture-atlas-vocabulary", "port": "section-boundary--caveat-4", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-vocabulary.json", "sections": [ { "id": "nodes-ports-and-hyperedge-vocabulary", "anchor": "nodes-ports-and-hyperedge-vocabulary", "title": "Nodes, ports and hyperedge vocabulary", "level": 1 }, { "id": "4-node-families", "anchor": "4-node-families", "title": "4. Node families", "level": 2 }, { "id": "n01--pure-computation", "anchor": "n01--pure-computation", "title": "N01 · Pure computation", "level": 3 }, { "id": "n02--effectful-operation", "anchor": "n02--effectful-operation", "title": "N02 · Effectful operation", "level": 3 }, { "id": "n03--decision--pattern-match", "anchor": "n03--decision--pattern-match", "title": "N03 · Decision / pattern match", "level": 3 }, { "id": "n04--loop--recursive-region", "anchor": "n04--loop--recursive-region", "title": "N04 · Loop / recursive region", "level": 3 }, { "id": "n05--actor--statechart", "anchor": "n05--actor--statechart", "title": "N05 · Actor / statechart", "level": 3 }, { "id": "n06--workflow--saga", "anchor": "n06--workflow--saga", "title": "N06 · Workflow / saga", "level": 3 }, { "id": "n07--stream-operator", "anchor": "n07--stream-operator", "title": "N07 · Stream operator", "level": 3 }, { "id": "n08--fork--join--scheduler", "anchor": "n08--fork--join--scheduler", "title": "N08 · Fork / join / scheduler", "level": 3 }, { "id": "n09--timer--clock-source", "anchor": "n09--timer--clock-source", "title": "N09 · Timer / clock source", "level": 3 }, { "id": "n10--function--blueprint-region", "anchor": "n10--function--blueprint-region", "title": "N10 · Function / blueprint region", "level": 3 }, { "id": "n11--surface--view-component", "anchor": "n11--surface--view-component", "title": "N11 · Surface / view component", "level": 3 }, { "id": "n12--route--navigation", "anchor": "n12--route--navigation", "title": "N12 · Route / navigation", "level": 3 }, { "id": "n13--input--interaction-source", "anchor": "n13--input--interaction-source", "title": "N13 · Input / interaction source", "level": 3 }, { "id": "n14--form--validation-region", "anchor": "n14--form--validation-region", "title": "N14 · Form / validation region", "level": 3 }, { "id": "n15--device--platform-adapter", "anchor": "n15--device--platform-adapter", "title": "N15 · Device / platform adapter", "level": 3 }, { "id": "n16--native-resource--engine", "anchor": "n16--native-resource--engine", "title": "N16 · Native resource / engine", "level": 3 }, { "id": "n17--media-transform", "anchor": "n17--media-transform", "title": "N17 · Media transform", "level": 3 }, { "id": "n18--model-inference", "anchor": "n18--model-inference", "title": "N18 · Model inference", "level": 3 }, { "id": "n19--tool--external-api-adapter", "anchor": "n19--tool--external-api-adapter", "title": "N19 · Tool / external API adapter", "level": 3 }, { "id": "n20--human-decision--approval", "anchor": "n20--human-decision--approval", "title": "N20 · Human decision / approval", "level": 3 }, { "id": "n21--database--state-authority", "anchor": "n21--database--state-authority", "title": "N21 · Database / state authority", "level": 3 }, { "id": "n22--query--materialized-view", "anchor": "n22--query--materialized-view", "title": "N22 · Query / materialized view", "level": 3 }, { "id": "n23--transaction--unit-of-work", "anchor": "n23--transaction--unit-of-work", "title": "N23 · Transaction / unit of work", "level": 3 }, { "id": "n24--queue--log--pubsub-resource", "anchor": "n24--queue--log--pubsub-resource", "title": "N24 · Queue / log / pubsub resource", "level": 3 }, { "id": "n25--cache--replica--sync-agent", "anchor": "n25--cache--replica--sync-agent", "title": "N25 · Cache / replica / sync agent", "level": 3 }, { "id": "n26--blob--buffer--asset-store", "anchor": "n26--blob--buffer--asset-store", "title": "N26 · Blob / buffer / asset store", "level": 3 }, { "id": "n27--runtime-host--executor", "anchor": "n27--runtime-host--executor", "title": "N27 · Runtime host / executor", "level": 3 }, { "id": "n28--placement--resource-pool", "anchor": "n28--placement--resource-pool", "title": "N28 · Placement / resource pool", "level": 3 }, { "id": "n29--factory--dynamic-instance", "anchor": "n29--factory--dynamic-instance", "title": "N29 · Factory / dynamic instance", "level": 3 }, { "id": "n30--external-system-boundary", "anchor": "n30--external-system-boundary", "title": "N30 · External system boundary", "level": 3 }, { "id": "n31--schema--contract-definition", "anchor": "n31--schema--contract-definition", "title": "N31 · Schema / contract definition", "level": 3 }, { "id": "n32--capability-offer--requirement", "anchor": "n32--capability-offer--requirement", "title": "N32 · Capability offer / requirement", "level": 3 }, { "id": "n33--policy--principal-boundary", "anchor": "n33--policy--principal-boundary", "title": "N33 · Policy / principal boundary", "level": 3 }, { "id": "n34--build--compiler-pass", "anchor": "n34--build--compiler-pass", "title": "N34 · Build / compiler pass", "level": 3 }, { "id": "n35--artifact--release-manifest", "anchor": "n35--artifact--release-manifest", "title": "N35 · Artifact / release manifest", "level": 3 }, { "id": "n36--test--shadow-scenario", "anchor": "n36--test--shadow-scenario", "title": "N36 · Test / Shadow scenario", "level": 3 }, { "id": "n37--claim--evidence-record", "anchor": "n37--claim--evidence-record", "title": "N37 · Claim / evidence record", "level": 3 }, { "id": "n38--observer--query--visitor", "anchor": "n38--observer--query--visitor", "title": "N38 · Observer / query / visitor", "level": 3 }, { "id": "n39--agent--change-proposer", "anchor": "n39--agent--change-proposer", "title": "N39 · Agent / change proposer", "level": 3 }, { "id": "n40--deployment--migration-controller", "anchor": "n40--deployment--migration-controller", "title": "N40 · Deployment / migration controller", "level": 3 }, { "id": "5-port-profiles", "anchor": "5-port-profiles", "title": "5. Port profiles", "level": 2 }, { "id": "p01--value--immutable-snapshot", "anchor": "p01--value--immutable-snapshot", "title": "P01 · Value / immutable snapshot", "level": 3 }, { "id": "p02--request--response", "anchor": "p02--request--response", "title": "P02 · Request / response", "level": 3 }, { "id": "p03--durable-command--receipt", "anchor": "p03--durable-command--receipt", "title": "P03 · Durable command / receipt", "level": 3 }, { "id": "p04--push-event", "anchor": "p04--push-event", "title": "P04 · Push event", "level": 3 }, { "id": "p05--pull-iterator--cursor", "anchor": "p05--pull-iterator--cursor", "title": "P05 · Pull iterator / cursor", "level": 3 }, { "id": "p06--credit-controlled-stream", "anchor": "p06--credit-controlled-stream", "title": "P06 · Credit-controlled stream", "level": 3 }, { "id": "p07--duplex-session", "anchor": "p07--duplex-session", "title": "P07 · Duplex session", "level": 3 }, { "id": "p08--signal--reactive-state", "anchor": "p08--signal--reactive-state", "title": "P08 · Signal / reactive state", "level": 3 }, { "id": "p09--mutation--conditional-update", "anchor": "p09--mutation--conditional-update", "title": "P09 · Mutation / conditional update", "level": 3 }, { "id": "p10--transaction-participant", "anchor": "p10--transaction-participant", "title": "P10 · Transaction participant", "level": 3 }, { "id": "p11--execution--continuation", "anchor": "p11--execution--continuation", "title": "P11 · Execution / continuation", "level": 3 }, { "id": "p12--branch--guarded-transition", "anchor": "p12--branch--guarded-transition", "title": "P12 · Branch / guarded transition", "level": 3 }, { "id": "p13--completion--join-token", "anchor": "p13--completion--join-token", "title": "P13 · Completion / join token", "level": 3 }, { "id": "p14--cancellation--deadline", "anchor": "p14--cancellation--deadline", "title": "P14 · Cancellation / deadline", "level": 3 }, { "id": "p15--clock--tick--timer", "anchor": "p15--clock--tick--timer", "title": "P15 · Clock / tick / timer", "level": 3 }, { "id": "p16--owned-resource-transfer", "anchor": "p16--owned-resource-transfer", "title": "P16 · Owned resource transfer", "level": 3 }, { "id": "p17--borrowed-buffer--view", "anchor": "p17--borrowed-buffer--view", "title": "P17 · Borrowed buffer / view", "level": 3 }, { "id": "p18--shared-read-lease", "anchor": "p18--shared-read-lease", "title": "P18 · Shared read lease", "level": 3 }, { "id": "p19--capability-descriptor", "anchor": "p19--capability-descriptor", "title": "P19 · Capability descriptor", "level": 3 }, { "id": "p20--authorization-request--grant", "anchor": "p20--authorization-request--grant", "title": "P20 · Authorization request / grant", "level": 3 }, { "id": "p21--lifecycle-management", "anchor": "p21--lifecycle-management", "title": "P21 · Lifecycle management", "level": 3 }, { "id": "p22--checkpoint--migration", "anchor": "p22--checkpoint--migration", "title": "P22 · Checkpoint / migration", "level": 3 }, { "id": "p23--artifact--schema-reference", "anchor": "p23--artifact--schema-reference", "title": "P23 · Artifact / schema reference", "level": 3 }, { "id": "p24--inspection--evidence", "anchor": "p24--inspection--evidence", "title": "P24 · Inspection / evidence", "level": 3 }, { "id": "6-hyperedge-patterns", "anchor": "6-hyperedge-patterns", "title": "6. Hyperedge patterns", "level": 2 }, { "id": "h01--exclusive-binding", "anchor": "h01--exclusive-binding", "title": "H01 · Exclusive binding", "level": 3 }, { "id": "h02--value-flow", "anchor": "h02--value-flow", "title": "H02 · Value flow", "level": 3 }, { "id": "h03--control-precedence", "anchor": "h03--control-precedence", "title": "H03 · Control precedence", "level": 3 }, { "id": "h04--event-subscription", "anchor": "h04--event-subscription", "title": "H04 · Event subscription", "level": 3 }, { "id": "h05--request--reply-binding", "anchor": "h05--request--reply-binding", "title": "H05 · Request / reply binding", "level": 3 }, { "id": "h06--multiparty-session", "anchor": "h06--multiparty-session", "title": "H06 · Multiparty session", "level": 3 }, { "id": "h07--broadcast--fanout", "anchor": "h07--broadcast--fanout", "title": "H07 · Broadcast / fanout", "level": 3 }, { "id": "h08--merge-any", "anchor": "h08--merge-any", "title": "H08 · Merge-any", "level": 3 }, { "id": "h09--join-all", "anchor": "h09--join-all", "title": "H09 · Join-all", "level": 3 }, { "id": "h10--race--select", "anchor": "h10--race--select", "title": "H10 · Race / select", "level": 3 }, { "id": "h11--keyed-temporal-join", "anchor": "h11--keyed-temporal-join", "title": "H11 · Keyed temporal join", "level": 3 }, { "id": "h12--barrier--synchronization", "anchor": "h12--barrier--synchronization", "title": "H12 · Barrier / synchronization", "level": 3 }, { "id": "h13--quorum-requirement", "anchor": "h13--quorum-requirement", "title": "H13 · Quorum requirement", "level": 3 }, { "id": "h14--replica-group", "anchor": "h14--replica-group", "title": "H14 · Replica group", "level": 3 }, { "id": "h15--partition--route", "anchor": "h15--partition--route", "title": "H15 · Partition / route", "level": 3 }, { "id": "h16--atomic-authority-scope", "anchor": "h16--atomic-authority-scope", "title": "H16 · Atomic authority scope", "level": 3 }, { "id": "h17--compensation-relation", "anchor": "h17--compensation-relation", "title": "H17 · Compensation relation", "level": 3 }, { "id": "h18--supervision", "anchor": "h18--supervision", "title": "H18 · Supervision", "level": 3 }, { "id": "h19--ownership--containment", "anchor": "h19--ownership--containment", "title": "H19 · Ownership / containment", "level": 3 }, { "id": "h20--instantiation", "anchor": "h20--instantiation", "title": "H20 · Instantiation", "level": 3 }, { "id": "h21--placement", "anchor": "h21--placement", "title": "H21 · Placement", "level": 3 }, { "id": "h22--affinity--separation", "anchor": "h22--affinity--separation", "title": "H22 · Affinity / separation", "level": 3 }, { "id": "h23--scoped-authorization", "anchor": "h23--scoped-authorization", "title": "H23 · Scoped authorization", "level": 3 }, { "id": "h24--capability-resolution", "anchor": "h24--capability-resolution", "title": "H24 · Capability resolution", "level": 3 }, { "id": "h25--implements--source-ownership", "anchor": "h25--implements--source-ownership", "title": "H25 · Implements / source ownership", "level": 3 }, { "id": "h26--artifact-dependency", "anchor": "h26--artifact-dependency", "title": "H26 · Artifact dependency", "level": 3 }, { "id": "h27--derivation--provenance", "anchor": "h27--derivation--provenance", "title": "H27 · Derivation / provenance", "level": 3 }, { "id": "h28--evidence-supports-claim", "anchor": "h28--evidence-supports-claim", "title": "H28 · Evidence supports claim", "level": 3 }, { "id": "h29--activation-cohort", "anchor": "h29--activation-cohort", "title": "H29 · Activation cohort", "level": 3 }, { "id": "h30--boundary-export--alias", "anchor": "h30--boundary-export--alias", "title": "H30 · Boundary export / alias", "level": 3 }, { "id": "h31--clock--time-alignment", "anchor": "h31--clock--time-alignment", "title": "H31 · Clock / time alignment", "level": 3 }, { "id": "h32--tensor--algebraic-operation", "anchor": "h32--tensor--algebraic-operation", "title": "H32 · Tensor / algebraic operation", "level": 3 }, { "id": "h33--fallback--preference-set", "anchor": "h33--fallback--preference-set", "title": "H33 · Fallback / preference set", "level": 3 }, { "id": "h34--data-access--lineage", "anchor": "h34--data-access--lineage", "title": "H34 · Data access / lineage", "level": 3 }, { "id": "h35--state-migration", "anchor": "h35--state-migration", "title": "H35 · State migration", "level": 3 }, { "id": "h36--navigation--interaction-route", "anchor": "h36--navigation--interaction-route", "title": "H36 · Navigation / interaction route", "level": 3 }, { "id": "panel-nodes-1", "anchor": "panel-nodes-1", "title": "Node families · behavior", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat", "anchor": "boundary--caveat", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes", "anchor": "diagram-inspection-notes", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-nodes-2", "anchor": "panel-nodes-2", "title": "Node families · experience", "level": 2 }, { "id": "reaktor-design-decision-1", "anchor": "reaktor-design-decision-1", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-1", "anchor": "boundary--caveat-1", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-1", "anchor": "diagram-inspection-notes-1", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-nodes-3", "anchor": "panel-nodes-3", "title": "Node families · resources", "level": 2 }, { "id": "reaktor-design-decision-2", "anchor": "reaktor-design-decision-2", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-2", "anchor": "boundary--caveat-2", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-2", "anchor": "diagram-inspection-notes-2", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-nodes-4", "anchor": "panel-nodes-4", "title": "Node families · governance", "level": 2 }, { "id": "reaktor-design-decision-3", "anchor": "reaktor-design-decision-3", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-3", "anchor": "boundary--caveat-3", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-3", "anchor": "diagram-inspection-notes-3", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-ports-1", "anchor": "panel-ports-1", "title": "Port profiles · values & interaction", "level": 2 }, { "id": "reaktor-design-decision-4", "anchor": "reaktor-design-decision-4", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-4", "anchor": "boundary--caveat-4", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-4", "anchor": "diagram-inspection-notes-4", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-ports-2", "anchor": "panel-ports-2", "title": "Port profiles · lifetime & control", "level": 2 }, { "id": "reaktor-design-decision-5", "anchor": "reaktor-design-decision-5", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-5", "anchor": "boundary--caveat-5", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-5", "anchor": "diagram-inspection-notes-5", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-relations-1", "anchor": "panel-relations-1", "title": "Hyperedge patterns · flow & coordination", "level": 2 }, { "id": "reaktor-design-decision-6", "anchor": "reaktor-design-decision-6", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-6", "anchor": "boundary--caveat-6", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-6", "anchor": "diagram-inspection-notes-6", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-relations-2", "anchor": "panel-relations-2", "title": "Hyperedge patterns · state & structure", "level": 2 }, { "id": "reaktor-design-decision-7", "anchor": "reaktor-design-decision-7", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-7", "anchor": "boundary--caveat-7", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-7", "anchor": "diagram-inspection-notes-7", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-relations-3", "anchor": "panel-relations-3", "title": "Hyperedge patterns · meaning & change", "level": 2 }, { "id": "reaktor-design-decision-8", "anchor": "reaktor-design-decision-8", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-8", "anchor": "boundary--caveat-8", "title": "Boundary / caveat", "level": 3 }, { "id": "diagram-inspection-notes-8", "anchor": "diagram-inspection-notes-8", "title": "Diagram inspection notes", "level": 3 }, { "id": "panel-vocabulary", "anchor": "panel-vocabulary", "title": "Node, port and hyperedge catalog", "level": 2 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-1" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-1" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-2" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-2" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-3" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-3" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-4" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-5" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-6" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-6" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-7" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-7" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-8" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-8" } ] }, { "id": "architecture-atlas-workbench", "kind": "design", "owner": "Reaktor / Astra", "summary": "Astra architecture synthesis: authoring and industry precedents. Design claims and falsifiable acceptance obligations.", "use": "Read alongside the current module and qualification chapters; this source is a design synthesis.", "diagrams": [ { "id": "synthesis", "src": "/docs/img/architecture-atlas/synthesis.svg", "alt": "Five product lessons, one distributed-system language", "text": "Stately\nBehavior is executable,\ninspectable state—not a\nflowchart\napproximation.\nStatecharts + actors\nUnreal / Blueprints\nA powerful engine\nexposes curated\nprimitives to a visual\nlanguage.\nEngine + visual language\nCursor\nSource editing, agent\ncontext and review\nbelong in the main\nworkbench.\nCode + agent workflow\nFlutterFlow\nStart from the product\nthe user is building,\nthen expose its\nbehavior.\nProduct + interactions\nExpo\nSeparate the installed\nnative runtime from\ncompatible updateable\ncontent.\nHost-aware releases\nReaktor Blueprint = a language for complete systems\nOne semantic graph • typed ports • reusable regions • explicit runtime boundaries\nMultiple editing modes, specialized execution, shared authority and evidence\nAuthor\nGraph / statechart / source\nProduct preview + agent edits\nQualify\nTypes, effects, compatibility\nShadow + independent policy\nRealize\nSigned region release\nPer-host prepare and activation\nObserve\nRevision + activation + trace\nFindings return to the same IDs\nThis is a synthesis of responsibilities, not a claim that any precedent supplies the whole architecture.\nProposed integration: keep the editor, semantic model, runtime and delivery protocol separate but coherent.", "inspectors": [] }, { "id": "studio", "src": "/docs/img/architecture-atlas/studio.svg", "alt": "One selected region synchronizes product, graph, code and evidence", "text": "REAKTOR STUDIO / Session feature\nDRAFT r108 HOST: preview-7 ACTUAL: r104\nModule palette\nCompatible with session.in\nStatechart / actor\nRequest operation\nDurable workflow\nNative adapter\nReusable region\nTest / assertion\nFilter by selected port\nComposition lens — region: session.join\nJoin intent\nrequest : Join\nSession actor\nevent : Join\nstate : Session\nResult authority\ncommit : Result\nSelected contract\nJoinRequest × SessionProtocol × tenant grant × owned session\n2 required pins unbound — saveable draft\nSource + agent\nregion SessionJoin {\nreceive JoinRequest\nrequire SessionGrant\nawait session.join(request)\nreturn durableReceipt\n}\nSource owner: structured region\nProduct preview\nJoin session\nContinue • pending receipt\nExecution + evidence\nTrace: Join → admitted → committed → receipt\nPinned: candidate r108 + artifact sha256:… + scenario v4\nProduction is not paused by stepping a Shadow instance.\nAgent patch: 3 entities changed • 2 consumers affected\nIntent → typed patch → review → Shadow → promotion → per-host activation\nA checkpoint restores a workspace. It does not undo a payment or a database migration.\nIllustrative workbench mock. Context-sensitive actions share command IDs and authority; there is no backend connection.", "inspectors": [] }, { "id": "precedents", "src": "/docs/img/architecture-atlas/precedents.svg", "alt": "Do not base differentiation on a familiar primitive", "text": "PRECEDENT MAP • REAKTOR’S OPPORTUNITY IS THE COMPOSITION\nPtolemy II\nHierarchical ports + execution\nprofiles\nMLIR\nDialects + qualified lowering\nMPS\nProjectional editing + agent\ntools\nDatabase systems\nAtomic change + isolation\nFoundationDB\nSimulation-supported evolution\nKubernetes / OTP\nReconciliation + live release\nReaktor: shared identity, contracts and governed change across the lifecycle\nThese precedents support specific mechanisms. None is evidence that the complete Reaktor composition already works.", "inspectors": [] } ], "region": "architecture-atlas-book", "order": 5, "title": "Authoring and industry precedents", "nav": "Authoring and industry precedents", "group": "architecture-atlas", "subsection": "architecture-atlas-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/architecture-atlas-workbench", "revision": "44cfae3ea4d1afc24846b9f1ad0b12050a6cf82a8e46fde68158d6f2f060410d", "status": "design", "renderingRevision": "350ded1077b0fcc62e5749cfd154174bc2989eccede34d4d14baff40ea738f03", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "astra-architecture-atlas-2026-10-07", "title": "Reaktor architecture, language and graph atlas", "date": "2026-10-07", "revision": "71c9cdc97b480ad08a50d5bb8d1c14c8fb49edb0d4d97f9c0f65f0d6468a324a", "coverage": [ "panel-synthesis", "panel-studio", "panel-precedents" ] } ], "anchors": [], "externalLinks": [ "https://stately.ai/docs/inspection", "https://dev.epicgames.com/documentation/en-us/unreal-engine/blueprint-debugger-in-unreal-engine", "https://cursor.com/docs/agent/overview", "https://docs.flutterflow.io/resources/functions/action-flow-editor/", "https://stately.ai/docs", "https://stately.ai/docs/state-machines-and-statecharts", "https://stately.ai/docs/actors", "https://dev.epicgames.com/documentation/unreal-engine/introduction-to-blueprints-visual-scripting-in-unreal-engine", "https://dev.epicgames.com/documentation/unreal-engine/technical-guide-for-blueprints-visual-scripting-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/cooking-content-in-unreal-engine", "https://cursor.com/docs/agent/security", "https://cursor.com/docs/rules", "https://docs.flutterflow.io/concepts/custom-code/", "https://docs.flutterflow.io/resources/ui/components/creating-components", "https://docs.expo.dev/develop/development-builds/introduction/", "https://docs.expo.dev/eas-update/runtime-versions/", "https://docs.expo.dev/eas-update/code-signing/", "https://docs.expo.dev/eas-update/rollouts/", "https://ptolemy.berkeley.edu/ptolemyII/ptIIfaq.htm", "https://mlir.llvm.org/docs/DialectConversion/", "https://www.jetbrains.com/help/mps/mps-projectional-agent-toolkit.html", "https://www.foundationdb.org/files/fdb-paper.pdf", "https://kubernetes.io/docs/concepts/architecture/controller/", "https://www.erlang.org/doc/system/release_handling.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/architecture-atlas-workbench", "polarity": "Neutral" }, { "id": "section-13-authoring-workbench-and-product-precedents", "anchor": "13-authoring-workbench-and-product-precedents", "label": "13. Authoring workbench and product precedents", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-workbench#13-authoring-workbench-and-product-precedents", "polarity": "Neutral" }, { "id": "section-panel-synthesis", "anchor": "panel-synthesis", "label": "Stately, Unreal, Cursor, FlutterFlow and Expo", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-workbench#panel-synthesis", "polarity": "Neutral" }, { "id": "section-panel-studio", "anchor": "panel-studio", "label": "Synchronized authoring and inspection views", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-workbench#panel-studio", "polarity": "Neutral" }, { "id": "section-panel-precedents", "anchor": "panel-precedents", "label": "Do not base differentiation on a familiar primitive", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-workbench#panel-precedents", "polarity": "Neutral" }, { "id": "section-boundary--caveat-1", "anchor": "boundary--caveat-1", "label": "Boundary / caveat", "profile": "section", "contract": "https://reaktor.build/docs/architecture-atlas-workbench#boundary--caveat-1", "polarity": "Neutral" } ], "relations": [ { "id": "architecture-atlas-workbench:references-architecture-atlas-foundations", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-workbench:references-architecture-atlas-vocabulary", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-workbench:references-architecture-atlas-semantics", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-workbench:references-architecture-atlas-language", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-workbench:references-architecture-atlas-evolution", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-workbench:references-architecture-atlas-scenarios", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-scenarios", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-workbench:references-architecture-atlas-qualification", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "architecture-atlas-workbench:references-reaktor-visual-language", "kind": "references", "owner": "architecture-atlas-workbench", "incidences": [ { "node": "architecture-atlas-workbench", "port": "section-boundary--caveat-1", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "architecture-atlas-workbench.json", "sections": [ { "id": "authoring-and-industry-precedents", "anchor": "authoring-and-industry-precedents", "title": "Authoring and industry precedents", "level": 1 }, { "id": "13-authoring-workbench-and-product-precedents", "anchor": "13-authoring-workbench-and-product-precedents", "title": "13. Authoring workbench and product precedents", "level": 2 }, { "id": "stately--xstate", "anchor": "stately--xstate", "title": "Stately / XState", "level": 3 }, { "id": "unreal-engine--blueprints", "anchor": "unreal-engine--blueprints", "title": "Unreal Engine / Blueprints", "level": 3 }, { "id": "cursor", "anchor": "cursor", "title": "Cursor", "level": 3 }, { "id": "flutterflow", "anchor": "flutterflow", "title": "FlutterFlow", "level": 3 }, { "id": "expo", "anchor": "expo", "title": "Expo", "level": 3 }, { "id": "panel-synthesis", "anchor": "panel-synthesis", "title": "Stately, Unreal, Cursor, FlutterFlow and Expo", "level": 2 }, { "id": "reaktor-design-decision", "anchor": "reaktor-design-decision", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat", "anchor": "boundary--caveat", "title": "Boundary / caveat", "level": 3 }, { "id": "panel-studio", "anchor": "panel-studio", "title": "Synchronized authoring and inspection views", "level": 2 }, { "id": "reaktor-design-decision-1", "anchor": "reaktor-design-decision-1", "title": "Reaktor design decision", "level": 3 }, { "id": "boundary--caveat-1", "anchor": "boundary--caveat-1", "title": "Boundary / caveat", "level": 3 }, { "id": "panel-precedents", "anchor": "panel-precedents", "title": "Do not base differentiation on a familiar primitive", "level": 2 }, { "id": "reaktor-design-decision-2", "anchor": "reaktor-design-decision-2", "title": "Reaktor design decision", "level": 3 }, { "id": "what-this-does-not-establish", "anchor": "what-this-does-not-establish", "title": "What this does not establish", "level": 3 } ], "links": [ { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-vocabulary", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-semantics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-language", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-scenarios", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "boundary--caveat-1" } ] }, { "id": "astra-reaktor-plan-and-roadmap", "owner": "Astra / Codex", "kind": "strategy", "summary": "Reaktor's software-forge north star: create and evolve apps with a live graph, actors, capabilities, polyglot FFI, formal methods and Claude/Codex; current system status and a two-developer roadmap to December 2026 public v1 and September 2027.", "use": "Start here for the north star, greenfield builder experience, system status, competitive strategy, release scope and measurable delivery gates.", "region": "start-here-core", "order": 3, "title": "Astra Reaktor Plan and Roadmap", "nav": "Astra Plan and Roadmap", "group": "start-here", "subsection": "start-here-core", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap", "revision": "2928edd4e3d0d1f4944ff50f4d660fab29400037b3c0f5a56c019680093bd800", "status": "design", "renderingRevision": "df34c855db425605cff7ac65b29d199dfa9254800025f25c681c72a69b1a145e", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://reaktor.build/private/astra-analysis", "https://cursor.com/docs/agent/overview", "https://cursor.com/docs/cloud-agent", "https://emergent.sh/blog/introducing-e-3-autonomous-app-building-on-emergent", "https://help.emergent.sh/web-mobile", "https://docs.rork.com/expo", "https://docs.rork.com/backend/rork-cloud", "https://docs.lovable.dev/introduction/getting-started", "https://docs.lovable.dev/features/design-guidance", "https://docs.lovable.dev/features/testing", "https://support.bolt.new/integrations/figma", "https://support.bolt.new/cloud/database", "https://support.bolt.new/integrations/git", "https://support.bolt.new/building/using-bolt/collaborate", "https://docs.replit.com/build/your-first-app", "https://docs.replit.com/build/mobile-app", "https://v0.dev/docs/full-stack-apps", "https://v0.app/changelog", "https://encore.dev/docs/understanding-encore", "https://docs.temporal.io/temporal", "https://docs.dapr.io/concepts/building-blocks-concept/", "https://aspire.dev/architecture/resource-model/", "https://modelcontextprotocol.io/docs/2026-07-28/learn/architecture", "https://opentelemetry.io/docs/concepts/signals/", "https://mlir.llvm.org/docs/Interfaces/", "https://dev.epicgames.com/documentation/en-us/unreal-engine/coding-in-unreal-engine-blueprint-vs-cplusplus", "https://mlir.llvm.org/docs/PassManagement/", "https://kotlinlang.org/docs/multiplatform/supported-platforms.html", "https://kotlinlang.org/docs/coroutines-overview.html", "https://kotlinlang.org/docs/ksp-overview.html", "https://kotlinlang.org/docs/compiler-plugins-overview.html", "https://learn.microsoft.com/en-us/dotnet/orleans/implementation/scheduler", "https://quint.sh/docs", "https://a2a-protocol.org/latest/specification/", "https://www.doc.ic.ac.uk/~yoshida/multiparty/multiparty.pdf", "https://developers.cloudflare.com/durable-objects/best-practices/rules-of-durable-objects/", "https://www.postgresql.org/docs/current/transaction-iso.html", "https://developers.cloudflare.com/r2/reference/consistency/", "https://docs.cloud.google.com/pubsub/docs/ordering", "https://docs.cloud.google.com/pubsub/docs/exactly-once-delivery", "https://developers.cloudflare.com/queues/reference/delivery-guarantees/", "https://developers.cloudflare.com/queues/reference/how-queues-works/", "https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-state-flow/", "https://grpc.io/docs/guides/flow-control/", "https://kotlinlang.org/docs/native-c-interop.html", "https://flatbuffers.dev/flexbuffers/", "https://arrow.apache.org/docs/format/CDataInterface.html", "https://github.com/grpc/grpc-web", "https://kotlinlang.org/docs/js-to-kotlin-interop.html", "https://kotlinlang.org/docs/wasm-js-interop.html", "https://docs.flutter.dev/platform-integration/platform-channels", "https://api.dart.dev/dart-ffi/NativeCallable/NativeCallable.listener.html", "https://docs.python.org/3/c-api/threads.html", "https://docs.python.org/3/c-api/buffer.html", "https://developer.apple.com/app-store/review/guidelines/", "https://support.google.com/googleplay/android-developer/answer/16559646?hl=en" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap", "polarity": "Neutral" }, { "id": "section-1-the-north-star", "anchor": "1-the-north-star", "label": "1. The north star", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#1-the-north-star", "polarity": "Neutral" }, { "id": "section-2-the-strategic-bet-and-the-standard-of-proof", "anchor": "2-the-strategic-bet-and-the-standard-of-proof", "label": "2. The strategic bet and the standard of proof", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#2-the-strategic-bet-and-the-standard-of-proof", "polarity": "Neutral" }, { "id": "section-3-greenfield-creation-is-a-first-class-product", "anchor": "3-greenfield-creation-is-a-first-class-product", "label": "3. Greenfield creation is a first-class product", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#3-greenfield-creation-is-a-first-class-product", "polarity": "Neutral" }, { "id": "section-4-the-engine-behind-creation", "anchor": "4-the-engine-behind-creation", "label": "4. The engine behind creation", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#4-the-engine-behind-creation", "polarity": "Neutral" }, { "id": "section-5-competing-with-builders-and-learning-from-infrastructure", "anchor": "5-competing-with-builders-and-learning-from-infrastructure", "label": "5. Competing with builders and learning from infrastructure", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#5-competing-with-builders-and-learning-from-infrastructure", "polarity": "Neutral" }, { "id": "section-6-the-core-a-live-model-with-a-small-semantic-kernel", "anchor": "6-the-core-a-live-model-with-a-small-semantic-kernel", "label": "6. The core: a live model with a small semantic kernel", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#6-the-core-a-live-model-with-a-small-semantic-kernel", "polarity": "Neutral" }, { "id": "section-8-a-generating-basis-modules-features-and-capabilities", "anchor": "8-a-generating-basis-modules-features-and-capabilities", "label": "8. A generating basis: modules, features and capabilities", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#8-a-generating-basis-modules-features-and-capabilities", "polarity": "Neutral" }, { "id": "section-9-runtime-actors-and-safe-live-evolution", "anchor": "9-runtime-actors-and-safe-live-evolution", "label": "9. Runtime, actors and safe live evolution", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#9-runtime-actors-and-safe-live-evolution", "polarity": "Neutral" }, { "id": "section-10-formal-methods-and-simulation-as-everyday-development-tools", "anchor": "10-formal-methods-and-simulation-as-everyday-development-tools", "label": "10. Formal methods and simulation as everyday development tools", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#10-formal-methods-and-simulation-as-everyday-development-tools", "polarity": "Neutral" }, { "id": "section-11-claude-codex-and-an-agent-native-system-interface", "anchor": "11-claude-codex-and-an-agent-native-system-interface", "label": "11. Claude, Codex and an agent-native system interface", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#11-claude-codex-and-an-agent-native-system-interface", "polarity": "Neutral" }, { "id": "section-13-polyglot-contracts-ffi-and-data-oriented-execution", "anchor": "13-polyglot-contracts-ffi-and-data-oriented-execution", "label": "13. Polyglot contracts, FFI and data-oriented execution", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#13-polyglot-contracts-ffi-and-data-oriented-execution", "polarity": "Neutral" }, { "id": "section-17-what-public-v1-means", "anchor": "17-what-public-v1-means", "label": "17. What public v1 means", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#17-what-public-v1-means", "polarity": "Neutral" }, { "id": "section-21-measuring-whether-reaktor-is-winning", "anchor": "21-measuring-whether-reaktor-is-winning", "label": "21. Measuring whether Reaktor is winning", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#21-measuring-whether-reaktor-is-winning", "polarity": "Neutral" }, { "id": "section-19-roadmap-from-september-2026-to-september-2027", "anchor": "19-roadmap-from-september-2026-to-september-2027", "label": "19. Roadmap from September 2026 to September 2027", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#19-roadmap-from-september-2026-to-september-2027", "polarity": "Neutral" }, { "id": "section-18-the-release-must-prove-four-complete-journeys", "anchor": "18-the-release-must-prove-four-complete-journeys", "label": "18. The release must prove four complete journeys", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#18-the-release-must-prove-four-complete-journeys", "polarity": "Neutral" }, { "id": "section-7-kotlin-and-the-public-programming-model", "anchor": "7-kotlin-and-the-public-programming-model", "label": "7. Kotlin and the public programming model", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#7-kotlin-and-the-public-programming-model", "polarity": "Neutral" }, { "id": "section-12-flows-choreography-and-the-opinionated-datacloud-stack", "anchor": "12-flows-choreography-and-the-opinionated-datacloud-stack", "label": "12. Flows, choreography and the opinionated data/cloud stack", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#12-flows-choreography-and-the-opinionated-datacloud-stack", "polarity": "Neutral" }, { "id": "section-14-studio-ides-and-tools-that-gain-power-from-the-graph", "anchor": "14-studio-ides-and-tools-that-gain-power-from-the-graph", "label": "14. Studio, IDEs and tools that gain power from the graph", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#14-studio-ides-and-tools-that-gain-power-from-the-graph", "polarity": "Neutral" }, { "id": "section-15-build-deploy-and-operate-one-reproducible-system", "anchor": "15-build-deploy-and-operate-one-reproducible-system", "label": "15. Build, deploy and operate one reproducible system", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#15-build-deploy-and-operate-one-reproducible-system", "polarity": "Neutral" }, { "id": "section-20-non-negotiable-december-release-gates", "anchor": "20-non-negotiable-december-release-gates", "label": "20. Non-negotiable December release gates", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#20-non-negotiable-december-release-gates", "polarity": "Neutral" }, { "id": "section-22-adoption-distribution-and-the-ten-year-position", "anchor": "22-adoption-distribution-and-the-ten-year-position", "label": "22. Adoption, distribution and the ten-year position", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#22-adoption-distribution-and-the-ten-year-position", "polarity": "Neutral" }, { "id": "section-16-current-system-map-and-intended-progression", "anchor": "16-current-system-map-and-intended-progression", "label": "16. Current system map and intended progression", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#16-current-system-map-and-intended-progression", "polarity": "Neutral" }, { "id": "section-the-central-design-improvement", "anchor": "the-central-design-improvement", "label": "The central design improvement", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#the-central-design-improvement", "polarity": "Neutral" }, { "id": "section-from-an-idea-to-an-application", "anchor": "from-an-idea-to-an-application", "label": "From an idea to an application", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#from-an-idea-to-an-application", "polarity": "Neutral" }, { "id": "section-four-linked-planes", "anchor": "four-linked-planes", "label": "Four linked semantic domains", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#four-linked-planes", "polarity": "Neutral" }, { "id": "section-graph-transformations-acquire-explicit-laws", "anchor": "graph-transformations-acquire-explicit-laws", "label": "Graph transformations acquire explicit laws", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#graph-transformations-acquire-explicit-laws", "polarity": "Neutral" }, { "id": "section-declarative-architecture-with-ordinary-code-inside", "anchor": "declarative-architecture-with-ordinary-code-inside", "label": "Declarative architecture with ordinary code inside", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#declarative-architecture-with-ordinary-code-inside", "polarity": "Neutral" }, { "id": "section-graceful-degradation-is-executable-product-behavior", "anchor": "graceful-degradation-is-executable-product-behavior", "label": "Graceful degradation is executable product behavior", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#graceful-degradation-is-executable-product-behavior", "polarity": "Neutral" }, { "id": "section-marked-graph-regions-and-code-push", "anchor": "marked-graph-regions-and-code-push", "label": "Marked graph regions and code push", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#marked-graph-regions-and-code-push", "polarity": "Neutral" }, { "id": "section-a-practical-chain-from-specification-to-runtime", "anchor": "a-practical-chain-from-specification-to-runtime", "label": "A practical chain from specification to runtime", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#a-practical-chain-from-specification-to-runtime", "polarity": "Neutral" }, { "id": "section-evidence-composes-and-expires-with-its-assumptions", "anchor": "evidence-composes-and-expires-with-its-assumptions", "label": "Evidence composes and expires with its assumptions", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#evidence-composes-and-expires-with-its-assumptions", "polarity": "Neutral" }, { "id": "section-ai-inside-the-generated-application", "anchor": "ai-inside-the-generated-application", "label": "AI inside the generated application", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#ai-inside-the-generated-application", "polarity": "Neutral" }, { "id": "section-offline-and-external-integrations-are-first-class-behaviors", "anchor": "offline-and-external-integrations-are-first-class-behaviors", "label": "Offline and external integrations are first-class behaviors", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#offline-and-external-integrations-are-first-class-behaviors", "polarity": "Neutral" }, { "id": "section-evidence-and-sequencing", "anchor": "evidence-and-sequencing", "label": "Evidence and sequencing", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#evidence-and-sequencing", "polarity": "Neutral" }, { "id": "section-a-worked-north-star-scenario", "anchor": "a-worked-north-star-scenario", "label": "A worked north-star scenario", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#a-worked-north-star-scenario", "polarity": "Neutral" }, { "id": "section-release-and-recovery-are-graph-operations-with-real-state", "anchor": "release-and-recovery-are-graph-operations-with-real-state", "label": "Release and recovery are graph operations with real state", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#release-and-recovery-are-graph-operations-with-real-state", "polarity": "Neutral" }, { "id": "section-24-reading-map-and-maintenance-contract", "anchor": "24-reading-map-and-maintenance-contract", "label": "24. Reading map and maintenance contract", "profile": "section", "contract": "https://reaktor.build/docs/astra-reaktor-plan-and-roadmap#24-reading-map-and-maintenance-contract", "polarity": "Neutral" } ], "relations": [ { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-essays", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-the-central-design-improvement", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-from-an-idea-to-an-application", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-workbench-roadmap", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-from-an-idea-to-an-application", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-unified-system-graph", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-6-the-core-a-live-model-with-a-small-semantic-kernel", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-unified-system-graph-continuous-zoom", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-four-linked-planes", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-continuous-zoom", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-unified-system-graph-flow-entrypoints", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-four-linked-planes", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-flow-entrypoints", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-graph-kernel-analysis", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-graph-transformations-acquire-explicit-laws", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor_graph_visitors_design", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-graph-transformations-acquire-explicit-laws", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-graph-transformations-acquire-explicit-laws", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-megascale-strategy", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-graph-transformations-acquire-explicit-laws", "role": "source", "ordinal": 0 }, { "node": "reaktor-megascale-strategy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-framework-overview", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-declarative-architecture-with-ordinary-code-inside", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-core", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-declarative-architecture-with-ordinary-code-inside", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-service", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-declarative-architecture-with-ordinary-code-inside", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-surface-renderers", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-declarative-architecture-with-ordinary-code-inside", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-visual-language", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-declarative-architecture-with-ordinary-code-inside", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-capability", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-graceful-degradation-is-executable-product-behavior", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-notifications-design", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-graceful-degradation-is-executable-product-behavior", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-component-lifecycle", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-marked-graph-regions-and-code-push", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-actor-model", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-marked-graph-regions-and-code-push", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-distributed-actors", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-marked-graph-regions-and-code-push", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-graph-migration-plan", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-marked-graph-regions-and-code-push", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-ffi-design", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-marked-graph-regions-and-code-push", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-formal-methods", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-a-practical-chain-from-specification-to-runtime", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-evidence-composes-and-expires-with-its-assumptions", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-agentic-tooling", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-ai-inside-the-generated-application", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-koog-workbench", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-ai-inside-the-generated-application", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-koog-agents", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-ai-inside-the-generated-application", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-browser-local-ai", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-ai-inside-the-generated-application", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-db", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-offline-and-external-integrations-are-first-class-behaviors", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-server", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-offline-and-external-integrations-are-first-class-behaviors", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-bus-mesh", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-offline-and-external-integrations-are-first-class-behaviors", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-mesh", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-offline-and-external-integrations-are-first-class-behaviors", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-work", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-offline-and-external-integrations-are-first-class-behaviors", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-flexbuffer-performance-review", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-evidence-and-sequencing", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-evidence-and-sequencing", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-flexbuffer-implementation", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-evidence-and-sequencing", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-flexbuffer-improvement-plan", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-evidence-and-sequencing", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-improvement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-ffi", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-evidence-and-sequencing", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-performance-observability", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-evidence-and-sequencing", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-desktop-master-plan", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-a-worked-north-star-scenario", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-a-worked-north-star-scenario", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-build-tools", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-release-and-recovery-are-graph-operations-with-real-state", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-dependeasy", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-release-and-recovery-are-graph-operations-with-real-state", "role": "source", "ordinal": 0 }, { "node": "reaktor-dependeasy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-cli", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-release-and-recovery-are-graph-operations-with-real-state", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-devops", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-release-and-recovery-are-graph-operations-with-real-state", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-cloud-pane", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-release-and-recovery-are-graph-operations-with-real-state", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-shadow-dev-environment", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-release-and-recovery-are-graph-operations-with-real-state", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-module-review", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-24-reading-map-and-maintenance-contract", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-module-execution-plan", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-24-reading-map-and-maintenance-contract", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "astra-reaktor-plan-and-roadmap:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "astra-reaktor-plan-and-roadmap", "incidences": [ { "node": "astra-reaktor-plan-and-roadmap", "port": "section-24-reading-map-and-maintenance-contract", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "astra-reaktor-plan-and-roadmap.json", "sections": [ { "id": "astra-reaktor-plan-and-roadmap", "anchor": "astra-reaktor-plan-and-roadmap", "title": "Astra Reaktor Plan and Roadmap", "level": 1 }, { "id": "1-the-north-star", "anchor": "1-the-north-star", "title": "1. The north star", "level": 2 }, { "id": "the-central-design-improvement", "anchor": "the-central-design-improvement", "title": "The central design improvement", "level": 3 }, { "id": "2-the-strategic-bet-and-the-standard-of-proof", "anchor": "2-the-strategic-bet-and-the-standard-of-proof", "title": "2. The strategic bet and the standard of proof", "level": 2 }, { "id": "overall-design-review-what-to-retain-and-what-to-improve", "anchor": "overall-design-review-what-to-retain-and-what-to-improve", "title": "Overall design review: what to retain and what to improve", "level": 3 }, { "id": "the-improvements-that-should-distinguish-the-engine", "anchor": "the-improvements-that-should-distinguish-the-engine", "title": "The improvements that should distinguish the engine", "level": 3 }, { "id": "3-greenfield-creation-is-a-first-class-product", "anchor": "3-greenfield-creation-is-a-first-class-product", "title": "3. Greenfield creation is a first-class product", "level": 2 }, { "id": "from-an-idea-to-an-application", "anchor": "from-an-idea-to-an-application", "title": "From an idea to an application", "level": 3 }, { "id": "full-stack-features-as-the-building-material", "anchor": "full-stack-features-as-the-building-material", "title": "Full-stack features as the building material", "level": 3 }, { "id": "design-quality-belongs-on-the-critical-path", "anchor": "design-quality-belongs-on-the-critical-path", "title": "Design quality belongs on the critical path", "level": 3 }, { "id": "build-apps-that-can-outgrow-their-first-prompt", "anchor": "build-apps-that-can-outgrow-their-first-prompt", "title": "Build apps that can outgrow their first prompt", "level": 3 }, { "id": "4-the-engine-behind-creation", "anchor": "4-the-engine-behind-creation", "title": "4. The engine behind creation", "level": 2 }, { "id": "5-competing-with-builders-and-learning-from-infrastructure", "anchor": "5-competing-with-builders-and-learning-from-infrastructure", "title": "5. Competing with builders and learning from infrastructure", "level": 2 }, { "id": "6-the-core-a-live-model-with-a-small-semantic-kernel", "anchor": "6-the-core-a-live-model-with-a-small-semantic-kernel", "title": "6. The core: a live model with a small semantic kernel", "level": 2 }, { "id": "a-small-nucleus-and-extensible-domain-semantics", "anchor": "a-small-nucleus-and-extensible-domain-semantics", "title": "A small nucleus and extensible domain semantics", "level": 3 }, { "id": "four-linked-planes", "anchor": "four-linked-planes", "title": "Four linked semantic domains", "level": 3 }, { "id": "local-runtime-islands-and-a-federated-live-view", "anchor": "local-runtime-islands-and-a-federated-live-view", "title": "Local runtime islands and a federated live view", "level": 3 }, { "id": "keep-the-graph-alive-while-specializing-execution", "anchor": "keep-the-graph-alive-while-specializing-execution", "title": "Keep the graph alive while specializing execution", "level": 3 }, { "id": "visitors-become-reusable-analyses-and-transformations", "anchor": "visitors-become-reusable-analyses-and-transformations", "title": "Visitors become reusable analyses and transformations", "level": 3 }, { "id": "graph-transformations-acquire-explicit-laws", "anchor": "graph-transformations-acquire-explicit-laws", "title": "Graph transformations acquire explicit laws", "level": 3 }, { "id": "7-kotlin-and-the-public-programming-model", "anchor": "7-kotlin-and-the-public-programming-model", "title": "7. Kotlin and the public programming model", "level": 2 }, { "id": "why-kotlin-is-the-center", "anchor": "why-kotlin-is-the-center", "title": "Why Kotlin is the center", "level": 3 }, { "id": "two-entrances-one-set-of-mechanisms", "anchor": "two-entrances-one-set-of-mechanisms", "title": "Two entrances, one set of mechanisms", "level": 3 }, { "id": "declarative-architecture-with-ordinary-code-inside", "anchor": "declarative-architecture-with-ordinary-code-inside", "title": "Declarative architecture with ordinary code inside", "level": 3 }, { "id": "8-a-generating-basis-modules-features-and-capabilities", "anchor": "8-a-generating-basis-modules-features-and-capabilities", "title": "8. A generating basis: modules, features and capabilities", "level": 2 }, { "id": "separate-structural-vocabulary-behavior-and-product-recipes", "anchor": "separate-structural-vocabulary-behavior-and-product-recipes", "title": "Separate structural vocabulary, behavior and product recipes", "level": 3 }, { "id": "a-module-carries-its-operating-contract", "anchor": "a-module-carries-its-operating-contract", "title": "A module carries its operating contract", "level": 3 }, { "id": "feature-capability-becomes-an-adaptive-composition-system", "anchor": "feature-capability-becomes-an-adaptive-composition-system", "title": "Feature-capability becomes an adaptive composition system", "level": 3 }, { "id": "graceful-degradation-is-executable-product-behavior", "anchor": "graceful-degradation-is-executable-product-behavior", "title": "Graceful degradation is executable product behavior", "level": 3 }, { "id": "9-runtime-actors-and-safe-live-evolution", "anchor": "9-runtime-actors-and-safe-live-evolution", "title": "9. Runtime, actors and safe live evolution", "level": 2 }, { "id": "declaration-preparation-publication-and-reconciliation", "anchor": "declaration-preparation-publication-and-reconciliation", "title": "Declaration, preparation, publication and reconciliation", "level": 3 }, { "id": "actors-own-decisions-not-merely-a-dispatcher", "anchor": "actors-own-decisions-not-merely-a-dispatcher", "title": "Actors own decisions, not merely a dispatcher", "level": 3 }, { "id": "admission-deadlines-and-message-outcomes", "anchor": "admission-deadlines-and-message-outcomes", "title": "Admission, deadlines and message outcomes", "level": 3 }, { "id": "durable-state-and-effect-completion", "anchor": "durable-state-and-effect-completion", "title": "Durable state and effect completion", "level": 3 }, { "id": "supervision-passivation-and-placement", "anchor": "supervision-passivation-and-placement", "title": "Supervision, passivation and placement", "level": 3 }, { "id": "marked-graph-regions-and-code-push", "anchor": "marked-graph-regions-and-code-push", "title": "Marked graph regions and code push", "level": 3 }, { "id": "10-formal-methods-and-simulation-as-everyday-development-tools", "anchor": "10-formal-methods-and-simulation-as-everyday-development-tools", "title": "10. Formal methods and simulation as everyday development tools", "level": 2 }, { "id": "match-the-method-to-the-claim", "anchor": "match-the-method-to-the-claim", "title": "Match the method to the claim", "level": 3 }, { "id": "a-practical-chain-from-specification-to-runtime", "anchor": "a-practical-chain-from-specification-to-runtime", "title": "A practical chain from specification to runtime", "level": 3 }, { "id": "deterministic-scenarios-over-the-actual-composition", "anchor": "deterministic-scenarios-over-the-actual-composition", "title": "Deterministic scenarios over the actual composition", "level": 3 }, { "id": "evidence-composes-and-expires-with-its-assumptions", "anchor": "evidence-composes-and-expires-with-its-assumptions", "title": "Evidence composes and expires with its assumptions", "level": 3 }, { "id": "11-claude-codex-and-an-agent-native-system-interface", "anchor": "11-claude-codex-and-an-agent-native-system-interface", "title": "11. Claude, Codex and an agent-native system interface", "level": 2 }, { "id": "a-richer-interface-than-isolated-tool-calls", "anchor": "a-richer-interface-than-isolated-tool-calls", "title": "A richer interface than isolated tool calls", "level": 3 }, { "id": "make-each-unit-of-context-do-more-work", "anchor": "make-each-unit-of-context-do-more-work", "title": "Make each unit of context do more work", "level": 3 }, { "id": "acceleration-that-compounds-across-model-generations", "anchor": "acceleration-that-compounds-across-model-generations", "title": "Acceleration that compounds across model generations", "level": 3 }, { "id": "ai-inside-the-generated-application", "anchor": "ai-inside-the-generated-application", "title": "AI inside the generated application", "level": 3 }, { "id": "12-flows-choreography-and-the-opinionated-datacloud-stack", "anchor": "12-flows-choreography-and-the-opinionated-datacloud-stack", "title": "12. Flows, choreography and the opinionated data/cloud stack", "level": 2 }, { "id": "values-requests-durable-work-and-conversations", "anchor": "values-requests-durable-work-and-conversations", "title": "Values, requests, durable work and conversations", "level": 3 }, { "id": "deep-defaults-explicit-provider-semantics", "anchor": "deep-defaults-explicit-provider-semantics", "title": "Deep defaults, explicit provider semantics", "level": 3 }, { "id": "one-authority-per-datum-explicit-projections-and-completion", "anchor": "one-authority-per-datum-explicit-projections-and-completion", "title": "One authority per datum, explicit projections and completion", "level": 3 }, { "id": "offline-and-external-integrations-are-first-class-behaviors", "anchor": "offline-and-external-integrations-are-first-class-behaviors", "title": "Offline and external integrations are first-class behaviors", "level": 3 }, { "id": "13-polyglot-contracts-ffi-and-data-oriented-execution", "anchor": "13-polyglot-contracts-ffi-and-data-oriented-execution", "title": "13. Polyglot contracts, FFI and data-oriented execution", "level": 2 }, { "id": "one-contract-compiler-idiomatic-language-surfaces", "anchor": "one-contract-compiler-idiomatic-language-surfaces", "title": "One contract compiler, idiomatic language surfaces", "level": 3 }, { "id": "calls-and-streams-with-bounded-resource-semantics", "anchor": "calls-and-streams-with-bounded-resource-semantics", "title": "Calls and streams with bounded resource semantics", "level": 3 }, { "id": "the-abi-is-an-ownership-and-lifecycle-contract", "anchor": "the-abi-is-an-ownership-and-lifecycle-contract", "title": "The ABI is an ownership and lifecycle contract", "level": 3 }, { "id": "flexbuffers-remains-central-different-data-shapes-get-suitable-lanes", "anchor": "flexbuffers-remains-central-different-data-shapes-get-suitable-lanes", "title": "FlexBuffers remains central; different data shapes get suitable lanes", "level": 3 }, { "id": "supported-transports-are-named-profiles", "anchor": "supported-transports-are-named-profiles", "title": "Supported transports are named profiles", "level": 3 }, { "id": "a-practical-breakthrough-for-python", "anchor": "a-practical-breakthrough-for-python", "title": "A practical breakthrough for Python", "level": 3 }, { "id": "code-push-has-a-host-contract-and-a-distribution-profile", "anchor": "code-push-has-a-host-contract-and-a-distribution-profile", "title": "Code push has a host contract and a distribution profile", "level": 3 }, { "id": "evidence-and-sequencing", "anchor": "evidence-and-sequencing", "title": "Evidence and sequencing", "level": 3 }, { "id": "14-studio-ides-and-tools-that-gain-power-from-the-graph", "anchor": "14-studio-ides-and-tools-that-gain-power-from-the-graph", "title": "14. Studio, IDEs and tools that gain power from the graph", "level": 2 }, { "id": "show-the-representation-that-answers-the-question", "anchor": "show-the-representation-that-answers-the-question", "title": "Show the representation that answers the question", "level": 3 }, { "id": "integrate-tools-through-semantic-contracts", "anchor": "integrate-tools-through-semantic-contracts", "title": "Integrate tools through semantic contracts", "level": 3 }, { "id": "a-worked-north-star-scenario", "anchor": "a-worked-north-star-scenario", "title": "A worked north-star scenario", "level": 3 }, { "id": "15-build-deploy-and-operate-one-reproducible-system", "anchor": "15-build-deploy-and-operate-one-reproducible-system", "title": "15. Build, deploy and operate one reproducible system", "level": 2 }, { "id": "build-facts-become-part-of-the-system-model", "anchor": "build-facts-become-part-of-the-system-model", "title": "Build facts become part of the system model", "level": 3 }, { "id": "compile-deployment-boundaries-with-their-costs", "anchor": "compile-deployment-boundaries-with-their-costs", "title": "Compile deployment boundaries with their costs", "level": 3 }, { "id": "release-and-recovery-are-graph-operations-with-real-state", "anchor": "release-and-recovery-are-graph-operations-with-real-state", "title": "Release and recovery are graph operations with real state", "level": 3 }, { "id": "16-current-system-map-and-intended-progression", "anchor": "16-current-system-map-and-intended-progression", "title": "16. Current system map and intended progression", "level": 2 }, { "id": "17-what-public-v1-means", "anchor": "17-what-public-v1-means", "title": "17. What public v1 means", "level": 2 }, { "id": "18-the-release-must-prove-four-complete-journeys", "anchor": "18-the-release-must-prove-four-complete-journeys", "title": "18. The release must prove four complete journeys", "level": 2 }, { "id": "create-a-real-application-from-an-unfamiliar-brief", "anchor": "create-a-real-application-from-an-unfamiliar-brief", "title": "Create a real application from an unfamiliar brief", "level": 3 }, { "id": "grow-the-application-without-throwing-it-away", "anchor": "grow-the-application-without-throwing-it-away", "title": "Grow the application without throwing it away", "level": 3 }, { "id": "diagnose-a-failure-and-recover-without-duplicating-work", "anchor": "diagnose-a-failure-and-recover-without-duplicating-work", "title": "Diagnose a failure and recover without duplicating work", "level": 3 }, { "id": "deploy-a-reviewed-revision-and-establish-what-happened", "anchor": "deploy-a-reviewed-revision-and-establish-what-happened", "title": "Deploy a reviewed revision and establish what happened", "level": 3 }, { "id": "19-roadmap-from-september-2026-to-september-2027", "anchor": "19-roadmap-from-september-2026-to-september-2027", "title": "19. Roadmap from September 2026 to September 2027", "level": 2 }, { "id": "20-non-negotiable-december-release-gates", "anchor": "20-non-negotiable-december-release-gates", "title": "20. Non-negotiable December release gates", "level": 2 }, { "id": "21-measuring-whether-reaktor-is-winning", "anchor": "21-measuring-whether-reaktor-is-winning", "title": "21. Measuring whether Reaktor is winning", "level": 2 }, { "id": "measure-the-core-mechanisms-not-only-the-final-demo", "anchor": "measure-the-core-mechanisms-not-only-the-final-demo", "title": "Measure the core mechanisms, not only the final demo", "level": 3 }, { "id": "22-adoption-distribution-and-the-ten-year-position", "anchor": "22-adoption-distribution-and-the-ten-year-position", "title": "22. Adoption, distribution and the ten-year position", "level": 2 }, { "id": "beyond-year-one-expand-the-engines-reach", "anchor": "beyond-year-one-expand-the-engines-reach", "title": "Beyond year one: expand the engine's reach", "level": 3 }, { "id": "23-decisions-that-keep-the-vision-coherent", "anchor": "23-decisions-that-keep-the-vision-coherent", "title": "23. Decisions that keep the vision coherent", "level": 2 }, { "id": "the-next-two-weeks-720-september-2026", "anchor": "the-next-two-weeks-720-september-2026", "title": "The next two weeks: 7–20 September 2026", "level": 3 }, { "id": "24-reading-map-and-maintenance-contract", "anchor": "24-reading-map-and-maintenance-contract", "title": "24. Reading map and maintenance contract", "level": 2 } ], "links": [ { "id": "astra-reaktor-plan-and-roadmap", "anchor": "3-greenfield-creation-is-a-first-class-product", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "6-the-core-a-live-model-with-a-small-semantic-kernel", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "16-current-system-map-and-intended-progression", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "17-what-public-v1-means", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "19-roadmap-from-september-2026-to-september-2027", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "the-central-design-improvement" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "from-an-idea-to-an-application" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "from-an-idea-to-an-application" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "6-the-core-a-live-model-with-a-small-semantic-kernel" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "6-the-core-a-live-model-with-a-small-semantic-kernel" }, { "id": "reaktor-unified-system-graph", "anchor": "continuous-zoom", "relation": "references", "sourceAnchor": "four-linked-planes" }, { "id": "reaktor-unified-system-graph", "anchor": "flow-entrypoints", "relation": "references", "sourceAnchor": "four-linked-planes" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "graph-transformations-acquire-explicit-laws" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "graph-transformations-acquire-explicit-laws" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "graph-transformations-acquire-explicit-laws" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "graph-transformations-acquire-explicit-laws" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "graph-transformations-acquire-explicit-laws" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "declarative-architecture-with-ordinary-code-inside" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "declarative-architecture-with-ordinary-code-inside" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "declarative-architecture-with-ordinary-code-inside" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "declarative-architecture-with-ordinary-code-inside" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "declarative-architecture-with-ordinary-code-inside" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "graceful-degradation-is-executable-product-behavior" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "graceful-degradation-is-executable-product-behavior" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "graceful-degradation-is-executable-product-behavior" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "graceful-degradation-is-executable-product-behavior" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "marked-graph-regions-and-code-push" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "marked-graph-regions-and-code-push" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "marked-graph-regions-and-code-push" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "marked-graph-regions-and-code-push" }, { "id": "reaktor-ffi-design", "anchor": "", "relation": "references", "sourceAnchor": "marked-graph-regions-and-code-push" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "a-practical-chain-from-specification-to-runtime" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "evidence-composes-and-expires-with-its-assumptions" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "evidence-composes-and-expires-with-its-assumptions" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "ai-inside-the-generated-application" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "ai-inside-the-generated-application" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "ai-inside-the-generated-application" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "ai-inside-the-generated-application" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "offline-and-external-integrations-are-first-class-behaviors" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "offline-and-external-integrations-are-first-class-behaviors" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "offline-and-external-integrations-are-first-class-behaviors" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "offline-and-external-integrations-are-first-class-behaviors" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "offline-and-external-integrations-are-first-class-behaviors" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "offline-and-external-integrations-are-first-class-behaviors" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "offline-and-external-integrations-are-first-class-behaviors" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-sequencing" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-sequencing" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-sequencing" }, { "id": "flexbuffer-improvement-plan", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-sequencing" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-sequencing" }, { "id": "reaktor-ffi-design", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-sequencing" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-sequencing" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "14-studio-ides-and-tools-that-gain-power-from-the-graph" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "a-worked-north-star-scenario" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "a-worked-north-star-scenario" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "a-worked-north-star-scenario" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "a-worked-north-star-scenario" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "release-and-recovery-are-graph-operations-with-real-state" }, { "id": "reaktor-dependeasy", "anchor": "", "relation": "references", "sourceAnchor": "release-and-recovery-are-graph-operations-with-real-state" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "release-and-recovery-are-graph-operations-with-real-state" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "release-and-recovery-are-graph-operations-with-real-state" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "release-and-recovery-are-graph-operations-with-real-state" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "release-and-recovery-are-graph-operations-with-real-state" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-module-review", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "24-reading-map-and-maintenance-contract" } ] }, { "id": "auth-analysis", "owner": "Claude", "kind": "security", "summary": "Source of truth for Reaktor auth: graph runtime, AuthContext, anonymous guest sessions, Supabase email/password, magic links, OTP, provider exchange, sessions, PATs, service accounts, Worker verification, schema, and E2E gates. Includes a general-purpose design review (§25–§30): the auth-landscape comparison, the tenant-vs-context unified-scope proposal, the first-party credential/MFA design, graph amplification, and a STRIDE/compliance/DX/performance review. §31 adds the Google/Apple OAuth authorization design: provider grants, server-side code exchange, refresh, and Apple-required revocation.", "use": "Use before changing reaktor-auth, request authorization boundaries, Supabase email auth, magic links, OTP, anonymous upgrade, or provider-token exchange — or when adding Google/Apple OAuth scopes, storing provider grants, evaluating Reaktor auth against other solutions, or planning the scope/credential redesign.", "region": "framework-backend", "order": 0, "title": "Reaktor Auth", "nav": "Auth Architecture", "group": "framework", "subsection": "framework-backend", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/auth-analysis", "revision": "ad05d71a28af8fc0f30cf5d8465ee6b40040fc9d0fbe33ad8390eccd35c7a3a0", "status": "unverified", "renderingRevision": "e72506fd250da180c526aee7200e9ec1e4bdcfd799f1dfbb7e927640370df993", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/auth-analysis", "polarity": "Neutral" }, { "id": "section-design-contract", "anchor": "design-contract", "label": "01. Design Contract", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#design-contract", "polarity": "Neutral" }, { "id": "section-current-status", "anchor": "current-status", "label": "02. Current Status", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#current-status", "polarity": "Neutral" }, { "id": "section-system-shape", "anchor": "system-shape", "label": "03. System Shape", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#system-shape", "polarity": "Neutral" }, { "id": "section-core-model", "anchor": "core-model", "label": "04. Core Model", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#core-model", "polarity": "Neutral" }, { "id": "section-auth-context", "anchor": "auth-context", "label": "05. AuthContext and AuthRequirement", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#auth-context", "polarity": "Neutral" }, { "id": "section-token-families", "anchor": "token-families", "label": "06. Token Families", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#token-families", "polarity": "Neutral" }, { "id": "section-runtime-graph", "anchor": "runtime-graph", "label": "07. Runtime Graph Decomposition", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#runtime-graph", "polarity": "Neutral" }, { "id": "section-graph-port-auth", "anchor": "graph-port-auth", "label": "19. Graph and Port Auth", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#graph-port-auth", "polarity": "Neutral" }, { "id": "section-provider-authorization", "anchor": "provider-authorization", "label": "31. Provider Authorization: Google and Apple OAuth", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#provider-authorization", "polarity": "Neutral" }, { "id": "section-open-work", "anchor": "open-work", "label": "24. Open Work", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#open-work", "polarity": "Neutral" }, { "id": "section-unified-scope", "anchor": "unified-scope", "label": "26. Unified Context: resolving tenant vs. context", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#unified-scope", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/auth-analysis#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "auth-analysis:references-reaktor-ui-ux-audit-2026-09-08-developer-workflow-pass--8-september", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-developer-workflow-pass--8-september", "role": "target", "ordinal": 0 } ] }, { "id": "auth-analysis:references-reaktor-workbench-layers-auth-workspace-projections", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "section-open-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "section-auth-workspace-projections", "role": "target", "ordinal": 0 } ] }, { "id": "auth-analysis:references-reaktor-multitenancy", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "section-unified-scope", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "auth-analysis:references-security-plan", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "auth-analysis:references-secrets-management", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "auth-analysis:references-deep-link-integration", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "auth-analysis:references-reaktor-service", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "auth-analysis:references-reaktor-devops", "kind": "references", "owner": "auth-analysis", "incidences": [ { "node": "auth-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "auth-analysis.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Auth", "level": 0 }, { "id": "design-contract", "anchor": "design-contract", "title": "01. Design Contract", "level": 2 }, { "id": "current-status", "anchor": "current-status", "title": "02. Current Status", "level": 2 }, { "id": "system-shape", "anchor": "system-shape", "title": "03. System Shape", "level": 2 }, { "id": "core-model", "anchor": "core-model", "title": "04. Core Model", "level": 2 }, { "id": "auth-context", "anchor": "auth-context", "title": "05. AuthContext and AuthRequirement", "level": 2 }, { "id": "token-families", "anchor": "token-families", "title": "06. Token Families", "level": 2 }, { "id": "runtime-graph", "anchor": "runtime-graph", "title": "07. Runtime Graph Decomposition", "level": 2 }, { "id": "http-surface", "anchor": "http-surface", "title": "08. HTTP Surface", "level": 2 }, { "id": "spring-boundary", "anchor": "spring-boundary", "title": "09. Spring Boundary", "level": 2 }, { "id": "worker-boundary", "anchor": "worker-boundary", "title": "10. Cloudflare Worker Boundary", "level": 2 }, { "id": "user-flow", "anchor": "user-flow", "title": "11. User Flow", "level": 2 }, { "id": "supabase-email-auth", "anchor": "supabase-email-auth", "title": "12. Supabase Email, Magic Link, and OTP Auth", "level": 2 }, { "id": "ownership-boundary", "anchor": "ownership-boundary", "title": "Ownership Boundary", "level": 3 }, { "id": "current-code-fit", "anchor": "current-code-fit", "title": "Current Code Fit", "level": 3 }, { "id": "supported-flow-families", "anchor": "supported-flow-families", "title": "Supported Flow Families", "level": 3 }, { "id": "email-and-password", "anchor": "email-and-password", "title": "Email and Password", "level": 3 }, { "id": "magic-link", "anchor": "magic-link", "title": "Magic Link", "level": 3 }, { "id": "email-otp", "anchor": "email-otp", "title": "Email OTP", "level": 3 }, { "id": "redirects-deep-links-and-browser-bff", "anchor": "redirects-deep-links-and-browser-bff", "title": "Redirects, Deep Links, and Browser BFF", "level": 3 }, { "id": "anonymous-upgrade-and-account-linking", "anchor": "anonymous-upgrade-and-account-linking", "title": "Anonymous Upgrade and Account Linking", "level": 3 }, { "id": "data-and-configuration", "anchor": "data-and-configuration", "title": "Data and Configuration", "level": 3 }, { "id": "dto-sketch", "anchor": "dto-sketch", "title": "DTO Sketch", "level": 3 }, { "id": "security-rules", "anchor": "security-rules", "title": "Security Rules", "level": 3 }, { "id": "acceptance-tests", "anchor": "acceptance-tests", "title": "Acceptance Tests", "level": 3 }, { "id": "supabase-reference-points", "anchor": "supabase-reference-points", "title": "Supabase Reference Points", "level": 3 }, { "id": "anonymous-auth-flow", "anchor": "anonymous-auth-flow", "title": "13. Anonymous Auth Flow", "level": 2 }, { "id": "refresh-flow", "anchor": "refresh-flow", "title": "14. Refresh Flow", "level": 2 }, { "id": "pat-flow", "anchor": "pat-flow", "title": "15. PAT Flow", "level": 2 }, { "id": "service-account-flow", "anchor": "service-account-flow", "title": "16. Service Account Flow", "level": 2 }, { "id": "delegation-flow", "anchor": "delegation-flow", "title": "17. Delegation Flow", "level": 2 }, { "id": "common-task-recipes", "anchor": "common-task-recipes", "title": "18. Common Task Recipes", "level": 2 }, { "id": "try-an-app-before-sign-up", "anchor": "try-an-app-before-sign-up", "title": "Try an App Before Sign Up", "level": 3 }, { "id": "sign-in-with-supabase-email-and-password", "anchor": "sign-in-with-supabase-email-and-password", "title": "Sign In with Supabase Email and Password", "level": 3 }, { "id": "use-supabase-magic-link-or-email-otp", "anchor": "use-supabase-magic-link-or-email-otp", "title": "Use Supabase Magic Link or Email OTP", "level": 3 }, { "id": "upgrade-a-guest-with-supabase-email", "anchor": "upgrade-a-guest-with-supabase-email", "title": "Upgrade a Guest with Supabase Email", "level": 3 }, { "id": "sign-in-and-call-a-worker", "anchor": "sign-in-and-call-a-worker", "title": "Sign In and Call a Worker", "level": 3 }, { "id": "keep-a-native-session-alive", "anchor": "keep-a-native-session-alive", "title": "Keep a Native Session Alive", "level": 3 }, { "id": "revoke-a-lost-device", "anchor": "revoke-a-lost-device", "title": "Revoke a Lost Device", "level": 3 }, { "id": "give-a-cli-or-mcp-tool-access", "anchor": "give-a-cli-or-mcp-tool-access", "title": "Give a CLI or MCP Tool Access", "level": 3 }, { "id": "make-worker-to-worker-calls-as-a-service", "anchor": "make-worker-to-worker-calls-as-a-service", "title": "Make Worker-to-Worker Calls as a Service", "level": 3 }, { "id": "call-a-worker-on-behalf-of-a-user", "anchor": "call-a-worker-on-behalf-of-a-user", "title": "Call a Worker on Behalf of a User", "level": 3 }, { "id": "call-the-graph-gateway-from-a-worker", "anchor": "call-the-graph-gateway-from-a-worker", "title": "Call the Graph Gateway from a Worker", "level": 3 }, { "id": "put-auth-behind-spring-without-making-spring-the-model", "anchor": "put-auth-behind-spring-without-making-spring-the-model", "title": "Put Auth Behind Spring Without Making Spring the Model", "level": 3 }, { "id": "compose-auth-inside-a-graph-aware-module", "anchor": "compose-auth-inside-a-graph-aware-module", "title": "Compose Auth Inside a Graph-Aware Module", "level": 3 }, { "id": "investigate-an-auth-incident", "anchor": "investigate-an-auth-incident", "title": "Investigate an Auth Incident", "level": 3 }, { "id": "graph-port-auth", "anchor": "graph-port-auth", "title": "19. Graph and Port Auth", "level": 2 }, { "id": "target-owned-tests", "anchor": "target-owned-tests", "title": "20. Target-Owned Tests", "level": 2 }, { "id": "deployment-status", "anchor": "deployment-status", "title": "21. Deployment Status", "level": 2 }, { "id": "operating-rules", "anchor": "operating-rules", "title": "22. Operating Rules", "level": 2 }, { "id": "review", "anchor": "review", "title": "23. Module Review and Assessment", "level": 2 }, { "id": "open-work", "anchor": "open-work", "title": "24. Open Work", "level": 2 }, { "id": "general-review", "anchor": "general-review", "title": "25. Design Review: Heimdall as a General-Purpose Auth Solution", "level": 2 }, { "id": "is-it-good", "anchor": "is-it-good", "title": "25.1 Is this a good model?", "level": 3 }, { "id": "two-questions", "anchor": "two-questions", "title": "25.2 Two model questions", "level": 3 }, { "id": "landscape", "anchor": "landscape", "title": "25.3 How Heimdall compares to the landscape", "level": 3 }, { "id": "unified-scope", "anchor": "unified-scope", "title": "26. Unified Context: resolving tenant vs. context", "level": 2 }, { "id": "first-party-credentials", "anchor": "first-party-credentials", "title": "27. First-Party Credentials and MFA", "level": 2 }, { "id": "graph-amplification", "anchor": "graph-amplification", "title": "28. Graph Amplification: auth that travels with causality", "level": 2 }, { "id": "use-case-archetypes", "anchor": "use-case-archetypes", "title": "29. Use-Case Archetypes", "level": 2 }, { "id": "perspective-reviews", "anchor": "perspective-reviews", "title": "30. Perspective Reviews", "level": 2 }, { "id": "threat-model", "anchor": "threat-model", "title": "30.1 Threat model (STRIDE)", "level": 3 }, { "id": "compliance", "anchor": "compliance", "title": "30.2 Compliance", "level": 3 }, { "id": "dx", "anchor": "dx", "title": "30.3 Developer experience", "level": 3 }, { "id": "performance", "anchor": "performance", "title": "30.4 Performance and scale", "level": 3 }, { "id": "build-vs-buy", "anchor": "build-vs-buy", "title": "30.5 Build vs. buy", "level": 3 }, { "id": "provider-authorization", "anchor": "provider-authorization", "title": "31. Provider Authorization: Google and Apple OAuth", "level": 2 }, { "id": "authz-gap", "anchor": "authz-gap", "title": "31.1 The gap: authentication is not authorization", "level": 3 }, { "id": "provider-surfaces", "anchor": "provider-surfaces", "title": "31.2 What the six client surfaces already offer", "level": 3 }, { "id": "authz-schema-today", "anchor": "authz-schema-today", "title": "31.3 What the schema already anticipated", "level": 3 }, { "id": "apple-specifics", "anchor": "apple-specifics", "title": "31.4 Apple's sharp edges", "level": 3 }, { "id": "provider-grant", "anchor": "provider-grant", "title": "31.5 Model addition: the provider grant", "level": 3 }, { "id": "authz-ports", "anchor": "authz-ports", "title": "31.6 Port and service shape", "level": 3 }, { "id": "client-authz", "anchor": "client-authz", "title": "31.7 Client surface changes", "level": 3 }, { "id": "authz-flow", "anchor": "authz-flow", "title": "31.8 Flow", "level": 3 }, { "id": "authz-security", "anchor": "authz-security", "title": "31.9 Security rules", "level": 3 }, { "id": "authz-increments", "anchor": "authz-increments", "title": "31.10 Increments", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "developer-workflow-pass--8-september", "relation": "references", "sourceAnchor": "" }, { "id": "auth-analysis", "anchor": "provider-authorization", "relation": "references", "sourceAnchor": "user-flow" }, { "id": "reaktor-workbench-layers", "anchor": "auth-workspace-projections", "relation": "references", "sourceAnchor": "open-work" }, { "id": "auth-analysis", "anchor": "provider-authorization", "relation": "references", "sourceAnchor": "open-work" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "unified-scope" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "bestbuds-schema-hardening", "owner": "Codex", "kind": "ops", "summary": "Performance, correctness, transaction, and scalability plan for replacing the broad BestBuds public compatibility views over Heimdall with app-scoped projections, alias tables, bounded chat queries, atomic refresh rotation, schema drift checks, and grant/RLS hardening.", "use": "Use before changing BestBuds public tables, Heimdall compatibility views, user id resolution, chat/social/campaign queries, refresh-token rotation, Supabase grants/RLS, or schema migration ordering.", "region": "data-evidence", "order": 2, "title": "BestBuds Public and Heimdall Schema Hardening", "nav": "BestBuds Schema Hardening", "group": "data", "subsection": "data-evidence", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/bestbuds-schema-hardening", "revision": "c9cae42e6b9c45ca798fd93a2d00c2c35ddeadf1f39a935616888e323599e4f1", "status": "unverified", "renderingRevision": "00232163c1363d4cec2857046c959ab2dea8362c15834a85862b74791dd772f1", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/bestbuds-schema-hardening", "polarity": "Neutral" }, { "id": "section-current-verdict", "anchor": "current-verdict", "label": "Current Verdict", "profile": "section", "contract": "https://reaktor.build/docs/bestbuds-schema-hardening#current-verdict", "polarity": "Neutral" }, { "id": "section-evidence-snapshot", "anchor": "evidence-snapshot", "label": "Evidence Snapshot", "profile": "section", "contract": "https://reaktor.build/docs/bestbuds-schema-hardening#evidence-snapshot", "polarity": "Neutral" }, { "id": "section-source-anchors", "anchor": "source-anchors", "label": "Source Anchors", "profile": "section", "contract": "https://reaktor.build/docs/bestbuds-schema-hardening#source-anchors", "polarity": "Neutral" }, { "id": "section-design-goal", "anchor": "design-goal", "label": "Design Goal", "profile": "section", "contract": "https://reaktor.build/docs/bestbuds-schema-hardening#design-goal", "polarity": "Neutral" }, { "id": "section-boundary-model", "anchor": "boundary-model", "label": "Boundary Model", "profile": "section", "contract": "https://reaktor.build/docs/bestbuds-schema-hardening#boundary-model", "polarity": "Neutral" }, { "id": "section-required-invariants", "anchor": "required-invariants", "label": "Required Invariants", "profile": "section", "contract": "https://reaktor.build/docs/bestbuds-schema-hardening#required-invariants", "polarity": "Neutral" } ], "relations": [ { "id": "bestbuds-schema-hardening:references-reaktor-data-implementation-documents", "kind": "references", "owner": "bestbuds-schema-hardening", "incidences": [ { "node": "bestbuds-schema-hardening", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "section-documents", "role": "target", "ordinal": 0 } ] } ] }, "content": "bestbuds-schema-hardening.json", "sections": [ { "id": "preamble", "anchor": "", "title": "BestBuds Public and Heimdall Schema Hardening", "level": 0 }, { "id": "current-verdict", "anchor": "current-verdict", "title": "Current Verdict", "level": 2 }, { "id": "evidence-snapshot", "anchor": "evidence-snapshot", "title": "Evidence Snapshot", "level": 2 }, { "id": "source-anchors", "anchor": "source-anchors", "title": "Source Anchors", "level": 2 }, { "id": "design-goal", "anchor": "design-goal", "title": "Design Goal", "level": 2 }, { "id": "boundary-model", "anchor": "boundary-model", "title": "Boundary Model", "level": 2 }, { "id": "required-invariants", "anchor": "required-invariants", "title": "Required Invariants", "level": 2 }, { "id": "replace-users-view", "anchor": "replace-users-view", "title": "Replace users_view as a Hot Path", "level": 2 }, { "id": "legacy-matching", "anchor": "legacy-matching", "title": "Replace Per-Request Legacy Matching", "level": 2 }, { "id": "message-hot-paths", "anchor": "message-hot-paths", "title": "Rewrite Message Hot Paths", "level": 2 }, { "id": "campaign-group-compat", "anchor": "campaign-group-compat", "title": "Campaign and Group Compatibility", "level": 2 }, { "id": "refresh-rotation", "anchor": "refresh-rotation", "title": "Refresh Rotation Must Be Atomic", "level": 2 }, { "id": "pat-write-amplification", "anchor": "pat-write-amplification", "title": "PAT Verification Write Amplification", "level": 2 }, { "id": "fk-index-backlog", "anchor": "fk-index-backlog", "title": "FK and Index Backlog", "level": 2 }, { "id": "sticker-schema-drift", "anchor": "sticker-schema-drift", "title": "Sticker Schema Drift", "level": 2 }, { "id": "grants-rls", "anchor": "grants-rls", "title": "Grants and RLS", "level": 2 }, { "id": "migration-plan", "anchor": "migration-plan", "title": "Compatibility Migration Plan", "level": 2 }, { "id": "stage-0-freeze-and-audit", "anchor": "stage-0-freeze-and-audit", "title": "Stage 0: freeze and audit", "level": 3 }, { "id": "stage-1-canonical-projection", "anchor": "stage-1-canonical-projection", "title": "Stage 1: canonical projection", "level": 3 }, { "id": "stage-2-alias-table", "anchor": "stage-2-alias-table", "title": "Stage 2: alias table", "level": 3 }, { "id": "stage-3-hot-query-rewrites", "anchor": "stage-3-hot-query-rewrites", "title": "Stage 3: hot query rewrites", "level": 3 }, { "id": "stage-4-transaction-hardening", "anchor": "stage-4-transaction-hardening", "title": "Stage 4: transaction hardening", "level": 3 }, { "id": "stage-5-source-and-live-schema-convergence", "anchor": "stage-5-source-and-live-schema-convergence", "title": "Stage 5: source and live schema convergence", "level": 3 }, { "id": "stage-6-security-hardening", "anchor": "stage-6-security-hardening", "title": "Stage 6: security hardening", "level": 3 }, { "id": "query-replacements", "anchor": "query-replacements", "title": "Suggested Query Replacements", "level": 2 }, { "id": "operational-checks", "anchor": "operational-checks", "title": "Operational Checks", "level": 2 }, { "id": "success-criteria", "anchor": "success-criteria", "title": "Success Criteria", "level": 2 }, { "id": "final-position", "anchor": "final-position", "title": "Final Position", "level": 2 } ], "links": [ { "id": "reaktor-data-implementation", "anchor": "documents", "relation": "references", "sourceAnchor": "" } ] }, { "id": "claude-critic-review", "owner": "Claude", "kind": "critique", "summary": "Adversarial review of architecture, feasibility, competition, and go-to-market risk.", "use": "Use as a second-opinion and adoption-risk check.", "region": "background-market", "order": 1, "title": "Claude Critic Review", "nav": "Claude Critic", "group": "background", "subsection": "background-market", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/claude-critic-review", "revision": "197dd5cc028837dc863fbb089de4840420218dbbae96347cda9d28c752e5fd5d", "status": "historical", "renderingRevision": "40335dcc7cf0f6ef7a5c041c34d16628797a06ccdad08c5cc8f115346a652502", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/claude-critic-review", "polarity": "Neutral" }, { "id": "section-0-executive-summary", "anchor": "0-executive-summary", "label": "0Executive Summary", "profile": "section", "contract": "https://reaktor.build/docs/claude-critic-review#0-executive-summary", "polarity": "Neutral" }, { "id": "section-1-the-scope-problem", "anchor": "1-the-scope-problem", "label": "1The Scope Problem", "profile": "section", "contract": "https://reaktor.build/docs/claude-critic-review#1-the-scope-problem", "polarity": "Neutral" }, { "id": "section-2-the-timeline-contradiction", "anchor": "2-the-timeline-contradiction", "label": "2The Timeline Contradiction", "profile": "section", "contract": "https://reaktor.build/docs/claude-critic-review#2-the-timeline-contradiction", "polarity": "Neutral" }, { "id": "section-3-the-team-scope-mismatch", "anchor": "3-the-team-scope-mismatch", "label": "3The Team-Scope Mismatch", "profile": "section", "contract": "https://reaktor.build/docs/claude-critic-review#3-the-team-scope-mismatch", "polarity": "Neutral" }, { "id": "section-4-the-market-size-question", "anchor": "4-the-market-size-question", "label": "4The Market Size Question", "profile": "section", "contract": "https://reaktor.build/docs/claude-critic-review#4-the-market-size-question", "polarity": "Neutral" }, { "id": "section-5-the-competitive-claims-are-overstated", "anchor": "5-the-competitive-claims-are-overstated", "label": "5The Competitive Claims Are Overstated", "profile": "section", "contract": "https://reaktor.build/docs/claude-critic-review#5-the-competitive-claims-are-overstated", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/claude-critic-review#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "claude-critic-review:references-codex-critic-review", "kind": "references", "owner": "claude-critic-review", "incidences": [ { "node": "claude-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "codex-critic-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-critic-review:references-reaktor-competitive-analysis", "kind": "references", "owner": "claude-critic-review", "incidences": [ { "node": "claude-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-critic-review:references-reaktor-workbench-roadmap", "kind": "references", "owner": "claude-critic-review", "incidences": [ { "node": "claude-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-critic-review:references-reaktor-framework-overview", "kind": "references", "owner": "claude-critic-review", "incidences": [ { "node": "claude-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-critic-review:references-reaktor-megascale-strategy", "kind": "references", "owner": "claude-critic-review", "incidences": [ { "node": "claude-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-megascale-strategy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-critic-review:references-graph-kernel-analysis", "kind": "references", "owner": "claude-critic-review", "incidences": [ { "node": "claude-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "claude-critic-review.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Claude Critic Review", "level": 0 }, { "id": "0-executive-summary", "anchor": "0-executive-summary", "title": "0Executive Summary", "level": 2 }, { "id": "1-the-scope-problem", "anchor": "1-the-scope-problem", "title": "1The Scope Problem", "level": 2 }, { "id": "scope", "anchor": "scope", "title": "What Reaktor promises to be", "level": 3 }, { "id": "scope-2", "anchor": "scope-2", "title": "The \"everything connects to everything\" trap", "level": 3 }, { "id": "2-the-timeline-contradiction", "anchor": "2-the-timeline-contradiction", "title": "2The Timeline Contradiction", "level": 2 }, { "id": "3-the-team-scope-mismatch", "anchor": "3-the-team-scope-mismatch", "title": "3The Team-Scope Mismatch", "level": 2 }, { "id": "4-the-market-size-question", "anchor": "4-the-market-size-question", "title": "4The Market Size Question", "level": 2 }, { "id": "market", "anchor": "market", "title": "KMP is the initial target", "level": 3 }, { "id": "market-2", "anchor": "market-2", "title": "The chicken-and-egg problem", "level": 3 }, { "id": "5-the-competitive-claims-are-overstated", "anchor": "5-the-competitive-claims-are-overstated", "title": "5The Competitive Claims Are Overstated", "level": 2 }, { "id": "competition", "anchor": "competition", "title": "The \"only tool with every checkmark\" claim", "level": 3 }, { "id": "competition-2", "anchor": "competition-2", "title": "The \"AI tools don't understand architecture\" thesis", "level": 3 }, { "id": "6-architectural-risks", "anchor": "6-architectural-risks", "title": "6Architectural Risks", "level": 2 }, { "id": "architecture", "anchor": "architecture", "title": "The GraphManifest doesn't exist yet", "level": 3 }, { "id": "architecture-2", "anchor": "architecture-2", "title": "The port system is the core — and it's unvalidated", "level": 3 }, { "id": "architecture-3", "anchor": "architecture-3", "title": "Live runtime connection is hand-waved", "level": 3 }, { "id": "7-the-prototype-paradox", "anchor": "7-the-prototype-paradox", "title": "7The Prototype Paradox", "level": 2 }, { "id": "prototype", "anchor": "prototype", "title": "Beautiful but dangerous", "level": 3 }, { "id": "8-the-ai-integration-bet", "anchor": "8-the-ai-integration-bet", "title": "8The AI Integration Bet", "level": 2 }, { "id": "ai", "anchor": "ai", "title": "MCP as moat — how defensible is it?", "level": 3 }, { "id": "ai-2", "anchor": "ai-2", "title": "GraphCommand as AI interface", "level": 3 }, { "id": "9-business-model-concerns", "anchor": "9-business-model-concerns", "title": "9Business Model Concerns", "level": 2 }, { "id": "business", "anchor": "business", "title": "Pricing assumes value that doesn't exist yet", "level": 3 }, { "id": "business-2", "anchor": "business-2", "title": "The open-source tension", "level": 3 }, { "id": "10-existential-risks", "anchor": "10-existential-risks", "title": "10Existential Risks", "level": 2 }, { "id": "existential", "anchor": "existential", "title": "What if KMP doesn't win?", "level": 3 }, { "id": "existential-2", "anchor": "existential-2", "title": "What if the graph model is wrong?", "level": 3 }, { "id": "existential-3", "anchor": "existential-3", "title": "What if one person gets sick?", "level": 3 }, { "id": "11-the-steel-man-and-mdash-what-could-go-right", "anchor": "11-the-steel-man-and-mdash-what-could-go-right", "title": "11The Steel Man — What Could Go Right", "level": 2 }, { "id": "12-risk-scorecard", "anchor": "12-risk-scorecard", "title": "12Risk Scorecard", "level": 2 }, { "id": "recommendations", "anchor": "recommendations", "title": "Recommendations", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "codex-critic-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "claude-dev-environment", "owner": "Claude", "kind": "prior", "summary": "Original shadow/dev-environment draft preserved for design lineage.", "use": "Use only when comparing prior shadow environment proposals.", "region": "background-research", "order": 4, "title": "Claude Dev Environment", "nav": "Claude Dev Env", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/claude-dev-environment", "revision": "6f00143b079e3468ef25d09a0c22b7241dab57aebdfab334f3b862ff36d69dc5", "status": "historical", "renderingRevision": "d01b2be920454a5e159f3b6abccc864a8886b9ee3361dec71d006b78ff12c840", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://keploy.io/docs/concepts/what-is-keploy/", "https://github.com/buger/goreplay", "https://mirrord.dev/docs/overview/introduction/", "https://www.replay.io/", "https://supabase.com/docs/guides/platform/branching", "https://neon.tech/docs/introduction/branching", "https://memgraph.com/docs/data-migration/dump-load", "https://supabase.com/docs/guides/database/replication", "https://developers.cloudflare.com/r2/buckets/event-notifications/", "https://k6.io/docs/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/claude-dev-environment", "polarity": "Neutral" }, { "id": "section-summary", "anchor": "summary", "label": "1. Executive summary", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#summary", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "2. Current state", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#current", "polarity": "Neutral" }, { "id": "section-why", "anchor": "why", "label": "3. Why a moving shadow", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#why", "polarity": "Neutral" }, { "id": "section-inspiration", "anchor": "inspiration", "label": "4. Prior art", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#inspiration", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "5. Principles", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#principles", "polarity": "Neutral" }, { "id": "section-surfaces", "anchor": "surfaces", "label": "6. Stateful surfaces to shadow", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#surfaces", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#related-docs", "polarity": "Neutral" }, { "id": "section-observability", "anchor": "observability", "label": "19. Observability", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#observability", "polarity": "Neutral" }, { "id": "section-references-3", "anchor": "references-3", "label": "Peer designs in this repo", "profile": "section", "contract": "https://reaktor.build/docs/claude-dev-environment#references-3", "polarity": "Neutral" } ], "relations": [ { "id": "claude-dev-environment:references-shadow-dev-environment", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-operations", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-performance-observability", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-observability", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-reaktor-notifications-design", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-deep-link-integration", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-auth-analysis", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-security-plan", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-graph-kernel-analysis", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-reaktor_graph_visitors_design", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-codex-dev-environment", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "codex-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-secrets-management", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-reaktor-devops", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-dev-environment:references-flexbuffer-improvement-plan", "kind": "references", "owner": "claude-dev-environment", "incidences": [ { "node": "claude-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-improvement-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "claude-dev-environment.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Claude Dev Environment", "level": 0 }, { "id": "summary", "anchor": "summary", "title": "1. Executive summary", "level": 2 }, { "id": "current", "anchor": "current", "title": "2. Current state", "level": 2 }, { "id": "current-2", "anchor": "current-2", "title": "2.1 What dev/test infrastructure exists today", "level": 3 }, { "id": "current-3", "anchor": "current-3", "title": "2.2 The honest gap", "level": 3 }, { "id": "why", "anchor": "why", "title": "3. Why a moving shadow", "level": 2 }, { "id": "bugs-live-in-production-shapes", "anchor": "bugs-live-in-production-shapes", "title": "Bugs live in production shapes", "level": 4 }, { "id": "load-tests-are-useless-without-realistic-mix", "anchor": "load-tests-are-useless-without-realistic-mix", "title": "Load tests are useless without realistic mix", "level": 4 }, { "id": "edge-cases-need-permanence", "anchor": "edge-cases-need-permanence", "title": "Edge cases need permanence", "level": 4 }, { "id": "side-effects-need-a-sandbox", "anchor": "side-effects-need-a-sandbox", "title": "Side effects need a sandbox", "level": 4 }, { "id": "privacy-by-construction", "anchor": "privacy-by-construction", "title": "Privacy by construction", "level": 4 }, { "id": "replay-closes-the-regression-loop", "anchor": "replay-closes-the-regression-loop", "title": "Replay closes the regression loop", "level": 4 }, { "id": "inspiration", "anchor": "inspiration", "title": "4. Prior art", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "5. Principles", "level": 2 }, { "id": "1--capture-is-a-visitor-not-a-proxy", "anchor": "1--capture-is-a-visitor-not-a-proxy", "title": "1 · Capture is a visitor, not a proxy", "level": 4 }, { "id": "2--the-shadow-is-dev", "anchor": "2--the-shadow-is-dev", "title": "2 · The shadow IS dev", "level": 4 }, { "id": "3--moving-by-default-pinned-by-exception", "anchor": "3--moving-by-default-pinned-by-exception", "title": "3 · Moving by default, pinned by exception", "level": 4 }, { "id": "4--side-effects-fail-loudly-in-shadow", "anchor": "4--side-effects-fail-loudly-in-shadow", "title": "4 · Side effects fail loudly in shadow", "level": 4 }, { "id": "5--pii-scrubbed-at-capture", "anchor": "5--pii-scrubbed-at-capture", "title": "5 · PII scrubbed at capture", "level": 4 }, { "id": "6--replay-must-be-deterministic", "anchor": "6--replay-must-be-deterministic", "title": "6 · Replay must be deterministic", "level": 4 }, { "id": "7--one-refresh-job-per-surface", "anchor": "7--one-refresh-job-per-surface", "title": "7 · One refresh job per surface", "level": 4 }, { "id": "8--tenant-prefix-everywhere", "anchor": "8--tenant-prefix-everywhere", "title": "8 · Tenant prefix everywhere", "level": 4 }, { "id": "surfaces", "anchor": "surfaces", "title": "6. Stateful surfaces to shadow", "level": 2 }, { "id": "sideeffects", "anchor": "sideeffects", "title": "7. Side-effect classification", "level": 2 }, { "id": "arch", "anchor": "arch", "title": "8. Stack diagram", "level": 2 }, { "id": "capture", "anchor": "capture", "title": "9. Capture path", "level": 2 }, { "id": "capture-2", "anchor": "capture-2", "title": "9.1 The visitor", "level": 3 }, { "id": "capture-3", "anchor": "capture-3", "title": "9.2 What an envelope contains", "level": 3 }, { "id": "capture-4", "anchor": "capture-4", "title": "9.3 Sampling", "level": 3 }, { "id": "stores", "anchor": "stores", "title": "10. Shadow stores per surface", "level": 2 }, { "id": "stores-2", "anchor": "stores-2", "title": "10.1 Postgres / Supabase / Cockroach", "level": 3 }, { "id": "stores-3", "anchor": "stores-3", "title": "10.2 Memgraph", "level": 3 }, { "id": "stores-4", "anchor": "stores-4", "title": "10.3 R2 IMAGES", "level": 3 }, { "id": "stores-5", "anchor": "stores-5", "title": "10.4 Workers AI", "level": 3 }, { "id": "stores-6", "anchor": "stores-6", "title": "10.5 Google Sheets / Firebase / FCM / APNs", "level": 3 }, { "id": "window", "anchor": "window", "title": "11. The 7-day window + pinned fixtures", "level": 2 }, { "id": "window-2", "anchor": "window-2", "title": "11.1 Two-tier retention", "level": 3 }, { "id": "window-3", "anchor": "window-3", "title": "11.2 Pin reasons (canonical list)", "level": 3 }, { "id": "window-4", "anchor": "window-4", "title": "11.3 Storage maths", "level": 3 }, { "id": "replay", "anchor": "replay", "title": "12. Replay engine", "level": 2 }, { "id": "replay-2", "anchor": "replay-2", "title": "12.1 CLI ergonomics", "level": 3 }, { "id": "replay-3", "anchor": "replay-3", "title": "12.2 What gets replayed", "level": 3 }, { "id": "replay-4", "anchor": "replay-4", "title": "12.3 Three replay modes", "level": 3 }, { "id": "strict", "anchor": "strict", "title": "strict", "level": 4 }, { "id": "tolerant", "anchor": "tolerant", "title": "tolerant", "level": 4 }, { "id": "exploratory", "anchor": "exploratory", "title": "exploratory", "level": 4 }, { "id": "stubs", "anchor": "stubs", "title": "13. Stubbing dangerous side effects", "level": 2 }, { "id": "anomaly", "anchor": "anomaly", "title": "14. Anomaly detection & auto-pinning", "level": 2 }, { "id": "privacy", "anchor": "privacy", "title": "15. Privacy & PII scrubbing", "level": 2 }, { "id": "privacy-2", "anchor": "privacy-2", "title": "15.1 Auditing", "level": 3 }, { "id": "tenant", "anchor": "tenant", "title": "16. Tenant isolation", "level": 2 }, { "id": "timetravel", "anchor": "timetravel", "title": "17. Time travel", "level": 2 }, { "id": "load", "anchor": "load", "title": "18. Load testing from real patterns", "level": 2 }, { "id": "observability", "anchor": "observability", "title": "19. Observability", "level": 2 }, { "id": "workbench", "anchor": "workbench", "title": "20. Workbench & CLI", "level": 2 }, { "id": "workbench-2", "anchor": "workbench-2", "title": "20.1 Workbench panel", "level": 3 }, { "id": "workbench-3", "anchor": "workbench-3", "title": "20.2 CLI verbs", "level": 3 }, { "id": "ci", "anchor": "ci", "title": "21. CI integration", "level": 2 }, { "id": "replay-pinned-regression-suite", "anchor": "replay-pinned-regression-suite", "title": "Replay pinned regression suite", "level": 4 }, { "id": "replay-yesterdays-traffic-sample", "anchor": "replay-yesterdays-traffic-sample", "title": "Replay yesterday's traffic sample", "level": 4 }, { "id": "load-test-from-last-weeks-patterns", "anchor": "load-test-from-last-weeks-patterns", "title": "Load test from last week's patterns", "level": 4 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "22. BestBuds wiring", "level": 2 }, { "id": "bestbuds-2", "anchor": "bestbuds-2", "title": "22.1 First slice: chatServer", "level": 3 }, { "id": "plan", "anchor": "plan", "title": "23. Phased plan", "level": 2 }, { "id": "spec-the-envelope--pin-schema", "anchor": "spec-the-envelope--pin-schema", "title": "Spec the envelope & pin schema", "level": 4 }, { "id": "capture-path-on-one-worker", "anchor": "capture-path-on-one-worker", "title": "Capture path on one worker", "level": 4 }, { "id": "shadow-postgres-via-logical-replication", "anchor": "shadow-postgres-via-logical-replication", "title": "Shadow Postgres via logical replication", "level": 4 }, { "id": "shadow-r2--memgraph--stubs", "anchor": "shadow-r2--memgraph--stubs", "title": "Shadow R2 + Memgraph + stubs", "level": 4 }, { "id": "replay-engine--cli", "anchor": "replay-engine--cli", "title": "Replay engine + CLI", "level": 4 }, { "id": "anomaly-detector--pin-queue", "anchor": "anomaly-detector--pin-queue", "title": "Anomaly detector + pin queue", "level": 4 }, { "id": "roll-capture-to-all-10-workers", "anchor": "roll-capture-to-all-10-workers", "title": "Roll capture to all 10 workers", "level": 4 }, { "id": "ci-integration", "anchor": "ci-integration", "title": "CI integration", "level": 4 }, { "id": "load-test--workbench-shadow-panel", "anchor": "load-test--workbench-shadow-panel", "title": "Load test + Workbench Shadow panel", "level": 4 }, { "id": "time-travel--per-branch-db-forks", "anchor": "time-travel--per-branch-db-forks", "title": "Time travel + per-branch DB forks", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "24. Risks & open questions", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Risks", "level": 4 }, { "id": "risks-3", "anchor": "risks-3", "title": "Open questions", "level": 4 }, { "id": "references", "anchor": "references", "title": "25. References", "level": 2 }, { "id": "references-2", "anchor": "references-2", "title": "Spec sections this design extends", "level": 4 }, { "id": "references-3", "anchor": "references-3", "title": "Peer designs in this repo", "level": 4 }, { "id": "references-4", "anchor": "references-4", "title": "Files inventoried during the design", "level": 4 }, { "id": "references-5", "anchor": "references-5", "title": "External tools cited", "level": 4 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "observability" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "codex-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-improvement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "claude-nexergy-appweb-analysis", "owner": "Claude", "kind": "design", "summary": "Production design for Nexergy Energy — a real B2B biomass trader-aggregator startup — built entirely on Reaktor primitives and wiring, grounded in how B2B commerce actually operates (OfBusiness, Buyofuel, BiofuelCircle, Udaan; composable-commerce/MACH capability maps; the canonical capture→…→analyse OMS flow). Maps the full commerce capability surface onto existing modules plus a minimal new substrate — reaktor-ledger (keystone), reaktor-catalog, reaktor-fulfillment, plus thin audit-journal and compliance-gate primitives, all factored as general primitives (no reaktor-biomass vertical) — and makes embedded working-capital credit the trader-aggregator moat. OMS/WMS/TMS/returns/financing are composition recipes; Nexergy Energy is the startup platform.", "use": "Use when designing the production Nexergy Energy system on Reaktor, scoping the ledger/catalog/fulfillment modules, designing embedded-finance/credit on the ledger, or turning the Nexergy prototype into a production system.", "region": "products-apps", "order": 4, "title": "Nexergy on Reaktor — Commerce Substrate Design", "nav": "Nexergy on Reaktor (Claude)", "group": "products", "subsection": "products-apps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/claude-nexergy-appweb-analysis", "revision": "0344aaa52927e07d687e001f007af438d9f689ea6294841eb389b1f325321759", "status": "unverified", "renderingRevision": "e299329eea3797323b5a06d654983a66fcf9f214a4e88e8189ede7af82bc143c", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://growthx.club/blog/ofbusiness-business-model", "https://buyofuel.com/", "https://tracxn.com/d/companies/buyofuel/__QF0efwdVbSe2KE0tgaJ2CCFzcx-DvgCSfBfwKp7mlH4", "https://www.biofuelcircle.com/", "https://aryanjalan.com/udaan-business-model/", "https://www.elasticpath.com/resources/ebooks/composable-commerce-architecture", "https://virtocommerce.com/blog/what-is-order-management-system", "https://www.galileo-ft.com/blog/embedded-b2b-finance-2026-next-frontier/", "https://www.myndsolution.com/accounting-for-ecommerce-businesses-managing-gst-marketplace-reconciliation-and-returns/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis", "polarity": "Neutral" }, { "id": "section-system-map", "anchor": "system-map", "label": "System map", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#system-map", "polarity": "Neutral" }, { "id": "section-0-executive-summary", "anchor": "0-executive-summary", "label": "0. Executive summary", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#0-executive-summary", "polarity": "Neutral" }, { "id": "section-1-competition-scan", "anchor": "1-competition-scan", "label": "1. How B2B commerce actually operates (competition scan)", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#1-competition-scan", "polarity": "Neutral" }, { "id": "section-2-capability-map", "anchor": "2-capability-map", "label": "2. The commerce capability map → Reaktor", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#2-capability-map", "polarity": "Neutral" }, { "id": "section-3-design-tenets", "anchor": "3-design-tenets", "label": "3. Design tenets", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#3-design-tenets", "polarity": "Neutral" }, { "id": "section-4-existing-modules", "anchor": "4-existing-modules", "label": "4. Existing modules, applied to Nexergy", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#4-existing-modules", "polarity": "Neutral" }, { "id": "section-sources", "anchor": "sources", "label": "Sources", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#sources", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/claude-nexergy-appweb-analysis#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "claude-nexergy-appweb-analysis:references-codex-nexergy-appweb-analysis", "kind": "references", "owner": "claude-nexergy-appweb-analysis", "incidences": [ { "node": "claude-nexergy-appweb-analysis", "port": "section-sources", "role": "source", "ordinal": 0 }, { "node": "codex-nexergy-appweb-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-nexergy-appweb-analysis:references-reaktor-db", "kind": "references", "owner": "claude-nexergy-appweb-analysis", "incidences": [ { "node": "claude-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-nexergy-appweb-analysis:references-reaktor-service", "kind": "references", "owner": "claude-nexergy-appweb-analysis", "incidences": [ { "node": "claude-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-nexergy-appweb-analysis:references-reaktor-bus-mesh", "kind": "references", "owner": "claude-nexergy-appweb-analysis", "incidences": [ { "node": "claude-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-nexergy-appweb-analysis:references-reaktor-multitenancy", "kind": "references", "owner": "claude-nexergy-appweb-analysis", "incidences": [ { "node": "claude-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "claude-nexergy-appweb-analysis:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "claude-nexergy-appweb-analysis", "incidences": [ { "node": "claude-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "claude-nexergy-appweb-analysis.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Nexergy on Reaktor — Commerce Substrate Design", "level": 0 }, { "id": "system-map", "anchor": "system-map", "title": "System map", "level": 2 }, { "id": "0-executive-summary", "anchor": "0-executive-summary", "title": "0. Executive summary", "level": 2 }, { "id": "1-competition-scan", "anchor": "1-competition-scan", "title": "1. How B2B commerce actually operates (competition scan)", "level": 2 }, { "id": "biomass-field", "anchor": "biomass-field", "title": "The biomass field", "level": 3 }, { "id": "horizontal", "anchor": "horizontal", "title": "The horizontal trader-aggregators (the real playbook)", "level": 3 }, { "id": "decomposition", "anchor": "decomposition", "title": "The canonical commerce decomposition", "level": 3 }, { "id": "2-capability-map", "anchor": "2-capability-map", "title": "2. The commerce capability map → Reaktor", "level": 2 }, { "id": "3-design-tenets", "anchor": "3-design-tenets", "title": "3. Design tenets", "level": 2 }, { "id": "4-existing-modules", "anchor": "4-existing-modules", "title": "4. Existing modules, applied to Nexergy", "level": 2 }, { "id": "5-reaktor-ledger", "anchor": "5-reaktor-ledger", "title": "5. New module #1 — reaktor-ledger (the keystone)", "level": 2 }, { "id": "6-reaktor-catalog", "anchor": "6-reaktor-catalog", "title": "6. New module #2 — reaktor-catalog (PIM)", "level": 2 }, { "id": "7-reaktor-fulfillment", "anchor": "7-reaktor-fulfillment", "title": "7. New module #3 — reaktor-fulfillment (the order domain)", "level": 2 }, { "id": "8-cross-cutting", "anchor": "8-cross-cutting", "title": "8. Cross-cutting thin primitives", "level": 2 }, { "id": "9-financing", "anchor": "9-financing", "title": "9. The financing layer — embedded working capital", "level": 2 }, { "id": "10-recipes", "anchor": "10-recipes", "title": "10. Putting it together — Nexergy as recipes", "level": 2 }, { "id": "11-runtime", "anchor": "11-runtime", "title": "11. Runtime topology", "level": 2 }, { "id": "12-primitives-not-vertical", "anchor": "12-primitives-not-vertical", "title": "12. Why these are Reaktor primitives, not a Nexergy vertical", "level": 2 }, { "id": "13-migration", "anchor": "13-migration", "title": "13. Migration from the prototype", "level": 2 }, { "id": "14-scorecard", "anchor": "14-scorecard", "title": "14. Module scorecard", "level": 2 }, { "id": "sources", "anchor": "sources", "title": "Sources", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "codex-nexergy-appweb-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "codex-nexergy-appweb-analysis", "anchor": "", "relation": "references", "sourceAnchor": "sources" }, { "id": "codex-nexergy-appweb-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "codex-critic-review", "owner": "Codex", "kind": "critique", "summary": "Skeptical counterarguments against the full Reaktor control-plane vision.", "use": "Read before expanding scope or trusting a broad roadmap.", "region": "background-market", "order": 2, "title": "Codex Critic Review", "nav": "Codex Critic", "group": "background", "subsection": "background-market", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/codex-critic-review", "revision": "69a0832a290f89fc45a27002ae14578883b8239b99b3534fa6d3b8c4d54567d2", "status": "historical", "renderingRevision": "c6e3bc4af3273a91dc431fa12ed3767f088481ab0ee13155c7ae955eab0e9aec", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/codex-critic-review", "polarity": "Neutral" }, { "id": "section-1-executive-verdict", "anchor": "1-executive-verdict", "label": "1. Executive Verdict", "profile": "section", "contract": "https://reaktor.build/docs/codex-critic-review#1-executive-verdict", "polarity": "Neutral" }, { "id": "section-2-core-counterarguments", "anchor": "2-core-counterarguments", "label": "2. Core Counterarguments", "profile": "section", "contract": "https://reaktor.build/docs/codex-critic-review#2-core-counterarguments", "polarity": "Neutral" }, { "id": "section-3-code-grounded-objections", "anchor": "3-code-grounded-objections", "label": "3. Code-Grounded Objections", "profile": "section", "contract": "https://reaktor.build/docs/codex-critic-review#3-code-grounded-objections", "polarity": "Neutral" }, { "id": "section-4-security-and-operational-critique", "anchor": "4-security-and-operational-critique", "label": "4. Security And Operational Critique", "profile": "section", "contract": "https://reaktor.build/docs/codex-critic-review#4-security-and-operational-critique", "polarity": "Neutral" }, { "id": "section-5-agents-and-command-queue-critique", "anchor": "5-agents-and-command-queue-critique", "label": "5. Agents And Command Queue Critique", "profile": "section", "contract": "https://reaktor.build/docs/codex-critic-review#5-agents-and-command-queue-critique", "polarity": "Neutral" }, { "id": "section-6-testing-critique", "anchor": "6-testing-critique", "label": "6. Testing Critique", "profile": "section", "contract": "https://reaktor.build/docs/codex-critic-review#6-testing-critique", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/codex-critic-review#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "codex-critic-review:references-claude-critic-review", "kind": "references", "owner": "codex-critic-review", "incidences": [ { "node": "codex-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "claude-critic-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-critic-review:references-reaktor-competitive-analysis", "kind": "references", "owner": "codex-critic-review", "incidences": [ { "node": "codex-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-critic-review:references-reaktor-workbench-roadmap", "kind": "references", "owner": "codex-critic-review", "incidences": [ { "node": "codex-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-critic-review:references-codex-roadmap", "kind": "references", "owner": "codex-critic-review", "incidences": [ { "node": "codex-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "codex-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-critic-review:references-reaktor-megascale-strategy", "kind": "references", "owner": "codex-critic-review", "incidences": [ { "node": "codex-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-megascale-strategy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-critic-review:references-reaktor-framework-overview", "kind": "references", "owner": "codex-critic-review", "incidences": [ { "node": "codex-critic-review", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "codex-critic-review.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Codex Critic Review", "level": 0 }, { "id": "1-executive-verdict", "anchor": "1-executive-verdict", "title": "1. Executive Verdict", "level": 2 }, { "id": "scope-risk", "anchor": "scope-risk", "title": "Scope Risk", "level": 3 }, { "id": "trust-risk", "anchor": "trust-risk", "title": "Trust Risk", "level": 3 }, { "id": "architecture-risk", "anchor": "architecture-risk", "title": "Architecture Risk", "level": 3 }, { "id": "salvageability", "anchor": "salvageability", "title": "Salvageability", "level": 3 }, { "id": "what-would-change-this-verdict", "anchor": "what-would-change-this-verdict", "title": "What would change this verdict", "level": 3 }, { "id": "2-core-counterarguments", "anchor": "2-core-counterarguments", "title": "2. Core Counterarguments", "level": 2 }, { "id": "the-biggest-conceptual-challenge", "anchor": "the-biggest-conceptual-challenge", "title": "The biggest conceptual challenge", "level": 3 }, { "id": "3-code-grounded-objections", "anchor": "3-code-grounded-objections", "title": "3. Code-Grounded Objections", "level": 2 }, { "id": "counterargument-to-the-counterargument", "anchor": "counterargument-to-the-counterargument", "title": "Counterargument to the counterargument", "level": 3 }, { "id": "4-security-and-operational-critique", "anchor": "4-security-and-operational-critique", "title": "4. Security And Operational Critique", "level": 2 }, { "id": "red-line-rule", "anchor": "red-line-rule", "title": "Red-line rule", "level": 3 }, { "id": "5-agents-and-command-queue-critique", "anchor": "5-agents-and-command-queue-critique", "title": "5. Agents And Command Queue Critique", "level": 2 }, { "id": "command-shape-is-not-semantic-safety", "anchor": "command-shape-is-not-semantic-safety", "title": "Command shape is not semantic safety", "level": 3 }, { "id": "agent-scouting-can-become-noise", "anchor": "agent-scouting-can-become-noise", "title": "Agent scouting can become noise", "level": 3 }, { "id": "commit-linkage-can-create-false-confidence", "anchor": "commit-linkage-can-create-false-confidence", "title": "Commit linkage can create false confidence", "level": 3 }, { "id": "hard-questions-for-the-agent-model", "anchor": "hard-questions-for-the-agent-model", "title": "Hard questions for the agent model", "level": 3 }, { "id": "6-testing-critique", "anchor": "6-testing-critique", "title": "6. Testing Critique", "level": 2 }, { "id": "tests-the-critic-would-require-before-expanding-scope", "anchor": "tests-the-critic-would-require-before-expanding-scope", "title": "Tests the critic would require before expanding scope", "level": 3 }, { "id": "7-product-and-adoption-risk", "anchor": "7-product-and-adoption-risk", "title": "7. Product And Adoption Risk", "level": 2 }, { "id": "the-buyer-may-not-exist-yet", "anchor": "the-buyer-may-not-exist-yet", "title": "The buyer may not exist yet", "level": 3 }, { "id": "the-adoption-cost-is-high", "anchor": "the-adoption-cost-is-high", "title": "The adoption cost is high", "level": 3 }, { "id": "existing-toolchains-are-good-enough-in-pieces", "anchor": "existing-toolchains-are-good-enough-in-pieces", "title": "Existing toolchains are good enough in pieces", "level": 3 }, { "id": "dogfood-can-mislead", "anchor": "dogfood-can-mislead", "title": "Dogfood can mislead", "level": 3 }, { "id": "positioning-critique", "anchor": "positioning-critique", "title": "Positioning critique", "level": 3 }, { "id": "8-safer-narrow-path", "anchor": "8-safer-narrow-path", "title": "8. Safer Narrow Path", "level": 2 }, { "id": "recommended-constraint", "anchor": "recommended-constraint", "title": "Recommended constraint", "level": 3 }, { "id": "kill-criteria", "anchor": "kill-criteria", "title": "Kill criteria", "level": 3 }, { "id": "most-constructive-critique", "anchor": "most-constructive-critique", "title": "Most constructive critique", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "claude-critic-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "codex-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "codex-dev-environment", "owner": "Codex", "kind": "prior", "summary": "Original capsule taxonomy, environment classes, materialisation workflow, and response comparison draft.", "use": "Use only when comparing prior shadow environment proposals.", "region": "background-research", "order": 5, "title": "Codex Dev Environment", "nav": "Codex Dev Env", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/codex-dev-environment", "revision": "45e48f440f4b6aa4411381f536db057dc87b5c63b7b9b9ec7e435be7764ae424", "status": "historical", "renderingRevision": "8950d252a91576ee29ccdefe43360698ca0fcc93e8930777284340f4b8a9539c", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/codex-dev-environment", "polarity": "Neutral" }, { "id": "section-summary", "anchor": "summary", "label": "1. Summary", "profile": "section", "contract": "https://reaktor.build/docs/codex-dev-environment#summary", "polarity": "Neutral" }, { "id": "section-spec-alignment", "anchor": "spec-alignment", "label": "2. Spec alignment", "profile": "section", "contract": "https://reaktor.build/docs/codex-dev-environment#spec-alignment", "polarity": "Neutral" }, { "id": "section-target-shape", "anchor": "target-shape", "label": "3. Target shape", "profile": "section", "contract": "https://reaktor.build/docs/codex-dev-environment#target-shape", "polarity": "Neutral" }, { "id": "section-capture-plane", "anchor": "capture-plane", "label": "4. Capture plane", "profile": "section", "contract": "https://reaktor.build/docs/codex-dev-environment#capture-plane", "polarity": "Neutral" }, { "id": "section-data-plane", "anchor": "data-plane", "label": "5. Data plane", "profile": "section", "contract": "https://reaktor.build/docs/codex-dev-environment#data-plane", "polarity": "Neutral" }, { "id": "section-shadow-capsules", "anchor": "shadow-capsules", "label": "6. Shadow capsules", "profile": "section", "contract": "https://reaktor.build/docs/codex-dev-environment#shadow-capsules", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/codex-dev-environment#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "codex-dev-environment:references-shadow-dev-environment", "kind": "references", "owner": "codex-dev-environment", "incidences": [ { "node": "codex-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-dev-environment:references-operations", "kind": "references", "owner": "codex-dev-environment", "incidences": [ { "node": "codex-dev-environment", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-dev-environment:references-claude-dev-environment", "kind": "references", "owner": "codex-dev-environment", "incidences": [ { "node": "codex-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "claude-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-dev-environment:references-performance-observability", "kind": "references", "owner": "codex-dev-environment", "incidences": [ { "node": "codex-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-dev-environment:references-secrets-management", "kind": "references", "owner": "codex-dev-environment", "incidences": [ { "node": "codex-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-dev-environment:references-reaktor-devops", "kind": "references", "owner": "codex-dev-environment", "incidences": [ { "node": "codex-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-dev-environment:references-flexbuffer-improvement-plan", "kind": "references", "owner": "codex-dev-environment", "incidences": [ { "node": "codex-dev-environment", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-improvement-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "codex-dev-environment.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Codex Dev Environment", "level": 0 }, { "id": "summary", "anchor": "summary", "title": "1. Summary", "level": 2 }, { "id": "moving-window", "anchor": "moving-window", "title": "Moving window", "level": 4 }, { "id": "pinned-anomalies", "anchor": "pinned-anomalies", "title": "Pinned anomalies", "level": 4 }, { "id": "writable-overlays", "anchor": "writable-overlays", "title": "Writable overlays", "level": 4 }, { "id": "spec-alignment", "anchor": "spec-alignment", "title": "2. Spec alignment", "level": 2 }, { "id": "target-shape", "anchor": "target-shape", "title": "3. Target shape", "level": 2 }, { "id": "target-shape-2", "anchor": "target-shape-2", "title": "Environment classes", "level": 3 }, { "id": "capture-plane", "anchor": "capture-plane", "title": "4. Capture plane", "level": 2 }, { "id": "capture-plane-2", "anchor": "capture-plane-2", "title": "Shadow envelope", "level": 3 }, { "id": "capture-plane-3", "anchor": "capture-plane-3", "title": "Capture adapters", "level": 3 }, { "id": "data-plane", "anchor": "data-plane", "title": "5. Data plane", "level": 2 }, { "id": "data-plane-2", "anchor": "data-plane-2", "title": "Resource materializers", "level": 3 }, { "id": "data-plane-3", "anchor": "data-plane-3", "title": "Base plus overlay", "level": 3 }, { "id": "shadow-capsules", "anchor": "shadow-capsules", "title": "6. Shadow capsules", "level": 2 }, { "id": "shadow-capsules-2", "anchor": "shadow-capsules-2", "title": "Capsule taxonomy", "level": 3 }, { "id": "shadow-capsules-3", "anchor": "shadow-capsules-3", "title": "Pinning rules", "level": 3 }, { "id": "materialization", "anchor": "materialization", "title": "7. Materialization workflow", "level": 2 }, { "id": "materialization-2", "anchor": "materialization-2", "title": "Developer commands", "level": 3 }, { "id": "replay", "anchor": "replay", "title": "8. Replay and testing", "level": 2 }, { "id": "replay-2", "anchor": "replay-2", "title": "Response comparison policy", "level": 3 }, { "id": "workbench", "anchor": "workbench", "title": "9. Workbench integration", "level": 2 }, { "id": "security", "anchor": "security", "title": "10. Security and governance", "level": 2 }, { "id": "security-2", "anchor": "security-2", "title": "Redaction contract", "level": 3 }, { "id": "security-3", "anchor": "security-3", "title": "Access model", "level": 3 }, { "id": "rollout", "anchor": "rollout", "title": "11. Rollout plan", "level": 2 }, { "id": "risks", "anchor": "risks", "title": "12. Risks and mitigations", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Open decisions", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "claude-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-improvement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "codex-nexergy-appweb-analysis", "owner": "Codex", "kind": "product", "summary": "Market-scanned target architecture and high-level subsystem map for Nexergy Energy, the production B2B biomass trader-aggregator platform running on feature-complete Reaktor: commerce, inventory/WMS, logistics/LMS, ledger/audit, graph workflow, credit, and service primitives without a biomass-specific module.", "use": "Use before building Nexergy Energy on Reaktor, scoping its commerce/inventory/logistics/ledger primitives, or designing its OMS/WMS/LMS platform surfaces on the graph.", "region": "products-apps", "order": 5, "title": "Codex Nexergy Energy on Reaktor", "nav": "Nexergy Energy", "group": "products", "subsection": "products-apps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/codex-nexergy-appweb-analysis", "revision": "6234610da8e3cbd099a8d7df3417a9d1435b722806eeb79d40cc49135393badd", "status": "unverified", "renderingRevision": "5165ba029183db82751f7bc2d354b99717d49744957ffc0b041aecd6b0d325d7", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://buyofuel.com/", "https://buyofuel.com/buyers/", "https://buyofuel.com/inventory-management/", "https://www.biofuelcircle.com/marketplace/", "https://www.biofuelcircle.com/supply-chain-as-a-service/", "https://www.biofuelcircle.com/envira/", "https://business.moglix.com/", "https://www.credlix.com/", "https://www.oxyzo.in/", "https://udaan.com/", "https://shopify.dev/docs/api/admin-rest", "https://docs.commercetools.com/api/projects/products", "https://buyofuel.com/sellers/", "https://buyofuel.com/sustainability-reporting/", "https://www.biofuelcircle.com/", "https://www.biofuelcircle.com/procurement-service/", "https://www.biofuelcircle.com/sales-service/", "https://www.biofuelcircle.com/value-added-services/", "https://www.moglix.com/", "https://docs.commercetools.com/api/projects/inventory" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis", "polarity": "Neutral" }, { "id": "section-1-high-level-platform-design", "anchor": "1-high-level-platform-design", "label": "1. High-Level Platform Design", "profile": "section", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis#1-high-level-platform-design", "polarity": "Neutral" }, { "id": "section-2-market-scan", "anchor": "2-market-scan", "label": "2. Market Scan", "profile": "section", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis#2-market-scan", "polarity": "Neutral" }, { "id": "section-3-commerce-operating-model", "anchor": "3-commerce-operating-model", "label": "3. Commerce Operating Model", "profile": "section", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis#3-commerce-operating-model", "polarity": "Neutral" }, { "id": "section-4-product-invariants", "anchor": "4-product-invariants", "label": "4. Product Invariants", "profile": "section", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis#4-product-invariants", "polarity": "Neutral" }, { "id": "section-5-module-targeting", "anchor": "5-module-targeting", "label": "5. Module Targeting", "profile": "section", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis#5-module-targeting", "polarity": "Neutral" }, { "id": "section-6-the-reaktor-commerce-substrate", "anchor": "6-the-reaktor-commerce-substrate", "label": "6. The Reaktor Commerce Substrate", "profile": "section", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis#6-the-reaktor-commerce-substrate", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/codex-nexergy-appweb-analysis#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "codex-nexergy-appweb-analysis:references-claude-nexergy-appweb-analysis", "kind": "references", "owner": "codex-nexergy-appweb-analysis", "incidences": [ { "node": "codex-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "claude-nexergy-appweb-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-nexergy-appweb-analysis:references-reaktor-service", "kind": "references", "owner": "codex-nexergy-appweb-analysis", "incidences": [ { "node": "codex-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-nexergy-appweb-analysis:references-reaktor-db", "kind": "references", "owner": "codex-nexergy-appweb-analysis", "incidences": [ { "node": "codex-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-nexergy-appweb-analysis:references-reaktor-work", "kind": "references", "owner": "codex-nexergy-appweb-analysis", "incidences": [ { "node": "codex-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-nexergy-appweb-analysis:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "codex-nexergy-appweb-analysis", "incidences": [ { "node": "codex-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-nexergy-appweb-analysis:references-reaktor-surface-renderers", "kind": "references", "owner": "codex-nexergy-appweb-analysis", "incidences": [ { "node": "codex-nexergy-appweb-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "codex-nexergy-appweb-analysis.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Codex Nexergy Energy on Reaktor", "level": 0 }, { "id": "1-high-level-platform-design", "anchor": "1-high-level-platform-design", "title": "1. High-Level Platform Design", "level": 2 }, { "id": "2-market-scan", "anchor": "2-market-scan", "title": "2. Market Scan", "level": 2 }, { "id": "3-commerce-operating-model", "anchor": "3-commerce-operating-model", "title": "3. Commerce Operating Model", "level": 2 }, { "id": "4-product-invariants", "anchor": "4-product-invariants", "title": "4. Product Invariants", "level": 2 }, { "id": "5-module-targeting", "anchor": "5-module-targeting", "title": "5. Module Targeting", "level": 2 }, { "id": "6-the-reaktor-commerce-substrate", "anchor": "6-the-reaktor-commerce-substrate", "title": "6. The Reaktor Commerce Substrate", "level": 2 }, { "id": "7-inventory-and-wms", "anchor": "7-inventory-and-wms", "title": "7. Inventory and WMS", "level": 2 }, { "id": "8-logistics-and-lmstms", "anchor": "8-logistics-and-lmstms", "title": "8. Logistics and LMS/TMS", "level": 2 }, { "id": "9-ledger-and-audit", "anchor": "9-ledger-and-audit", "title": "9. Ledger and Audit", "level": 2 }, { "id": "10-nexergy-energy-platform-graphs", "anchor": "10-nexergy-energy-platform-graphs", "title": "10. Nexergy Energy Platform Graphs", "level": 2 }, { "id": "11-service-map", "anchor": "11-service-map", "title": "11. Service Map", "level": 2 }, { "id": "12-workflow-recipes", "anchor": "12-workflow-recipes", "title": "12. Workflow Recipes", "level": 2 }, { "id": "13-ecommerce-back-office-recipes", "anchor": "13-ecommerce-back-office-recipes", "title": "13. Ecommerce Back Office Recipes", "level": 2 }, { "id": "14-data-authority-and-runtime-topology", "anchor": "14-data-authority-and-runtime-topology", "title": "14. Data Authority and Runtime Topology", "level": 2 }, { "id": "15-security-tenancy-and-redaction", "anchor": "15-security-tenancy-and-redaction", "title": "15. Security, Tenancy, and Redaction", "level": 2 }, { "id": "16-build-sequence", "anchor": "16-build-sequence", "title": "16. Build Sequence", "level": 2 }, { "id": "phase-0-freeze-the-vocabulary", "anchor": "phase-0-freeze-the-vocabulary", "title": "Phase 0: Freeze the vocabulary", "level": 3 }, { "id": "phase-1-ledger-and-contracts-first", "anchor": "phase-1-ledger-and-contracts-first", "title": "Phase 1: Ledger and contracts first", "level": 3 }, { "id": "phase-2-ops-first-mvp", "anchor": "phase-2-ops-first-mvp", "title": "Phase 2: Ops-first MVP", "level": 3 }, { "id": "phase-3-commerce-inventory-and-logistics-extraction", "anchor": "phase-3-commerce-inventory-and-logistics-extraction", "title": "Phase 3: Commerce, inventory, and logistics extraction", "level": 3 }, { "id": "phase-4-b2b-depth", "anchor": "phase-4-b2b-depth", "title": "Phase 4: B2B depth", "level": 3 }, { "id": "phase-5-scale-and-automation", "anchor": "phase-5-scale-and-automation", "title": "Phase 5: Scale and automation", "level": 3 }, { "id": "17-non-goals", "anchor": "17-non-goals", "title": "17. Non-Goals", "level": 2 }, { "id": "18-final-shape", "anchor": "18-final-shape", "title": "18. Final Shape", "level": 2 }, { "id": "sources-scanned", "anchor": "sources-scanned", "title": "Sources Scanned", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "claude-nexergy-appweb-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "codex-roadmap", "owner": "Codex", "kind": "roadmap", "summary": "Code-grounded roadmap for turning the workbench prototype into a real control plane.", "use": "Historical delivery proposal. Use the Astra system plan and module execution plan for current direction and acceptance criteria.", "region": "background-roadmaps", "order": 0, "title": "Codex Roadmap", "nav": "Codex Roadmap", "group": "background", "subsection": "background-roadmaps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/codex-roadmap", "revision": "0110f58f3cd31e4f501ee3555bec287c4db3c71080527de12e98daf202290c5a", "status": "superseded", "renderingRevision": "cbccc38a8c960bc09881e22dfa066a8bd5300cf4aebb703bd1f48534a08be945", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/codex-roadmap", "polarity": "Neutral" }, { "id": "section-1-summary", "anchor": "1-summary", "label": "1. Summary", "profile": "section", "contract": "https://reaktor.build/docs/codex-roadmap#1-summary", "polarity": "Neutral" }, { "id": "section-2-evidence-from-the-current-code", "anchor": "2-evidence-from-the-current-code", "label": "2. Evidence From The Current Code", "profile": "section", "contract": "https://reaktor.build/docs/codex-roadmap#2-evidence-from-the-current-code", "polarity": "Neutral" }, { "id": "section-2a-deeper-code-level-analysis", "anchor": "2a-deeper-code-level-analysis", "label": "2A. Deeper Code-Level Analysis", "profile": "section", "contract": "https://reaktor.build/docs/codex-roadmap#2a-deeper-code-level-analysis", "polarity": "Neutral" }, { "id": "section-3-target-architecture", "anchor": "3-target-architecture", "label": "3. Target Architecture", "profile": "section", "contract": "https://reaktor.build/docs/codex-roadmap#3-target-architecture", "polarity": "Neutral" }, { "id": "section-4-prototype-feature-map", "anchor": "4-prototype-feature-map", "label": "4. Prototype Feature Map", "profile": "section", "contract": "https://reaktor.build/docs/codex-roadmap#4-prototype-feature-map", "polarity": "Neutral" }, { "id": "section-5-implementation-phases", "anchor": "5-implementation-phases", "label": "5. Implementation Phases", "profile": "section", "contract": "https://reaktor.build/docs/codex-roadmap#5-implementation-phases", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/codex-roadmap#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "codex-roadmap:references-reaktor-workbench-roadmap", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-roadmap:references-reaktor-implementation-plan", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-implementation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-roadmap:references-graph-kernel-analysis", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-roadmap:references-reaktor-agentic-tooling", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-roadmap:references-reaktor-architecture-analysis", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-architecture-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-roadmap:references-reaktor-framework-overview", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-roadmap:current-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "codex-roadmap:current-reaktor-module-execution-plan", "kind": "references", "owner": "codex-roadmap", "incidences": [ { "node": "codex-roadmap", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "codex-roadmap.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Codex Roadmap", "level": 0 }, { "id": "1-summary", "anchor": "1-summary", "title": "1. Summary", "level": 2 }, { "id": "keep", "anchor": "keep", "title": "Keep", "level": 3 }, { "id": "replace", "anchor": "replace", "title": "Replace", "level": 3 }, { "id": "converge", "anchor": "converge", "title": "Converge", "level": 3 }, { "id": "2-evidence-from-the-current-code", "anchor": "2-evidence-from-the-current-code", "title": "2. Evidence From The Current Code", "level": 2 }, { "id": "2a-deeper-code-level-analysis", "anchor": "2a-deeper-code-level-analysis", "title": "2A. Deeper Code-Level Analysis", "level": 2 }, { "id": "runtime-substrate-that-should-be-reused", "anchor": "runtime-substrate-that-should-be-reused", "title": "Runtime substrate that should be reused", "level": 3 }, { "id": "bestbuds-is-a-concrete-dogfood-app-not-a-toy-fixture", "anchor": "bestbuds-is-a-concrete-dogfood-app-not-a-toy-fixture", "title": "BestBuds is a concrete dogfood app, not a toy fixture", "level": 3 }, { "id": "current-graph-document-export-is-useful-but-too-thin", "anchor": "current-graph-document-export-is-useful-but-too-thin", "title": "Current graph document export is useful but too thin", "level": 3 }, { "id": "prototype-to-real-replacement-map", "anchor": "prototype-to-real-replacement-map", "title": "Prototype-to-real replacement map", "level": 3 }, { "id": "production-blockers-found-in-code", "anchor": "production-blockers-found-in-code", "title": "Production blockers found in code", "level": 3 }, { "id": "concrete-first-implementation-delta", "anchor": "concrete-first-implementation-delta", "title": "Concrete first implementation delta", "level": 3 }, { "id": "3-target-architecture", "anchor": "3-target-architecture", "title": "3. Target Architecture", "level": 2 }, { "id": "core-packages-to-introduce-or-promote", "anchor": "core-packages-to-introduce-or-promote", "title": "Core packages to introduce or promote", "level": 3 }, { "id": "shape-of-the-shared-contract", "anchor": "shape-of-the-shared-contract", "title": "Shape of the shared contract", "level": 3 }, { "id": "4-prototype-feature-map", "anchor": "4-prototype-feature-map", "title": "4. Prototype Feature Map", "level": 2 }, { "id": "5-implementation-phases", "anchor": "5-implementation-phases", "title": "5. Implementation Phases", "level": 2 }, { "id": "6-bestbuds-dogfood-gaps-the-workbench-should-expose", "anchor": "6-bestbuds-dogfood-gaps-the-workbench-should-expose", "title": "6. BestBuds Dogfood Gaps The Workbench Should Expose", "level": 2 }, { "id": "7-testing-strategy", "anchor": "7-testing-strategy", "title": "7. Testing Strategy", "level": 2 }, { "id": "contract-tests", "anchor": "contract-tests", "title": "Contract tests", "level": 3 }, { "id": "ui-and-workflow-tests", "anchor": "ui-and-workflow-tests", "title": "UI and workflow tests", "level": 3 }, { "id": "production-readiness-gates", "anchor": "production-readiness-gates", "title": "Production-readiness gates", "level": 3 }, { "id": "8-risks-and-mitigations", "anchor": "8-risks-and-mitigations", "title": "8. Risks And Mitigations", "level": 2 }, { "id": "risk-the-ui-outpaces-the-substrate-again", "anchor": "risk-the-ui-outpaces-the-substrate-again", "title": "Risk: the UI outpaces the substrate again", "level": 3 }, { "id": "risk-graph-manifest-becomes-another-static-snapshot", "anchor": "risk-graph-manifest-becomes-another-static-snapshot", "title": "Risk: graph manifest becomes another static snapshot", "level": 3 }, { "id": "risk-command-queue-can-damage-source-or-production", "anchor": "risk-command-queue-can-damage-source-or-production", "title": "Risk: command queue can damage source or production", "level": 3 }, { "id": "risk-authdb-consoles-expose-sensitive-data", "anchor": "risk-authdb-consoles-expose-sensitive-data", "title": "Risk: auth/DB consoles expose sensitive data", "level": 3 }, { "id": "risk-agents-create-unreviewable-complexity", "anchor": "risk-agents-create-unreviewable-complexity", "title": "Risk: agents create unreviewable complexity", "level": 3 }, { "id": "risk-two-workbenches-diverge", "anchor": "risk-two-workbenches-diverge", "title": "Risk: two workbenches diverge", "level": 3 }, { "id": "near-term-execution-order", "anchor": "near-term-execution-order", "title": "Near-Term Execution Order", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-implementation-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-architecture-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "companyos-migration-plan", "owner": "Claude", "kind": "product", "summary": "CompanyOS migration record covering the landed TypeScript/Vite cutover, typed service contract, Browser Run portal sessions, Cloudflare Workflow DAG runner, Playwright gates, and 20 routine automation recipes.", "use": "Use before changing the CompanyOS architecture, importer, browser automation, Workflow DAGs, or migration phases.", "region": "products-apps", "order": 3, "title": "CompanyOS — TypeScript / Vite / Reaktor Migration Plan", "nav": "CompanyOS Migration", "group": "products", "subsection": "products-apps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/companyos-migration-plan", "revision": "488ab48b32b51442a9dbaf3c490c35cf15511df4fda77490ea0449cedf63c6e5", "status": "unverified", "renderingRevision": "6ef0778c365f5fd6cafe6d90bbcdb8a2cd2da605925b172971ac5835a0cb0346", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/companyos-migration-plan", "polarity": "Neutral" }, { "id": "section-situation", "anchor": "situation", "label": "1. Situation & Goals", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#situation", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "2. Baseline Architecture & Domain Shape", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#current", "polarity": "Neutral" }, { "id": "section-stack", "anchor": "stack", "label": "3. Target Stack — TypeScript + Vite + Cloudflare", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#stack", "polarity": "Neutral" }, { "id": "section-decompose", "anchor": "decompose", "label": "4. Decomposition with Reaktor Principles", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#decompose", "polarity": "Neutral" }, { "id": "section-graph", "anchor": "graph", "label": "5. Reaktor-Graph + Reaktor-Service Adoption", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#graph", "polarity": "Neutral" }, { "id": "section-browser", "anchor": "browser", "label": "6. Browser Automation via Cloudflare Browser Rendering", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#browser", "polarity": "Neutral" }, { "id": "section-dual-runtime", "anchor": "dual-runtime", "label": "6a. Dual-runtime execution — local Playwright ↔ Cloudflare DO", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#dual-runtime", "polarity": "Neutral" }, { "id": "section-agent-drive", "anchor": "agent-drive", "label": "6b. Agent-driven operation — Claude / Codex", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#agent-drive", "polarity": "Neutral" }, { "id": "section-recipes", "anchor": "recipes", "label": "7. Automation Recipes", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#recipes", "polarity": "Neutral" }, { "id": "section-perf", "anchor": "perf", "label": "8. Performance — Lighthouse Profiling & Acceleration", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#perf", "polarity": "Neutral" }, { "id": "section-tests", "anchor": "tests", "label": "9. Tests — Using & Refining Codex's Suites", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#tests", "polarity": "Neutral" }, { "id": "section-phases", "anchor": "phases", "label": "10. Migration Phases", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#phases", "polarity": "Neutral" }, { "id": "section-risks", "anchor": "risks", "label": "11. Risk Matrix", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#risks", "polarity": "Neutral" }, { "id": "section-decisions", "anchor": "decisions", "label": "12. Open Decisions", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#decisions", "polarity": "Neutral" }, { "id": "section-appendix", "anchor": "appendix", "label": "13. Appendix — File / Action Map", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#appendix", "polarity": "Neutral" }, { "id": "section-tier-a-incremental-in-browser-graph-runtime", "anchor": "tier-a-incremental-in-browser-graph-runtime", "label": "Tier A (incremental): in-browser graph runtime", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#tier-a-incremental-in-browser-graph-runtime", "polarity": "Neutral" }, { "id": "section-everything-from-reaktor-map", "anchor": "everything-from-reaktor-map", "label": "Everything-from-Reaktor map", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#everything-from-reaktor-map", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/companyos-migration-plan#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "companyos-migration-plan:references-reaktor-service", "kind": "references", "owner": "companyos-migration-plan", "incidences": [ { "node": "companyos-migration-plan", "port": "section-graph", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "companyos-migration-plan:references-reaktor-graph-migration-plan", "kind": "references", "owner": "companyos-migration-plan", "incidences": [ { "node": "companyos-migration-plan", "port": "section-tier-a-incremental-in-browser-graph-runtime", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "companyos-migration-plan:references-reaktor-work", "kind": "references", "owner": "companyos-migration-plan", "incidences": [ { "node": "companyos-migration-plan", "port": "section-everything-from-reaktor-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "companyos-migration-plan:references-reaktor-surface-renderers", "kind": "references", "owner": "companyos-migration-plan", "incidences": [ { "node": "companyos-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "companyos-migration-plan:references-performance-observability", "kind": "references", "owner": "companyos-migration-plan", "incidences": [ { "node": "companyos-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "companyos-migration-plan:references-shadow-dev-environment", "kind": "references", "owner": "companyos-migration-plan", "incidences": [ { "node": "companyos-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "companyos-migration-plan:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "companyos-migration-plan", "incidences": [ { "node": "companyos-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "companyos-migration-plan.json", "sections": [ { "id": "preamble", "anchor": "", "title": "CompanyOS — TypeScript / Vite / Reaktor Migration Plan", "level": 0 }, { "id": "situation", "anchor": "situation", "title": "1. Situation & Goals", "level": 2 }, { "id": "baseline-snapshot-2026-06-05", "anchor": "baseline-snapshot-2026-06-05", "title": "Baseline snapshot (2026-06-05)", "level": 3 }, { "id": "current-implementation-snapshot-2026-06-07", "anchor": "current-implementation-snapshot-2026-06-07", "title": "Current implementation snapshot (2026-06-07)", "level": 3 }, { "id": "goals-this-plan", "anchor": "goals-this-plan", "title": "Goals (this plan)", "level": 3 }, { "id": "non-goals--invariants-do-not-break", "anchor": "non-goals--invariants-do-not-break", "title": "Non-goals / invariants (do not break)", "level": 3 }, { "id": "current", "anchor": "current", "title": "2. Baseline Architecture & Domain Shape", "level": 2 }, { "id": "baseline-file-map-targetscompanyos-pre-cutover", "anchor": "baseline-file-map-targetscompanyos-pre-cutover", "title": "Baseline file map (targets/companyOS, pre-cutover)", "level": 3 }, { "id": "the-data-is-already-a-graph", "anchor": "the-data-is-already-a-graph", "title": "The data is already a graph", "level": 3 }, { "id": "the-store-is-a-hand-rolled-actor", "anchor": "the-store-is-a-hand-rolled-actor", "title": "The store is a hand-rolled actor", "level": 3 }, { "id": "auth-frozen-contract", "anchor": "auth-frozen-contract", "title": "Auth (frozen contract)", "level": 3 }, { "id": "stack", "anchor": "stack", "title": "3. Target Stack — TypeScript + Vite + Cloudflare", "level": 2 }, { "id": "decompose", "anchor": "decompose", "title": "4. Decomposition with Reaktor Principles", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "5. Reaktor-Graph + Reaktor-Service Adoption", "level": 2 }, { "id": "tier-b-do-first-service-contracts--graph-backed-persistence", "anchor": "tier-b-do-first-service-contracts--graph-backed-persistence", "title": "Tier B (do first): service contracts + graph-backed persistence", "level": 3 }, { "id": "tier-a-incremental-in-browser-graph-runtime", "anchor": "tier-a-incremental-in-browser-graph-runtime", "title": "Tier A (incremental): in-browser graph runtime", "level": 3 }, { "id": "everything-from-reaktor-map", "anchor": "everything-from-reaktor-map", "title": "Everything-from-Reaktor map", "level": 3 }, { "id": "browser", "anchor": "browser", "title": "6. Browser Automation via Cloudflare Browser Rendering", "level": 2 }, { "id": "dual-runtime", "anchor": "dual-runtime", "title": "6a. Dual-runtime execution — local Playwright ↔ Cloudflare DO", "level": 3 }, { "id": "agent-drive", "anchor": "agent-drive", "title": "6b. Agent-driven operation — Claude / Codex", "level": 3 }, { "id": "recipes", "anchor": "recipes", "title": "7. Automation Recipes", "level": 2 }, { "id": "perf", "anchor": "perf", "title": "8. Performance — Lighthouse Profiling & Acceleration", "level": 2 }, { "id": "tests", "anchor": "tests", "title": "9. Tests — Using & Refining Codex's Suites", "level": 2 }, { "id": "phases", "anchor": "phases", "title": "10. Migration Phases", "level": 2 }, { "id": "risks", "anchor": "risks", "title": "11. Risk Matrix", "level": 2 }, { "id": "decisions", "anchor": "decisions", "title": "12. Open Decisions", "level": 2 }, { "id": "appendix", "anchor": "appendix", "title": "13. Appendix — File / Action Map", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "companyos-migration-plan", "anchor": "situation", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "current", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "stack", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "decompose", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "graph", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "browser", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "dual-runtime", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "agent-drive", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "recipes", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "perf", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "tests", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "phases", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "risks", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "decisions", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "appendix", "relation": "references", "sourceAnchor": "" }, { "id": "companyos-migration-plan", "anchor": "decisions", "relation": "references", "sourceAnchor": "stack" }, { "id": "companyos-migration-plan", "anchor": "appendix", "relation": "references", "sourceAnchor": "decompose" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "graph" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "tier-b-do-first-service-contracts--graph-backed-persistence" }, { "id": "companyos-migration-plan", "anchor": "decisions", "relation": "references", "sourceAnchor": "tier-b-do-first-service-contracts--graph-backed-persistence" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "tier-a-incremental-in-browser-graph-runtime" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "everything-from-reaktor-map" }, { "id": "companyos-migration-plan", "anchor": "decisions", "relation": "references", "sourceAnchor": "browser" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "decisions" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "contributing", "owner": "Merged", "kind": "guide", "summary": "The practical entry point for a new contributor: what lives in which repository, the module map, how to set up and build, the two rules every module must obey, where to put a change, and how to add or edit a doc on this site.", "use": "Read before your first change to Reaktor, and whenever you add a module or a doc.", "region": "start-here-core", "order": 4, "title": "Contributing to Reaktor", "nav": "Contributing", "group": "start-here", "subsection": "start-here-core", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/contributing", "revision": "cec814bd91626957fefe0477dee9acfcc9714497b4195588b84a77370da74e75", "status": "unverified", "renderingRevision": "5260cde2b1f41b8e882c9c077570395b3c189584530028666598305df2cce8ec", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://manna.ac/documentation" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/contributing", "polarity": "Neutral" }, { "id": "section-repositories", "anchor": "repositories", "label": "1. Which repository", "profile": "section", "contract": "https://reaktor.build/docs/contributing#repositories", "polarity": "Neutral" }, { "id": "section-modules", "anchor": "modules", "label": "2. The module map", "profile": "section", "contract": "https://reaktor.build/docs/contributing#modules", "polarity": "Neutral" }, { "id": "section-setup", "anchor": "setup", "label": "3. Set up and build", "profile": "section", "contract": "https://reaktor.build/docs/contributing#setup", "polarity": "Neutral" }, { "id": "section-rules", "anchor": "rules", "label": "4. The two rules", "profile": "section", "contract": "https://reaktor.build/docs/contributing#rules", "polarity": "Neutral" }, { "id": "section-code", "anchor": "code", "label": "5. Writing the code", "profile": "section", "contract": "https://reaktor.build/docs/contributing#code", "polarity": "Neutral" }, { "id": "section-docs", "anchor": "docs", "label": "6. Working on these docs", "profile": "section", "contract": "https://reaktor.build/docs/contributing#docs", "polarity": "Neutral" } ], "relations": [ { "id": "contributing:references-reaktor-framework-overview", "kind": "references", "owner": "contributing", "incidences": [ { "node": "contributing", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "contributing:references-home-background", "kind": "references", "owner": "contributing", "incidences": [ { "node": "contributing", "port": "page", "role": "source", "ordinal": 0 }, { "node": "home", "port": "section-background", "role": "target", "ordinal": 0 } ] }, { "id": "contributing:references-reaktor-agent-efficiency", "kind": "references", "owner": "contributing", "incidences": [ { "node": "contributing", "port": "section-code", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-efficiency", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "contributing:references-flexbuffer-performance-review", "kind": "references", "owner": "contributing", "incidences": [ { "node": "contributing", "port": "section-code", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "contributing:references-documentation-library-machine-reading-contract", "kind": "references", "owner": "contributing", "incidences": [ { "node": "contributing", "port": "section-docs", "role": "source", "ordinal": 0 }, { "node": "documentation-library", "port": "section-machine-reading-contract", "role": "target", "ordinal": 0 } ] } ] }, "content": "contributing.json", "sections": [ { "id": "contributing-to-reaktor", "anchor": "contributing-to-reaktor", "title": "Contributing to Reaktor", "level": 1 }, { "id": "repositories", "anchor": "repositories", "title": "1. Which repository", "level": 2 }, { "id": "modules", "anchor": "modules", "title": "2. The module map", "level": 2 }, { "id": "setup", "anchor": "setup", "title": "3. Set up and build", "level": 2 }, { "id": "rules", "anchor": "rules", "title": "4. The two rules", "level": 2 }, { "id": "every-module-needs-a-graph-agnostic-surface", "anchor": "every-module-needs-a-graph-agnostic-surface", "title": "Modules compose through the graph", "level": 3 }, { "id": "layers-do-not-leak", "anchor": "layers-do-not-leak", "title": "Layers do not leak", "level": 3 }, { "id": "code", "anchor": "code", "title": "5. Writing the code", "level": 2 }, { "id": "docs", "anchor": "docs", "title": "6. Working on these docs", "level": 2 }, { "id": "where", "anchor": "where", "title": "7. Where a change belongs", "level": 2 } ], "links": [ { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "background", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agent-efficiency", "anchor": "", "relation": "references", "sourceAnchor": "code" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "code" }, { "id": "documentation-graph-markers", "anchor": "", "relation": "references", "sourceAnchor": "docs" }, { "id": "documentation-library", "anchor": "machine-reading-contract", "relation": "references", "sourceAnchor": "docs" } ] }, { "id": "deep-link-integration", "owner": "Codex", "kind": "module", "summary": "Graph-native URI model, route index, backstack planner, guards, and platform bridges.", "use": "Use before adding route-driven external entry points.", "region": "framework-backend", "order": 3, "title": "Deep Link Integration", "nav": "Deep Links", "group": "framework", "subsection": "framework-backend", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/deep-link-integration", "revision": "ff58b8fb53f5204e5786b9071c9aa023a2e5a0df23225dcab4e99215575d4197", "status": "unverified", "renderingRevision": "7fee0ad3bda2bf9c3d7ef0a179b67b9d38a2c45f1faeadba5c913935662fea43", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/deep-link-integration", "polarity": "Neutral" }, { "id": "section-summary", "anchor": "summary", "label": "1. Executive summary", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#summary", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "2. Current state", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#current", "polarity": "Neutral" }, { "id": "section-goals", "anchor": "goals", "label": "3. Goals & non-goals", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#goals", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "4. URI model", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#model", "polarity": "Neutral" }, { "id": "section-arch", "anchor": "arch", "label": "5. Architecture", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#arch", "polarity": "Neutral" }, { "id": "section-visitors", "anchor": "visitors", "label": "6. The four visitors", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#visitors", "polarity": "Neutral" }, { "id": "section-wellknown", "anchor": "wellknown", "label": "14. .well-known association files", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#wellknown", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/deep-link-integration#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "deep-link-integration:references-reaktor_graph_visitors_design", "kind": "references", "owner": "deep-link-integration", "incidences": [ { "node": "deep-link-integration", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "deep-link-integration:references-reaktor-graph-migration-plan", "kind": "references", "owner": "deep-link-integration", "incidences": [ { "node": "deep-link-integration", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "deep-link-integration:references-auth-analysis", "kind": "references", "owner": "deep-link-integration", "incidences": [ { "node": "deep-link-integration", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "deep-link-integration:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "deep-link-integration", "incidences": [ { "node": "deep-link-integration", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "deep-link-integration:references-performance-observability", "kind": "references", "owner": "deep-link-integration", "incidences": [ { "node": "deep-link-integration", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "deep-link-integration:references-reaktor-server", "kind": "references", "owner": "deep-link-integration", "incidences": [ { "node": "deep-link-integration", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "deep-link-integration.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Deep Link Integration", "level": 0 }, { "id": "summary", "anchor": "summary", "title": "1. Executive summary", "level": 2 }, { "id": "current", "anchor": "current", "title": "2. Current state", "level": 2 }, { "id": "current-2", "anchor": "current-2", "title": "2.1 What works", "level": 3 }, { "id": "current-3", "anchor": "current-3", "title": "2.2 What's missing", "level": 3 }, { "id": "goals", "anchor": "goals", "title": "3. Goals & non-goals", "level": 2 }, { "id": "goals-2", "anchor": "goals-2", "title": "Goals", "level": 4 }, { "id": "non-goals", "anchor": "non-goals", "title": "Non-goals", "level": 4 }, { "id": "model", "anchor": "model", "title": "4. URI model", "level": 2 }, { "id": "arch", "anchor": "arch", "title": "5. Architecture", "level": 2 }, { "id": "visitors", "anchor": "visitors", "title": "6. The four visitors", "level": 2 }, { "id": "visitors-2", "anchor": "visitors-2", "title": "6.1 RouteIndexVisitor", "level": 3 }, { "id": "visitors-3", "anchor": "visitors-3", "title": "6.2 BackStackPlannerVisitor", "level": 3 }, { "id": "visitors-4", "anchor": "visitors-4", "title": "6.3 GuardCollectorVisitor", "level": 3 }, { "id": "visitors-5", "anchor": "visitors-5", "title": "6.4 SchemaEmitterVisitor", "level": 3 }, { "id": "api", "anchor": "api", "title": "7. Common API surface", "level": 2 }, { "id": "android", "anchor": "android", "title": "8. Android bridge", "level": 2 }, { "id": "android-2", "anchor": "android-2", "title": "8.1 Manifest", "level": 3 }, { "id": "android-3", "anchor": "android-3", "title": "8.2 Activity wiring", "level": 3 }, { "id": "ios", "anchor": "ios", "title": "9. iOS bridge", "level": 2 }, { "id": "ios-2", "anchor": "ios-2", "title": "9.1 Info.plist", "level": 3 }, { "id": "ios-3", "anchor": "ios-3", "title": "9.2 AppDelegate wiring", "level": 3 }, { "id": "web", "anchor": "web", "title": "10. Web bridge", "level": 2 }, { "id": "desktop", "anchor": "desktop", "title": "11. Desktop bridge", "level": 2 }, { "id": "guards", "anchor": "guards", "title": "12. Auth guards & pending links", "level": 2 }, { "id": "guards-2", "anchor": "guards-2", "title": "12.1 The flow", "level": 3 }, { "id": "guards-3", "anchor": "guards-3", "title": "12.2 PendingDeepLink", "level": 3 }, { "id": "guards-4", "anchor": "guards-4", "title": "12.3 Declaring a guard", "level": 3 }, { "id": "actions", "anchor": "actions", "title": "13. Actions — non-route deep links", "level": 2 }, { "id": "wellknown", "anchor": "wellknown", "title": "14. .well-known association files", "level": 2 }, { "id": "wellknown-2", "anchor": "wellknown-2", "title": "14.1 Android — assetlinks.json", "level": 3 }, { "id": "wellknown-3", "anchor": "wellknown-3", "title": "14.2 iOS — apple-app-site-association", "level": 3 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "15. BestBuds wiring", "level": 2 }, { "id": "bestbuds-2", "anchor": "bestbuds-2", "title": "15.1 What BestBuds adds", "level": 3 }, { "id": "testing", "anchor": "testing", "title": "16. Testing strategy", "level": 2 }, { "id": "testing-2", "anchor": "testing-2", "title": "commonTest", "level": 4 }, { "id": "testing-3", "anchor": "testing-3", "title": "androidTest / iosTest", "level": 4 }, { "id": "testing-4", "anchor": "testing-4", "title": "e2e via Maestro (already wired in bestbuds/maestro)", "level": 4 }, { "id": "plan", "anchor": "plan", "title": "17. Phased plan", "level": 2 }, { "id": "phase-1--common-resolver--1-day", "anchor": "phase-1--common-resolver--1-day", "title": "Phase 1 — Common resolver · ~1 day", "level": 4 }, { "id": "phase-2--web-bridge-refactor---day", "anchor": "phase-2--web-bridge-refactor---day", "title": "Phase 2 — Web bridge refactor · ~½ day", "level": 4 }, { "id": "phase-3--android--1-day", "anchor": "phase-3--android--1-day", "title": "Phase 3 — Android · ~1 day", "level": 4 }, { "id": "phase-4--ios--1-day", "anchor": "phase-4--ios--1-day", "title": "Phase 4 — iOS · ~1 day", "level": 4 }, { "id": "phase-5--guards--pending-queue--1-day", "anchor": "phase-5--guards--pending-queue--1-day", "title": "Phase 5 — Guards & pending queue · ~1 day", "level": 4 }, { "id": "phase-6--synthetic-back-stack--1-day", "anchor": "phase-6--synthetic-back-stack--1-day", "title": "Phase 6 — Synthetic back stack · ~1 day", "level": 4 }, { "id": "phase-7--desktop--well-known--applink-autoverify--1-day", "anchor": "phase-7--desktop--well-known--applink-autoverify--1-day", "title": "Phase 7 — Desktop + .well-known + AppLink autoVerify · ~1 day", "level": 4 }, { "id": "phase-8--actions-share-urls-analytics---day", "anchor": "phase-8--actions-share-urls-analytics---day", "title": "Phase 8 — Actions, share URLs, analytics · ~½ day", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "18. Risks & open questions", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Risks", "level": 4 }, { "id": "risks-3", "anchor": "risks-3", "title": "Open questions", "level": 4 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "deep-link-integration", "anchor": "wellknown", "relation": "references", "sourceAnchor": "ios-2" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "documentation-audit", "owner": "Reaktor documentation", "kind": "analysis", "summary": "Criterion-by-criterion findings across the public and private corpus, source integration, structural repairs, canonical roles and editorial priorities.", "use": "Read the measured findings and distinguish completed structural repairs from current-source qualification.", "region": "start-here-core", "order": 5, "title": "Documentation audit — 7 October 2026", "nav": "Documentation audit", "group": "start-here", "subsection": "start-here-core", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/documentation-audit", "revision": "b3a32bef8102dc15c3ec00d951a78a423060e3968e49807a1449ee20b8fccf19", "status": "historical", "renderingRevision": "27a1287d8fb62a83c741f096d5a6df7d7ef94e771c7c83a2f03aa7cf42110e8d", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/documentation-audit", "polarity": "Neutral" }, { "id": "section-scope-and-measured-findings", "anchor": "scope-and-measured-findings", "label": "Scope and measured findings", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#scope-and-measured-findings", "polarity": "Neutral" }, { "id": "section-assessment-against-the-requested-criteria", "anchor": "assessment-against-the-requested-criteria", "label": "Assessment against the requested criteria", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#assessment-against-the-requested-criteria", "polarity": "Neutral" }, { "id": "section-canonical-roles-and-editorial-order", "anchor": "canonical-roles-and-editorial-order", "label": "Canonical roles and editorial order", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#canonical-roles-and-editorial-order", "polarity": "Neutral" }, { "id": "section-rechecking-the-work", "anchor": "rechecking-the-work", "label": "Rechecking the work", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#rechecking-the-work", "polarity": "Neutral" }, { "id": "retirement", "anchor": "retirement-candidates", "label": "Retirement candidates", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#retirement-candidates", "polarity": "Neutral" }, { "id": "pruning", "anchor": "section-pruning", "label": "Sections that can be removed or replaced", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#section-pruning", "polarity": "Neutral" }, { "id": "preserve", "anchor": "preserve-material", "label": "Material to preserve", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#preserve-material", "polarity": "Neutral" }, { "id": "anchors", "anchor": "anchor-and-example-contract", "label": "Anchor and example contract", "profile": "section", "contract": "https://reaktor.build/docs/documentation-audit#anchor-and-example-contract", "polarity": "Neutral" } ], "relations": [ { "id": "documentation-audit:references-documentation-library", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "section-rechecking-the-work", "role": "source", "ordinal": 0 }, { "node": "documentation-library", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:explains-documentation-library", "kind": "explains", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "page", "role": "source", "ordinal": 0 }, { "node": "documentation-library", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:references-architecture-atlas-qualification", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:references-engine-preprint-reference", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:references-contributing", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "page", "role": "source", "ordinal": 0 }, { "node": "contributing", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:retirement-review-codex-roadmap", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "retirement", "role": "source", "ordinal": 0 }, { "node": "codex-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:retirement-review-reaktor-workbench-roadmap", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "retirement", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:retirement-review-reaktor-implementation-plan", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "retirement", "role": "source", "ordinal": 0 }, { "node": "reaktor-implementation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:retirement-review-shadow-design-history", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "retirement", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:retirement-review-performance-observability-history", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "retirement", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-audit:retirement-review-reaktor-graph-theory", "kind": "references", "owner": "documentation-audit", "incidences": [ { "node": "documentation-audit", "port": "retirement", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "documentation-audit.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Documentation audit — 7 October 2026", "level": 0 }, { "id": "scope-and-measured-findings", "anchor": "scope-and-measured-findings", "title": "Scope and measured findings", "level": 2 }, { "id": "assessment-against-the-requested-criteria", "anchor": "assessment-against-the-requested-criteria", "title": "Assessment against the requested criteria", "level": 2 }, { "id": "canonical-roles-and-editorial-order", "anchor": "canonical-roles-and-editorial-order", "title": "Canonical roles and editorial order", "level": 2 }, { "id": "rechecking-the-work", "anchor": "rechecking-the-work", "title": "Rechecking the work", "level": 2 }, { "id": "retirement-candidates", "anchor": "retirement-candidates", "title": "Retirement candidates", "level": 2 }, { "id": "section-pruning", "anchor": "section-pruning", "title": "Sections that can be removed or replaced", "level": 2 }, { "id": "preserve-material", "anchor": "preserve-material", "title": "Material to preserve", "level": 2 }, { "id": "anchor-and-example-contract", "anchor": "anchor-and-example-contract", "title": "Anchor and example contract", "level": 2 } ], "links": [ { "id": "documentation-library", "anchor": "", "relation": "references", "sourceAnchor": "rechecking-the-work" }, { "id": "codex-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-implementation-plan", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-module-execution-plan", "anchor": "critical-path", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-workbench-layers", "anchor": "the-layer-map", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "claude-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "codex-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-architecture-analysis", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-graph-theory", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "retirement-candidates" }, { "id": "reaktor-implementation-plan", "anchor": "inventory", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "reaktor-implementation-plan", "anchor": "schedule", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "reaktor-workbench-roadmap", "anchor": "current", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "codex-roadmap", "anchor": "2a-deeper-code-level-analysis", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "codex-roadmap", "anchor": "5-implementation-phases", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "reaktor-graph-migration-plan", "anchor": "decomposition", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "reaktor-graph-migration-plan", "anchor": "migration", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "reaktor-graph-migration-plan", "anchor": "sprints", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "shadow-design-history", "anchor": "", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "performance-observability-history", "anchor": "", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "reaktor-graph-theory", "anchor": "structural-core", "relation": "references", "sourceAnchor": "section-pruning" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "preserve-material" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "preserve-material" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "preserve-material" } ] }, { "id": "documentation-graph-markers", "region": "start-here-core", "order": 6, "owner": "Reaktor documentation", "kind": "guide", "summary": "Author document metadata, navigation regions, named ports and relationships in Markdown; generate every graph and reading view from the same declarations.", "use": "Follow this contract whenever a human or agent updates a document, anchor, graph relationship or worked design.", "title": "Markdown graph markers", "nav": "Graph markers for maintainers", "group": "start-here", "subsection": "start-here-core", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/documentation-graph-markers", "revision": "3c17e5bd0cc10b20bb3fcc253e2587b80724302e96db729b853302b084f6755f", "status": "design", "renderingRevision": "0c68e4d5c3c0222894e6e39514f250f314606d185a1dcbda17f79d62699973fe", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/documentation-graph-markers", "polarity": "Neutral" }, { "id": "catalogue", "anchor": "catalogue", "label": "Catalogue and navigation", "profile": "navigation", "contract": "https://reaktor.build/docs/documentation-graph-markers#catalogue", "polarity": "Neutral" }, { "id": "ports", "anchor": "ports", "label": "Named ports bound to anchors", "profile": "section", "contract": "https://reaktor.build/docs/documentation-graph-markers#ports", "polarity": "Neutral" }, { "id": "relations", "anchor": "relations", "label": "Explicit relationships and hyperedges", "profile": "section", "contract": "https://reaktor.build/docs/documentation-graph-markers#relations", "polarity": "Neutral" }, { "id": "designs", "anchor": "designs", "label": "Worked system designs", "profile": "section", "contract": "https://reaktor.build/docs/documentation-graph-markers#designs", "polarity": "Neutral" }, { "id": "maintenance", "anchor": "maintenance", "label": "Updating a document", "profile": "procedure", "contract": "https://reaktor.build/docs/documentation-graph-markers#maintenance", "polarity": "Neutral" } ], "relations": [ { "id": "documentation-graph-markers:contributor-contract", "kind": "explains", "owner": "documentation-graph-markers", "incidences": [ { "node": "documentation-graph-markers", "port": "maintenance", "role": "source", "ordinal": 0 }, { "node": "contributing", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-graph-markers:structural-model", "kind": "derived-from", "owner": "documentation-graph-markers", "incidences": [ { "node": "documentation-graph-markers", "port": "relations", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-graph-markers:role-model", "kind": "derived-from", "owner": "documentation-graph-markers", "incidences": [ { "node": "documentation-graph-markers", "port": "relations", "role": "source", "ordinal": 0 }, { "node": "reaktor-hyperedge-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-graph-markers:generated-views", "kind": "explains", "owner": "documentation-graph-markers", "incidences": [ { "node": "documentation-graph-markers", "port": "page", "role": "declaration", "ordinal": 0 }, { "node": "documentation-library", "port": "page", "role": "consumer", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "consumer", "ordinal": 1 } ] } ] }, "content": "documentation-graph-markers.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Markdown graph markers", "level": 0 }, { "id": "catalogue", "anchor": "catalogue", "title": "Catalogue and navigation", "level": 2 }, { "id": "ports", "anchor": "ports", "title": "Named ports bound to anchors", "level": 2 }, { "id": "relations", "anchor": "relations", "title": "Explicit relationships and hyperedges", "level": 2 }, { "id": "designs", "anchor": "designs", "title": "Worked system designs", "level": 2 }, { "id": "maintenance", "anchor": "maintenance", "title": "Updating a document", "level": 2 } ], "links": [ { "id": "reaktor-graph-theory", "anchor": "", "relation": "references", "sourceAnchor": "designs" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "designs" } ] }, { "id": "documentation-library", "owner": "Reaktor documentation", "kind": "guide", "summary": "Reading paths for people, retrieval systems and agents; source coverage, audit criteria, website improvements and remaining editorial work.", "use": "Start here to find the current guides, design books and evidence boundaries.", "region": "start-here-core", "order": 0, "title": "Documentation library and improvement programme", "nav": "Using the documentation", "group": "start-here", "subsection": "start-here-core", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/documentation-library", "revision": "430238028b8c1d285788ce7ee257354f3a77525ed0d0cc108b6fa868c456c0df", "status": "design", "renderingRevision": "3538d3cdc1477a899d3bceaa8ed1a3741f25df9602fd53ba8f1cc6ec9bb548d1", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://manna.ac/documentation", "https://diataxis.fr/", "https://c4model.com/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/documentation-library", "polarity": "Neutral" }, { "id": "section-choose-a-reading-path", "anchor": "choose-a-reading-path", "label": "Choose a reading path", "profile": "section", "contract": "https://reaktor.build/docs/documentation-library#choose-a-reading-path", "polarity": "Neutral" }, { "id": "section-evidence-and-source-editions", "anchor": "evidence-and-source-editions", "label": "Evidence and source editions", "profile": "section", "contract": "https://reaktor.build/docs/documentation-library#evidence-and-source-editions", "polarity": "Neutral" }, { "id": "section-audit-criteria-and-improvements", "anchor": "audit-criteria-and-improvements", "label": "Audit criteria and improvements", "profile": "section", "contract": "https://reaktor.build/docs/documentation-library#audit-criteria-and-improvements", "polarity": "Neutral" }, { "id": "section-manna-questions-and-pdf-editions", "anchor": "manna-questions-and-pdf-editions", "label": "Manna questions and PDF editions", "profile": "section", "contract": "https://reaktor.build/docs/documentation-library#manna-questions-and-pdf-editions", "polarity": "Neutral" }, { "id": "section-further-website-improvements", "anchor": "further-website-improvements", "label": "Further website improvements", "profile": "section", "contract": "https://reaktor.build/docs/documentation-library#further-website-improvements", "polarity": "Neutral" }, { "id": "section-machine-reading-contract", "anchor": "machine-reading-contract", "label": "Machine reading contract", "profile": "section", "contract": "https://reaktor.build/docs/documentation-library#machine-reading-contract", "polarity": "Neutral" } ], "relations": [ { "id": "documentation-library:references-reaktor-framework-overview", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-contributing", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-choose-a-reading-path", "role": "source", "ordinal": 0 }, { "node": "contributing", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-architecture-atlas-foundations", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-choose-a-reading-path", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-engine-preprint-engine", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-choose-a-reading-path", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-engine-preprint-evaluation", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-choose-a-reading-path", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-engine-preprint-reference", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-choose-a-reading-path", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-home-map", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-choose-a-reading-path", "role": "source", "ordinal": 0 }, { "node": "home", "port": "section-map", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-engine-preprint-facsimile", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-evidence-and-source-editions", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:references-documentation-audit", "kind": "references", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "section-audit-criteria-and-improvements", "role": "source", "ordinal": 0 }, { "node": "documentation-audit", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:explains-reaktor-framework-overview", "kind": "explains", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "documentation-library:requires-contributing", "kind": "requires", "owner": "documentation-library", "incidences": [ { "node": "documentation-library", "port": "page", "role": "source", "ordinal": 0 }, { "node": "contributing", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "documentation-library.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Documentation library and improvement programme", "level": 0 }, { "id": "choose-a-reading-path", "anchor": "choose-a-reading-path", "title": "Choose a reading path", "level": 2 }, { "id": "evidence-and-source-editions", "anchor": "evidence-and-source-editions", "title": "Evidence and source editions", "level": 2 }, { "id": "audit-criteria-and-improvements", "anchor": "audit-criteria-and-improvements", "title": "Audit criteria and improvements", "level": 2 }, { "id": "manna-questions-and-pdf-editions", "anchor": "manna-questions-and-pdf-editions", "title": "Manna questions and PDF editions", "level": 2 }, { "id": "further-website-improvements", "anchor": "further-website-improvements", "title": "Further website improvements", "level": 2 }, { "id": "machine-reading-contract", "anchor": "machine-reading-contract", "title": "Machine reading contract", "level": 2 } ], "links": [ { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "contributing", "anchor": "", "relation": "references", "sourceAnchor": "choose-a-reading-path" }, { "id": "architecture-atlas-foundations", "anchor": "", "relation": "references", "sourceAnchor": "choose-a-reading-path" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "choose-a-reading-path" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "choose-a-reading-path" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "choose-a-reading-path" }, { "id": "home", "anchor": "map", "relation": "references", "sourceAnchor": "choose-a-reading-path" }, { "id": "engine-preprint-facsimile", "anchor": "", "relation": "references", "sourceAnchor": "evidence-and-source-editions" }, { "id": "documentation-audit", "anchor": "", "relation": "references", "sourceAnchor": "audit-criteria-and-improvements" }, { "id": "documentation-graph-markers", "anchor": "", "relation": "references", "sourceAnchor": "machine-reading-contract" } ] }, { "id": "engine-preprint-assurance", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: assurance and adoption studies. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 6, "title": "Assurance and adoption studies", "nav": "Assurance and adoption studies", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-assurance", "revision": "e1d326ba288a5821eeb04ca00c3a8e0ee9519f384fe942398e19c57d50f702d7", "status": "design", "renderingRevision": "40e8a9a25497abdd70188f22a5bc040c93717c1a7e1c5ac081b38e95ce856506", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "30", "31", "32", "33" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-assurance", "polarity": "Neutral" }, { "id": "section-section-30", "anchor": "section-30", "label": "30. Assurance and formal guarantees", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#section-30", "polarity": "Neutral" }, { "id": "section-section-31", "anchor": "section-31", "label": "31. Constructing an assurance argument", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#section-31", "polarity": "Neutral" }, { "id": "section-section-32", "anchor": "section-32", "label": "32. Heterogeneous and cyber-physical systems", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#section-32", "polarity": "Neutral" }, { "id": "section-section-33", "anchor": "section-33", "label": "33. Application and adoption studies", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#section-33", "polarity": "Neutral" }, { "id": "section-source-figure-pages", "anchor": "source-figure-pages", "label": "Source figure pages", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#source-figure-pages", "polarity": "Neutral" }, { "id": "section-306-versioned-evidence-and-invalidation", "anchor": "306-versioned-evidence-and-invalidation", "label": "30.6 Versioned evidence and invalidation", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#306-versioned-evidence-and-invalidation", "polarity": "Neutral" }, { "id": "section-319-assurance-economics-and-remaining-judgment", "anchor": "319-assurance-economics-and-remaining-judgment", "label": "31.9 Assurance economics and remaining judgment", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#319-assurance-economics-and-remaining-judgment", "polarity": "Neutral" }, { "id": "section-328-an-interactive-validation-laboratory", "anchor": "328-an-interactive-validation-laboratory", "label": "32.8 An interactive validation laboratory", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#328-an-interactive-validation-laboratory", "polarity": "Neutral" }, { "id": "section-3310-where-adoption-should-be-rejected-or-reduced", "anchor": "3310-where-adoption-should-be-rejected-or-reduced", "label": "33.10 Where adoption should be rejected or reduced", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-assurance#3310-where-adoption-should-be-rejected-or-reduced", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-assurance:references-reaktor-formal-methods", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-shadow-verification", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-architecture-atlas-qualification", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-facsimile-page-75", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "section-306-versioned-evidence-and-invalidation", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-75", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-facsimile-page-77", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "section-319-assurance-economics-and-remaining-judgment", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-77", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-facsimile-page-80", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "section-328-an-interactive-validation-laboratory", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-80", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:references-engine-preprint-facsimile-page-83", "kind": "references", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "section-3310-where-adoption-should-be-rejected-or-reduced", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-83", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:explains-reaktor-formal-methods", "kind": "explains", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:explains-shadow-verification", "kind": "explains", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-assurance:explains-architecture-atlas-qualification", "kind": "explains", "owner": "engine-preprint-assurance", "incidences": [ { "node": "engine-preprint-assurance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-assurance.json", "sections": [ { "id": "assurance-and-adoption-studies", "anchor": "assurance-and-adoption-studies", "title": "Assurance and adoption studies", "level": 1 }, { "id": "section-30", "anchor": "section-30", "title": "30. Assurance and formal guarantees", "level": 2 }, { "id": "301-claims-assumptions-and-trusted-boundaries", "anchor": "301-claims-assumptions-and-trusted-boundaries", "title": "30.1 Claims, assumptions, and trusted boundaries", "level": 3 }, { "id": "302-structural-and-relational-checks", "anchor": "302-structural-and-relational-checks", "title": "30.2 Structural and relational checks", "level": 3 }, { "id": "303-constraint-and-temporal-verification", "anchor": "303-constraint-and-temporal-verification", "title": "30.3 Constraint and temporal verification", "level": 3 }, { "id": "304-refinement-and-composition", "anchor": "304-refinement-and-composition", "title": "30.4 Refinement and composition", "level": 3 }, { "id": "305-simulation-and-implementation-proofs", "anchor": "305-simulation-and-implementation-proofs", "title": "30.5 Simulation and implementation proofs", "level": 3 }, { "id": "306-versioned-evidence-and-invalidation", "anchor": "306-versioned-evidence-and-invalidation", "title": "30.6 Versioned evidence and invalidation", "level": 3 }, { "id": "section-31", "anchor": "section-31", "title": "31. Constructing an assurance argument", "level": 2 }, { "id": "311-from-requirements-to-predicates", "anchor": "311-from-requirements-to-predicates", "title": "31.1 From requirements to predicates", "level": 3 }, { "id": "312-hoare-style-local-reasoning", "anchor": "312-hoare-style-local-reasoning", "title": "31.2 Hoare-style local reasoning", "level": 3 }, { "id": "313-relational-exploration-with-alloy", "anchor": "313-relational-exploration-with-alloy", "title": "31.3 Relational exploration with Alloy", "level": 3 }, { "id": "314-state-exploration-with-temporal-models", "anchor": "314-state-exploration-with-temporal-models", "title": "31.4 State exploration with temporal models", "level": 3 }, { "id": "315-a-reproduced-finite-generation-model", "anchor": "315-a-reproduced-finite-generation-model", "title": "31.5 A reproduced finite generation model", "level": 3 }, { "id": "316-abstraction-and-implementation-conformance", "anchor": "316-abstraction-and-implementation-conformance", "title": "31.6 Abstraction and implementation conformance", "level": 3 }, { "id": "317-checking-the-transformation-rather-than-trusting-the-optimizer", "anchor": "317-checking-the-transformation-rather-than-trusting-the-optimizer", "title": "31.7 Checking the transformation rather than trusting the optimizer", "level": 3 }, { "id": "318-proof-dependencies-and-invalidation", "anchor": "318-proof-dependencies-and-invalidation", "title": "31.8 Proof dependencies and invalidation", "level": 3 }, { "id": "319-assurance-economics-and-remaining-judgment", "anchor": "319-assurance-economics-and-remaining-judgment", "title": "31.9 Assurance economics and remaining judgment", "level": 3 }, { "id": "section-32", "anchor": "section-32", "title": "32. Heterogeneous and cyber-physical systems", "level": 2 }, { "id": "321-typed-physical-quantities-and-coordinate-frames", "anchor": "321-typed-physical-quantities-and-coordinate-frames", "title": "32.1 Typed physical quantities and coordinate frames", "level": 3 }, { "id": "322-ros-2-as-an-integration-boundary", "anchor": "322-ros-2-as-an-integration-boundary", "title": "32.2 ROS 2 as an integration boundary", "level": 3 }, { "id": "323-discrete-and-continuous-behavior", "anchor": "323-discrete-and-continuous-behavior", "title": "32.3 Discrete and continuous behavior", "level": 3 }, { "id": "324-control-barriers-and-qualified-safety-boundaries", "anchor": "324-control-barriers-and-qualified-safety-boundaries", "title": "32.4 Control barriers and qualified safety boundaries", "level": 3 }, { "id": "325-feedback-observability-and-supervisory-control", "anchor": "325-feedback-observability-and-supervisory-control", "title": "32.5 Feedback, observability, and supervisory control", "level": 3 }, { "id": "326-updates-in-physical-systems", "anchor": "326-updates-in-physical-systems", "title": "32.6 Updates in physical systems", "level": 3 }, { "id": "327-energy-and-resource-constraints", "anchor": "327-energy-and-resource-constraints", "title": "32.7 Energy and resource constraints", "level": 3 }, { "id": "328-an-interactive-validation-laboratory", "anchor": "328-an-interactive-validation-laboratory", "title": "32.8 An interactive validation laboratory", "level": 3 }, { "id": "section-33", "anchor": "section-33", "title": "33. Application and adoption studies", "level": 2 }, { "id": "331-a-solo-developer-an-offline-field-notes-application", "anchor": "331-a-solo-developer-an-offline-field-notes-application", "title": "33.1 A solo developer: an offline field-notes application", "level": 3 }, { "id": "332-an-early-stage-startup-messaging-engagement-and-analytics", "anchor": "332-an-early-stage-startup-messaging-engagement-and-analytics", "title": "33.2 An early-stage startup: messaging, engagement, and analytics", "level": 3 }, { "id": "333-a-software-agency-or-b2b-vendor-families-of-related-applications", "anchor": "333-a-software-agency-or-b2b-vendor-families-of-related-applications", "title": "33.3 A software agency or B2B vendor: families of related applications", "level": 3 }, { "id": "334-a-growing-commerce-platform-checkout-under-partial-failure", "anchor": "334-a-growing-commerce-platform-checkout-under-partial-failure", "title": "33.4 A growing commerce platform: checkout under partial failure", "level": 3 }, { "id": "335-a-large-corporation-federating-a-brownfield-estate", "anchor": "335-a-large-corporation-federating-a-brownfield-estate", "title": "33.5 A large corporation: federating a brownfield estate", "level": 3 }, { "id": "336-a-platform-team-operating-shared-cloud-and-data-services", "anchor": "336-a-platform-team-operating-shared-cloud-and-data-services", "title": "33.6 A platform team: operating shared cloud and data services", "level": 3 }, { "id": "337-a-robotics-organization-a-mixed-runtime-fleet", "anchor": "337-a-robotics-organization-a-mixed-runtime-fleet", "title": "33.7 A robotics organization: a mixed-runtime fleet", "level": 3 }, { "id": "338-a-research-or-machine-learning-team-reproducible-pipelines", "anchor": "338-a-research-or-machine-learning-team-reproducible-pipelines", "title": "33.8 A research or machine-learning team: reproducible pipelines", "level": 3 }, { "id": "339-companyos-browser-operations-and-human-handoff", "anchor": "339-companyos-browser-operations-and-human-handoff", "title": "33.9 CompanyOS: browser operations and human handoff", "level": 3 }, { "id": "3310-where-adoption-should-be-rejected-or-reduced", "anchor": "3310-where-adoption-should-be-rejected-or-reduced", "title": "33.10 Where adoption should be rejected or reduced", "level": 3 }, { "id": "source-figure-pages", "anchor": "source-figure-pages", "title": "Source figure pages", "level": 2 }, { "id": "original-figure-page-81", "anchor": "original-figure-page-81", "title": "Original figure page 81", "level": 3 } ], "links": [ { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-75", "relation": "references", "sourceAnchor": "306-versioned-evidence-and-invalidation" }, { "id": "engine-preprint-facsimile", "anchor": "page-77", "relation": "references", "sourceAnchor": "319-assurance-economics-and-remaining-judgment" }, { "id": "engine-preprint-facsimile", "anchor": "page-80", "relation": "references", "sourceAnchor": "328-an-interactive-validation-laboratory" }, { "id": "engine-preprint-facsimile", "anchor": "page-83", "relation": "references", "sourceAnchor": "3310-where-adoption-should-be-rejected-or-reduced" } ] }, { "id": "engine-preprint-data", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: data authority, contracts and federation. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 3, "title": "Data authority, contracts and federation", "nav": "Data authority, contracts and federation", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-data", "revision": "96b8499e14c41fce48e21956db1305d1c8aabc4b8c1cee367e5f9775dc9e8445", "status": "design", "renderingRevision": "5e9fe75fd101556aa963022322e46699be051ffbefa863ad92a4b718fcf030b7", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "18", "19" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-data", "polarity": "Neutral" }, { "id": "section-section-18", "anchor": "section-18", "label": "18. The system knowledge graph and data layer", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-data#section-18", "polarity": "Neutral" }, { "id": "section-section-19", "anchor": "section-19", "label": "19. Federation, data contracts, and operational integration", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-data#section-19", "polarity": "Neutral" }, { "id": "section-187-security-boundaries-and-privacy", "anchor": "187-security-boundaries-and-privacy", "label": "18.7 Security boundaries and privacy", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-data#187-security-boundaries-and-privacy", "polarity": "Neutral" }, { "id": "section-196-federated-consistency-and-bounded-materialization", "anchor": "196-federated-consistency-and-bounded-materialization", "label": "19.6 Federated consistency and bounded materialization", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-data#196-federated-consistency-and-bounded-materialization", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-data:references-reaktor-db", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-reaktor-data-graph", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-reaktor-data-implementation", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-facsimile-page-45", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "section-187-security-boundaries-and-privacy", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-45", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:references-engine-preprint-facsimile-page-48", "kind": "references", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "section-196-federated-consistency-and-bounded-materialization", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-48", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:explains-reaktor-db", "kind": "explains", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:explains-reaktor-data-graph", "kind": "explains", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-data:explains-reaktor-data-implementation", "kind": "explains", "owner": "engine-preprint-data", "incidences": [ { "node": "engine-preprint-data", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-data.json", "sections": [ { "id": "data-authority-contracts-and-federation", "anchor": "data-authority-contracts-and-federation", "title": "Data authority, contracts and federation", "level": 1 }, { "id": "section-18", "anchor": "section-18", "title": "18. The system knowledge graph and data layer", "level": 2 }, { "id": "181-connections-relations-and-facets", "anchor": "181-connections-relations-and-facets", "title": "18.1 Connections, relations, and facets", "level": 3 }, { "id": "182-assertions-provenance-and-completeness", "anchor": "182-assertions-provenance-and-completeness", "title": "18.2 Assertions, provenance, and completeness", "level": 3 }, { "id": "183-three-connected-data-representations", "anchor": "183-three-connected-data-representations", "title": "18.3 Three connected data representations", "level": 3 }, { "id": "184-a-concrete-data-realization", "anchor": "184-a-concrete-data-realization", "title": "18.4 A concrete data realization", "level": 3 }, { "id": "185-synchronization-and-consistency-evidence", "anchor": "185-synchronization-and-consistency-evidence", "title": "18.5 Synchronization and consistency evidence", "level": 3 }, { "id": "186-cloud-resources-tools-and-external-systems", "anchor": "186-cloud-resources-tools-and-external-systems", "title": "18.6 Cloud resources, tools, and external systems", "level": 3 }, { "id": "187-security-boundaries-and-privacy", "anchor": "187-security-boundaries-and-privacy", "title": "18.7 Security boundaries and privacy", "level": 3 }, { "id": "section-19", "anchor": "section-19", "title": "19. Federation, data contracts, and operational integration", "level": 2 }, { "id": "191-facts-have-authority-and-provenance", "anchor": "191-facts-have-authority-and-provenance", "title": "19.1 Facts have authority and provenance", "level": 3 }, { "id": "192-data-descriptors-connect-topology-to-semantics", "anchor": "192-data-descriptors-connect-topology-to-semantics", "title": "19.2 Data descriptors connect topology to semantics", "level": 3 }, { "id": "193-lineage-describes-both-definitions-and-runs", "anchor": "193-lineage-describes-both-definitions-and-runs", "title": "19.3 Lineage describes both definitions and runs", "level": 3 }, { "id": "194-builds-and-releases-as-derived-relationships", "anchor": "194-builds-and-releases-as-derived-relationships", "title": "19.4 Builds and releases as derived relationships", "level": 3 }, { "id": "195-operational-actions-are-typed-scoped-and-evidenced", "anchor": "195-operational-actions-are-typed-scoped-and-evidenced", "title": "19.5 Operational actions are typed, scoped, and evidenced", "level": 3 }, { "id": "196-federated-consistency-and-bounded-materialization", "anchor": "196-federated-consistency-and-bounded-materialization", "title": "19.6 Federated consistency and bounded materialization", "level": 3 } ], "links": [ { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-45", "relation": "references", "sourceAnchor": "187-security-boundaries-and-privacy" }, { "id": "engine-preprint-facsimile", "anchor": "page-48", "relation": "references", "sourceAnchor": "196-federated-consistency-and-bounded-materialization" } ] }, { "id": "engine-preprint-delivery", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: build, compilation and resource budgets. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 4, "title": "Build, compilation and resource budgets", "nav": "Build, compilation and resource budgets", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-delivery", "revision": "7ab236f9dd5a20b3a346b13f8ff1a28e894391b38a493b1b90b42d3fcfbd304a", "status": "design", "renderingRevision": "6f6f119c55e8e7f497d32315867e63a8078bf249a8124c3d667279fc20aa3dd5", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "23", "24", "25" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-delivery", "polarity": "Neutral" }, { "id": "section-section-23", "anchor": "section-23", "label": "23. Build, cloud, observation, and reproducible development", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-delivery#section-23", "polarity": "Neutral" }, { "id": "section-section-24", "anchor": "section-24", "label": "24. Compilation and data-oriented implementation", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-delivery#section-24", "polarity": "Neutral" }, { "id": "section-section-25", "anchor": "section-25", "label": "25. Hardware, resource budgets, and performance semantics", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-delivery#section-25", "polarity": "Neutral" }, { "id": "section-236-operate-existing-systems-without-claiming-complete-ownership", "anchor": "236-operate-existing-systems-without-claiming-complete-ownership", "label": "23.6 Operate existing systems without claiming complete ownership", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-delivery#236-operate-existing-systems-without-claiming-complete-ownership", "polarity": "Neutral" }, { "id": "section-247-measured-realization-rather-than-representation-fashion", "anchor": "247-measured-realization-rather-than-representation-fashion", "label": "24.7 Measured realization rather than representation fashion", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-delivery#247-measured-realization-rather-than-representation-fashion", "polarity": "Neutral" }, { "id": "section-258-physical-delay-and-placement", "anchor": "258-physical-delay-and-placement", "label": "25.8 Physical delay and placement", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-delivery#258-physical-delay-and-placement", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-delivery:references-reaktor-build-tools", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-reaktor-cloud-pane", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-performance-observability", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-facsimile-page-57", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "section-236-operate-existing-systems-without-claiming-complete-ownership", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-57", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-facsimile-page-59", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "section-247-measured-realization-rather-than-representation-fashion", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-59", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:references-engine-preprint-facsimile-page-61", "kind": "references", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "section-258-physical-delay-and-placement", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-61", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:explains-reaktor-build-tools", "kind": "explains", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:explains-reaktor-cloud-pane", "kind": "explains", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-delivery:explains-performance-observability", "kind": "explains", "owner": "engine-preprint-delivery", "incidences": [ { "node": "engine-preprint-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-delivery.json", "sections": [ { "id": "build-compilation-and-resource-budgets", "anchor": "build-compilation-and-resource-budgets", "title": "Build, compilation and resource budgets", "level": 1 }, { "id": "section-23", "anchor": "section-23", "title": "23. Build, cloud, observation, and reproducible development", "level": 2 }, { "id": "231-dependeasy-publishes-build-facts-tools-execute-them", "anchor": "231-dependeasy-publishes-build-facts-tools-execute-them", "title": "23.1 Dependeasy publishes build facts; tools execute them", "level": 3 }, { "id": "232-a-release-is-a-dependency-aware-operation-plan", "anchor": "232-a-release-is-a-dependency-aware-operation-plan", "title": "23.2 A release is a dependency-aware operation plan", "level": 3 }, { "id": "233-gcp-cells-and-attached-customer-environments", "anchor": "233-gcp-cells-and-attached-customer-environments", "title": "23.3 GCP cells and attached customer environments", "level": 3 }, { "id": "234-signals-belong-to-contracts-not-only-dashboards", "anchor": "234-signals-belong-to-contracts-not-only-dashboards", "title": "23.4 Signals belong to contracts, not only dashboards", "level": 3 }, { "id": "235-development-profiles-before-production-mirroring", "anchor": "235-development-profiles-before-production-mirroring", "title": "23.5 Development profiles before production mirroring", "level": 3 }, { "id": "236-operate-existing-systems-without-claiming-complete-ownership", "anchor": "236-operate-existing-systems-without-claiming-complete-ownership", "title": "23.6 Operate existing systems without claiming complete ownership", "level": 3 }, { "id": "section-24", "anchor": "section-24", "title": "24. Compilation and data-oriented implementation", "level": 2 }, { "id": "241-representations-for-different-workloads", "anchor": "241-representations-for-different-workloads", "title": "24.1 Representations for different workloads", "level": 3 }, { "id": "242-record-layout-and-indexing", "anchor": "242-record-layout-and-indexing", "title": "24.2 Record layout and indexing", "level": 3 }, { "id": "243-snapshots-and-mutation-cost", "anchor": "243-snapshots-and-mutation-cost", "title": "24.3 Snapshots and mutation cost", "level": 3 }, { "id": "244-compiled-dispatch", "anchor": "244-compiled-dispatch", "title": "24.4 Compiled dispatch", "level": 3 }, { "id": "245-lifetime-concurrency-and-payload-ownership", "anchor": "245-lifetime-concurrency-and-payload-ownership", "title": "24.5 Lifetime, concurrency, and payload ownership", "level": 3 }, { "id": "246-performance-claims-and-measurements", "anchor": "246-performance-claims-and-measurements", "title": "24.6 Performance claims and measurements", "level": 3 }, { "id": "247-measured-realization-rather-than-representation-fashion", "anchor": "247-measured-realization-rather-than-representation-fashion", "title": "24.7 Measured realization rather than representation fashion", "level": 3 }, { "id": "section-25", "anchor": "section-25", "title": "25. Hardware, resource budgets, and performance semantics", "level": 2 }, { "id": "251-the-cost-of-following-a-relationship", "anchor": "251-the-cost-of-following-a-relationship", "title": "25.1 The cost of following a relationship", "level": 3 }, { "id": "252-bandwidth-and-operational-intensity", "anchor": "252-bandwidth-and-operational-intensity", "title": "25.2 Bandwidth and operational intensity", "level": 3 }, { "id": "253-parallelism-has-a-serial-boundary", "anchor": "253-parallelism-has-a-serial-boundary", "title": "25.3 Parallelism has a serial boundary", "level": 3 }, { "id": "254-batching-exchanges-overhead-for-latency", "anchor": "254-batching-exchanges-overhead-for-latency", "title": "25.4 Batching exchanges overhead for latency", "level": 3 }, { "id": "255-queueing-identities-are-not-latency-guarantees", "anchor": "255-queueing-identities-are-not-latency-guarantees", "title": "25.5 Queueing identities are not latency guarantees", "level": 3 }, { "id": "256-memory-ownership-and-reclamation", "anchor": "256-memory-ownership-and-reclamation", "title": "25.6 Memory ownership and reclamation", "level": 3 }, { "id": "257-a-concrete-snapshot-layout-budget", "anchor": "257-a-concrete-snapshot-layout-budget", "title": "25.7 A concrete snapshot layout budget", "level": 3 }, { "id": "258-physical-delay-and-placement", "anchor": "258-physical-delay-and-placement", "title": "25.8 Physical delay and placement", "level": 3 } ], "links": [ { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-57", "relation": "references", "sourceAnchor": "236-operate-existing-systems-without-claiming-complete-ownership" }, { "id": "engine-preprint-facsimile", "anchor": "page-59", "relation": "references", "sourceAnchor": "247-measured-realization-rather-than-representation-fashion" }, { "id": "engine-preprint-facsimile", "anchor": "page-61", "relation": "references", "sourceAnchor": "258-physical-delay-and-placement" } ] }, { "id": "engine-preprint-engine", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: the engine and feature composition. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 0, "title": "The engine and feature composition", "nav": "The engine and feature composition", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-engine", "revision": "97bf060c2bcdee6e371e0960f67099ab35477ae3fb31b508ddc609a13379ea19", "status": "design", "renderingRevision": "057f0f84d3b6baa9a6d537a9da565fc64da62a446ab6851b3f41e1b264356e27", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "preface", "1", "2", "3", "4", "5", "6", "7" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-engine", "polarity": "Neutral" }, { "id": "section-source-title-and-abstract", "anchor": "source-title-and-abstract", "label": "Source title and abstract", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#source-title-and-abstract", "polarity": "Neutral" }, { "id": "section-section-preface", "anchor": "section-preface", "label": "Before the introduction: building applications inside an engine", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#section-preface", "polarity": "Neutral" }, { "id": "section-section-1", "anchor": "section-1", "label": "1. Motivation, contributions, and scope", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#section-1", "polarity": "Neutral" }, { "id": "section-section-2", "anchor": "section-2", "label": "2. The engine model: mechanisms, Blueprints, and product composition", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#section-2", "polarity": "Neutral" }, { "id": "section-section-3", "anchor": "section-3", "label": "3. A feature from composition to production change", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#section-3", "polarity": "Neutral" }, { "id": "section-section-4", "anchor": "section-4", "label": "4. The concrete Reaktor reference stack", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#section-4", "polarity": "Neutral" }, { "id": "section-the-graph-is-the-engines-shared-representation", "anchor": "the-graph-is-the-engines-shared-representation", "label": "The graph is the engine’s shared representation", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#the-graph-is-the-engines-shared-representation", "polarity": "Neutral" }, { "id": "section-13-reading-routes", "anchor": "13-reading-routes", "label": "1.3 Reading routes", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#13-reading-routes", "polarity": "Neutral" }, { "id": "section-24-the-human-authoring-contract", "anchor": "24-the-human-authoring-contract", "label": "2.4 The human authoring contract", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#24-the-human-authoring-contract", "polarity": "Neutral" }, { "id": "section-38-the-responsibility-that-remains", "anchor": "38-the-responsibility-that-remains", "label": "3.8 The responsibility that remains", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#38-the-responsibility-that-remains", "polarity": "Neutral" }, { "id": "section-45-one-authority-for-each-authored-fact", "anchor": "45-one-authority-for-each-authored-fact", "label": "4.5 One authority for each authored fact", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#45-one-authority-for-each-authored-fact", "polarity": "Neutral" }, { "id": "section-55-versioning-the-authoring-vocabulary", "anchor": "55-versioning-the-authoring-vocabulary", "label": "5.5 Versioning the authoring vocabulary", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#55-versioning-the-authoring-vocabulary", "polarity": "Neutral" }, { "id": "section-65-self-hosting-as-a-useful-but-limited-case", "anchor": "65-self-hosting-as-a-useful-but-limited-case", "label": "6.5 Self-hosting as a useful but limited case", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#65-self-hosting-as-a-useful-but-limited-case", "polarity": "Neutral" }, { "id": "section-73-control-and-execution", "anchor": "73-control-and-execution", "label": "7.3 Control and execution", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-engine#73-control-and-execution", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-engine:references-reaktor-framework-overview", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-reaktor-service", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-reaktor-workbench-links", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-2", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-the-graph-is-the-engines-shared-representation", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-2", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-5", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-13-reading-routes", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-5", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-6", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-24-the-human-authoring-contract", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-6", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-8", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-38-the-responsibility-that-remains", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-8", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-12", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-45-one-authority-for-each-authored-fact", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-12", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-14", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-55-versioning-the-authoring-vocabulary", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-14", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-17", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-65-self-hosting-as-a-useful-but-limited-case", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-17", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:references-engine-preprint-facsimile-page-18", "kind": "references", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "section-73-control-and-execution", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-18", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:explains-reaktor-framework-overview", "kind": "explains", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:explains-reaktor-service", "kind": "explains", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-engine:explains-reaktor-workbench-links", "kind": "explains", "owner": "engine-preprint-engine", "incidences": [ { "node": "engine-preprint-engine", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-engine.json", "sections": [ { "id": "the-engine-and-feature-composition", "anchor": "the-engine-and-feature-composition", "title": "The engine and feature composition", "level": 1 }, { "id": "source-title-and-abstract", "anchor": "source-title-and-abstract", "title": "Source title and abstract", "level": 2 }, { "id": "abstract", "anchor": "abstract", "title": "Abstract", "level": 3 }, { "id": "section-preface", "anchor": "section-preface", "title": "Before the introduction: building applications inside an engine", "level": 2 }, { "id": "one-feature-rather-than-seven-disconnected-integrations", "anchor": "one-feature-rather-than-seven-disconnected-integrations", "title": "One feature, rather than seven disconnected integrations", "level": 3 }, { "id": "the-graph-is-the-engines-shared-representation", "anchor": "the-graph-is-the-engines-shared-representation", "title": "The graph is the engine’s shared representation", "level": 3 }, { "id": "section-1", "anchor": "section-1", "title": "1. Motivation, contributions, and scope", "level": 2 }, { "id": "11-contributions", "anchor": "11-contributions", "title": "1.1 Contributions", "level": 3 }, { "id": "12-requirements-and-exclusions", "anchor": "12-requirements-and-exclusions", "title": "1.2 Requirements and exclusions", "level": 3 }, { "id": "13-reading-routes", "anchor": "13-reading-routes", "title": "1.3 Reading routes", "level": 3 }, { "id": "section-2", "anchor": "section-2", "title": "2. The engine model: mechanisms, Blueprints, and product composition", "level": 2 }, { "id": "21-what-the-unreal-precedent-actually-establishes", "anchor": "21-what-the-unreal-precedent-actually-establishes", "title": "2.1 What the Unreal precedent actually establishes", "level": 3 }, { "id": "22-why-a-component-library-is-not-yet-an-engine", "anchor": "22-why-a-component-library-is-not-yet-an-engine", "title": "2.2 Why a component library is not yet an engine", "level": 3 }, { "id": "23-full-stack-modules-are-distributed-packages-not-giant-objects", "anchor": "23-full-stack-modules-are-distributed-packages-not-giant-objects", "title": "2.3 Full-stack modules are distributed packages, not giant objects", "level": 3 }, { "id": "24-the-human-authoring-contract", "anchor": "24-the-human-authoring-contract", "title": "2.4 The human authoring contract", "level": 3 }, { "id": "section-3", "anchor": "section-3", "title": "3. A feature from composition to production change", "level": 2 }, { "id": "31-the-product-contract", "anchor": "31-the-product-contract", "title": "3.1 The product contract", "level": 3 }, { "id": "32-choose-the-reusable-mechanisms", "anchor": "32-choose-the-reusable-mechanisms", "title": "3.2 Choose the reusable mechanisms", "level": 3 }, { "id": "33-write-the-boundary-and-compose-the-behavior", "anchor": "33-write-the-boundary-and-compose-the-behavior", "title": "3.3 Write the boundary and compose the behavior", "level": 3 }, { "id": "34-bind-the-same-logical-feature-to-concrete-profiles", "anchor": "34-bind-the-same-logical-feature-to-concrete-profiles", "title": "3.4 Bind the same logical feature to concrete profiles", "level": 3 }, { "id": "35-what-one-declaration-can-produce", "anchor": "35-what-one-declaration-can-produce", "title": "3.5 What one declaration can produce", "level": 3 }, { "id": "36-run-and-inspect-the-actual-interaction", "anchor": "36-run-and-inspect-the-actual-interaction", "title": "3.6 Run and inspect the actual interaction", "level": 3 }, { "id": "37-make-a-product-change-without-rebuilding-the-mechanism", "anchor": "37-make-a-product-change-without-rebuilding-the-mechanism", "title": "3.7 Make a product change without rebuilding the mechanism", "level": 3 }, { "id": "38-the-responsibility-that-remains", "anchor": "38-the-responsibility-that-remains", "title": "3.8 The responsibility that remains", "level": 3 }, { "id": "section-4", "anchor": "section-4", "title": "4. The concrete Reaktor reference stack", "level": 2 }, { "id": "41-source-sets-runtimes-and-products-are-different-axes", "anchor": "41-source-sets-runtimes-and-products-are-different-axes", "title": "4.1 Source sets, runtimes, and products are different axes", "level": 3 }, { "id": "42-the-smallest-useful-profile", "anchor": "42-the-smallest-useful-profile", "title": "4.2 The smallest useful profile", "level": 3 }, { "id": "43-one-shared-operation-on-real-service-hosts", "anchor": "43-one-shared-operation-on-real-service-hosts", "title": "4.3 One shared operation on real service hosts", "level": 3 }, { "id": "44-the-difference-between-existing-slices-and-the-complete-engine", "anchor": "44-the-difference-between-existing-slices-and-the-complete-engine", "title": "4.4 The difference between existing slices and the complete engine", "level": 3 }, { "id": "45-one-authority-for-each-authored-fact", "anchor": "45-one-authority-for-each-authored-fact", "title": "4.5 One authority for each authored fact", "level": 3 }, { "id": "section-5", "anchor": "section-5", "title": "5. Blueprint authoring and reusable feature packages", "level": 2 }, { "id": "51-visual-grammar", "anchor": "51-visual-grammar", "title": "5.1 Visual grammar", "level": 3 }, { "id": "52-one-supported-program-two-authoring-surfaces", "anchor": "52-one-supported-program-two-authoring-surfaces", "title": "5.2 One supported program, two authoring surfaces", "level": 3 }, { "id": "53-reusable-definitions-instances-and-parameterization", "anchor": "53-reusable-definitions-instances-and-parameterization", "title": "5.3 Reusable definitions, instances, and parameterization", "level": 3 }, { "id": "54-what-the-author-still-programs", "anchor": "54-what-the-author-still-programs", "title": "5.4 What the author still programs", "level": 3 }, { "id": "55-versioning-the-authoring-vocabulary", "anchor": "55-versioning-the-authoring-vocabulary", "title": "5.5 Versioning the authoring vocabulary", "level": 3 }, { "id": "section-6", "anchor": "section-6", "title": "6. The workbench: edit, run, inspect, and explain", "level": 2 }, { "id": "61-navigate-by-scope-not-by-rendering-the-entire-universe", "anchor": "61-navigate-by-scope-not-by-rendering-the-entire-universe", "title": "6.1 Navigate by scope, not by rendering the entire universe", "level": 3 }, { "id": "62-a-shared-authoring-session", "anchor": "62-a-shared-authoring-session", "title": "6.2 A shared authoring session", "level": 3 }, { "id": "63-four-different-meanings-of-debugging", "anchor": "63-four-different-meanings-of-debugging", "title": "6.3 Four different meanings of debugging", "level": 3 }, { "id": "64-findings-are-explanations-attached-to-work", "anchor": "64-findings-are-explanations-attached-to-work", "title": "6.4 Findings are explanations attached to work", "level": 3 }, { "id": "65-self-hosting-as-a-useful-but-limited-case", "anchor": "65-self-hosting-as-a-useful-but-limited-case", "title": "6.5 Self-hosting as a useful but limited case", "level": 3 }, { "id": "section-7", "anchor": "section-7", "title": "7. A shared model across authoring, execution, and observation", "level": 2 }, { "id": "71-planes-and-identities", "anchor": "71-planes-and-identities", "title": "7.1 Planes and identities", "level": 3 }, { "id": "72-authority-and-revisions", "anchor": "72-authority-and-revisions", "title": "7.2 Authority and revisions", "level": 3 }, { "id": "73-control-and-execution", "anchor": "73-control-and-execution", "title": "7.3 Control and execution", "level": 3 }, { "id": "source-figure-pages", "anchor": "source-figure-pages", "title": "Source figure pages", "level": 2 }, { "id": "original-figure-page-7", "anchor": "original-figure-page-7", "title": "Original figure page 7", "level": 3 }, { "id": "original-figure-page-9", "anchor": "original-figure-page-9", "title": "Original figure page 9", "level": 3 }, { "id": "original-figure-page-16", "anchor": "original-figure-page-16", "title": "Original figure page 16", "level": 3 }, { "id": "original-figure-page-19", "anchor": "original-figure-page-19", "title": "Original figure page 19", "level": 3 } ], "links": [ { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-2", "relation": "references", "sourceAnchor": "the-graph-is-the-engines-shared-representation" }, { "id": "engine-preprint-facsimile", "anchor": "page-5", "relation": "references", "sourceAnchor": "13-reading-routes" }, { "id": "engine-preprint-facsimile", "anchor": "page-6", "relation": "references", "sourceAnchor": "24-the-human-authoring-contract" }, { "id": "engine-preprint-facsimile", "anchor": "page-8", "relation": "references", "sourceAnchor": "38-the-responsibility-that-remains" }, { "id": "engine-preprint-facsimile", "anchor": "page-12", "relation": "references", "sourceAnchor": "45-one-authority-for-each-authored-fact" }, { "id": "engine-preprint-facsimile", "anchor": "page-14", "relation": "references", "sourceAnchor": "55-versioning-the-authoring-vocabulary" }, { "id": "engine-preprint-facsimile", "anchor": "page-17", "relation": "references", "sourceAnchor": "65-self-hosting-as-a-useful-but-limited-case" }, { "id": "engine-preprint-facsimile", "anchor": "page-18", "relation": "references", "sourceAnchor": "73-control-and-execution" } ] }, { "id": "engine-preprint-evaluation", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: precedents, evaluation and implementation sequence. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 7, "title": "Precedents, evaluation and implementation sequence", "nav": "Precedents, evaluation and implementation sequence", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-evaluation", "revision": "54d6734a1f233476d23ef5afa6882a780f4ac4dd3ba138da054e11bd1dc43a61", "status": "design", "renderingRevision": "8bc532dcb80954200d1170ef1797305627db01f881ae02db7d3591bfdb529527", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "34", "35", "36", "37" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-evaluation", "polarity": "Neutral" }, { "id": "section-section-34", "anchor": "section-34", "label": "34. Industrial precedents and their limits", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evaluation#section-34", "polarity": "Neutral" }, { "id": "section-section-35", "anchor": "section-35", "label": "35. Evaluation agenda and limitations", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evaluation#section-35", "polarity": "Neutral" }, { "id": "section-section-36", "anchor": "section-36", "label": "36. Implementation sequence and acceptance milestones", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evaluation#section-36", "polarity": "Neutral" }, { "id": "section-section-37", "anchor": "section-37", "label": "37. Conclusion", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evaluation#section-37", "polarity": "Neutral" }, { "id": "section-3410-what-remains-unvalidated", "anchor": "3410-what-remains-unvalidated", "label": "34.10 What remains unvalidated", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evaluation#3410-what-remains-unvalidated", "polarity": "Neutral" }, { "id": "section-356-work-experience-as-evidence", "anchor": "356-work-experience-as-evidence", "label": "35.6 Work experience as evidence", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evaluation#356-work-experience-as-evidence", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-evaluation:references-reaktor-competitive-analysis", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-reaktor-module-execution-plan", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-architecture-atlas-workbench", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-facsimile-page-91", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "section-3410-what-remains-unvalidated", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-91", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-facsimile-page-95", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "section-356-work-experience-as-evidence", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-95", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-facsimile-page-96", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "section-section-36", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-96", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:references-engine-preprint-facsimile-page-97", "kind": "references", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "section-section-37", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-97", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:explains-reaktor-competitive-analysis", "kind": "explains", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:explains-reaktor-module-execution-plan", "kind": "explains", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evaluation:explains-architecture-atlas-workbench", "kind": "explains", "owner": "engine-preprint-evaluation", "incidences": [ { "node": "engine-preprint-evaluation", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-evaluation.json", "sections": [ { "id": "precedents-evaluation-and-implementation-sequence", "anchor": "precedents-evaluation-and-implementation-sequence", "title": "Precedents, evaluation and implementation sequence", "level": 1 }, { "id": "section-34", "anchor": "section-34", "title": "34. Industrial precedents and their limits", "level": 2 }, { "id": "341-the-engine-precedent-and-its-different-mechanisms", "anchor": "341-the-engine-precedent-and-its-different-mechanisms", "title": "34.1 The engine precedent and its different mechanisms", "level": 3 }, { "id": "342-render-graphs-declare-validate-compile-execute", "anchor": "342-render-graphs-declare-validate-compile-execute", "title": "34.2 Render graphs: declare, validate, compile, execute", "level": 3 }, { "id": "343-massentity-data-layout-follows-processing", "anchor": "343-massentity-data-layout-follows-processing", "title": "34.3 MassEntity: data layout follows processing", "level": 3 }, { "id": "344-asset-management-replication-and-gameplay-mechanisms", "anchor": "344-asset-management-replication-and-gameplay-mechanisms", "title": "34.4 Asset management, replication, and gameplay mechanisms", "level": 3 }, { "id": "345-compiler-infrastructures-and-reproducible-construction", "anchor": "345-compiler-infrastructures-and-reproducible-construction", "title": "34.5 Compiler infrastructures and reproducible construction", "level": 3 }, { "id": "346-distributed-programming-and-operational-services", "anchor": "346-distributed-programming-and-operational-services", "title": "34.6 Distributed programming and operational services", "level": 3 }, { "id": "347-application-building-blocks-and-operational-composition", "anchor": "347-application-building-blocks-and-operational-composition", "title": "34.7 Application building blocks and operational composition", "level": 3 }, { "id": "348-catalogs-lineage-and-provenance", "anchor": "348-catalogs-lineage-and-provenance", "title": "34.8 Catalogs, lineage, and provenance", "level": 3 }, { "id": "349-testing-proof-and-trusted-computing-bases", "anchor": "349-testing-proof-and-trusted-computing-bases", "title": "34.9 Testing, proof, and trusted computing bases", "level": 3 }, { "id": "3410-what-remains-unvalidated", "anchor": "3410-what-remains-unvalidated", "title": "34.10 What remains unvalidated", "level": 3 }, { "id": "section-35", "anchor": "section-35", "title": "35. Evaluation agenda and limitations", "level": 2 }, { "id": "351-matched-engineering-conditions", "anchor": "351-matched-engineering-conditions", "title": "35.1 Matched engineering conditions", "level": 3 }, { "id": "352-limits-of-the-model", "anchor": "352-limits-of-the-model", "title": "35.2 Limits of the model", "level": 3 }, { "id": "353-falsifiable-questions-and-comparison-design", "anchor": "353-falsifiable-questions-and-comparison-design", "title": "35.3 Falsifiable questions and comparison design", "level": 3 }, { "id": "354-correctness-coverage-and-failure-campaigns", "anchor": "354-correctness-coverage-and-failure-campaigns", "title": "35.4 Correctness, coverage, and failure campaigns", "level": 3 }, { "id": "355-human-and-agent-outcomes", "anchor": "355-human-and-agent-outcomes", "title": "35.5 Human and agent outcomes", "level": 3 }, { "id": "356-work-experience-as-evidence", "anchor": "356-work-experience-as-evidence", "title": "35.6 Work experience as evidence", "level": 3 }, { "id": "section-36", "anchor": "section-36", "title": "36. Implementation sequence and acceptance milestones", "level": 2 }, { "id": "section-37", "anchor": "section-37", "title": "37. Conclusion", "level": 2 } ], "links": [ { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-workbench", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-91", "relation": "references", "sourceAnchor": "3410-what-remains-unvalidated" }, { "id": "engine-preprint-facsimile", "anchor": "page-95", "relation": "references", "sourceAnchor": "356-work-experience-as-evidence" }, { "id": "engine-preprint-facsimile", "anchor": "page-96", "relation": "references", "sourceAnchor": "section-36" }, { "id": "engine-preprint-facsimile", "anchor": "page-97", "relation": "references", "sourceAnchor": "section-37" } ] }, { "id": "engine-preprint-evolution", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: liveupdate, coordinator and human-agent authoring. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 5, "title": "LiveUpdate, coordinator and human-agent authoring", "nav": "LiveUpdate, coordinator and human-agent authoring", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-evolution", "revision": "9cbe9c874110e02b6b4f2458c0b43922527a9ebbc828f2e1e007d4c7003f218b", "status": "design", "renderingRevision": "cc8740ecec632fd30aa5af897145c5043e17d78eeddcfab00eab267d559bc54b", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "26", "27", "28", "29" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-evolution", "polarity": "Neutral" }, { "id": "section-section-26", "anchor": "section-26", "label": "26. LiveUpdate: replacement of supported subgraphs", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#section-26", "polarity": "Neutral" }, { "id": "section-section-27", "anchor": "section-27", "label": "27. A concrete LiveUpdate coordinator", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#section-27", "polarity": "Neutral" }, { "id": "section-section-28", "anchor": "section-28", "label": "28. Human and agent authoring", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#section-28", "polarity": "Neutral" }, { "id": "section-section-29", "anchor": "section-29", "label": "29. Capability growth and the changing division of programming work", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#section-29", "polarity": "Neutral" }, { "id": "section-source-figure-pages", "anchor": "source-figure-pages", "label": "Source figure pages", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#source-figure-pages", "polarity": "Neutral" }, { "id": "section-2610-packaging-memory-and-update-security", "anchor": "2610-packaging-memory-and-update-security", "label": "26.10 Packaging, memory, and update security", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#2610-packaging-memory-and-update-security", "polarity": "Neutral" }, { "id": "section-275-delivery-optimization-follows-correctness", "anchor": "275-delivery-optimization-follows-correctness", "label": "27.5 Delivery optimization follows correctness", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#275-delivery-optimization-follows-correctness", "polarity": "Neutral" }, { "id": "section-284-reusable-discoveries-not-perpetual-rediscovery", "anchor": "284-reusable-discoveries-not-perpetual-rediscovery", "label": "28.4 Reusable discoveries, not perpetual rediscovery", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#284-reusable-discoveries-not-perpetual-rediscovery", "polarity": "Neutral" }, { "id": "section-299-avoiding-false-confidence-from-multiple-agents", "anchor": "299-avoiding-false-confidence-from-multiple-agents", "label": "29.9 Avoiding false confidence from multiple agents", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-evolution#299-avoiding-false-confidence-from-multiple-agents", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-evolution:references-reaktor-agentic-tooling", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-reaktor-capability", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-architecture-atlas-evolution", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-facsimile-page-63", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "section-2610-packaging-memory-and-update-security", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-63", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-facsimile-page-68", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "section-275-delivery-optimization-follows-correctness", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-68", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-facsimile-page-70", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "section-284-reusable-discoveries-not-perpetual-rediscovery", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-70", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:references-engine-preprint-facsimile-page-71", "kind": "references", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "section-299-avoiding-false-confidence-from-multiple-agents", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-71", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:explains-reaktor-agentic-tooling", "kind": "explains", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:explains-reaktor-capability", "kind": "explains", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-evolution:explains-architecture-atlas-evolution", "kind": "explains", "owner": "engine-preprint-evolution", "incidences": [ { "node": "engine-preprint-evolution", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-evolution.json", "sections": [ { "id": "liveupdate-coordinator-and-human-agent-authoring", "anchor": "liveupdate-coordinator-and-human-agent-authoring", "title": "LiveUpdate, coordinator and human-agent authoring", "level": 1 }, { "id": "section-26", "anchor": "section-26", "title": "26. LiveUpdate: replacement of supported subgraphs", "level": 2 }, { "id": "261-delivery-rewriting-and-activation", "anchor": "261-delivery-rewriting-and-activation", "title": "26.1 Delivery, rewriting, and activation", "level": 3 }, { "id": "262-update-regions-and-closure", "anchor": "262-update-regions-and-closure", "title": "26.2 Update regions and closure", "level": 3 }, { "id": "263-update-kinds-and-activation-modes", "anchor": "263-update-kinds-and-activation-modes", "title": "26.3 Update kinds and activation modes", "level": 3 }, { "id": "264-host-contracts-artifacts-and-release-mappings", "anchor": "264-host-contracts-artifacts-and-release-mappings", "title": "26.4 Host contracts, artifacts, and release mappings", "level": 3 }, { "id": "265-eligibility-and-runtime-readiness", "anchor": "265-eligibility-and-runtime-readiness", "title": "26.5 Eligibility and runtime readiness", "level": 3 }, { "id": "266-preparation-and-effect-isolation", "anchor": "266-preparation-and-effect-isolation", "title": "26.6 Preparation and effect isolation", "level": 3 }, { "id": "267-generation-pinned-execution", "anchor": "267-generation-pinned-execution", "title": "26.7 Generation-pinned execution", "level": 3 }, { "id": "268-exclusive-state-and-safe-points", "anchor": "268-exclusive-state-and-safe-points", "title": "26.8 Exclusive state and safe points", "level": 3 }, { "id": "269-state-migration-and-recovery", "anchor": "269-state-migration-and-recovery", "title": "26.9 State migration and recovery", "level": 3 }, { "id": "2610-packaging-memory-and-update-security", "anchor": "2610-packaging-memory-and-update-security", "title": "26.10 Packaging, memory, and update security", "level": 3 }, { "id": "section-27", "anchor": "section-27", "title": "27. A concrete LiveUpdate coordinator", "level": 2 }, { "id": "271-durable-decisions-and-transient-preparation", "anchor": "271-durable-decisions-and-transient-preparation", "title": "27.1 Durable decisions and transient preparation", "level": 3 }, { "id": "272-a-publication-protocol", "anchor": "272-a-publication-protocol", "title": "27.2 A publication protocol", "level": 3 }, { "id": "273-crash-cuts-and-recovery-choices", "anchor": "273-crash-cuts-and-recovery-choices", "title": "27.3 Crash cuts and recovery choices", "level": 3 }, { "id": "274-callbacks-subscriptions-and-native-resources", "anchor": "274-callbacks-subscriptions-and-native-resources", "title": "27.4 Callbacks, subscriptions, and native resources", "level": 3 }, { "id": "275-delivery-optimization-follows-correctness", "anchor": "275-delivery-optimization-follows-correctness", "title": "27.5 Delivery optimization follows correctness", "level": 3 }, { "id": "section-28", "anchor": "section-28", "title": "28. Human and agent authoring", "level": 2 }, { "id": "281-a-common-engineering-surface", "anchor": "281-a-common-engineering-surface", "title": "28.1 A common engineering surface", "level": 3 }, { "id": "282-proposals-checks-and-receipts", "anchor": "282-proposals-checks-and-receipts", "title": "28.2 Proposals, checks, and receipts", "level": 3 }, { "id": "283-application-agents-are-also-application-components", "anchor": "283-application-agents-are-also-application-components", "title": "28.3 Application agents are also application components", "level": 3 }, { "id": "284-reusable-discoveries-not-perpetual-rediscovery", "anchor": "284-reusable-discoveries-not-perpetual-rediscovery", "title": "28.4 Reusable discoveries, not perpetual rediscovery", "level": 3 }, { "id": "section-29", "anchor": "section-29", "title": "29. Capability growth and the changing division of programming work", "level": 2 }, { "id": "291-a-realizable-system-space", "anchor": "291-a-realizable-system-space", "title": "29.1 A realizable-system space", "level": 3 }, { "id": "292-conservative-extensions", "anchor": "292-conservative-extensions", "title": "29.2 Conservative extensions", "level": 3 }, { "id": "293-where-vector-spaces-are-genuinely-useful", "anchor": "293-where-vector-spaces-are-genuinely-useful", "title": "29.3 Where vector spaces are genuinely useful", "level": 3 }, { "id": "294-a-capability-package-carries-more-than-code", "anchor": "294-a-capability-package-carries-more-than-code", "title": "29.4 A capability package carries more than code", "level": 3 }, { "id": "295-human-and-agent-responsibilities", "anchor": "295-human-and-agent-responsibilities", "title": "29.5 Human and agent responsibilities", "level": 3 }, { "id": "296-evidence-about-agent-environments", "anchor": "296-evidence-about-agent-environments", "title": "29.6 Evidence about agent environments", "level": 3 }, { "id": "297-faster-generation-shifts-rather-than-removes-bottlenecks", "anchor": "297-faster-generation-shifts-rather-than-removes-bottlenecks", "title": "29.7 Faster generation shifts rather than removes bottlenecks", "level": 3 }, { "id": "298-three-trajectories-one-robust-architecture", "anchor": "298-three-trajectories-one-robust-architecture", "title": "29.8 Three trajectories, one robust architecture", "level": 3 }, { "id": "299-avoiding-false-confidence-from-multiple-agents", "anchor": "299-avoiding-false-confidence-from-multiple-agents", "title": "29.9 Avoiding false confidence from multiple agents", "level": 3 }, { "id": "source-figure-pages", "anchor": "source-figure-pages", "title": "Source figure pages", "level": 2 }, { "id": "original-figure-page-66", "anchor": "original-figure-page-66", "title": "Original figure page 66", "level": 3 }, { "id": "original-figure-page-68", "anchor": "original-figure-page-68", "title": "Original figure page 68", "level": 3 }, { "id": "original-figure-page-72", "anchor": "original-figure-page-72", "title": "Original figure page 72", "level": 3 } ], "links": [ { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-63", "relation": "references", "sourceAnchor": "2610-packaging-memory-and-update-security" }, { "id": "engine-preprint-facsimile", "anchor": "page-68", "relation": "references", "sourceAnchor": "275-delivery-optimization-follows-correctness" }, { "id": "engine-preprint-facsimile", "anchor": "page-70", "relation": "references", "sourceAnchor": "284-reusable-discoveries-not-perpetual-rediscovery" }, { "id": "engine-preprint-facsimile", "anchor": "page-71", "relation": "references", "sourceAnchor": "299-avoiding-false-confidence-from-multiple-agents" } ] }, { "id": "engine-preprint-facsimile", "owner": "Reaktor Project / BestBuds Ventures", "use": "Use for the exact source typography, alongside the ordered reading chapters.", "kind": "facsimile", "summary": "All 114 source pages as web vector images with extracted text, preserving exact original typography without requiring the PDF.", "region": "engine-preprint-book", "order": 9, "title": "Engine preprint: original page layouts", "nav": "Original page layouts", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-facsimile", "revision": "07acb1ba494ee8e8491ad218e3d3f807d7c6efd8a60492710478e18b1ea15dd0", "status": "design", "renderingRevision": "5eb9714da9807d168ea42d6749bce8eefa5fcb87025b1fa87f08a3097e7aac57", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor engine technical preprint", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "all 114 original pages" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-facsimile", "polarity": "Neutral" }, { "id": "section-page-1", "anchor": "page-1", "label": "Page 1", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-1", "polarity": "Neutral" }, { "id": "section-page-2", "anchor": "page-2", "label": "Page 2", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-2", "polarity": "Neutral" }, { "id": "section-page-3", "anchor": "page-3", "label": "Page 3", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-3", "polarity": "Neutral" }, { "id": "section-page-4", "anchor": "page-4", "label": "Page 4", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-4", "polarity": "Neutral" }, { "id": "section-page-5", "anchor": "page-5", "label": "Page 5", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-5", "polarity": "Neutral" }, { "id": "section-page-6", "anchor": "page-6", "label": "Page 6", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-6", "polarity": "Neutral" }, { "id": "section-page-8", "anchor": "page-8", "label": "Page 8", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-8", "polarity": "Neutral" }, { "id": "section-page-12", "anchor": "page-12", "label": "Page 12", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-12", "polarity": "Neutral" }, { "id": "section-page-14", "anchor": "page-14", "label": "Page 14", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-14", "polarity": "Neutral" }, { "id": "section-page-17", "anchor": "page-17", "label": "Page 17", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-17", "polarity": "Neutral" }, { "id": "section-page-18", "anchor": "page-18", "label": "Page 18", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-18", "polarity": "Neutral" }, { "id": "section-page-20", "anchor": "page-20", "label": "Page 20", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-20", "polarity": "Neutral" }, { "id": "section-page-22", "anchor": "page-22", "label": "Page 22", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-22", "polarity": "Neutral" }, { "id": "section-page-25", "anchor": "page-25", "label": "Page 25", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-25", "polarity": "Neutral" }, { "id": "section-page-27", "anchor": "page-27", "label": "Page 27", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-27", "polarity": "Neutral" }, { "id": "section-page-30", "anchor": "page-30", "label": "Page 30", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-30", "polarity": "Neutral" }, { "id": "section-page-35", "anchor": "page-35", "label": "Page 35", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-35", "polarity": "Neutral" }, { "id": "section-page-36", "anchor": "page-36", "label": "Page 36", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-36", "polarity": "Neutral" }, { "id": "section-page-39", "anchor": "page-39", "label": "Page 39", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-39", "polarity": "Neutral" }, { "id": "section-page-42", "anchor": "page-42", "label": "Page 42", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-42", "polarity": "Neutral" }, { "id": "section-page-43", "anchor": "page-43", "label": "Page 43", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-43", "polarity": "Neutral" }, { "id": "section-page-51", "anchor": "page-51", "label": "Page 51", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-51", "polarity": "Neutral" }, { "id": "section-page-53", "anchor": "page-53", "label": "Page 53", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-53", "polarity": "Neutral" }, { "id": "section-page-54", "anchor": "page-54", "label": "Page 54", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-54", "polarity": "Neutral" }, { "id": "section-page-45", "anchor": "page-45", "label": "Page 45", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-45", "polarity": "Neutral" }, { "id": "section-page-48", "anchor": "page-48", "label": "Page 48", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-48", "polarity": "Neutral" }, { "id": "section-page-57", "anchor": "page-57", "label": "Page 57", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-57", "polarity": "Neutral" }, { "id": "section-page-59", "anchor": "page-59", "label": "Page 59", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-59", "polarity": "Neutral" }, { "id": "section-page-61", "anchor": "page-61", "label": "Page 61", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-61", "polarity": "Neutral" }, { "id": "section-page-63", "anchor": "page-63", "label": "Page 63", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-63", "polarity": "Neutral" }, { "id": "section-page-68", "anchor": "page-68", "label": "Page 68", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-68", "polarity": "Neutral" }, { "id": "section-page-70", "anchor": "page-70", "label": "Page 70", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-70", "polarity": "Neutral" }, { "id": "section-page-71", "anchor": "page-71", "label": "Page 71", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-71", "polarity": "Neutral" }, { "id": "section-page-75", "anchor": "page-75", "label": "Page 75", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-75", "polarity": "Neutral" }, { "id": "section-page-77", "anchor": "page-77", "label": "Page 77", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-77", "polarity": "Neutral" }, { "id": "section-page-80", "anchor": "page-80", "label": "Page 80", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-80", "polarity": "Neutral" }, { "id": "section-page-83", "anchor": "page-83", "label": "Page 83", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-83", "polarity": "Neutral" }, { "id": "section-page-91", "anchor": "page-91", "label": "Page 91", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-91", "polarity": "Neutral" }, { "id": "section-page-95", "anchor": "page-95", "label": "Page 95", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-95", "polarity": "Neutral" }, { "id": "section-page-96", "anchor": "page-96", "label": "Page 96", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-96", "polarity": "Neutral" }, { "id": "section-page-97", "anchor": "page-97", "label": "Page 97", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-97", "polarity": "Neutral" }, { "id": "section-page-98", "anchor": "page-98", "label": "Page 98", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-98", "polarity": "Neutral" }, { "id": "section-page-105", "anchor": "page-105", "label": "Page 105", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-105", "polarity": "Neutral" }, { "id": "section-page-106", "anchor": "page-106", "label": "Page 106", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-106", "polarity": "Neutral" }, { "id": "section-page-107", "anchor": "page-107", "label": "Page 107", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-107", "polarity": "Neutral" }, { "id": "section-page-108", "anchor": "page-108", "label": "Page 108", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-108", "polarity": "Neutral" }, { "id": "section-page-109", "anchor": "page-109", "label": "Page 109", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-109", "polarity": "Neutral" }, { "id": "section-page-112", "anchor": "page-112", "label": "Page 112", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-facsimile#page-112", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-facsimile:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-facsimile", "incidences": [ { "node": "engine-preprint-facsimile", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-facsimile.json", "sections": [ { "id": "engine-preprint-original-page-layouts", "anchor": "engine-preprint-original-page-layouts", "title": "Engine preprint: original page layouts", "level": 1 }, { "id": "page-1", "anchor": "page-1", "title": "Page 1", "level": 2 }, { "id": "page-2", "anchor": "page-2", "title": "Page 2", "level": 2 }, { "id": "page-3", "anchor": "page-3", "title": "Page 3", "level": 2 }, { "id": "page-4", "anchor": "page-4", "title": "Page 4", "level": 2 }, { "id": "page-5", "anchor": "page-5", "title": "Page 5", "level": 2 }, { "id": "page-6", "anchor": "page-6", "title": "Page 6", "level": 2 }, { "id": "page-7", "anchor": "page-7", "title": "Page 7", "level": 2 }, { "id": "page-8", "anchor": "page-8", "title": "Page 8", "level": 2 }, { "id": "page-9", "anchor": "page-9", "title": "Page 9", "level": 2 }, { "id": "page-10", "anchor": "page-10", "title": "Page 10", "level": 2 }, { "id": "page-11", "anchor": "page-11", "title": "Page 11", "level": 2 }, { "id": "page-12", "anchor": "page-12", "title": "Page 12", "level": 2 }, { "id": "page-13", "anchor": "page-13", "title": "Page 13", "level": 2 }, { "id": "page-14", "anchor": "page-14", "title": "Page 14", "level": 2 }, { "id": "page-15", "anchor": "page-15", "title": "Page 15", "level": 2 }, { "id": "page-16", "anchor": "page-16", "title": "Page 16", "level": 2 }, { "id": "page-17", "anchor": "page-17", "title": "Page 17", "level": 2 }, { "id": "page-18", "anchor": "page-18", "title": "Page 18", "level": 2 }, { "id": "page-19", "anchor": "page-19", "title": "Page 19", "level": 2 }, { "id": "page-20", "anchor": "page-20", "title": "Page 20", "level": 2 }, { "id": "page-21", "anchor": "page-21", "title": "Page 21", "level": 2 }, { "id": "page-22", "anchor": "page-22", "title": "Page 22", "level": 2 }, { "id": "page-23", "anchor": "page-23", "title": "Page 23", "level": 2 }, { "id": "page-24", "anchor": "page-24", "title": "Page 24", "level": 2 }, { "id": "page-25", "anchor": "page-25", "title": "Page 25", "level": 2 }, { "id": "page-26", "anchor": "page-26", "title": "Page 26", "level": 2 }, { "id": "page-27", "anchor": "page-27", "title": "Page 27", "level": 2 }, { "id": "page-28", "anchor": "page-28", "title": "Page 28", "level": 2 }, { "id": "page-29", "anchor": "page-29", "title": "Page 29", "level": 2 }, { "id": "page-30", "anchor": "page-30", "title": "Page 30", "level": 2 }, { "id": "page-31", "anchor": "page-31", "title": "Page 31", "level": 2 }, { "id": "page-32", "anchor": "page-32", "title": "Page 32", "level": 2 }, { "id": "page-33", "anchor": "page-33", "title": "Page 33", "level": 2 }, { "id": "page-34", "anchor": "page-34", "title": "Page 34", "level": 2 }, { "id": "page-35", "anchor": "page-35", "title": "Page 35", "level": 2 }, { "id": "page-36", "anchor": "page-36", "title": "Page 36", "level": 2 }, { "id": "page-37", "anchor": "page-37", "title": "Page 37", "level": 2 }, { "id": "page-38", "anchor": "page-38", "title": "Page 38", "level": 2 }, { "id": "page-39", "anchor": "page-39", "title": "Page 39", "level": 2 }, { "id": "page-40", "anchor": "page-40", "title": "Page 40", "level": 2 }, { "id": "page-41", "anchor": "page-41", "title": "Page 41", "level": 2 }, { "id": "page-42", "anchor": "page-42", "title": "Page 42", "level": 2 }, { "id": "page-43", "anchor": "page-43", "title": "Page 43", "level": 2 }, { "id": "page-44", "anchor": "page-44", "title": "Page 44", "level": 2 }, { "id": "page-45", "anchor": "page-45", "title": "Page 45", "level": 2 }, { "id": "page-46", "anchor": "page-46", "title": "Page 46", "level": 2 }, { "id": "page-47", "anchor": "page-47", "title": "Page 47", "level": 2 }, { "id": "page-48", "anchor": "page-48", "title": "Page 48", "level": 2 }, { "id": "page-49", "anchor": "page-49", "title": "Page 49", "level": 2 }, { "id": "page-50", "anchor": "page-50", "title": "Page 50", "level": 2 }, { "id": "page-51", "anchor": "page-51", "title": "Page 51", "level": 2 }, { "id": "page-52", "anchor": "page-52", "title": "Page 52", "level": 2 }, { "id": "page-53", "anchor": "page-53", "title": "Page 53", "level": 2 }, { "id": "page-54", "anchor": "page-54", "title": "Page 54", "level": 2 }, { "id": "page-55", "anchor": "page-55", "title": "Page 55", "level": 2 }, { "id": "page-56", "anchor": "page-56", "title": "Page 56", "level": 2 }, { "id": "page-57", "anchor": "page-57", "title": "Page 57", "level": 2 }, { "id": "page-58", "anchor": "page-58", "title": "Page 58", "level": 2 }, { "id": "page-59", "anchor": "page-59", "title": "Page 59", "level": 2 }, { "id": "page-60", "anchor": "page-60", "title": "Page 60", "level": 2 }, { "id": "page-61", "anchor": "page-61", "title": "Page 61", "level": 2 }, { "id": "page-62", "anchor": "page-62", "title": "Page 62", "level": 2 }, { "id": "page-63", "anchor": "page-63", "title": "Page 63", "level": 2 }, { "id": "page-64", "anchor": "page-64", "title": "Page 64", "level": 2 }, { "id": "page-65", "anchor": "page-65", "title": "Page 65", "level": 2 }, { "id": "page-66", "anchor": "page-66", "title": "Page 66", "level": 2 }, { "id": "page-67", "anchor": "page-67", "title": "Page 67", "level": 2 }, { "id": "page-68", "anchor": "page-68", "title": "Page 68", "level": 2 }, { "id": "page-69", "anchor": "page-69", "title": "Page 69", "level": 2 }, { "id": "page-70", "anchor": "page-70", "title": "Page 70", "level": 2 }, { "id": "page-71", "anchor": "page-71", "title": "Page 71", "level": 2 }, { "id": "page-72", "anchor": "page-72", "title": "Page 72", "level": 2 }, { "id": "page-73", "anchor": "page-73", "title": "Page 73", "level": 2 }, { "id": "page-74", "anchor": "page-74", "title": "Page 74", "level": 2 }, { "id": "page-75", "anchor": "page-75", "title": "Page 75", "level": 2 }, { "id": "page-76", "anchor": "page-76", "title": "Page 76", "level": 2 }, { "id": "page-77", "anchor": "page-77", "title": "Page 77", "level": 2 }, { "id": "page-78", "anchor": "page-78", "title": "Page 78", "level": 2 }, { "id": "page-79", "anchor": "page-79", "title": "Page 79", "level": 2 }, { "id": "page-80", "anchor": "page-80", "title": "Page 80", "level": 2 }, { "id": "page-81", "anchor": "page-81", "title": "Page 81", "level": 2 }, { "id": "page-82", "anchor": "page-82", "title": "Page 82", "level": 2 }, { "id": "page-83", "anchor": "page-83", "title": "Page 83", "level": 2 }, { "id": "page-84", "anchor": "page-84", "title": "Page 84", "level": 2 }, { "id": "page-85", "anchor": "page-85", "title": "Page 85", "level": 2 }, { "id": "page-86", "anchor": "page-86", "title": "Page 86", "level": 2 }, { "id": "page-87", "anchor": "page-87", "title": "Page 87", "level": 2 }, { "id": "page-88", "anchor": "page-88", "title": "Page 88", "level": 2 }, { "id": "page-89", "anchor": "page-89", "title": "Page 89", "level": 2 }, { "id": "page-90", "anchor": "page-90", "title": "Page 90", "level": 2 }, { "id": "page-91", "anchor": "page-91", "title": "Page 91", "level": 2 }, { "id": "page-92", "anchor": "page-92", "title": "Page 92", "level": 2 }, { "id": "page-93", "anchor": "page-93", "title": "Page 93", "level": 2 }, { "id": "page-94", "anchor": "page-94", "title": "Page 94", "level": 2 }, { "id": "page-95", "anchor": "page-95", "title": "Page 95", "level": 2 }, { "id": "page-96", "anchor": "page-96", "title": "Page 96", "level": 2 }, { "id": "page-97", "anchor": "page-97", "title": "Page 97", "level": 2 }, { "id": "page-98", "anchor": "page-98", "title": "Page 98", "level": 2 }, { "id": "page-99", "anchor": "page-99", "title": "Page 99", "level": 2 }, { "id": "page-100", "anchor": "page-100", "title": "Page 100", "level": 2 }, { "id": "page-101", "anchor": "page-101", "title": "Page 101", "level": 2 }, { "id": "page-102", "anchor": "page-102", "title": "Page 102", "level": 2 }, { "id": "page-103", "anchor": "page-103", "title": "Page 103", "level": 2 }, { "id": "page-104", "anchor": "page-104", "title": "Page 104", "level": 2 }, { "id": "page-105", "anchor": "page-105", "title": "Page 105", "level": 2 }, { "id": "page-106", "anchor": "page-106", "title": "Page 106", "level": 2 }, { "id": "page-107", "anchor": "page-107", "title": "Page 107", "level": 2 }, { "id": "page-108", "anchor": "page-108", "title": "Page 108", "level": 2 }, { "id": "page-109", "anchor": "page-109", "title": "Page 109", "level": 2 }, { "id": "page-110", "anchor": "page-110", "title": "Page 110", "level": 2 }, { "id": "page-111", "anchor": "page-111", "title": "Page 111", "level": 2 }, { "id": "page-112", "anchor": "page-112", "title": "Page 112", "level": 2 }, { "id": "page-113", "anchor": "page-113", "title": "Page 113", "level": 2 }, { "id": "page-114", "anchor": "page-114", "title": "Page 114", "level": 2 } ], "links": [ { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" } ] }, { "id": "engine-preprint-graph", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: graph model, protocols and computation. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 1, "title": "Graph model, protocols and computation", "nav": "Graph model, protocols and computation", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-graph", "revision": "09ef3f7527b74786d73805704b83748089cd0fa54ba285e69a081bf6329e1142", "status": "design", "renderingRevision": "f60a27c9a820d4aa365df55b178d14a21dd54c703ffe4d9e3b49aa3cda10b3ce", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "8", "9", "10", "11", "12", "13", "14", "15" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-graph", "polarity": "Neutral" }, { "id": "section-section-8", "anchor": "section-8", "label": "8. Mathematical foundations for architectural reasoning", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#section-8", "polarity": "Neutral" }, { "id": "section-section-9", "anchor": "section-9", "label": "9. The graph-theoretic model", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#section-9", "polarity": "Neutral" }, { "id": "section-section-10", "anchor": "section-10", "label": "10. Network views, sparse algebra, and architectural analysis", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#section-10", "polarity": "Neutral" }, { "id": "section-section-11", "anchor": "section-11", "label": "11. Ports, contracts, and shared service interfaces", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#section-11", "polarity": "Neutral" }, { "id": "section-section-12", "anchor": "section-12", "label": "12. Interface contracts and implementation architecture", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#section-12", "polarity": "Neutral" }, { "id": "section-section-13", "anchor": "section-13", "label": "13. Hyperedges, modules, and graph rewriting", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#section-13", "polarity": "Neutral" }, { "id": "section-87-mathematics-as-an-engineering-interface", "anchor": "87-mathematics-as-an-engineering-interface", "label": "8.7 Mathematics as an engineering interface", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#87-mathematics-as-an-engineering-interface", "polarity": "Neutral" }, { "id": "section-96-behavioral-interpretation", "anchor": "96-behavioral-interpretation", "label": "9.6 Behavioral interpretation", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#96-behavioral-interpretation", "polarity": "Neutral" }, { "id": "section-106-views-are-queries-with-obligations", "anchor": "106-views-are-queries-with-obligations", "label": "10.6 Views are queries with obligations", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#106-views-are-queries-with-obligations", "polarity": "Neutral" }, { "id": "section-115-context-effects-and-failure", "anchor": "115-context-effects-and-failure", "label": "11.5 Context, effects, and failure", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#115-context-effects-and-failure", "polarity": "Neutral" }, { "id": "section-129-compilation-outputs-and-diagnostics", "anchor": "129-compilation-outputs-and-diagnostics", "label": "12.9 Compilation outputs and diagnostics", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#129-compilation-outputs-and-diagnostics", "polarity": "Neutral" }, { "id": "section-133-concurrent-editing", "anchor": "133-concurrent-editing", "label": "13.3 Concurrent editing", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#133-concurrent-editing", "polarity": "Neutral" }, { "id": "section-147-multiple-meanings-of-time", "anchor": "147-multiple-meanings-of-time", "label": "14.7 Multiple meanings of time", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#147-multiple-meanings-of-time", "polarity": "Neutral" }, { "id": "section-158-consistency-belongs-to-an-operation-or-datum", "anchor": "158-consistency-belongs-to-an-operation-or-datum", "label": "15.8 Consistency belongs to an operation or datum", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-graph#158-consistency-belongs-to-an-operation-or-datum", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-graph:references-reaktor-unified-system-graph", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-graph-kernel-analysis", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-reaktor-actor-model", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-20", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-87-mathematics-as-an-engineering-interface", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-20", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-22", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-96-behavioral-interpretation", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-22", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-25", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-106-views-are-queries-with-obligations", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-25", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-27", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-115-context-effects-and-failure", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-27", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-30", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-129-compilation-outputs-and-diagnostics", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-30", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-35", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-133-concurrent-editing", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-35", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-36", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-147-multiple-meanings-of-time", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-36", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:references-engine-preprint-facsimile-page-39", "kind": "references", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "section-158-consistency-belongs-to-an-operation-or-datum", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-39", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:explains-reaktor-unified-system-graph", "kind": "explains", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:explains-graph-kernel-analysis", "kind": "explains", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-graph:explains-reaktor-actor-model", "kind": "explains", "owner": "engine-preprint-graph", "incidences": [ { "node": "engine-preprint-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-graph.json", "sections": [ { "id": "graph-model-protocols-and-computation", "anchor": "graph-model-protocols-and-computation", "title": "Graph model, protocols and computation", "level": 1 }, { "id": "section-8", "anchor": "section-8", "title": "8. Mathematical foundations for architectural reasoning", "level": 2 }, { "id": "81-sets-identities-functions-and-relations", "anchor": "81-sets-identities-functions-and-relations", "title": "8.1 Sets, identities, functions, and relations", "level": 3 }, { "id": "82-types-distinguish-legal-objects-from-merely-encodable-objects", "anchor": "82-types-distinguish-legal-objects-from-merely-encodable-objects", "title": "8.2 Types distinguish legal objects from merely encodable objects", "level": 3 }, { "id": "83-partial-orders-causality-and-information-growth", "anchor": "83-partial-orders-causality-and-information-growth", "title": "8.3 Partial orders, causality, and information growth", "level": 3 }, { "id": "84-fixed-points-and-closure", "anchor": "84-fixed-points-and-closure", "title": "8.4 Fixed points and closure", "level": 3 }, { "id": "85-state-machines-invariants-and-traces", "anchor": "85-state-machines-invariants-and-traces", "title": "8.5 State machines, invariants, and traces", "level": 3 }, { "id": "86-compositional-reasoning-and-its-limits", "anchor": "86-compositional-reasoning-and-its-limits", "title": "8.6 Compositional reasoning and its limits", "level": 3 }, { "id": "87-mathematics-as-an-engineering-interface", "anchor": "87-mathematics-as-an-engineering-interface", "title": "8.7 Mathematics as an engineering interface", "level": 3 }, { "id": "section-9", "anchor": "section-9", "title": "9. The graph-theoretic model", "level": 2 }, { "id": "91-typed-incidence-structure", "anchor": "91-typed-incidence-structure", "title": "9.1 Typed incidence structure", "level": 3 }, { "id": "92-typing-and-structural-validity", "anchor": "92-typing-and-structural-validity", "title": "9.2 Typing and structural validity", "level": 3 }, { "id": "93-protocols-determine-direction-and-enablement", "anchor": "93-protocols-determine-direction-and-enablement", "title": "9.3 Protocols determine direction and enablement", "level": 3 }, { "id": "94-incidence-encoding-and-representation-correctness", "anchor": "94-incidence-encoding-and-representation-correctness", "title": "9.4 Incidence encoding and representation correctness", "level": 3 }, { "id": "95-hierarchy-and-exposed-interfaces", "anchor": "95-hierarchy-and-exposed-interfaces", "title": "9.5 Hierarchy and exposed interfaces", "level": 3 }, { "id": "96-behavioral-interpretation", "anchor": "96-behavioral-interpretation", "title": "9.6 Behavioral interpretation", "level": 3 }, { "id": "section-10", "anchor": "section-10", "title": "10. Network views, sparse algebra, and architectural analysis", "level": 2 }, { "id": "101-a-worked-incidence-example", "anchor": "101-a-worked-incidence-example", "title": "10.1 A worked incidence example", "level": 3 }, { "id": "102-reachability-strongly-connected-components-and-domination", "anchor": "102-reachability-strongly-connected-components-and-domination", "title": "10.2 Reachability, strongly connected components, and domination", "level": 3 }, { "id": "103-hypergraph-aware-enablement", "anchor": "103-hypergraph-aware-enablement", "title": "10.3 Hypergraph-aware enablement", "level": 3 }, { "id": "104-weighted-networks-and-cost-models", "anchor": "104-weighted-networks-and-cost-models", "title": "10.4 Weighted networks and cost models", "level": 3 }, { "id": "105-spectral-methods-useful-projections-limited-meaning", "anchor": "105-spectral-methods-useful-projections-limited-meaning", "title": "10.5 Spectral methods: useful projections, limited meaning", "level": 3 }, { "id": "106-views-are-queries-with-obligations", "anchor": "106-views-are-queries-with-obligations", "title": "10.6 Views are queries with obligations", "level": 3 }, { "id": "section-11", "anchor": "section-11", "title": "11. Ports, contracts, and shared service interfaces", "level": 2 }, { "id": "111-two-dimensions-of-an-endpoint", "anchor": "111-two-dimensions-of-an-endpoint", "title": "11.1 Two dimensions of an endpoint", "level": 3 }, { "id": "112-language-neutral-contract-identity", "anchor": "112-language-neutral-contract-identity", "title": "11.2 Language-neutral contract identity", "level": 3 }, { "id": "113-cardinality-and-collective-operations", "anchor": "113-cardinality-and-collective-operations", "title": "11.3 Cardinality and collective operations", "level": 3 }, { "id": "114-shared-api-authoring", "anchor": "114-shared-api-authoring", "title": "11.4 Shared API authoring", "level": 3 }, { "id": "115-context-effects-and-failure", "anchor": "115-context-effects-and-failure", "title": "11.5 Context, effects, and failure", "level": 3 }, { "id": "section-12", "anchor": "section-12", "title": "12. Interface contracts and implementation architecture", "level": 2 }, { "id": "121-identity-revision-and-schema-directories", "anchor": "121-identity-revision-and-schema-directories", "title": "12.1 Identity, revision, and schema directories", "level": 3 }, { "id": "122-graph-readers-expose-snapshots-not-mutable-internals", "anchor": "122-graph-readers-expose-snapshots-not-mutable-internals", "title": "12.2 Graph readers expose snapshots, not mutable internals", "level": 3 }, { "id": "123-selectors-traversals-visitors-and-passes", "anchor": "123-selectors-traversals-visitors-and-passes", "title": "12.3 Selectors, traversals, visitors, and passes", "level": 3 }, { "id": "124-graph-patches-are-transactions-over-a-semantic-revision", "anchor": "124-graph-patches-are-transactions-over-a-semantic-revision", "title": "12.4 Graph patches are transactions over a semantic revision", "level": 3 }, { "id": "125-protocol-registries-and-semantic-extension-packages", "anchor": "125-protocol-registries-and-semantic-extension-packages", "title": "12.5 Protocol registries and semantic extension packages", "level": 3 }, { "id": "126-execution-handles-and-invocation-context", "anchor": "126-execution-handles-and-invocation-context", "title": "12.6 Execution handles and invocation context", "level": 3 }, { "id": "127-streams-and-state-subscriptions", "anchor": "127-streams-and-state-subscriptions", "title": "12.7 Streams and state subscriptions", "level": 3 }, { "id": "128-lifecycle-ownership", "anchor": "128-lifecycle-ownership", "title": "12.8 Lifecycle ownership", "level": 3 }, { "id": "129-compilation-outputs-and-diagnostics", "anchor": "129-compilation-outputs-and-diagnostics", "title": "12.9 Compilation outputs and diagnostics", "level": 3 }, { "id": "section-13", "anchor": "section-13", "title": "13. Hyperedges, modules, and graph rewriting", "level": 2 }, { "id": "131-native-hyperedges-and-reified-components", "anchor": "131-native-hyperedges-and-reified-components", "title": "13.1 Native hyperedges and reified components", "level": 3 }, { "id": "132-declarative-graph-patches", "anchor": "132-declarative-graph-patches", "title": "13.2 Declarative graph patches", "level": 3 }, { "id": "133-concurrent-editing", "anchor": "133-concurrent-editing", "title": "13.3 Concurrent editing", "level": 3 }, { "id": "section-14", "anchor": "section-14", "title": "14. Computational semantics and flow-based programming", "level": 2 }, { "id": "141-a-hierarchy-of-executable-dialects", "anchor": "141-a-hierarchy-of-executable-dialects", "title": "14.1 A hierarchy of executable dialects", "level": 3 }, { "id": "142-kahn-networks-and-deterministic-streams", "anchor": "142-kahn-networks-and-deterministic-streams", "title": "14.2 Kahn networks and deterministic streams", "level": 3 }, { "id": "143-synchronous-dataflow-and-balance-equations", "anchor": "143-synchronous-dataflow-and-balance-equations", "title": "14.3 Synchronous dataflow and balance equations", "level": 3 }, { "id": "144-petri-nets-and-resource-accounting", "anchor": "144-petri-nets-and-resource-accounting", "title": "14.4 Petri nets and resource accounting", "level": 3 }, { "id": "145-an-explicit-turing-complete-behavior-dialect", "anchor": "145-an-explicit-turing-complete-behavior-dialect", "title": "14.5 An explicit Turing-complete behavior dialect", "level": 3 }, { "id": "146-why-general-verification-cannot-be-completely-automatic", "anchor": "146-why-general-verification-cannot-be-completely-automatic", "title": "14.6 Why general verification cannot be completely automatic", "level": 3 }, { "id": "147-multiple-meanings-of-time", "anchor": "147-multiple-meanings-of-time", "title": "14.7 Multiple meanings of time", "level": 3 }, { "id": "section-15", "anchor": "section-15", "title": "15. Distributed algorithms behind the execution model", "level": 2 }, { "id": "151-failure-models-are-part-of-the-contract", "anchor": "151-failure-models-are-part-of-the-contract", "title": "15.1 Failure models are part of the contract", "level": 3 }, { "id": "152-causality-and-clocks", "anchor": "152-causality-and-clocks", "title": "15.2 Causality and clocks", "level": 3 }, { "id": "153-safety-liveness-and-impossibility-boundaries", "anchor": "153-safety-liveness-and-impossibility-boundaries", "title": "15.3 Safety, liveness, and impossibility boundaries", "level": 3 }, { "id": "154-linearization-points-and-external-effects", "anchor": "154-linearization-points-and-external-effects", "title": "15.4 Linearization points and external effects", "level": 3 }, { "id": "155-quorums-replicas-and-ownership", "anchor": "155-quorums-replicas-and-ownership", "title": "15.5 Quorums, replicas, and ownership", "level": 3 }, { "id": "156-delivery-identity-effect-identity-and-deduplication", "anchor": "156-delivery-identity-effect-identity-and-deduplication", "title": "15.6 Delivery identity, effect identity, and deduplication", "level": 3 }, { "id": "157-backpressure-and-overload", "anchor": "157-backpressure-and-overload", "title": "15.7 Backpressure and overload", "level": 3 }, { "id": "158-consistency-belongs-to-an-operation-or-datum", "anchor": "158-consistency-belongs-to-an-operation-or-datum", "title": "15.8 Consistency belongs to an operation or datum", "level": 3 } ], "links": [ { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-20", "relation": "references", "sourceAnchor": "87-mathematics-as-an-engineering-interface" }, { "id": "engine-preprint-facsimile", "anchor": "page-22", "relation": "references", "sourceAnchor": "96-behavioral-interpretation" }, { "id": "engine-preprint-facsimile", "anchor": "page-25", "relation": "references", "sourceAnchor": "106-views-are-queries-with-obligations" }, { "id": "engine-preprint-facsimile", "anchor": "page-27", "relation": "references", "sourceAnchor": "115-context-effects-and-failure" }, { "id": "engine-preprint-facsimile", "anchor": "page-30", "relation": "references", "sourceAnchor": "129-compilation-outputs-and-diagnostics" }, { "id": "engine-preprint-facsimile", "anchor": "page-35", "relation": "references", "sourceAnchor": "133-concurrent-editing" }, { "id": "engine-preprint-facsimile", "anchor": "page-36", "relation": "references", "sourceAnchor": "147-multiple-meanings-of-time" }, { "id": "engine-preprint-facsimile", "anchor": "page-39", "relation": "references", "sourceAnchor": "158-consistency-belongs-to-an-operation-or-datum" } ] }, { "id": "engine-preprint-reference", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: references, notation, exercises and source lineage. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 8, "title": "References, notation, exercises and source lineage", "nav": "References, notation, exercises and source lineage", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-reference", "revision": "e04b6a8852529ce9e5fe982a4834cf09d458438f5deb103f6c8088bb1262c435", "status": "design", "renderingRevision": "f9224ec1c9802c8401c1604857b6a377221f474d56fc4f91b94092730d72cb5b", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "references", "A", "B", "C", "D", "E", "F" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-reference", "polarity": "Neutral" }, { "id": "section-section-references", "anchor": "section-references", "label": "References", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#section-references", "polarity": "Neutral" }, { "id": "section-section-A", "anchor": "section-A", "label": "A. Notation and representation interfaces", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#section-A", "polarity": "Neutral" }, { "id": "section-section-B", "anchor": "section-B", "label": "B. Update failure obligations", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#section-B", "polarity": "Neutral" }, { "id": "section-section-C", "anchor": "section-C", "label": "C. Terminology and reading conventions", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#section-C", "polarity": "Neutral" }, { "id": "section-section-D", "anchor": "section-D", "label": "D. Reproducibility of the finite reference model", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#section-D", "polarity": "Neutral" }, { "id": "section-section-E", "anchor": "section-E", "label": "E. Study guide and implementation exercises", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#section-E", "polarity": "Neutral" }, { "id": "section-e12-capstone-and-priorities", "anchor": "e12-capstone-and-priorities", "label": "E.12 Capstone and priorities", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#e12-capstone-and-priorities", "polarity": "Neutral" }, { "id": "section-f3-decisions-that-must-not-be-silently-merged", "anchor": "f3-decisions-that-must-not-be-silently-merged", "label": "F.3 Decisions that must not be silently merged", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-reference#f3-decisions-that-must-not-be-silently-merged", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-reference:references-reaktor-data-implementation", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-architecture-atlas-qualification", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-runtime", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-runtime", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-facsimile-page-98", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "section-section-references", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-98", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-facsimile-page-105", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "section-section-A", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-105", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-facsimile-page-106", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "section-section-B", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-106", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-facsimile-page-107", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "section-section-C", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-107", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-facsimile-page-108", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "section-section-D", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-108", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-facsimile-page-109", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "section-e12-capstone-and-priorities", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-109", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:references-engine-preprint-facsimile-page-112", "kind": "references", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "section-f3-decisions-that-must-not-be-silently-merged", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-112", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:explains-reaktor-data-implementation", "kind": "explains", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-reference:explains-architecture-atlas-qualification", "kind": "explains", "owner": "engine-preprint-reference", "incidences": [ { "node": "engine-preprint-reference", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-qualification", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-reference.json", "sections": [ { "id": "references-notation-exercises-and-source-lineage", "anchor": "references-notation-exercises-and-source-lineage", "title": "References, notation, exercises and source lineage", "level": 1 }, { "id": "section-references", "anchor": "section-references", "title": "References", "level": 2 }, { "id": "section-A", "anchor": "section-A", "title": "A. Notation and representation interfaces", "level": 2 }, { "id": "section-B", "anchor": "section-B", "title": "B. Update failure obligations", "level": 2 }, { "id": "section-C", "anchor": "section-C", "title": "C. Terminology and reading conventions", "level": 2 }, { "id": "section-D", "anchor": "section-D", "title": "D. Reproducibility of the finite reference model", "level": 2 }, { "id": "section-E", "anchor": "section-E", "title": "E. Study guide and implementation exercises", "level": 2 }, { "id": "e1-stage-1-relations-logic-and-proof", "anchor": "e1-stage-1-relations-logic-and-proof", "title": "E.1 Stage 1: relations, logic, and proof", "level": 3 }, { "id": "e2-stage-2-network-representations-and-linear-algebra", "anchor": "e2-stage-2-network-representations-and-linear-algebra", "title": "E.2 Stage 2: network representations and linear algebra", "level": 3 }, { "id": "e3-stage-3-execution-semantics-and-computability", "anchor": "e3-stage-3-execution-semantics-and-computability", "title": "E.3 Stage 3: execution semantics and computability", "level": 3 }, { "id": "e4-stage-4-distributed-algorithms-and-consistency", "anchor": "e4-stage-4-distributed-algorithms-and-consistency", "title": "E.4 Stage 4: distributed algorithms and consistency", "level": 3 }, { "id": "e5-stage-5-specification-and-model-checking", "anchor": "e5-stage-5-specification-and-model-checking", "title": "E.5 Stage 5: specification and model checking", "level": 3 }, { "id": "e6-stage-6-hardware-and-data-oriented-execution", "anchor": "e6-stage-6-hardware-and-data-oriented-execution", "title": "E.6 Stage 6: hardware and data-oriented execution", "level": 3 }, { "id": "e7-stage-7-composition-rewriting-and-extensions", "anchor": "e7-stage-7-composition-rewriting-and-extensions", "title": "E.7 Stage 7: composition, rewriting, and extensions", "level": 3 }, { "id": "e8-stage-8-dynamic-updating-and-recovery", "anchor": "e8-stage-8-dynamic-updating-and-recovery", "title": "E.8 Stage 8: dynamic updating and recovery", "level": 3 }, { "id": "e9-stage-9-system-engineering-data-and-robotics", "anchor": "e9-stage-9-system-engineering-data-and-robotics", "title": "E.9 Stage 9: system engineering, data, and robotics", "level": 3 }, { "id": "e10-stage-10-implementation-proofs-and-humanagent-tools", "anchor": "e10-stage-10-implementation-proofs-and-humanagent-tools", "title": "E.10 Stage 10: implementation proofs and human–agent tools", "level": 3 }, { "id": "e11-an-authoring-and-integration-practicum", "anchor": "e11-an-authoring-and-integration-practicum", "title": "E.11 An authoring and integration practicum", "level": 3 }, { "id": "e12-capstone-and-priorities", "anchor": "e12-capstone-and-priorities", "title": "E.12 Capstone and priorities", "level": 3 }, { "id": "section-F", "anchor": "section-F", "title": "F. Source lineage, maturity, and explicit design decisions", "level": 2 }, { "id": "f1-documentary-baseline", "anchor": "f1-documentary-baseline", "title": "F.1 Documentary baseline", "level": 3 }, { "id": "f2-maturity-interpretation", "anchor": "f2-maturity-interpretation", "title": "F.2 Maturity interpretation", "level": 3 }, { "id": "f3-decisions-that-must-not-be-silently-merged", "anchor": "f3-decisions-that-must-not-be-silently-merged", "title": "F.3 Decisions that must not be silently merged", "level": 3 } ], "links": [ { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "architecture-atlas-qualification", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-98", "relation": "references", "sourceAnchor": "section-references" }, { "id": "engine-preprint-facsimile", "anchor": "page-105", "relation": "references", "sourceAnchor": "section-A" }, { "id": "engine-preprint-facsimile", "anchor": "page-106", "relation": "references", "sourceAnchor": "section-B" }, { "id": "engine-preprint-facsimile", "anchor": "page-107", "relation": "references", "sourceAnchor": "section-C" }, { "id": "engine-preprint-facsimile", "anchor": "page-108", "relation": "references", "sourceAnchor": "section-D" }, { "id": "engine-preprint-facsimile", "anchor": "page-109", "relation": "references", "sourceAnchor": "e12-capstone-and-priorities" }, { "id": "engine-preprint-facsimile", "anchor": "page-112", "relation": "references", "sourceAnchor": "f3-decisions-that-must-not-be-silently-merged" } ] }, { "id": "engine-preprint-runtime", "kind": "design", "owner": "Reaktor Project / BestBuds Ventures", "summary": "September technical preprint: platforms, identity and polyglot execution. Historical design and explicitly scoped evidence.", "use": "Read with current guides. Proposed APIs and abstract results do not establish current implementation.", "region": "engine-preprint-book", "order": 2, "title": "Platforms, identity and polyglot execution", "nav": "Platforms, identity and polyglot execution", "group": "engine-preprint", "subsection": "engine-preprint-book", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-preprint-runtime", "revision": "05df78ef5763b10f714b5a45ac18c68c89d2d5e087931653cdadb12681d9a337", "status": "design", "renderingRevision": "67af8a3e1272577d92ec0ceb116c8e5c7bc722be42386aae42cbdd40d1e20582", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "engine-preprint-2026-09-16", "title": "Reaktor: An Extensible Engine for Applications and Distributed Systems", "date": "2026-09-16", "revision": "04df3284b4765abcdc1035715cd4589abafe041b721f96d07f3861b59a2d895b", "sections": [ "16", "17", "20", "21", "22" ] } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-preprint-runtime", "polarity": "Neutral" }, { "id": "section-section-16", "anchor": "section-16", "label": "16. Platform integration, lifecycle, and adaptive capabilities", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#section-16", "polarity": "Neutral" }, { "id": "section-section-17", "anchor": "section-17", "label": "17. Behavior and distributed execution", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#section-17", "polarity": "Neutral" }, { "id": "section-section-20", "anchor": "section-20", "label": "20. Identity, tenant isolation, secrets, and encrypted communication", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#section-20", "polarity": "Neutral" }, { "id": "section-section-21", "anchor": "section-21", "label": "21. Application protocols: work, mesh, notifications, and entry", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#section-21", "polarity": "Neutral" }, { "id": "section-section-22", "anchor": "section-22", "label": "22. Polyglot execution, Switchboard, and the UI engine", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#section-22", "polarity": "Neutral" }, { "id": "section-source-figure-pages", "anchor": "source-figure-pages", "label": "Source figure pages", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#source-figure-pages", "polarity": "Neutral" }, { "id": "section-164-application-structure-at-a-readable-level", "anchor": "164-application-structure-at-a-readable-level", "label": "16.4 Application structure at a readable level", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#164-application-structure-at-a-readable-level", "polarity": "Neutral" }, { "id": "section-177-local-projections-and-fleet-rollout", "anchor": "177-local-projections-and-fleet-rollout", "label": "17.7 Local projections and fleet rollout", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#177-local-projections-and-fleet-rollout", "polarity": "Neutral" }, { "id": "section-204-mls-and-end-to-end-encrypted-conversations", "anchor": "204-mls-and-end-to-end-encrypted-conversations", "label": "20.4 MLS and end-to-end encrypted conversations", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#204-mls-and-end-to-end-encrypted-conversations", "polarity": "Neutral" }, { "id": "section-215-cross-subsystem-behavior-remains-explicit", "anchor": "215-cross-subsystem-behavior-remains-explicit", "label": "21.5 Cross-subsystem behavior remains explicit", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#215-cross-subsystem-behavior-remains-explicit", "polarity": "Neutral" }, { "id": "section-227-runtime-management-and-replacement-boundaries", "anchor": "227-runtime-management-and-replacement-boundaries", "label": "22.7 Runtime management and replacement boundaries", "profile": "section", "contract": "https://reaktor.build/docs/engine-preprint-runtime#227-runtime-management-and-replacement-boundaries", "polarity": "Neutral" } ], "relations": [ { "id": "engine-preprint-runtime:references-auth-analysis", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-reaktor-ffi", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-reaktor-surface", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-reaktor-work", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-engine", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-engine", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-graph", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-data", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-data", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-delivery", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-evolution", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-assurance", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-assurance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-evaluation", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-reference", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-reference", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-facsimile-page-42", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "section-164-application-structure-at-a-readable-level", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-42", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-facsimile-page-43", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "section-177-local-projections-and-fleet-rollout", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-43", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-facsimile-page-51", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "section-204-mls-and-end-to-end-encrypted-conversations", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-51", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-facsimile-page-53", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "section-215-cross-subsystem-behavior-remains-explicit", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-53", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:references-engine-preprint-facsimile-page-54", "kind": "references", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "section-227-runtime-management-and-replacement-boundaries", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-facsimile", "port": "section-page-54", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:explains-auth-analysis", "kind": "explains", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:explains-reaktor-ffi", "kind": "explains", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:explains-reaktor-surface", "kind": "explains", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-preprint-runtime:explains-reaktor-work", "kind": "explains", "owner": "engine-preprint-runtime", "incidences": [ { "node": "engine-preprint-runtime", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-preprint-runtime.json", "sections": [ { "id": "platforms-identity-and-polyglot-execution", "anchor": "platforms-identity-and-polyglot-execution", "title": "Platforms, identity and polyglot execution", "level": 1 }, { "id": "section-16", "anchor": "section-16", "title": "16. Platform integration, lifecycle, and adaptive capabilities", "level": 2 }, { "id": "161-core-as-the-composition-root-boundary", "anchor": "161-core-as-the-composition-root-boundary", "title": "16.1 Core as the composition-root boundary", "level": 3 }, { "id": "162-host-lifecycle-and-graph-lifecycle", "anchor": "162-host-lifecycle-and-graph-lifecycle", "title": "16.2 Host lifecycle and graph lifecycle", "level": 3 }, { "id": "163-capabilities-describe-conditions-not-permission-alone", "anchor": "163-capabilities-describe-conditions-not-permission-alone", "title": "16.3 Capabilities describe conditions, not permission alone", "level": 3 }, { "id": "164-application-structure-at-a-readable-level", "anchor": "164-application-structure-at-a-readable-level", "title": "16.4 Application structure at a readable level", "level": 3 }, { "id": "section-17", "anchor": "section-17", "title": "17. Behavior and distributed execution", "level": 2 }, { "id": "171-wiring-is-not-scheduling", "anchor": "171-wiring-is-not-scheduling", "title": "17.1 Wiring is not scheduling", "level": 3 }, { "id": "172-actor-behavior-and-exclusive-state", "anchor": "172-actor-behavior-and-exclusive-state", "title": "17.2 Actor behavior and exclusive state", "level": 3 }, { "id": "173-publication-and-competing-delivery", "anchor": "173-publication-and-competing-delivery", "title": "17.3 Publication and competing delivery", "level": 3 }, { "id": "174-streams-state-sessions-and-mesh", "anchor": "174-streams-state-sessions-and-mesh", "title": "17.4 Streams, state, sessions, and mesh", "level": 3 }, { "id": "175-durable-workflows", "anchor": "175-durable-workflows", "title": "17.5 Durable workflows", "level": 3 }, { "id": "176-placement-and-realization", "anchor": "176-placement-and-realization", "title": "17.6 Placement and realization", "level": 3 }, { "id": "177-local-projections-and-fleet-rollout", "anchor": "177-local-projections-and-fleet-rollout", "title": "17.7 Local projections and fleet rollout", "level": 3 }, { "id": "section-20", "anchor": "section-20", "title": "20. Identity, tenant isolation, secrets, and encrypted communication", "level": 2 }, { "id": "201-a-full-stack-authorization-engine", "anchor": "201-a-full-stack-authorization-engine", "title": "20.1 A full-stack authorization engine", "level": 3 }, { "id": "202-tenancy-has-four-independent-obligations", "anchor": "202-tenancy-has-four-independent-obligations", "title": "20.2 Tenancy has four independent obligations", "level": 3 }, { "id": "203-secrets-are-referenced-in-the-graph-and-materialized-at-targets", "anchor": "203-secrets-are-referenced-in-the-graph-and-materialized-at-targets", "title": "20.3 Secrets are referenced in the graph and materialized at targets", "level": 3 }, { "id": "204-mls-and-end-to-end-encrypted-conversations", "anchor": "204-mls-and-end-to-end-encrypted-conversations", "title": "20.4 MLS and end-to-end encrypted conversations", "level": 3 }, { "id": "section-21", "anchor": "section-21", "title": "21. Application protocols: work, mesh, notifications, and entry", "level": 2 }, { "id": "211-background-work-is-not-a-durable-server-workflow", "anchor": "211-background-work-is-not-a-durable-server-workflow", "title": "21.1 Background work is not a durable server workflow", "level": 3 }, { "id": "212-durable-bus-and-live-mesh", "anchor": "212-durable-bus-and-live-mesh", "title": "21.2 Durable bus and live mesh", "level": 3 }, { "id": "213-notifications-as-a-full-stack-feature", "anchor": "213-notifications-as-a-full-stack-feature", "title": "21.3 Notifications as a full-stack feature", "level": 3 }, { "id": "214-external-entry-uses-the-same-route-contract", "anchor": "214-external-entry-uses-the-same-route-contract", "title": "21.4 External entry uses the same route contract", "level": 3 }, { "id": "215-cross-subsystem-behavior-remains-explicit", "anchor": "215-cross-subsystem-behavior-remains-explicit", "title": "21.5 Cross-subsystem behavior remains explicit", "level": 3 }, { "id": "section-22", "anchor": "section-22", "title": "22. Polyglot execution, Switchboard, and the UI engine", "level": 2 }, { "id": "221-execution-domains-and-artifacts", "anchor": "221-execution-domains-and-artifacts", "title": "22.1 Execution domains and artifacts", "level": 3 }, { "id": "222-switchboard-as-a-language-bridge-profile", "anchor": "222-switchboard-as-a-language-bridge-profile", "title": "22.2 Switchboard as a language-bridge profile", "level": 3 }, { "id": "223-frames-schemas-and-ownership", "anchor": "223-frames-schemas-and-ownership", "title": "22.3 Frames, schemas, and ownership", "level": 3 }, { "id": "224-one-ui-vocabulary-several-expert-frontends-and-renderers", "anchor": "224-one-ui-vocabulary-several-expert-frontends-and-renderers", "title": "22.4 One UI vocabulary, several expert frontends and renderers", "level": 3 }, { "id": "225-ownership-events-state-and-navigation", "anchor": "225-ownership-events-state-and-navigation", "title": "22.5 Ownership, events, state, and navigation", "level": 3 }, { "id": "226-tactile-behavior-and-design-system-contracts", "anchor": "226-tactile-behavior-and-design-system-contracts", "title": "22.6 Tactile behavior and design-system contracts", "level": 3 }, { "id": "227-runtime-management-and-replacement-boundaries", "anchor": "227-runtime-management-and-replacement-boundaries", "title": "22.7 Runtime management and replacement boundaries", "level": 3 }, { "id": "source-figure-pages", "anchor": "source-figure-pages", "title": "Source figure pages", "level": 2 }, { "id": "original-figure-page-55", "anchor": "original-figure-page-55", "title": "Original figure page 55", "level": 3 } ], "links": [ { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-engine", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-runtime", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-data", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evolution", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-assurance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-evaluation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-reference", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "engine-preprint-facsimile", "anchor": "page-42", "relation": "references", "sourceAnchor": "164-application-structure-at-a-readable-level" }, { "id": "engine-preprint-facsimile", "anchor": "page-43", "relation": "references", "sourceAnchor": "177-local-projections-and-fleet-rollout" }, { "id": "engine-preprint-facsimile", "anchor": "page-51", "relation": "references", "sourceAnchor": "204-mls-and-end-to-end-encrypted-conversations" }, { "id": "engine-preprint-facsimile", "anchor": "page-53", "relation": "references", "sourceAnchor": "215-cross-subsystem-behavior-remains-explicit" }, { "id": "engine-preprint-facsimile", "anchor": "page-54", "relation": "references", "sourceAnchor": "227-runtime-management-and-replacement-boundaries" } ] }, { "id": "engine-website-implementation-report", "owner": "Codex", "kind": "report", "summary": "KMM engine migration, Kotlin/React website renderer, Compose parity, tests, and graph pain points.", "use": "Use when reviewing what was implemented and what remains.", "region": "background-research", "order": 7, "title": "Engine and Website Implementation Report", "nav": "Engine Report", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/engine-website-implementation-report", "revision": "d948dc92de73a44f749ec2ec66ac4374d8613a8defee353ed429ad1b669c39bc", "status": "historical", "renderingRevision": "8cdf7dd6a741d645a6201d87acfbd3352f6bc29c9c216c37c814138bd0d6e64c", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/engine-website-implementation-report", "polarity": "Neutral" }, { "id": "section-executive-summary", "anchor": "executive-summary", "label": "Executive Summary", "profile": "section", "contract": "https://reaktor.build/docs/engine-website-implementation-report#executive-summary", "polarity": "Neutral" }, { "id": "section-module-shape", "anchor": "module-shape", "label": "Module Shape", "profile": "section", "contract": "https://reaktor.build/docs/engine-website-implementation-report#module-shape", "polarity": "Neutral" }, { "id": "section-shared-kotlin", "anchor": "shared-kotlin", "label": "Shared Kotlin Core", "profile": "section", "contract": "https://reaktor.build/docs/engine-website-implementation-report#shared-kotlin", "polarity": "Neutral" }, { "id": "section-website", "anchor": "website", "label": "Website Renderer", "profile": "section", "contract": "https://reaktor.build/docs/engine-website-implementation-report#website", "polarity": "Neutral" }, { "id": "section-desktop", "anchor": "desktop", "label": "Desktop Engine", "profile": "section", "contract": "https://reaktor.build/docs/engine-website-implementation-report#desktop", "polarity": "Neutral" }, { "id": "section-feature-parity", "anchor": "feature-parity", "label": "Feature Parity", "profile": "section", "contract": "https://reaktor.build/docs/engine-website-implementation-report#feature-parity", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/engine-website-implementation-report#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "engine-website-implementation-report:references-reaktor-architecture-analysis", "kind": "references", "owner": "engine-website-implementation-report", "incidences": [ { "node": "engine-website-implementation-report", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-architecture-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-website-implementation-report:references-reaktor-surface-renderers", "kind": "references", "owner": "engine-website-implementation-report", "incidences": [ { "node": "engine-website-implementation-report", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-website-implementation-report:references-reaktor-graph-migration-plan", "kind": "references", "owner": "engine-website-implementation-report", "incidences": [ { "node": "engine-website-implementation-report", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-website-implementation-report:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "engine-website-implementation-report", "incidences": [ { "node": "engine-website-implementation-report", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-website-implementation-report:references-codex-roadmap", "kind": "references", "owner": "engine-website-implementation-report", "incidences": [ { "node": "engine-website-implementation-report", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "codex-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "engine-website-implementation-report:references-reaktor-visual-language", "kind": "references", "owner": "engine-website-implementation-report", "incidences": [ { "node": "engine-website-implementation-report", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "engine-website-implementation-report.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Engine and Website Implementation Report", "level": 0 }, { "id": "executive-summary", "anchor": "executive-summary", "title": "Executive Summary", "level": 2 }, { "id": "architecture", "anchor": "architecture", "title": "Architecture", "level": 3 }, { "id": "parity", "anchor": "parity", "title": "Parity", "level": 3 }, { "id": "quality", "anchor": "quality", "title": "Quality", "level": 3 }, { "id": "module-shape", "anchor": "module-shape", "title": "Module Shape", "level": 2 }, { "id": "shared-kotlin", "anchor": "shared-kotlin", "title": "Shared Kotlin Core", "level": 2 }, { "id": "workbenchgraph", "anchor": "workbenchgraph", "title": "WorkbenchGraph", "level": 3 }, { "id": "pane-subgraphs", "anchor": "pane-subgraphs", "title": "Pane Subgraphs", "level": 3 }, { "id": "actors-and-interactors", "anchor": "actors-and-interactors", "title": "Actors and Interactors", "level": 3 }, { "id": "fixtures-and-services", "anchor": "fixtures-and-services", "title": "Fixtures and Services", "level": 3 }, { "id": "shared-kotlin-2", "anchor": "shared-kotlin-2", "title": "Common service surface", "level": 3 }, { "id": "website", "anchor": "website", "title": "Website Renderer", "level": 2 }, { "id": "website-2", "anchor": "website-2", "title": "Kotlin/React decomposition", "level": 3 }, { "id": "website-3", "anchor": "website-3", "title": "Website behavior implemented", "level": 3 }, { "id": "desktop", "anchor": "desktop", "title": "Desktop Engine", "level": 2 }, { "id": "visual-system", "anchor": "visual-system", "title": "Visual system", "level": 3 }, { "id": "layout-system", "anchor": "layout-system", "title": "Layout system", "level": 3 }, { "id": "graph-pane", "anchor": "graph-pane", "title": "Graph pane", "level": 3 }, { "id": "devtools", "anchor": "devtools", "title": "DevTools", "level": 3 }, { "id": "feature-parity", "anchor": "feature-parity", "title": "Feature Parity", "level": 2 }, { "id": "tests-performance", "anchor": "tests-performance", "title": "Tests and Performance", "level": 2 }, { "id": "verified-test-commands", "anchor": "verified-test-commands", "title": "Verified test commands", "level": 3 }, { "id": "coverage-added", "anchor": "coverage-added", "title": "Coverage added", "level": 3 }, { "id": "real-vs-mock", "anchor": "real-vs-mock", "title": "Real vs Mock", "level": 2 }, { "id": "pain-points", "anchor": "pain-points", "title": "Pain Points Found", "level": 2 }, { "id": "graph-composition-is-verbose", "anchor": "graph-composition-is-verbose", "title": "Graph composition is verbose", "level": 3 }, { "id": "auto-wire-diagnostics-are-thin", "anchor": "auto-wire-diagnostics-are-thin", "title": "Auto-wire diagnostics are thin", "level": 3 }, { "id": "navigation-needs-a-registry", "anchor": "navigation-needs-a-registry", "title": "Navigation needs a registry", "level": 3 }, { "id": "service-mocks-are-too-manual", "anchor": "service-mocks-are-too-manual", "title": "Service mocks are too manual", "level": 3 }, { "id": "js-bridge-ergonomics-are-still-rough", "anchor": "js-bridge-ergonomics-are-still-rough", "title": "JS bridge ergonomics are still rough", "level": 3 }, { "id": "visual-graph-adapters-are-duplicated", "anchor": "visual-graph-adapters-are-duplicated", "title": "Visual graph adapters are duplicated", "level": 3 }, { "id": "desktop-ui-testing-is-brittle", "anchor": "desktop-ui-testing-is-brittle", "title": "Desktop UI testing is brittle", "level": 3 }, { "id": "realmock-maturity-is-not-first-class", "anchor": "realmock-maturity-is-not-first-class", "title": "Real/mock maturity is not first-class", "level": 3 }, { "id": "graph-enhancements", "anchor": "graph-enhancements", "title": "Reaktor Graph Enhancements", "level": 2 }, { "id": "next-steps", "anchor": "next-steps", "title": "Next Steps", "level": 2 }, { "id": "file-map", "anchor": "file-map", "title": "File Map", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-architecture-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "codex-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Representations, scalar layout, alignment, arithmetic, and safe C++ byte views.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 3, "title": "Part I Bytes and Ownership", "nav": "Part I Bytes and Ownership", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "revision": "7afb323827627d6cf48bd17a420bce3a51c1c9de4e9d20fb68940bbd07b6c9cb", "status": "historical", "renderingRevision": "d2976b8840813c4ca97eda787d5591273732a20f3b07378aba460b69e32c5e08", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "polarity": "Neutral" }, { "id": "section-in-this-part", "anchor": "in-this-part", "label": "In this part", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership#in-this-part", "polarity": "Neutral" }, { "id": "section-chapter-1", "anchor": "chapter-1", "label": "Chapter 1: Two representations, two jobs", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership#chapter-1", "polarity": "Neutral" }, { "id": "section-chapter-2", "anchor": "chapter-2", "label": "Chapter 2: Bytes, alignment, integers, and floating point", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership#chapter-2", "polarity": "Neutral" }, { "id": "section-chapter-3", "anchor": "chapter-3", "label": "Chapter 3: A safe C++ vocabulary for byte formats", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership#chapter-3", "polarity": "Neutral" }, { "id": "section-checkpoint-2", "anchor": "checkpoint-2", "label": "Checkpoint", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership#checkpoint-2", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "section-checkpoint-2", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "section-checkpoint-2", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Part I Bytes and Ownership", "level": 0 }, { "id": "in-this-part", "anchor": "in-this-part", "title": "In this part", "level": 2 }, { "id": "chapter-1", "anchor": "chapter-1", "title": "Chapter 1: Two representations, two jobs", "level": 2 }, { "id": "start-with-an-ordinary-object", "anchor": "start-with-an-ordinary-object", "title": "Start with an ordinary object", "level": 3 }, { "id": "what-zero-copy-does-and-does-not-mean", "anchor": "what-zero-copy-does-and-does-not-mean", "title": "What “zero-copy” does and does not mean", "level": 3 }, { "id": "a-schema-is-information-not-magic", "anchor": "a-schema-is-information-not-magic", "title": "A schema is information, not magic", "level": 3 }, { "id": "wire-compactness-and-mutation-pull-in-different-directions", "anchor": "wire-compactness-and-mutation-pull-in-different-directions", "title": "Wire compactness and mutation pull in different directions", "level": 3 }, { "id": "three-levels-of-compatibility", "anchor": "three-levels-of-compatibility", "title": "Three levels of compatibility", "level": 3 }, { "id": "checkpoint", "anchor": "checkpoint", "title": "Checkpoint", "level": 3 }, { "id": "chapter-2", "anchor": "chapter-2", "title": "Chapter 2: Bytes, alignment, integers, and floating point", "level": 2 }, { "id": "a-byte-position-is-not-an-address", "anchor": "a-byte-position-is-not-an-address", "title": "A byte position is not an address", "level": 3 }, { "id": "little-endian-storage", "anchor": "little-endian-storage", "title": "Little-endian storage", "level": 3 }, { "id": "signed-values-and-sign-extension", "anchor": "signed-values-and-sign-extension", "title": "Signed values and sign extension", "level": 3 }, { "id": "alignment-is-a-layout-constraint-not-a-permission-slip", "anchor": "alignment-is-a-layout-constraint-not-a-permission-slip", "title": "Alignment is a layout constraint, not a permission slip", "level": 3 }, { "id": "floating-point-payloads", "anchor": "floating-point-payloads", "title": "Floating-point payloads", "level": 3 }, { "id": "checkpoint-1", "anchor": "checkpoint-1", "title": "Checkpoint", "level": 3 }, { "id": "chapter-3", "anchor": "chapter-3", "title": "Chapter 3: A safe C++ vocabulary for byte formats", "level": 2 }, { "id": "own-the-allocation-borrow-the-view", "anchor": "own-the-allocation-borrow-the-view", "title": "Own the allocation; borrow the view", "level": 3 }, { "id": "four-layers-of-an-implementation", "anchor": "four-layers-of-an-implementation", "title": "Four layers of an implementation", "level": 3 }, { "id": "a-readable-scalar-load", "anchor": "a-readable-scalar-load", "title": "A readable scalar load", "level": 3 }, { "id": "error-handling-is-part-of-the-format-boundary", "anchor": "error-handling-is-part-of-the-format-boundary", "title": "Error handling is part of the format boundary", "level": 3 }, { "id": "arithmetic-helpers-deserve-their-own-tests", "anchor": "arithmetic-helpers-deserve-their-own-tests", "title": "Arithmetic helpers deserve their own tests", "level": 3 }, { "id": "checkpoint-2", "anchor": "checkpoint-2", "title": "Checkpoint", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "chapter-1", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "chapter-2", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "chapter-3", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-2" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-2" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Tables, vtables, structs, vectors, builders, schema evolution, verification, and constrained mutation.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 4, "title": "Part II FlatBuffers", "nav": "Part II FlatBuffers", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "revision": "15783b307c02b965a52cebb2795f72200528d786014484b46db522caf8f4f50d", "status": "historical", "renderingRevision": "91cecc2c1c0f7581aa0494824f5bbfb73f96cfdaf7896c5968a58de5726a848f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "polarity": "Neutral" }, { "id": "section-in-this-part", "anchor": "in-this-part", "label": "In this part", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#in-this-part", "polarity": "Neutral" }, { "id": "section-chapter-4", "anchor": "chapter-4", "label": "Chapter 4: FlatBuffers: the root, the table, and the vtable", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#chapter-4", "polarity": "Neutral" }, { "id": "section-chapter-5", "anchor": "chapter-5", "label": "Chapter 5: A complete 32-byte FlatBuffer", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#chapter-5", "polarity": "Neutral" }, { "id": "section-chapter-6", "anchor": "chapter-6", "label": "Chapter 6: Structs, vectors, strings, unions, and framing", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#chapter-6", "polarity": "Neutral" }, { "id": "section-chapter-7", "anchor": "chapter-7", "label": "Chapter 7: Reconstructing the FlatBuffers builder", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#chapter-7", "polarity": "Neutral" }, { "id": "section-chapter-8", "anchor": "chapter-8", "label": "Chapter 8: Schema evolution, generated code, and reflection", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#chapter-8", "polarity": "Neutral" }, { "id": "section-chapter-9", "anchor": "chapter-9", "label": "Chapter 9: FlatBuffers verification and the boundary of mutation", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#chapter-9", "polarity": "Neutral" }, { "id": "section-checkpoint-5", "anchor": "checkpoint-5", "label": "Checkpoint", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-02-flatbuffers#checkpoint-5", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-checkpoint-5", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers:references-flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-checkpoint-5", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-checkpoint-5", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Part II FlatBuffers", "level": 0 }, { "id": "in-this-part", "anchor": "in-this-part", "title": "In this part", "level": 2 }, { "id": "chapter-4", "anchor": "chapter-4", "title": "Chapter 4: FlatBuffers: the root, the table, and the vtable", "level": 2 }, { "id": "the-first-reference-points-forward", "anchor": "the-first-reference-points-forward", "title": "The first reference points forward", "level": 3 }, { "id": "a-table-begins-with-a-different-kind-of-offset", "anchor": "a-table-begins-with-a-different-kind-of-offset", "title": "A table begins with a different kind of offset", "level": 3 }, { "id": "finding-a-field-slowly", "anchor": "finding-a-field-slowly", "title": "Finding a field slowly", "level": 3 }, { "id": "why-not-store-fields-in-schema-order", "anchor": "why-not-store-fields-in-schema-order", "title": "Why not store fields in schema order?", "level": 3 }, { "id": "why-16-bit-field-displacements", "anchor": "why-16-bit-field-displacements", "title": "Why 16-bit field displacements?", "level": 3 }, { "id": "checkpoint", "anchor": "checkpoint", "title": "Checkpoint", "level": 3 }, { "id": "chapter-5", "anchor": "chapter-5", "title": "Chapter 5: A complete 32-byte FlatBuffer", "level": 2 }, { "id": "the-schema-and-the-values", "anchor": "the-schema-and-the-values", "title": "The schema and the values", "level": 3 }, { "id": "find-the-count", "anchor": "find-the-count", "title": "Find the count", "level": 3 }, { "id": "find-the-name", "anchor": "find-the-name", "title": "Find the name", "level": 3 }, { "id": "make-the-field-absent-without-moving-anything", "anchor": "make-the-field-absent-without-moving-anything", "title": "Make the field absent without moving anything", "level": 3 }, { "id": "a-negative-displacement-is-valid", "anchor": "a-negative-displacement-is-valid", "title": "A negative displacement is valid", "level": 3 }, { "id": "from-one-table-to-a-real-reader", "anchor": "from-one-table-to-a-real-reader", "title": "From one table to a real reader", "level": 3 }, { "id": "checkpoint-1", "anchor": "checkpoint-1", "title": "Checkpoint", "level": 3 }, { "id": "chapter-6", "anchor": "chapter-6", "title": "Chapter 6: Structs, vectors, strings, unions, and framing", "level": 2 }, { "id": "structs-exchange-flexibility-for-predictable-placement", "anchor": "structs-exchange-flexibility-for-predictable-placement", "title": "Structs exchange flexibility for predictable placement", "level": 3 }, { "id": "vectors-are-contiguous-but-their-elements-may-be-references", "anchor": "vectors-are-contiguous-but-their-elements-may-be-references", "title": "Vectors are contiguous, but their elements may be references", "level": 3 }, { "id": "strings-have-both-a-length-and-a-terminator", "anchor": "strings-have-both-a-length-and-a-terminator", "title": "Strings have both a length and a terminator", "level": 3 }, { "id": "a-union-is-a-discriminator-plus-a-payload", "anchor": "a-union-is-a-discriminator-plus-a-payload", "title": "A union is a discriminator plus a payload", "level": 3 }, { "id": "size-prefixes-and-identifiers-solve-different-problems", "anchor": "size-prefixes-and-identifiers-solve-different-problems", "title": "Size prefixes and identifiers solve different problems", "level": 3 }, { "id": "nested-buffers-are-opaque-until-validated", "anchor": "nested-buffers-are-opaque-until-validated", "title": "Nested buffers are opaque until validated", "level": 3 }, { "id": "checkpoint-2", "anchor": "checkpoint-2", "title": "Checkpoint", "level": 3 }, { "id": "chapter-7", "anchor": "chapter-7", "title": "Chapter 7: Reconstructing the FlatBuffers builder", "level": 2 }, { "id": "why-build-backward", "anchor": "why-build-backward", "title": "Why build backward?", "level": 3 }, { "id": "derive-the-offset-conversion", "anchor": "derive-the-offset-conversion", "title": "Derive the offset conversion", "level": 3 }, { "id": "building-a-table", "anchor": "building-a-table", "title": "Building a table", "level": 3 }, { "id": "why-constructing-children-inside-the-parent-scope-is-discouraged", "anchor": "why-constructing-children-inside-the-parent-scope-is-discouraged", "title": "Why constructing children inside the parent scope is discouraged", "level": 3 }, { "id": "vtable-deduplication", "anchor": "vtable-deduplication", "title": "Vtable deduplication", "level": 3 }, { "id": "finishing-and-ownership", "anchor": "finishing-and-ownership", "title": "Finishing and ownership", "level": 3 }, { "id": "checkpoint-3", "anchor": "checkpoint-3", "title": "Checkpoint", "level": 3 }, { "id": "chapter-8", "anchor": "chapter-8", "title": "Chapter 8: Schema evolution, generated code, and reflection", "level": 2 }, { "id": "evolution-works-because-absence-is-meaningful", "anchor": "evolution-works-because-absence-is-meaningful", "title": "Evolution works because absence is meaningful", "level": 3 }, { "id": "defaults-are-part-of-the-stored-meaning", "anchor": "defaults-are-part-of-the-stored-meaning", "title": "Defaults are part of the stored meaning", "level": 3 }, { "id": "what-generated-code-actually-supplies", "anchor": "what-generated-code-actually-supplies", "title": "What generated code actually supplies", "level": 3 }, { "id": "reflection-moves-schema-information-to-runtime", "anchor": "reflection-moves-schema-information-to-runtime", "title": "Reflection moves schema information to runtime", "level": 3 }, { "id": "test-evolution-in-both-directions", "anchor": "test-evolution-in-both-directions", "title": "Test evolution in both directions", "level": 3 }, { "id": "checkpoint-4", "anchor": "checkpoint-4", "title": "Checkpoint", "level": 3 }, { "id": "chapter-9", "anchor": "chapter-9", "title": "Chapter 9: FlatBuffers verification and the boundary of mutation", "level": 2 }, { "id": "verify-before-trusting-navigation", "anchor": "verify-before-trusting-navigation", "title": "Verify before trusting navigation", "level": 3 }, { "id": "mutation-of-an-existing-scalar", "anchor": "mutation-of-an-existing-scalar", "title": "Mutation of an existing scalar", "level": 3 }, { "id": "length-preserving-edits-are-a-narrow-case", "anchor": "length-preserving-edits-are-a-narrow-case", "title": "Length-preserving edits are a narrow case", "level": 3 }, { "id": "the-modern-64-bit-nuance", "anchor": "the-modern-64-bit-nuance", "title": "The modern 64-bit nuance", "level": 3 }, { "id": "when-flatbuffers-is-the-right-execution-representation", "anchor": "when-flatbuffers-is-the-right-execution-representation", "title": "When FlatBuffers is the right execution representation", "level": 3 }, { "id": "checkpoint-5", "anchor": "checkpoint-5", "title": "Checkpoint", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-4", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-5", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-6", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-7", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-8", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-9", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-5" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-5" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-5" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "The trailer, width solver, strings, vector families, maps, views, builders, mutation, and verification.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 5, "title": "Part III FlexBuffers", "nav": "Part III FlexBuffers", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "revision": "debb6eb15d5d32dae79c42bf5305b5ba642f3400dc07f13f59a2a63d176cb0c8", "status": "historical", "renderingRevision": "7e09477983191bb569207eebf688e89a733dcf0e110ccfdb9ffdca1854891a96", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "polarity": "Neutral" }, { "id": "section-in-this-part", "anchor": "in-this-part", "label": "In this part", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#in-this-part", "polarity": "Neutral" }, { "id": "section-chapter-10", "anchor": "chapter-10", "label": "Chapter 10: FlexBuffers starts at the end", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-10", "polarity": "Neutral" }, { "id": "section-chapter-11", "anchor": "chapter-11", "label": "Chapter 11: Widths are a small layout solver", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-11", "polarity": "Neutral" }, { "id": "section-chapter-12", "anchor": "chapter-12", "label": "Chapter 12: Keys, strings, and blobs are different objects", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-12", "polarity": "Neutral" }, { "id": "section-chapter-13", "anchor": "chapter-13", "label": "Chapter 13: Every vector family, one at a time", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-13", "polarity": "Neutral" }, { "id": "section-chapter-14", "anchor": "chapter-14", "label": "Chapter 14: A map is two coordinated vectors", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-14", "polarity": "Neutral" }, { "id": "section-chapter-15", "anchor": "chapter-15", "label": "Chapter 15: Building a reader as a set of views", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-15", "polarity": "Neutral" }, { "id": "section-chapter-16", "anchor": "chapter-16", "label": "Chapter 16: Building the writer from first principles", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-16", "polarity": "Neutral" }, { "id": "section-chapter-17", "anchor": "chapter-17", "label": "Chapter 17: Mutation, sharing, and why one outlier matters", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-17", "polarity": "Neutral" }, { "id": "section-chapter-18", "anchor": "chapter-18", "label": "Chapter 18: Verification is a small security boundary", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#chapter-18", "polarity": "Neutral" }, { "id": "section-checkpoint-8", "anchor": "checkpoint-8", "label": "Checkpoint", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-03-flexbuffers#checkpoint-8", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-checkpoint-8", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-checkpoint-8", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-checkpoint-8", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Part III FlexBuffers", "level": 0 }, { "id": "in-this-part", "anchor": "in-this-part", "title": "In this part", "level": 2 }, { "id": "chapter-10", "anchor": "chapter-10", "title": "Chapter 10: FlexBuffers starts at the end", "level": 2 }, { "id": "a-three-byte-document", "anchor": "a-three-byte-document", "title": "A three-byte document", "level": 3 }, { "id": "split-the-packed-type", "anchor": "split-the-packed-type", "title": "Split the packed type", "level": 3 }, { "id": "inline-values-and-indirect-values", "anchor": "inline-values-and-indirect-values", "title": "Inline values and indirect values", "level": 3 }, { "id": "why-the-trailer-contains-two-widths-in-disguise", "anchor": "why-the-trailer-contains-two-widths-in-disguise", "title": "Why the trailer contains two widths in disguise", "level": 3 }, { "id": "a-string-root", "anchor": "a-string-root", "title": "A string root", "level": 3 }, { "id": "what-the-trailer-does-not-provide", "anchor": "what-the-trailer-does-not-provide", "title": "What the trailer does not provide", "level": 3 }, { "id": "checkpoint", "anchor": "checkpoint", "title": "Checkpoint", "level": 3 }, { "id": "chapter-11", "anchor": "chapter-11", "title": "Chapter 11: Widths are a small layout solver", "level": 2 }, { "id": "the-four-storage-widths", "anchor": "the-four-storage-widths", "title": "The four storage widths", "level": 3 }, { "id": "a-parent-gives-all-its-slots-one-stride", "anchor": "a-parent-gives-all-its-slots-one-stride", "title": "A parent gives all its slots one stride", "level": 3 }, { "id": "a-full-example-with-different-widths", "anchor": "a-full-example-with-different-widths", "title": "A full example with different widths", "level": 3 }, { "id": "why-distance-depends-on-the-candidate-width", "anchor": "why-distance-depends-on-the-candidate-width", "title": "Why distance depends on the candidate width", "level": 3 }, { "id": "a-simple-global-candidate-algorithm", "anchor": "a-simple-global-candidate-algorithm", "title": "A simple global candidate algorithm", "level": 3 }, { "id": "floats-and-indirect-numeric-values", "anchor": "floats-and-indirect-numeric-values", "title": "Floats and indirect numeric values", "level": 3 }, { "id": "checkpoint-1", "anchor": "checkpoint-1", "title": "Checkpoint", "level": 3 }, { "id": "chapter-12", "anchor": "chapter-12", "title": "Chapter 12: Keys, strings, and blobs are different objects", "level": 2 }, { "id": "a-key-has-no-length-prefix", "anchor": "a-key-has-no-length-prefix", "title": "A key has no length prefix", "level": 3 }, { "id": "a-string-has-a-length-and-a-terminator", "anchor": "a-string-has-a-length-and-a-terminator", "title": "A string has a length and a terminator", "level": 3 }, { "id": "a-blob-is-not-a-typed-byte-vector", "anchor": "a-blob-is-not-a-typed-byte-vector", "title": "A blob is not a typed byte vector", "level": 3 }, { "id": "empty-values-reveal-useful-edge-cases", "anchor": "empty-values-reveal-useful-edge-cases", "title": "Empty values reveal useful edge cases", "level": 3 }, { "id": "pooling-changes-aliasing", "anchor": "pooling-changes-aliasing", "title": "Pooling changes aliasing", "level": 3 }, { "id": "boundaries-and-text-validation", "anchor": "boundaries-and-text-validation", "title": "Boundaries and text validation", "level": 3 }, { "id": "checkpoint-2", "anchor": "checkpoint-2", "title": "Checkpoint", "level": 3 }, { "id": "chapter-13", "anchor": "chapter-13", "title": "Chapter 13: Every vector family, one at a time", "level": 2 }, { "id": "untyped-vectors-carry-a-separate-type-table", "anchor": "untyped-vectors-carry-a-separate-type-table", "title": "Untyped vectors carry a separate type table", "level": 3 }, { "id": "typed-vectors-remove-the-per-element-tags", "anchor": "typed-vectors-remove-the-per-element-tags", "title": "Typed vectors remove the per-element tags", "level": 3 }, { "id": "fixed-typed-vectors-remove-the-count-too", "anchor": "fixed-typed-vectors-remove-the-count-too", "title": "Fixed typed vectors remove the count too", "level": 3 }, { "id": "the-deprecated-typed-string-family", "anchor": "the-deprecated-typed-string-family", "title": "The deprecated typed-string family", "level": 3 }, { "id": "count-width-can-dominate-element-width", "anchor": "count-width-can-dominate-element-width", "title": "Count width can dominate element width", "level": 3 }, { "id": "typed-scans-and-heterogeneous-discovery", "anchor": "typed-scans-and-heterogeneous-discovery", "title": "Typed scans and heterogeneous discovery", "level": 3 }, { "id": "checkpoint-3", "anchor": "checkpoint-3", "title": "Checkpoint", "level": 3 }, { "id": "chapter-14", "anchor": "chapter-14", "title": "Chapter 14: A map is two coordinated vectors", "level": 2 }, { "id": "begin-with-sorted-keys", "anchor": "begin-with-sorted-keys", "title": "Begin with sorted keys", "level": 3 }, { "id": "the-map-prefix", "anchor": "the-map-prefix", "title": "The map prefix", "level": 3 }, { "id": "decode-a-complete-map", "anchor": "decode-a-complete-map", "title": "Decode a complete map", "level": 3 }, { "id": "key-width-and-value-width-need-not-match", "anchor": "key-width-and-value-width-need-not-match", "title": "Key width and value width need not match", "level": 3 }, { "id": "duplicate-keys-and-absent-values", "anchor": "duplicate-keys-and-absent-values", "title": "Duplicate keys and absent values", "level": 3 }, { "id": "sharing-key-vectors", "anchor": "sharing-key-vectors", "title": "Sharing key vectors", "level": 3 }, { "id": "checkpoint-4", "anchor": "checkpoint-4", "title": "Checkpoint", "level": 3 }, { "id": "chapter-15", "anchor": "chapter-15", "title": "Chapter 15: Building a reader as a set of views", "level": 2 }, { "id": "the-reference-object-is-not-the-wire-object", "anchor": "the-reference-object-is-not-the-wire-object", "title": "The reference object is not the wire object", "level": 3 }, { "id": "scalar-accessors-should-make-conversion-policy-explicit", "anchor": "scalar-accessors-should-make-conversion-policy-explicit", "title": "Scalar accessors should make conversion policy explicit", "level": 3 }, { "id": "container-access-is-mostly-arithmetic", "anchor": "container-access-is-mostly-arithmetic", "title": "Container access is mostly arithmetic", "level": 3 }, { "id": "map-lookup-is-an-indexed-relationship", "anchor": "map-lookup-is-an-indexed-relationship", "title": "Map lookup is an indexed relationship", "level": 3 }, { "id": "do-not-let-convenience-hide-ownership", "anchor": "do-not-let-convenience-hide-ownership", "title": "Do not let convenience hide ownership", "level": 3 }, { "id": "a-trusted-fast-path-is-a-different-contract", "anchor": "a-trusted-fast-path-is-a-different-contract", "title": "A trusted fast path is a different contract", "level": 3 }, { "id": "checkpoint-5", "anchor": "checkpoint-5", "title": "Checkpoint", "level": 3 }, { "id": "chapter-16", "anchor": "chapter-16", "title": "Chapter 16: Building the writer from first principles", "level": 2 }, { "id": "store-construction-descriptors-not-unstable-pointers", "anchor": "store-construction-descriptors-not-unstable-pointers", "title": "Store construction descriptors, not unstable pointers", "level": 3 }, { "id": "emit-children-eagerly", "anchor": "emit-children-eagerly", "title": "Emit children eagerly", "level": 3 }, { "id": "close-a-vector-in-two-phases", "anchor": "close-a-vector-in-two-phases", "title": "Close a vector in two phases", "level": 3 }, { "id": "close-a-map-without-losing-associations", "anchor": "close-a-map-without-losing-associations", "title": "Close a map without losing associations", "level": 3 }, { "id": "finish-the-document", "anchor": "finish-the-document", "title": "Finish the document", "level": 3 }, { "id": "exception-and-allocation-behavior", "anchor": "exception-and-allocation-behavior", "title": "Exception and allocation behavior", "level": 3 }, { "id": "checkpoint-6", "anchor": "checkpoint-6", "title": "Checkpoint", "level": 3 }, { "id": "chapter-17", "anchor": "chapter-17", "title": "Chapter 17: Mutation, sharing, and why one outlier matters", "level": 2 }, { "id": "what-the-official-mutation-methods-can-do", "anchor": "what-the-official-mutation-methods-can-do", "title": "What the official mutation methods can do", "level": 3 }, { "id": "the-scalar-outlier-example", "anchor": "the-scalar-outlier-example", "title": "The scalar outlier example", "level": 3 }, { "id": "derive-the-approximate-trade-off", "anchor": "derive-the-approximate-trade-off", "title": "Derive the approximate trade-off", "level": 3 }, { "id": "reserving-width-is-not-reserving-arbitrary-capacity", "anchor": "reserving-width-is-not-reserving-arbitrary-capacity", "title": "Reserving width is not reserving arbitrary capacity", "level": 3 }, { "id": "moving-bytes-changes-some-offsets-not-all", "anchor": "moving-bytes-changes-some-offsets-not-all", "title": "Moving bytes changes some offsets, not all", "level": 3 }, { "id": "aliases-make-mutation-observable-elsewhere", "anchor": "aliases-make-mutation-observable-elsewhere", "title": "Aliases make mutation observable elsewhere", "level": 3 }, { "id": "checkpoint-7", "anchor": "checkpoint-7", "title": "Checkpoint", "level": 3 }, { "id": "chapter-18", "anchor": "chapter-18", "title": "Chapter 18: Verification is a small security boundary", "level": 2 }, { "id": "begin-with-the-threat-model", "anchor": "begin-with-the-threat-model", "title": "Begin with the threat model", "level": 3 }, { "id": "the-order-of-checks-matters", "anchor": "the-order-of-checks-matters", "title": "The order of checks matters", "level": 3 }, { "id": "structural-verification-versus-a-strict-application-profile", "anchor": "structural-verification-versus-a-strict-application-profile", "title": "Structural verification versus a strict application profile", "level": 3 }, { "id": "budgets-are-correctness-features", "anchor": "budgets-are-correctness-features", "title": "Budgets are correctness features", "level": 3 }, { "id": "sharing-and-memoization", "anchor": "sharing-and-memoization", "title": "Sharing and memoization", "level": 3 }, { "id": "verification-has-a-lifetime", "anchor": "verification-has-a-lifetime", "title": "Verification has a lifetime", "level": 3 }, { "id": "checkpoint-8", "anchor": "checkpoint-8", "title": "Checkpoint", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-10", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-11", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-12", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-13", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-14", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-15", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-16", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-17", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-18", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-8" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-8" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-8" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Interoperability, hardware, language boundaries, workload-normalized benchmarks, and earned optimizations.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 6, "title": "Part IV Quality and Performance", "nav": "Part IV Quality and Performance", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "revision": "1f25a7f84662b864791eecc7b7e03bd112fc8bade9314e7cf3fa186d45427f99", "status": "historical", "renderingRevision": "e606ae53ab1095d8fa5fb650305687e066118a52f8379fa80e15d17b6e7ccbdf", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "polarity": "Neutral" }, { "id": "section-in-this-part", "anchor": "in-this-part", "label": "In this part", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance#in-this-part", "polarity": "Neutral" }, { "id": "section-chapter-19", "anchor": "chapter-19", "label": "Chapter 19: What “close to official quality” actually requires", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance#chapter-19", "polarity": "Neutral" }, { "id": "section-chapter-20", "anchor": "chapter-20", "label": "Chapter 20: Hardware-aware optimization without unsafe shortcuts", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance#chapter-20", "polarity": "Neutral" }, { "id": "section-chapter-21", "anchor": "chapter-21", "label": "Chapter 21: What modern languages help with—and what they do not", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance#chapter-21", "polarity": "Neutral" }, { "id": "section-chapter-22", "anchor": "chapter-22", "label": "Chapter 22: Benchmark the workload, not the advertisement", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance#chapter-22", "polarity": "Neutral" }, { "id": "section-chapter-23", "anchor": "chapter-23", "label": "Chapter 23: Optimizations worth earning", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance#chapter-23", "polarity": "Neutral" }, { "id": "section-checkpoint-4", "anchor": "checkpoint-4", "label": "Checkpoint", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance#checkpoint-4", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-checkpoint-4", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-checkpoint-4", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-checkpoint-4", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Part IV Quality and Performance", "level": 0 }, { "id": "in-this-part", "anchor": "in-this-part", "title": "In this part", "level": 2 }, { "id": "chapter-19", "anchor": "chapter-19", "title": "Chapter 19: What “close to official quality” actually requires", "level": 2 }, { "id": "correct-output-is-only-the-first-gate", "anchor": "correct-output-is-only-the-first-gate", "title": "Correct output is only the first gate", "level": 3 }, { "id": "test-categories-that-catch-different-mistakes", "anchor": "test-categories-that-catch-different-mistakes", "title": "Test categories that catch different mistakes", "level": 3 }, { "id": "build-an-interoperability-matrix", "anchor": "build-an-interoperability-matrix", "title": "Build an interoperability matrix", "level": 3 }, { "id": "sanitizers-and-coverage-guided-fuzzing", "anchor": "sanitizers-and-coverage-guided-fuzzing", "title": "Sanitizers and coverage-guided fuzzing", "level": 3 }, { "id": "stateful-testing-for-the-mutable-engine", "anchor": "stateful-testing-for-the-mutable-engine", "title": "Stateful testing for the mutable engine", "level": 3 }, { "id": "the-actual-receipt-for-this-edition", "anchor": "the-actual-receipt-for-this-edition", "title": "The actual receipt for this edition", "level": 3 }, { "id": "checkpoint", "anchor": "checkpoint", "title": "Checkpoint", "level": 3 }, { "id": "chapter-20", "anchor": "chapter-20", "title": "Chapter 20: Hardware-aware optimization without unsafe shortcuts", "level": 2 }, { "id": "count-bytes-dependencies-and-work", "anchor": "count-bytes-dependencies-and-work", "title": "Count bytes, dependencies, and work", "level": 3 }, { "id": "compression-can-beat-native-convenience", "anchor": "compression-can-beat-native-convenience", "title": "Compression can beat native convenience", "level": 3 }, { "id": "specialize-outside-the-loop", "anchor": "specialize-outside-the-loop", "title": "Specialize outside the loop", "level": 3 }, { "id": "simd-is-particularly-useful-for-metadata", "anchor": "simd-is-particularly-useful-for-metadata", "title": "SIMD is particularly useful for metadata", "level": 3 }, { "id": "prefetching-and-batching", "anchor": "prefetching-and-batching", "title": "Prefetching and batching", "level": 3 }, { "id": "allocation-locality-and-false-sharing", "anchor": "allocation-locality-and-false-sharing", "title": "Allocation, locality, and false sharing", "level": 3 }, { "id": "checkpoint-1", "anchor": "checkpoint-1", "title": "Checkpoint", "level": 3 }, { "id": "chapter-21", "anchor": "chapter-21", "title": "Chapter 21: What modern languages help with—and what they do not", "level": 2 }, { "id": "c20-is-enough-for-the-core", "anchor": "c20-is-enough-for-the-core", "title": "C++20 is enough for the core", "level": 3 }, { "id": "allocation-resources-are-policy-hooks", "anchor": "allocation-resources-are-policy-hooks", "title": "Allocation resources are policy hooks", "level": 3 }, { "id": "rust-changes-how-borrowing-is-expressed", "anchor": "rust-changes-how-borrowing-is-expressed", "title": "Rust changes how borrowing is expressed", "level": 3 }, { "id": "managed-runtimes-still-need-an-ownership-boundary", "anchor": "managed-runtimes-still-need-an-ownership-boundary", "title": "Managed runtimes still need an ownership boundary", "level": 3 }, { "id": "javascript-has-a-numeric-distinction-you-must-preserve", "anchor": "javascript-has-a-numeric-distinction-you-must-preserve", "title": "JavaScript has a numeric distinction you must preserve", "level": 3 }, { "id": "bindings-should-expose-bulk-capabilities", "anchor": "bindings-should-expose-bulk-capabilities", "title": "Bindings should expose bulk capabilities", "level": 3 }, { "id": "checkpoint-2", "anchor": "checkpoint-2", "title": "Checkpoint", "level": 3 }, { "id": "chapter-22", "anchor": "chapter-22", "title": "Chapter 22: Benchmark the workload, not the advertisement", "level": 2 }, { "id": "start-with-comparable-semantics", "anchor": "start-with-comparable-semantics", "title": "Start with comparable semantics", "level": 3 }, { "id": "a-concrete-workload-matrix", "anchor": "a-concrete-workload-matrix", "title": "A concrete workload matrix", "level": 3 }, { "id": "measure-the-full-cost-ledger", "anchor": "measure-the-full-cost-ledger", "title": "Measure the full cost ledger", "level": 3 }, { "id": "prevent-common-measurement-errors", "anchor": "prevent-common-measurement-errors", "title": "Prevent common measurement errors", "level": 3 }, { "id": "use-counters-to-explain-not-decorate", "anchor": "use-counters-to-explain-not-decorate", "title": "Use counters to explain, not decorate", "level": 3 }, { "id": "a-simple-amortization-equation", "anchor": "a-simple-amortization-equation", "title": "A simple amortization equation", "level": 3 }, { "id": "checkpoint-3", "anchor": "checkpoint-3", "title": "Checkpoint", "level": 3 }, { "id": "chapter-23", "anchor": "chapter-23", "title": "Chapter 23: Optimizations worth earning", "level": 2 }, { "id": "improve-the-representation-before-the-instruction", "anchor": "improve-the-representation-before-the-instruction", "title": "Improve the representation before the instruction", "level": 3 }, { "id": "runtime-shapes-do-not-require-a-declared-schema", "anchor": "runtime-shapes-do-not-require-a-declared-schema", "title": "Runtime shapes do not require a declared schema", "level": 3 }, { "id": "cache-a-path-only-with-its-assumptions", "anchor": "cache-a-path-only-with-its-assumptions", "title": "Cache a path only with its assumptions", "level": 3 }, { "id": "avoid-premature-universal-compression", "anchor": "avoid-premature-universal-compression", "title": "Avoid premature universal compression", "level": 3 }, { "id": "make-every-optimization-reversible", "anchor": "make-every-optimization-reversible", "title": "Make every optimization reversible", "level": 3 }, { "id": "checkpoint-4", "anchor": "checkpoint-4", "title": "Checkpoint", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-19", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-20", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-21", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-22", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-23", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-4" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-4" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-4" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Compatibility, cells, descriptors, allocation, reclamation, containers, transactions, snapshots, and staged delivery.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 7, "title": "Part V LiveFlex Mutable Memory", "nav": "Part V LiveFlex Mutable Memory", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "revision": "f2ecfe2675fd4e21923da5c950a0ca3aec50e39da60e87ccc1ff4b14627c2cd0", "status": "historical", "renderingRevision": "fc2c34409de6af0c9cba51aa02997cd2a255c9d0154c7398abcfd9c2835a5ea1", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [ "the-engine-we-are-designing" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "polarity": "Neutral" }, { "id": "section-in-this-part", "anchor": "in-this-part", "label": "In this part", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#in-this-part", "polarity": "Neutral" }, { "id": "section-chapter-24", "anchor": "chapter-24", "label": "Chapter 24: Capstone: choose the compatibility contract first", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#chapter-24", "polarity": "Neutral" }, { "id": "section-chapter-25", "anchor": "chapter-25", "label": "Chapter 25: The 16-byte cell and the 32-byte descriptor", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#chapter-25", "polarity": "Neutral" }, { "id": "section-chapter-26", "anchor": "chapter-26", "label": "Chapter 26: Allocation, roots, reclamation, and compaction", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#chapter-26", "polarity": "Neutral" }, { "id": "section-chapter-27", "anchor": "chapter-27", "label": "Chapter 27: Fast containers without a declared schema", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#chapter-27", "polarity": "Neutral" }, { "id": "section-chapter-28", "anchor": "chapter-28", "label": "Chapter 28: Transactions, borrows, and concurrent snapshots", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#chapter-28", "polarity": "Neutral" }, { "id": "section-chapter-29", "anchor": "chapter-29", "label": "Chapter 29: Freeze and thaw without changing the standard", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#chapter-29", "polarity": "Neutral" }, { "id": "section-chapter-30", "anchor": "chapter-30", "label": "Chapter 30: Build the capstone in stages, then earn its speed", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#chapter-30", "polarity": "Neutral" }, { "id": "section-checkpoint-6", "anchor": "checkpoint-6", "label": "Checkpoint", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-05-mutable-memory#checkpoint-6", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-checkpoint-6", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-checkpoint-6", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-checkpoint-6", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Part V LiveFlex Mutable Memory", "level": 0 }, { "id": "in-this-part", "anchor": "in-this-part", "title": "In this part", "level": 2 }, { "id": "chapter-24", "anchor": "chapter-24", "title": "Chapter 24: Capstone: choose the compatibility contract first", "level": 2 }, { "id": "mutable-memory-engine-design", "anchor": "mutable-memory-engine-design", "title": "Mutable-memory engine design", "level": 3 }, { "id": "what-compatible-means-here", "anchor": "what-compatible-means-here", "title": "What compatible means here", "level": 3 }, { "id": "why-not-just-add-capacity-to-a-flexbuffer", "anchor": "why-not-just-add-capacity-to-a-flexbuffer", "title": "Why not just add capacity to a FlexBuffer?", "level": 3 }, { "id": "a-genuine-continuously-compatible-alternative-an-append-log", "anchor": "a-genuine-continuously-compatible-alternative-an-append-log", "title": "A genuine continuously compatible alternative: an append log", "level": 3 }, { "id": "the-non-goals-keep-the-design-small", "anchor": "the-non-goals-keep-the-design-small", "title": "The non-goals keep the design small", "level": 3 }, { "id": "a-proposed-public-surface", "anchor": "a-proposed-public-surface", "title": "A proposed public surface", "level": 3 }, { "id": "checkpoint", "anchor": "checkpoint", "title": "Checkpoint", "level": 3 }, { "id": "chapter-25", "anchor": "chapter-25", "title": "Chapter 25: The 16-byte cell and the 32-byte descriptor", "level": 2 }, { "id": "keep-ordinary-scalars-inline", "anchor": "keep-ordinary-scalars-inline", "title": "Keep ordinary scalars inline", "level": 3 }, { "id": "short-text-uses-the-otherwise-available-bytes", "anchor": "short-text-uses-the-otherwise-available-bytes", "title": "Short text uses the otherwise available bytes", "level": 3 }, { "id": "external-values-use-generational-handles", "anchor": "external-values-use-generational-handles", "title": "External values use generational handles", "level": 3 }, { "id": "the-proposed-descriptor", "anchor": "the-proposed-descriptor", "title": "The proposed descriptor", "level": 3 }, { "id": "stable-descriptors-movable-payloads", "anchor": "stable-descriptors-movable-payloads", "title": "Stable descriptors, movable payloads", "level": 3 }, { "id": "account-for-memory-honestly", "anchor": "account-for-memory-honestly", "title": "Account for memory honestly", "level": 3 }, { "id": "checkpoint-1", "anchor": "checkpoint-1", "title": "Checkpoint", "level": 3 }, { "id": "chapter-26", "anchor": "chapter-26", "title": "Chapter 26: Allocation, roots, reclamation, and compaction", "level": 2 }, { "id": "separate-descriptor-storage-from-payload-storage", "anchor": "separate-descriptor-storage-from-payload-storage", "title": "Separate descriptor storage from payload storage", "level": 3 }, { "id": "use-different-allocation-policies-for-different-lifetimes", "anchor": "use-different-allocation-policies-for-different-lifetimes", "title": "Use different allocation policies for different lifetimes", "level": 3 }, { "id": "allocation-must-precede-publication", "anchor": "allocation-must-precede-publication", "title": "Allocation must precede publication", "level": 3 }, { "id": "a-copied-cell-is-not-automatically-a-root", "anchor": "a-copied-cell-is-not-automatically-a-root", "title": "A copied cell is not automatically a root", "level": 3 }, { "id": "mark-and-sweep-with-generations", "anchor": "mark-and-sweep-with-generations", "title": "Mark and sweep with generations", "level": 3 }, { "id": "cycle-policy-and-collection-policy-are-different", "anchor": "cycle-policy-and-collection-policy-are-different", "title": "Cycle policy and collection policy are different", "level": 3 }, { "id": "compaction-without-changing-handles", "anchor": "compaction-without-changing-handles", "title": "Compaction without changing handles", "level": 3 }, { "id": "checkpoint-2", "anchor": "checkpoint-2", "title": "Checkpoint", "level": 3 }, { "id": "chapter-27", "anchor": "chapter-27", "title": "Chapter 27: Fast containers without a declared schema", "level": 2 }, { "id": "generic-vectors-are-the-baseline", "anchor": "generic-vectors-are-the-baseline", "title": "Generic vectors are the baseline", "level": 3 }, { "id": "homogeneity-can-be-discovered-at-runtime", "anchor": "homogeneity-can-be-discovered-at-runtime", "title": "Homogeneity can be discovered at runtime", "level": 3 }, { "id": "a-bulk-borrow-resolves-once", "anchor": "a-bulk-borrow-resolves-once", "title": "A bulk borrow resolves once", "level": 3 }, { "id": "tiny-maps-should-not-pay-for-a-large-index", "anchor": "tiny-maps-should-not-pay-for-a-large-index", "title": "Tiny maps should not pay for a large index", "level": 3 }, { "id": "a-concrete-group-probed-hash-map-design", "anchor": "a-concrete-group-probed-hash-map-design", "title": "A concrete group-probed hash-map design", "level": 3 }, { "id": "rehashing-is-a-staged-operation", "anchor": "rehashing-is-a-staged-operation", "title": "Rehashing is a staged operation", "level": 3 }, { "id": "intern-keys-once-but-bound-the-interner", "anchor": "intern-keys-once-but-bound-the-interner", "title": "Intern keys once, but bound the interner", "level": 3 }, { "id": "strings-and-blobs-use-replacement-semantics-initially", "anchor": "strings-and-blobs-use-replacement-semantics-initially", "title": "Strings and blobs use replacement semantics initially", "level": 3 }, { "id": "checkpoint-3", "anchor": "checkpoint-3", "title": "Checkpoint", "level": 3 }, { "id": "chapter-28", "anchor": "chapter-28", "title": "Chapter 28: Transactions, borrows, and concurrent snapshots", "level": 2 }, { "id": "start-with-one-mutable-owner", "anchor": "start-with-one-mutable-owner", "title": "Start with one mutable owner", "level": 3 }, { "id": "single-operation-safety-before-transactions", "anchor": "single-operation-safety-before-transactions", "title": "Single-operation safety before transactions", "level": 3 }, { "id": "a-practical-commit-protocol", "anchor": "a-practical-commit-protocol", "title": "A practical commit protocol", "level": 3 }, { "id": "publish-immutable-wire-snapshots-first", "anchor": "publish-immutable-wire-snapshots-first", "title": "Publish immutable wire snapshots first", "level": 3 }, { "id": "why-a-naive-seqlock-is-not-enough-in-c", "anchor": "why-a-naive-seqlock-is-not-enough-in-c", "title": "Why a naive seqlock is not enough in C++", "level": 3 }, { "id": "native-copy-on-write-snapshots-need-versioned-resolution", "anchor": "native-copy-on-write-snapshots-need-versioned-resolution", "title": "Native copy-on-write snapshots need versioned resolution", "level": 3 }, { "id": "reclamation-and-latency", "anchor": "reclamation-and-latency", "title": "Reclamation and latency", "level": 3 }, { "id": "checkpoint-4", "anchor": "checkpoint-4", "title": "Checkpoint", "level": 3 }, { "id": "chapter-29", "anchor": "chapter-29", "title": "Chapter 29: Freeze and thaw without changing the standard", "level": 2 }, { "id": "define-semantic-equivalence-first", "anchor": "define-semantic-equivalence-first", "title": "Define semantic equivalence first", "level": 3 }, { "id": "postorder-emission", "anchor": "postorder-emission", "title": "Postorder emission", "level": 3 }, { "id": "native-map-order-is-not-wire-map-order", "anchor": "native-map-order-is-not-wire-map-order", "title": "Native map order is not wire map order", "level": 3 }, { "id": "typed-arrays-and-width-selection", "anchor": "typed-arrays-and-width-selection", "title": "Typed arrays and width selection", "level": 3 }, { "id": "thawing-should-not-confuse-values-with-identities", "anchor": "thawing-should-not-confuse-values-with-identities", "title": "Thawing should not confuse values with identities", "level": 3 }, { "id": "incremental-export-is-not-automatically-zero-copy", "anchor": "incremental-export-is-not-automatically-zero-copy", "title": "Incremental export is not automatically zero-copy", "level": 3 }, { "id": "verification-at-the-export-boundary", "anchor": "verification-at-the-export-boundary", "title": "Verification at the export boundary", "level": 3 }, { "id": "checkpoint-5", "anchor": "checkpoint-5", "title": "Checkpoint", "level": 3 }, { "id": "chapter-30", "anchor": "chapter-30", "title": "Chapter 30: Build the capstone in stages, then earn its speed", "level": 2 }, { "id": "run-the-supplied-laboratory", "anchor": "run-the-supplied-laboratory", "title": "Run the supplied laboratory", "level": 3 }, { "id": "read-the-three-core-files-in-order", "anchor": "read-the-three-core-files-in-order", "title": "Read the three core files in order", "level": 3 }, { "id": "what-is-implemented-and-what-is-proposed", "anchor": "what-is-implemented-and-what-is-proposed", "title": "What is implemented and what is proposed", "level": 3 }, { "id": "stage-one-qualify-the-wire-layer", "anchor": "stage-one-qualify-the-wire-layer", "title": "Stage one: qualify the wire layer", "level": 3 }, { "id": "stage-two-replace-one-storage-component-at-a-time", "anchor": "stage-two-replace-one-storage-component-at-a-time", "title": "Stage two: replace one storage component at a time", "level": 3 }, { "id": "stage-three-add-only-required-ownership-features", "anchor": "stage-three-add-only-required-ownership-features", "title": "Stage three: add only required ownership features", "level": 3 }, { "id": "stage-four-establish-the-performance-frontier", "anchor": "stage-four-establish-the-performance-frontier", "title": "Stage four: establish the performance frontier", "level": 3 }, { "id": "the-final-mental-model", "anchor": "the-final-mental-model", "title": "The final mental model", "level": 3 }, { "id": "checkpoint-6", "anchor": "checkpoint-6", "title": "Checkpoint", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-24", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-25", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-26", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-27", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-28", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-29", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-30", "relation": "references", "sourceAnchor": "in-this-part" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-6" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-6" }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "anchor": "", "relation": "references", "sourceAnchor": "checkpoint-6" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Type Codes and Byte Equations from the complete supplied first edition.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 8, "title": "Appendix A Type Codes and Byte Equations", "nav": "Appendix A Type Codes and Byte Equations", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "revision": "6445bf61a76ef083d997b79c959b355cd6d0c63fa45ab1e109a244c212ecf85b", "status": "historical", "renderingRevision": "7e6ec092a53978e31cca5e14c989b33cf618e6145585ee549229f8c55d7a7e66", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "polarity": "Neutral" }, { "id": "section-appendix-a", "anchor": "appendix-a", "label": "Appendix A: Type codes and byte equations", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-06-appendix-a#appendix-a", "polarity": "Neutral" }, { "id": "section-small-golden-buffers", "anchor": "small-golden-buffers", "label": "Small golden buffers", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-06-appendix-a#small-golden-buffers", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "section-small-golden-buffers", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "section-small-golden-buffers", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a:references-flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "section-small-golden-buffers", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Appendix A Type Codes and Byte Equations", "level": 0 }, { "id": "appendix-a", "anchor": "appendix-a", "title": "Appendix A: Type codes and byte equations", "level": 2 }, { "id": "complete-flexbuffers-type-table-for-this-edition", "anchor": "complete-flexbuffers-type-table-for-this-edition", "title": "Complete FlexBuffers type table for this edition", "level": 3 }, { "id": "the-equations-worth-memorizing", "anchor": "the-equations-worth-memorizing", "title": "The equations worth memorizing", "level": 3 }, { "id": "small-golden-buffers", "anchor": "small-golden-buffers", "title": "Small golden buffers", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "small-golden-buffers" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "small-golden-buffers" }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "anchor": "", "relation": "references", "sourceAnchor": "small-golden-buffers" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Exercise Solutions and Implementation Hints from the complete supplied first edition.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 9, "title": "Appendix B Exercise Solutions and Implementation Hints", "nav": "Appendix B Exercise Solutions and Implementation Hints", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "revision": "345eabf8ad9244c49debe2087c6aecf93006ac16657323607bc936ababc0488b", "status": "historical", "renderingRevision": "9450956a7cd4fcf0def7b22c78ee81c462e193f409d2b39cb2e1f06868f33e11", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "polarity": "Neutral" }, { "id": "section-appendix-b", "anchor": "appendix-b", "label": "Appendix B: Exercise solutions and implementation hints", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-07-appendix-b#appendix-b", "polarity": "Neutral" }, { "id": "section-solutions-2632-the-capstone", "anchor": "solutions-2632-the-capstone", "label": "Solutions 26–32: the capstone", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-07-appendix-b#solutions-2632-the-capstone", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "section-solutions-2632-the-capstone", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b:references-flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "section-solutions-2632-the-capstone", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b:references-flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "section-solutions-2632-the-capstone", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Appendix B Exercise Solutions and Implementation Hints", "level": 0 }, { "id": "appendix-b", "anchor": "appendix-b", "title": "Appendix B: Exercise solutions and implementation hints", "level": 2 }, { "id": "solutions-14-foundations", "anchor": "solutions-14-foundations", "title": "Solutions 1–4: foundations", "level": 3 }, { "id": "solutions-510-flatbuffers", "anchor": "solutions-510-flatbuffers", "title": "Solutions 5–10: FlatBuffers", "level": 3 }, { "id": "solutions-1115-flexbuffers-primitives-and-vectors", "anchor": "solutions-1115-flexbuffers-primitives-and-vectors", "title": "Solutions 11–15: FlexBuffers primitives and vectors", "level": 3 }, { "id": "solutions-1620-maps-builders-mutation-verification", "anchor": "solutions-1620-maps-builders-mutation-verification", "title": "Solutions 16–20: maps, builders, mutation, verification", "level": 3 }, { "id": "solutions-2125-engineering", "anchor": "solutions-2125-engineering", "title": "Solutions 21–25: engineering", "level": 3 }, { "id": "solutions-2632-the-capstone", "anchor": "solutions-2632-the-capstone", "title": "Solutions 26–32: the capstone", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "solutions-2632-the-capstone" }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "anchor": "", "relation": "references", "sourceAnchor": "solutions-2632-the-capstone" }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "anchor": "", "relation": "references", "sourceAnchor": "solutions-2632-the-capstone" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Reading the Official Implementation from the complete supplied first edition.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 10, "title": "Appendix C Reading the Official Implementation", "nav": "Appendix C Reading the Official Implementation", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "revision": "bf2fb4d163834ce97c1ccc7e47934d86e53b817dfd1af7e85aef07cc3b4c90d3", "status": "historical", "renderingRevision": "e4ffcc839044a4eacf3d55dbb23893e8472a0df74b77563a4c432c3bd1abaf53", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "polarity": "Neutral" }, { "id": "section-appendix-c", "anchor": "appendix-c", "label": "Appendix C: Reading the official implementation", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-08-appendix-c#appendix-c", "polarity": "Neutral" }, { "id": "section-source-listings-and-reproducibility", "anchor": "source-listings-and-reproducibility", "label": "Source listings and reproducibility", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-08-appendix-c#source-listings-and-reproducibility", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "section-source-listings-and-reproducibility", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c:references-flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "section-source-listings-and-reproducibility", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c:references-flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "section-source-listings-and-reproducibility", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Appendix C Reading the Official Implementation", "level": 0 }, { "id": "appendix-c", "anchor": "appendix-c", "title": "Appendix C: Reading the official implementation", "level": 2 }, { "id": "a-deliberate-reading-order", "anchor": "a-deliberate-reading-order", "title": "A deliberate reading order", "level": 3 }, { "id": "questions-to-ask-beside-every-function", "anchor": "questions-to-ask-beside-every-function", "title": "Questions to ask beside every function", "level": 3 }, { "id": "concept-navigator", "anchor": "concept-navigator", "title": "Concept navigator", "level": 3 }, { "id": "small-glossary", "anchor": "small-glossary", "title": "Small glossary", "level": 3 }, { "id": "source-listings-and-reproducibility", "anchor": "source-listings-and-reproducibility", "title": "Source listings and reproducibility", "level": 3 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "source-listings-and-reproducibility" }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "anchor": "", "relation": "references", "sourceAnchor": "source-listings-and-reproducibility" }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "anchor": "", "relation": "references", "sourceAnchor": "source-listings-and-reproducibility" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Checked FlexBuffers Laboratory from the complete supplied first edition.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 11, "title": "Appendix D Checked FlexBuffers Laboratory", "nav": "Appendix D Checked FlexBuffers Laboratory", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "revision": "c18b32b3a2c7491bbdd32f4bdd50c8f3711860d77d6022453771424e4d6d59af", "status": "historical", "renderingRevision": "b874c9a24ec182dd3694f2fea499b18624eb661bbf9745a53686b7f4718b79fb", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "polarity": "Neutral" }, { "id": "section-appendix-d", "anchor": "appendix-d", "label": "Appendix D: Complete checked FlexBuffers laboratory", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-09-appendix-d#appendix-d", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "section-appendix-d", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d:references-flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "section-appendix-d", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d:references-flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "section-appendix-d", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Appendix D Checked FlexBuffers Laboratory", "level": 0 }, { "id": "appendix-d", "anchor": "appendix-d", "title": "Appendix D: Complete checked FlexBuffers laboratory", "level": 2 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "appendix-d" }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "anchor": "", "relation": "references", "sourceAnchor": "appendix-d" }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "anchor": "", "relation": "references", "sourceAnchor": "appendix-d" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Mutable Semantic Laboratory from the complete supplied first edition.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 12, "title": "Appendix E Mutable Semantic Laboratory", "nav": "Appendix E Mutable Semantic Laboratory", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "revision": "29f2ae5092955ccafccbe6b3506cb278235e08d643bacad20bd10f1462f6342a", "status": "historical", "renderingRevision": "ccee2c51f6eec2c9c7fb480a9a5675b6bbae1f4fbc6cb24af282e72594b9a714", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "polarity": "Neutral" }, { "id": "section-appendix-e", "anchor": "appendix-e", "label": "Appendix E: Complete mutable semantic laboratory", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-10-appendix-e#appendix-e", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "section-appendix-e", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e:references-flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "section-appendix-e", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e:references-flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "section-appendix-e", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Appendix E Mutable Semantic Laboratory", "level": 0 }, { "id": "appendix-e", "anchor": "appendix-e", "title": "Appendix E: Complete mutable semantic laboratory", "level": 2 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "appendix-e" }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "anchor": "", "relation": "references", "sourceAnchor": "appendix-e" }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "anchor": "", "relation": "references", "sourceAnchor": "appendix-e" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "FlatBuffers Table Laboratory from the complete supplied first edition.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 13, "title": "Appendix F FlatBuffers Table Laboratory", "nav": "Appendix F FlatBuffers Table Laboratory", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "revision": "f1b6b937f0f0405de2ca29dff0364b1ad515d36f7e0ee4585c649688c0fab099", "status": "historical", "renderingRevision": "5f01bf4c24b18d82ac86dad0abfd993432c8d78ef453b4de6e7a30fb54a6bb61", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "polarity": "Neutral" }, { "id": "section-appendix-f", "anchor": "appendix-f", "label": "Appendix F: Complete FlatBuffers table laboratory", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-11-appendix-f#appendix-f", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "section-appendix-f", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f:references-flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "section-appendix-f", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f:references-flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "section-appendix-f", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Appendix F FlatBuffers Table Laboratory", "level": 0 }, { "id": "appendix-f", "anchor": "appendix-f", "title": "Appendix F: Complete FlatBuffers table laboratory", "level": 2 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "appendix-f" }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "anchor": "", "relation": "references", "sourceAnchor": "appendix-f" }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "anchor": "", "relation": "references", "sourceAnchor": "appendix-f" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Sources and Edition Notes from the complete supplied first edition.", "use": "Read in book order through the From Bytes to Mutable Memory overview. Distinguish wire facts, pinned-source observations, and design proposals.", "region": "flexbuffers", "order": 14, "title": "Appendix G Sources and Edition Notes", "nav": "Appendix G Sources and Edition Notes", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "revision": "e53fa4ce943770661aaaf6e3b0541966acdf54ea3116c41911e079f071da2fc6", "status": "historical", "renderingRevision": "ac5b411f6f5e138edb1b1dcbedef9af37f81a632168ab61cd06166d4e588f897", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [], "externalLinks": [ "https://github.com/google/flatbuffers/blob/b8431fbcd7a5c71817f314e18b332c0648554efa/include/flatbuffers/flexbuffers.h", "https://github.com/google/flatbuffers/blob/b8431fbcd7a5c71817f314e18b332c0648554efa/include/flatbuffers/table.h", "https://github.com/google/flatbuffers/blob/b8431fbcd7a5c71817f314e18b332c0648554efa/include/flatbuffers/flatbuffer_builder.h", "https://flatbuffers.dev/internals/", "https://flatbuffers.dev/flexbuffers/", "https://flatbuffers.dev/schema/", "https://flatbuffers.dev/evolution/", "https://flatbuffers.dev/languages/cpp/", "https://flatbuffers.dev/flatc/", "https://flatbuffers.dev/annotation/", "https://abseil.io/about/design/swisstables", "https://eel.is/c++draft/bit.cast", "https://eel.is/c++draft/intro.races", "https://eel.is/c++draft/mem.res", "https://eel.is/c++draft/util.smartptr.atomic", "https://llvm.org/docs/Vectorizers.html", "https://google.github.io/benchmark/user_guide.html", "https://clang.llvm.org/docs/AddressSanitizer.html", "https://clang.llvm.org/docs/UndefinedBehaviorSanitizer.html", "https://clang.llvm.org/docs/ThreadSanitizer.html", "https://llvm.org/docs/LibFuzzer.html", "https://doc.rust-lang.org/std/slice/fn.from_raw_parts.html", "https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/foreign/MemorySegment.html", "https://tc39.es/ecma262/multipage/structured-data.html#sec-dataview-objects", "https://docs.kernel.org/kernel-hacking/false-sharing.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "polarity": "Neutral" }, { "id": "section-appendix-g", "anchor": "appendix-g", "label": "Appendix G: Sources and edition notes", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-12-appendix-g#appendix-g", "polarity": "Neutral" }, { "id": "section-related-reaktor-documentation", "anchor": "related-reaktor-documentation", "label": "Related Reaktor documentation", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory-12-appendix-g#related-reaktor-documentation", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g:references-flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g:references-flatbuffers-flexbuffers-mutable-memory-preface", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-preface", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g:references-flexbuffer-implementation", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g:references-reaktor-ffi", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Appendix G Sources and Edition Notes", "level": 0 }, { "id": "appendix-g", "anchor": "appendix-g", "title": "Appendix G: Sources and edition notes", "level": 2 }, { "id": "1-google-flatbuffers-flexbuffers-c-implementation", "anchor": "1-google-flatbuffers-flexbuffers-c-implementation", "title": "[1] Google FlatBuffers: FlexBuffers C++ implementation", "level": 3 }, { "id": "2-google-flatbuffers-table-implementation", "anchor": "2-google-flatbuffers-table-implementation", "title": "[2] Google FlatBuffers: Table implementation", "level": 3 }, { "id": "3-google-flatbuffers-flatbufferbuilder-implementation", "anchor": "3-google-flatbuffers-flatbufferbuilder-implementation", "title": "[3] Google FlatBuffers: FlatBufferBuilder implementation", "level": 3 }, { "id": "4-flatbuffers-documentation-internals", "anchor": "4-flatbuffers-documentation-internals", "title": "[4] FlatBuffers documentation: Internals", "level": 3 }, { "id": "5-flatbuffers-documentation-flexbuffers", "anchor": "5-flatbuffers-documentation-flexbuffers", "title": "[5] FlatBuffers documentation: FlexBuffers", "level": 3 }, { "id": "6-flatbuffers-documentation-schema", "anchor": "6-flatbuffers-documentation-schema", "title": "[6] FlatBuffers documentation: Schema", "level": 3 }, { "id": "7-flatbuffers-documentation-evolution", "anchor": "7-flatbuffers-documentation-evolution", "title": "[7] FlatBuffers documentation: Evolution", "level": 3 }, { "id": "8-flatbuffers-documentation-c", "anchor": "8-flatbuffers-documentation-c", "title": "[8] FlatBuffers documentation: C++", "level": 3 }, { "id": "9-flatbuffers-documentation-flatc", "anchor": "9-flatbuffers-documentation-flatc", "title": "[9] FlatBuffers documentation: flatc", "level": 3 }, { "id": "10-flatbuffers-documentation-annotation", "anchor": "10-flatbuffers-documentation-annotation", "title": "[10] FlatBuffers documentation: Annotation", "level": 3 }, { "id": "11-abseil-swiss-tables-design-notes", "anchor": "11-abseil-swiss-tables-design-notes", "title": "[11] Abseil: Swiss Tables design notes", "level": 3 }, { "id": "12-c-working-draft-bitcast", "anchor": "12-c-working-draft-bitcast", "title": "[12] C++ working draft: bit.cast", "level": 3 }, { "id": "13-c-working-draft-data-races", "anchor": "13-c-working-draft-data-races", "title": "[13] C++ working draft: Data races", "level": 3 }, { "id": "14-c-working-draft-memory-resources", "anchor": "14-c-working-draft-memory-resources", "title": "[14] C++ working draft: Memory resources", "level": 3 }, { "id": "15-c-working-draft-atomic-smart-pointers", "anchor": "15-c-working-draft-atomic-smart-pointers", "title": "[15] C++ working draft: Atomic smart pointers", "level": 3 }, { "id": "16-llvm-auto-vectorization-documentation", "anchor": "16-llvm-auto-vectorization-documentation", "title": "[16] LLVM: Auto-vectorization documentation", "level": 3 }, { "id": "17-google-benchmark-user-guide", "anchor": "17-google-benchmark-user-guide", "title": "[17] Google Benchmark: User guide", "level": 3 }, { "id": "18-clang-addresssanitizer", "anchor": "18-clang-addresssanitizer", "title": "[18] Clang: AddressSanitizer", "level": 3 }, { "id": "19-clang-undefinedbehaviorsanitizer", "anchor": "19-clang-undefinedbehaviorsanitizer", "title": "[19] Clang: UndefinedBehaviorSanitizer", "level": 3 }, { "id": "20-clang-threadsanitizer", "anchor": "20-clang-threadsanitizer", "title": "[20] Clang: ThreadSanitizer", "level": 3 }, { "id": "21-llvm-libfuzzer", "anchor": "21-llvm-libfuzzer", "title": "[21] LLVM: LibFuzzer", "level": 3 }, { "id": "22-rust-standard-library-slicefrom_raw_parts", "anchor": "22-rust-standard-library-slicefrom_raw_parts", "title": "[22] Rust standard library: slice::from_raw_parts", "level": 3 }, { "id": "23-java-se-22-api-memorysegment", "anchor": "23-java-se-22-api-memorysegment", "title": "[23] Java SE 22 API: MemorySegment", "level": 3 }, { "id": "24-ecmascript-specification-dataview-objects", "anchor": "24-ecmascript-specification-dataview-objects", "title": "[24] ECMAScript specification: DataView objects", "level": 3 }, { "id": "25-linux-kernel-documentation-false-sharing", "anchor": "25-linux-kernel-documentation-false-sharing", "title": "[25] Linux kernel documentation: False sharing", "level": 3 }, { "id": "edition-and-reproducibility", "anchor": "edition-and-reproducibility", "title": "Edition and reproducibility", "level": 3 }, { "id": "related-reaktor-documentation", "anchor": "related-reaktor-documentation", "title": "Related Reaktor documentation", "level": 2 } ], "links": [ { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory", "owner": "Supplied book / Codex conversion", "kind": "reference", "summary": "Reading map for the complete supplied 127-page first edition: 30 chapters, 32 exercises, seven appendices, 14 tables, worked wire examples, all 778 printed C++ source lines and 25 primary-source links. Five part pages and seven appendix pages preserve the complete text and source; LiveFlex remains distinct from current Reaktor implementation.", "use": "Read for wire layouts, C++ engineering, validation, ownership, compiler specialization, cells/slabs/handles, SIMD, transactions, concurrency and immutable snapshots. Source test receipts are author claims; the companion project was not supplied.", "region": "flexbuffers", "order": 2, "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory", "nav": "From Bytes to Mutable Memory", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory", "revision": "e7380788566fb05b99d8719eb9dbcf0c3bb70b26f5b5ea86190f29df76e6e871", "status": "historical", "renderingRevision": "6d406f884bbc5d90a99f008c0fe378bb9e18ce3bccc5b583cfad0fbd297da35d", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [ { "id": "flatbuffers-flexbuffers-first-edition", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory — supplied first edition", "date": "2026-09", "revision": "bfab19c78a274a0dab2a39bf15b9b680607444c12f07c894a58838bc29db6f0a" } ], "anchors": [ "chapter-1", "chapter-2", "chapter-3", "chapter-4", "chapter-5", "chapter-6", "chapter-7", "chapter-8", "chapter-9", "chapter-10", "chapter-11", "chapter-12", "chapter-13", "chapter-14", "chapter-15", "chapter-16", "chapter-17", "chapter-18", "chapter-19", "chapter-20", "chapter-21", "chapter-22", "chapter-23", "chapter-24", "chapter-25", "chapter-26", "chapter-27", "chapter-28", "chapter-29", "chapter-30", "appendix-a", "appendix-b", "appendix-c", "appendix-d", "appendix-e", "appendix-f", "appendix-g" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory", "polarity": "Neutral" }, { "id": "section-parts-and-references", "anchor": "parts-and-references", "label": "Parts and references", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory#parts-and-references", "polarity": "Neutral" }, { "id": "section-complete-contents", "anchor": "complete-contents", "label": "Complete contents", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory#complete-contents", "polarity": "Neutral" }, { "id": "section-preface", "anchor": "preface", "label": "Preface: What this book will teach you", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory#preface", "polarity": "Neutral" }, { "id": "section-related-reaktor-documentation", "anchor": "related-reaktor-documentation", "label": "Related Reaktor documentation", "profile": "section", "contract": "https://reaktor.build/docs/flatbuffers-flexbuffers-mutable-memory#related-reaktor-documentation", "polarity": "Neutral" } ], "relations": [ { "id": "flatbuffers-flexbuffers-mutable-memory:references-flexbuffer-implementation", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flexbuffer-performance-review", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-reaktor-ffi", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-related-reaktor-documentation", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-parts-and-references", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership-chapter-1", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "section-chapter-1", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership-chapter-2", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "section-chapter-2", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership-chapter-3", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "port": "section-chapter-3", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers-chapter-4", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-chapter-4", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers-chapter-5", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-chapter-5", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers-chapter-6", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-chapter-6", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers-chapter-7", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-chapter-7", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers-chapter-8", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-chapter-8", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-02-flatbuffers-chapter-9", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "port": "section-chapter-9", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-10", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-10", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-11", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-11", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-12", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-12", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-13", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-13", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-14", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-14", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-15", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-15", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-16", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-16", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-17", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-17", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-03-flexbuffers-chapter-18", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "port": "section-chapter-18", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance-chapter-19", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-chapter-19", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance-chapter-20", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-chapter-20", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance-chapter-21", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-chapter-21", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance-chapter-22", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-chapter-22", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance-chapter-23", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "port": "section-chapter-23", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-24", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-24", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-25", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-25", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-26", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-26", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-27", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-27", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-28", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-28", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-29", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-29", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-30", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-30", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-06-appendix-a-appendix-a", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "port": "section-appendix-a", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-07-appendix-b-appendix-b", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "port": "section-appendix-b", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-08-appendix-c-appendix-c", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "port": "section-appendix-c", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-09-appendix-d-appendix-d", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "port": "section-appendix-d", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-10-appendix-e-appendix-e", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "port": "section-appendix-e", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-11-appendix-f-appendix-f", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "port": "section-appendix-f", "role": "target", "ordinal": 0 } ] }, { "id": "flatbuffers-flexbuffers-mutable-memory:references-flatbuffers-flexbuffers-mutable-memory-12-appendix-g-appendix-g", "kind": "references", "owner": "flatbuffers-flexbuffers-mutable-memory", "incidences": [ { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "section-complete-contents", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "port": "section-appendix-g", "role": "target", "ordinal": 0 } ] } ] }, "content": "flatbuffers-flexbuffers-mutable-memory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "FlatBuffers and FlexBuffers: From Bytes to Mutable Memory", "level": 0 }, { "id": "parts-and-references", "anchor": "parts-and-references", "title": "Parts and references", "level": 2 }, { "id": "complete-contents", "anchor": "complete-contents", "title": "Complete contents", "level": 2 }, { "id": "preface", "anchor": "preface", "title": "Preface: What this book will teach you", "level": 2 }, { "id": "the-source-baseline", "anchor": "the-source-baseline", "title": "The source baseline", "level": 3 }, { "id": "the-companion-and-its-limits", "anchor": "the-companion-and-its-limits", "title": "The companion and its limits", "level": 3 }, { "id": "how-to-read", "anchor": "how-to-read", "title": "How to read", "level": 3 }, { "id": "a-promise-about-maximum-performance", "anchor": "a-promise-about-maximum-performance", "title": "A promise about “maximum performance”", "level": 3 }, { "id": "related-reaktor-documentation", "anchor": "related-reaktor-documentation", "title": "Related Reaktor documentation", "level": 2 } ], "links": [ { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "anchor": "", "relation": "references", "sourceAnchor": "parts-and-references" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "preface", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "chapter-1", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "chapter-2", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-01-bytes-and-ownership", "anchor": "chapter-3", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-4", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-5", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-6", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-7", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-8", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-02-flatbuffers", "anchor": "chapter-9", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-10", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-11", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-12", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-13", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-14", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-15", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-16", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-17", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-03-flexbuffers", "anchor": "chapter-18", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-19", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-20", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-21", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-22", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-04-quality-and-performance", "anchor": "chapter-23", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-24", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-25", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-26", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-27", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-28", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-29", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-30", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-06-appendix-a", "anchor": "appendix-a", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-07-appendix-b", "anchor": "appendix-b", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-08-appendix-c", "anchor": "appendix-c", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-09-appendix-d", "anchor": "appendix-d", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-10-appendix-e", "anchor": "appendix-e", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-11-appendix-f", "anchor": "appendix-f", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flatbuffers-flexbuffers-mutable-memory-12-appendix-g", "anchor": "appendix-g", "relation": "references", "sourceAnchor": "complete-contents" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-reaktor-documentation" } ] }, { "id": "flexbuffer-implementation", "owner": "Codex", "kind": "performance", "summary": "Current implementation and adoption guide: generated/raw/accessor/caller-owned tiers, platform kernels, October correctness blockers, historical July evidence, wire and allocation tradeoffs, ownership, schema safety, and proposed native/compiler/mutable-memory work.", "use": "Use before changing reaktor-flexbuffer, serialization policy, persisted binary payloads, benchmark baselines, or any JNI, cinterop, JSI, or future Wasm boundary.", "region": "flexbuffers", "order": 0, "title": "Reaktor FlexBuffer — High-Performance Binary Serialization", "nav": "FlexBuffer", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flexbuffer-implementation", "revision": "b1d038aac9926093166282136e4ac5c23f9a8f14f96f316b9c439aec3d5c33b3", "status": "unverified", "renderingRevision": "5c2c4114dad04a633a904ebe1f0cb7d351d359757707d3805eb2296c644ad6d7", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flexbuffer-implementation", "polarity": "Neutral" }, { "id": "section-status", "anchor": "status", "label": "1. Executive view", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#status", "polarity": "Neutral" }, { "id": "section-2-the-big-picture-runtime-model", "anchor": "2-the-big-picture-runtime-model", "label": "2. The big-picture runtime model", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#2-the-big-picture-runtime-model", "polarity": "Neutral" }, { "id": "section-access-tiers", "anchor": "access-tiers", "label": "3. Five access tiers and when to choose each", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#access-tiers", "polarity": "Neutral" }, { "id": "section-4-complete-optimization-ledger", "anchor": "4-complete-optimization-ledger", "label": "4. Complete optimization ledger", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#4-complete-optimization-ledger", "polarity": "Neutral" }, { "id": "section-5-rejected-optimizations", "anchor": "5-rejected-optimizations", "label": "5. Rejected optimizations", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#5-rejected-optimizations", "polarity": "Neutral" }, { "id": "section-benchmarks", "anchor": "benchmarks", "label": "6. Historical July JVM evidence", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#benchmarks", "polarity": "Neutral" }, { "id": "section-roadmap", "anchor": "roadmap", "label": "17. Remaining roadmap", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#roadmap", "polarity": "Neutral" }, { "id": "section-the-current-result-3-october-2026", "anchor": "the-current-result-3-october-2026", "label": "The current result (3 October 2026)", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#the-current-result-3-october-2026", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#related-docs", "polarity": "Neutral" }, { "id": "section-72-androidart", "anchor": "72-androidart", "label": "7.2 Android/ART", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#72-androidart", "polarity": "Neutral" }, { "id": "section-74-javascript-browser-node-and-cloudflare-workers", "anchor": "74-javascript-browser-node-and-cloudflare-workers", "label": "7.4 JavaScript, browser, Node, and Cloudflare Workers", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#74-javascript-browser-node-and-cloudflare-workers", "polarity": "Neutral" }, { "id": "section-12-high-performance-ffi-design", "anchor": "12-high-performance-ffi-design", "label": "12. High-performance FFI design", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#12-high-performance-ffi-design", "polarity": "Neutral" }, { "id": "section-remaining-format-parity-blockers", "anchor": "remaining-format-parity-blockers", "label": "Remaining format-parity blockers", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-implementation#remaining-format-parity-blockers", "polarity": "Neutral" } ], "relations": [ { "id": "flexbuffer-implementation:references-flexbuffer-performance-review", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-the-current-result-3-october-2026", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flexbuffer-performance-review-jvm", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-benchmarks", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "section-jvm", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flexbuffer-performance-review-android-bulk", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-72-androidart", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "section-android-bulk", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flexbuffer-performance-review-platforms", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-74-javascript-browser-node-and-cloudflare-workers", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "section-platforms", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-reaktor-ffi", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-12-high-performance-ffi-design", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flexbuffer-performance-review-stability", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-remaining-format-parity-blockers", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "section-stability", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flexbuffer-performance-review-plan", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-roadmap", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "section-plan", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-reaktor-ffi-frames", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-roadmap", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-frames", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-24", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-roadmap", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-24", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-performance-observability", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-reaktor-core", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-reaktor-server", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-reaktor-db", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-implementation:references-flexbuffer-improvement-plan", "kind": "references", "owner": "flexbuffer-implementation", "incidences": [ { "node": "flexbuffer-implementation", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-improvement-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flexbuffer-implementation.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor FlexBuffer — High-Performance Binary Serialization", "level": 0 }, { "id": "status", "anchor": "status", "title": "1. Executive view", "level": 2 }, { "id": "the-current-result-3-october-2026", "anchor": "the-current-result-3-october-2026", "title": "The current result (3 October 2026)", "level": 3 }, { "id": "what-is-implemented-and-what-is-not", "anchor": "what-is-implemented-and-what-is-not", "title": "What is implemented, and what is not", "level": 3 }, { "id": "the-architectural-call", "anchor": "the-architectural-call", "title": "The architectural call", "level": 3 }, { "id": "2-the-big-picture-runtime-model", "anchor": "2-the-big-picture-runtime-model", "title": "2. The big-picture runtime model", "level": 2 }, { "id": "access-tiers", "anchor": "access-tiers", "title": "3. Five access tiers and when to choose each", "level": 2 }, { "id": "a-practical-decision-tree", "anchor": "a-practical-decision-tree", "title": "A practical decision tree", "level": 3 }, { "id": "public-api-examples", "anchor": "public-api-examples", "title": "Public API examples", "level": 3 }, { "id": "4-complete-optimization-ledger", "anchor": "4-complete-optimization-ledger", "title": "4. Complete optimization ledger", "level": 2 }, { "id": "40-direct-memory-and-container-foundations", "anchor": "40-direct-memory-and-container-foundations", "title": "4.0 Direct memory and container foundations", "level": 3 }, { "id": "41-generated-root-and-dispatch-geometry", "anchor": "41-generated-root-and-dispatch-geometry", "title": "4.1 Generated root and dispatch geometry", "level": 3 }, { "id": "42-compile-time-keys-and-map-layout", "anchor": "42-compile-time-keys-and-map-layout", "title": "4.2 Compile-time keys and map layout", "level": 3 }, { "id": "43-generated-scalar-decode", "anchor": "43-generated-scalar-decode", "title": "4.3 Generated scalar decode", "level": 3 }, { "id": "44-primitive-vector-width-selection", "anchor": "44-primitive-vector-width-selection", "title": "4.4 Primitive vector width selection", "level": 3 }, { "id": "45-platform-bulk-primitive-transfer", "anchor": "45-platform-bulk-primitive-transfer", "title": "4.5 Platform bulk primitive transfer", "level": 3 }, { "id": "46-primitive-collection-materialization", "anchor": "46-primitive-collection-materialization", "title": "4.6 Primitive collection materialization", "level": 3 }, { "id": "47-string-encoding-and-decoding", "anchor": "47-string-encoding-and-decoding", "title": "4.7 String encoding and decoding", "level": 3 }, { "id": "jvm", "anchor": "jvm", "title": "JVM", "level": 4 }, { "id": "android", "anchor": "android", "title": "Android", "level": 4 }, { "id": "javascript", "anchor": "javascript", "title": "JavaScript", "level": 4 }, { "id": "kotlinnative", "anchor": "kotlinnative", "title": "Kotlin/Native", "level": 4 }, { "id": "48-key-lookup", "anchor": "48-key-lookup", "title": "4.8 Key lookup", "level": 3 }, { "id": "49-raw-kotlinx-decoder-hot-path", "anchor": "49-raw-kotlinx-decoder-hot-path", "title": "4.9 Raw kotlinx decoder hot path", "level": 3 }, { "id": "410-builder-ownership-pooling-and-copies", "anchor": "410-builder-ownership-pooling-and-copies", "title": "4.10 Builder ownership, pooling, and copies", "level": 3 }, { "id": "411-reader-and-safety-hardening", "anchor": "411-reader-and-safety-hardening", "title": "4.11 Reader and safety hardening", "level": 3 }, { "id": "412-registration-and-incremental-code-generation-correctness", "anchor": "412-registration-and-incremental-code-generation-correctness", "title": "4.12 Registration and incremental code-generation correctness", "level": 3 }, { "id": "5-rejected-optimizations", "anchor": "5-rejected-optimizations", "title": "5. Rejected optimizations", "level": 2 }, { "id": "51-memory-and-code-size-tradeoffs", "anchor": "51-memory-and-code-size-tradeoffs", "title": "5.1 Memory and code-size tradeoffs", "level": 3 }, { "id": "benchmarks", "anchor": "benchmarks", "title": "6. Historical July JVM evidence", "level": 2 }, { "id": "61-headline-matrix", "anchor": "61-headline-matrix", "title": "6.1 Headline matrix", "level": 3 }, { "id": "62-what-the-baseline-to-final-numbers-can-and-cannot-prove", "anchor": "62-what-the-baseline-to-final-numbers-can-and-cannot-prove", "title": "6.2 What the baseline-to-final numbers can and cannot prove", "level": 3 }, { "id": "63-the-26-model-corpus", "anchor": "63-the-26-model-corpus", "title": "6.3 The 26-model corpus", "level": 3 }, { "id": "64-primitive-vector-matched-ab", "anchor": "64-primitive-vector-matched-ab", "title": "6.4 Primitive-vector matched A/B", "level": 3 }, { "id": "65-generated-accessor-evidence", "anchor": "65-generated-accessor-evidence", "title": "6.5 Generated accessor evidence", "level": 3 }, { "id": "66-2026-07-13-re-verification-and-adversarial-suite", "anchor": "66-2026-07-13-re-verification-and-adversarial-suite", "title": "6.6 2026-07-13 re-verification and adversarial suite", "level": 3 }, { "id": "7-platform-specific-evidence-and-policy", "anchor": "7-platform-specific-evidence-and-policy", "title": "7. Platform-specific evidence and policy", "level": 2 }, { "id": "71-jvm-and-reaktor-server", "anchor": "71-jvm-and-reaktor-server", "title": "7.1 JVM and Reaktor Server", "level": 3 }, { "id": "72-androidart", "anchor": "72-androidart", "title": "7.2 Android/ART", "level": 3 }, { "id": "73-kotlinnative-and-ios", "anchor": "73-kotlinnative-and-ios", "title": "7.3 Kotlin/Native and iOS", "level": 3 }, { "id": "74-javascript-browser-node-and-cloudflare-workers", "anchor": "74-javascript-browser-node-and-cloudflare-workers", "title": "7.4 JavaScript, browser, Node, and Cloudflare Workers", "level": 3 }, { "id": "75-c-comparison", "anchor": "75-c-comparison", "title": "7.5 C++ comparison", "level": 3 }, { "id": "8-flatbuffers-versus-flexbuffers", "anchor": "8-flatbuffers-versus-flexbuffers", "title": "8. FlatBuffers versus FlexBuffers", "level": 2 }, { "id": "9-bestbuds-real-complex-model-integration", "anchor": "9-bestbuds-real-complex-model-integration", "title": "9. BestBuds: real complex-model integration", "level": 2 }, { "id": "bestbuds-adoption-opportunities", "anchor": "bestbuds-adoption-opportunities", "title": "BestBuds adoption opportunities", "level": 3 }, { "id": "10-manna-where-flexbuffers-could-matter", "anchor": "10-manna-where-flexbuffers-could-matter", "title": "10. Manna: where FlexBuffers could matter", "level": 2 }, { "id": "high-value-candidate-knowledge-graph-snapshot", "anchor": "high-value-candidate-knowledge-graph-snapshot", "title": "High-value candidate: knowledge-graph snapshot", "level": 3 }, { "id": "boundaries-that-should-remain-json-by-default", "anchor": "boundaries-that-should-remain-json-by-default", "title": "Boundaries that should remain JSON by default", "level": 3 }, { "id": "11-reaktor-wide-target-map", "anchor": "11-reaktor-wide-target-map", "title": "11. Reaktor-wide target map", "level": 2 }, { "id": "12-high-performance-ffi-design", "anchor": "12-high-performance-ffi-design", "title": "12. High-performance FFI design", "level": 2 }, { "id": "121-why-byte-protocols-help-ffi", "anchor": "121-why-byte-protocols-help-ffi", "title": "12.1 Why byte protocols help FFI", "level": 3 }, { "id": "122-current-native-proof", "anchor": "122-current-native-proof", "title": "12.2 Current native proof", "level": 3 }, { "id": "123-required-production-envelope", "anchor": "123-required-production-envelope", "title": "12.3 Required production envelope", "level": 3 }, { "id": "124-ownership-contract", "anchor": "124-ownership-contract", "title": "12.4 Ownership contract", "level": 3 }, { "id": "125-platform-boundary-guidance", "anchor": "125-platform-boundary-guidance", "title": "12.5 Platform boundary guidance", "level": 3 }, { "id": "jni--android", "anchor": "jni--android", "title": "JNI / Android", "level": 4 }, { "id": "cinterop--apple", "anchor": "cinterop--apple", "title": "cinterop / Apple", "level": 4 }, { "id": "jsi--hermes-and-browser-javascript", "anchor": "jsi--hermes-and-browser-javascript", "title": "JSI / Hermes and browser JavaScript", "level": 4 }, { "id": "jvm-nativeserver-libraries", "anchor": "jvm-nativeserver-libraries", "title": "JVM native/server libraries", "level": 4 }, { "id": "c--unreal--native-engines", "anchor": "c--unreal--native-engines", "title": "C++ / Unreal / native engines", "level": 4 }, { "id": "webassembly", "anchor": "webassembly", "title": "WebAssembly", "level": 4 }, { "id": "126-ffi-performance-budget", "anchor": "126-ffi-performance-budget", "title": "12.6 FFI performance budget", "level": 3 }, { "id": "13-wire-compatibility-and-security-rules", "anchor": "13-wire-compatibility-and-security-rules", "title": "13. Wire, compatibility, and security rules", "level": 2 }, { "id": "signed-integer-upgrade", "anchor": "signed-integer-upgrade", "title": "Signed integer upgrade", "level": 3 }, { "id": "trusted-versus-untrusted-bytes", "anchor": "trusted-versus-untrusted-bytes", "title": "Trusted versus untrusted bytes", "level": 3 }, { "id": "remaining-format-parity-blockers", "anchor": "remaining-format-parity-blockers", "title": "Remaining format-parity blockers", "level": 3 }, { "id": "14-adoption-playbook", "anchor": "14-adoption-playbook", "title": "14. Adoption playbook", "level": 2 }, { "id": "phase-0-prove-the-workload", "anchor": "phase-0-prove-the-workload", "title": "Phase 0: prove the workload", "level": 3 }, { "id": "phase-1-add-a-versioned-dto", "anchor": "phase-1-add-a-versioned-dto", "title": "Phase 1: add a versioned DTO", "level": 3 }, { "id": "phase-2-deploy-generated-bytes-on-an-ephemeral-internal-path", "anchor": "phase-2-deploy-generated-bytes-on-an-ephemeral-internal-path", "title": "Phase 2: deploy generated bytes on an ephemeral internal path", "level": 3 }, { "id": "phase-3-remove-copies", "anchor": "phase-3-remove-copies", "title": "Phase 3: remove copies", "level": 3 }, { "id": "phase-4-consider-persistence", "anchor": "phase-4-consider-persistence", "title": "Phase 4: consider persistence", "level": 3 }, { "id": "15-benchmark-discipline", "anchor": "15-benchmark-discipline", "title": "15. Benchmark discipline", "level": 2 }, { "id": "reproduce", "anchor": "reproduce", "title": "16. Reproduction and evidence", "level": 2 }, { "id": "roadmap", "anchor": "roadmap", "title": "17. Remaining roadmap", "level": 2 }, { "id": "18-source-map", "anchor": "18-source-map", "title": "18. Source map", "level": 2 }, { "id": "19-rules-to-keep", "anchor": "19-rules-to-keep", "title": "19. Rules to keep", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "the-current-result-3-october-2026" }, { "id": "flexbuffer-performance-review", "anchor": "jvm", "relation": "references", "sourceAnchor": "benchmarks" }, { "id": "flexbuffer-performance-review", "anchor": "android-bulk", "relation": "references", "sourceAnchor": "72-androidart" }, { "id": "flexbuffer-performance-review", "anchor": "platforms", "relation": "references", "sourceAnchor": "74-javascript-browser-node-and-cloudflare-workers" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "12-high-performance-ffi-design" }, { "id": "flexbuffer-performance-review", "anchor": "stability", "relation": "references", "sourceAnchor": "remaining-format-parity-blockers" }, { "id": "flexbuffer-performance-review", "anchor": "plan", "relation": "references", "sourceAnchor": "roadmap" }, { "id": "reaktor-ffi", "anchor": "frames", "relation": "references", "sourceAnchor": "roadmap" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-24", "relation": "references", "sourceAnchor": "roadmap" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-improvement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "flexbuffer-improvement-plan", "owner": "Codex", "kind": "prior", "summary": "Earlier FlexBuffer optimization plan, superseded by the implementation ledger.", "use": "Use for history only; prefer the Reaktor FlexBuffer performance guide.", "region": "flexbuffers", "order": 15, "title": "FlexBuffer Improvement Plan", "nav": "FlexBuffer Plan", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flexbuffer-improvement-plan", "revision": "e5a71dad5b6c9c1477bb8d110325cb60dda7b5791b2fcc8984501acb02312256", "status": "unverified", "renderingRevision": "c0fa0152841ab9ce514ede015ab4ccc6a7e92009447d5b1d106b01a0bb9daa38", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flexbuffer-improvement-plan", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-improvement-plan#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "flexbuffer-improvement-plan:references-flexbuffer-implementation", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-flexbuffer-implementation-status", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "section-status", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-flexbuffer-implementation-roadmap", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "section-roadmap", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-flexbuffer-performance-review", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-reaktor-ffi", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-performance-observability", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-reaktor-core", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-improvement-plan:references-claude-dev-environment", "kind": "references", "owner": "flexbuffer-improvement-plan", "incidences": [ { "node": "flexbuffer-improvement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "claude-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flexbuffer-improvement-plan.json", "sections": [ { "id": "preamble", "anchor": "", "title": "FlexBuffer Improvement Plan", "level": 0 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-implementation", "anchor": "status", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-implementation", "anchor": "roadmap", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "claude-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "flexbuffer-performance-review", "owner": "Codex", "kind": "performance", "summary": "October source-grounded measurements on M4 Pro, actual Chrome and physical S23 Ultra/iPhone 14 Pro: JSON, kotlinx ProtoBuf and packed Google Java Protobuf, allocations, wire sizes, partial reads, validation, Android bulk experiments, four unresolved correctness defects and prioritized optimization gates.", "use": "Use for current measured claims and stability blockers before optimizing codecs, selecting a native kernel or compiler specialization, or adopting binary transport. Codec timings do not establish FFI hop or mutable-engine performance.", "region": "flexbuffers", "order": 1, "title": "FlexBuffers: October performance and stability review", "nav": "Performance and stability review", "group": "flexbuffers-ffi", "subsection": "flexbuffers", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flexbuffer-performance-review", "revision": "d3318a36a5a7bc5b6d93efa8b7b97341d58a480b086457e43282fbb58579210e", "status": "unverified", "renderingRevision": "08cb9216a20f22bfaf11f9d3ede9648954b4dc3d3e66737d19e96669d3c31d26", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flexbuffer-performance-review", "polarity": "Neutral" }, { "id": "section-protocol", "anchor": "protocol", "label": "Evidence and protocol", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#protocol", "polarity": "Neutral" }, { "id": "section-jvm", "anchor": "jvm", "label": "JVM encoding and decoding", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#jvm", "polarity": "Neutral" }, { "id": "section-platforms", "anchor": "platforms", "label": "Matched cross-platform codec results", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#platforms", "polarity": "Neutral" }, { "id": "section-wire", "anchor": "wire", "label": "Wire sizes", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#wire", "polarity": "Neutral" }, { "id": "section-google-protobuf", "anchor": "google-protobuf", "label": "Packed Google Java Protobuf", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#google-protobuf", "polarity": "Neutral" }, { "id": "section-memory", "anchor": "memory", "label": "In-memory access and validation", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#memory", "polarity": "Neutral" }, { "id": "section-android-bulk", "anchor": "android-bulk", "label": "Android primitive bulk transfer: measured experiment", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#android-bulk", "polarity": "Neutral" }, { "id": "section-stability", "anchor": "stability", "label": "Reproduced stability defects", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#stability", "polarity": "Neutral" }, { "id": "section-plan", "anchor": "plan", "label": "Optimization and adoption plan", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#plan", "polarity": "Neutral" }, { "id": "section-related-documentation", "anchor": "related-documentation", "label": "Related documentation", "profile": "section", "contract": "https://reaktor.build/docs/flexbuffer-performance-review#related-documentation", "polarity": "Neutral" } ], "relations": [ { "id": "flexbuffer-performance-review:references-flexbuffer-implementation", "kind": "references", "owner": "flexbuffer-performance-review", "incidences": [ { "node": "flexbuffer-performance-review", "port": "section-related-documentation", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-performance-review:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "flexbuffer-performance-review", "incidences": [ { "node": "flexbuffer-performance-review", "port": "section-related-documentation", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-performance-review:references-reaktor-ffi", "kind": "references", "owner": "flexbuffer-performance-review", "incidences": [ { "node": "flexbuffer-performance-review", "port": "section-related-documentation", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flexbuffer-performance-review:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-24", "kind": "references", "owner": "flexbuffer-performance-review", "incidences": [ { "node": "flexbuffer-performance-review", "port": "section-plan", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-24", "role": "target", "ordinal": 0 } ] } ] }, "content": "flexbuffer-performance-review.json", "sections": [ { "id": "preamble", "anchor": "", "title": "FlexBuffers: October performance and stability review", "level": 0 }, { "id": "protocol", "anchor": "protocol", "title": "Evidence and protocol", "level": 2 }, { "id": "jvm", "anchor": "jvm", "title": "JVM encoding and decoding", "level": 2 }, { "id": "platforms", "anchor": "platforms", "title": "Matched cross-platform codec results", "level": 2 }, { "id": "jvm-supplemental-harness", "anchor": "jvm-supplemental-harness", "title": "JVM supplemental harness", "level": 3 }, { "id": "physical-android", "anchor": "physical-android", "title": "Physical Android", "level": 3 }, { "id": "physical-ios", "anchor": "physical-ios", "title": "Physical iOS", "level": 3 }, { "id": "chrome-browser", "anchor": "chrome-browser", "title": "Chrome browser", "level": 3 }, { "id": "native-browser-json-is-a-separate-representation", "anchor": "native-browser-json-is-a-separate-representation", "title": "Native browser JSON is a separate representation", "level": 3 }, { "id": "wire", "anchor": "wire", "title": "Wire sizes", "level": 2 }, { "id": "google-protobuf", "anchor": "google-protobuf", "title": "Packed Google Java Protobuf", "level": 2 }, { "id": "memory", "anchor": "memory", "title": "In-memory access and validation", "level": 2 }, { "id": "android-bulk", "anchor": "android-bulk", "title": "Android primitive bulk transfer: measured experiment", "level": 2 }, { "id": "hotspots", "anchor": "hotspots", "title": "Adversarial and profiling findings", "level": 2 }, { "id": "stability", "anchor": "stability", "title": "Reproduced stability defects", "level": 2 }, { "id": "plan", "anchor": "plan", "title": "Optimization and adoption plan", "level": 2 }, { "id": "related-documentation", "anchor": "related-documentation", "title": "Related documentation", "level": 2 } ], "links": [ { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-24", "relation": "references", "sourceAnchor": "plan" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-documentation" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "related-documentation" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-documentation" } ] }, { "id": "flow-analysis", "owner": "Claude", "kind": "analysis", "summary": "react-flow, compose-flow, and reaktor-flow comparison for visual graph editing.", "use": "Use when shaping flow UI behavior and graph editor affordances.", "region": "background-research", "order": 6, "title": "Flow Analysis", "nav": "Flow Analysis", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/flow-analysis", "revision": "e6c396403ec1fbae0149252b21cd1414a469702e4bdb37cdee2505a168d4db5f", "status": "historical", "renderingRevision": "368db73d33bb6b969524122525edb175aaa53c0a436f2233c3916385f4310348", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/flow-analysis", "polarity": "Neutral" }, { "id": "section-01-react-flow-and-mdash-the-reference-implementation", "anchor": "01-react-flow-and-mdash-the-reference-implementation", "label": "01 React Flow — The Reference Implementation", "profile": "section", "contract": "https://reaktor.build/docs/flow-analysis#01-react-flow-and-mdash-the-reference-implementation", "polarity": "Neutral" }, { "id": "section-02-compose-flow-and-mdash-current-state", "anchor": "02-compose-flow-and-mdash-current-state", "label": "02 Compose Flow — Current State", "profile": "section", "contract": "https://reaktor.build/docs/flow-analysis#02-compose-flow-and-mdash-current-state", "polarity": "Neutral" }, { "id": "section-03-reaktor-flow-and-mdash-the-bridge-layer", "anchor": "03-reaktor-flow-and-mdash-the-bridge-layer", "label": "03 Reaktor Flow — The Bridge Layer", "profile": "section", "contract": "https://reaktor.build/docs/flow-analysis#03-reaktor-flow-and-mdash-the-bridge-layer", "polarity": "Neutral" }, { "id": "section-04-parity-snapshot", "anchor": "04-parity-snapshot", "label": "04 Parity Snapshot", "profile": "section", "contract": "https://reaktor.build/docs/flow-analysis#04-parity-snapshot", "polarity": "Neutral" }, { "id": "section-05-detailed-gap-analysis", "anchor": "05-detailed-gap-analysis", "label": "05 Detailed Gap Analysis", "profile": "section", "contract": "https://reaktor.build/docs/flow-analysis#05-detailed-gap-analysis", "polarity": "Neutral" }, { "id": "section-06-architecture-diagram", "anchor": "06-architecture-diagram", "label": "06 Architecture Diagram", "profile": "section", "contract": "https://reaktor.build/docs/flow-analysis#06-architecture-diagram", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/flow-analysis#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "flow-analysis:references-reaktor-visual-language", "kind": "references", "owner": "flow-analysis", "incidences": [ { "node": "flow-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flow-analysis:references-graph-kernel-analysis", "kind": "references", "owner": "flow-analysis", "incidences": [ { "node": "flow-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flow-analysis:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "flow-analysis", "incidences": [ { "node": "flow-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flow-analysis:references-reaktor-surface-renderers", "kind": "references", "owner": "flow-analysis", "incidences": [ { "node": "flow-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flow-analysis:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "flow-analysis", "incidences": [ { "node": "flow-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "flow-analysis:references-reaktor_graph_visitors_design", "kind": "references", "owner": "flow-analysis", "incidences": [ { "node": "flow-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "flow-analysis.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Flow Analysis", "level": 0 }, { "id": "01-react-flow-and-mdash-the-reference-implementation", "anchor": "01-react-flow-and-mdash-the-reference-implementation", "title": "01 React Flow — The Reference Implementation", "level": 2 }, { "id": "react-flow", "anchor": "react-flow", "title": "Architecture", "level": 3 }, { "id": "react-flow-2", "anchor": "react-flow-2", "title": "Data Model", "level": 3 }, { "id": "react-flow-3", "anchor": "react-flow-3", "title": "Built-in Types", "level": 3 }, { "id": "node-types", "anchor": "node-types", "title": "Node Types", "level": 4 }, { "id": "edge-types", "anchor": "edge-types", "title": "Edge Types", "level": 4 }, { "id": "react-flow-4", "anchor": "react-flow-4", "title": "Feature Surface", "level": 3 }, { "id": "react-flow-5", "anchor": "react-flow-5", "title": "Interaction Features", "level": 4 }, { "id": "react-flow-6", "anchor": "react-flow-6", "title": "Components", "level": 4 }, { "id": "react-flow-7", "anchor": "react-flow-7", "title": "Hooks", "level": 4 }, { "id": "react-flow-8", "anchor": "react-flow-8", "title": "Event System (~40 callbacks)", "level": 4 }, { "id": "02-compose-flow-and-mdash-current-state", "anchor": "02-compose-flow-and-mdash-current-state", "title": "02 Compose Flow — Current State", "level": 2 }, { "id": "compose-flow", "anchor": "compose-flow", "title": "Rendering Pipeline", "level": 3 }, { "id": "compose-flow-2", "anchor": "compose-flow-2", "title": "What’s Implemented", "level": 3 }, { "id": "compose-flow-3", "anchor": "compose-flow-3", "title": "Data Model", "level": 4 }, { "id": "compose-flow-4", "anchor": "compose-flow-4", "title": "Change System", "level": 4 }, { "id": "compose-flow-5", "anchor": "compose-flow-5", "title": "State Management", "level": 4 }, { "id": "compose-flow-6", "anchor": "compose-flow-6", "title": "Main Composable — ReactFlow()", "level": 4 }, { "id": "compose-flow-7", "anchor": "compose-flow-7", "title": "Components", "level": 4 }, { "id": "compose-flow-8", "anchor": "compose-flow-8", "title": "Interactions", "level": 4 }, { "id": "compose-flow-9", "anchor": "compose-flow-9", "title": "Edge Rendering", "level": 4 }, { "id": "compose-flow-10", "anchor": "compose-flow-10", "title": "JS/Web Interop", "level": 4 }, { "id": "compose-flow-11", "anchor": "compose-flow-11", "title": "Theme System", "level": 4 }, { "id": "compose-flow-12", "anchor": "compose-flow-12", "title": "Tests & Tracking", "level": 4 }, { "id": "03-reaktor-flow-and-mdash-the-bridge-layer", "anchor": "03-reaktor-flow-and-mdash-the-bridge-layer", "title": "03 Reaktor Flow — The Bridge Layer", "level": 2 }, { "id": "reaktor-flow", "anchor": "reaktor-flow", "title": "3a. Adapter Layer", "level": 3 }, { "id": "reaktor-flow-2", "anchor": "reaktor-flow-2", "title": "3b. Layout Engine", "level": 3 }, { "id": "reaktor-flow-3", "anchor": "reaktor-flow-3", "title": "3c. Editor / Render Layer", "level": 3 }, { "id": "reaktor-flow-4", "anchor": "reaktor-flow-4", "title": "Render Components", "level": 4 }, { "id": "reaktor-flow-5", "anchor": "reaktor-flow-5", "title": "3d. Type System", "level": 3 }, { "id": "reaktor-flow-6", "anchor": "reaktor-flow-6", "title": "3e. Style System", "level": 3 }, { "id": "canvas", "anchor": "canvas", "title": "Canvas", "level": 4 }, { "id": "layout", "anchor": "layout", "title": "Layout", "level": 4 }, { "id": "node", "anchor": "node", "title": "Node", "level": 4 }, { "id": "port", "anchor": "port", "title": "Port", "level": 4 }, { "id": "region", "anchor": "region", "title": "Region", "level": 4 }, { "id": "chrome", "anchor": "chrome", "title": "Chrome", "level": 4 }, { "id": "viewport", "anchor": "viewport", "title": "Viewport", "level": 4 }, { "id": "widthpolicy", "anchor": "widthpolicy", "title": "WidthPolicy", "level": 4 }, { "id": "04-parity-snapshot", "anchor": "04-parity-snapshot", "title": "04 Parity Snapshot", "level": 2 }, { "id": "05-detailed-gap-analysis", "anchor": "05-detailed-gap-analysis", "title": "05 Detailed Gap Analysis", "level": 2 }, { "id": "06-architecture-diagram", "anchor": "06-architecture-diagram", "title": "06 Architecture Diagram", "level": 2 }, { "id": "07-roadmap-to-parity", "anchor": "07-roadmap-to-parity", "title": "07 Roadmap to Parity", "level": 2 }, { "id": "phase-1--core-interactions-month-12", "anchor": "phase-1--core-interactions-month-12", "title": "Phase 1 — Core Interactions (Month 1–2)", "level": 4 }, { "id": "phase-2--node-constraints--polish-month-23", "anchor": "phase-2--node-constraints--polish-month-23", "title": "Phase 2 — Node Constraints & Polish (Month 2–3)", "level": 4 }, { "id": "phase-3--advanced-features-month-34", "anchor": "phase-3--advanced-features-month-34", "title": "Phase 3 — Advanced Features (Month 3–4)", "level": 4 }, { "id": "phase-4--full-parity-month-45", "anchor": "phase-4--full-parity-month-45", "title": "Phase 4 — Full Parity (Month 4–5)", "level": 4 }, { "id": "08-architectural-strengths-already-in-place", "anchor": "08-architectural-strengths-already-in-place", "title": "08 Architectural Strengths Already in Place", "level": 2 }, { "id": "clean-separation", "anchor": "clean-separation", "title": "Clean Separation", "level": 4 }, { "id": "immutable-data", "anchor": "immutable-data", "title": "Immutable Data", "level": 4 }, { "id": "js-interop", "anchor": "js-interop", "title": "JS Interop", "level": 4 }, { "id": "platform-bridge", "anchor": "platform-bridge", "title": "Platform Bridge", "level": 4 }, { "id": "parity-tracking", "anchor": "parity-tracking", "title": "Parity Tracking", "level": 4 }, { "id": "comprehensive-theming", "anchor": "comprehensive-theming", "title": "Comprehensive Theming", "level": 4 }, { "id": "strengths", "anchor": "strengths", "title": "What reaktor-flow Needs Next", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "graph-kernel-analysis", "owner": "Claude", "kind": "architecture", "summary": "Universal composition kernel for graph runtime, modules, visitors, snapshots, and commands.", "use": "Use to keep the core language small while modules add vocabulary.", "region": "graph-model", "order": 1, "title": "Graph Kernel Analysis", "nav": "Graph Kernel", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/graph-kernel-analysis", "revision": "6d608bf52178ff1c1e436da9ff5b6e6dc602f3ac29dfe60ad3dc20851f7ed779", "status": "unverified", "renderingRevision": "613bbec61d73214cc0862db796de6d12430dcbe31674f4adf6c60cf02021f5c4", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/graph-kernel-analysis", "polarity": "Neutral" }, { "id": "section-the-refined-thesis", "anchor": "the-refined-thesis", "label": "The refined thesis", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#the-refined-thesis", "polarity": "Neutral" }, { "id": "section-kernel-ontology", "anchor": "kernel-ontology", "label": "Kernel ontology", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#kernel-ontology", "polarity": "Neutral" }, { "id": "section-kernel-laws", "anchor": "kernel-laws", "label": "Kernel laws", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#kernel-laws", "polarity": "Neutral" }, { "id": "section-module-model", "anchor": "module-model", "label": "Module model", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#module-model", "polarity": "Neutral" }, { "id": "section-canonical-runtime-planes", "anchor": "canonical-runtime-planes", "label": "Canonical runtime planes", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#canonical-runtime-planes", "polarity": "Neutral" }, { "id": "section-targets-and-languages", "anchor": "targets-and-languages", "label": "Targets and languages", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#targets-and-languages", "polarity": "Neutral" }, { "id": "section-implementation", "anchor": "implementation", "label": "Build next", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#implementation", "polarity": "Neutral" }, { "id": "section-kernel", "anchor": "kernel", "label": "Target kernel sketch", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#kernel", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/graph-kernel-analysis#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "graph-kernel-analysis:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-server-api-evolution", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-api-evolution", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-capability", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-implementation", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-service", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-implementation", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-framework-overview", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor_graph_visitors_design", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-graph-migration-plan", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-actor-model", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "graph-kernel-analysis:references-reaktor-unified-system-graph", "kind": "references", "owner": "graph-kernel-analysis", "incidences": [ { "node": "graph-kernel-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "graph-kernel-analysis.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Graph Kernel Analysis", "level": 0 }, { "id": "the-refined-thesis", "anchor": "the-refined-thesis", "title": "The refined thesis", "level": 2 }, { "id": "modules", "anchor": "modules", "title": "Modules", "level": 3 }, { "id": "graph", "anchor": "graph", "title": "Graph", "level": 3 }, { "id": "tools--ai", "anchor": "tools--ai", "title": "Tools & AI", "level": 3 }, { "id": "kernel-ontology", "anchor": "kernel-ontology", "title": "Kernel ontology", "level": 2 }, { "id": "kernel", "anchor": "kernel", "title": "Target kernel sketch", "level": 3 }, { "id": "kernel-laws", "anchor": "kernel-laws", "title": "Kernel laws", "level": 2 }, { "id": "1-identity-is-stable", "anchor": "1-identity-is-stable", "title": "1. Identity is stable", "level": 4 }, { "id": "2-ports-connect-by-contract", "anchor": "2-ports-connect-by-contract", "title": "2. Ports connect by contract", "level": 4 }, { "id": "3-edges-are-explicit", "anchor": "3-edges-are-explicit", "title": "3. Edges are explicit", "level": 4 }, { "id": "4-facets-add-meaning", "anchor": "4-facets-add-meaning", "title": "4. Facets add meaning", "level": 4 }, { "id": "5-capabilities-are-observed", "anchor": "5-capabilities-are-observed", "title": "5. Capabilities are observed", "level": 4 }, { "id": "6-visitors-interpret", "anchor": "6-visitors-interpret", "title": "6. Visitors interpret", "level": 4 }, { "id": "7-commands-mutate", "anchor": "7-commands-mutate", "title": "7. Commands mutate", "level": 4 }, { "id": "8-snapshots-are-read-only", "anchor": "8-snapshots-are-read-only", "title": "8. Snapshots are read-only", "level": 4 }, { "id": "9-code-remains-truth", "anchor": "9-code-remains-truth", "title": "9. Code remains truth", "level": 4 }, { "id": "10-modules-cannot-bloat-the-kernel", "anchor": "10-modules-cannot-bloat-the-kernel", "title": "10. Modules cannot bloat the kernel", "level": 4 }, { "id": "module-model", "anchor": "module-model", "title": "Module model", "level": 2 }, { "id": "module-vocabulary", "anchor": "module-vocabulary", "title": "Module vocabulary", "level": 3 }, { "id": "runtime-behavior", "anchor": "runtime-behavior", "title": "Runtime behavior", "level": 3 }, { "id": "tooling-surface", "anchor": "tooling-surface", "title": "Tooling surface", "level": 3 }, { "id": "modules-2", "anchor": "modules-2", "title": "Example modules", "level": 3 }, { "id": "canonical-runtime-planes", "anchor": "canonical-runtime-planes", "title": "Canonical runtime planes", "level": 2 }, { "id": "targets-and-languages", "anchor": "targets-and-languages", "title": "Targets and languages", "level": 2 }, { "id": "primary-runtime-targets", "anchor": "primary-runtime-targets", "title": "Primary runtime targets", "level": 3 }, { "id": "language-tiers", "anchor": "language-tiers", "title": "Language tiers", "level": 3 }, { "id": "targets", "anchor": "targets", "title": "Universal distributed/polyglot boundary", "level": 3 }, { "id": "minimum-extension-vocabulary", "anchor": "minimum-extension-vocabulary", "title": "Minimum extension vocabulary", "level": 2 }, { "id": "structural-facets", "anchor": "structural-facets", "title": "Structural facets", "level": 3 }, { "id": "edge-facets", "anchor": "edge-facets", "title": "Edge facets", "level": 3 }, { "id": "capability-facets", "anchor": "capability-facets", "title": "Capability facets", "level": 3 }, { "id": "dominant-graph-shapes", "anchor": "dominant-graph-shapes", "title": "Dominant graph shapes", "level": 2 }, { "id": "1-route--screen--state", "anchor": "1-route--screen--state", "title": "1. Route + Screen + State", "level": 3 }, { "id": "2-service--repository", "anchor": "2-service--repository", "title": "2. Service + Repository", "level": 3 }, { "id": "3-offline-first-sync", "anchor": "3-offline-first-sync", "title": "3. Offline-first sync", "level": 3 }, { "id": "4-async-workflow", "anchor": "4-async-workflow", "title": "4. Async workflow", "level": 3 }, { "id": "5-realtime-room--actor", "anchor": "5-realtime-room--actor", "title": "5. Realtime room / actor", "level": 3 }, { "id": "6-capability-strategy", "anchor": "6-capability-strategy", "title": "6. Capability strategy", "level": 3 }, { "id": "7-deployment-cut", "anchor": "7-deployment-cut", "title": "7. Deployment cut", "level": 3 }, { "id": "8-ai-command-loop", "anchor": "8-ai-command-loop", "title": "8. AI command loop", "level": 3 }, { "id": "representative-application-set", "anchor": "representative-application-set", "title": "Representative application set", "level": 2 }, { "id": "1-notes--personal-knowledge-app", "anchor": "1-notes--personal-knowledge-app", "title": "1 Notes / Personal Knowledge App", "level": 3 }, { "id": "2-consumer-mobile-app-with-auth-and-profile", "anchor": "2-consumer-mobile-app-with-auth-and-profile", "title": "2 Consumer Mobile App with Auth and Profile", "level": 3 }, { "id": "3-offline-field-service-app", "anchor": "3-offline-field-service-app", "title": "3 Offline Field-Service App", "level": 3 }, { "id": "4-social--messaging-app", "anchor": "4-social--messaging-app", "title": "4 Social / Messaging App", "level": 3 }, { "id": "5-event--wedding-media-app", "anchor": "5-event--wedding-media-app", "title": "5 Event / Wedding Media App", "level": 3 }, { "id": "6-marketplace--ecommerce--inventory", "anchor": "6-marketplace--ecommerce--inventory", "title": "6 Marketplace / Ecommerce / Inventory", "level": 3 }, { "id": "7-saas-admin-dashboard", "anchor": "7-saas-admin-dashboard", "title": "7 SaaS Admin Dashboard", "level": 3 }, { "id": "8-collaborative-realtime-editor", "anchor": "8-collaborative-realtime-editor", "title": "8 Collaborative Realtime Editor", "level": 3 }, { "id": "9-notification-and-campaign-system", "anchor": "9-notification-and-campaign-system", "title": "9 Notification and Campaign System", "level": 3 }, { "id": "10-iot--geo--logistics-system", "anchor": "10-iot--geo--logistics-system", "title": "10 IoT / Geo / Logistics System", "level": 3 }, { "id": "11-ai-tutor--learning-platform", "anchor": "11-ai-tutor--learning-platform", "title": "11 AI Tutor / Learning Platform", "level": 3 }, { "id": "12-ai-agent-operations--workflow-automation", "anchor": "12-ai-agent-operations--workflow-automation", "title": "12 AI Agent Operations / Workflow Automation", "level": 3 }, { "id": "13-edge-api-platform", "anchor": "13-edge-api-platform", "title": "13 Edge API Platform", "level": 3 }, { "id": "14-native-c-media--compute-pipeline", "anchor": "14-native-c-media--compute-pipeline", "title": "14 Native C++ Media / Compute Pipeline", "level": 3 }, { "id": "15-brownfield-react--spring-incremental-adoption", "anchor": "15-brownfield-react--spring-incremental-adoption", "title": "15 Brownfield React + Spring Incremental Adoption", "level": 3 }, { "id": "16-reaktor-desktop--developer-tooling-app", "anchor": "16-reaktor-desktop--developer-tooling-app", "title": "16 Reaktor Desktop / Developer Tooling App", "level": 3 }, { "id": "coverage-matrix", "anchor": "coverage-matrix", "title": "Coverage matrix", "level": 2 }, { "id": "implementation-plan", "anchor": "implementation-plan", "title": "Implementation plan", "level": 2 }, { "id": "implementation", "anchor": "implementation", "title": "Build next", "level": 3 }, { "id": "1-contractid--schemaid", "anchor": "1-contractid--schemaid", "title": "1. ContractId + SchemaId", "level": 4 }, { "id": "2-facetset", "anchor": "2-facetset", "title": "2. FacetSet", "level": 4 }, { "id": "3-capabilityprofile", "anchor": "3-capabilityprofile", "title": "3. CapabilityProfile", "level": 4 }, { "id": "4-graphsnapshot", "anchor": "4-graphsnapshot", "title": "4. GraphSnapshot", "level": 4 }, { "id": "5-grapheventbus", "anchor": "5-grapheventbus", "title": "5. GraphEventBus", "level": 4 }, { "id": "6-graphcommand-v0", "anchor": "6-graphcommand-v0", "title": "6. GraphCommand v0", "level": 4 }, { "id": "7-graphvalidator", "anchor": "7-graphvalidator", "title": "7. GraphValidator", "level": 4 }, { "id": "8-moduleregistry", "anchor": "8-moduleregistry", "title": "8. ModuleRegistry", "level": 4 }, { "id": "9-route-attachment-roles", "anchor": "9-route-attachment-roles", "title": "9. Route attachment roles", "level": 4 }, { "id": "10-transport-neutral-services", "anchor": "10-transport-neutral-services", "title": "10. Transport-neutral services", "level": 4 }, { "id": "implementation-2", "anchor": "implementation-2", "title": "Golden samples", "level": 3 }, { "id": "final-design-heuristic", "anchor": "final-design-heuristic", "title": "Final design heuristic", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "graph-kernel-analysis", "anchor": "implementation", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-server", "anchor": "api-evolution", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "implementation" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "implementation" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "hangar", "owner": "Claude", "kind": "architecture", "summary": "What Hangar is and how its window works: one title row, the macOS menu bar the way IntelliJ uses it, the twelve panes with their shortcuts and docs, how panes link, and the one map style every graph shares.", "use": "Start here to find your way around the desktop app; each pane row links to that pane's own document.", "region": "workbench-surfaces", "order": 3, "title": "Hangar — the Reaktor desktop app", "nav": "Hangar", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/hangar", "revision": "1030c55b77342f9c2a8dfeb9b5678fa286af1d6b368bd6115a10d15cde708865", "status": "unverified", "renderingRevision": "e2b85e0b876bf289c709519ef9885b3c3b827b67a5bda92c9e398e7d78ada594", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/hangar", "polarity": "Neutral" }, { "id": "section-window", "anchor": "window", "label": "The window", "profile": "section", "contract": "https://reaktor.build/docs/hangar#window", "polarity": "Neutral" }, { "id": "section-panes", "anchor": "panes", "label": "Panes", "profile": "section", "contract": "https://reaktor.build/docs/hangar#panes", "polarity": "Neutral" }, { "id": "section-agent", "anchor": "agent", "label": "Agents and the MCP door", "profile": "section", "contract": "https://reaktor.build/docs/hangar#agent", "polarity": "Neutral" }, { "id": "section-ai", "anchor": "ai", "label": "AI: bots, AI Gateway and Workers", "profile": "section", "contract": "https://reaktor.build/docs/hangar#ai", "polarity": "Neutral" }, { "id": "section-one-map-style", "anchor": "one-map-style", "label": "One map style", "profile": "section", "contract": "https://reaktor.build/docs/hangar#one-map-style", "polarity": "Neutral" }, { "id": "section-hangar-map", "anchor": "hangar-map", "label": "Hangar on its own map", "profile": "section", "contract": "https://reaktor.build/docs/hangar#hangar-map", "polarity": "Neutral" } ], "relations": [ { "id": "hangar:references-reaktor-graph-pane", "kind": "references", "owner": "hangar", "incidences": [ { "node": "hangar", "port": "section-panes", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "hangar:references-reaktor-devtools", "kind": "references", "owner": "hangar", "incidences": [ { "node": "hangar", "port": "section-panes", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "hangar:references-reaktor-agent-workspace", "kind": "references", "owner": "hangar", "incidences": [ { "node": "hangar", "port": "section-panes", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "hangar:references-reaktor-cloud-cloud-apis", "kind": "references", "owner": "hangar", "incidences": [ { "node": "hangar", "port": "section-panes", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "section-cloud-apis", "role": "target", "ordinal": 0 } ] }, { "id": "hangar:references-reaktor-cloud", "kind": "references", "owner": "hangar", "incidences": [ { "node": "hangar", "port": "section-panes", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "hangar:references-reaktor-analytics-telemetry", "kind": "references", "owner": "hangar", "incidences": [ { "node": "hangar", "port": "section-panes", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "hangar:references-reaktor-workbench-links", "kind": "references", "owner": "hangar", "incidences": [ { "node": "hangar", "port": "section-panes", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "hangar.json", "sections": [ { "id": "hangar", "anchor": "hangar", "title": "Hangar", "level": 1 }, { "id": "window", "anchor": "window", "title": "The window", "level": 2 }, { "id": "panes", "anchor": "panes", "title": "Panes", "level": 2 }, { "id": "agent", "anchor": "agent", "title": "Agents and the MCP door", "level": 2 }, { "id": "ai", "anchor": "ai", "title": "AI: bots, AI Gateway and Workers", "level": 2 }, { "id": "one-map-style", "anchor": "one-map-style", "title": "One map style", "level": 2 }, { "id": "hangar-map", "anchor": "hangar-map", "title": "Hangar on its own map", "level": 2 }, { "id": "shortcuts", "anchor": "shortcuts", "title": "Other shortcuts", "level": 2 } ], "links": [ { "id": "reaktor-graph-pane", "anchor": "", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "panes" }, { "id": "hangar", "anchor": "agent", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "panes" }, { "id": "hangar", "anchor": "ai", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-cloud", "anchor": "cloud-apis", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "panes" }, { "id": "reaktor-cloud", "anchor": "cloud-apis", "relation": "references", "sourceAnchor": "ai" } ] }, { "id": "kotlin-clr", "owner": "Claude", "kind": "design", "summary": "A Kotlin compiler backend emitting CIL and ECMA-335 metadata: an importer that reads assembly metadata lazily in the frontend the way Kotlin reads Java, a two-process emitter that can host Roslyn, a single CLR-shaped member set, the type-mapping decision table including the cases that do not map (struct value classes, enums in both directions, ByteArray, iterator protocols), suspend over Task without losing structured concurrency, reflection-free metadata for IL2CPP and NativeAOT, NuGet and MSBuild packaging as the adoption bottleneck, the coroutines and serialisation ports the target requires, and a first milestone that is a hand-written CIL conformance corpus.", "use": "Read before any work on a .NET target. §14 covers the library scope — atomicfu, coroutines, serialisation, the Tier-1 list and the ports to skip. §17 is the Reaktor decision: the FFI C ABI and rgp/1 give C# a bridged seat years earlier, while Kotlin/CLR makes C# first-party and is the only answer for hosts that make you author host types. Includes the cost ladder, kill criteria and a reading order. None of it is built.", "region": "ffi", "order": 1, "title": "Kotlin/CLR — a .NET backend for Kotlin", "nav": "Kotlin/CLR", "group": "flexbuffers-ffi", "subsection": "ffi", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/kotlin-clr", "revision": "fe254cc626d9e2f8d1d22552881d4ed6542f1bd344856bdbffa16492f5e74078", "status": "unverified", "renderingRevision": "68b6fcf0ffd0788cb7cac1539b2d8bf5874353572836a3a4a2c4a5734bf4e19f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/kotlin-clr", "polarity": "Neutral" }, { "id": "section-answer", "anchor": "answer", "label": "1. The answer first", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#answer", "polarity": "Neutral" }, { "id": "section-why-clr", "anchor": "why-clr", "label": "2. Why the CLR", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#why-clr", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "3. Where this sits in the compiler", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#architecture", "polarity": "Neutral" }, { "id": "section-abi", "anchor": "abi", "label": "4. The ABI: a single member set", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#abi", "polarity": "Neutral" }, { "id": "section-primitives", "anchor": "primitives", "label": "5. Primitives, strings and numbers", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#primitives", "polarity": "Neutral" }, { "id": "section-nullability", "anchor": "nullability", "label": "6. Nullability", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#nullability", "polarity": "Neutral" }, { "id": "section-ecosystem", "anchor": "ecosystem", "label": "14. The libraries this needs", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#ecosystem", "polarity": "Neutral" }, { "id": "section-reaktor", "anchor": "reaktor", "label": "17. What this means for Reaktor", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#reaktor", "polarity": "Neutral" }, { "id": "section-source-generators", "anchor": "source-generators", "label": "9.6 Source generators, and the C# facade", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#source-generators", "polarity": "Neutral" }, { "id": "section-concurrency", "anchor": "concurrency", "label": "8. Concurrency: suspend and Task", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#concurrency", "polarity": "Neutral" }, { "id": "section-exceptions", "anchor": "exceptions", "label": "7.4 Exceptions", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#exceptions", "polarity": "Neutral" }, { "id": "section-aot", "anchor": "aot", "label": "10. Metadata, reflection and AOT", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#aot", "polarity": "Neutral" }, { "id": "section-emitter", "anchor": "emitter", "label": "3.2 The emitter", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#emitter", "polarity": "Neutral" }, { "id": "section-arithmetic", "anchor": "arithmetic", "label": "5.2 Arithmetic", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#arithmetic", "polarity": "Neutral" }, { "id": "section-ikvm", "anchor": "ikvm", "label": "15. IKVM's real job", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#ikvm", "polarity": "Neutral" }, { "id": "section-atomicfu", "anchor": "atomicfu", "label": "14.1 atomicfu comes first", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#atomicfu", "polarity": "Neutral" }, { "id": "section-coroutines", "anchor": "coroutines", "label": "14.2 Coroutines", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#coroutines", "polarity": "Neutral" }, { "id": "section-tier1", "anchor": "tier1", "label": "14.4 Tier 1: needed for anything real", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#tier1", "polarity": "Neutral" }, { "id": "section-m3", "anchor": "m3", "label": "Milestone 3 — kotlin-stdlib-clr on the BCL", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#m3", "polarity": "Neutral" }, { "id": "section-risk", "anchor": "risk", "label": "16. Cost, risk and kill criteria", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#risk", "polarity": "Neutral" }, { "id": "section-consuming", "anchor": "consuming", "label": "9. Consuming .NET: the parts that decide whether this is usable", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#consuming", "polarity": "Neutral" }, { "id": "section-host-types", "anchor": "host-types", "label": "Which hosts have no bridged answer at all", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#host-types", "polarity": "Neutral" }, { "id": "section-object-model", "anchor": "object-model", "label": "7. The object model, decision by decision", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#object-model", "polarity": "Neutral" }, { "id": "section-importer", "anchor": "importer", "label": "3.1 The importer", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#importer", "polarity": "Neutral" }, { "id": "section-collections", "anchor": "collections", "label": "7.6 Collections", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#collections", "polarity": "Neutral" }, { "id": "section-reaktor-modules", "anchor": "reaktor-modules", "label": "14.5 Tier 2: Reaktor's own modules", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#reaktor-modules", "polarity": "Neutral" }, { "id": "section-related-serialization-and-ffi-evidence", "anchor": "related-serialization-and-ffi-evidence", "label": "Related serialization and FFI evidence", "profile": "section", "contract": "https://reaktor.build/docs/kotlin-clr#related-serialization-and-ffi-evidence", "polarity": "Neutral" } ], "relations": [ { "id": "kotlin-clr:references-reaktor-ffi", "kind": "references", "owner": "kotlin-clr", "incidences": [ { "node": "kotlin-clr", "port": "section-answer", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "kotlin-clr:references-reaktor-graph-protocol", "kind": "references", "owner": "kotlin-clr", "incidences": [ { "node": "kotlin-clr", "port": "section-answer", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "kotlin-clr:references-flexbuffer-implementation", "kind": "references", "owner": "kotlin-clr", "incidences": [ { "node": "kotlin-clr", "port": "section-reaktor-modules", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "kotlin-clr:references-flexbuffer-performance-review", "kind": "references", "owner": "kotlin-clr", "incidences": [ { "node": "kotlin-clr", "port": "section-related-serialization-and-ffi-evidence", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "kotlin-clr:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "kotlin-clr", "incidences": [ { "node": "kotlin-clr", "port": "section-related-serialization-and-ffi-evidence", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "kotlin-clr.json", "sections": [ { "id": "kotlinclr--a-net-backend-for-kotlin", "anchor": "kotlinclr--a-net-backend-for-kotlin", "title": "Kotlin/CLR — a .NET backend for Kotlin", "level": 1 }, { "id": "answer", "anchor": "answer", "title": "1. The answer first", "level": 2 }, { "id": "why-clr", "anchor": "why-clr", "title": "2. Why the CLR", "level": 2 }, { "id": "architecture", "anchor": "architecture", "title": "3. Where this sits in the compiler", "level": 2 }, { "id": "importer", "anchor": "importer", "title": "3.1 The importer", "level": 3 }, { "id": "emitter", "anchor": "emitter", "title": "3.2 The emitter", "level": 3 }, { "id": "abi", "anchor": "abi", "title": "4. The ABI: a single member set", "level": 2 }, { "id": "primitives", "anchor": "primitives", "title": "5. Primitives, strings and numbers", "level": 2 }, { "id": "bytearray", "anchor": "bytearray", "title": "5.1 ByteArray is the mapping that bites", "level": 3 }, { "id": "arithmetic", "anchor": "arithmetic", "title": "5.2 Arithmetic", "level": 3 }, { "id": "strings", "anchor": "strings", "title": "5.3 Strings", "level": 3 }, { "id": "nullability", "anchor": "nullability", "title": "6. Nullability", "level": 2 }, { "id": "object-model", "anchor": "object-model", "title": "7. The object model, decision by decision", "level": 2 }, { "id": "generics", "anchor": "generics", "title": "7.1 Generics, variance and constraints", "level": 3 }, { "id": "value-classes", "anchor": "value-classes", "title": "7.2 Value classes and structs", "level": 3 }, { "id": "enums", "anchor": "enums", "title": "7.3 Enums are broken in both directions", "level": 3 }, { "id": "exceptions", "anchor": "exceptions", "title": "7.4 Exceptions", "level": 3 }, { "id": "declarations", "anchor": "declarations", "title": "7.5 Declarations", "level": 3 }, { "id": "collections", "anchor": "collections", "title": "7.6 Collections", "level": 3 }, { "id": "concurrency", "anchor": "concurrency", "title": "8. Concurrency: suspend and Task", "level": 2 }, { "id": "consuming", "anchor": "consuming", "title": "9. Consuming .NET: the parts that decide whether this is usable", "level": 2 }, { "id": "attributes", "anchor": "attributes", "title": "9.1 Applying attributes is Phase-1 work", "level": 3 }, { "id": "events", "anchor": "events", "title": "9.2 Events", "level": 3 }, { "id": "byref", "anchor": "byref", "title": "9.3 ref, out, in", "level": 3 }, { "id": "spans", "anchor": "spans", "title": "9.4 Span and ref struct", "level": 3 }, { "id": "static-abstract", "anchor": "static-abstract", "title": "9.5 Static abstract interface members", "level": 3 }, { "id": "source-generators", "anchor": "source-generators", "title": "9.6 Source generators, and the C# facade", "level": 3 }, { "id": "names", "anchor": "names", "title": "9.7 Names", "level": 3 }, { "id": "aot", "anchor": "aot", "title": "10. Metadata, reflection and AOT", "level": 2 }, { "id": "build", "anchor": "build", "title": "11. Build, packaging and debugging", "level": 2 }, { "id": "testing", "anchor": "testing", "title": "12. How this gets tested", "level": 2 }, { "id": "sequencing", "anchor": "sequencing", "title": "13. Sequencing", "level": 2 }, { "id": "m0", "anchor": "m0", "title": "Milestone 0 — the ABI, written by hand", "level": 3 }, { "id": "m1", "anchor": "m1", "title": "Milestone 1 — Hello.dll", "level": 3 }, { "id": "m2", "anchor": "m2", "title": "Milestone 2 — the importer, and expect/actual", "level": 3 }, { "id": "m3", "anchor": "m3", "title": "Milestone 3 — kotlin-stdlib-clr on the BCL", "level": 3 }, { "id": "m4", "anchor": "m4", "title": "Milestone 4 — idiomatic interop", "level": 3 }, { "id": "m5", "anchor": "m5", "title": "Milestone 5 — concurrency, and kotlinx-coroutines-core", "level": 3 }, { "id": "m6", "anchor": "m6", "title": "Milestone 6 — first host: a plain net8.0 console and ASP.NET app", "level": 3 }, { "id": "m7", "anchor": "m7", "title": "Milestone 7 — Godot", "level": 3 }, { "id": "m8", "anchor": "m8", "title": "Milestone 8 — Unity", "level": 3 }, { "id": "m9", "anchor": "m9", "title": "Milestone 9 — performance and AOT", "level": 3 }, { "id": "ecosystem", "anchor": "ecosystem", "title": "14. The libraries this needs", "level": 2 }, { "id": "atomicfu", "anchor": "atomicfu", "title": "14.1 atomicfu comes first", "level": 3 }, { "id": "coroutines", "anchor": "coroutines", "title": "14.2 Coroutines", "level": 3 }, { "id": "serialization", "anchor": "serialization", "title": "14.3 Serialisation", "level": 3 }, { "id": "tier1", "anchor": "tier1", "title": "14.4 Tier 1: needed for anything real", "level": 3 }, { "id": "reaktor-modules", "anchor": "reaktor-modules", "title": "14.5 Tier 2: Reaktor's own modules", "level": 3 }, { "id": "upstreaming", "anchor": "upstreaming", "title": "14.6 Getting them, and upstreaming them", "level": 3 }, { "id": "ikvm", "anchor": "ikvm", "title": "15. IKVM's real job", "level": 2 }, { "id": "risk", "anchor": "risk", "title": "16. Cost, risk and kill criteria", "level": 2 }, { "id": "reaktor", "anchor": "reaktor", "title": "17. What this means for Reaktor", "level": 2 }, { "id": "bridged-vs-first-party", "anchor": "bridged-vs-first-party", "title": "Bridged is not first-party", "level": 3 }, { "id": "host-types", "anchor": "host-types", "title": "Which hosts have no bridged answer at all", "level": 3 }, { "id": "use-cases", "anchor": "use-cases", "title": "18. Use cases, re-ranked", "level": 2 }, { "id": "study", "anchor": "study", "title": "19. What to read, in the order the decisions arrive", "level": 2 }, { "id": "study-have", "anchor": "study-have", "title": "Already in Manna", "level": 3 }, { "id": "study-missing", "anchor": "study-missing", "title": "Missing, and core", "level": 3 }, { "id": "study-order", "anchor": "study-order", "title": "The order", "level": 3 }, { "id": "open", "anchor": "open", "title": "20. Open questions", "level": 2 }, { "id": "related-serialization-and-ffi-evidence", "anchor": "related-serialization-and-ffi-evidence", "title": "Related serialization and FFI evidence", "level": 2 } ], "links": [ { "id": "kotlin-clr", "anchor": "ecosystem", "relation": "references", "sourceAnchor": "answer" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "answer" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "answer" }, { "id": "kotlin-clr", "anchor": "reaktor", "relation": "references", "sourceAnchor": "answer" }, { "id": "kotlin-clr", "anchor": "source-generators", "relation": "references", "sourceAnchor": "emitter" }, { "id": "kotlin-clr", "anchor": "concurrency", "relation": "references", "sourceAnchor": "abi" }, { "id": "kotlin-clr", "anchor": "exceptions", "relation": "references", "sourceAnchor": "primitives" }, { "id": "kotlin-clr", "anchor": "aot", "relation": "references", "sourceAnchor": "generics" }, { "id": "kotlin-clr", "anchor": "aot", "relation": "references", "sourceAnchor": "concurrency" }, { "id": "kotlin-clr", "anchor": "emitter", "relation": "references", "sourceAnchor": "source-generators" }, { "id": "kotlin-clr", "anchor": "abi", "relation": "references", "sourceAnchor": "build" }, { "id": "kotlin-clr", "anchor": "arithmetic", "relation": "references", "sourceAnchor": "testing" }, { "id": "kotlin-clr", "anchor": "aot", "relation": "references", "sourceAnchor": "testing" }, { "id": "kotlin-clr", "anchor": "abi", "relation": "references", "sourceAnchor": "testing" }, { "id": "kotlin-clr", "anchor": "ikvm", "relation": "references", "sourceAnchor": "m3" }, { "id": "kotlin-clr", "anchor": "atomicfu", "relation": "references", "sourceAnchor": "m3" }, { "id": "kotlin-clr", "anchor": "concurrency", "relation": "references", "sourceAnchor": "m5" }, { "id": "kotlin-clr", "anchor": "coroutines", "relation": "references", "sourceAnchor": "m5" }, { "id": "kotlin-clr", "anchor": "tier1", "relation": "references", "sourceAnchor": "m6" }, { "id": "kotlin-clr", "anchor": "source-generators", "relation": "references", "sourceAnchor": "m7" }, { "id": "kotlin-clr", "anchor": "m3", "relation": "references", "sourceAnchor": "atomicfu" }, { "id": "kotlin-clr", "anchor": "aot", "relation": "references", "sourceAnchor": "coroutines" }, { "id": "kotlin-clr", "anchor": "aot", "relation": "references", "sourceAnchor": "serialization" }, { "id": "kotlin-clr", "anchor": "coroutines", "relation": "references", "sourceAnchor": "tier1" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "tier1" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-modules" }, { "id": "kotlin-clr", "anchor": "risk", "relation": "references", "sourceAnchor": "upstreaming" }, { "id": "kotlin-clr", "anchor": "consuming", "relation": "references", "sourceAnchor": "upstreaming" }, { "id": "kotlin-clr", "anchor": "ecosystem", "relation": "references", "sourceAnchor": "ikvm" }, { "id": "kotlin-clr", "anchor": "ecosystem", "relation": "references", "sourceAnchor": "risk" }, { "id": "kotlin-clr", "anchor": "source-generators", "relation": "references", "sourceAnchor": "risk" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "reaktor" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "reaktor" }, { "id": "kotlin-clr", "anchor": "risk", "relation": "references", "sourceAnchor": "reaktor" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "bridged-vs-first-party" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "bridged-vs-first-party" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "host-types" }, { "id": "kotlin-clr", "anchor": "host-types", "relation": "references", "sourceAnchor": "use-cases" }, { "id": "kotlin-clr", "anchor": "source-generators", "relation": "references", "sourceAnchor": "use-cases" }, { "id": "kotlin-clr", "anchor": "source-generators", "relation": "references", "sourceAnchor": "study-have" }, { "id": "kotlin-clr", "anchor": "object-model", "relation": "references", "sourceAnchor": "study-missing" }, { "id": "kotlin-clr", "anchor": "importer", "relation": "references", "sourceAnchor": "study-missing" }, { "id": "kotlin-clr", "anchor": "coroutines", "relation": "references", "sourceAnchor": "open" }, { "id": "kotlin-clr", "anchor": "collections", "relation": "references", "sourceAnchor": "open" }, { "id": "kotlin-clr", "anchor": "nullability", "relation": "references", "sourceAnchor": "open" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-serialization-and-ffi-evidence" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "related-serialization-and-ffi-evidence" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "related-serialization-and-ffi-evidence" } ] }, { "id": "manna-functional-designs", "owner": "Codex", "kind": "design", "summary": "The expanded Manna Pencil specification: 42 desktop and 43 mobile screens, the full multilayer Atlas, connected workflows, editing and recovery states.", "use": "Use with the Manna HLD to implement the product journeys. Includes previews, graph-scale boundaries, interaction contracts and the complete canvas register.", "region": "products-apps", "order": 1, "title": "Manna — Functional Design Handoff", "nav": "Manna Designs", "group": "products", "subsection": "products-apps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/manna-functional-designs", "revision": "1598ddc6be837dd57acea803088c4137238e4801d40902eaad6a810459433bc1", "status": "unverified", "renderingRevision": "d0ae8ad04a118d7e7df7f34adefade3b219533e365b4bb5384a8401ffadbad8d", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/manna-functional-designs", "polarity": "Neutral" }, { "id": "section-1-what-changed", "anchor": "1-what-changed", "label": "1 What changed", "profile": "section", "contract": "https://reaktor.build/docs/manna-functional-designs#1-what-changed", "polarity": "Neutral" }, { "id": "section-2-review-the-connected-journeys", "anchor": "2-review-the-connected-journeys", "label": "2 Review the connected journeys", "profile": "section", "contract": "https://reaktor.build/docs/manna-functional-designs#2-review-the-connected-journeys", "polarity": "Neutral" }, { "id": "section-3-interaction-and-implementation-contracts", "anchor": "3-interaction-and-implementation-contracts", "label": "3 Interaction and implementation contracts", "profile": "section", "contract": "https://reaktor.build/docs/manna-functional-designs#3-interaction-and-implementation-contracts", "polarity": "Neutral" }, { "id": "section-4-navigating-the-entire-legacy-graph", "anchor": "4-navigating-the-entire-legacy-graph", "label": "4 Navigating the entire legacy graph", "profile": "section", "contract": "https://reaktor.build/docs/manna-functional-designs#4-navigating-the-entire-legacy-graph", "polarity": "Neutral" }, { "id": "section-5-state-and-accessibility-coverage", "anchor": "5-state-and-accessibility-coverage", "label": "5 State and accessibility coverage", "profile": "section", "contract": "https://reaktor.build/docs/manna-functional-designs#5-state-and-accessibility-coverage", "polarity": "Neutral" }, { "id": "section-6-complete-canvas-register", "anchor": "6-complete-canvas-register", "label": "6 Complete canvas register", "profile": "section", "contract": "https://reaktor.build/docs/manna-functional-designs#6-complete-canvas-register", "polarity": "Neutral" } ], "relations": [ { "id": "manna-functional-designs:references-manna-hld", "kind": "references", "owner": "manna-functional-designs", "incidences": [ { "node": "manna-functional-designs", "port": "section-3-interaction-and-implementation-contracts", "role": "source", "ordinal": 0 }, { "node": "manna-hld", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-functional-designs:references-reaktor-surface", "kind": "references", "owner": "manna-functional-designs", "incidences": [ { "node": "manna-functional-designs", "port": "section-3-interaction-and-implementation-contracts", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-functional-designs:references-manna-hld-3-system-structure", "kind": "references", "owner": "manna-functional-designs", "incidences": [ { "node": "manna-functional-designs", "port": "section-3-interaction-and-implementation-contracts", "role": "source", "ordinal": 0 }, { "node": "manna-hld", "port": "section-3-system-structure", "role": "target", "ordinal": 0 } ] } ] }, "content": "manna-functional-designs.json", "sections": [ { "id": "manna--functional-design-handoff", "anchor": "manna--functional-design-handoff", "title": "Manna — Functional Design Handoff", "level": 1 }, { "id": "1-what-changed", "anchor": "1-what-changed", "title": "1 What changed", "level": 2 }, { "id": "2-review-the-connected-journeys", "anchor": "2-review-the-connected-journeys", "title": "2 Review the connected journeys", "level": 2 }, { "id": "home-and-memory", "anchor": "home-and-memory", "title": "Home and memory", "level": 3 }, { "id": "learning-and-evidence", "anchor": "learning-and-evidence", "title": "Learning and evidence", "level": 3 }, { "id": "the-full-knowledge-map", "anchor": "the-full-knowledge-map", "title": "The full knowledge map", "level": 3 }, { "id": "work-context-and-recovery", "anchor": "work-context-and-recovery", "title": "Work, context and recovery", "level": 3 }, { "id": "mobile-capability-without-a-compressed-desktop", "anchor": "mobile-capability-without-a-compressed-desktop", "title": "Mobile capability without a compressed desktop", "level": 3 }, { "id": "3-interaction-and-implementation-contracts", "anchor": "3-interaction-and-implementation-contracts", "title": "3 Interaction and implementation contracts", "level": 2 }, { "id": "4-navigating-the-entire-legacy-graph", "anchor": "4-navigating-the-entire-legacy-graph", "title": "4 Navigating the entire legacy graph", "level": 2 }, { "id": "5-state-and-accessibility-coverage", "anchor": "5-state-and-accessibility-coverage", "title": "5 State and accessibility coverage", "level": 2 }, { "id": "6-complete-canvas-register", "anchor": "6-complete-canvas-register", "title": "6 Complete canvas register", "level": 2 }, { "id": "7-verification-and-delivery", "anchor": "7-verification-and-delivery", "title": "7 Verification and delivery", "level": 2 } ], "links": [ { "id": "manna-hld", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "manna-hld", "anchor": "", "relation": "references", "sourceAnchor": "3-interaction-and-implementation-contracts" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "3-interaction-and-implementation-contracts" }, { "id": "manna-hld", "anchor": "3-system-structure", "relation": "references", "sourceAnchor": "3-interaction-and-implementation-contracts" }, { "id": "manna-hld", "anchor": "", "relation": "references", "sourceAnchor": "7-verification-and-delivery" } ] }, { "id": "manna-hld", "owner": "Codex", "kind": "architecture", "summary": "Manna's mobile and desktop web architecture: scoped Reaktor graphs, typed ports and actors, Surface behavior, a full multilayer knowledge map, data ownership, AI, offline recovery and legacy migration.", "use": "Use as the implementation HLD for Manna. Seven diagrams connect framework capabilities to product journeys, with current source evidence separated from proposed contracts and delivery gates.", "region": "products-apps", "order": 0, "title": "Manna HLD — Implementation on Reaktor Graph and Surface", "nav": "Manna HLD", "group": "products", "subsection": "products-apps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/manna-hld", "revision": "ba1cdca617f06779caba308ef74eab756d0d6f57b8b97c29533eee26d06e0eb7", "status": "unverified", "renderingRevision": "5ee55e9bf2d7d002a26be139eb671199201a2447ba76a4362fe8f9094eebff6f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://reaktor.build/docs/img/manna-hld/architecture.svg", "https://reaktor.build/docs/img/manna-hld/runtime-scopes.svg", "https://reaktor.build/docs/img/manna-hld/graph-identities.svg", "https://reaktor.build/docs/img/manna-hld/map-query.svg", "https://reaktor.build/docs/img/manna-hld/surface-state.svg", "https://react.dev/reference/react/useSyncExternalStore", "https://www.rfc-editor.org/rfc/rfc5545", "https://developers.cloudflare.com/durable-objects/api/alarms/", "https://reaktor.build/docs/img/manna-hld/command-effects.svg", "https://reaktor.build/docs/img/manna-hld/migration.svg" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/manna-hld", "polarity": "Neutral" }, { "id": "section-1-architecture-decision", "anchor": "1-architecture-decision", "label": "1 Architecture decision", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#1-architecture-decision", "polarity": "Neutral" }, { "id": "section-2-existing-implementation-and-reuse", "anchor": "2-existing-implementation-and-reuse", "label": "2 Existing implementation and reuse", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#2-existing-implementation-and-reuse", "polarity": "Neutral" }, { "id": "section-3-system-structure", "anchor": "3-system-structure", "label": "3 System structure", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#3-system-structure", "polarity": "Neutral" }, { "id": "section-4-code-ownership-and-package-plan", "anchor": "4-code-ownership-and-package-plan", "label": "4 Code ownership and package plan", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#4-code-ownership-and-package-plan", "polarity": "Neutral" }, { "id": "section-5-domain-model-and-identity", "anchor": "5-domain-model-and-identity", "label": "5 Domain model and identity", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#5-domain-model-and-identity", "polarity": "Neutral" }, { "id": "section-6-storage-and-consistency", "anchor": "6-storage-and-consistency", "label": "6 Storage and consistency", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#6-storage-and-consistency", "polarity": "Neutral" }, { "id": "section-source-s01", "anchor": "source-s01", "label": "S01 Product requirements", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s01", "polarity": "Neutral" }, { "id": "section-source-s02", "anchor": "source-s02", "label": "S02 Repository composition", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s02", "polarity": "Neutral" }, { "id": "section-source-s03", "anchor": "source-s03", "label": "S03 Current legacy API boundary", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s03", "polarity": "Neutral" }, { "id": "section-source-s04", "anchor": "source-s04", "label": "S04 Native baseline", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s04", "polarity": "Neutral" }, { "id": "section-source-s05", "anchor": "source-s05", "label": "S05 Legacy graph and transformation", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s05", "polarity": "Neutral" }, { "id": "section-source-s06", "anchor": "source-s06", "label": "S06 Graph runtime", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s06", "polarity": "Neutral" }, { "id": "section-source-s07", "anchor": "source-s07", "label": "S07 Graph editor", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s07", "polarity": "Neutral" }, { "id": "section-source-s08", "anchor": "source-s08", "label": "S08 Implemented Surface primitives", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s08", "polarity": "Neutral" }, { "id": "section-source-s09", "anchor": "source-s09", "label": "S09 Surface target architecture", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s09", "polarity": "Neutral" }, { "id": "section-source-s10", "anchor": "source-s10", "label": "S10 Persistence and scheduling substrate", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s10", "polarity": "Neutral" }, { "id": "section-source-s11", "anchor": "source-s11", "label": "S11 Authority contracts", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s11", "polarity": "Neutral" }, { "id": "section-source-s12", "anchor": "source-s12", "label": "S12 Context and agents", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s12", "polarity": "Neutral" }, { "id": "section-source-s13", "anchor": "source-s13", "label": "S13 Services and observation", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s13", "polarity": "Neutral" }, { "id": "section-source-s14", "anchor": "source-s14", "label": "S14 Hosting and control plane", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s14", "polarity": "Neutral" }, { "id": "section-source-s15", "anchor": "source-s15", "label": "S15 Planned Graph Protocol", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s15", "polarity": "Neutral" }, { "id": "section-source-s16", "anchor": "source-s16", "label": "S16 Theme composition example", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#source-s16", "polarity": "Neutral" }, { "id": "section-typed-maps-visitors-and-source-ownership", "anchor": "typed-maps-visitors-and-source-ownership", "label": "Typed maps, visitors and source ownership", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#typed-maps-visitors-and-source-ownership", "polarity": "Neutral" }, { "id": "section-graph-composition-ports-and-lifetimes", "anchor": "graph-composition-ports-and-lifetimes", "label": "Graph composition, ports and lifetimes", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#graph-composition-ports-and-lifetimes", "polarity": "Neutral" }, { "id": "section-capability-offers-and-deliberate-fallback", "anchor": "capability-offers-and-deliberate-fallback", "label": "Capability offers and deliberate fallback", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#capability-offers-and-deliberate-fallback", "polarity": "Neutral" }, { "id": "section-product-composition-over-surface-primitives", "anchor": "product-composition-over-surface-primitives", "label": "Product composition over Surface primitives", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#product-composition-over-surface-primitives", "polarity": "Neutral" }, { "id": "section-21-reaktor-integration-and-framework-growth", "anchor": "21-reaktor-integration-and-framework-growth", "label": "21 Reaktor integration and framework growth", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#21-reaktor-integration-and-framework-growth", "polarity": "Neutral" }, { "id": "section-a-connected-development-and-verification-loop", "anchor": "a-connected-development-and-verification-loop", "label": "A connected development and verification loop", "profile": "section", "contract": "https://reaktor.build/docs/manna-hld#a-connected-development-and-verification-loop", "polarity": "Neutral" } ], "relations": [ { "id": "manna-hld:references-reaktor-framework-overview", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-typed-maps-visitors-and-source-ownership", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-module-review", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-surface", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-manna-functional-designs", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "page", "role": "source", "ordinal": 0 }, { "node": "manna-functional-designs", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-graph-kernel-analysis", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-graph-composition-ports-and-lifetimes", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-component-lifecycle", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-graph-composition-ports-and-lifetimes", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-actor-model", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-graph-composition-ports-and-lifetimes", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor_graph_visitors_design", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-typed-maps-visitors-and-source-ownership", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-capability", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-capability-offers-and-deliberate-fallback", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-surface-application-patterns", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-capability-offers-and-deliberate-fallback", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-application-patterns", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-product-composition-over-surface-primitives", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-surface-contracts-and-interaction", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-product-composition-over-surface-primitives", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-surface-dynamic-ui-and-verification", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-product-composition-over-surface-primitives", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-module-execution-plan", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-21-reaktor-integration-and-framework-growth", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-db", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-21-reaktor-integration-and-framework-growth", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-workbench-layers", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-a-connected-development-and-verification-loop", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-tooling-layer", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-a-connected-development-and-verification-loop", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-devtools", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-a-connected-development-and-verification-loop", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-graph-protocol", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-a-connected-development-and-verification-loop", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-hld:references-reaktor-formal-methods", "kind": "references", "owner": "manna-hld", "incidences": [ { "node": "manna-hld", "port": "section-a-connected-development-and-verification-loop", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "manna-hld.json", "sections": [ { "id": "manna-hld--implementation-on-reaktor-graph-and-surface", "anchor": "manna-hld--implementation-on-reaktor-graph-and-surface", "title": "Manna HLD — Implementation on Reaktor Graph and Surface", "level": 1 }, { "id": "1-architecture-decision", "anchor": "1-architecture-decision", "title": "1 Architecture decision", "level": 2 }, { "id": "2-existing-implementation-and-reuse", "anchor": "2-existing-implementation-and-reuse", "title": "2 Existing implementation and reuse", "level": 2 }, { "id": "3-system-structure", "anchor": "3-system-structure", "title": "3 System structure", "level": 2 }, { "id": "4-code-ownership-and-package-plan", "anchor": "4-code-ownership-and-package-plan", "title": "4 Code ownership and package plan", "level": 2 }, { "id": "reaktor-capability-mapping", "anchor": "reaktor-capability-mapping", "title": "Reaktor capability mapping", "level": 3 }, { "id": "graph-composition-ports-and-lifetimes", "anchor": "graph-composition-ports-and-lifetimes", "title": "Graph composition, ports and lifetimes", "level": 3 }, { "id": "typed-maps-visitors-and-source-ownership", "anchor": "typed-maps-visitors-and-source-ownership", "title": "Typed maps, visitors and source ownership", "level": 3 }, { "id": "capability-offers-and-deliberate-fallback", "anchor": "capability-offers-and-deliberate-fallback", "title": "Capability offers and deliberate fallback", "level": 3 }, { "id": "5-domain-model-and-identity", "anchor": "5-domain-model-and-identity", "title": "5 Domain model and identity", "level": 2 }, { "id": "6-storage-and-consistency", "anchor": "6-storage-and-consistency", "title": "6 Storage and consistency", "level": 2 }, { "id": "authoritative-ownership", "anchor": "authoritative-ownership", "title": "Authoritative ownership", "level": 3 }, { "id": "command-transaction", "anchor": "command-transaction", "title": "Command transaction", "level": 3 }, { "id": "7-the-full-knowledge-graph-map", "anchor": "7-the-full-knowledge-graph-map", "title": "7 The full knowledge graph map", "level": 2 }, { "id": "semantic-scale-and-map-behavior", "anchor": "semantic-scale-and-map-behavior", "title": "Semantic scale and map behavior", "level": 3 }, { "id": "bounded-query-contract", "anchor": "bounded-query-contract", "title": "Bounded query contract", "level": 3 }, { "id": "rendering-and-scale-qualification", "anchor": "rendering-and-scale-qualification", "title": "Rendering and scale qualification", "level": 3 }, { "id": "8-surface-and-application-state", "anchor": "8-surface-and-application-state", "title": "8 Surface and application state", "level": 2 }, { "id": "one-state-owner-and-two-rendering-families", "anchor": "one-state-owner-and-two-rendering-families", "title": "One state owner and two rendering families", "level": 3 }, { "id": "manna-appearance-and-adaptive-layout", "anchor": "manna-appearance-and-adaptive-layout", "title": "Manna appearance and adaptive layout", "level": 3 }, { "id": "product-composition-over-surface-primitives", "anchor": "product-composition-over-surface-primitives", "title": "Product composition over Surface primitives", "level": 3 }, { "id": "9-memory-and-exact-sources", "anchor": "9-memory-and-exact-sources", "title": "9 Memory and exact sources", "level": 2 }, { "id": "10-courses-learning-and-evidence", "anchor": "10-courses-learning-and-evidence", "title": "10 Courses learning and evidence", "level": 2 }, { "id": "11-missions-rhythms-and-time", "anchor": "11-missions-rhythms-and-time", "title": "11 Missions rhythms and time", "level": 2 }, { "id": "12-recommendations-and-graph-intelligence", "anchor": "12-recommendations-and-graph-intelligence", "title": "12 Recommendations and graph intelligence", "level": 2 }, { "id": "13-context-ai-and-bounded-automation", "anchor": "13-context-ai-and-bounded-automation", "title": "13 Context AI and bounded automation", "level": 2 }, { "id": "14-people-exchange-and-bestbuds-integration", "anchor": "14-people-exchange-and-bestbuds-integration", "title": "14 People exchange and BestBuds integration", "level": 2 }, { "id": "15-end-to-end-command-flows", "anchor": "15-end-to-end-command-flows", "title": "15 End to end command flows", "level": 2 }, { "id": "course-position-and-a-qualifying-session", "anchor": "course-position-and-a-qualifying-session", "title": "Course position and a qualifying session", "level": 3 }, { "id": "proposal-and-external-calendar-change", "anchor": "proposal-and-external-calendar-change", "title": "Proposal and external calendar change", "level": 3 }, { "id": "correction-and-revoked-access", "anchor": "correction-and-revoked-access", "title": "Correction and revoked access", "level": 3 }, { "id": "find-a-source-on-the-map", "anchor": "find-a-source-on-the-map", "title": "Find a source on the map", "level": 3 }, { "id": "16-offline-operation-and-recovery", "anchor": "16-offline-operation-and-recovery", "title": "16 Offline operation and recovery", "level": 2 }, { "id": "17-legacy-migration-and-retained-infrastructure", "anchor": "17-legacy-migration-and-retained-infrastructure", "title": "17 Legacy migration and retained infrastructure", "level": 2 }, { "id": "migration-boundary", "anchor": "migration-boundary", "title": "Migration boundary", "level": 3 }, { "id": "preserve-before-transforming", "anchor": "preserve-before-transforming", "title": "Preserve before transforming", "level": 3 }, { "id": "planned-downtime-and-one-new-writer", "anchor": "planned-downtime-and-one-new-writer", "title": "Planned downtime and one new writer", "level": 3 }, { "id": "18-performance-reliability-and-operations", "anchor": "18-performance-reliability-and-operations", "title": "18 Performance reliability and operations", "level": 2 }, { "id": "19-delivery-plan-and-acceptance", "anchor": "19-delivery-plan-and-acceptance", "title": "19 Delivery plan and acceptance", "level": 2 }, { "id": "20-decisions-to-settle-before-implementation-expands", "anchor": "20-decisions-to-settle-before-implementation-expands", "title": "20 Decisions to settle before implementation expands", "level": 2 }, { "id": "21-reaktor-integration-and-framework-growth", "anchor": "21-reaktor-integration-and-framework-growth", "title": "21 Reaktor integration and framework growth", "level": 2 }, { "id": "a-connected-development-and-verification-loop", "anchor": "a-connected-development-and-verification-loop", "title": "A connected development and verification loop", "level": 3 }, { "id": "22-source-references", "anchor": "22-source-references", "title": "22 Source references", "level": 2 }, { "id": "source-s01", "anchor": "source-s01", "title": "S01 Product requirements", "level": 4 }, { "id": "source-s02", "anchor": "source-s02", "title": "S02 Repository composition", "level": 4 }, { "id": "source-s03", "anchor": "source-s03", "title": "S03 Current legacy API boundary", "level": 4 }, { "id": "source-s04", "anchor": "source-s04", "title": "S04 Native baseline", "level": 4 }, { "id": "source-s05", "anchor": "source-s05", "title": "S05 Legacy graph and transformation", "level": 4 }, { "id": "source-s06", "anchor": "source-s06", "title": "S06 Graph runtime", "level": 4 }, { "id": "source-s07", "anchor": "source-s07", "title": "S07 Graph editor", "level": 4 }, { "id": "source-s08", "anchor": "source-s08", "title": "S08 Implemented Surface primitives", "level": 4 }, { "id": "source-s09", "anchor": "source-s09", "title": "S09 Surface target architecture", "level": 4 }, { "id": "source-s10", "anchor": "source-s10", "title": "S10 Persistence and scheduling substrate", "level": 4 }, { "id": "source-s11", "anchor": "source-s11", "title": "S11 Authority contracts", "level": 4 }, { "id": "source-s12", "anchor": "source-s12", "title": "S12 Context and agents", "level": 4 }, { "id": "source-s13", "anchor": "source-s13", "title": "S13 Services and observation", "level": 4 }, { "id": "source-s14", "anchor": "source-s14", "title": "S14 Hosting and control plane", "level": 4 }, { "id": "source-s15", "anchor": "source-s15", "title": "S15 Planned Graph Protocol", "level": 4 }, { "id": "source-s16", "anchor": "source-s16", "title": "S16 Theme composition example", "level": 4 } ], "links": [ { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-module-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "manna-functional-designs", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "manna-hld", "anchor": "source-s01", "relation": "references", "sourceAnchor": "1-architecture-decision" }, { "id": "manna-hld", "anchor": "source-s02", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s03", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s04", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s05", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s06", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s07", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s08", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s09", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s10", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s03", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s11", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s12", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s13", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s14", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s14", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s12", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s15", "relation": "references", "sourceAnchor": "2-existing-implementation-and-reuse" }, { "id": "manna-hld", "anchor": "source-s14", "relation": "references", "sourceAnchor": "3-system-structure" }, { "id": "manna-hld", "anchor": "source-s05", "relation": "references", "sourceAnchor": "4-code-ownership-and-package-plan" }, { "id": "manna-hld", "anchor": "source-s07", "relation": "references", "sourceAnchor": "4-code-ownership-and-package-plan" }, { "id": "manna-hld", "anchor": "source-s02", "relation": "references", "sourceAnchor": "4-code-ownership-and-package-plan" }, { "id": "manna-hld", "anchor": "source-s14", "relation": "references", "sourceAnchor": "4-code-ownership-and-package-plan" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "graph-composition-ports-and-lifetimes" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "graph-composition-ports-and-lifetimes" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "graph-composition-ports-and-lifetimes" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "typed-maps-visitors-and-source-ownership" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "typed-maps-visitors-and-source-ownership" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "capability-offers-and-deliberate-fallback" }, { "id": "reaktor-surface-application-patterns", "anchor": "", "relation": "references", "sourceAnchor": "capability-offers-and-deliberate-fallback" }, { "id": "manna-hld", "anchor": "source-s05", "relation": "references", "sourceAnchor": "semantic-scale-and-map-behavior" }, { "id": "manna-hld", "anchor": "source-s07", "relation": "references", "sourceAnchor": "semantic-scale-and-map-behavior" }, { "id": "manna-hld", "anchor": "source-s08", "relation": "references", "sourceAnchor": "one-state-owner-and-two-rendering-families" }, { "id": "manna-hld", "anchor": "source-s09", "relation": "references", "sourceAnchor": "one-state-owner-and-two-rendering-families" }, { "id": "manna-hld", "anchor": "source-s16", "relation": "references", "sourceAnchor": "manna-appearance-and-adaptive-layout" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "product-composition-over-surface-primitives" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "product-composition-over-surface-primitives" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "product-composition-over-surface-primitives" }, { "id": "manna-hld", "anchor": "source-s12", "relation": "references", "sourceAnchor": "13-context-ai-and-bounded-automation" }, { "id": "manna-hld", "anchor": "source-s03", "relation": "references", "sourceAnchor": "migration-boundary" }, { "id": "manna-hld", "anchor": "source-s05", "relation": "references", "sourceAnchor": "preserve-before-transforming" }, { "id": "manna-hld", "anchor": "source-s13", "relation": "references", "sourceAnchor": "18-performance-reliability-and-operations" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "21-reaktor-integration-and-framework-growth" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "21-reaktor-integration-and-framework-growth" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "a-connected-development-and-verification-loop" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "a-connected-development-and-verification-loop" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "a-connected-development-and-verification-loop" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "a-connected-development-and-verification-loop" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "a-connected-development-and-verification-loop" } ] }, { "id": "manna-kotlin-surface-migration-plan", "owner": "Codex", "kind": "plan", "summary": "One shared Kotlin Surface application, Kotlin React web and Compose native realizations, adaptive layouts, typed editor islands and retirement of handwritten Manna TypeScript/CSS.", "use": "Use to sequence the shared Surface authoring prerequisite, preserve Notes/Atlas and data contracts, qualify editor hosts and every target, and retire duplicated product implementations.", "region": "products-apps", "order": 2, "title": "Manna — Kotlin Surface migration plan", "nav": "Manna Kotlin migration", "group": "products", "subsection": "products-apps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan", "revision": "c988d249ee5d9372647f9da748b2814557d0845b94021cbe449359f83d1d8158", "status": "unverified", "renderingRevision": "ad8d2732673dc4655eb40d1d51ce5ac8b11bb28e4db344451e6cffc753cb6efe", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://raw.githubusercontent.com/androidx/androidx/androidx-main/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Applier.kt", "https://raw.githubusercontent.com/JetBrains/kotlin-wrappers/master/kotlin-react/README.md", "https://react.dev/reference/react/useSyncExternalStore", "https://github.com/JetBrains/kotlin-wrappers/blob/master/kotlin-react/README.md", "https://developer.android.com/reference/kotlin/androidx/compose/runtime/Applier", "https://tiptap.dev/docs/editor/api/commands/content/set-content", "https://github.com/excalidraw/excalidraw/blob/master/dev-docs/docs/%40excalidraw/excalidraw/api/props/props.mdx" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan", "polarity": "Neutral" }, { "id": "section-baseline", "anchor": "baseline", "label": "1. What is already present, and what is missing", "profile": "section", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan#baseline", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "2. Shared Kotlin authoring and renderer boundary", "profile": "section", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan#architecture", "polarity": "Neutral" }, { "id": "section-ownership", "anchor": "ownership", "label": "3. Module ownership", "profile": "section", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan#ownership", "polarity": "Neutral" }, { "id": "section-adaptive", "anchor": "adaptive", "label": "4. Design and adaptive layouts", "profile": "section", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan#adaptive", "polarity": "Neutral" }, { "id": "section-editors", "anchor": "editors", "label": "5. Notes and specialized editor islands", "profile": "section", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan#editors", "polarity": "Neutral" }, { "id": "section-graphs", "anchor": "graphs", "label": "6. Atlas and authored graph parity", "profile": "section", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan#graphs", "polarity": "Neutral" }, { "id": "section-sources", "anchor": "sources", "label": "13. Sources and qualification boundaries", "profile": "section", "contract": "https://reaktor.build/docs/manna-kotlin-surface-migration-plan#sources", "polarity": "Neutral" } ], "relations": [ { "id": "manna-kotlin-surface-migration-plan:references-manna-hld", "kind": "references", "owner": "manna-kotlin-surface-migration-plan", "incidences": [ { "node": "manna-kotlin-surface-migration-plan", "port": "section-baseline", "role": "source", "ordinal": 0 }, { "node": "manna-hld", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-kotlin-surface-migration-plan:references-manna-functional-designs", "kind": "references", "owner": "manna-kotlin-surface-migration-plan", "incidences": [ { "node": "manna-kotlin-surface-migration-plan", "port": "section-baseline", "role": "source", "ordinal": 0 }, { "node": "manna-functional-designs", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-kotlin-surface-migration-plan:references-reaktor-surface-renderers", "kind": "references", "owner": "manna-kotlin-surface-migration-plan", "incidences": [ { "node": "manna-kotlin-surface-migration-plan", "port": "section-architecture", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-kotlin-surface-migration-plan:references-reaktor-surface-implementation-plan", "kind": "references", "owner": "manna-kotlin-surface-migration-plan", "incidences": [ { "node": "manna-kotlin-surface-migration-plan", "port": "section-sources", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-implementation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "manna-kotlin-surface-migration-plan:references-reaktor-webview", "kind": "references", "owner": "manna-kotlin-surface-migration-plan", "incidences": [ { "node": "manna-kotlin-surface-migration-plan", "port": "section-sources", "role": "source", "ordinal": 0 }, { "node": "reaktor-webview", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "manna-kotlin-surface-migration-plan.json", "sections": [ { "id": "manna--kotlin-surface-migration-plan", "anchor": "manna--kotlin-surface-migration-plan", "title": "Manna — Kotlin Surface migration plan", "level": 1 }, { "id": "baseline", "anchor": "baseline", "title": "1. What is already present, and what is missing", "level": 2 }, { "id": "architecture", "anchor": "architecture", "title": "2. Shared Kotlin authoring and renderer boundary", "level": 2 }, { "id": "ownership", "anchor": "ownership", "title": "3. Module ownership", "level": 2 }, { "id": "adaptive", "anchor": "adaptive", "title": "4. Design and adaptive layouts", "level": 2 }, { "id": "editors", "anchor": "editors", "title": "5. Notes and specialized editor islands", "level": 2 }, { "id": "graphs", "anchor": "graphs", "title": "6. Atlas and authored graph parity", "level": 2 }, { "id": "data", "anchor": "data", "title": "7. State, persistence and backend continuity", "level": 2 }, { "id": "delivery", "anchor": "delivery", "title": "8. Delivery waves and acceptance gates", "level": 2 }, { "id": "verification", "anchor": "verification", "title": "9. Verification matrix", "level": 2 }, { "id": "retirement", "anchor": "retirement", "title": "10. Source retirement and release checklist", "level": 2 }, { "id": "first-slice", "anchor": "first-slice", "title": "11. First implementation slice", "level": 2 }, { "id": "feasibility", "anchor": "feasibility", "title": "12. Feasibility benchmark against the Surface design", "level": 2 }, { "id": "121-requirement-to-design-comparison", "anchor": "121-requirement-to-design-comparison", "title": "12.1 Requirement-to-design comparison", "level": 3 }, { "id": "122-what-was-actually-checked", "anchor": "122-what-was-actually-checked", "title": "12.2 What was actually checked", "level": 3 }, { "id": "123-blocking-experiments-and-decisions", "anchor": "123-blocking-experiments-and-decisions", "title": "12.3 Blocking experiments and decisions", "level": 3 }, { "id": "sources", "anchor": "sources", "title": "13. Sources and qualification boundaries", "level": 2 } ], "links": [ { "id": "manna-kotlin-surface-migration-plan", "anchor": "feasibility", "relation": "references", "sourceAnchor": "" }, { "id": "manna-hld", "anchor": "", "relation": "references", "sourceAnchor": "baseline" }, { "id": "manna-functional-designs", "anchor": "", "relation": "references", "sourceAnchor": "baseline" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "architecture" }, { "id": "reaktor-surface-renderers", "anchor": "16-hostapplier-and-the-portable-composition-boundary", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-renderers", "anchor": "react-web", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "12-themes-tokens-and-interchangeable-visual-languages", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "14-adaptive-layouts-navigation-and-coordinate-systems", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-desktop", "anchor": "371-a-collection-runs-one-machine-not-one-per-row", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "25-custom-interfaces-and-specialized-engines", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-desktop", "anchor": "377-an-island-is-the-boundary-around-an-engine", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-application-patterns", "anchor": "28-blueprint-a-dense-workbench-around-a-specialized-canvas", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-foundations", "anchor": "33-keep-the-fast-feedback-loop-local", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-application-extensions", "anchor": "32-creative-software-a-specialized-scene-within-a-coherent-shell", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-desktop", "anchor": "", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "26-verification-and-implementation-boundaries", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "13-graph-bindings-identity-and-lifecycle-ownership", "relation": "references", "sourceAnchor": "121-requirement-to-design-comparison" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "sources" }, { "id": "reaktor-surface-implementation-plan", "anchor": "", "relation": "references", "sourceAnchor": "sources" }, { "id": "reaktor-webview", "anchor": "", "relation": "references", "sourceAnchor": "sources" } ] }, { "id": "operations-crashlytics", "owner": "Reaktor / Codex", "kind": "ops", "summary": "Crashlytics release qualification, Reaktor session and trace correlation, explicit breadcrumbs, Firebase Performance, kernel reads, privacy and bounded client evidence.", "use": "Use when implementing mobile crash reporting or joining device errors to graph, release and backend evidence. Implementation claims require the acceptance receipts below.", "region": "operations-observability", "order": 4, "title": "Native diagnostics with Crashlytics", "nav": "Crashlytics and client evidence", "group": "operations", "subsection": "operations-observability", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-crashlytics", "revision": "d8204c1d17c22fd59f6de790996ee5672e12b247b354763e55a21aa165e98dae", "status": "design", "renderingRevision": "0526675e2c0829efcb6d14130413007fa7427f2323f2ede2815c62719f6d121a", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://firebase.google.com/pricing", "https://firebase.google.com/docs/crashlytics/ios/get-deobfuscated-reports", "https://firebase.google.com/docs/crashlytics/ios/test-implementation", "https://firebase.google.com/docs/crashlytics/android/customize-crash-reports", "https://firebase.google.com/docs/perf-mon", "https://firebase.google.com/docs/crashlytics/ai-assistance-mcp", "https://firebase.google.com/support/privacy" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-crashlytics", "polarity": "Neutral" }, { "id": "section-role-and-boundaries", "anchor": "role-and-boundaries", "label": "Role and boundaries", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#role-and-boundaries", "polarity": "Neutral" }, { "id": "section-current-integration", "anchor": "current-integration", "label": "Current integration", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#current-integration", "polarity": "Neutral" }, { "id": "section-release-builds-and-crash-reporting", "anchor": "release-builds-and-crash-reporting", "label": "Release builds and crash reporting", "profile": "procedure", "contract": "https://reaktor.build/docs/operations-crashlytics#release-builds-and-crash-reporting", "polarity": "Neutral" }, { "id": "section-joining-crashes-to-the-graph", "anchor": "joining-crashes-to-the-graph", "label": "Joining crashes to the graph", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#joining-crashes-to-the-graph", "polarity": "Neutral" }, { "id": "section-performance-and-client-evidence", "anchor": "performance-and-client-evidence", "label": "Performance and client evidence", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#performance-and-client-evidence", "polarity": "Neutral" }, { "id": "section-hangar-devtools-and-mcp", "anchor": "hangar-devtools-and-mcp", "label": "Hangar, DevTools and MCP", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#hangar-devtools-and-mcp", "polarity": "Neutral" }, { "id": "section-alerts-and-service-levels", "anchor": "alerts-and-service-levels", "label": "Alerts and service levels", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#alerts-and-service-levels", "polarity": "Neutral" }, { "id": "section-privacy-and-retention", "anchor": "privacy-and-retention", "label": "Privacy and retention", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#privacy-and-retention", "polarity": "Neutral" }, { "id": "section-shadow-investigation", "anchor": "shadow-investigation", "label": "Shadow investigation", "profile": "section", "contract": "https://reaktor.build/docs/operations-crashlytics#shadow-investigation", "polarity": "Neutral" }, { "id": "section-acceptance", "anchor": "acceptance", "label": "Acceptance", "profile": "procedure", "contract": "https://reaktor.build/docs/operations-crashlytics#acceptance", "polarity": "Neutral" } ], "relations": [ { "id": "operations-crashlytics:signal-ownership", "kind": "references", "owner": "operations-crashlytics", "incidences": [ { "node": "operations-crashlytics", "port": "section-role-and-boundaries", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "section-signal-ownership-and-storage", "role": "target", "ordinal": 0 } ] }, { "id": "operations-crashlytics:identity-contract", "kind": "requires", "owner": "operations-crashlytics", "incidences": [ { "node": "operations-crashlytics", "port": "section-joining-crashes-to-the-graph", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "section-identity-contract", "role": "target", "ordinal": 0 } ] }, { "id": "operations-crashlytics:instance-diagnostics", "kind": "references", "owner": "operations-crashlytics", "incidences": [ { "node": "operations-crashlytics", "port": "section-performance-and-client-evidence", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "section-platform-collection-plan", "role": "target", "ordinal": 0 } ] }, { "id": "operations-crashlytics:performance-harness", "kind": "references", "owner": "operations-crashlytics", "incidences": [ { "node": "operations-crashlytics", "port": "section-performance-and-client-evidence", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-crashlytics:devtools", "kind": "references", "owner": "operations-crashlytics", "incidences": [ { "node": "operations-crashlytics", "port": "section-hangar-devtools-and-mcp", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "section-operations-and-shadow-integration", "role": "target", "ordinal": 0 } ] }, { "id": "operations-crashlytics:shadow-capsules", "kind": "references", "owner": "operations-crashlytics", "incidences": [ { "node": "operations-crashlytics", "port": "section-shadow-investigation", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "section-from-anomaly-to-regression-case", "role": "target", "ordinal": 0 } ] }, { "id": "operations-crashlytics:delivery-gates", "kind": "references", "owner": "operations-crashlytics", "incidences": [ { "node": "operations-crashlytics", "port": "section-acceptance", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "section-implementation-sequence", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-crashlytics.json", "sections": [ { "id": "native-diagnostics-with-crashlytics", "anchor": "native-diagnostics-with-crashlytics", "title": "Native diagnostics with Crashlytics", "level": 1 }, { "id": "role-and-boundaries", "anchor": "role-and-boundaries", "title": "Role and boundaries", "level": 2 }, { "id": "current-integration", "anchor": "current-integration", "title": "Current integration", "level": 2 }, { "id": "release-builds-and-crash-reporting", "anchor": "release-builds-and-crash-reporting", "title": "Release builds and crash reporting", "level": 2 }, { "id": "joining-crashes-to-the-graph", "anchor": "joining-crashes-to-the-graph", "title": "Joining crashes to the graph", "level": 2 }, { "id": "performance-and-client-evidence", "anchor": "performance-and-client-evidence", "title": "Performance and client evidence", "level": 2 }, { "id": "hangar-devtools-and-mcp", "anchor": "hangar-devtools-and-mcp", "title": "Hangar, DevTools and MCP", "level": 2 }, { "id": "alerts-and-service-levels", "anchor": "alerts-and-service-levels", "title": "Alerts and service levels", "level": 2 }, { "id": "privacy-and-retention", "anchor": "privacy-and-retention", "title": "Privacy and retention", "level": 2 }, { "id": "shadow-investigation", "anchor": "shadow-investigation", "title": "Shadow investigation", "level": 2 }, { "id": "acceptance", "anchor": "acceptance", "title": "Acceptance", "level": 2 } ], "links": [] }, { "id": "operations-delivery", "owner": "Reaktor / Codex", "kind": "plan", "summary": "Textbook chapter 16 and current-source delivery gates: safe moving dev, one real replay, evidence transport and operating health.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-delivery", "order": 0, "title": "Operations Delivery Gates and Runbooks", "nav": "Delivery & runbooks", "group": "operations", "subsection": "operations-delivery", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-delivery", "revision": "fdcc9202d01538390139e4cac1622a1977a0641b16e797e528be619f0fc34552", "status": "unverified", "renderingRevision": "3e46fabe72f06480838f88be6cb0757cd296af340f0a712c32a5a7fc641eb786", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-delivery", "polarity": "Neutral" }, { "id": "section-implementation-sequence", "anchor": "implementation-sequence", "label": "Implementation sequence", "profile": "section", "contract": "https://reaktor.build/docs/operations-delivery#implementation-sequence", "polarity": "Neutral" }, { "id": "section-capture-fabric-gate", "anchor": "capture-fabric-gate", "label": "Capture fabric gate", "profile": "section", "contract": "https://reaktor.build/docs/operations-delivery#capture-fabric-gate", "polarity": "Neutral" }, { "id": "section-ownership-and-storage", "anchor": "ownership-and-storage", "label": "Ownership and storage", "profile": "section", "contract": "https://reaktor.build/docs/operations-delivery#ownership-and-storage", "polarity": "Neutral" }, { "id": "section-operate-the-system-that-gathers-evidence", "anchor": "operate-the-system-that-gathers-evidence", "label": "Operate the system that gathers evidence", "profile": "section", "contract": "https://reaktor.build/docs/operations-delivery#operate-the-system-that-gathers-evidence", "polarity": "Neutral" }, { "id": "section-incident-workflow", "anchor": "incident-workflow", "label": "Incident workflow", "profile": "section", "contract": "https://reaktor.build/docs/operations-delivery#incident-workflow", "polarity": "Neutral" }, { "id": "section-current-runbook-authority", "anchor": "current-runbook-authority", "label": "Current runbook authority", "profile": "section", "contract": "https://reaktor.build/docs/operations-delivery#current-runbook-authority", "polarity": "Neutral" } ], "relations": [ { "id": "operations-delivery:references-shadow-capture-fabric", "kind": "references", "owner": "operations-delivery", "incidences": [ { "node": "operations-delivery", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-delivery:references-reaktor-instrumentation-plan", "kind": "references", "owner": "operations-delivery", "incidences": [ { "node": "operations-delivery", "port": "section-implementation-sequence", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-delivery:references-operations-instance-diagnostics", "kind": "references", "owner": "operations-delivery", "incidences": [ { "node": "operations-delivery", "port": "section-incident-workflow", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-delivery:references-operations-references-implementation-evidence", "kind": "references", "owner": "operations-delivery", "incidences": [ { "node": "operations-delivery", "port": "section-current-runbook-authority", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "section-implementation-evidence", "role": "target", "ordinal": 0 } ] }, { "id": "operations-delivery:references-operations-crashlytics", "kind": "references", "owner": "operations-delivery", "incidences": [ { "node": "operations-delivery", "port": "section-ownership-and-storage", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "section-shadow-investigation", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-delivery.json", "sections": [ { "id": "operations-delivery-gates-and-runbooks", "anchor": "operations-delivery-gates-and-runbooks", "title": "Operations Delivery Gates and Runbooks", "level": 1 }, { "id": "implementation-sequence", "anchor": "implementation-sequence", "title": "Implementation sequence", "level": 2 }, { "id": "capture-fabric-gate", "anchor": "capture-fabric-gate", "title": "Capture fabric gate", "level": 2 }, { "id": "ownership-and-storage", "anchor": "ownership-and-storage", "title": "Ownership and storage", "level": 2 }, { "id": "operate-the-system-that-gathers-evidence", "anchor": "operate-the-system-that-gathers-evidence", "title": "Operate the system that gathers evidence", "level": 2 }, { "id": "incident-workflow", "anchor": "incident-workflow", "title": "Incident workflow", "level": 2 }, { "id": "current-runbook-authority", "anchor": "current-runbook-authority", "title": "Current runbook authority", "level": 2 }, { "id": "final-acceptance", "anchor": "final-acceptance", "title": "Final acceptance", "level": 2 } ], "links": [ { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-instrumentation-plan", "anchor": "", "relation": "references", "sourceAnchor": "implementation-sequence" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "ownership-and-storage" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "incident-workflow" }, { "id": "operations-references", "anchor": "implementation-evidence", "relation": "references", "sourceAnchor": "current-runbook-authority" } ] }, { "id": "operations-graph-evidence", "owner": "Reaktor / Codex", "kind": "architecture", "summary": "Exact source, graph, artifact and activation identity across telemetry, profiles, instance metrics and Shadow experiments.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-observability", "order": 2, "title": "Graph Attribution and Operational Evidence", "nav": "Graph evidence", "group": "operations", "subsection": "operations-observability", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-graph-evidence", "revision": "7734b97081ab56ee25ec438dc987a271c0423828b99c615facc379883a3d5b0f", "status": "unverified", "renderingRevision": "c66a737913bdd36a8e931fdb9a0de1b2e4d3eb804b2a39b1420d8b1373f97566", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-graph-evidence", "polarity": "Neutral" }, { "id": "section-identity-contract", "anchor": "identity-contract", "label": "Identity contract", "profile": "section", "contract": "https://reaktor.build/docs/operations-graph-evidence#identity-contract", "polarity": "Neutral" }, { "id": "section-observe-compile-and-execute", "anchor": "observe-compile-and-execute", "label": "Observe, compile and execute", "profile": "section", "contract": "https://reaktor.build/docs/operations-graph-evidence#observe-compile-and-execute", "polarity": "Neutral" }, { "id": "section-causal-evidence-across-runtimes", "anchor": "causal-evidence-across-runtimes", "label": "Causal evidence across runtimes", "profile": "section", "contract": "https://reaktor.build/docs/operations-graph-evidence#causal-evidence-across-runtimes", "polarity": "Neutral" }, { "id": "section-evidence-as-a-fact", "anchor": "evidence-as-a-fact", "label": "Evidence as a fact", "profile": "section", "contract": "https://reaktor.build/docs/operations-graph-evidence#evidence-as-a-fact", "polarity": "Neutral" }, { "id": "section-profiles-and-instance-metrics-on-the-graph", "anchor": "profiles-and-instance-metrics-on-the-graph", "label": "Profiles and instance metrics on the graph", "profile": "section", "contract": "https://reaktor.build/docs/operations-graph-evidence#profiles-and-instance-metrics-on-the-graph", "polarity": "Neutral" }, { "id": "section-acceptance", "anchor": "acceptance", "label": "Acceptance", "profile": "section", "contract": "https://reaktor.build/docs/operations-graph-evidence#acceptance", "polarity": "Neutral" } ], "relations": [ { "id": "operations-graph-evidence:references-shadow-capture-fabric", "kind": "references", "owner": "operations-graph-evidence", "incidences": [ { "node": "operations-graph-evidence", "port": "section-observe-compile-and-execute", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-graph-evidence:references-reaktor-workbench-links", "kind": "references", "owner": "operations-graph-evidence", "incidences": [ { "node": "operations-graph-evidence", "port": "section-causal-evidence-across-runtimes", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-graph-evidence:references-reaktor-instrumentation-plan", "kind": "references", "owner": "operations-graph-evidence", "incidences": [ { "node": "operations-graph-evidence", "port": "section-acceptance", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-graph-evidence.json", "sections": [ { "id": "graph-attribution-and-operational-evidence", "anchor": "graph-attribution-and-operational-evidence", "title": "Graph Attribution and Operational Evidence", "level": 1 }, { "id": "identity-contract", "anchor": "identity-contract", "title": "Identity contract", "level": 2 }, { "id": "observe-compile-and-execute", "anchor": "observe-compile-and-execute", "title": "Observe, compile and execute", "level": 2 }, { "id": "causal-evidence-across-runtimes", "anchor": "causal-evidence-across-runtimes", "title": "Causal evidence across runtimes", "level": 2 }, { "id": "evidence-as-a-fact", "anchor": "evidence-as-a-fact", "title": "Evidence as a fact", "level": 2 }, { "id": "profiles-and-instance-metrics-on-the-graph", "anchor": "profiles-and-instance-metrics-on-the-graph", "title": "Profiles and instance metrics on the graph", "level": 2 }, { "id": "acceptance", "anchor": "acceptance", "title": "Acceptance", "level": 2 } ], "links": [ { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "observe-compile-and-execute" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "causal-evidence-across-runtimes" }, { "id": "reaktor-instrumentation-plan", "anchor": "", "relation": "references", "sourceAnchor": "acceptance" } ] }, { "id": "operations-instance-diagnostics", "owner": "Reaktor / Codex", "kind": "ops", "summary": "App size, process/thread counts, CPU, managed/native memory, GC, resource pressure and repeatable leak diagnosis.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-diagnostics", "order": 0, "title": "Instance Health, Footprint and Memory Leaks", "nav": "Instance diagnostics", "group": "operations", "subsection": "operations-diagnostics", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-instance-diagnostics", "revision": "2f6e607920ae21249b42c7a18e4354b7089c86d53410315f62e9405add0662ae", "status": "unverified", "renderingRevision": "d9ab21965e8684e53458bd349006e3fd1e7719a42ba15764734d7ef8af6a87ab", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developer.android.com/topic/performance/memory", "https://docs.oracle.com/en/java/javase/25/troubleshoot/troubleshooting-memory-leaks.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-instance-diagnostics", "polarity": "Neutral" }, { "id": "section-footprint-and-instance-catalog", "anchor": "footprint-and-instance-catalog", "label": "Footprint and instance catalog", "profile": "section", "contract": "https://reaktor.build/docs/operations-instance-diagnostics#footprint-and-instance-catalog", "polarity": "Neutral" }, { "id": "section-platform-collection-plan", "anchor": "platform-collection-plan", "label": "Platform collection plan", "profile": "section", "contract": "https://reaktor.build/docs/operations-instance-diagnostics#platform-collection-plan", "polarity": "Neutral" }, { "id": "section-proving-a-leak", "anchor": "proving-a-leak", "label": "Proving a leak", "profile": "section", "contract": "https://reaktor.build/docs/operations-instance-diagnostics#proving-a-leak", "polarity": "Neutral" }, { "id": "section-budgets-and-workbench-behavior", "anchor": "budgets-and-workbench-behavior", "label": "Budgets and workbench behavior", "profile": "section", "contract": "https://reaktor.build/docs/operations-instance-diagnostics#budgets-and-workbench-behavior", "polarity": "Neutral" } ], "relations": [ { "id": "operations-instance-diagnostics:references-operations-profiling", "kind": "references", "owner": "operations-instance-diagnostics", "incidences": [ { "node": "operations-instance-diagnostics", "port": "section-proving-a-leak", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-instance-diagnostics:references-operations-graph-evidence", "kind": "references", "owner": "operations-instance-diagnostics", "incidences": [ { "node": "operations-instance-diagnostics", "port": "section-budgets-and-workbench-behavior", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-instance-diagnostics:references-operations-crashlytics", "kind": "references", "owner": "operations-instance-diagnostics", "incidences": [ { "node": "operations-instance-diagnostics", "port": "section-platform-collection-plan", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-instance-diagnostics.json", "sections": [ { "id": "instance-health-footprint-and-memory-leaks", "anchor": "instance-health-footprint-and-memory-leaks", "title": "Instance Health, Footprint and Memory Leaks", "level": 1 }, { "id": "footprint-and-instance-catalog", "anchor": "footprint-and-instance-catalog", "title": "Footprint and instance catalog", "level": 2 }, { "id": "platform-collection-plan", "anchor": "platform-collection-plan", "title": "Platform collection plan", "level": 2 }, { "id": "proving-a-leak", "anchor": "proving-a-leak", "title": "Proving a leak", "level": 2 }, { "id": "budgets-and-workbench-behavior", "anchor": "budgets-and-workbench-behavior", "title": "Budgets and workbench behavior", "level": 2 } ], "links": [ { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "platform-collection-plan" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "proving-a-leak" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "budgets-and-workbench-behavior" } ] }, { "id": "operations-load-resilience", "owner": "Reaktor / Codex", "kind": "testing", "summary": "Textbook chapter 13: real dependencies, representative arrival models, capacity, soak/leak tests, faults and AI evaluation boundaries.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-diagnostics", "order": 2, "title": "Load, Capacity and Resilience Verification", "nav": "Load & resilience", "group": "operations", "subsection": "operations-diagnostics", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-load-resilience", "revision": "ef6f6f169e62800c60f0a3758f40abfc60761df6140801c2ee16eb22db91bf00", "status": "unverified", "renderingRevision": "f6bb1490699c8b6e7be0df5c53c7f8ef6c550664e103b235a40cfc0dc616224d", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://grafana.com/docs/k6/latest/using-k6/scenarios/concepts/open-vs-closed/", "https://developers.cloudflare.com/queues/reference/delivery-guarantees/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-load-resilience", "polarity": "Neutral" }, { "id": "section-declare-the-performance-profile", "anchor": "declare-the-performance-profile", "label": "Declare the performance profile", "profile": "section", "contract": "https://reaktor.build/docs/operations-load-resilience#declare-the-performance-profile", "polarity": "Neutral" }, { "id": "section-test-families", "anchor": "test-families", "label": "Test families", "profile": "section", "contract": "https://reaktor.build/docs/operations-load-resilience#test-families", "polarity": "Neutral" }, { "id": "section-arrival-models-and-overload", "anchor": "arrival-models-and-overload", "label": "Arrival models and overload", "profile": "section", "contract": "https://reaktor.build/docs/operations-load-resilience#arrival-models-and-overload", "polarity": "Neutral" }, { "id": "section-compare-fairly-and-gate-explicitly", "anchor": "compare-fairly-and-gate-explicitly", "label": "Compare fairly and gate explicitly", "profile": "section", "contract": "https://reaktor.build/docs/operations-load-resilience#compare-fairly-and-gate-explicitly", "polarity": "Neutral" }, { "id": "section-faults-and-stateful-correctness", "anchor": "faults-and-stateful-correctness", "label": "Faults and stateful correctness", "profile": "section", "contract": "https://reaktor.build/docs/operations-load-resilience#faults-and-stateful-correctness", "polarity": "Neutral" }, { "id": "section-ai-and-corpus-scope", "anchor": "ai-and-corpus-scope", "label": "AI and corpus scope", "profile": "section", "contract": "https://reaktor.build/docs/operations-load-resilience#ai-and-corpus-scope", "polarity": "Neutral" } ], "relations": [ { "id": "operations-load-resilience:references-operations-instance-diagnostics", "kind": "references", "owner": "operations-load-resilience", "incidences": [ { "node": "operations-load-resilience", "port": "section-compare-fairly-and-gate-explicitly", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-load-resilience:references-operations-profiling", "kind": "references", "owner": "operations-load-resilience", "incidences": [ { "node": "operations-load-resilience", "port": "section-compare-fairly-and-gate-explicitly", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-load-resilience:references-shadow-verification-send-retry-reconnect", "kind": "references", "owner": "operations-load-resilience", "incidences": [ { "node": "operations-load-resilience", "port": "section-faults-and-stateful-correctness", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "section-send-retry-reconnect", "role": "target", "ordinal": 0 } ] }, { "id": "operations-load-resilience:references-shadow-clients-agents", "kind": "references", "owner": "operations-load-resilience", "incidences": [ { "node": "operations-load-resilience", "port": "section-ai-and-corpus-scope", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-load-resilience.json", "sections": [ { "id": "load-capacity-and-resilience-verification", "anchor": "load-capacity-and-resilience-verification", "title": "Load, Capacity and Resilience Verification", "level": 1 }, { "id": "declare-the-performance-profile", "anchor": "declare-the-performance-profile", "title": "Declare the performance profile", "level": 2 }, { "id": "test-families", "anchor": "test-families", "title": "Test families", "level": 2 }, { "id": "arrival-models-and-overload", "anchor": "arrival-models-and-overload", "title": "Arrival models and overload", "level": 2 }, { "id": "compare-fairly-and-gate-explicitly", "anchor": "compare-fairly-and-gate-explicitly", "title": "Compare fairly and gate explicitly", "level": 2 }, { "id": "faults-and-stateful-correctness", "anchor": "faults-and-stateful-correctness", "title": "Faults and stateful correctness", "level": 2 }, { "id": "ai-and-corpus-scope", "anchor": "ai-and-corpus-scope", "title": "AI and corpus scope", "level": 2 } ], "links": [ { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "compare-fairly-and-gate-explicitly" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "compare-fairly-and-gate-explicitly" }, { "id": "shadow-verification", "anchor": "send-retry-reconnect", "relation": "references", "sourceAnchor": "faults-and-stateful-correctness" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "ai-and-corpus-scope" } ] }, { "id": "operations-observability", "owner": "Reaktor / Codex", "kind": "ops", "summary": "Retained Grafana/ClickHouse roles, proposed WAE hot comparisons and R2/Iceberg evidence, with delivery and retention contracts.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-observability", "order": 1, "title": "Shared Observability and Shadow Evidence", "nav": "Observability", "group": "operations", "subsection": "operations-observability", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-observability", "revision": "12206b1b512f6b2ecb6acbfe3e0ac8407bd6829f6924799f346cb79a1440e6b7", "status": "unverified", "renderingRevision": "44c2adf88cbf372741275ec891c742ddcb374df0f7cb8a5f4ffb49679f886033", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developers.cloudflare.com/analytics/analytics-engine/limits/", "https://developers.cloudflare.com/analytics/analytics-engine/sql-reference/statements/", "https://developers.cloudflare.com/analytics/analytics-engine/sampling/", "https://developers.cloudflare.com/analytics/analytics-engine/sql-reference/aggregate-functions/", "https://developers.cloudflare.com/pipelines/sinks/available-sinks/r2-data-catalog/", "https://developers.cloudflare.com/r2-sql/reference/limitations-best-practices/", "https://developers.cloudflare.com/pipelines/", "https://developers.cloudflare.com/r2-data-catalog/deleting-data/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-observability", "polarity": "Neutral" }, { "id": "section-signal-ownership-and-storage", "anchor": "signal-ownership-and-storage", "label": "Signal ownership and storage", "profile": "section", "contract": "https://reaktor.build/docs/operations-observability#signal-ownership-and-storage", "polarity": "Neutral" }, { "id": "section-the-paired-observation", "anchor": "the-paired-observation", "label": "The paired observation", "profile": "section", "contract": "https://reaktor.build/docs/operations-observability#the-paired-observation", "polarity": "Neutral" }, { "id": "section-hot-comparison-in-analytics-engine", "anchor": "hot-comparison-in-analytics-engine", "label": "Hot comparison in Analytics Engine", "profile": "section", "contract": "https://reaktor.build/docs/operations-observability#hot-comparison-in-analytics-engine", "polarity": "Neutral" }, { "id": "section-durable-evidence-and-visibility", "anchor": "durable-evidence-and-visibility", "label": "Durable evidence and visibility", "profile": "section", "contract": "https://reaktor.build/docs/operations-observability#durable-evidence-and-visibility", "polarity": "Neutral" }, { "id": "section-current-exporter-limitations", "anchor": "current-exporter-limitations", "label": "Current exporter limitations", "profile": "section", "contract": "https://reaktor.build/docs/operations-observability#current-exporter-limitations", "polarity": "Neutral" }, { "id": "section-access-retention-and-deletion", "anchor": "access-retention-and-deletion", "label": "Access, retention and deletion", "profile": "section", "contract": "https://reaktor.build/docs/operations-observability#access-retention-and-deletion", "polarity": "Neutral" } ], "relations": [ { "id": "operations-observability:references-shadow-workspaces", "kind": "references", "owner": "operations-observability", "incidences": [ { "node": "operations-observability", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-observability:references-operations-delivery", "kind": "references", "owner": "operations-observability", "incidences": [ { "node": "operations-observability", "port": "section-access-retention-and-deletion", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-observability:references-operations-crashlytics", "kind": "references", "owner": "operations-observability", "incidences": [ { "node": "operations-observability", "port": "section-signal-ownership-and-storage", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-observability.json", "sections": [ { "id": "shared-observability-and-shadow-evidence", "anchor": "shared-observability-and-shadow-evidence", "title": "Shared Observability and Shadow Evidence", "level": 1 }, { "id": "signal-ownership-and-storage", "anchor": "signal-ownership-and-storage", "title": "Signal ownership and storage", "level": 2 }, { "id": "the-paired-observation", "anchor": "the-paired-observation", "title": "The paired observation", "level": 2 }, { "id": "hot-comparison-in-analytics-engine", "anchor": "hot-comparison-in-analytics-engine", "title": "Hot comparison in Analytics Engine", "level": 2 }, { "id": "durable-evidence-and-visibility", "anchor": "durable-evidence-and-visibility", "title": "Durable evidence and visibility", "level": 2 }, { "id": "current-exporter-limitations", "anchor": "current-exporter-limitations", "title": "Current exporter limitations", "level": 2 }, { "id": "access-retention-and-deletion", "anchor": "access-retention-and-deletion", "title": "Access, retention and deletion", "level": 2 } ], "links": [ { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "signal-ownership-and-storage" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "access-retention-and-deletion" } ] }, { "id": "operations-profiling", "owner": "Reaktor / Codex", "kind": "performance", "summary": "Practical JVM JFR, thread, NMT and sampled-profile workflows, cross-platform capture qualification and retained evidence.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-diagnostics", "order": 1, "title": "Profiling and JVM Diagnosis", "nav": "Profiling", "group": "operations", "subsection": "operations-diagnostics", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-profiling", "revision": "700c923b183b5360dee508f1df58eb21e38dc1590f7b4f028a9c7a14a9deb15d", "status": "unverified", "renderingRevision": "589f62fc0197361fdc7e198f6ab08f791ee9c2fa217c93548e51f38c618dd2c6", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.manning.com/books/the-well-grounded-java-developer-second-edition", "https://docs.oracle.com/en/java/javase/25/docs/specs/man/jcmd.html", "https://docs.oracle.com/en/java/javase/25/vm/native-memory-tracking.html", "https://github.com/async-profiler/async-profiler/blob/master/docs/ProfilingModes.md", "https://developers.cloudflare.com/workers/runtime-apis/performance/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-profiling", "polarity": "Neutral" }, { "id": "section-start-with-a-hypothesis", "anchor": "start-with-a-hypothesis", "label": "Start with a hypothesis", "profile": "section", "contract": "https://reaktor.build/docs/operations-profiling#start-with-a-hypothesis", "polarity": "Neutral" }, { "id": "section-jvm-capture-workflow", "anchor": "jvm-capture-workflow", "label": "JVM capture workflow", "profile": "section", "contract": "https://reaktor.build/docs/operations-profiling#jvm-capture-workflow", "polarity": "Neutral" }, { "id": "section-cross-platform-qualification", "anchor": "cross-platform-qualification", "label": "Cross-platform qualification", "profile": "section", "contract": "https://reaktor.build/docs/operations-profiling#cross-platform-qualification", "polarity": "Neutral" }, { "id": "section-capture-and-storage-contract", "anchor": "capture-and-storage-contract", "label": "Capture and storage contract", "profile": "section", "contract": "https://reaktor.build/docs/operations-profiling#capture-and-storage-contract", "polarity": "Neutral" }, { "id": "section-a-diagnosis-is-complete-when", "anchor": "a-diagnosis-is-complete-when", "label": "A diagnosis is complete when", "profile": "section", "contract": "https://reaktor.build/docs/operations-profiling#a-diagnosis-is-complete-when", "polarity": "Neutral" } ], "relations": [ { "id": "operations-profiling:references-operations-instance-diagnostics", "kind": "references", "owner": "operations-profiling", "incidences": [ { "node": "operations-profiling", "port": "section-start-with-a-hypothesis", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-profiling:references-operations-load-resilience", "kind": "references", "owner": "operations-profiling", "incidences": [ { "node": "operations-profiling", "port": "section-start-with-a-hypothesis", "role": "source", "ordinal": 0 }, { "node": "operations-load-resilience", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-profiling:references-flexbuffer-performance-review", "kind": "references", "owner": "operations-profiling", "incidences": [ { "node": "operations-profiling", "port": "section-cross-platform-qualification", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-profiling:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "operations-profiling", "incidences": [ { "node": "operations-profiling", "port": "section-cross-platform-qualification", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-profiling.json", "sections": [ { "id": "profiling-and-jvm-diagnosis", "anchor": "profiling-and-jvm-diagnosis", "title": "Profiling and JVM Diagnosis", "level": 1 }, { "id": "start-with-a-hypothesis", "anchor": "start-with-a-hypothesis", "title": "Start with a hypothesis", "level": 2 }, { "id": "jvm-capture-workflow", "anchor": "jvm-capture-workflow", "title": "JVM capture workflow", "level": 2 }, { "id": "cross-platform-qualification", "anchor": "cross-platform-qualification", "title": "Cross-platform qualification", "level": 2 }, { "id": "capture-and-storage-contract", "anchor": "capture-and-storage-contract", "title": "Capture and storage contract", "level": 2 }, { "id": "a-diagnosis-is-complete-when", "anchor": "a-diagnosis-is-complete-when", "title": "A diagnosis is complete when", "level": 2 } ], "links": [ { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "start-with-a-hypothesis" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "start-with-a-hypothesis" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "cross-platform-qualification" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "cross-platform-qualification" } ] }, { "id": "operations-references", "owner": "Reaktor / Codex", "kind": "reference", "summary": "Every Shadow textbook chapter mapped to a page, related Reaktor documents reconciled and implementation/source evidence indexed.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-overview", "order": 1, "title": "Operations Sources and Document Register", "nav": "Sources & document map", "group": "operations", "subsection": "operations-overview", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations-references", "revision": "5375008210250eb6f2de12ccdefd3ebfd8cb64342bc1bc9ad91d272ff8dfa7c9", "status": "unverified", "renderingRevision": "0e31c1be0c283df2cc4b86fd4911d8d2a011001357fb8dbff12144e50dd147e7", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.postgresql.org/docs/18/logical-replication-restrictions.html", "https://www.postgresql.org/docs/18/logicaldecoding-explanation.html", "https://tc39.es/ecma262/multipage/ordinary-and-exotic-objects-behaviours.html#sec-proxy-object-internal-methods-and-internal-slots", "https://developers.cloudflare.com/workers/runtime-apis/bindings/", "https://developers.cloudflare.com/workers/reference/how-workers-works/", "https://developers.cloudflare.com/queues/reference/delivery-guarantees/", "https://opentelemetry.io/docs/concepts/sampling/", "https://keploy.io/docs/running-keploy/mock-your-tests/", "https://keploy.io/docs/server/install/", "https://keploy.io/docs/quickstart/k8s-proxy/", "https://developers.cloudflare.com/workers/previews/", "https://developers.cloudflare.com/workers/testing/vitest-integration/", "https://developers.cloudflare.com/workers/testing/vitest-integration/mock-outbound-requests/", "https://developers.cloudflare.com/dynamic-workers/", "https://supabase.com/docs/guides/deployment/branching/dashboard", "https://grafana.com/docs/k6/latest/using-k6/scenarios/concepts/open-vs-closed/", "https://schemathesis.readthedocs.io/en/stable/", "https://www.zaproxy.org/docs/automate/automation-framework/", "https://developers.cloudflare.com/workers/runtime-apis/performance/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations-references", "polarity": "Neutral" }, { "id": "section-textbook-chapters", "anchor": "textbook-chapters", "label": "Textbook chapter register", "profile": "section", "contract": "https://reaktor.build/docs/operations-references#textbook-chapters", "polarity": "Neutral" }, { "id": "section-document-register", "anchor": "document-register", "label": "Related document register", "profile": "section", "contract": "https://reaktor.build/docs/operations-references#document-register", "polarity": "Neutral" }, { "id": "section-implementation-evidence", "anchor": "implementation-evidence", "label": "Implementation evidence", "profile": "section", "contract": "https://reaktor.build/docs/operations-references#implementation-evidence", "polarity": "Neutral" }, { "id": "section-textbook-primary-references", "anchor": "textbook-primary-references", "label": "Textbook primary references", "profile": "section", "contract": "https://reaktor.build/docs/operations-references#textbook-primary-references", "polarity": "Neutral" } ], "relations": [ { "id": "operations-references:references-shadow-foundations", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-workspaces", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-capture-replay", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-backends", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-backends", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-verification", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-operations-load-resilience", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "operations-load-resilience", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-verification-send-retry-reconnect", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "section-send-retry-reconnect", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-clients-agents", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-operations-delivery", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-operations", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-capture-fabric", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-chapters", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-performance-observability", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-dev-environment", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-analytics-telemetry", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-instrumentation-plan", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-devtools", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-tooling-layer", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-workbench-links", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-cloud", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-cloud-pane", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-devops", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-build-tools", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-cli", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-graph-pane", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-unified-system-graph", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-graph-protocol", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-graph-sources", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor_graph_visitors_design", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-component-lifecycle", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-actor-model", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-distributed-actors", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-service", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-server", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-db", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-data-graph", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-work", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-notifications-design", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-multitenancy", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-surface-performance-and-assets", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-performance-and-assets", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-surface-dynamic-ui-and-verification", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-flexbuffer-implementation", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-ffi", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-security-plan", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-secrets-management", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-auth-analysis", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-agent-workspace", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-agentic-tooling", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-conductor", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-formal-methods", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-module-review", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-reaktor-module-execution-plan", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-claude-dev-environment", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "claude-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-codex-dev-environment", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "codex-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-performance-observability-history", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-shadow-design-history", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-operations-observability", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-primary-references", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-operations-instance-diagnostics", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-primary-references", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-operations-profiling", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-textbook-primary-references", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations-references:references-operations-crashlytics", "kind": "references", "owner": "operations-references", "incidences": [ { "node": "operations-references", "port": "section-document-register", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations-references.json", "sections": [ { "id": "operations-sources-and-document-register", "anchor": "operations-sources-and-document-register", "title": "Operations Sources and Document Register", "level": 1 }, { "id": "textbook-chapters", "anchor": "textbook-chapters", "title": "Textbook chapter register", "level": 2 }, { "id": "document-register", "anchor": "document-register", "title": "Related document register", "level": 2 }, { "id": "implementation-evidence", "anchor": "implementation-evidence", "title": "Implementation evidence", "level": 2 }, { "id": "textbook-primary-references", "anchor": "textbook-primary-references", "title": "Textbook primary references", "level": 2 } ], "links": [ { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-verification", "anchor": "send-retry-reconnect", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "textbook-chapters" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-instrumentation-plan", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-graph-pane", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-module-review", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "claude-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "codex-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "performance-observability-history", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "shadow-design-history", "anchor": "", "relation": "references", "sourceAnchor": "document-register" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "textbook-primary-references" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "textbook-primary-references" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "textbook-primary-references" } ] }, { "id": "operations", "owner": "Reaktor / Codex", "kind": "overview", "summary": "Shared observability, graph evidence, instance diagnostics and the complete Shadow textbook reading map.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-overview", "order": 0, "title": "Operations & Reliability", "nav": "Operations overview", "group": "operations", "subsection": "operations-overview", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/operations", "revision": "2d0561f80e6dd54101920eff9c83876396bd9f8e398af69178bc6b17c679994a", "status": "unverified", "renderingRevision": "b471695540199396f9b31aa94ac35c13bf5504be0f5f7876adae9b37cf8dbad2", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/operations", "polarity": "Neutral" }, { "id": "section-read-by-task", "anchor": "read-by-task", "label": "Read by task", "profile": "section", "contract": "https://reaktor.build/docs/operations#read-by-task", "polarity": "Neutral" }, { "id": "section-current-implementation-and-intended-direction", "anchor": "current-implementation-and-intended-direction", "label": "Current implementation and intended direction", "profile": "section", "contract": "https://reaktor.build/docs/operations#current-implementation-and-intended-direction", "polarity": "Neutral" }, { "id": "section-one-graph-several-kinds-of-evidence", "anchor": "one-graph-several-kinds-of-evidence", "label": "One graph, several kinds of evidence", "profile": "section", "contract": "https://reaktor.build/docs/operations#one-graph-several-kinds-of-evidence", "polarity": "Neutral" }, { "id": "section-document-ownership-and-reconciliation", "anchor": "document-ownership-and-reconciliation", "label": "Document ownership and reconciliation", "profile": "section", "contract": "https://reaktor.build/docs/operations#document-ownership-and-reconciliation", "polarity": "Neutral" }, { "id": "section-textbook-conversion", "anchor": "textbook-conversion", "label": "Textbook conversion", "profile": "section", "contract": "https://reaktor.build/docs/operations#textbook-conversion", "polarity": "Neutral" } ], "relations": [ { "id": "operations:references-shadow-capture-fabric", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-observability", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-reaktor-analytics-telemetry", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-graph-evidence", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-reaktor-workbench-links", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-instance-diagnostics", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-profiling", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-crashlytics", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-dev-environment", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-foundations", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-workspaces", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-backends", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-backends", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-capture-replay", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-verification", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-clients-agents", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-delivery", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-load-resilience", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "operations-load-resilience", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-performance-observability", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-read-by-task", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-references-implementation-evidence", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-current-implementation-and-intended-direction", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "section-implementation-evidence", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-references-document-register", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-document-ownership-and-reconciliation", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "section-document-register", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-performance-observability-history", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-document-ownership-and-reconciliation", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-shadow-design-history", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-document-ownership-and-reconciliation", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "operations:references-operations-references-textbook-chapters", "kind": "references", "owner": "operations", "incidences": [ { "node": "operations", "port": "section-textbook-conversion", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "section-textbook-chapters", "role": "target", "ordinal": 0 } ] } ] }, "content": "operations.json", "sections": [ { "id": "operations--reliability", "anchor": "operations--reliability", "title": "Operations & Reliability", "level": 1 }, { "id": "read-by-task", "anchor": "read-by-task", "title": "Read by task", "level": 2 }, { "id": "current-implementation-and-intended-direction", "anchor": "current-implementation-and-intended-direction", "title": "Current implementation and intended direction", "level": 2 }, { "id": "one-graph-several-kinds-of-evidence", "anchor": "one-graph-several-kinds-of-evidence", "title": "One graph, several kinds of evidence", "level": 2 }, { "id": "document-ownership-and-reconciliation", "anchor": "document-ownership-and-reconciliation", "title": "Document ownership and reconciliation", "level": 2 }, { "id": "textbook-conversion", "anchor": "textbook-conversion", "title": "Textbook conversion", "level": 2 } ], "links": [ { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "read-by-task" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "current-implementation-and-intended-direction" }, { "id": "operations-references", "anchor": "implementation-evidence", "relation": "references", "sourceAnchor": "current-implementation-and-intended-direction" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "one-graph-several-kinds-of-evidence" }, { "id": "operations-references", "anchor": "document-register", "relation": "references", "sourceAnchor": "document-ownership-and-reconciliation" }, { "id": "performance-observability-history", "anchor": "", "relation": "references", "sourceAnchor": "document-ownership-and-reconciliation" }, { "id": "shadow-design-history", "anchor": "", "relation": "references", "sourceAnchor": "document-ownership-and-reconciliation" }, { "id": "operations-references", "anchor": "textbook-chapters", "relation": "references", "sourceAnchor": "textbook-conversion" } ] }, { "id": "performance-observability-history", "owner": "Reaktor / Codex", "kind": "prior", "summary": "Superseded performance/observability design and September reviews preserved before the October reconciliation.", "use": "Read as dated historical source, not current behavior.", "region": "background-research", "order": 2, "title": "Performance design history", "nav": "Performance history", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/performance-observability-history", "revision": "f4eb39c32a168794e8d36989af106e8da623b9484c6ae32fc6920e64e2b71988", "status": "historical", "renderingRevision": "a22effc8ac6f935face782968990c6ff361f097942fe40270c7fc9b99a5bd8e0", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "265-benchmarking-is-a-third-discipline-and-this-document-was-missing-it" ], "externalLinks": [ "https://pyroscope.io" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/performance-observability-history", "polarity": "Neutral" }, { "id": "section-summary", "anchor": "summary", "label": "1. Executive summary", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#summary", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "2. Current state of reaktor-performance", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#current", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "3. Guiding principles", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#principles", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "4. The unified data model", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#model", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "5. Stack architecture", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#architecture", "polarity": "Neutral" }, { "id": "section-android", "anchor": "android", "label": "6. Android profiling & vitals", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#android", "polarity": "Neutral" }, { "id": "section-verified", "anchor": "verified", "label": "26. Verified state, 13 September 2026", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#verified", "polarity": "Neutral" }, { "id": "section-lighthouse", "anchor": "lighthouse", "label": "2.4 Lighthouse runner (standard)", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#lighthouse", "polarity": "Neutral" }, { "id": "section-ios", "anchor": "ios", "label": "7. iOS profiling & vitals", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#ios", "polarity": "Neutral" }, { "id": "section-web", "anchor": "web", "label": "8. Web vitals & Lighthouse", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#web", "polarity": "Neutral" }, { "id": "section-desktop", "anchor": "desktop", "label": "9. Desktop (JVM) profiling", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#desktop", "polarity": "Neutral" }, { "id": "section-client-drivers", "anchor": "client-drivers", "label": "10. Maestro · Flashlight · Playwright", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#client-drivers", "polarity": "Neutral" }, { "id": "section-jvm-server", "anchor": "jvm-server", "label": "11. JVM server profiling", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#jvm-server", "polarity": "Neutral" }, { "id": "section-workers", "anchor": "workers", "label": "12. Cloudflare Workers profiling", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#workers", "polarity": "Neutral" }, { "id": "section-server-drivers", "anchor": "server-drivers", "label": "13. k6 · Gatling · Keploy", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#server-drivers", "polarity": "Neutral" }, { "id": "section-postgres", "anchor": "postgres", "label": "14. Postgres & Hyperdrive", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#postgres", "polarity": "Neutral" }, { "id": "section-memgraph", "anchor": "memgraph", "label": "15. Memgraph / Neo4j", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#memgraph", "polarity": "Neutral" }, { "id": "section-sqlite", "anchor": "sqlite", "label": "16. Client SQLite (SQLDelight)", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#sqlite", "polarity": "Neutral" }, { "id": "section-telemetry-pipeline", "anchor": "telemetry-pipeline", "label": "17. OTel pipeline · Tempo · Mimir · Loki", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#telemetry-pipeline", "polarity": "Neutral" }, { "id": "section-prod-slos", "anchor": "prod-slos", "label": "18. Production SLOs & alerts", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#prod-slos", "polarity": "Neutral" }, { "id": "section-blueprint", "anchor": "blueprint", "label": "21. Blueprint overlay", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#blueprint", "polarity": "Neutral" }, { "id": "section-ai", "anchor": "ai", "label": "22. AI-assisted analysis", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#ai", "polarity": "Neutral" }, { "id": "section-bestbuds", "anchor": "bestbuds", "label": "23. BestBuds wiring", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#bestbuds", "polarity": "Neutral" }, { "id": "section-plan", "anchor": "plan", "label": "24. Phased plan", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#plan", "polarity": "Neutral" }, { "id": "section-risks", "anchor": "risks", "label": "25. Risks & open questions", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#risks", "polarity": "Neutral" }, { "id": "section-jvm-server-4", "anchor": "jvm-server-4", "label": "11.3 Worker / actor metrics", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#jvm-server-4", "polarity": "Neutral" }, { "id": "section-telemetry-pipeline-3", "anchor": "telemetry-pipeline-3", "label": "17.2 Backend choice", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#telemetry-pipeline-3", "polarity": "Neutral" }, { "id": "section-265-benchmarking-is-a-third-discipline-and-this-document-was-missing-it", "anchor": "265-benchmarking-as-a-separate-discipline", "label": "26.5 Benchmarking as a separate discipline", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#265-benchmarking-as-a-separate-discipline", "polarity": "Neutral" }, { "id": "section-267-a-profile-capture-is-a-tooling-layer-fact", "anchor": "267-a-profile-capture-is-a-tooling-layer-fact", "label": "26.7 A profile capture is a tooling-layer fact", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#267-a-profile-capture-is-a-tooling-layer-fact", "polarity": "Neutral" }, { "id": "section-269-order-of-work", "anchor": "269-order-of-work", "label": "26.9 Order of work", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#269-order-of-work", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability-history#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "performance-observability-history:references-operations", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-performance-observability", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "page", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-work", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-jvm-server-4", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-db-sinks", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-telemetry-pipeline-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-sinks", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-devtools", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-265-benchmarking-is-a-third-discipline-and-this-document-was-missing-it", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-tooling-layer-three-nouns", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-267-a-profile-capture-is-a-tooling-layer-fact", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "section-three-nouns", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-tooling-layer-an-attachment-is-an-rgp-target", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-267-a-profile-capture-is-a-tooling-layer-fact", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "section-an-attachment-is-an-rgp-target", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-tooling-layer-the-fidelity-ladder", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-267-a-profile-capture-is-a-tooling-layer-fact", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "section-the-fidelity-ladder", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-instrumentation-plan-build-vs-adopt", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-269-order-of-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "section-build-vs-adopt", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-analytics-telemetry", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-shadow-dev-environment", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-devops", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-cloud-pane", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-flexbuffer-implementation", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability-history:references-reaktor-server", "kind": "references", "owner": "performance-observability-history", "incidences": [ { "node": "performance-observability-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "performance-observability-history.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Performance design history", "level": 0 }, { "id": "summary", "anchor": "summary", "title": "1. Executive summary", "level": 2 }, { "id": "current", "anchor": "current", "title": "2. Current state of reaktor-performance", "level": 2 }, { "id": "current-2", "anchor": "current-2", "title": "2.1 What ships in reaktor-performance", "level": 3 }, { "id": "current-3", "anchor": "current-3", "title": "2.2 Adjacent infrastructure", "level": 3 }, { "id": "current-4", "anchor": "current-4", "title": "2.3 Gaps that block end-to-end perf", "level": 3 }, { "id": "lighthouse", "anchor": "lighthouse", "title": "2.4 Lighthouse runner (standard)", "level": 3 }, { "id": "principles", "anchor": "principles", "title": "3. Guiding principles", "level": 2 }, { "id": "1--graph-attribution-is-sacred", "anchor": "1--graph-attribution-is-sacred", "title": "1 · Graph attribution is sacred", "level": 4 }, { "id": "2--one-collector-many-sources", "anchor": "2--one-collector-many-sources", "title": "2 · One collector, many sources", "level": 4 }, { "id": "3--dont-measure-what-you-cant-act-on", "anchor": "3--dont-measure-what-you-cant-act-on", "title": "3 · Don't measure what you can't act on", "level": 4 }, { "id": "4--drivers-are-upstream-tools-not-reinventions", "anchor": "4--drivers-are-upstream-tools-not-reinventions", "title": "4 · Drivers are upstream tools, not reinventions", "level": 4 }, { "id": "5--otel-is-the-only-wire-format", "anchor": "5--otel-is-the-only-wire-format", "title": "5 · OTel is the only wire format", "level": 4 }, { "id": "6--production-and-ci-share-the-schema", "anchor": "6--production-and-ci-share-the-schema", "title": "6 · Production and CI share the schema", "level": 4 }, { "id": "7--slos-decide-alert-severity", "anchor": "7--slos-decide-alert-severity", "title": "7 · SLOs decide alert severity", "level": 4 }, { "id": "8--telemetry-must-be-observable", "anchor": "8--telemetry-must-be-observable", "title": "8 · Telemetry must be observable", "level": 4 }, { "id": "model", "anchor": "model", "title": "4. The unified data model", "level": 2 }, { "id": "architecture", "anchor": "architecture", "title": "5. Stack architecture", "level": 2 }, { "id": "android", "anchor": "android", "title": "6. Android profiling & vitals", "level": 2 }, { "id": "android-2", "anchor": "android-2", "title": "6.1 Vitals collection", "level": 3 }, { "id": "frame-metrics", "anchor": "frame-metrics", "title": "Frame metrics", "level": 4 }, { "id": "startup--cold-start", "anchor": "startup--cold-start", "title": "Startup & cold start", "level": 4 }, { "id": "long-tasks", "anchor": "long-tasks", "title": "Long tasks", "level": 4 }, { "id": "memory", "anchor": "memory", "title": "Memory", "level": 4 }, { "id": "android-3", "anchor": "android-3", "title": "6.2 Profiling", "level": 3 }, { "id": "android-4", "anchor": "android-4", "title": "6.3 Low-level / debugging", "level": 3 }, { "id": "ios", "anchor": "ios", "title": "7. iOS profiling & vitals", "level": 2 }, { "id": "ios-2", "anchor": "ios-2", "title": "7.1 Vitals collection", "level": 3 }, { "id": "frame-metrics-1", "anchor": "frame-metrics-1", "title": "Frame metrics", "level": 4 }, { "id": "metrickit", "anchor": "metrickit", "title": "MetricKit", "level": 4 }, { "id": "cold-start", "anchor": "cold-start", "title": "Cold start", "level": 4 }, { "id": "memory-1", "anchor": "memory-1", "title": "Memory", "level": 4 }, { "id": "ios-3", "anchor": "ios-3", "title": "7.2 Profiling", "level": 3 }, { "id": "ios-4", "anchor": "ios-4", "title": "7.3 Low-level / debugging", "level": 3 }, { "id": "web", "anchor": "web", "title": "8. Web vitals & Lighthouse", "level": 2 }, { "id": "web-2", "anchor": "web-2", "title": "8.1 In-browser collection", "level": 3 }, { "id": "web-3", "anchor": "web-3", "title": "8.2 Lighthouse CI", "level": 3 }, { "id": "web-4", "anchor": "web-4", "title": "8.3 Web bundle budgets", "level": 3 }, { "id": "desktop", "anchor": "desktop", "title": "9. Desktop (JVM) profiling", "level": 2 }, { "id": "client-drivers", "anchor": "client-drivers", "title": "10. Maestro · Flashlight · Playwright", "level": 2 }, { "id": "maestro--ui-flow-regression-with-timing-assertions", "anchor": "maestro--ui-flow-regression-with-timing-assertions", "title": "Maestro — UI flow regression with timing assertions", "level": 4 }, { "id": "flashlight--lighthouse-for-mobile", "anchor": "flashlight--lighthouse-for-mobile", "title": "Flashlight — \"Lighthouse for mobile\"", "level": 4 }, { "id": "playwright--web-e2e-with-trace--perf", "anchor": "playwright--web-e2e-with-trace--perf", "title": "Playwright — web e2e with trace + perf", "level": 4 }, { "id": "jvm-server", "anchor": "jvm-server", "title": "11. JVM server profiling", "level": 2 }, { "id": "jvm-server-2", "anchor": "jvm-server-2", "title": "11.1 Continuous profiling in production", "level": 3 }, { "id": "jvm-server-3", "anchor": "jvm-server-3", "title": "11.2 Service interceptor", "level": 3 }, { "id": "jvm-server-4", "anchor": "jvm-server-4", "title": "11.3 Worker / actor metrics", "level": 3 }, { "id": "jvm-server-5", "anchor": "jvm-server-5", "title": "11.4 Thread & lock analysis", "level": 3 }, { "id": "workers", "anchor": "workers", "title": "12. Cloudflare Workers profiling", "level": 2 }, { "id": "server-drivers", "anchor": "server-drivers", "title": "13. k6 · Gatling · Keploy", "level": 2 }, { "id": "k6--scripted-load-tests", "anchor": "k6--scripted-load-tests", "title": "k6 — scripted load tests", "level": 4 }, { "id": "gatling--same-role-jvm-ecosystem", "anchor": "gatling--same-role-jvm-ecosystem", "title": "Gatling — same role, JVM ecosystem", "level": 4 }, { "id": "keploy--capture-replay-regression", "anchor": "keploy--capture-replay-regression", "title": "Keploy — capture-replay regression", "level": 4 }, { "id": "postgres", "anchor": "postgres", "title": "14. Postgres & Hyperdrive", "level": 2 }, { "id": "memgraph", "anchor": "memgraph", "title": "15. Memgraph / Neo4j", "level": 2 }, { "id": "sqlite", "anchor": "sqlite", "title": "16. Client SQLite (SQLDelight)", "level": 2 }, { "id": "telemetry-pipeline", "anchor": "telemetry-pipeline", "title": "17. OTel pipeline · Tempo · Mimir · Loki", "level": 2 }, { "id": "telemetry-pipeline-2", "anchor": "telemetry-pipeline-2", "title": "17.1 Sampling", "level": 3 }, { "id": "telemetry-pipeline-3", "anchor": "telemetry-pipeline-3", "title": "17.2 Backend choice", "level": 3 }, { "id": "telemetry-pipeline-4", "anchor": "telemetry-pipeline-4", "title": "17.3 Telemetry pipeline health", "level": 3 }, { "id": "telemetry-pipeline-5", "anchor": "telemetry-pipeline-5", "title": "17.4 Exemplars and correlation IDs", "level": 3 }, { "id": "prod-slos", "anchor": "prod-slos", "title": "18. Production SLOs & alerts", "level": 2 }, { "id": "prod-slos-2", "anchor": "prod-slos-2", "title": "18.1 Journey SLOs", "level": 3 }, { "id": "prod-slos-3", "anchor": "prod-slos-3", "title": "18.2 Alert policy", "level": 3 }, { "id": "prod-slos-4", "anchor": "prod-slos-4", "title": "18.3 Burn-rate alerts", "level": 3 }, { "id": "prod-slos-5", "anchor": "prod-slos-5", "title": "18.4 Runbook shape", "level": 3 }, { "id": "prod-slos-6", "anchor": "prod-slos-6", "title": "18.5 Production coverage matrix", "level": 3 }, { "id": "governance", "anchor": "governance", "title": "19. Telemetry governance", "level": 2 }, { "id": "governance-2", "anchor": "governance-2", "title": "19.1 Cardinality contract", "level": 3 }, { "id": "governance-3", "anchor": "governance-3", "title": "19.2 Redaction and consent", "level": 3 }, { "id": "governance-4", "anchor": "governance-4", "title": "19.3 Metric catalog and schema tests", "level": 3 }, { "id": "governance-5", "anchor": "governance-5", "title": "19.4 Retention and cost controls", "level": 3 }, { "id": "governance-6", "anchor": "governance-6", "title": "19.5 Release and flag annotations", "level": 3 }, { "id": "ci", "anchor": "ci", "title": "20. CI integration & budgets", "level": 2 }, { "id": "ci-2", "anchor": "ci-2", "title": "20.1 Per-PR job sequence", "level": 3 }, { "id": "ci-3", "anchor": "ci-3", "title": "20.2 Headline budgets", "level": 3 }, { "id": "ci-4", "anchor": "ci-4", "title": "20.3 PR comment format", "level": 3 }, { "id": "blueprint", "anchor": "blueprint", "title": "21. Blueprint overlay", "level": 2 }, { "id": "ai", "anchor": "ai", "title": "22. AI-assisted analysis", "level": 2 }, { "id": "hotspot-summariser", "anchor": "hotspot-summariser", "title": "Hotspot summariser", "level": 4 }, { "id": "bundle-bloat-detector", "anchor": "bundle-bloat-detector", "title": "Bundle bloat detector", "level": 4 }, { "id": "slow-query-rewriter", "anchor": "slow-query-rewriter", "title": "Slow-query rewriter", "level": 4 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "23. BestBuds wiring", "level": 2 }, { "id": "plan", "anchor": "plan", "title": "24. Phased plan", "level": 2 }, { "id": "wire-the-collector-to-otel", "anchor": "wire-the-collector-to-otel", "title": "Wire the collector to OTel", "level": 4 }, { "id": "client-vitals", "anchor": "client-vitals", "title": "Client vitals", "level": 4 }, { "id": "db--worker-spans", "anchor": "db--worker-spans", "title": "DB & worker spans", "level": 4 }, { "id": "production-guardrails", "anchor": "production-guardrails", "title": "Production guardrails", "level": 4 }, { "id": "ci-drivers", "anchor": "ci-drivers", "title": "CI drivers", "level": 4 }, { "id": "continuous-profiling", "anchor": "continuous-profiling", "title": "Continuous profiling", "level": 4 }, { "id": "blueprint-overlay", "anchor": "blueprint-overlay", "title": "Blueprint overlay", "level": 4 }, { "id": "ai-assisted-analysis", "anchor": "ai-assisted-analysis", "title": "AI-assisted analysis", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "25. Risks & open questions", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Risks", "level": 4 }, { "id": "risks-3", "anchor": "risks-3", "title": "Open questions", "level": 4 }, { "id": "verified", "anchor": "verified", "title": "26. Verified state, 13 September 2026", "level": 2 }, { "id": "261-the-pattern", "anchor": "261-the-pattern", "title": "26.1 The pattern", "level": 3 }, { "id": "262-what-actually-collects-per-target", "anchor": "262-what-actually-collects-per-target", "title": "26.2 What actually collects, per target", "level": 3 }, { "id": "263-the-flexbuffer-harness-is-the-frameworks-profiling-layer-misfiled", "anchor": "263-the-flexbuffer-harness-is-the-frameworks-profiling-layer-misfiled", "title": "26.3 The flexbuffer harness is the framework's profiling layer, misfiled", "level": 3 }, { "id": "264-corrections-to-2", "anchor": "264-corrections-to-2", "title": "26.4 Corrections to §2", "level": 3 }, { "id": "265-benchmarking-as-a-separate-discipline", "anchor": "265-benchmarking-as-a-separate-discipline", "title": "26.5 Benchmarking as a separate discipline", "level": 3 }, { "id": "266-trace-format-adopt-perfetto-do-not-extend-reaktorflamegraphframe", "anchor": "266-trace-format-adopt-perfetto-do-not-extend-reaktorflamegraphframe", "title": "26.6 Trace format: adopt Perfetto, do not extend ReaktorFlamegraphFrame", "level": 3 }, { "id": "267-a-profile-capture-is-a-tooling-layer-fact", "anchor": "267-a-profile-capture-is-a-tooling-layer-fact", "title": "26.7 A profile capture is a tooling-layer fact", "level": 3 }, { "id": "268-where-reaktor-can-beat-the-field", "anchor": "268-where-reaktor-can-beat-the-field", "title": "26.8 Where Reaktor can beat the field", "level": 3 }, { "id": "269-order-of-work", "anchor": "269-order-of-work", "title": "26.9 Order of work", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "performance-observability-history", "anchor": "verified", "relation": "references", "sourceAnchor": "current-2" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "jvm-server-4" }, { "id": "reaktor-db", "anchor": "sinks", "relation": "references", "sourceAnchor": "telemetry-pipeline-3" }, { "id": "performance-observability-history", "anchor": "principles", "relation": "references", "sourceAnchor": "261-the-pattern" }, { "id": "performance-observability-history", "anchor": "principles", "relation": "references", "sourceAnchor": "264-corrections-to-2" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "265-benchmarking-as-a-separate-discipline" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "266-trace-format-adopt-perfetto-do-not-extend-reaktorflamegraphframe" }, { "id": "reaktor-tooling-layer", "anchor": "three-nouns", "relation": "references", "sourceAnchor": "267-a-profile-capture-is-a-tooling-layer-fact" }, { "id": "reaktor-tooling-layer", "anchor": "an-attachment-is-an-rgp-target", "relation": "references", "sourceAnchor": "267-a-profile-capture-is-a-tooling-layer-fact" }, { "id": "reaktor-tooling-layer", "anchor": "the-fidelity-ladder", "relation": "references", "sourceAnchor": "267-a-profile-capture-is-a-tooling-layer-fact" }, { "id": "performance-observability-history", "anchor": "principles", "relation": "references", "sourceAnchor": "268-where-reaktor-can-beat-the-field" }, { "id": "reaktor-instrumentation-plan", "anchor": "build-vs-adopt", "relation": "references", "sourceAnchor": "269-order-of-work" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "performance-observability", "owner": "Codex", "kind": "ops", "summary": "Current-source operating overview for shared telemetry, instance diagnosis, profiling, controlled workloads and measurement gates.", "use": "Start here for performance coverage; follow the Operations topic pages for detailed contracts.", "region": "operations-observability", "order": 0, "title": "Performance and Observability", "nav": "Performance overview", "group": "operations", "subsection": "operations-observability", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/performance-observability", "revision": "5b858a162ca7c4069e914b641638d6c60f5caed443be94ac73e072abd071cc61", "status": "unverified", "renderingRevision": "435627a515dd3a09982c42f2b74ded0d6e99ac787f7004778ee0a122f6480aee", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "summary", "current", "lighthouse", "principles", "model", "architecture", "android", "ios", "web", "desktop", "client-drivers", "jvm-server", "workers", "server-drivers", "postgres", "memgraph", "sqlite", "telemetry-pipeline", "prod-slos", "blueprint", "ai", "bestbuds", "plan", "risks" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/performance-observability", "polarity": "Neutral" }, { "id": "section-verified", "anchor": "verified", "label": "Source-grounded starting state", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability#verified", "polarity": "Neutral" }, { "id": "section-operating-paths", "anchor": "operating-paths", "label": "Operating paths", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability#operating-paths", "polarity": "Neutral" }, { "id": "section-ci", "anchor": "ci", "label": "Evidence and budgets", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability#ci", "polarity": "Neutral" }, { "id": "section-governance", "anchor": "governance", "label": "Graph, privacy and lifecycle", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability#governance", "polarity": "Neutral" }, { "id": "section-supporting-documents", "anchor": "supporting-documents", "label": "Supporting documents", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability#supporting-documents", "polarity": "Neutral" }, { "id": "section-earlier-section-links", "anchor": "earlier-section-links", "label": "Earlier section links", "profile": "section", "contract": "https://reaktor.build/docs/performance-observability#earlier-section-links", "polarity": "Neutral" } ], "relations": [ { "id": "performance-observability:references-operations", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-flexbuffer-performance-review", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-verified", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-references-implementation-evidence", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-verified", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "section-implementation-evidence", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-observability", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-graph-evidence", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-instance-diagnostics", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-profiling", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-load-resilience", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "operations-load-resilience", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-shadow-verification", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-reaktor-instrumentation-plan", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-delivery", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-operating-paths", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-reaktor-analytics-telemetry", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-supporting-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-reaktor-devtools", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-supporting-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-reaktor-tooling-layer", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-supporting-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-reaktor-workbench-links", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-supporting-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-supporting-documents", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-summary", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-summary", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-current", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-current", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-lighthouse", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-lighthouse", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-principles", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-principles", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-model", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-model", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-architecture", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-architecture", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-android", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-android", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-ios", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-ios", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-web", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-web", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-desktop", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-desktop", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-client-drivers", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-client-drivers", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-jvm-server", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-jvm-server", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-workers", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-workers", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-server-drivers", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-server-drivers", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-postgres", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-postgres", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-memgraph", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-memgraph", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-sqlite", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-sqlite", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-telemetry-pipeline", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-telemetry-pipeline", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-prod-slos", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-prod-slos", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-blueprint", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-blueprint", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-ai", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-ai", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-bestbuds", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-bestbuds", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-plan", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-plan", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-performance-observability-history-risks", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "performance-observability-history", "port": "section-risks", "role": "target", "ordinal": 0 } ] }, { "id": "performance-observability:references-operations-crashlytics", "kind": "references", "owner": "performance-observability", "incidences": [ { "node": "performance-observability", "port": "section-verified", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "performance-observability.json", "sections": [ { "id": "performance-and-observability", "anchor": "performance-and-observability", "title": "Performance and Observability", "level": 1 }, { "id": "verified", "anchor": "verified", "title": "Source-grounded starting state", "level": 2 }, { "id": "operating-paths", "anchor": "operating-paths", "title": "Operating paths", "level": 2 }, { "id": "ci", "anchor": "ci", "title": "Evidence and budgets", "level": 2 }, { "id": "governance", "anchor": "governance", "title": "Graph, privacy and lifecycle", "level": 2 }, { "id": "supporting-documents", "anchor": "supporting-documents", "title": "Supporting documents", "level": 2 }, { "id": "earlier-section-links", "anchor": "earlier-section-links", "title": "Earlier section links", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "verified" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "verified" }, { "id": "operations-references", "anchor": "implementation-evidence", "relation": "references", "sourceAnchor": "verified" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "reaktor-instrumentation-plan", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "operating-paths" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "supporting-documents" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "supporting-documents" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "supporting-documents" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "supporting-documents" }, { "id": "performance-observability-history", "anchor": "", "relation": "references", "sourceAnchor": "supporting-documents" }, { "id": "performance-observability-history", "anchor": "summary", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "current", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "lighthouse", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "principles", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "model", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "architecture", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "android", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "ios", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "web", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "desktop", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "client-drivers", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "jvm-server", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "workers", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "server-drivers", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "postgres", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "memgraph", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "sqlite", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "telemetry-pipeline", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "prod-slos", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "blueprint", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "ai", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "bestbuds", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "plan", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "performance-observability-history", "anchor": "risks", "relation": "references", "sourceAnchor": "earlier-section-links" } ] }, { "id": "reaktor-actor-model", "owner": "Codex", "kind": "architecture", "summary": "ActorNode as a graph node with a serialized mailbox, exclusive state, and port wiring.", "use": "Use before adding actor behavior or moving chat/session workflows into actors.", "region": "graph-model", "order": 4, "title": "Reaktor Actor Model", "nav": "Actor Model", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-actor-model", "revision": "abf9f0e6a93cdf38d1cb3157dc7a0ce24d0ed30885976056a06069b9bd7813e8", "status": "unverified", "renderingRevision": "fce1aba373e42c96194ffd2fc68df96b3f5a0e9a011fd35fb22f77dc396d754f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://github.com/cloudflare/actors", "https://developers.cloudflare.com/durable-objects/", "https://developers.cloudflare.com/durable-objects/what-are-durable-objects/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-actor-model", "polarity": "Neutral" }, { "id": "section-status", "anchor": "status", "label": "1. Implementation Status", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#status", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "2. Principles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#principles", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "3. Core Model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#model", "polarity": "Neutral" }, { "id": "section-api", "anchor": "api", "label": "4. API Shape", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#api", "polarity": "Neutral" }, { "id": "section-lifecycle", "anchor": "lifecycle", "label": "5. Lifecycle and Supervision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#lifecycle", "polarity": "Neutral" }, { "id": "section-storage", "anchor": "storage", "label": "6. Exclusive ObjectStore", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#storage", "polarity": "Neutral" }, { "id": "section-reaktor-superset-path", "anchor": "reaktor-superset-path", "label": "Reaktor superset path", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#reaktor-superset-path", "polarity": "Neutral" }, { "id": "section-next", "anchor": "next", "label": "11. Next Work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#next", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-actor-model#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-actor-model:references-reaktor-distributed-actors-edge", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-reaktor-superset-path", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "section-edge", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-reaktor-db-consistency", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-reaktor-superset-path", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-consistency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-reaktor-multitenancy-edge", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-next", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "section-edge", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-reaktor-work", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-reaktor-service", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-actor-model:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-actor-model", "incidences": [ { "node": "reaktor-actor-model", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-actor-model.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Actor Model", "level": 0 }, { "id": "status", "anchor": "status", "title": "1. Implementation Status", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "2. Principles", "level": 2 }, { "id": "what-actors-are-for", "anchor": "what-actors-are-for", "title": "What actors are for", "level": 3 }, { "id": "what-actors-are-not-for", "anchor": "what-actors-are-not-for", "title": "What actors are not for", "level": 3 }, { "id": "model", "anchor": "model", "title": "3. Core Model", "level": 2 }, { "id": "model-2", "anchor": "model-2", "title": "The critical contract", "level": 3 }, { "id": "api", "anchor": "api", "title": "4. API Shape", "level": 2 }, { "id": "api-2", "anchor": "api-2", "title": "Graph declaration", "level": 3 }, { "id": "api-3", "anchor": "api-3", "title": "Node consumption", "level": 3 }, { "id": "lifecycle", "anchor": "lifecycle", "title": "5. Lifecycle and Supervision", "level": 2 }, { "id": "lifecycle-2", "anchor": "lifecycle-2", "title": "Failure rule", "level": 3 }, { "id": "storage", "anchor": "storage", "title": "6. Exclusive ObjectStore", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "7. Graph Wiring", "level": 2 }, { "id": "provideskey-create", "anchor": "provideskey-create", "title": "provides(key, create)", "level": 3 }, { "id": "consumeskey", "anchor": "consumeskey", "title": "consumes(key)", "level": 3 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "8. BestBuds ChatActor", "level": 2 }, { "id": "bestbuds-2", "anchor": "bestbuds-2", "title": "Before", "level": 3 }, { "id": "bestbuds-3", "anchor": "bestbuds-3", "title": "After", "level": 3 }, { "id": "bestbuds-4", "anchor": "bestbuds-4", "title": "Why this scales features", "level": 3 }, { "id": "cloudflare", "anchor": "cloudflare", "title": "9. Cloudflare Alignment", "level": 2 }, { "id": "durable-object-mapping", "anchor": "durable-object-mapping", "title": "Durable Object mapping", "level": 3 }, { "id": "reaktor-superset-path", "anchor": "reaktor-superset-path", "title": "Reaktor superset path", "level": 3 }, { "id": "invariants", "anchor": "invariants", "title": "10. Invariants", "level": 2 }, { "id": "next", "anchor": "next", "title": "11. Next Work", "level": 2 }, { "id": "sources", "anchor": "sources", "title": "12. Sources", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-distributed-actors", "anchor": "edge", "relation": "references", "sourceAnchor": "reaktor-superset-path" }, { "id": "reaktor-db", "anchor": "consistency", "relation": "references", "sourceAnchor": "reaktor-superset-path" }, { "id": "reaktor-multitenancy", "anchor": "edge", "relation": "references", "sourceAnchor": "next" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-agent-efficiency", "owner": "Claude", "kind": "guide", "summary": "A field report from one large multi-agent session: where about 19 million tokens went, the MCP reads, guards and headless flows agents should use today, and ten ordered enhancements — codemods, one verify call with typed results, context packs, design-bar guards, a hermetic test kit, per-agent workspaces with a merge queue, scaffolds, structured output, stable ids and build hygiene.", "use": "Use before briefing coding agents on Reaktor or Hangar work, and when choosing which agent tooling to build next; each enhancement names its problem, shape and how to tell it worked.", "region": "agents-building", "order": 0, "title": "Building Reaktor with agents — where the tokens go, and how to spend fewer", "nav": "Agent efficiency", "group": "agents", "subsection": "agents-building", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-agent-efficiency", "revision": "570ce928b58c2919d1deefd3ee98022f9b0e109b677ed221ba1668f0eb56433f", "status": "unverified", "renderingRevision": "0f0287e1638e18ae6d66a22c15d12f395c9f70cfadee5420b56d0d7e236b5da3", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "measure" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency", "polarity": "Neutral" }, { "id": "section-evidence", "anchor": "evidence", "label": "1. What one session cost", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#evidence", "polarity": "Neutral" }, { "id": "section-use-now", "anchor": "use-now", "label": "2. Use what exists today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#use-now", "polarity": "Neutral" }, { "id": "section-build", "anchor": "build", "label": "3. What to build, highest leverage first", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#build", "polarity": "Neutral" }, { "id": "section-brief", "anchor": "brief", "label": "4. How to brief an agent", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#brief", "polarity": "Neutral" }, { "id": "section-measure", "anchor": "acceptance-criteria", "label": "5. Acceptance criteria", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#acceptance-criteria", "polarity": "Neutral" }, { "id": "section-order", "anchor": "order", "label": "6. Order of work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#order", "polarity": "Neutral" }, { "id": "section-related", "anchor": "related", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#related", "polarity": "Neutral" }, { "id": "section-codemods", "anchor": "codemods", "label": "3.1 Codemods for mechanical migrations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#codemods", "polarity": "Neutral" }, { "id": "section-verify", "anchor": "verify", "label": "3.2 One verify call with typed results", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#verify", "polarity": "Neutral" }, { "id": "section-context-packs", "anchor": "context-packs", "label": "3.3 Context packs per module", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#context-packs", "polarity": "Neutral" }, { "id": "section-guards", "anchor": "guards", "label": "3.4 Guards for the whole design bar", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#guards", "polarity": "Neutral" }, { "id": "section-workspaces", "anchor": "workspaces", "label": "3.6 One workspace per agent, behind a merge queue", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-efficiency#workspaces", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-agent-efficiency:references-hangar", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "hangar", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-surface", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-conductor-economics", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-economics", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-agent-workspace", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-agentic-tooling-phases", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-use-now", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "section-phases", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-conductor-measurement", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-codemods", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-measurement", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-conductor-verification", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-verify", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-verification", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-conductor-reduction", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-verify", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-reduction", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-conductor-agent-files", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-context-packs", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-agent-files", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-formal-methods", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-guards", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-agent-workspace-findings", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-guards", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "section-findings", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-agent-workspace-isolation", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-workspaces", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "section-isolation", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-agent-workspace-ledger", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-measure", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "section-ledger", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-conductor-build-order", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-order", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-build-order", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-efficiency:references-reaktor-conductor", "kind": "references", "owner": "reaktor-agent-efficiency", "incidences": [ { "node": "reaktor-agent-efficiency", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-agent-efficiency.json", "sections": [ { "id": "building-reaktor-with-agents-where-the-tokens-go-and-how-to-spend-fewer", "anchor": "building-reaktor-with-agents-where-the-tokens-go-and-how-to-spend-fewer", "title": "Building Reaktor with agents: where the tokens go, and how to spend fewer", "level": 1 }, { "id": "evidence", "anchor": "evidence", "title": "1. What one session cost", "level": 2 }, { "id": "use-now", "anchor": "use-now", "title": "2. Use what exists today", "level": 2 }, { "id": "build", "anchor": "build", "title": "3. What to build, highest leverage first", "level": 2 }, { "id": "codemods", "anchor": "codemods", "title": "3.1 Codemods for mechanical migrations", "level": 3 }, { "id": "verify", "anchor": "verify", "title": "3.2 One verify call with typed results", "level": 3 }, { "id": "context-packs", "anchor": "context-packs", "title": "3.3 Context packs per module", "level": 3 }, { "id": "guards", "anchor": "guards", "title": "3.4 Guards for the whole design bar", "level": 3 }, { "id": "hermetic", "anchor": "hermetic", "title": "3.5 A hermetic test kit", "level": 3 }, { "id": "workspaces", "anchor": "workspaces", "title": "3.6 One workspace per agent, behind a merge queue", "level": 3 }, { "id": "scaffolds", "anchor": "scaffolds", "title": "3.7 Scaffolds for the common shapes", "level": 3 }, { "id": "structured-output", "anchor": "structured-output", "title": "3.8 Structured output from every script", "level": 3 }, { "id": "stable-ids", "anchor": "stable-ids", "title": "3.9 Stable ids by construction", "level": 3 }, { "id": "build-hygiene", "anchor": "build-hygiene", "title": "3.10 Build hygiene", "level": 3 }, { "id": "brief", "anchor": "brief", "title": "4. How to brief an agent", "level": 2 }, { "id": "acceptance-criteria", "anchor": "acceptance-criteria", "title": "5. Acceptance criteria", "level": 2 }, { "id": "order", "anchor": "order", "title": "6. Order of work", "level": 2 }, { "id": "related", "anchor": "related", "title": "Related docs", "level": 2 } ], "links": [ { "id": "hangar", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-conductor", "anchor": "economics", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agentic-tooling", "anchor": "phases", "relation": "references", "sourceAnchor": "use-now" }, { "id": "reaktor-conductor", "anchor": "measurement", "relation": "references", "sourceAnchor": "codemods" }, { "id": "reaktor-conductor", "anchor": "verification", "relation": "references", "sourceAnchor": "verify" }, { "id": "reaktor-conductor", "anchor": "reduction", "relation": "references", "sourceAnchor": "verify" }, { "id": "reaktor-conductor", "anchor": "agent-files", "relation": "references", "sourceAnchor": "context-packs" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "guards" }, { "id": "reaktor-agent-workspace", "anchor": "findings", "relation": "references", "sourceAnchor": "guards" }, { "id": "reaktor-agent-workspace", "anchor": "isolation", "relation": "references", "sourceAnchor": "workspaces" }, { "id": "reaktor-conductor", "anchor": "measurement", "relation": "references", "sourceAnchor": "acceptance-criteria" }, { "id": "reaktor-agent-workspace", "anchor": "ledger", "relation": "references", "sourceAnchor": "acceptance-criteria" }, { "id": "reaktor-conductor", "anchor": "build-order", "relation": "references", "sourceAnchor": "order" }, { "id": "reaktor-conductor", "anchor": "build-order", "relation": "references", "sourceAnchor": "order" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "hangar", "anchor": "", "relation": "references", "sourceAnchor": "related" } ] }, { "id": "reaktor-agent-workspace", "owner": "Codex / Claude", "kind": "design", "summary": "Graph-first native Codex and Claude integration through an extension bundle and desktop session adapters: effort controls, typed findings, local context, evidence, orchestration and the workspace UI, with implemented behavior separated from proposals.", "use": "Read the reviewed native capability inventory, integration boundaries, local data responsibilities and eight delivery slices with concrete acceptance gates. Includes measured qualification results, an outcome-based savings evaluation and six Pencil destination boards.", "region": "agents-outbound", "order": 1, "title": "Reaktor Agent Workspace — Native Harnesses, Graph Context and Verified Work", "nav": "Agent Workspace", "group": "agents", "subsection": "agents-outbound", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-agent-workspace", "revision": "761f0c0599befd5a859fd9ad365f4d9bfaa8927102d30860d90ab93d1bddea09", "status": "unverified", "renderingRevision": "5ab087006f810b6528eee5eaacdf4a81470e68b3992981cebd3bf144f2210f2b", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://learn.chatgpt.com/docs/app-server", "https://code.claude.com/docs/en/cli-reference", "https://learn.chatgpt.com/docs/app-server#inject-items-into-a-thread", "https://antigravity.google/docs/artifacts/", "https://github.com/karpathy/llm-council", "https://learn.chatgpt.com/docs/app-server#item-deltas", "https://docs.pencil.dev/getting-started/ai-integration", "https://openai.com/index/scaling-storage-one-billion-users-part-one/", "https://aider.chat/docs/repomap.html", "https://tree-sitter.github.io/tree-sitter/", "https://docs.langchain.com/oss/python/langgraph/persistence" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-agent-workspace", "polarity": "Neutral" }, { "id": "section-surface", "anchor": "surface", "label": "1. Native capabilities and their qualification", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#surface", "polarity": "Neutral" }, { "id": "section-hook", "anchor": "hook", "label": "2. Two entry points, one graph-owned workspace", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#hook", "polarity": "Neutral" }, { "id": "section-effort", "anchor": "effort", "label": "3. Effort without a lowest-common-denominator ceiling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#effort", "polarity": "Neutral" }, { "id": "section-taskclass", "anchor": "taskclass", "label": "4. Route from graph evidence and measured outcomes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#taskclass", "polarity": "Neutral" }, { "id": "section-ladder", "anchor": "ladder", "label": "5. Budgets and collaboration policies", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#ladder", "polarity": "Neutral" }, { "id": "section-findings", "anchor": "findings", "label": "6. Typed findings with semantic validation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#findings", "polarity": "Neutral" }, { "id": "section-isolation", "anchor": "isolation", "label": "8. Local execution and honest isolation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#isolation", "polarity": "Neutral" }, { "id": "section-ledger", "anchor": "ledger", "label": "15. Measure accepted outcomes and human effort", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#ledger", "polarity": "Neutral" }, { "id": "section-thirdagent", "anchor": "thirdagent", "label": "23. A third agent: ChatGPT + Gemini", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#thirdagent", "polarity": "Neutral" }, { "id": "section-door", "anchor": "door", "label": "The door: one MCP entry in every harness", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#door", "polarity": "Neutral" }, { "id": "section-change-budget", "anchor": "change-budget", "label": "What a change may add", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#change-budget", "polarity": "Neutral" }, { "id": "section-ai-gateway", "anchor": "ai-gateway", "label": "24. Model traffic through Cloudflare AI Gateway", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#ai-gateway", "polarity": "Neutral" }, { "id": "section-status", "anchor": "status", "label": "22. Implementation evidence and delivery order", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#status", "polarity": "Neutral" }, { "id": "section-surface-design", "anchor": "surface-design", "label": "13. A small, schema-first graph surface", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#surface-design", "polarity": "Neutral" }, { "id": "section-data", "anchor": "data", "label": "16. Local data with bounded retrieval", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#data", "polarity": "Neutral" }, { "id": "section-related", "anchor": "related", "label": "Related", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agent-workspace#related", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-agent-workspace:references-reaktor-cloud-agents", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-door", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "section-agents", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-framework-overview-model", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-change-budget", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "section-model", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-surface-design", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-data-graph", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-data", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-db", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-data", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-conductor-measurement", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-ai-gateway", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-measurement", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-conductor-second-call", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-ai-gateway", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-second-call", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-conductor", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-workbench-layers", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agent-workspace:references-reaktor-desktop-master-plan", "kind": "references", "owner": "reaktor-agent-workspace", "incidences": [ { "node": "reaktor-agent-workspace", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-agent-workspace.json", "sections": [ { "id": "reaktor-agent-workspace", "anchor": "reaktor-agent-workspace", "title": "Reaktor Agent Workspace", "level": 1 }, { "id": "surface", "anchor": "surface", "title": "1. Native capabilities and their qualification", "level": 2 }, { "id": "hook", "anchor": "hook", "title": "2. Two entry points, one graph-owned workspace", "level": 2 }, { "id": "door", "anchor": "door", "title": "The door: one MCP entry in every harness", "level": 3 }, { "id": "effort", "anchor": "effort", "title": "3. Effort without a lowest-common-denominator ceiling", "level": 2 }, { "id": "taskclass", "anchor": "taskclass", "title": "4. Route from graph evidence and measured outcomes", "level": 2 }, { "id": "ladder", "anchor": "ladder", "title": "5. Budgets and collaboration policies", "level": 2 }, { "id": "change-budget", "anchor": "change-budget", "title": "What a change may add", "level": 3 }, { "id": "findings", "anchor": "findings", "title": "6. Typed findings with semantic validation", "level": 2 }, { "id": "context", "anchor": "context", "title": "7. Context delivery, continuation and cache reuse", "level": 2 }, { "id": "isolation", "anchor": "isolation", "title": "8. Local execution and honest isolation", "level": 2 }, { "id": "artifacts", "anchor": "artifacts", "title": "9. Artifacts from events and executors", "level": 2 }, { "id": "council", "anchor": "council", "title": "10. Council independence and useful disagreement", "level": 2 }, { "id": "trace", "anchor": "trace", "title": "11. A readable trace with provider fidelity", "level": 2 }, { "id": "orchestrator", "anchor": "orchestrator", "title": "12. The task can orchestrate agents", "level": 2 }, { "id": "surface-design", "anchor": "surface-design", "title": "13. A small, schema-first graph surface", "level": 2 }, { "id": "approvals", "anchor": "approvals", "title": "14. Routed permissions and actual coverage", "level": 2 }, { "id": "ledger", "anchor": "ledger", "title": "15. Measure accepted outcomes and human effort", "level": 2 }, { "id": "data", "anchor": "data", "title": "16. Local data with bounded retrieval", "level": 2 }, { "id": "shared", "anchor": "shared", "title": "17. What Codex and Claude share", "level": 2 }, { "id": "manna", "anchor": "manna", "title": "18. Manna's ownership boundary", "level": 2 }, { "id": "adoption", "anchor": "adoption", "title": "19. Mechanisms to adopt and qualify", "level": 2 }, { "id": "borrow", "anchor": "borrow", "title": "20. Source precision and durable execution", "level": 2 }, { "id": "a-derived-symbol-overlay", "anchor": "a-derived-symbol-overlay", "title": "A derived symbol overlay", "level": 3 }, { "id": "durability-in-the-task-owner", "anchor": "durability-in-the-task-owner", "title": "Durability in the task owner", "level": 3 }, { "id": "appbuilders", "anchor": "appbuilders", "title": "21. The greenfield and existing-app loops", "level": 2 }, { "id": "status", "anchor": "status", "title": "22. Implementation evidence and delivery order", "level": 2 }, { "id": "desktop-design-contract", "anchor": "desktop-design-contract", "title": "Desktop design contract", "level": 3 }, { "id": "thirdagent", "anchor": "thirdagent", "title": "23. A third agent: ChatGPT + Gemini", "level": 2 }, { "id": "ai-gateway", "anchor": "ai-gateway", "title": "24. Model traffic through Cloudflare AI Gateway", "level": 2 }, { "id": "related", "anchor": "related", "title": "Related", "level": 2 } ], "links": [ { "id": "reaktor-agent-workspace", "anchor": "thirdagent", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agent-workspace", "anchor": "change-budget", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agent-workspace", "anchor": "ai-gateway", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agent-workspace", "anchor": "status", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agent-workspace", "anchor": "status", "relation": "references", "sourceAnchor": "surface" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "hook" }, { "id": "reaktor-cloud", "anchor": "agents", "relation": "references", "sourceAnchor": "door" }, { "id": "reaktor-agent-workspace", "anchor": "ai-gateway", "relation": "references", "sourceAnchor": "door" }, { "id": "reaktor-agent-workspace", "anchor": "change-budget", "relation": "references", "sourceAnchor": "door" }, { "id": "reaktor-agent-workspace", "anchor": "thirdagent", "relation": "references", "sourceAnchor": "door" }, { "id": "reaktor-agent-workspace", "anchor": "taskclass", "relation": "references", "sourceAnchor": "change-budget" }, { "id": "reaktor-agent-workspace", "anchor": "findings", "relation": "references", "sourceAnchor": "change-budget" }, { "id": "reaktor-framework-overview", "anchor": "model", "relation": "references", "sourceAnchor": "change-budget" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "surface-design" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "surface-design" }, { "id": "reaktor-agent-workspace", "anchor": "ai-gateway", "relation": "references", "sourceAnchor": "ledger" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "data" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "data" }, { "id": "reaktor-agent-workspace", "anchor": "thirdagent", "relation": "references", "sourceAnchor": "status" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "status" }, { "id": "reaktor-agent-workspace", "anchor": "ai-gateway", "relation": "references", "sourceAnchor": "status" }, { "id": "reaktor-agent-workspace", "anchor": "change-budget", "relation": "references", "sourceAnchor": "status" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "status" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "thirdagent" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-agent-workspace", "anchor": "change-budget", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-agent-workspace", "anchor": "ledger", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-conductor", "anchor": "measurement", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-agent-workspace", "anchor": "ladder", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-agent-workspace", "anchor": "effort", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-conductor", "anchor": "second-call", "relation": "references", "sourceAnchor": "ai-gateway" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "related" } ] }, { "id": "reaktor-agentic-tooling", "owner": "Codex", "kind": "control-plane", "summary": "MCP, Koog, graph snapshots, typed tools, permission-gated mutations, and command queues.", "use": "Use when exposing Reaktor safely to humans and agents.", "region": "agents-inbound", "order": 0, "title": "The Reaktor Control Plane", "nav": "Control Plane", "group": "agents", "subsection": "agents-inbound", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-agentic-tooling", "revision": "3fd293b0e555e796fb3f0ef5ce58793d2b03b93ede85276cd5e94cf486fe0a1e", "status": "unverified", "renderingRevision": "c3a2435dba237c8f094ffb512948b2df732e94a940ac09c3ac9d53557bdb2f07", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling", "polarity": "Neutral" }, { "id": "section-context", "anchor": "context", "label": "Context — one control plane for humans and agents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#context", "polarity": "Neutral" }, { "id": "section-quality", "anchor": "quality", "label": "Why it raises code quality", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#quality", "polarity": "Neutral" }, { "id": "section-thesis", "anchor": "thesis", "label": "The thesis", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#thesis", "polarity": "Neutral" }, { "id": "section-primitives", "anchor": "primitives", "label": "Kernel primitives — the shared vocabulary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#primitives", "polarity": "Neutral" }, { "id": "section-surface", "anchor": "surface", "label": "The Surface — a thin reaktor-agent module", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#surface", "polarity": "Neutral" }, { "id": "section-observe", "anchor": "observe", "label": "Observe — the live graph as a knowledge graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#observe", "polarity": "Neutral" }, { "id": "section-phases", "anchor": "phases", "label": "Build phases (additive — nothing is deleted)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#phases", "polarity": "Neutral" }, { "id": "section-change", "anchor": "change", "label": "Change — the unified mutation spine", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#change", "polarity": "Neutral" }, { "id": "section-call", "anchor": "call", "label": "Call — capabilities as typed tools", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#call", "polarity": "Neutral" }, { "id": "section-permissions", "anchor": "permissions", "label": "Identity & permissions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#permissions", "polarity": "Neutral" }, { "id": "section-connection", "anchor": "connection", "label": "Connection models & trust profiles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#connection", "polarity": "Neutral" }, { "id": "section-two-transports", "anchor": "two-transports", "label": "Two transports", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#two-transports", "polarity": "Neutral" }, { "id": "section-observed", "anchor": "observed", "label": "Observed & budgeted — the surface watches itself", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#observed", "polarity": "Neutral" }, { "id": "section-two-trust-profiles-one-surface", "anchor": "two-trust-profiles-one-surface", "label": "Two trust profiles, one surface", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#two-trust-profiles-one-surface", "polarity": "Neutral" }, { "id": "section-p6--distributed-read-mostly", "anchor": "p6--distributed-read-mostly", "label": "P6 · Distributed (read-mostly)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#p6--distributed-read-mostly", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#related-docs", "polarity": "Neutral" }, { "id": "section-references", "anchor": "references", "label": "References", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-agentic-tooling#references", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-agentic-tooling:references-reaktor-agent-workspace-door", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-two-transports", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "section-door", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-workbench-layers", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-primitives", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-observe", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-graph-protocol-edit-domain", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-change", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-edit-domain", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-performance-observability", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-observed", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-two-trust-profiles-one-surface", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-koog-agents", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-two-trust-profiles-one-surface", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-p6--distributed-read-mostly", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-browser-local-ai", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-security-plan", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-gemini-devops-agent", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-gemini-devops-agent", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-agentic-tooling:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-agentic-tooling", "incidences": [ { "node": "reaktor-agentic-tooling", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-agentic-tooling.json", "sections": [ { "id": "preamble", "anchor": "", "title": "The Reaktor Control Plane", "level": 0 }, { "id": "context", "anchor": "context", "title": "Context — one control plane for humans and agents", "level": 2 }, { "id": "quality", "anchor": "quality", "title": "Why it raises code quality", "level": 2 }, { "id": "editing-code-today", "anchor": "editing-code-today", "title": "Editing code today", "level": 3 }, { "id": "editing-code-on-the-surface", "anchor": "editing-code-on-the-surface", "title": "Editing code on the surface", "level": 3 }, { "id": "thesis", "anchor": "thesis", "title": "The thesis", "level": 2 }, { "id": "three-things-any-operator-needs", "anchor": "three-things-any-operator-needs", "title": "Three things any operator needs", "level": 3 }, { "id": "operators--transports", "anchor": "operators--transports", "title": "Operators & transports", "level": 3 }, { "id": "primitives", "anchor": "primitives", "title": "Kernel primitives — the shared vocabulary", "level": 2 }, { "id": "surface", "anchor": "surface", "title": "The Surface — a thin reaktor-agent module", "level": 2 }, { "id": "observe", "anchor": "observe", "title": "Observe — the live graph as a knowledge graph", "level": 2 }, { "id": "call", "anchor": "call", "title": "Call — capabilities as typed tools", "level": 2 }, { "id": "change", "anchor": "change", "title": "Change — the unified mutation spine", "level": 2 }, { "id": "permissions", "anchor": "permissions", "title": "Identity & permissions", "level": 2 }, { "id": "observed", "anchor": "observed", "title": "Observed & budgeted — the surface watches itself", "level": 2 }, { "id": "connection", "anchor": "connection", "title": "Connection models & trust profiles", "level": 2 }, { "id": "two-transports", "anchor": "two-transports", "title": "Two transports", "level": 3 }, { "id": "two-trust-profiles-one-surface", "anchor": "two-trust-profiles-one-surface", "title": "Two trust profiles, one surface", "level": 3 }, { "id": "growing", "anchor": "growing", "title": "A toolbox that grows with Reaktor", "level": 2 }, { "id": "state", "anchor": "state", "title": "Expose-existing vs genuinely net-new", "level": 2 }, { "id": "expose-existing", "anchor": "expose-existing", "title": "Expose existing", "level": 3 }, { "id": "genuinely-net-new", "anchor": "genuinely-net-new", "title": "Genuinely net-new", "level": 3 }, { "id": "phases", "anchor": "phases", "title": "Build phases (additive — nothing is deleted)", "level": 2 }, { "id": "p0--read-only-knowledge-graph-over-mcp", "anchor": "p0--read-only-knowledge-graph-over-mcp", "title": "P0 · Read-only knowledge graph over MCP", "level": 3 }, { "id": "p1--ports-as-tools", "anchor": "p1--ports-as-tools", "title": "P1 · Ports as tools", "level": 3 }, { "id": "p2--the-mutation-spine", "anchor": "p2--the-mutation-spine", "title": "P2 · The mutation spine", "level": 3 }, { "id": "p3--subsystem-tool-families", "anchor": "p3--subsystem-tool-families", "title": "P3 · Subsystem tool families", "level": 3 }, { "id": "p4--in-process-koog", "anchor": "p4--in-process-koog", "title": "P4 · In-process Koog", "level": 3 }, { "id": "p5--identity-call-time-authz-live-state", "anchor": "p5--identity-call-time-authz-live-state", "title": "P5 · Identity, call-time authz, live state", "level": 3 }, { "id": "p6--distributed-read-mostly", "anchor": "p6--distributed-read-mostly", "title": "P6 · Distributed (read-mostly)", "level": 3 }, { "id": "safety", "anchor": "safety", "title": "Safety & verification", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 }, { "id": "references", "anchor": "references", "title": "References", "level": 2 } ], "links": [ { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "primitives" }, { "id": "reaktor-agentic-tooling", "anchor": "observe", "relation": "references", "sourceAnchor": "primitives" }, { "id": "reaktor-agentic-tooling", "anchor": "call", "relation": "references", "sourceAnchor": "primitives" }, { "id": "reaktor-agentic-tooling", "anchor": "change", "relation": "references", "sourceAnchor": "primitives" }, { "id": "reaktor-agentic-tooling", "anchor": "permissions", "relation": "references", "sourceAnchor": "primitives" }, { "id": "reaktor-agentic-tooling", "anchor": "permissions", "relation": "references", "sourceAnchor": "surface" }, { "id": "reaktor-agentic-tooling", "anchor": "connection", "relation": "references", "sourceAnchor": "surface" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "observe" }, { "id": "reaktor-graph-protocol", "anchor": "edit-domain", "relation": "references", "sourceAnchor": "change" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "observed" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "two-transports" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "two-trust-profiles-one-surface" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "two-trust-profiles-one-surface" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "p0--read-only-knowledge-graph-over-mcp" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "p6--distributed-read-mostly" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-gemini-devops-agent", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "references" } ] }, { "id": "reaktor-analytics-telemetry", "owner": "Codex", "kind": "ops", "summary": "Product event catalogs and OTel graph conventions, reconciled with existing ClickHouse/Crashlytics and proposed Shadow hot/archive evidence.", "use": "Use before adding app analytics events, telemetry spans, signal sinks, dashboards, privacy lint, or graph-linked Insights panels.", "region": "operations-observability", "order": 3, "title": "Reaktor Analytics and Telemetry", "nav": "Analytics + Telemetry", "group": "operations", "subsection": "operations-observability", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-analytics-telemetry", "revision": "6dac2ec801cdb341552005386289cd3b6bfd395b9d01de54f53b743e1053f335", "status": "unverified", "renderingRevision": "25e340804ac22c8ddbb8ecbf9c56b1ce7c58e8ed4827817cf1a8db0b16180bc2", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry", "polarity": "Neutral" }, { "id": "section-verdict", "anchor": "verdict", "label": "1. Architecture call", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#verdict", "polarity": "Neutral" }, { "id": "section-boundaries", "anchor": "boundaries", "label": "2. Analytics vs telemetry", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#boundaries", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "3. Current state", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#current", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "4. Unified signal model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#model", "polarity": "Neutral" }, { "id": "section-catalog", "anchor": "catalog", "label": "5. Event catalog and schema governance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#catalog", "polarity": "Neutral" }, { "id": "section-graph", "anchor": "graph", "label": "6. Graph attribution", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#graph", "polarity": "Neutral" }, { "id": "section-graph-native", "anchor": "graph-native", "label": "17. Graph-native telemetry", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#graph-native", "polarity": "Neutral" }, { "id": "section-otel-fixed", "anchor": "otel-fixed", "label": "17.2 Decision — OpenTelemetry is the internal model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#otel-fixed", "polarity": "Neutral" }, { "id": "section-firebase-retirement--7-october-2026", "anchor": "firebase-retirement--7-october-2026", "label": "Firebase service boundaries — 7 October 2026", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#firebase-retirement--7-october-2026", "polarity": "Neutral" }, { "id": "section-materialized-layers", "anchor": "materialized-layers", "label": "Materialized layers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#materialized-layers", "polarity": "Neutral" }, { "id": "section-convention", "anchor": "convention", "label": "17.3 The reaktor.* semantic convention", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#convention", "polarity": "Neutral" }, { "id": "section-port-shapes", "anchor": "port-shapes", "label": "17.4 Instrument the port call itself", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#port-shapes", "polarity": "Neutral" }, { "id": "section-two-paths", "anchor": "two-paths", "label": "17.9 Two telemetry paths", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#two-paths", "polarity": "Neutral" }, { "id": "section-capture", "anchor": "capture", "label": "17.10 Capture is a graph command", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#capture", "polarity": "Neutral" }, { "id": "section-prerequisites", "anchor": "prerequisites", "label": "17.13 Implemented substrate and remaining prerequisites", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#prerequisites", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-analytics-telemetry#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-analytics-telemetry:references-operations", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-current", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-operations-observability", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-current", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-shadow-capture-fabric", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-firebase-retirement--7-october-2026", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-operations-observability-the-paired-observation", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-model", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "section-the-paired-observation", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor-db", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-materialized-layers", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-operations-graph-evidence", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-otel-fixed", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor-graph-protocol-identity", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-convention", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-identity", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-shadow-capture-replay", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-port-shapes", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor-tooling-layer", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-two-paths", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor-tooling-layer-writes", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-capture", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "section-writes", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor-instrumentation-plan", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-prerequisites", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-performance-observability", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-auth-analysis", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-reaktor-server", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-analytics-telemetry:references-operations-crashlytics", "kind": "references", "owner": "reaktor-analytics-telemetry", "incidences": [ { "node": "reaktor-analytics-telemetry", "port": "section-firebase-retirement--7-october-2026", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "section-shadow-investigation", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-analytics-telemetry.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Analytics and Telemetry", "level": 0 }, { "id": "verdict", "anchor": "verdict", "title": "1. Architecture call", "level": 2 }, { "id": "boundaries", "anchor": "boundaries", "title": "2. Analytics vs telemetry", "level": 2 }, { "id": "current", "anchor": "current", "title": "3. Current state", "level": 2 }, { "id": "firebase-retirement--7-october-2026", "anchor": "firebase-retirement--7-october-2026", "title": "Firebase service boundaries — 7 October 2026", "level": 3 }, { "id": "model", "anchor": "model", "title": "4. Unified signal model", "level": 2 }, { "id": "catalog", "anchor": "catalog", "title": "5. Event catalog and schema governance", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "6. Graph attribution", "level": 2 }, { "id": "runtime", "anchor": "runtime", "title": "7. Reaktor runtime API", "level": 2 }, { "id": "runtime-2", "anchor": "runtime-2", "title": "Core interfaces", "level": 3 }, { "id": "runtime-3", "anchor": "runtime-3", "title": "Expected usage in an app", "level": 3 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "8. BestBuds app implementation", "level": 2 }, { "id": "bestbuds-2", "anchor": "bestbuds-2", "title": "BestBuds event families", "level": 3 }, { "id": "ingest", "anchor": "ingest", "title": "9. Ingestion path", "level": 2 }, { "id": "warehouse", "anchor": "warehouse", "title": "10. Storage, rollups, and recommendation data", "level": 2 }, { "id": "materialized-layers", "anchor": "materialized-layers", "title": "Materialized layers", "level": 3 }, { "id": "privacy", "anchor": "privacy", "title": "11. Privacy and safety model", "level": 2 }, { "id": "desktop", "anchor": "desktop", "title": "12. Reaktor Desktop and MCP", "level": 2 }, { "id": "desktop-2", "anchor": "desktop-2", "title": "Desktop panels", "level": 3 }, { "id": "desktop-3", "anchor": "desktop-3", "title": "MCP tool families", "level": 3 }, { "id": "quality", "anchor": "quality", "title": "13. Quality gates", "level": 2 }, { "id": "rollout", "anchor": "rollout", "title": "14. Phased plan", "level": 2 }, { "id": "promote-bestbudsevents-into-a-typed-catalog", "anchor": "promote-bestbudsevents-into-a-typed-catalog", "title": "Promote BestBudsEvents into a typed catalog", "level": 4 }, { "id": "make-invalid-analytics-impossible-to-merge", "anchor": "make-invalid-analytics-impossible-to-merge", "title": "Make invalid analytics impossible to merge", "level": 4 }, { "id": "standardize-otel-attributes-and-graph-links", "anchor": "standardize-otel-attributes-and-graph-links", "title": "Standardize OTel attributes and graph links", "level": 4 }, { "id": "harden-bestbuds-analytics-ingest", "anchor": "harden-bestbuds-analytics-ingest", "title": "Harden BestBuds analytics ingest", "level": 4 }, { "id": "make-signals-graph-visible-in-reaktor-desktop", "anchor": "make-signals-graph-visible-in-reaktor-desktop", "title": "Make signals graph-visible in Reaktor Desktop", "level": 4 }, { "id": "use-analytics-as-a-recommendation-substrate", "anchor": "use-analytics-as-a-recommendation-substrate", "title": "Use analytics as a recommendation substrate", "level": 4 }, { "id": "repo", "anchor": "repo", "title": "15. Repo implementation map", "level": 2 }, { "id": "final", "anchor": "final", "title": "16. Final shape", "level": 2 }, { "id": "graph-native", "anchor": "graph-native", "title": "17. Graph-native telemetry", "level": 2 }, { "id": "three-structures", "anchor": "three-structures", "title": "17.1 Telemetry is a derived layer over the graph", "level": 3 }, { "id": "otel-fixed", "anchor": "otel-fixed", "title": "17.2 Decision — OpenTelemetry is the internal model", "level": 3 }, { "id": "convention", "anchor": "convention", "title": "17.3 The reaktor.* semantic convention", "level": 3 }, { "id": "port-shapes", "anchor": "port-shapes", "title": "17.4 Instrument the port call itself", "level": 3 }, { "id": "facet", "anchor": "facet", "title": "17.5 TelemetryFacet declares policy, never data", "level": 3 }, { "id": "visitor", "anchor": "visitor", "title": "17.6 TelemetryVisitor compiles a TelemetryPlan", "level": 3 }, { "id": "execution-context", "anchor": "execution-context", "title": "17.7 ExecutionContext and causality across boundaries", "level": 3 }, { "id": "cardinality", "anchor": "cardinality", "title": "17.8 Cardinality is enforced, not advised", "level": 3 }, { "id": "two-paths", "anchor": "two-paths", "title": "17.9 Two telemetry paths", "level": 3 }, { "id": "capture", "anchor": "capture", "title": "17.10 Capture is a graph command", "level": 3 }, { "id": "privacy-2", "anchor": "privacy-2", "title": "17.11 Privacy is graph policy", "level": 3 }, { "id": "no-self-instrumentation", "anchor": "no-self-instrumentation", "title": "17.12 Telemetry must not instrument itself", "level": 3 }, { "id": "prerequisites", "anchor": "prerequisites", "title": "17.13 Implemented substrate and remaining prerequisites", "level": 3 }, { "id": "layout", "anchor": "layout", "title": "17.14 Module layout", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "current" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "current" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "current" }, { "id": "operations-crashlytics", "anchor": "release-builds-and-crash-reporting", "relation": "references", "sourceAnchor": "firebase-retirement--7-october-2026" }, { "id": "operations-crashlytics", "anchor": "shadow-investigation", "relation": "references", "sourceAnchor": "firebase-retirement--7-october-2026" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "firebase-retirement--7-october-2026" }, { "id": "operations-observability", "anchor": "the-paired-observation", "relation": "references", "sourceAnchor": "model" }, { "id": "reaktor-analytics-telemetry", "anchor": "otel-fixed", "relation": "references", "sourceAnchor": "runtime" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "ingest" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "materialized-layers" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "otel-fixed" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "otel-fixed" }, { "id": "reaktor-graph-protocol", "anchor": "identity", "relation": "references", "sourceAnchor": "convention" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "port-shapes" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "two-paths" }, { "id": "reaktor-tooling-layer", "anchor": "writes", "relation": "references", "sourceAnchor": "capture" }, { "id": "reaktor-instrumentation-plan", "anchor": "", "relation": "references", "sourceAnchor": "prerequisites" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-architecture-analysis", "owner": "Claude", "kind": "analysis", "summary": "Prototype screen gaps, differentiators, implementation priorities, and inspector coverage.", "use": "Use when prioritizing visible workbench functionality.", "region": "background-research", "order": 1, "title": "Workbench Feature Gap Analysis", "nav": "Workbench Gaps", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-architecture-analysis", "revision": "5370724d1f071caf3d403bfda478296d82247d5f97d4f7acaa0d47ebec00a41f", "status": "historical", "renderingRevision": "ffbfc9f209d268d8eb9c55685e4f4cfc822df54fefef63dc46b04382906ddcd3", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis", "polarity": "Neutral" }, { "id": "section-what-works", "anchor": "what-works", "label": "✓ What the Prototype Gets Right", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#what-works", "polarity": "Neutral" }, { "id": "section-critical-gaps", "anchor": "critical-gaps", "label": "! Critical Architectural Gaps", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#critical-gaps", "polarity": "Neutral" }, { "id": "section-screen-gaps", "anchor": "screen-gaps", "label": "■ Screen-Level Feature Gaps", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#screen-gaps", "polarity": "Neutral" }, { "id": "section-five-diffs", "anchor": "five-diffs", "label": "★ The Five Differentiators", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#five-diffs", "polarity": "Neutral" }, { "id": "section-priorities", "anchor": "priorities", "label": "▲ Prioritized Implementation Plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#priorities", "polarity": "Neutral" }, { "id": "section-node-type-coverage", "anchor": "node-type-coverage", "label": "● Node Type Coverage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#node-type-coverage", "polarity": "Neutral" }, { "id": "section-inspector-coverage", "anchor": "inspector-coverage", "label": "■ Inspector Coverage by Entity Type", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#inspector-coverage", "polarity": "Neutral" }, { "id": "section-overlay-coverage", "anchor": "overlay-coverage", "label": "◉ Graph Overlay / Mode Coverage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#overlay-coverage", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-architecture-analysis#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-architecture-analysis:references-reaktor-workbench-roadmap", "kind": "references", "owner": "reaktor-architecture-analysis", "incidences": [ { "node": "reaktor-architecture-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-architecture-analysis:references-engine-website-implementation-report", "kind": "references", "owner": "reaktor-architecture-analysis", "incidences": [ { "node": "reaktor-architecture-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "engine-website-implementation-report", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-architecture-analysis:references-reaktor-desktop-v3", "kind": "references", "owner": "reaktor-architecture-analysis", "incidences": [ { "node": "reaktor-architecture-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-v3", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-architecture-analysis:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-architecture-analysis", "incidences": [ { "node": "reaktor-architecture-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-architecture-analysis:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "reaktor-architecture-analysis", "incidences": [ { "node": "reaktor-architecture-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-architecture-analysis:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-architecture-analysis", "incidences": [ { "node": "reaktor-architecture-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-architecture-analysis.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Workbench Feature Gap Analysis", "level": 0 }, { "id": "contents", "anchor": "contents", "title": "Contents", "level": 4 }, { "id": "what-works", "anchor": "what-works", "title": "✓ What the Prototype Gets Right", "level": 2 }, { "id": "layout--information-architecture", "anchor": "layout--information-architecture", "title": "Layout & Information Architecture", "level": 4 }, { "id": "interactive-controls", "anchor": "interactive-controls", "title": "Interactive Controls", "level": 4 }, { "id": "data-model", "anchor": "data-model", "title": "Data Model", "level": 4 }, { "id": "visual-design", "anchor": "visual-design", "title": "Visual Design", "level": 4 }, { "id": "critical-gaps", "anchor": "critical-gaps", "title": "! Critical Architectural Gaps", "level": 2 }, { "id": "gap-1-graph-model-missing-core-node-types", "anchor": "gap-1-graph-model-missing-core-node-types", "title": "Gap 1: Graph Model Missing Core Node Types", "level": 4 }, { "id": "gap-2-port-system-is-absent", "anchor": "gap-2-port-system-is-absent", "title": "Gap 2: Port System is Absent", "level": 4 }, { "id": "gap-3-no-live-runtime-connection-model", "anchor": "gap-3-no-live-runtime-connection-model", "title": "Gap 3: No Live Runtime Connection Model", "level": 4 }, { "id": "gap-4-graphcommand-system-partially-represented", "anchor": "gap-4-graphcommand-system-partially-represented", "title": "Gap 4: GraphCommand System Partially Represented", "level": 4 }, { "id": "gap-5-agent-as-visitor-model-not-represented", "anchor": "gap-5-agent-as-visitor-model-not-represented", "title": "Gap 5: Agent-as-Visitor Model Not Represented", "level": 4 }, { "id": "screen-gaps", "anchor": "screen-gaps", "title": "■ Screen-Level Feature Gaps", "level": 2 }, { "id": "graph-screen", "anchor": "graph-screen", "title": "Graph Screen", "level": 3 }, { "id": "run-screen-wysiwyg", "anchor": "run-screen-wysiwyg", "title": "Run Screen (WYSIWYG)", "level": 3 }, { "id": "devtools--drilldown", "anchor": "devtools--drilldown", "title": "DevTools / Drilldown", "level": 3 }, { "id": "deploy-screen", "anchor": "deploy-screen", "title": "Deploy Screen", "level": 3 }, { "id": "insights-screen", "anchor": "insights-screen", "title": "Insights Screen", "level": 3 }, { "id": "five-diffs", "anchor": "five-diffs", "title": "★ The Five Differentiators", "level": 2 }, { "id": "priorities", "anchor": "priorities", "title": "▲ Prioritized Implementation Plan", "level": 2 }, { "id": "node-type-coverage", "anchor": "node-type-coverage", "title": "● Node Type Coverage", "level": 2 }, { "id": "inspector-coverage", "anchor": "inspector-coverage", "title": "■ Inspector Coverage by Entity Type", "level": 2 }, { "id": "overlay-coverage", "anchor": "overlay-coverage", "title": "◉ Graph Overlay / Mode Coverage", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-architecture-analysis", "anchor": "what-works", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-architecture-analysis", "anchor": "critical-gaps", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-architecture-analysis", "anchor": "screen-gaps", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-architecture-analysis", "anchor": "five-diffs", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-architecture-analysis", "anchor": "priorities", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-architecture-analysis", "anchor": "node-type-coverage", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-architecture-analysis", "anchor": "inspector-coverage", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-architecture-analysis", "anchor": "overlay-coverage", "relation": "references", "sourceAnchor": "contents" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "engine-website-implementation-report", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-desktop-v3", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-arena", "owner": "Codex", "kind": "design", "summary": "Unreal Engine simulation lab for validating Reaktor ideas through combat, AI, algorithms, traces, scenario replay, and future graph orchestration.", "use": "Use when designing the Unreal-based Arena lab, AI/algorithm playgrounds, scenario replay, debug inspectors, and the future Reaktor-to-Unreal bridge.", "region": "workbench-surfaces", "order": 8, "title": "Reaktor Arena", "nav": "Reaktor Arena", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-arena", "revision": "13dbc6ada02152eb4a18fcf47d53766ba37f3b99b290fb7cf651c66e75b8e96c", "status": "unverified", "renderingRevision": "5e986f1ef78cdc5ca176002ba6c9dab6b337f52cab5553aab775a2aab6b45158", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-arena", "polarity": "Neutral" }, { "id": "section-why", "anchor": "why", "label": "1. Why this exists", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#why", "polarity": "Neutral" }, { "id": "section-intent", "anchor": "intent", "label": "2. Product intent", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#intent", "polarity": "Neutral" }, { "id": "section-non-goals", "anchor": "non-goals", "label": "3. Non-goals for v1", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#non-goals", "polarity": "Neutral" }, { "id": "section-constraints", "anchor": "constraints", "label": "4. Design constraints", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#constraints", "polarity": "Neutral" }, { "id": "section-unreal-architecture", "anchor": "unreal-architecture", "label": "5. Unreal architecture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#unreal-architecture", "polarity": "Neutral" }, { "id": "section-agent-model", "anchor": "agent-model", "label": "6. Agent model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#agent-model", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "See also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#see-also", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-arena#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-arena:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-reaktor-browser-local-ai", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-performance-observability", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-reaktor-workbench-roadmap", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-reaktor-competitive-analysis", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-arena:references-reaktor-megascale-strategy", "kind": "references", "owner": "reaktor-arena", "incidences": [ { "node": "reaktor-arena", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-megascale-strategy", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-arena.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Arena", "level": 0 }, { "id": "why", "anchor": "why", "title": "1. Why this exists", "level": 2 }, { "id": "intent", "anchor": "intent", "title": "2. Product intent", "level": 2 }, { "id": "non-goals", "anchor": "non-goals", "title": "3. Non-goals for v1", "level": 2 }, { "id": "constraints", "anchor": "constraints", "title": "4. Design constraints", "level": 2 }, { "id": "unreal-architecture", "anchor": "unreal-architecture", "title": "5. Unreal architecture", "level": 2 }, { "id": "agent-model", "anchor": "agent-model", "title": "6. Agent model", "level": 2 }, { "id": "arena-world", "anchor": "arena-world", "title": "7. Arena world", "level": 2 }, { "id": "combat", "anchor": "combat", "title": "8. Combat runtime", "level": 2 }, { "id": "perception-memory", "anchor": "perception-memory", "title": "9. Perception and memory", "level": 2 }, { "id": "decision-backends", "anchor": "decision-backends", "title": "10. Decision backends", "level": 2 }, { "id": "utility-ai", "anchor": "utility-ai", "title": "10.1 Utility AI", "level": 3 }, { "id": "goap", "anchor": "goap", "title": "10.2 GOAP", "level": 3 }, { "id": "ml-policy", "anchor": "ml-policy", "title": "10.3 Machine-learning policy adapters", "level": 3 }, { "id": "algorithms", "anchor": "algorithms", "title": "11. Algorithm playground", "level": 2 }, { "id": "debug-studio", "anchor": "debug-studio", "title": "12. Debug studio", "level": 2 }, { "id": "agent-inspector", "anchor": "agent-inspector", "title": "Agent inspector", "level": 3 }, { "id": "event-timeline", "anchor": "event-timeline", "title": "Event timeline", "level": 3 }, { "id": "overlays", "anchor": "overlays", "title": "Overlays", "level": 3 }, { "id": "read-only-graph-view", "anchor": "read-only-graph-view", "title": "Read-only graph view", "level": 3 }, { "id": "scenario-harness", "anchor": "scenario-harness", "title": "13. Scenario harness", "level": 2 }, { "id": "metrics", "anchor": "metrics", "title": "14. Metrics and comparison", "level": 2 }, { "id": "bridge", "anchor": "bridge", "title": "15. Future Reaktor bridge", "level": 2 }, { "id": "bridge-protocol-sketch", "anchor": "bridge-protocol-sketch", "title": "Bridge protocol sketch", "level": 3 }, { "id": "lessons", "anchor": "lessons", "title": "16. Reaktor lessons table", "level": 2 }, { "id": "roadmap", "anchor": "roadmap", "title": "17. Roadmap", "level": 2 }, { "id": "v01---combat-sandbox", "anchor": "v01---combat-sandbox", "title": "v0.1 - Combat sandbox", "level": 3 }, { "id": "v02---ability-and-effect-runtime", "anchor": "v02---ability-and-effect-runtime", "title": "v0.2 - Ability and effect runtime", "level": 3 }, { "id": "v03---perception-and-behavior-tree", "anchor": "v03---perception-and-behavior-tree", "title": "v0.3 - Perception and Behavior Tree", "level": 3 }, { "id": "v04---utility-ai", "anchor": "v04---utility-ai", "title": "v0.4 - Utility AI", "level": 3 }, { "id": "v05---goap-planner", "anchor": "v05---goap-planner", "title": "v0.5 - GOAP planner", "level": 3 }, { "id": "v06---debug-studio", "anchor": "v06---debug-studio", "title": "v0.6 - Debug studio", "level": 3 }, { "id": "v07---read-only-graph-visualization", "anchor": "v07---read-only-graph-visualization", "title": "v0.7 - Read-only graph visualization", "level": 3 }, { "id": "v08---bridge-prototype", "anchor": "v08---bridge-prototype", "title": "v0.8 - Bridge prototype", "level": 3 }, { "id": "v09---ml-policy-lab", "anchor": "v09---ml-policy-lab", "title": "v0.9 - ML policy lab", "level": 3 }, { "id": "definition-of-done", "anchor": "definition-of-done", "title": "18. Definition of done", "level": 2 }, { "id": "risks", "anchor": "risks", "title": "19. Risks", "level": 2 }, { "id": "see-also", "anchor": "see-also", "title": "See also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra", "owner": "Astra / Codex", "kind": "design", "summary": "The 122-board software engine atlas: 61 current workspace handoffs, including 18 Living Graph workspaces, whole-system graphs, composable modules, persistent editors, Conductor harnesses, cloud placement, devices, delivery, telemetry, analytics and retained specialist references.", "use": "Read first and use as the implementation, design, and agent handoff contract for every change to reaktor.pen or the Reaktor workbench.", "region": "workbench-surfaces", "order": 1, "title": "Reaktor Product Atlas — Living Graph Super-IDE", "nav": "Living Graph Super-IDE", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra", "revision": "47063e5cb786bd2924758194e7da26cdf08f32f61e7593d9dcae4ef07fc0a9b9", "status": "unverified", "renderingRevision": "984ffcfe55229cd313e71d9bea3c8888c1456b1a19b1d90cc30d9ad3c3f75de4", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "board-ZCxzu", "board-DBc14", "board-pxsmW", "board-Pu9Sf", "board-W9V37c", "board-Wgw9w", "board-FsQx4", "board-LODux", "board-ufhps", "board-nXDMm", "board-C2Cd7K", "board-IRQ5A", "board-aPU6J", "board-yPKZB", "navigation-decisions-this-revision-makes", "progressive-depth-and-persistent-context", "current-native-implementation", "board-Gbwnj", "board-gVWV6", "board-Ruuut", "board-Mmo0o", "board-Hzi6v", "board-L9r7am", "board-DOTHj", "board-gddyF", "board-fFimd", "board-QPAyL", "board-yawya", "board-Wx6KI", "board-iq3nC", "board-Ri7Es", "board-Pr3Pv", "board-hqJ9u", "board-p4vwb", "board-Hr7rV", "board-w4EWt", "board-LXase", "board-GaN4a", "board-O0ZFq9", "board-Yb00x", "board-izozd", "board-A0KF5", "board-ObFUi", "board-KM61m", "board-GqUVw", "board-Nm5QX", "board-OYUup", "board-A0a5je", "board-sW0d1", "board-j8If5", "board-P29oV8", "board-oKbaW", "board-oxhTK", "board-ZqZ5F", "board-j7OsB", "board-aFYsq", "board-Ipum2", "board-j0RpiZ", "board-VsGDs", "board-X45qZ", "board-ag6vT", "board-r7L5v", "board-KWocx", "board-Xd3s4", "board-of8K7", "board-HfRjK", "board-Mw1gH", "board-D0yQo", "board-blRVd", "board-ysUFy", "board-qoZHY", "board-l4tkKY", "board-okDnx", "board-n7tbP", "board-pj1eK", "board-a1cWFd", "board-L8el1", "board-OhclB", "board-AgsbM", "board-LzukO", "board-GiULy", "board-U4IpH", "board-kvPHW", "board-wXLgg", "board-gt7MZ", "board-xqQrc", "board-V2GduQ", "board-VLrsK", "board-v0bjJ", "board-YdwCE", "board-T51iyD", "board-jmEA1", "board-z6gUa2", "board-lN1J9", "board-ZlHaI", "board-cvqmo", "board-DeFQh", "board-i1enWz", "board-ITreE", "board-D3PIAz", "board-zJrBc", "board-Wjmfj", "board-qtbd3", "board-W3npMV", "board-ZV3fR", "board-QMram", "board-ED2r5", "board-p0Fgf", "board-LI1ng", "board-CU5sk", "board-mmz92", "board-o1sWu8", "board-uVvPE", "board-z2yKVY", "board-fSDjL", "board-jvUo9", "board-Z2axVY", "board-wTkHR", "board-d1l54", "board-O36J3u", "board-H20qZ", "board-TtM5J", "board-uicyy", "board-e2iRw", "board-FzAEr" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra", "polarity": "Neutral" }, { "id": "section-the-system-map-one-viewport-four-scales", "anchor": "the-system-map-one-viewport-four-scales", "label": "The system map: one viewport, four scales", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#the-system-map-one-viewport-four-scales", "polarity": "Neutral" }, { "id": "section-the-developer-workbench", "anchor": "the-developer-workbench", "label": "The developer workbench", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#the-developer-workbench", "polarity": "Neutral" }, { "id": "section-atlas-orientation", "anchor": "atlas-orientation", "label": "Atlas orientation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#atlas-orientation", "polarity": "Neutral" }, { "id": "section-interaction-guide", "anchor": "interaction-guide", "label": "Interaction guide", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#interaction-guide", "polarity": "Neutral" }, { "id": "section-use-the-living-graph-as-a-development-instrument", "anchor": "use-the-living-graph-as-a-development-instrument", "label": "Use the Living Graph as a development instrument", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#use-the-living-graph-as-a-development-instrument", "polarity": "Neutral" }, { "id": "section-persistent-editor-shell", "anchor": "persistent-editor-shell", "label": "Persistent editor shell", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#persistent-editor-shell", "polarity": "Neutral" }, { "id": "section-current-native-implementation", "anchor": "current-native-implementation", "label": "current-native-implementation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#current-native-implementation", "polarity": "Neutral" }, { "id": "section-board-FsQx4", "anchor": "board-FsQx4", "label": "board-FsQx4", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-FsQx4", "polarity": "Neutral" }, { "id": "section-board-LODux", "anchor": "board-LODux", "label": "board-LODux", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-LODux", "polarity": "Neutral" }, { "id": "section-board-ZCxzu", "anchor": "board-ZCxzu", "label": "board-ZCxzu", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-ZCxzu", "polarity": "Neutral" }, { "id": "section-board-ufhps", "anchor": "board-ufhps", "label": "board-ufhps", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-ufhps", "polarity": "Neutral" }, { "id": "section-board-nXDMm", "anchor": "board-nXDMm", "label": "board-nXDMm", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-nXDMm", "polarity": "Neutral" }, { "id": "section-board-C2Cd7K", "anchor": "board-C2Cd7K", "label": "board-C2Cd7K", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-C2Cd7K", "polarity": "Neutral" }, { "id": "section-board-IRQ5A", "anchor": "board-IRQ5A", "label": "board-IRQ5A", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-IRQ5A", "polarity": "Neutral" }, { "id": "section-zoom-through-one-whole-system-map", "anchor": "zoom-through-one-whole-system-map", "label": "Zoom through one whole-system map", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#zoom-through-one-whole-system-map", "polarity": "Neutral" }, { "id": "section-board-aPU6J", "anchor": "board-aPU6J", "label": "board-aPU6J", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-aPU6J", "polarity": "Neutral" }, { "id": "section-board-gVWV6", "anchor": "board-gVWV6", "label": "board-gVWV6", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-gVWV6", "polarity": "Neutral" }, { "id": "section-one-connected-value-chain", "anchor": "one-connected-value-chain", "label": "One connected value chain", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#one-connected-value-chain", "polarity": "Neutral" }, { "id": "section-board-w4EWt", "anchor": "board-w4EWt", "label": "board-w4EWt", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-w4EWt", "polarity": "Neutral" }, { "id": "section-board-Mmo0o", "anchor": "board-Mmo0o", "label": "board-Mmo0o", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-Mmo0o", "polarity": "Neutral" }, { "id": "section-board-Wx6KI", "anchor": "board-Wx6KI", "label": "board-Wx6KI", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-Wx6KI", "polarity": "Neutral" }, { "id": "section-rebuilt-workspaces", "anchor": "rebuilt-workspaces", "label": "Rebuilt workspaces", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#rebuilt-workspaces", "polarity": "Neutral" }, { "id": "section-retained-specialist-references", "anchor": "retained-specialist-references", "label": "Retained specialist references", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#retained-specialist-references", "polarity": "Neutral" }, { "id": "section-board-Wgw9w", "anchor": "board-Wgw9w", "label": "board-Wgw9w", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-Wgw9w", "polarity": "Neutral" }, { "id": "section-board-DBc14", "anchor": "board-DBc14", "label": "board-DBc14", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-DBc14", "polarity": "Neutral" }, { "id": "section-board-pxsmW", "anchor": "board-pxsmW", "label": "board-pxsmW", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-pxsmW", "polarity": "Neutral" }, { "id": "section-board-Pu9Sf", "anchor": "board-Pu9Sf", "label": "board-Pu9Sf", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-Pu9Sf", "polarity": "Neutral" }, { "id": "section-board-W9V37c", "anchor": "board-W9V37c", "label": "board-W9V37c", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-W9V37c", "polarity": "Neutral" }, { "id": "section-board-yawya", "anchor": "board-yawya", "label": "board-yawya", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-yawya", "polarity": "Neutral" }, { "id": "section-board-j8If5", "anchor": "board-j8If5", "label": "board-j8If5", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-j8If5", "polarity": "Neutral" }, { "id": "section-board-LzukO", "anchor": "board-LzukO", "label": "board-LzukO", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-LzukO", "polarity": "Neutral" }, { "id": "section-board-hqJ9u", "anchor": "board-hqJ9u", "label": "board-hqJ9u", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#board-hqJ9u", "polarity": "Neutral" }, { "id": "section-one-living-system", "anchor": "one-living-system", "label": "One living system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#one-living-system", "polarity": "Neutral" }, { "id": "section-current-native-implementation--8-september-2026", "anchor": "current-native-implementation--8-september-2026", "label": "Current native implementation — 8 September 2026", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#current-native-implementation--8-september-2026", "polarity": "Neutral" }, { "id": "section-system-map--estate", "anchor": "system-map--estate", "label": "System map · estate", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#system-map--estate", "polarity": "Neutral" }, { "id": "section-system-map--realtime-session-versus-durable-delivery", "anchor": "system-map--realtime-session-versus-durable-delivery", "label": "System map · realtime session versus durable delivery", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#system-map--realtime-session-versus-durable-delivery", "polarity": "Neutral" }, { "id": "section-map-viewport-instruments", "anchor": "map-viewport-instruments", "label": "Map viewport instruments", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#map-viewport-instruments", "polarity": "Neutral" }, { "id": "section-bestbuds--follow-a-selection-across-tools", "anchor": "bestbuds--follow-a-selection-across-tools", "label": "BestBuds — follow a selection across tools", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#bestbuds--follow-a-selection-across-tools", "polarity": "Neutral" }, { "id": "section-orchestrate-from-any-event-or-intent", "anchor": "orchestrate-from-any-event-or-intent", "label": "Orchestrate from any event or intent", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#orchestrate-from-any-event-or-intent", "polarity": "Neutral" }, { "id": "section-operate-on-the-selected-end-to-end-flow", "anchor": "operate-on-the-selected-end-to-end-flow", "label": "Operate on the selected end-to-end flow", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#operate-on-the-selected-end-to-end-flow", "polarity": "Neutral" }, { "id": "section-modules-contribute-working-mechanisms-and-their-instruments", "anchor": "modules-contribute-working-mechanisms-and-their-instruments", "label": "Modules contribute working mechanisms and their instruments", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#modules-contribute-working-mechanisms-and-their-instruments", "polarity": "Neutral" }, { "id": "section-make-the-opinionated-cloud-visible", "anchor": "make-the-opinionated-cloud-visible", "label": "Make the opinionated cloud visible", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#make-the-opinionated-cloud-visible", "polarity": "Neutral" }, { "id": "section-complete-one-feature-across-the-system", "anchor": "complete-one-feature-across-the-system", "label": "Complete one feature across the system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#complete-one-feature-across-the-system", "polarity": "Neutral" }, { "id": "section-creating-and-extending-a-normal-project", "anchor": "creating-and-extending-a-normal-project", "label": "Creating and extending a normal project", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#creating-and-extending-a-normal-project", "polarity": "Neutral" }, { "id": "section-coediting-source-composition-and-product", "anchor": "coediting-source-composition-and-product", "label": "Coediting source, composition and product", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#coediting-source-composition-and-product", "polarity": "Neutral" }, { "id": "section-one-action-path-appropriate-to-the-action", "anchor": "one-action-path-appropriate-to-the-action", "label": "One action path, appropriate to the action", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#one-action-path-appropriate-to-the-action", "polarity": "Neutral" }, { "id": "section-conductor-alongside-the-editors", "anchor": "conductor-alongside-the-editors", "label": "Conductor alongside the editors", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#conductor-alongside-the-editors", "polarity": "Neutral" }, { "id": "section-specialist-workspaces-earn-their-space", "anchor": "specialist-workspaces-earn-their-space", "label": "Specialist workspaces earn their space", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#specialist-workspaces-earn-their-space", "polarity": "Neutral" }, { "id": "section-0406--graph--editing-connections", "anchor": "0406--graph--editing-connections", "label": "04.06 · Graph · Editing Connections", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-revamp-5.6-ultra#0406--graph--editing-connections", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-one-living-system", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-substrate-redesign-ecosystem-integration", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "section-ecosystem-integration", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-ui-ux-audit-2026-09-08", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-current-native-implementation--8-september-2026", "role": "source", "ordinal": 0 }, { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-ui-ux-audit-2026-09-08-distance-from-the-full-design-and-vision", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-distance-from-the-full-design-and-vision", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-hierarchical-ui-fixture-ledger", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-the-system-map-one-viewport-four-scales", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-fixture-ledger", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-hierarchical-ui-decision-table", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-the-system-map-one-viewport-four-scales", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-decision-table", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-hierarchical-ui-acceptance-tests", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-system-map--estate", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-acceptance-tests", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-mesh", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-system-map--realtime-session-versus-durable-delivery", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-system-map--realtime-session-versus-durable-delivery", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-visual-language-road-grammar", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-map-viewport-instruments", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "section-road-grammar", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-hierarchical-ui-real-app-topology", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-bestbuds--follow-a-selection-across-tools", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-real-app-topology", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-unified-system-graph-flow-entrypoints", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-orchestrate-from-any-event-or-intent", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-flow-entrypoints", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-interaction-guide", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-desktop-master-plan", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-interaction-guide", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-interaction-guide", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-essays", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-interaction-guide", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-hierarchical-ui-continuous-zoom", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-operate-on-the-selected-end-to-end-flow", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-continuous-zoom", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-unified-system-graph-ui-to-system", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-operate-on-the-selected-end-to-end-flow", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-ui-to-system", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-unified-system-graph-route-orchestration", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-operate-on-the-selected-end-to-end-flow", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-route-orchestration", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-operate-on-the-selected-end-to-end-flow", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-operate-on-the-selected-end-to-end-flow", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-astra-reaktor-plan-and-roadmap-8-a-generating-basis-modules-features-and-capabilities", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-modules-contribute-working-mechanisms-and-their-instruments", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-8-a-generating-basis-modules-features-and-capabilities", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-astra-reaktor-plan-and-roadmap-12-flows-choreography-and-the-opinionated-datacloud-stack", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-make-the-opinionated-cloud-visible", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-12-flows-choreography-and-the-opinionated-datacloud-stack", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-astra-reaktor-plan-and-roadmap-16-current-system-map-and-intended-progression", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-complete-one-feature-across-the-system", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-16-current-system-map-and-intended-progression", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-astra-reaktor-plan-and-roadmap-3-greenfield-creation-is-a-first-class-product", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-creating-and-extending-a-normal-project", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-3-greenfield-creation-is-a-first-class-product", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-astra-reaktor-plan-and-roadmap-6-the-core-a-live-model-with-a-small-semantic-kernel", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-coediting-source-composition-and-product", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-6-the-core-a-live-model-with-a-small-semantic-kernel", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-one-action-path-appropriate-to-the-action", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-conductor", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-conductor-alongside-the-editors", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-conductor-gaps", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-conductor-alongside-the-editors", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "section-gaps", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-capability", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-specialist-workspaces-earn-their-space", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-ffi", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-specialist-workspaces-earn-their-space", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-formal-methods", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-specialist-workspaces-earn-their-space", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-atlas-review-fable-5", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-retained-specialist-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-review-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-revamp-5.6-ultra:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "reaktor-atlas-revamp-5.6-ultra", "incidences": [ { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-0406--graph--editing-connections", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-atlas-revamp-5.6-ultra.json", "sections": [ { "id": "reaktor-product-atlas--living-graph-super-ide", "anchor": "reaktor-product-atlas--living-graph-super-ide", "title": "Reaktor Product Atlas — Living Graph Super-IDE", "level": 1 }, { "id": "the-system-map-one-viewport-four-scales", "anchor": "the-system-map-one-viewport-four-scales", "title": "The system map: one viewport, four scales", "level": 2 }, { "id": "system-map--estate", "anchor": "system-map--estate", "title": "System map · estate", "level": 3 }, { "id": "system-map--runtime-district", "anchor": "system-map--runtime-district", "title": "System map · runtime district", "level": 3 }, { "id": "system-map--feature-and-its-boundary", "anchor": "system-map--feature-and-its-boundary", "title": "System map · feature and its boundary", "level": 3 }, { "id": "system-map--exact-port-and-selected-execution", "anchor": "system-map--exact-port-and-selected-execution", "title": "System map · exact port and selected execution", "level": 3 }, { "id": "system-map--realtime-session-versus-durable-delivery", "anchor": "system-map--realtime-session-versus-durable-delivery", "title": "System map · realtime session versus durable delivery", "level": 3 }, { "id": "map-viewport-instruments", "anchor": "map-viewport-instruments", "title": "Map viewport instruments", "level": 3 }, { "id": "the-developer-workbench", "anchor": "the-developer-workbench", "title": "The developer workbench", "level": 2 }, { "id": "bestbuds--whole-application-topology", "anchor": "bestbuds--whole-application-topology", "title": "BestBuds — whole-application topology", "level": 3 }, { "id": "bestbuds--follow-a-selection-across-tools", "anchor": "bestbuds--follow-a-selection-across-tools", "title": "BestBuds — follow a selection across tools", "level": 3 }, { "id": "from-ui-element-to-the-whole-system", "anchor": "from-ui-element-to-the-whole-system", "title": "From UI element to the whole system", "level": 3 }, { "id": "route-and-orchestrate-an-end-to-end-flow", "anchor": "route-and-orchestrate-an-end-to-end-flow", "title": "Route and orchestrate an end-to-end flow", "level": 3 }, { "id": "orchestrate-from-any-event-or-intent", "anchor": "orchestrate-from-any-event-or-intent", "title": "Orchestrate from any event or intent", "level": 3 }, { "id": "one-living-system", "anchor": "one-living-system", "title": "One living system", "level": 3 }, { "id": "author-through-ports-and-kotlin", "anchor": "author-through-ports-and-kotlin", "title": "Author through ports and Kotlin", "level": 3 }, { "id": "atlas-orientation", "anchor": "atlas-orientation", "title": "Atlas orientation", "level": 2 }, { "id": "start-here-the-reaktor-product-atlas", "anchor": "start-here-the-reaktor-product-atlas", "title": "Start here: the Reaktor product atlas", "level": 3 }, { "id": "interaction-guide", "anchor": "interaction-guide", "title": "Interaction guide", "level": 2 }, { "id": "use-the-living-graph-as-a-development-instrument", "anchor": "use-the-living-graph-as-a-development-instrument", "title": "Use the Living Graph as a development instrument", "level": 2 }, { "id": "zoom-through-one-whole-system-map", "anchor": "zoom-through-one-whole-system-map", "title": "Zoom through one whole-system map", "level": 3 }, { "id": "inspect-the-product-follow-its-behavior", "anchor": "inspect-the-product-follow-its-behavior", "title": "Inspect the product, follow its behavior", "level": 3 }, { "id": "operate-on-the-selected-end-to-end-flow", "anchor": "operate-on-the-selected-end-to-end-flow", "title": "Operate on the selected end-to-end flow", "level": 3 }, { "id": "persistent-editor-shell", "anchor": "persistent-editor-shell", "title": "Persistent editor shell", "level": 2 }, { "id": "one-engine-for-the-complete-application", "anchor": "one-engine-for-the-complete-application", "title": "One engine for the complete application", "level": 2 }, { "id": "modules-contribute-working-mechanisms-and-their-instruments", "anchor": "modules-contribute-working-mechanisms-and-their-instruments", "title": "Modules contribute working mechanisms and their instruments", "level": 3 }, { "id": "make-the-opinionated-cloud-visible", "anchor": "make-the-opinionated-cloud-visible", "title": "Make the opinionated cloud visible", "level": 3 }, { "id": "apply-useful-passes-to-the-selected-system", "anchor": "apply-useful-passes-to-the-selected-system", "title": "Apply useful passes to the selected system", "level": 3 }, { "id": "complete-one-feature-across-the-system", "anchor": "complete-one-feature-across-the-system", "title": "Complete one feature across the system", "level": 3 }, { "id": "one-connected-value-chain", "anchor": "one-connected-value-chain", "title": "One connected value chain", "level": 2 }, { "id": "provider-specific-tools-preserve-their-depth", "anchor": "provider-specific-tools-preserve-their-depth", "title": "Provider-specific tools preserve their depth", "level": 3 }, { "id": "connect-devices-releases-outcomes-and-cost-to-the-change", "anchor": "connect-devices-releases-outcomes-and-cost-to-the-change", "title": "Connect devices, releases, outcomes and cost to the change", "level": 3 }, { "id": "combine-ai-approaches-around-the-work", "anchor": "combine-ai-approaches-around-the-work", "title": "Combine AI approaches around the work", "level": 3 }, { "id": "creating-and-extending-a-normal-project", "anchor": "creating-and-extending-a-normal-project", "title": "Creating and extending a normal project", "level": 2 }, { "id": "editor-groups-perspectives-and-pinned-context", "anchor": "editor-groups-perspectives-and-pinned-context", "title": "Editor groups, perspectives and pinned context", "level": 2 }, { "id": "coediting-source-composition-and-product", "anchor": "coediting-source-composition-and-product", "title": "Coediting source, composition and product", "level": 2 }, { "id": "one-action-path-appropriate-to-the-action", "anchor": "one-action-path-appropriate-to-the-action", "title": "One action path, appropriate to the action", "level": 2 }, { "id": "debug-the-running-system", "anchor": "debug-the-running-system", "title": "Debug the running system", "level": 2 }, { "id": "conductor-alongside-the-editors", "anchor": "conductor-alongside-the-editors", "title": "Conductor alongside the editors", "level": 2 }, { "id": "specialist-workspaces-earn-their-space", "anchor": "specialist-workspaces-earn-their-space", "title": "Specialist workspaces earn their space", "level": 2 }, { "id": "program-the-workspace-itself", "anchor": "program-the-workspace-itself", "title": "Program the workspace itself", "level": 2 }, { "id": "truth-and-failure-are-part-of-the-interaction", "anchor": "truth-and-failure-are-part-of-the-interaction", "title": "Truth and failure are part of the interaction", "level": 2 }, { "id": "power-must-remain-readable-and-accessible", "anchor": "power-must-remain-readable-and-accessible", "title": "Power must remain readable and accessible", "level": 2 }, { "id": "december-delivery-and-the-north-star-design", "anchor": "december-delivery-and-the-north-star-design", "title": "December delivery and the north-star design", "level": 2 }, { "id": "implementation-baseline-behind-the-designs", "anchor": "implementation-baseline-behind-the-designs", "title": "Implementation baseline behind the designs", "level": 2 }, { "id": "current-native-implementation--8-september-2026", "anchor": "current-native-implementation--8-september-2026", "title": "Current native implementation — 8 September 2026", "level": 3 }, { "id": "source-consistency-audit--7-september-2026", "anchor": "source-consistency-audit--7-september-2026", "title": "Source consistency audit — 7 September 2026", "level": 3 }, { "id": "earlier-application-inspection--7-september-2026", "anchor": "earlier-application-inspection--7-september-2026", "title": "Earlier application inspection — 7 September 2026", "level": 3 }, { "id": "workflow-acceptance", "anchor": "workflow-acceptance", "title": "Workflow acceptance", "level": 2 }, { "id": "implementation-and-design-handoff", "anchor": "implementation-and-design-handoff", "title": "Implementation and design handoff", "level": 2 }, { "id": "design-registry-and-validation", "anchor": "design-registry-and-validation", "title": "Design registry and validation", "level": 2 }, { "id": "rebuilt-workspaces", "anchor": "rebuilt-workspaces", "title": "Rebuilt workspaces", "level": 2 }, { "id": "missions-tools-and-editors", "anchor": "missions-tools-and-editors", "title": "Missions tools and editors", "level": 2 }, { "id": "what-will-you-build-today", "anchor": "what-will-you-build-today", "title": "What will you build today?", "level": 3 }, { "id": "fieldwork-is-taking-shape", "anchor": "fieldwork-is-taking-shape", "title": "Fieldwork is taking shape", "level": 3 }, { "id": "design-the-interaction-preserve-the-behavior", "anchor": "design-the-interaction-preserve-the-behavior", "title": "Design the interaction, preserve the behavior", "level": 3 }, { "id": "make-offline-capture-dependable", "anchor": "make-offline-capture-dependable", "title": "Make offline capture dependable", "level": 3 }, { "id": "your-team-your-way-of-working", "anchor": "your-team-your-way-of-working", "title": "Your team, your way of working", "level": 3 }, { "id": "compose-how-agents-collaborate", "anchor": "compose-how-agents-collaborate", "title": "Compose how agents collaborate", "level": 3 }, { "id": "what-will-this-agent-know", "anchor": "what-will-this-agent-know", "title": "What will this agent know?", "level": 3 }, { "id": "bring-an-existing-system-into-focus", "anchor": "bring-an-existing-system-into-focus", "title": "Bring an existing system into focus", "level": 3 }, { "id": "graph-editors-and-instruments", "anchor": "graph-editors-and-instruments", "title": "Graph editors and instruments", "level": 2 }, { "id": "compose-from-a-small-powerful-basis", "anchor": "compose-from-a-small-powerful-basis", "title": "Compose from a small, powerful basis", "level": 3 }, { "id": "one-graph-across-runtime-islands", "anchor": "one-graph-across-runtime-islands", "title": "One graph across runtime islands", "level": 3 }, { "id": "query-data-with-its-system-context", "anchor": "query-data-with-its-system-context", "title": "Query data with its system context", "level": 3 }, { "id": "program-the-living-graph", "anchor": "program-the-living-graph", "title": "Program the Living Graph", "level": 3 }, { "id": "inspect-every-boundary-in-a-pipeline", "anchor": "inspect-every-boundary-in-a-pipeline", "title": "Inspect every boundary in a pipeline", "level": 3 }, { "id": "choose-behavior-for-each-target", "anchor": "choose-behavior-for-each-target", "title": "Choose behavior for each target", "level": 3 }, { "id": "0405--reaktor-graph--compose-across-every-boundary", "anchor": "0405--reaktor-graph--compose-across-every-boundary", "title": "04.05 · Reaktor Graph · Compose across every boundary", "level": 3 }, { "id": "changes-and-diff-editors", "anchor": "changes-and-diff-editors", "title": "Changes and diff editors", "level": 2 }, { "id": "commit-and-semantic-patch-review", "anchor": "commit-and-semantic-patch-review", "title": "Commit and semantic patch review", "level": 3 }, { "id": "evolve-a-marked-runtime-boundary", "anchor": "evolve-a-marked-runtime-boundary", "title": "Evolve a marked runtime boundary", "level": 3 }, { "id": "run-and-debugging-tools", "anchor": "run-and-debugging-tools", "title": "Run and debugging tools", "level": 2 }, { "id": "publish-the-exact-system-you-reviewed", "anchor": "publish-the-exact-system-you-reviewed", "title": "Publish the exact system you reviewed", "level": 3 }, { "id": "a-visit-one-owned-turn-at-a-time", "anchor": "a-visit-one-owned-turn-at-a-time", "title": "A visit, one owned turn at a time", "level": 3 }, { "id": "an-attempt-stopped-what-actually-happened", "anchor": "an-attempt-stopped-what-actually-happened", "title": "An attempt stopped. What actually happened?", "level": 3 }, { "id": "0701--reaktor-ide--device-lab", "anchor": "0701--reaktor-ide--device-lab", "title": "07.01 · Reaktor IDE · Device Lab", "level": 3 }, { "id": "0702--reaktor-ide--pipeline", "anchor": "0702--reaktor-ide--pipeline", "title": "07.02 · Reaktor IDE · Pipeline", "level": 3 }, { "id": "0703--reaktor-ide--releases", "anchor": "0703--reaktor-ide--releases", "title": "07.03 · Reaktor IDE · Releases", "level": 3 }, { "id": "0604--reaktor-graph--runtime-and-causal-trace", "anchor": "0604--reaktor-graph--runtime-and-causal-trace", "title": "06.04 · Reaktor Graph · Runtime and causal trace", "level": 3 }, { "id": "evidence-editors-and-instruments", "anchor": "evidence-editors-and-instruments", "title": "Evidence editors and instruments", "level": 2 }, { "id": "counterexample-to-reviewed-repair", "anchor": "counterexample-to-reviewed-repair", "title": "Counterexample to reviewed repair", "level": 3 }, { "id": "optimize-the-selected-behavior", "anchor": "optimize-the-selected-behavior", "title": "Optimize the selected behavior", "level": 3 }, { "id": "find-the-reason-not-just-the-answer", "anchor": "find-the-reason-not-just-the-answer", "title": "Find the reason, not just the answer", "level": 3 }, { "id": "capture--telemetry-and-profile", "anchor": "capture--telemetry-and-profile", "title": "Capture · telemetry and profile", "level": 3 }, { "id": "capture--outcomes-and-regressions", "anchor": "capture--outcomes-and-regressions", "title": "Capture · outcomes and regressions", "level": 3 }, { "id": "capture--cost-attribution", "anchor": "capture--cost-attribution", "title": "Capture · cost attribution", "level": 3 }, { "id": "system-configuration-and-tools", "anchor": "system-configuration-and-tools", "title": "System configuration and tools", "level": 2 }, { "id": "workspace-layout-and-pinned-context", "anchor": "workspace-layout-and-pinned-context", "title": "Workspace layout and pinned context", "level": 3 }, { "id": "harness-engineering", "anchor": "harness-engineering", "title": "Harness engineering", "level": 3 }, { "id": "why-is-this-action-allowed", "anchor": "why-is-this-action-allowed", "title": "Why is this action allowed?", "level": 3 }, { "id": "one-system-explicit-authorities", "anchor": "one-system-explicit-authorities", "title": "One system, explicit authorities", "level": 3 }, { "id": "a-useful-next-step-in-every-state", "anchor": "a-useful-next-step-in-every-state", "title": "A useful next step in every state", "level": 3 }, { "id": "creation-and-recovery-states", "anchor": "creation-and-recovery-states", "title": "Creation and recovery states", "level": 2 }, { "id": "start-with-the-product-brief", "anchor": "start-with-the-product-brief", "title": "Start with the product brief", "level": 3 }, { "id": "agree-on-the-product-shape", "anchor": "agree-on-the-product-shape", "title": "Agree on the product shape", "level": 3 }, { "id": "decide-when-a-tradeoff-matters", "anchor": "decide-when-a-tradeoff-matters", "title": "Decide when a tradeoff matters", "level": 3 }, { "id": "ready-for-the-first-working-slice", "anchor": "ready-for-the-first-working-slice", "title": "Ready for the first working slice", "level": 3 }, { "id": "building-the-visit-journey", "anchor": "building-the-visit-journey", "title": "Building the visit journey", "level": 3 }, { "id": "the-first-journey-is-ready-to-try", "anchor": "the-first-journey-is-ready-to-try", "title": "The first journey is ready to try", "level": 3 }, { "id": "the-new-build-needs-a-repair", "anchor": "the-new-build-needs-a-repair", "title": "The new build needs a repair", "level": 3 }, { "id": "retry-the-failed-work", "anchor": "retry-the-failed-work", "title": "Retry the failed work", "level": 3 }, { "id": "restore-a-compatible-preview", "anchor": "restore-a-compatible-preview", "title": "Restore a compatible preview", "level": 3 }, { "id": "a-release-gate-needs-attention", "anchor": "a-release-gate-needs-attention", "title": "A release gate needs attention", "level": 3 }, { "id": "recovery-has-a-compatibility-boundary", "anchor": "recovery-has-a-compatibility-boundary", "title": "Recovery has a compatibility boundary", "level": 3 }, { "id": "the-release-is-progressing-by-target", "anchor": "the-release-is-progressing-by-target", "title": "The release is progressing by target", "level": 3 }, { "id": "release-observations-match-the-scoped-plan", "anchor": "release-observations-match-the-scoped-plan", "title": "Release observations match the scoped plan", "level": 3 }, { "id": "recovery-still-has-an-unresolved-effect", "anchor": "recovery-still-has-an-unresolved-effect", "title": "Recovery still has an unresolved effect", "level": 3 }, { "id": "retained-specialist-references", "anchor": "retained-specialist-references", "title": "Retained specialist references", "level": 2 }, { "id": "graph-system-and-boundary-references", "anchor": "graph-system-and-boundary-references", "title": "Graph, system and boundary references", "level": 2 }, { "id": "0102--north-star--auth-system-slice", "anchor": "0102--north-star--auth-system-slice", "title": "01.02 · North Star · Auth System Slice", "level": 3 }, { "id": "0202--create--design-system-graph", "anchor": "0202--create--design-system-graph", "title": "02.02 · Create · Design System Graph", "level": 3 }, { "id": "0204--create--bestbuds-feature-graph", "anchor": "0204--create--bestbuds-feature-graph", "title": "02.04 · Create · BestBuds Feature Graph", "level": 3 }, { "id": "0302--extend--polyglot-boundary-studio", "anchor": "0302--extend--polyglot-boundary-studio", "title": "03.02 · Extend · Polyglot Boundary Studio", "level": 3 }, { "id": "0304--scale--constraint-optimizer", "anchor": "0304--scale--constraint-optimizer", "title": "03.04 · Scale · Constraint Optimizer", "level": 3 }, { "id": "0401--graph--system-graph", "anchor": "0401--graph--system-graph", "title": "04.01 · Graph · System Graph", "level": 3 }, { "id": "0404--graph--launch", "anchor": "0404--graph--launch", "title": "04.04 · Graph · Launch", "level": 3 }, { "id": "0406--graph--editing-connections", "anchor": "0406--graph--editing-connections", "title": "04.06 · Graph · Editing Connections", "level": 3 }, { "id": "0406a--graph--editing-connections--connected", "anchor": "0406a--graph--editing-connections--connected", "title": "04.06A · Graph · Editing Connections — Connected", "level": 3 }, { "id": "0406b--graph--editing-connections--rerouted", "anchor": "0406b--graph--editing-connections--rerouted", "title": "04.06B · Graph · Editing Connections — Rerouted", "level": 3 }, { "id": "0407--map--zoom--level-of-detail", "anchor": "0407--map--zoom--level-of-detail", "title": "04.07 · Map · Zoom & Level of Detail", "level": 3 }, { "id": "1302--trace--runtime--system-fabric-resource-explorer", "anchor": "1302--trace--runtime--system-fabric-resource-explorer", "title": "13.02 · Trace + Runtime · System Fabric Resource Explorer", "level": 3 }, { "id": "1304--extend--graph-projections", "anchor": "1304--extend--graph-projections", "title": "13.04 · Extend · Graph Projections", "level": 3 }, { "id": "interface-and-responsive-references", "anchor": "interface-and-responsive-references", "title": "Interface and responsive references", "level": 2 }, { "id": "0500--interface-system--machine-signal-design-system", "anchor": "0500--interface-system--machine-signal-design-system", "title": "05.00 · Interface System — Machine Signal Design System", "level": 3 }, { "id": "0501--interface--atomic-catalog", "anchor": "0501--interface--atomic-catalog", "title": "05.01 · Interface · Atomic Catalog", "level": 3 }, { "id": "0502--interface--responsive--visual-tests", "anchor": "0502--interface--responsive--visual-tests", "title": "05.02 · Interface · Responsive & Visual Tests", "level": 3 }, { "id": "0503--interface--command-palette", "anchor": "0503--interface--command-palette", "title": "05.03 · Interface · Command Palette", "level": 3 }, { "id": "0504--interface--drawer-states", "anchor": "0504--interface--drawer-states", "title": "05.04 · Interface · Drawer States", "level": 3 }, { "id": "state--system-studio-shell--compact-390", "anchor": "state--system-studio-shell--compact-390", "title": "STATE · System Studio Shell · Compact 390", "level": 3 }, { "id": "state--system-studio-shell--expanded-1600--dark", "anchor": "state--system-studio-shell--expanded-1600--dark", "title": "STATE · System Studio Shell · Expanded 1600 · Dark", "level": 3 }, { "id": "state--system-studio-shell--expanded-1600--high-contrast", "anchor": "state--system-studio-shell--expanded-1600--high-contrast", "title": "STATE · System Studio Shell · Expanded 1600 · High Contrast", "level": 3 }, { "id": "state--system-studio-shell--expanded-1600--light", "anchor": "state--system-studio-shell--expanded-1600--light", "title": "STATE · System Studio Shell · Expanded 1600 · Light", "level": 3 }, { "id": "state--system-studio-shell--medium-768", "anchor": "state--system-studio-shell--medium-768", "title": "STATE · System Studio Shell · Medium 768", "level": 3 }, { "id": "inner-loop-and-delivery-references", "anchor": "inner-loop-and-delivery-references", "title": "Inner-loop and delivery references", "level": 2 }, { "id": "0603--inner-loop--recorder", "anchor": "0603--inner-loop--recorder", "title": "06.03 · Inner Loop · Recorder", "level": 3 }, { "id": "state-and-trust-references", "anchor": "state-and-trust-references", "title": "State and trust references", "level": 2 }, { "id": "0902--trust--auth-sessions", "anchor": "0902--trust--auth-sessions", "title": "09.02 · Trust · Auth Sessions", "level": 3 }, { "id": "0903--trust--security-simulator", "anchor": "0903--trust--security-simulator", "title": "09.03 · Trust · Security Simulator", "level": 3 }, { "id": "0905--state--query-plan--governed-migrations", "anchor": "0905--state--query-plan--governed-migrations", "title": "09.05 · State · Query Plan & Governed Migrations", "level": 3 }, { "id": "0906--state--data-evidence--history", "anchor": "0906--state--data-evidence--history", "title": "09.06 · State · Data Evidence & History", "level": 3 }, { "id": "observe-and-product-learning-references", "anchor": "observe-and-product-learning-references", "title": "Observe and product-learning references", "level": 2 }, { "id": "1001--trace--runtime--spans-ebpf--evidence", "anchor": "1001--trace--runtime--spans-ebpf--evidence", "title": "10.01 · Trace + Runtime · Spans, eBPF & Evidence", "level": 3 }, { "id": "1004--observe--errors", "anchor": "1004--observe--errors", "title": "10.04 · Observe · Errors", "level": 3 }, { "id": "1005--observe--alerts--pipelines", "anchor": "1005--observe--alerts--pipelines", "title": "10.05 · Observe · Alerts & Pipelines", "level": 3 }, { "id": "1102--learn--cohorts--retention", "anchor": "1102--learn--cohorts--retention", "title": "11.02 · Learn · Cohorts & Retention", "level": 3 }, { "id": "1103--learn--experiments", "anchor": "1103--learn--experiments", "title": "11.03 · Learn · Experiments", "level": 3 }, { "id": "1105--learn--reports", "anchor": "1105--learn--reports", "title": "11.05 · Learn · Reports", "level": 3 }, { "id": "ai-engineering-references", "anchor": "ai-engineering-references", "title": "AI engineering references", "level": 2 }, { "id": "1201--ai--models--operators", "anchor": "1201--ai--models--operators", "title": "12.01 · AI · Models & Operators", "level": 3 }, { "id": "1202--ai--models--routing", "anchor": "1202--ai--models--routing", "title": "12.02 · AI · Models & Routing", "level": 3 }, { "id": "1203--map--intelligence--governed-chain-builder", "anchor": "1203--map--intelligence--governed-chain-builder", "title": "12.03 · Map + Intelligence · Governed Chain Builder", "level": 3 }, { "id": "1204--ai--rag", "anchor": "1204--ai--rag", "title": "12.04 · AI · RAG", "level": 3 }, { "id": "1205--ai--prompts--evals", "anchor": "1205--ai--prompts--evals", "title": "12.05 · AI · Prompts & Evals", "level": 3 }, { "id": "1206--ai--notebooks", "anchor": "1206--ai--notebooks", "title": "12.06 · AI · Notebooks", "level": 3 }, { "id": "1207--ai--traces", "anchor": "1207--ai--traces", "title": "12.07 · AI · Traces", "level": 3 }, { "id": "components-and-atlas-dividers", "anchor": "components-and-atlas-dividers", "title": "Components and atlas dividers", "level": 2 }, { "id": "1600--reaktor-graph--living-graph-instruments", "anchor": "1600--reaktor-graph--living-graph-instruments", "title": "16.00 · Reaktor Graph · Living graph instruments", "level": 3 }, { "id": "reaktor--workbench-system", "anchor": "reaktor--workbench-system", "title": "Reaktor / Workbench system", "level": 3 }, { "id": "1400--reaktor--machine-signal-interaction-kit", "anchor": "1400--reaktor--machine-signal-interaction-kit", "title": "14.00 · Reaktor · Machine Signal interaction kit", "level": 3 }, { "id": "1401--reaktor--fieldwork-product-preview-component", "anchor": "1401--reaktor--fieldwork-product-preview-component", "title": "14.01 · Reaktor · Fieldwork product preview component", "level": 3 }, { "id": "reference-library--machine-signal", "anchor": "reference-library--machine-signal", "title": "REFERENCE LIBRARY · MACHINE SIGNAL", "level": 3 }, { "id": "section-01--north-star--understand", "anchor": "section-01--north-star--understand", "title": "SECTION 01 · NORTH STAR / UNDERSTAND", "level": 3 }, { "id": "section-02--create--compose", "anchor": "section-02--create--compose", "title": "SECTION 02 · CREATE / COMPOSE", "level": 3 }, { "id": "section-03--govern--extend--scale", "anchor": "section-03--govern--extend--scale", "title": "SECTION 03 · GOVERN / EXTEND / SCALE", "level": 3 }, { "id": "section-04--graph-substrate", "anchor": "section-04--graph-substrate", "title": "SECTION 04 · GRAPH SUBSTRATE", "level": 3 }, { "id": "section-05--interface-system", "anchor": "section-05--interface-system", "title": "SECTION 05 · INTERFACE SYSTEM", "level": 3 }, { "id": "section-06--inner-development-loop", "anchor": "section-06--inner-development-loop", "title": "SECTION 06 · INNER DEVELOPMENT LOOP", "level": 3 }, { "id": "section-07--ship--release", "anchor": "section-07--ship--release", "title": "SECTION 07 · SHIP & RELEASE", "level": 3 }, { "id": "section-08--agent-operations", "anchor": "section-08--agent-operations", "title": "SECTION 08 · AGENT OPERATIONS", "level": 3 }, { "id": "section-09--state--trust", "anchor": "section-09--state--trust", "title": "SECTION 09 · STATE & TRUST", "level": 3 }, { "id": "section-10--observe", "anchor": "section-10--observe", "title": "SECTION 10 · OBSERVE", "level": 3 }, { "id": "section-11--learn--optimize", "anchor": "section-11--learn--optimize", "title": "SECTION 11 · LEARN & OPTIMIZE", "level": 3 }, { "id": "section-12--ai-engineering", "anchor": "section-12--ai-engineering", "title": "SECTION 12 · AI ENGINEERING", "level": 3 }, { "id": "section-13--runtime--extensibility", "anchor": "section-13--runtime--extensibility", "title": "SECTION 13 · RUNTIME & EXTENSIBILITY", "level": 3 } ], "links": [ { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "ecosystem-integration", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "distance-from-the-full-design-and-vision", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "current-native-implementation", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-FsQx4", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-LODux", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-ZCxzu", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-ufhps", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-nXDMm", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-C2Cd7K", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-IRQ5A", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "zoom-through-one-whole-system-map", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-aPU6J", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-gVWV6", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "one-connected-value-chain", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "persistent-editor-shell", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-w4EWt", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Mmo0o", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Wx6KI", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "rebuilt-workspaces", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "retained-specialist-references", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Wgw9w", "relation": "references", "sourceAnchor": "the-system-map-one-viewport-four-scales" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "fixture-ledger", "relation": "references", "sourceAnchor": "the-system-map-one-viewport-four-scales" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "decision-table", "relation": "references", "sourceAnchor": "the-system-map-one-viewport-four-scales" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-DBc14", "relation": "references", "sourceAnchor": "system-map--estate" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "acceptance-tests", "relation": "references", "sourceAnchor": "system-map--estate" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-pxsmW", "relation": "references", "sourceAnchor": "system-map--runtime-district" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "acceptance-tests", "relation": "references", "sourceAnchor": "system-map--runtime-district" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Pu9Sf", "relation": "references", "sourceAnchor": "system-map--feature-and-its-boundary" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "acceptance-tests", "relation": "references", "sourceAnchor": "system-map--feature-and-its-boundary" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "acceptance-tests", "relation": "references", "sourceAnchor": "system-map--exact-port-and-selected-execution" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "system-map--realtime-session-versus-durable-delivery" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "system-map--realtime-session-versus-durable-delivery" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "acceptance-tests", "relation": "references", "sourceAnchor": "system-map--realtime-session-versus-durable-delivery" }, { "id": "reaktor-visual-language", "anchor": "road-grammar", "relation": "references", "sourceAnchor": "map-viewport-instruments" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "real-app-topology", "relation": "references", "sourceAnchor": "bestbuds--follow-a-selection-across-tools" }, { "id": "reaktor-unified-system-graph", "anchor": "flow-entrypoints", "relation": "references", "sourceAnchor": "orchestrate-from-any-event-or-intent" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "one-living-system" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "interaction-guide" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "interaction-guide" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "interaction-guide" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "interaction-guide" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-ZCxzu", "relation": "references", "sourceAnchor": "zoom-through-one-whole-system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-DBc14", "relation": "references", "sourceAnchor": "zoom-through-one-whole-system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-pxsmW", "relation": "references", "sourceAnchor": "zoom-through-one-whole-system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Pu9Sf", "relation": "references", "sourceAnchor": "zoom-through-one-whole-system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-W9V37c", "relation": "references", "sourceAnchor": "zoom-through-one-whole-system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Wgw9w", "relation": "references", "sourceAnchor": "zoom-through-one-whole-system-map" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "continuous-zoom", "relation": "references", "sourceAnchor": "operate-on-the-selected-end-to-end-flow" }, { "id": "reaktor-unified-system-graph", "anchor": "ui-to-system", "relation": "references", "sourceAnchor": "operate-on-the-selected-end-to-end-flow" }, { "id": "reaktor-unified-system-graph", "anchor": "route-orchestration", "relation": "references", "sourceAnchor": "operate-on-the-selected-end-to-end-flow" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "operate-on-the-selected-end-to-end-flow" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "operate-on-the-selected-end-to-end-flow" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "operate-on-the-selected-end-to-end-flow" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "operate-on-the-selected-end-to-end-flow" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "8-a-generating-basis-modules-features-and-capabilities", "relation": "references", "sourceAnchor": "modules-contribute-working-mechanisms-and-their-instruments" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "12-flows-choreography-and-the-opinionated-datacloud-stack", "relation": "references", "sourceAnchor": "make-the-opinionated-cloud-visible" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "make-the-opinionated-cloud-visible" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "16-current-system-map-and-intended-progression", "relation": "references", "sourceAnchor": "complete-one-feature-across-the-system" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "3-greenfield-creation-is-a-first-class-product", "relation": "references", "sourceAnchor": "creating-and-extending-a-normal-project" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "6-the-core-a-live-model-with-a-small-semantic-kernel", "relation": "references", "sourceAnchor": "coediting-source-composition-and-product" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "one-action-path-appropriate-to-the-action" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "one-action-path-appropriate-to-the-action" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "conductor-alongside-the-editors" }, { "id": "reaktor-conductor", "anchor": "gaps", "relation": "references", "sourceAnchor": "conductor-alongside-the-editors" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "specialist-workspaces-earn-their-space" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "specialist-workspaces-earn-their-space" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "specialist-workspaces-earn-their-space" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "specialist-workspaces-earn-their-space" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "specialist-workspaces-earn-their-space" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "specialist-workspaces-earn-their-space" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "16-current-system-map-and-intended-progression", "relation": "references", "sourceAnchor": "december-delivery-and-the-north-star-design" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-ZCxzu", "relation": "references", "sourceAnchor": "current-native-implementation--8-september-2026" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-yawya", "relation": "references", "sourceAnchor": "current-native-implementation--8-september-2026" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-j8If5", "relation": "references", "sourceAnchor": "current-native-implementation--8-september-2026" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-LzukO", "relation": "references", "sourceAnchor": "current-native-implementation--8-september-2026" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-ufhps", "relation": "references", "sourceAnchor": "current-native-implementation--8-september-2026" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Wgw9w", "relation": "references", "sourceAnchor": "current-native-implementation--8-september-2026" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "current-native-implementation--8-september-2026" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Pu9Sf", "relation": "references", "sourceAnchor": "source-consistency-audit--7-september-2026" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "real-app-topology", "relation": "references", "sourceAnchor": "earlier-application-inspection--7-september-2026" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "earlier-application-inspection--7-september-2026" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "16-current-system-map-and-intended-progression", "relation": "references", "sourceAnchor": "earlier-application-inspection--7-september-2026" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "rebuilt-workspaces" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "rebuilt-workspaces" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "rebuilt-workspaces" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "rebuilt-workspaces" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-IRQ5A", "relation": "references", "sourceAnchor": "graph-editors-and-instruments" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-aPU6J", "relation": "references", "sourceAnchor": "graph-editors-and-instruments" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-hqJ9u", "relation": "references", "sourceAnchor": "program-the-living-graph" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-IRQ5A", "relation": "references", "sourceAnchor": "one-system-explicit-authorities" }, { "id": "reaktor-atlas-review-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "retained-specialist-references" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "retained-specialist-references" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "0406--graph--editing-connections" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "0903--trust--security-simulator" } ] }, { "id": "reaktor-atlas-review-fable-5", "owner": "Claude", "kind": "analysis", "summary": "Claude's original exhaustive board inventory, measurements, contradiction audit, and pane-by-pane reasoning, retained publicly as auditable source material for the canonical combined atlas.", "use": "Use for source-level audit detail after reading the current Astra atlas; do not treat it as the current implementation plan where the combined guide resolves or supersedes it.", "region": "background-research", "order": 9, "title": "Reaktor Product Atlas — Original Source Review — Fable 5", "nav": "Atlas Source Review (Fable 5)", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-atlas-review-fable-5", "revision": "d5e1f7981556edcef9eee49925fc1d259b1cdc218af5fd0d007c7941b778b85b", "status": "historical", "renderingRevision": "b128b6bf253011cfd91fa3f2e88ff5df7e30010e1eea1beb88b79defe71a8fcc", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "how-this-was-produced" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-atlas-review-fable-5", "polarity": "Neutral" }, { "id": "section-how-this-was-produced", "anchor": "evidence-basis", "label": "Evidence basis", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-review-fable-5#evidence-basis", "polarity": "Neutral" }, { "id": "section-the-atlas-in-one-page", "anchor": "the-atlas-in-one-page", "label": "The atlas in one page", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-review-fable-5#the-atlas-in-one-page", "polarity": "Neutral" }, { "id": "section-the-diagnosis", "anchor": "the-diagnosis", "label": "The diagnosis", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-review-fable-5#the-diagnosis", "polarity": "Neutral" }, { "id": "section-what-follows", "anchor": "what-follows", "label": "What follows", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-review-fable-5#what-follows", "polarity": "Neutral" }, { "id": "section-part-3--the-evidence-template", "anchor": "part-3--the-evidence-template", "label": "Part 3 · The evidence template", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-review-fable-5#part-3--the-evidence-template", "polarity": "Neutral" }, { "id": "section-part-4--section-0001--entry-and-north-star", "anchor": "part-4--section-0001--entry-and-north-star", "label": "Part 4 · Section 00–01 — Entry and North Star", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-atlas-review-fable-5#part-4--section-0001--entry-and-north-star", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-atlas-review-fable-5:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "reaktor-atlas-review-fable-5", "incidences": [ { "node": "reaktor-atlas-review-fable-5", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-review-fable-5:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "reaktor-atlas-review-fable-5", "incidences": [ { "node": "reaktor-atlas-review-fable-5", "port": "section-how-this-was-produced", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-review-fable-5:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "reaktor-atlas-review-fable-5", "incidences": [ { "node": "reaktor-atlas-review-fable-5", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-atlas-review-fable-5:references-reaktor-essays", "kind": "references", "owner": "reaktor-atlas-review-fable-5", "incidences": [ { "node": "reaktor-atlas-review-fable-5", "port": "section-how-this-was-produced", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-atlas-review-fable-5.json", "sections": [ { "id": "reaktor-product-atlas--original-source-review--fable-5", "anchor": "reaktor-product-atlas--original-source-review--fable-5", "title": "Reaktor Product Atlas — Original Source Review — Fable 5", "level": 1 }, { "id": "evidence-basis", "anchor": "evidence-basis", "title": "Evidence basis", "level": 2 }, { "id": "the-atlas-in-one-page", "anchor": "the-atlas-in-one-page", "title": "The atlas in one page", "level": 2 }, { "id": "the-diagnosis", "anchor": "the-diagnosis", "title": "The diagnosis", "level": 2 }, { "id": "1-the-fixture-data-contradicts-itself-which-disproves-the-atlass-own-thesis", "anchor": "1-the-fixture-data-contradicts-itself-which-disproves-the-atlass-own-thesis", "title": "1. The fixture data contradicts itself, which disproves the atlas's own thesis", "level": 3 }, { "id": "2-the-evidence-block-is-a-constant", "anchor": "2-the-evidence-block-is-a-constant", "title": "2. The evidence block is a constant", "level": 3 }, { "id": "3-the-evidence-discipline-reaches-the-periphery-and-stops-at-the-core", "anchor": "3-the-evidence-discipline-reaches-the-periphery-and-stops-at-the-core", "title": "3. The evidence discipline reaches the periphery and stops at the core", "level": 3 }, { "id": "4-time-is-the-invariant-that-broke", "anchor": "4-time-is-the-invariant-that-broke", "title": "4. Time is the invariant that broke", "level": 3 }, { "id": "5-the-atlas-depicts-reaktors-structure-and-not-its-semantics", "anchor": "5-the-atlas-depicts-reaktors-structure-and-not-its-semantics", "title": "5. The atlas depicts Reaktor's structure and not its semantics", "level": 3 }, { "id": "6-there-is-no-assurance-section", "anchor": "6-there-is-no-assurance-section", "title": "6. There is no assurance section", "level": 3 }, { "id": "7-governance-forks-into-four-mechanisms-where-the-contract-promises-one", "anchor": "7-governance-forks-into-four-mechanisms-where-the-contract-promises-one", "title": "7. Governance forks into four mechanisms where the contract promises one", "level": 3 }, { "id": "8-provenance-is-mis-encoded-rather-than-missing--and-this-is-the-cheap-fix", "anchor": "8-provenance-is-mis-encoded-rather-than-missing--and-this-is-the-cheap-fix", "title": "8. Provenance is mis-encoded rather than missing — and this is the cheap fix", "level": 3 }, { "id": "9-substantial-redundancy-above-healthy-chrome", "anchor": "9-substantial-redundancy-above-healthy-chrome", "title": "9. Substantial redundancy above healthy chrome", "level": 3 }, { "id": "10-the-design-system-has-drifted-out-from-under-the-atlas", "anchor": "10-the-design-system-has-drifted-out-from-under-the-atlas", "title": "10. The design system has drifted out from under the atlas", "level": 3 }, { "id": "what-follows", "anchor": "what-follows", "title": "What follows", "level": 2 }, { "id": "part-3--the-evidence-template", "anchor": "part-3--the-evidence-template", "title": "Part 3 · The evidence template", "level": 2 }, { "id": "the-regions", "anchor": "the-regions", "title": "The regions", "level": 4 }, { "id": "mandatory-versus-optional", "anchor": "mandatory-versus-optional", "title": "Mandatory versus optional", "level": 4 }, { "id": "the-four-validity-rules", "anchor": "the-four-validity-rules", "title": "The four validity rules", "level": 4 }, { "id": "how-a-board-declares-its-coverage-honestly", "anchor": "how-a-board-declares-its-coverage-honestly", "title": "How a board declares its coverage honestly", "level": 4 }, { "id": "applying-the-template-to-a-new-board-tomorrow", "anchor": "applying-the-template-to-a-new-board-tomorrow", "title": "Applying the template to a new board tomorrow", "level": 4 }, { "id": "part-4--section-0001--entry-and-north-star", "anchor": "part-4--section-0001--entry-and-north-star", "title": "Part 4 · Section 00–01 — Entry and North Star", "level": 2 }, { "id": "00--start-here--reaktor-product-atlas", "anchor": "00--start-here--reaktor-product-atlas", "title": "00 · START HERE — Reaktor Product Atlas", "level": 4 }, { "id": "0101--north-star--mission-control", "anchor": "0101--north-star--mission-control", "title": "01.01 · North Star · Mission Control", "level": 4 }, { "id": "0102--north-star--auth-system-slice", "anchor": "0102--north-star--auth-system-slice", "title": "01.02 · North Star · Auth System Slice", "level": 4 }, { "id": "0103--north-star--system-fabric", "anchor": "0103--north-star--system-fabric", "title": "01.03 · North Star · System Fabric", "level": 4 }, { "id": "0104--north-star--agent-os", "anchor": "0104--north-star--agent-os", "title": "01.04 · North Star · Agent OS", "level": 4 }, { "id": "0105--north-star--knowledge-atlas", "anchor": "0105--north-star--knowledge-atlas", "title": "01.05 · North Star · Knowledge Atlas", "level": 4 }, { "id": "section-0113-banners-thirteen-boards-grouped", "anchor": "section-0113-banners-thirteen-boards-grouped", "title": "SECTION 01–13 banners (thirteen boards, grouped)", "level": 4 }, { "id": "reference-library--machine-signal", "anchor": "reference-library--machine-signal", "title": "REFERENCE LIBRARY · MACHINE SIGNAL", "level": 4 }, { "id": "cluster-findings", "anchor": "cluster-findings", "title": "Cluster findings", "level": 3 }, { "id": "atlas-taxonomy-verdict", "anchor": "atlas-taxonomy-verdict", "title": "Atlas taxonomy verdict", "level": 3 }, { "id": "part-5--section-0203--create-govern-extend-scale", "anchor": "part-5--section-0203--create-govern-extend-scale", "title": "Part 5 · Section 02–03 — Create, Govern, Extend, Scale", "level": 2 }, { "id": "0201--create--new-system-composer", "anchor": "0201--create--new-system-composer", "title": "02.01 · Create · New System Composer", "level": 4 }, { "id": "0202--create--design-system-graph", "anchor": "0202--create--design-system-graph", "title": "02.02 · Create · Design System Graph", "level": 4 }, { "id": "0203--create--primitive-atlas", "anchor": "0203--create--primitive-atlas", "title": "02.03 · Create · Primitive Atlas", "level": 4 }, { "id": "0204--create--bestbuds-feature-graph", "anchor": "0204--create--bestbuds-feature-graph", "title": "02.04 · Create · BestBuds Feature Graph", "level": 4 }, { "id": "0301--govern--visitor-lab", "anchor": "0301--govern--visitor-lab", "title": "03.01 · Govern · Visitor Lab", "level": 4 }, { "id": "0302--extend--polyglot-boundary-studio", "anchor": "0302--extend--polyglot-boundary-studio", "title": "03.02 · Extend · Polyglot Boundary Studio", "level": 4 }, { "id": "0303--scale--brownfield-atlas", "anchor": "0303--scale--brownfield-atlas", "title": "03.03 · Scale · Brownfield Atlas", "level": 4 }, { "id": "0304--scale--constraint-optimizer", "anchor": "0304--scale--constraint-optimizer", "title": "03.04 · Scale · Constraint Optimizer", "level": 4 }, { "id": "cluster-findings-1", "anchor": "cluster-findings-1", "title": "Cluster findings", "level": 3 }, { "id": "part-6--section-04--the-graph-substrate", "anchor": "part-6--section-04--the-graph-substrate", "title": "Part 6 · Section 04 — The Graph Substrate", "level": 2 }, { "id": "summary-before-the-detail", "anchor": "summary-before-the-detail", "title": "Summary before the detail", "level": 3 }, { "id": "0401--graph--system-graph", "anchor": "0401--graph--system-graph", "title": "04.01 · Graph · System Graph", "level": 4 }, { "id": "0402--map--semantic-graph-editor--compiler", "anchor": "0402--map--semantic-graph-editor--compiler", "title": "04.02 · Map · Semantic Graph Editor & Compiler", "level": 4 }, { "id": "0403--map--full-system--fabric-studio--command-density", "anchor": "0403--map--full-system--fabric-studio--command-density", "title": "04.03 · Map · Full System + Fabric Studio — Command Density", "level": 4 }, { "id": "0404--graph--launch", "anchor": "0404--graph--launch", "title": "04.04 · Graph · Launch", "level": 4 }, { "id": "0405--map--semantic-depth--density", "anchor": "0405--map--semantic-depth--density", "title": "04.05 · Map · Semantic Depth × Density", "level": 4 }, { "id": "0406--graph--editing-connections", "anchor": "0406--graph--editing-connections", "title": "04.06 · Graph · Editing Connections", "level": 4 }, { "id": "0406a--graph--editing-connections--connected", "anchor": "0406a--graph--editing-connections--connected", "title": "04.06A · Graph · Editing Connections — Connected", "level": 4 }, { "id": "0406b--graph--editing-connections--rerouted", "anchor": "0406b--graph--editing-connections--rerouted", "title": "04.06B · Graph · Editing Connections — Rerouted", "level": 4 }, { "id": "0407--map--zoom--level-of-detail", "anchor": "0407--map--zoom--level-of-detail", "title": "04.07 · Map · Zoom & Level of Detail", "level": 4 }, { "id": "0408--act--source--authoring-compile--debug", "anchor": "0408--act--source--authoring-compile--debug", "title": "04.08 · Act + Source · Authoring, Compile & Debug", "level": 4 }, { "id": "blueprint-parity-table", "anchor": "blueprint-parity-table", "title": "Blueprint parity table", "level": 3 }, { "id": "the-identity-problem", "anchor": "the-identity-problem", "title": "The identity problem", "level": 3 }, { "id": "what-the-surfaces-must-show", "anchor": "what-the-surfaces-must-show", "title": "What the surfaces must show", "level": 4 }, { "id": "editing-versus-runtime", "anchor": "editing-versus-runtime", "title": "Editing versus runtime", "level": 3 }, { "id": "redundancy-and-consolidation", "anchor": "redundancy-and-consolidation", "title": "Redundancy and consolidation", "level": 3 }, { "id": "recommended-consolidation", "anchor": "recommended-consolidation", "title": "Recommended consolidation", "level": 4 }, { "id": "cluster-findings-2", "anchor": "cluster-findings-2", "title": "Cluster findings", "level": 3 }, { "id": "missing-panes", "anchor": "missing-panes", "title": "Missing panes", "level": 4 }, { "id": "seams", "anchor": "seams", "title": "Seams", "level": 4 }, { "id": "honesty-audit", "anchor": "honesty-audit", "title": "Honesty audit", "level": 4 }, { "id": "part-7--section-05--the-interface-system-and-the-shell", "anchor": "part-7--section-05--the-interface-system-and-the-shell", "title": "Part 7 · Section 05 — The Interface System and the Shell", "level": 2 }, { "id": "0500--interface-system--machine-signal-design-system", "anchor": "0500--interface-system--machine-signal-design-system", "title": "05.00 · Interface System — Machine Signal Design System", "level": 4 }, { "id": "0501--interface--atomic-catalog", "anchor": "0501--interface--atomic-catalog", "title": "05.01 · Interface · Atomic Catalog", "level": 4 }, { "id": "0502--interface--responsive--visual-tests", "anchor": "0502--interface--responsive--visual-tests", "title": "05.02 · Interface · Responsive & Visual Tests", "level": 4 }, { "id": "0503--interface--command-palette", "anchor": "0503--interface--command-palette", "title": "05.03 · Interface · Command Palette", "level": 4 }, { "id": "0504--interface--drawer-states", "anchor": "0504--interface--drawer-states", "title": "05.04 · Interface · Drawer States", "level": 4 }, { "id": "state--system-studio-shell--compact-390", "anchor": "state--system-studio-shell--compact-390", "title": "STATE · System Studio Shell · Compact 390", "level": 4 }, { "id": "state--system-studio-shell--medium-768", "anchor": "state--system-studio-shell--medium-768", "title": "STATE · System Studio Shell · Medium 768", "level": 4 }, { "id": "state--system-studio-shell--expanded-1600--dark", "anchor": "state--system-studio-shell--expanded-1600--dark", "title": "STATE · System Studio Shell · Expanded 1600 · Dark", "level": 4 }, { "id": "state--system-studio-shell--expanded-1600--light", "anchor": "state--system-studio-shell--expanded-1600--light", "title": "STATE · System Studio Shell · Expanded 1600 · Light", "level": 4 }, { "id": "state--system-studio-shell--expanded-1600--high-contrast", "anchor": "state--system-studio-shell--expanded-1600--high-contrast", "title": "STATE · System Studio Shell · Expanded 1600 · High Contrast", "level": 4 }, { "id": "a-the-truth-vocabulary-judged-and-completed", "anchor": "a-the-truth-vocabulary-judged-and-completed", "title": "A. The truth vocabulary, judged and completed", "level": 3 }, { "id": "what-is-actually-there", "anchor": "what-is-actually-there", "title": "What is actually there", "level": 4 }, { "id": "three-defects-in-the-vocabulary-itself", "anchor": "three-defects-in-the-vocabulary-itself", "title": "Three defects in the vocabulary itself", "level": 4 }, { "id": "the-proposed-final-vocabulary", "anchor": "the-proposed-final-vocabulary", "title": "The proposed final vocabulary", "level": 4 }, { "id": "b-enforcement--making-provenance-impossible-to-omit", "anchor": "b-enforcement--making-provenance-impossible-to-omit", "title": "B. Enforcement — making provenance impossible to omit", "level": 3 }, { "id": "in-the-components", "anchor": "in-the-components", "title": "In the components", "level": 4 }, { "id": "in-the-file", "anchor": "in-the-file", "title": "In the file", "level": 4 }, { "id": "the-parity-check", "anchor": "the-parity-check", "title": "The parity check", "level": 4 }, { "id": "c-the-shell-across-breakpoints", "anchor": "c-the-shell-across-breakpoints", "title": "C. The shell across breakpoints", "level": 3 }, { "id": "d-the-command-palette-as-the-agentic-seam", "anchor": "d-the-command-palette-as-the-agentic-seam", "title": "D. The command palette as the agentic seam", "level": 3 }, { "id": "cluster-findings-3", "anchor": "cluster-findings-3", "title": "Cluster findings", "level": 3 }, { "id": "missing-panes-1", "anchor": "missing-panes-1", "title": "Missing panes", "level": 4 }, { "id": "seams-1", "anchor": "seams-1", "title": "Seams", "level": 4 }, { "id": "honesty-audit-1", "anchor": "honesty-audit-1", "title": "Honesty audit", "level": 4 }, { "id": "part-8--section-0607--inner-loop-ship-and-release", "anchor": "part-8--section-0607--inner-loop-ship-and-release", "title": "Part 8 · Section 06–07 — Inner Loop, Ship and Release", "level": 2 }, { "id": "0601--trace--interface--live-preview", "anchor": "0601--trace--interface--live-preview", "title": "06.01 · Trace + Interface · Live Preview", "level": 4 }, { "id": "0602--inner-loop--flow-storyboard", "anchor": "0602--inner-loop--flow-storyboard", "title": "06.02 · Inner Loop · Flow Storyboard", "level": 4 }, { "id": "0603--inner-loop--recorder", "anchor": "0603--inner-loop--recorder", "title": "06.03 · Inner Loop · Recorder", "level": 4 }, { "id": "0604--inner-loop--causal-trace", "anchor": "0604--inner-loop--causal-trace", "title": "06.04 · Inner Loop · Causal Trace", "level": 4 }, { "id": "0605--validate--delivery--harnesses--shadow-e2e", "anchor": "0605--validate--delivery--harnesses--shadow-e2e", "title": "06.05 · Validate + Delivery · Harnesses & Shadow E2E", "level": 4 }, { "id": "0701--ship--device-lab", "anchor": "0701--ship--device-lab", "title": "07.01 · Ship · Device Lab", "level": 4 }, { "id": "0702--ship--pipeline", "anchor": "0702--ship--pipeline", "title": "07.02 · Ship · Pipeline", "level": 4 }, { "id": "0703--ship--releases", "anchor": "0703--ship--releases", "title": "07.03 · Ship · Releases", "level": 4 }, { "id": "0704--act--delivery--deployment-plan--gates", "anchor": "0704--act--delivery--deployment-plan--gates", "title": "07.04 · Act + Delivery · Deployment Plan & Gates", "level": 4 }, { "id": "state--deploy--blocked-by-failed-gate", "anchor": "state--deploy--blocked-by-failed-gate", "title": "STATE · Deploy · Blocked by Failed Gate", "level": 4 }, { "id": "state--deploy--rollback-confirmation", "anchor": "state--deploy--rollback-confirmation", "title": "STATE · Deploy · Rollback Confirmation", "level": 4 }, { "id": "state--deploy--production-rollout-running", "anchor": "state--deploy--production-rollout-running", "title": "STATE · Deploy · Production Rollout Running", "level": 4 }, { "id": "state--deploy--complete-and-healthy", "anchor": "state--deploy--complete-and-healthy", "title": "STATE · Deploy · Complete and Healthy", "level": 4 }, { "id": "state--deploy--recovery-complete", "anchor": "state--deploy--recovery-complete", "title": "STATE · Deploy · Recovery Complete", "level": 4 }, { "id": "focused-judgements", "anchor": "focused-judgements", "title": "Focused judgements", "level": 3 }, { "id": "1-the-ci-contradiction-on-0702", "anchor": "1-the-ci-contradiction-on-0702", "title": "1. The CI contradiction on 07.02", "level": 4 }, { "id": "2-0605-as-the-honesty-exemplar-and-how-to-systematise-it", "anchor": "2-0605-as-the-honesty-exemplar-and-how-to-systematise-it", "title": "2. 06.05 as the honesty exemplar, and how to systematise it", "level": 4 }, { "id": "3-where-the-verification-ladder-belongs", "anchor": "3-where-the-verification-ladder-belongs", "title": "3. Where the verification ladder belongs", "level": 4 }, { "id": "4-graph-code-push", "anchor": "4-graph-code-push", "title": "4. Graph code push", "level": 4 }, { "id": "5-are-these-the-right-five-deploy-states", "anchor": "5-are-these-the-right-five-deploy-states", "title": "5. Are these the right five deploy states?", "level": 4 }, { "id": "cluster-findings-4", "anchor": "cluster-findings-4", "title": "Cluster findings", "level": 3 }, { "id": "part-9--section-08-and-12--agent-operations-and-ai-engineering", "anchor": "part-9--section-08-and-12--agent-operations-and-ai-engineering", "title": "Part 9 · Section 08 and 12 — Agent Operations and AI Engineering", "level": 2 }, { "id": "0-the-two-planes-and-which-board-belongs-to-which", "anchor": "0-the-two-planes-and-which-board-belongs-to-which", "title": "0. The two planes, and which board belongs to which", "level": 3 }, { "id": "board-entries", "anchor": "board-entries", "title": "Board entries", "level": 3 }, { "id": "0801--agent--conductor-session--critic", "anchor": "0801--agent--conductor-session--critic", "title": "08.01 · Agent · Conductor, Session & Critic", "level": 4 }, { "id": "0802--agents--kanban-orchestration", "anchor": "0802--agents--kanban-orchestration", "title": "08.02 · Agents · Kanban Orchestration", "level": 4 }, { "id": "0803--agents--tasks-dag", "anchor": "0803--agents--tasks-dag", "title": "08.03 · Agents · Tasks DAG", "level": 4 }, { "id": "0804--agents--mcp--memory", "anchor": "0804--agents--mcp--memory", "title": "08.04 · Agents · MCP & Memory", "level": 4 }, { "id": "0805--agents--runbooks--audit", "anchor": "0805--agents--runbooks--audit", "title": "08.05 · Agents · Runbooks & Audit", "level": 4 }, { "id": "1201--ai--models--operators", "anchor": "1201--ai--models--operators", "title": "12.01 · AI · Models & Operators", "level": 4 }, { "id": "1202--ai--models--routing", "anchor": "1202--ai--models--routing", "title": "12.02 · AI · Models & Routing", "level": 4 }, { "id": "1203--map--intelligence--governed-chain-builder", "anchor": "1203--map--intelligence--governed-chain-builder", "title": "12.03 · Map + Intelligence · Governed Chain Builder", "level": 4 }, { "id": "1204--ai--rag", "anchor": "1204--ai--rag", "title": "12.04 · AI · RAG", "level": 4 }, { "id": "1205--ai--prompts--evals", "anchor": "1205--ai--prompts--evals", "title": "12.05 · AI · Prompts & Evals", "level": 4 }, { "id": "1206--ai--notebooks", "anchor": "1206--ai--notebooks", "title": "12.06 · AI · Notebooks", "level": 4 }, { "id": "1207--ai--traces", "anchor": "1207--ai--traces", "title": "12.07 · AI · Traces", "level": 4 }, { "id": "cluster-findings-5", "anchor": "cluster-findings-5", "title": "Cluster findings", "level": 3 }, { "id": "missing-panes-2", "anchor": "missing-panes-2", "title": "Missing panes", "level": 4 }, { "id": "seams-2", "anchor": "seams-2", "title": "Seams", "level": 4 }, { "id": "honesty-audit-2", "anchor": "honesty-audit-2", "title": "Honesty audit", "level": 4 }, { "id": "d-what-a-genuinely-superior-to-mcp-agent-interface-looks-like", "anchor": "d-what-a-genuinely-superior-to-mcp-agent-interface-looks-like", "title": "D. What a genuinely superior-to-MCP agent interface looks like", "level": 3 }, { "id": "e-governed-change--a-serious-structural-flaw", "anchor": "e-governed-change--a-serious-structural-flaw", "title": "E. Governed change — a serious structural flaw", "level": 3 }, { "id": "f-competitive-framing--against-what-cursor-claude-code-devin-langsmith-and-wb-ship-today", "anchor": "f-competitive-framing--against-what-cursor-claude-code-devin-langsmith-and-wb-ship-today", "title": "F. Competitive framing — against what Cursor, Claude Code, Devin, LangSmith and W&B ship today", "level": 3 }, { "id": "part-10--section-09--state-and-trust", "anchor": "part-10--section-09--state-and-trust", "title": "Part 10 · Section 09 — State and Trust", "level": 2 }, { "id": "0901--validate--identity--policy-rbac--explanation", "anchor": "0901--validate--identity--policy-rbac--explanation", "title": "09.01 · Validate + Identity · Policy, RBAC & Explanation", "level": 4 }, { "id": "0902--trust--auth-sessions", "anchor": "0902--trust--auth-sessions", "title": "09.02 · Trust · Auth Sessions", "level": 4 }, { "id": "0903--trust--security-simulator", "anchor": "0903--trust--security-simulator", "title": "09.03 · Trust · Security Simulator", "level": 4 }, { "id": "would-0901-or-0902-have-surfaced-s-1-no--and-the-reason-is-structural-not-accidental", "anchor": "would-0901-or-0902-have-surfaced-s-1-no--and-the-reason-is-structural-not-accidental", "title": "Would 09.01 or 09.02 have surfaced S-1? No — and the reason is structural, not accidental", "level": 4 }, { "id": "0904--map--state--data-studio--query-schema--lineage", "anchor": "0904--map--state--data-studio--query-schema--lineage", "title": "09.04 · Map + State · Data Studio — Query, Schema & Lineage", "level": 4 }, { "id": "0905--state--query-plan--governed-migrations", "anchor": "0905--state--query-plan--governed-migrations", "title": "09.05 · State · Query Plan & Governed Migrations", "level": 4 }, { "id": "0906--state--data-evidence--history", "anchor": "0906--state--data-evidence--history", "title": "09.06 · State · Data Evidence & History", "level": 4 }, { "id": "state--composer--1-of-5--product-intent", "anchor": "state--composer--1-of-5--product-intent", "title": "STATE · Composer · 1 of 5 · Product Intent", "level": 4 }, { "id": "state--composer--2-of-5--product-graph", "anchor": "state--composer--2-of-5--product-graph", "title": "STATE · Composer · 2 of 5 · Product Graph", "level": 4 }, { "id": "state--composer--3-of-5--targets--capabilities", "anchor": "state--composer--3-of-5--targets--capabilities", "title": "STATE · Composer · 3 of 5 · Targets & Capabilities", "level": 4 }, { "id": "state--composer--4-of-5--policies", "anchor": "state--composer--4-of-5--policies", "title": "STATE · Composer · 4 of 5 · Policies", "level": 4 }, { "id": "state--composer--5-of-5--bootstrap-ready", "anchor": "state--composer--5-of-5--bootstrap-ready", "title": "STATE · Composer · 5 of 5 · Bootstrap Ready", "level": 4 }, { "id": "state--composer--provisioning--running", "anchor": "state--composer--provisioning--running", "title": "STATE · Composer · Provisioning · Running", "level": 4 }, { "id": "state--composer--provisioning--complete", "anchor": "state--composer--provisioning--complete", "title": "STATE · Composer · Provisioning · Complete", "level": 4 }, { "id": "state--composer--provisioning--failed", "anchor": "state--composer--provisioning--failed", "title": "STATE · Composer · Provisioning · Failed", "level": 4 }, { "id": "state--composer--provisioning--retry", "anchor": "state--composer--provisioning--retry", "title": "STATE · Composer · Provisioning · Retry", "level": 4 }, { "id": "state--composer--provisioning--rollback", "anchor": "state--composer--provisioning--rollback", "title": "STATE · Composer · Provisioning · Rollback", "level": 4 }, { "id": "on-the-composer-as-onboarding", "anchor": "on-the-composer-as-onboarding", "title": "On the Composer as onboarding", "level": 4 }, { "id": "on-data-authority", "anchor": "on-data-authority", "title": "On data authority", "level": 4 }, { "id": "cluster-findings-6", "anchor": "cluster-findings-6", "title": "Cluster findings", "level": 3 }, { "id": "part-11--section-1011--observe-learn-and-optimize", "anchor": "part-11--section-1011--observe-learn-and-optimize", "title": "Part 11 · Section 10–11 — Observe, Learn and Optimize", "level": 2 }, { "id": "1001--trace--runtime--spans-ebpf--evidence", "anchor": "1001--trace--runtime--spans-ebpf--evidence", "title": "10.01 · Trace + Runtime · Spans, eBPF & Evidence", "level": 4 }, { "id": "1002--observe--metrics", "anchor": "1002--observe--metrics", "title": "10.02 · Observe · Metrics", "level": 4 }, { "id": "1003--observe--profiles", "anchor": "1003--observe--profiles", "title": "10.03 · Observe · Profiles", "level": 4 }, { "id": "1004--observe--errors", "anchor": "1004--observe--errors", "title": "10.04 · Observe · Errors", "level": 4 }, { "id": "1005--observe--alerts--pipelines", "anchor": "1005--observe--alerts--pipelines", "title": "10.05 · Observe · Alerts & Pipelines", "level": 4 }, { "id": "1101--trace--product--outcomes--regressions", "anchor": "1101--trace--product--outcomes--regressions", "title": "11.01 · Trace + Product · Outcomes & Regressions", "level": 4 }, { "id": "1102--learn--cohorts--retention", "anchor": "1102--learn--cohorts--retention", "title": "11.02 · Learn · Cohorts & Retention", "level": 4 }, { "id": "1103--learn--experiments", "anchor": "1103--learn--experiments", "title": "11.03 · Learn · Experiments", "level": 4 }, { "id": "1104--optimize--costs", "anchor": "1104--optimize--costs", "title": "11.04 · Optimize · Costs", "level": 4 }, { "id": "1105--learn--reports", "anchor": "1105--learn--reports", "title": "11.05 · Learn · Reports", "level": 4 }, { "id": "cross-cutting", "anchor": "cross-cutting", "title": "Cross-cutting", "level": 3 }, { "id": "1-the-differentiation-ledger", "anchor": "1-the-differentiation-ledger", "title": "1. The differentiation ledger", "level": 4 }, { "id": "2-what-graph-native-observability-actually-looks-like", "anchor": "2-what-graph-native-observability-actually-looks-like", "title": "2. What graph-native observability actually looks like", "level": 4 }, { "id": "3-the-trace-continuum-one-surface-or-three", "anchor": "3-the-trace-continuum-one-surface-or-three", "title": "3. The trace continuum: one surface or three?", "level": 4 }, { "id": "4-should-section-11-be-demoted", "anchor": "4-should-section-11-be-demoted", "title": "4. Should Section 11 be demoted?", "level": 4 }, { "id": "cluster-findings-7", "anchor": "cluster-findings-7", "title": "Cluster findings", "level": 3 }, { "id": "missing-panes-3", "anchor": "missing-panes-3", "title": "Missing panes", "level": 4 }, { "id": "seams-3", "anchor": "seams-3", "title": "Seams", "level": 4 }, { "id": "honesty-audit-3", "anchor": "honesty-audit-3", "title": "Honesty audit", "level": 4 }, { "id": "part-12--section-13--runtime-and-extensibility", "anchor": "part-12--section-13--runtime-and-extensibility", "title": "Part 12 · Section 13 — Runtime and Extensibility", "level": 2 }, { "id": "the-evidence-template", "anchor": "the-evidence-template", "title": "The evidence template", "level": 3 }, { "id": "the-regions-1", "anchor": "the-regions-1", "title": "The regions", "level": 4 }, { "id": "mandatory-versus-optional-1", "anchor": "mandatory-versus-optional-1", "title": "Mandatory versus optional", "level": 4 }, { "id": "the-four-validity-rules-1", "anchor": "the-four-validity-rules-1", "title": "The four validity rules", "level": 4 }, { "id": "how-a-board-declares-its-coverage-honestly-1", "anchor": "how-a-board-declares-its-coverage-honestly-1", "title": "How a board declares its coverage honestly", "level": 4 }, { "id": "applying-the-template-to-a-new-board-tomorrow-1", "anchor": "applying-the-template-to-a-new-board-tomorrow-1", "title": "Applying the template to a new board tomorrow", "level": 4 }, { "id": "board-entries-1", "anchor": "board-entries-1", "title": "Board entries", "level": 3 }, { "id": "1301--map--runtime--system-fabric--operations", "anchor": "1301--map--runtime--system-fabric--operations", "title": "13.01 · Map + Runtime · System Fabric & Operations", "level": 4 }, { "id": "1302--trace--runtime--system-fabric-resource-explorer", "anchor": "1302--trace--runtime--system-fabric-resource-explorer", "title": "13.02 · Trace + Runtime · System Fabric Resource Explorer", "level": 4 }, { "id": "1303--extend--ffi-switchboard", "anchor": "1303--extend--ffi-switchboard", "title": "13.03 · Extend · FFI Switchboard", "level": 4 }, { "id": "1304--extend--graph-projections", "anchor": "1304--extend--graph-projections", "title": "13.04 · Extend · Graph Projections", "level": 4 }, { "id": "part-2--ffi-what-the-board-shows-against-what-the-protocol-is", "anchor": "part-2--ffi-what-the-board-shows-against-what-the-protocol-is", "title": "Part 2 — FFI: what the board shows against what the protocol is", "level": 3 }, { "id": "how-well-1303-depicts-the-real-protocol", "anchor": "how-well-1303-depicts-the-real-protocol", "title": "How well 13.03 depicts the real protocol", "level": 4 }, { "id": "the-three-genuinely-undefined-things-and-how-to-draw-them", "anchor": "the-three-genuinely-undefined-things-and-how-to-draw-them", "title": "The three genuinely undefined things, and how to draw them", "level": 4 }, { "id": "the-six-panes-a-developer-needs", "anchor": "the-six-panes-a-developer-needs", "title": "The six panes a developer needs", "level": 4 }, { "id": "part-3--graph-projections-and-code-push", "anchor": "part-3--graph-projections-and-code-push", "title": "Part 3 — Graph projections and code push", "level": 3 }, { "id": "does-1304-serve-projection", "anchor": "does-1304-serve-projection", "title": "Does 13.04 serve projection?", "level": 4 }, { "id": "does-1304-serve-code-push", "anchor": "does-1304-serve-code-push", "title": "Does 13.04 serve code push?", "level": 4 }, { "id": "what-to-build", "anchor": "what-to-build", "title": "What to build", "level": 4 }, { "id": "cluster-findings-8", "anchor": "cluster-findings-8", "title": "Cluster findings", "level": 3 }, { "id": "missing-panes-4", "anchor": "missing-panes-4", "title": "Missing panes", "level": 4 }, { "id": "seams-4", "anchor": "seams-4", "title": "Seams", "level": 4 }, { "id": "honesty-audit-4", "anchor": "honesty-audit-4", "title": "Honesty audit", "level": 4 }, { "id": "part-13--the-panes-the-atlas-needs", "anchor": "part-13--the-panes-the-atlas-needs", "title": "Part 13 · The panes the atlas needs", "level": 2 }, { "id": "tier-1--proposed-independently-by-three-or-more-analysts", "anchor": "tier-1--proposed-independently-by-three-or-more-analysts", "title": "Tier 1 — Proposed independently by three or more analysts", "level": 3 }, { "id": "tier-2--proposed-by-two-analysts-or-by-one-with-a-strong-case", "anchor": "tier-2--proposed-by-two-analysts-or-by-one-with-a-strong-case", "title": "Tier 2 — Proposed by two analysts, or by one with a strong case", "level": 3 }, { "id": "tier-3--dead-tabs-that-promise-boards-which-do-not-exist", "anchor": "tier-3--dead-tabs-that-promise-boards-which-do-not-exist", "title": "Tier 3 — Dead tabs that promise boards which do not exist", "level": 3 }, { "id": "part-14--the-taxonomy-after-revamp", "anchor": "part-14--the-taxonomy-after-revamp", "title": "Part 14 · The taxonomy after revamp", "level": 2 }, { "id": "part-15--the-seamlessness-programme", "anchor": "part-15--the-seamlessness-programme", "title": "Part 15 · The seamlessness programme", "level": 2 }, { "id": "part-16--sequencing", "anchor": "part-16--sequencing", "title": "Part 16 · Sequencing", "level": 2 }, { "id": "appendix-b--method", "anchor": "appendix-b--method", "title": "Appendix B · Method", "level": 2 }, { "id": "appendix-a--measurements", "anchor": "appendix-a--measurements", "title": "Appendix A · Measurements", "level": 2 }, { "id": "scale", "anchor": "scale", "title": "Scale", "level": 3 }, { "id": "finding-0--the-evidence-block-is-a-constant-and-it-contradicts-itself", "anchor": "finding-0--the-evidence-block-is-a-constant-and-it-contradicts-itself", "title": "Finding 0 — The evidence block is a constant, and it contradicts itself", "level": 3 }, { "id": "finding-1--the-frame-of-evidence-without-the-substance", "anchor": "finding-1--the-frame-of-evidence-without-the-substance", "title": "Finding 1 — The frame of evidence without the substance", "level": 3 }, { "id": "finding-2--time-is-the-broken-invariant", "anchor": "finding-2--time-is-the-broken-invariant", "title": "Finding 2 — Time is the broken invariant", "level": 3 }, { "id": "finding-3--confident-fiction", "anchor": "finding-3--confident-fiction", "title": "Finding 3 — Confident fiction", "level": 3 }, { "id": "finding-4--the-assurance-vocabulary-is-absent", "anchor": "finding-4--the-assurance-vocabulary-is-absent", "title": "Finding 4 — The assurance vocabulary is absent", "level": 3 }, { "id": "finding-4b--which-of-reaktors-load-bearing-ideas-the-atlas-actually-depicts", "anchor": "finding-4b--which-of-reaktors-load-bearing-ideas-the-atlas-actually-depicts", "title": "Finding 4b — Which of Reaktor's load-bearing ideas the atlas actually depicts", "level": 3 }, { "id": "finding-5--redundancy", "anchor": "finding-5--redundancy", "title": "Finding 5 — Redundancy", "level": 3 }, { "id": "finding-6--thin-boards", "anchor": "finding-6--thin-boards", "title": "Finding 6 — Thin boards", "level": 3 }, { "id": "method-note", "anchor": "method-note", "title": "Method note", "level": 3 }, { "id": "appendix-b--method-1", "anchor": "appendix-b--method-1", "title": "Appendix B · Method", "level": 2 } ], "links": [ { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "evidence-basis" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "evidence-basis" } ] }, { "id": "reaktor-browser-local-ai", "owner": "Codex", "kind": "control-plane", "summary": "How Chrome built-in Gemini Nano APIs and WebLLM provide local AI capabilities for docs, graph explanations, workbench suggestions, and draft graph operations.", "use": "Use before adding WebLLM, Chrome built-in AI, or browser-local model providers to Reaktor Web, docs, or workbench surfaces.", "region": "agents-in-products", "order": 2, "title": "Browser-Local AI for Reaktor", "nav": "Browser-Local AI", "group": "agents", "subsection": "agents-in-products", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-browser-local-ai", "revision": "6b9788db10223d4e17b198d2eac1fc07924c1ce3d88393d0ac7a5dc0f6f903a1", "status": "design", "renderingRevision": "794446f7d4d5736bfdad8ec607f93115279bd77611258d9146173c108e324560", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developer.chrome.com/docs/ai/built-in", "https://developer.chrome.com/docs/ai/get-started", "https://developer.chrome.com/docs/ai/built-in-apis", "https://developer.chrome.com/docs/ai/prompt-api", "https://developer.chrome.com/docs/ai/summarizer-api", "https://developer.chrome.com/docs/ai/translator-api", "https://developer.chrome.com/docs/ai/language-detection", "https://webllm.mlc.ai/docs/", "https://github.com/mlc-ai/web-llm" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai", "polarity": "Neutral" }, { "id": "section-verdict", "anchor": "verdict", "label": "1. Verdict", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#verdict", "polarity": "Neutral" }, { "id": "section-providers", "anchor": "providers", "label": "2. Two provider families", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#providers", "polarity": "Neutral" }, { "id": "section-functionality", "anchor": "functionality", "label": "3. Where it helps Reaktor", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#functionality", "polarity": "Neutral" }, { "id": "section-graph-representation", "anchor": "graph-representation", "label": "4. Graph representation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#graph-representation", "polarity": "Neutral" }, { "id": "section-selection", "anchor": "selection", "label": "5. Provider selection policy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#selection", "polarity": "Neutral" }, { "id": "section-security", "anchor": "security", "label": "6. Security and permission model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#security", "polarity": "Neutral" }, { "id": "section-visual-language", "anchor": "visual-language", "label": "3.3 Reaktor visual language", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#visual-language", "polarity": "Neutral" }, { "id": "section-evaluation", "anchor": "evaluation", "label": "7. Evaluation and telemetry", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#evaluation", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "11. See also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#see-also", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-browser-local-ai#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-browser-local-ai:references-documentation-library-manna-questions-and-pdf-editions", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "page", "role": "source", "ordinal": 0 }, { "node": "documentation-library", "port": "section-manna-questions-and-pdf-editions", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-visual-language", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-evaluation", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-reaktor-capability", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-performance-observability", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-security-plan", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-browser-local-ai:references-documentation-library", "kind": "references", "owner": "reaktor-browser-local-ai", "incidences": [ { "node": "reaktor-browser-local-ai", "port": "page", "role": "source", "ordinal": 0 }, { "node": "documentation-library", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-browser-local-ai.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Browser-Local AI for Reaktor", "level": 0 }, { "id": "verdict", "anchor": "verdict", "title": "1. Verdict", "level": 2 }, { "id": "providers", "anchor": "providers", "title": "2. Two provider families", "level": 2 }, { "id": "chrome-built-in-ai", "anchor": "chrome-built-in-ai", "title": "2.1 Chrome built-in AI / Gemini Nano", "level": 3 }, { "id": "webllm", "anchor": "webllm", "title": "2.2 WebLLM / MLC WebLLM", "level": 3 }, { "id": "functionality", "anchor": "functionality", "title": "3. Where it helps Reaktor", "level": 2 }, { "id": "docs-assistant", "anchor": "docs-assistant", "title": "3.1 Retired documentation experiment", "level": 3 }, { "id": "graph-workbench", "anchor": "graph-workbench", "title": "3.2 Reaktor graph and workbench", "level": 3 }, { "id": "visual-language", "anchor": "visual-language", "title": "3.3 Reaktor visual language", "level": 3 }, { "id": "apps", "anchor": "apps", "title": "3.4 BestBuds and Reaktor apps", "level": 3 }, { "id": "context-compression", "anchor": "context-compression", "title": "3.5 Local context compression before cloud agents", "level": 3 }, { "id": "graph-representation", "anchor": "graph-representation", "title": "4. Graph representation", "level": 2 }, { "id": "provider-nodes", "anchor": "provider-nodes", "title": "4.1 Provider nodes", "level": 3 }, { "id": "capability-nodes", "anchor": "capability-nodes", "title": "4.2 Capability nodes and ports", "level": 3 }, { "id": "kotlin-first", "anchor": "kotlin-first", "title": "4.3 Kotlin-first declaration shape", "level": 3 }, { "id": "selection", "anchor": "selection", "title": "5. Provider selection policy", "level": 2 }, { "id": "security", "anchor": "security", "title": "6. Security and permission model", "level": 2 }, { "id": "evaluation", "anchor": "evaluation", "title": "7. Evaluation and telemetry", "level": 2 }, { "id": "limitations", "anchor": "limitations", "title": "8. Limitations", "level": 2 }, { "id": "implementation-plan", "anchor": "implementation-plan", "title": "9. Implementation plan", "level": 2 }, { "id": "p0---historical-docs-assistant", "anchor": "p0---historical-docs-assistant", "title": "P0 - historical docs assistant", "level": 3 }, { "id": "p1---provider-abstraction", "anchor": "p1---provider-abstraction", "title": "P1 - provider abstraction", "level": 3 }, { "id": "p2---graph-explanation", "anchor": "p2---graph-explanation", "title": "P2 - graph explanation", "level": 3 }, { "id": "p3---draft-graph-patches", "anchor": "p3---draft-graph-patches", "title": "P3 - draft graph patches", "level": 3 }, { "id": "p4---local-context-compressor", "anchor": "p4---local-context-compressor", "title": "P4 - local context compressor", "level": 3 }, { "id": "p5---app-facing-local-ai", "anchor": "p5---app-facing-local-ai", "title": "P5 - app-facing local AI", "level": 3 }, { "id": "open-questions", "anchor": "open-questions", "title": "10. Open questions", "level": 2 }, { "id": "see-also", "anchor": "see-also", "title": "11. See also", "level": 2 }, { "id": "references", "anchor": "references", "title": "12. External references", "level": 2 }, { "id": "lineage", "anchor": "lineage", "title": "13. Doc lineage", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "documentation-library", "anchor": "manna-questions-and-pdf-editions", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "visual-language" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "evaluation" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-build-tools", "owner": "Codex", "kind": "build-tools", "summary": "The plain-language map for the current Reaktor and BestBuds build toolchain: what Dependeasy owns, what Reaktor CLI reads today, where build/deploy work is duplicated, and which adapters should be added next.", "use": "Read before changing Dependeasy, Reaktor CLI, build/test/deploy scripts, docs deployment, Gradle/Vite/CMake speed work, tool adapters, security scanners, or the task catalog shown to humans and agents.", "region": "ship-toolchain", "order": 0, "title": "Reaktor Build Tools", "nav": "Build Tools", "group": "ship", "subsection": "ship-toolchain", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-build-tools", "revision": "a0a6a6750263294a636978a5ea6c360b871a7ffdd08c31051c1da448b0a8f335", "status": "unverified", "renderingRevision": "66ff22c724270ddf424d782ae89f9449f7faa829a1c943a34f0cf0f3f3bd6076", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-build-tools", "polarity": "Neutral" }, { "id": "section-split", "anchor": "split", "label": "The Split", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-build-tools#split", "polarity": "Neutral" }, { "id": "section-today", "anchor": "today", "label": "What Exists Today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-build-tools#today", "polarity": "Neutral" }, { "id": "section-cli-today", "anchor": "cli-today", "label": "What Reaktor CLI Does Today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-build-tools#cli-today", "polarity": "Neutral" }, { "id": "section-dependeasy-today", "anchor": "dependeasy-today", "label": "What Dependeasy Owns Today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-build-tools#dependeasy-today", "polarity": "Neutral" }, { "id": "section-build-speed", "anchor": "build-speed", "label": "Build and Deployment Speed", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-build-tools#build-speed", "polarity": "Neutral" }, { "id": "section-manifest", "anchor": "manifest", "label": "The Missing Manifest", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-build-tools#manifest", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-build-tools:references-reaktor-dependeasy", "kind": "references", "owner": "reaktor-build-tools", "incidences": [ { "node": "reaktor-build-tools", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-dependeasy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-build-tools:references-reaktor-cli", "kind": "references", "owner": "reaktor-build-tools", "incidences": [ { "node": "reaktor-build-tools", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-build-tools:references-reaktor-devops", "kind": "references", "owner": "reaktor-build-tools", "incidences": [ { "node": "reaktor-build-tools", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-build-tools.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Build Tools", "level": 0 }, { "id": "split", "anchor": "split", "title": "The Split", "level": 2 }, { "id": "today", "anchor": "today", "title": "What Exists Today", "level": 2 }, { "id": "build-and-language-tools", "anchor": "build-and-language-tools", "title": "Build and language tools", "level": 3 }, { "id": "native-and-mobile-tools", "anchor": "native-and-mobile-tools", "title": "Native and mobile tools", "level": 3 }, { "id": "web-and-worker-tools", "anchor": "web-and-worker-tools", "title": "Web and Worker tools", "level": 3 }, { "id": "test-performance-and-replay-tools", "anchor": "test-performance-and-replay-tools", "title": "Test, performance, and replay tools", "level": 3 }, { "id": "deploy-cloud-and-operations-tools", "anchor": "deploy-cloud-and-operations-tools", "title": "Deploy, cloud, and operations tools", "level": 3 }, { "id": "security-tools-to-add", "anchor": "security-tools-to-add", "title": "Security tools to add", "level": 3 }, { "id": "cli-today", "anchor": "cli-today", "title": "What Reaktor CLI Does Today", "level": 2 }, { "id": "dependeasy-today", "anchor": "dependeasy-today", "title": "What Dependeasy Owns Today", "level": 2 }, { "id": "build-speed", "anchor": "build-speed", "title": "Build and Deployment Speed", "level": 2 }, { "id": "patterns-found-in-the-current-tree", "anchor": "patterns-found-in-the-current-tree", "title": "Patterns Found In The Current Tree", "level": 3 }, { "id": "duplicate-work-to-remove-first", "anchor": "duplicate-work-to-remove-first", "title": "Duplicate Work To Remove First", "level": 3 }, { "id": "gradle-and-kmp-speed-practices", "anchor": "gradle-and-kmp-speed-practices", "title": "Gradle And KMP Speed Practices", "level": 3 }, { "id": "vite-and-web-speed-practices", "anchor": "vite-and-web-speed-practices", "title": "Vite And Web Speed Practices", "level": 3 }, { "id": "cmake-and-native-speed-practices", "anchor": "cmake-and-native-speed-practices", "title": "CMake And Native Speed Practices", "level": 3 }, { "id": "deployment-speed-practices", "anchor": "deployment-speed-practices", "title": "Deployment Speed Practices", "level": 3 }, { "id": "highest-priority-features", "anchor": "highest-priority-features", "title": "Highest Priority Features", "level": 3 }, { "id": "manifest", "anchor": "manifest", "title": "The Missing Manifest", "level": 2 }, { "id": "dsl-rule", "anchor": "dsl-rule", "title": "The DSL Rule", "level": 2 }, { "id": "adapters", "anchor": "adapters", "title": "Tool Adapters To Build", "level": 2 }, { "id": "1-fact-adapters", "anchor": "1-fact-adapters", "title": "1. Fact adapters", "level": 3 }, { "id": "2-report-adapters", "anchor": "2-report-adapters", "title": "2. Report adapters", "level": 3 }, { "id": "3-operation-adapters", "anchor": "3-operation-adapters", "title": "3. Operation adapters", "level": 3 }, { "id": "feel", "anchor": "feel", "title": "How It Should Feel", "level": 2 }, { "id": "priority-plan", "anchor": "priority-plan", "title": "Priority Plan", "level": 2 } ], "links": [ { "id": "reaktor-dependeasy", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "" } ] }, { "id": "reaktor-bus-mesh", "owner": "Codex", "kind": "design", "summary": "Source of truth for Reaktor's durable async delivery fabric: typed envelopes, routing, GCP Pub/Sub, Cloudflare Queues, outbox, idempotent consumers, DLQ, replay, graph projection, and the boundary to service, work, mesh, and distributed actors.", "use": "Use before designing queue/pubsub delivery, service-to-service async work, event fanout, outbox relays, DLQ replay, Cloudflare Queues, GCP Pub/Sub, or graph projection for topics, queues, consumers, and delivery policies.", "region": "data-delivery", "order": 0, "title": "Reaktor Bus", "nav": "Bus", "group": "data", "subsection": "data-delivery", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-bus-mesh", "revision": "da64b59d0050dd72142f6acb155af6c247208580c5f6f0128a8174ded7ef40b7", "status": "unverified", "renderingRevision": "f1ea46600c030404efcf987819be08698f2f7e3293fffbe4064918c8270d81d9", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developers.cloudflare.com/queues/reference/delivery-guarantees/", "https://developers.cloudflare.com/queues/reference/how-queues-works/", "https://developers.cloudflare.com/queues/platform/limits/", "https://cloud.google.com/pubsub/docs/overview", "https://cloud.google.com/pubsub/docs/subscription-retry-policy", "https://cloud.google.com/pubsub/docs/dead-letter-topics", "https://cloud.google.com/pubsub/docs/ordering", "https://cloud.google.com/pubsub/docs/exactly-once-delivery", "https://cloud.google.com/pubsub/docs/schemas", "https://cloud.google.com/pubsub/quotas", "https://developers.cloudflare.com/queues/configuration/javascript-apis/", "https://developers.cloudflare.com/queues/configuration/batching-retries/", "https://developers.cloudflare.com/queues/configuration/dead-letter-queues/", "https://developers.cloudflare.com/queues/configuration/pull-consumers/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-bus-mesh", "polarity": "Neutral" }, { "id": "section-operating-model", "anchor": "operating-model", "label": "1. Operating Model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#operating-model", "polarity": "Neutral" }, { "id": "section-boundaries", "anchor": "boundaries", "label": "2. Boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#boundaries", "polarity": "Neutral" }, { "id": "section-queue-vs-pubsub", "anchor": "queue-vs-pubsub", "label": "3. Queue vs Pub/Sub", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#queue-vs-pubsub", "polarity": "Neutral" }, { "id": "section-provider-contract-matrix", "anchor": "provider-contract-matrix", "label": "4. Provider Contract Matrix", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#provider-contract-matrix", "polarity": "Neutral" }, { "id": "section-contract", "anchor": "contract", "label": "5. Bus Envelope", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#contract", "polarity": "Neutral" }, { "id": "section-api", "anchor": "api", "label": "6. Bus API", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#api", "polarity": "Neutral" }, { "id": "section-related", "anchor": "related", "label": "Related Docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#related", "polarity": "Neutral" }, { "id": "section-provider-contract-and-current-limits", "anchor": "provider-contract-and-current-limits", "label": "Provider contract and current limits", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-bus-mesh#provider-contract-and-current-limits", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-bus-mesh:references-reaktor-db-realtime", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-realtime", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-service", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-mesh", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-boundaries", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-data-workflows-queues", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-provider-contract-and-current-limits", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-queues", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-data-workflows-queue-workflow", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-provider-contract-and-current-limits", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-queue-workflow", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-work", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-server", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-notifications-design", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-bus-mesh:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-bus-mesh", "incidences": [ { "node": "reaktor-bus-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-bus-mesh.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Bus", "level": 0 }, { "id": "operating-model", "anchor": "operating-model", "title": "1. Operating Model", "level": 2 }, { "id": "boundaries", "anchor": "boundaries", "title": "2. Boundaries", "level": 2 }, { "id": "queue-vs-pubsub", "anchor": "queue-vs-pubsub", "title": "3. Queue vs Pub/Sub", "level": 2 }, { "id": "pubsub", "anchor": "pubsub", "title": "Pub/Sub", "level": 3 }, { "id": "queue", "anchor": "queue", "title": "Queue", "level": 3 }, { "id": "provider-contract-matrix", "anchor": "provider-contract-matrix", "title": "4. Provider Contract Matrix", "level": 2 }, { "id": "contract", "anchor": "contract", "title": "5. Bus Envelope", "level": 2 }, { "id": "api", "anchor": "api", "title": "6. Bus API", "level": 2 }, { "id": "route-policy", "anchor": "route-policy", "title": "7. Route Policy", "level": 2 }, { "id": "gcp-pubsub", "anchor": "gcp-pubsub", "title": "8. GCP Pub/Sub Binding", "level": 2 }, { "id": "existing-reaktor-surface", "anchor": "existing-reaktor-surface", "title": "Existing Reaktor Surface", "level": 3 }, { "id": "provider-facts-to-encode", "anchor": "provider-facts-to-encode", "title": "Provider Facts To Encode", "level": 3 }, { "id": "envelope-mapping", "anchor": "envelope-mapping", "title": "Envelope Mapping", "level": 3 }, { "id": "consumer-outcome-mapping", "anchor": "consumer-outcome-mapping", "title": "Consumer Outcome Mapping", "level": 3 }, { "id": "pubsub-route-defaults", "anchor": "pubsub-route-defaults", "title": "Pub/Sub Route Defaults", "level": 3 }, { "id": "cloudflare-queues", "anchor": "cloudflare-queues", "title": "9. Cloudflare Queues Binding", "level": 2 }, { "id": "provider-contract-and-current-limits", "anchor": "provider-contract-and-current-limits", "title": "Provider contract and current limits", "level": 3 }, { "id": "reaktor-cloudflare-surface", "anchor": "reaktor-cloudflare-surface", "title": "Reaktor Cloudflare Surface", "level": 3 }, { "id": "consumer-outcome-mapping-1", "anchor": "consumer-outcome-mapping-1", "title": "Consumer Outcome Mapping", "level": 3 }, { "id": "cloudflare-queue-route-defaults", "anchor": "cloudflare-queue-route-defaults", "title": "Cloudflare Queue Route Defaults", "level": 3 }, { "id": "realtime-boundary", "anchor": "realtime-boundary", "title": "10. Reaktor Realtime Is Mesh, Not Bus", "level": 2 }, { "id": "claim-check", "anchor": "claim-check", "title": "11. Claim-Check Policy", "level": 2 }, { "id": "idempotency", "anchor": "idempotency", "title": "12. Idempotency And Dedup", "level": 2 }, { "id": "outbox", "anchor": "outbox", "title": "13. Outbox", "level": 2 }, { "id": "dlq", "anchor": "dlq", "title": "14. DLQ And Replay", "level": 2 }, { "id": "schema", "anchor": "schema", "title": "15. Schema And Compatibility", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "16. Graph Projection", "level": 2 }, { "id": "observability", "anchor": "observability", "title": "17. Observability", "level": 2 }, { "id": "module-plan", "anchor": "module-plan", "title": "18. Module Plan", "level": 2 }, { "id": "acceptance-tests", "anchor": "acceptance-tests", "title": "19. Acceptance Tests", "level": 2 }, { "id": "rough-edges", "anchor": "rough-edges", "title": "20. Rough Edges", "level": 2 }, { "id": "provider-references", "anchor": "provider-references", "title": "21. Provider References", "level": 2 }, { "id": "related", "anchor": "related", "title": "Related Docs", "level": 2 } ], "links": [ { "id": "reaktor-db", "anchor": "realtime", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "boundaries" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "provider-contract-matrix" }, { "id": "reaktor-data-workflows", "anchor": "queues", "relation": "references", "sourceAnchor": "provider-contract-and-current-limits" }, { "id": "reaktor-data-workflows", "anchor": "queue-workflow", "relation": "references", "sourceAnchor": "provider-contract-and-current-limits" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "realtime-boundary" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related" } ] }, { "id": "reaktor-capability", "owner": "Codex", "kind": "module", "summary": "Environment snapshots, capability profiles, strategy selection, and degradation tiers.", "use": "Use before branching behavior by platform, device, network, permission, or renderer state.", "region": "framework-foundations", "order": 1, "title": "reaktor-capability", "nav": "Capability Runtime", "group": "framework", "subsection": "framework-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-capability", "revision": "962002fefbd69ad9d9904bc9c579eae13b357536448a4ba5dc328c090e9ffb5a", "status": "unverified", "renderingRevision": "1828dc262a9b8525a4780dbc680ef5890037501662133d46e2e3b27174f4269e", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-capability", "polarity": "Neutral" }, { "id": "section-verdict", "anchor": "verdict", "label": "Verdict", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-capability#verdict", "polarity": "Neutral" }, { "id": "section-scanned", "anchor": "scanned", "label": "Source scan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-capability#scanned", "polarity": "Neutral" }, { "id": "section-boundaries", "anchor": "boundaries", "label": "Concept boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-capability#boundaries", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "Public model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-capability#model", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "Runtime architecture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-capability#architecture", "polarity": "Neutral" }, { "id": "section-strategy", "anchor": "strategy", "label": "Strategy selection", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-capability#strategy", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-capability#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-capability:references-reaktor-core", "kind": "references", "owner": "reaktor-capability", "incidences": [ { "node": "reaktor-capability", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-capability:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-capability", "incidences": [ { "node": "reaktor-capability", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-capability:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "reaktor-capability", "incidences": [ { "node": "reaktor-capability", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-capability:references-performance-observability", "kind": "references", "owner": "reaktor-capability", "incidences": [ { "node": "reaktor-capability", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-capability:references-reaktor-server", "kind": "references", "owner": "reaktor-capability", "incidences": [ { "node": "reaktor-capability", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-capability.json", "sections": [ { "id": "preamble", "anchor": "", "title": "reaktor-capability", "level": 0 }, { "id": "verdict", "anchor": "verdict", "title": "Verdict", "level": 2 }, { "id": "keep-the-api-small", "anchor": "keep-the-api-small", "title": "Keep the API small", "level": 3 }, { "id": "normalize-for-privacy", "anchor": "normalize-for-privacy", "title": "Normalize for privacy", "level": 3 }, { "id": "make-degradation-visible", "anchor": "make-degradation-visible", "title": "Make degradation visible", "level": 3 }, { "id": "scanned", "anchor": "scanned", "title": "Source scan", "level": 2 }, { "id": "boundaries", "anchor": "boundaries", "title": "Concept boundaries", "level": 2 }, { "id": "model", "anchor": "model", "title": "Public model", "level": 2 }, { "id": "model-2", "anchor": "model-2", "title": "Environment snapshots", "level": 3 }, { "id": "stable-public-buckets", "anchor": "stable-public-buckets", "title": "Stable public buckets", "level": 3 }, { "id": "private-raw-facts", "anchor": "private-raw-facts", "title": "Private raw facts", "level": 3 }, { "id": "architecture", "anchor": "architecture", "title": "Runtime architecture", "level": 2 }, { "id": "architecture-2", "anchor": "architecture-2", "title": "Collector contracts", "level": 3 }, { "id": "strategy", "anchor": "strategy", "title": "Strategy selection", "level": 2 }, { "id": "strategy-2", "anchor": "strategy-2", "title": "Representative degradation paths", "level": 3 }, { "id": "integration", "anchor": "integration", "title": "Module integration", "level": 2 }, { "id": "desktop", "anchor": "desktop", "title": "Visual plane in reaktorDesktop", "level": 2 }, { "id": "desktop-2", "anchor": "desktop-2", "title": "What the visual plane should show", "level": 3 }, { "id": "graph-overlay", "anchor": "graph-overlay", "title": "Graph overlay", "level": 3 }, { "id": "inspector-panel", "anchor": "inspector-panel", "title": "Inspector panel", "level": 3 }, { "id": "environment-controls", "anchor": "environment-controls", "title": "Environment controls", "level": 3 }, { "id": "decision-timeline", "anchor": "decision-timeline", "title": "Decision timeline", "level": 3 }, { "id": "desktop-3", "anchor": "desktop-3", "title": "Workbench data additions", "level": 3 }, { "id": "phases", "anchor": "phases", "title": "Build phases", "level": 2 }, { "id": "testing", "anchor": "testing", "title": "Testing and performance", "level": 2 }, { "id": "testing-2", "anchor": "testing-2", "title": "Runtime constraints", "level": 3 }, { "id": "decisions", "anchor": "decisions", "title": "Open decisions", "level": 2 }, { "id": "graph-dependency-boundary", "anchor": "graph-dependency-boundary", "title": "Graph dependency boundary", "level": 3 }, { "id": "policy-source-of-truth", "anchor": "policy-source-of-truth", "title": "Policy source of truth", "level": 3 }, { "id": "permission-prompts", "anchor": "permission-prompts", "title": "Permission prompts", "level": 3 }, { "id": "server-capability-shape", "anchor": "server-capability-shape", "title": "Server capability shape", "level": 3 }, { "id": "decision-history-retention", "anchor": "decision-history-retention", "title": "Decision history retention", "level": 3 }, { "id": "generated-ui-grants", "anchor": "generated-ui-grants", "title": "Generated UI grants", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-cli", "owner": "Claude", "kind": "build-tools", "summary": "The terminal face of the Reaktor task catalog: a Kotlin CLI that discovers targets, Gradle modules, npm scripts, tool families, logs, deploys, tests, and doctor checks from the current project.", "use": "Use after the Build Tools map when changing the CLI command tree, project discovery, task routing, install flow, or the bridge from current project files to future Dependeasy facts.", "region": "ship-toolchain", "order": 2, "title": "Reaktor CLI — one command line for every reaktor app", "nav": "CLI", "group": "ship", "subsection": "ship-toolchain", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-cli", "revision": "e45bc8e7c8814d8712a6cf017d562f590fb76989906329c6856fda9af3a65679", "status": "unverified", "renderingRevision": "e2f17b75e38efdbe0cb5a5e7d4ad2f9f434d600b0fda9f0b784e249c384e7de3", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://github.com/ajalt/mordant" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-cli", "polarity": "Neutral" }, { "id": "section-why", "anchor": "why", "label": "1. Why a CLI — and why it is a framework tool", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#why", "polarity": "Neutral" }, { "id": "section-decision", "anchor": "decision", "label": "2. The framework choice — Clikt, not oclif", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#decision", "polarity": "Neutral" }, { "id": "section-commands", "anchor": "commands", "label": "3. The command surface", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#commands", "polarity": "Neutral" }, { "id": "section-discovery", "anchor": "discovery", "label": "4. Project discovery & extensibility", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#discovery", "polarity": "Neutral" }, { "id": "section-design", "anchor": "design", "label": "5. Concrete Clikt design", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#design", "polarity": "Neutral" }, { "id": "section-install", "anchor": "install", "label": "6. Self-install — reaktor install", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#install", "polarity": "Neutral" }, { "id": "section-bestbuds", "anchor": "bestbuds", "label": "10. bestbuds as the first consumer — a migration example", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#bestbuds", "polarity": "Neutral" }, { "id": "section-dist", "anchor": "dist", "label": "8. Distribution & startup", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#dist", "polarity": "Neutral" }, { "id": "section-fit", "anchor": "fit", "label": "9. How it fits the reaktor ecosystem", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#fit", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cli#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-cli:references-reaktor-build-tools", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-why", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-why", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-core", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-discovery", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-devops", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-design", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-auth-analysis", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-fit", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-fit", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-fit", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-security-plan", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-gemini-devops-agent", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-gemini-devops-agent", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cli:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-cli", "incidences": [ { "node": "reaktor-cli", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-cli.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor CLI — one command line for every reaktor app", "level": 0 }, { "id": "why", "anchor": "why", "title": "1. Why a CLI — and why it is a framework tool", "level": 2 }, { "id": "decision", "anchor": "decision", "title": "2. The framework choice — Clikt, not oclif", "level": 2 }, { "id": "commands", "anchor": "commands", "title": "3. The command surface", "level": 2 }, { "id": "discovery", "anchor": "discovery", "title": "4. Project discovery & extensibility", "level": 2 }, { "id": "design", "anchor": "design", "title": "5. Concrete Clikt design", "level": 2 }, { "id": "install", "anchor": "install", "title": "6. Self-install — reaktor install", "level": 2 }, { "id": "output", "anchor": "output", "title": "7. Rich terminal output — Mordant", "level": 2 }, { "id": "dist", "anchor": "dist", "title": "8. Distribution & startup", "level": 2 }, { "id": "fit", "anchor": "fit", "title": "9. How it fits the reaktor ecosystem", "level": 2 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "10. bestbuds as the first consumer — a migration example", "level": 2 }, { "id": "phases", "anchor": "phases", "title": "11. Build plan & status", "level": 2 }, { "id": "open", "anchor": "open", "title": "12. Open decisions", "level": 2 }, { "id": "references", "anchor": "references", "title": "13. References", "level": 2 }, { "id": "see-also", "anchor": "see-also", "title": "See also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cli", "anchor": "bestbuds", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cli", "anchor": "decision", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cli", "anchor": "discovery", "relation": "references", "sourceAnchor": "why" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "why" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "why" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "discovery" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "design" }, { "id": "reaktor-cli", "anchor": "design", "relation": "references", "sourceAnchor": "output" }, { "id": "reaktor-cli", "anchor": "design", "relation": "references", "sourceAnchor": "output" }, { "id": "reaktor-cli", "anchor": "dist", "relation": "references", "sourceAnchor": "output" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "fit" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "fit" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "fit" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "fit" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "fit" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "fit" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "fit" }, { "id": "reaktor-cli", "anchor": "decision", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-gemini-devops-agent", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-cloud-pane", "owner": "Codex", "kind": "ops", "summary": "GCP-first cloud control plane for regional k3s cells: Reaktor-managed capacity billed through Reaktor, customer-owned GCP cells managed through reaktor-agent, typed fleet operations, Dagger/Pulumi execution, and no scattered provider auth or Node sidecar.", "use": "Use when building the operator view over Reaktor-managed GCP capacity, customer-owned GCP cluster attachment, cloud resources, cell operations, and tool execution.", "region": "ship-cloud", "order": 0, "title": "Reaktor Cloud Control Plane", "nav": "Cloud Control Plane", "group": "ship", "subsection": "ship-cloud", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-cloud-pane", "revision": "97c1f5f408b5917e6100e4008619119b68fe1f55a79a35c42c6ca2c11ba474e8", "status": "unverified", "renderingRevision": "50cc13abb994cbd713eab37a4a4bf5234494fa41c2ec86a19e597886a7ff04b0", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-cloud-pane", "polarity": "Neutral" }, { "id": "section-core", "anchor": "core", "label": "1. The Core Decision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud-pane#core", "polarity": "Neutral" }, { "id": "section-planes", "anchor": "planes", "label": "2. Control Plane And Cells", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud-pane#planes", "polarity": "Neutral" }, { "id": "section-reaktor-managed", "anchor": "reaktor-managed", "label": "3. Reaktor-Managed GCP Cells", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud-pane#reaktor-managed", "polarity": "Neutral" }, { "id": "section-byo-gcp", "anchor": "byo-gcp", "label": "4. Customer-Owned GCP Cells", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud-pane#byo-gcp", "polarity": "Neutral" }, { "id": "section-agent", "anchor": "agent", "label": "4. reaktor-agent", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud-pane#agent", "polarity": "Neutral" }, { "id": "section-operations", "anchor": "operations", "label": "5. Operations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud-pane#operations", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related Docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud-pane#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-cloud-pane:references-shadow-workspaces", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-operations-observability", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-reaktor-cloud", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-reaktor-devops", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-reaktor-service", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-auth-analysis", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-performance-observability", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud-pane:references-secrets-management", "kind": "references", "owner": "reaktor-cloud-pane", "incidences": [ { "node": "reaktor-cloud-pane", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-cloud-pane.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Cloud Control Plane", "level": 0 }, { "id": "core", "anchor": "core", "title": "1. The Core Decision", "level": 2 }, { "id": "planes", "anchor": "planes", "title": "2. Control Plane And Cells", "level": 2 }, { "id": "cell-shape", "anchor": "cell-shape", "title": "2.1 Cell Shape", "level": 3 }, { "id": "cluster-interaction", "anchor": "cluster-interaction", "title": "2.2 How Clusters Interact", "level": 3 }, { "id": "capacity-vs-location", "anchor": "capacity-vs-location", "title": "2.3 Same Region vs New Location", "level": 3 }, { "id": "reaktor-managed", "anchor": "reaktor-managed", "title": "3. Reaktor-Managed GCP Cells", "level": 2 }, { "id": "byo-gcp", "anchor": "byo-gcp", "title": "4. Customer-Owned GCP Cells", "level": 2 }, { "id": "attach-flow", "anchor": "attach-flow", "title": "3.1 Attachment Flow", "level": 3 }, { "id": "connection-model", "anchor": "connection-model", "title": "3.2 Connection Model", "level": 3 }, { "id": "modes", "anchor": "modes", "title": "3.3 Operating Modes", "level": 3 }, { "id": "agent", "anchor": "agent", "title": "4. reaktor-agent", "level": 2 }, { "id": "operations", "anchor": "operations", "title": "5. Operations", "level": 2 }, { "id": "tooling", "anchor": "tooling", "title": "6. Tool Execution Boundary", "level": 2 }, { "id": "interceptors", "anchor": "interceptors", "title": "7. Interceptors And Auth", "level": 2 }, { "id": "pane", "anchor": "pane", "title": "8. Control Plane UI", "level": 2 }, { "id": "multitenancy", "anchor": "multitenancy", "title": "9. Multitenancy Link", "level": 2 }, { "id": "plan", "anchor": "plan", "title": "10. Build Plan", "level": 2 }, { "id": "risks", "anchor": "risks", "title": "11. Risks And Guardrails", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related Docs", "level": 2 } ], "links": [ { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-cloud", "owner": "Claude", "kind": "architecture", "summary": "The workbench pane that reads Cloudflare, Google Cloud and the Kubernetes cluster through the control plane, joins them with what the repository declares, and shows one graph from hostname to machine: a map drawn by the Graph pane's renderer, one frame per service packed to the window's shape, with neighbourhoods and paths, provider tabs, findings with evidence, drift, a change timeline, cost quantities and MCP reads for agents; and every operation of the Cloudflare, Supabase and Google Cloud APIs, read from the providers' own descriptions and callable from Hangar and the agent door, with changes behind approval. Compared with Headlamp, App Hub, CloudWatch Application Signals, Wiz, Komodor, CloudQuery and OpenCost.", "use": "Read before changing the Cloud pane, the cloud readers or the cloud API layer in reaktor-tooling, or the audit rules. Section 1 is the architecture and how providers are joined, section 2 the views including Cloud APIs, section 3 the findings, section 4 the agent tools, section 6 the known limits and section 8 the roadmap ordered by value.", "region": "workbench-surfaces", "order": 4, "title": "Reaktor Cloud", "nav": "Cloud", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-cloud", "revision": "a48af5adee1dce92752ee2ffe74d811525b2bf49b2c6d0e234fbe029bd0b2e4e", "status": "unverified", "renderingRevision": "4768542aa0a869a6326d964d5ce20f043577b81986b43cde0154f48e68cc4f91", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://github.com/cloudflare/api-schemas", "https://api.supabase.com/api/v1-json", "https://discovery.googleapis.com/discovery/v1/apis", "https://headlamp.dev/blog/2025/01/17/making-sense-of-kubernetes-with-headlamps-map-view/", "https://docs.cloud.google.com/app-hub/docs/overview", "https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ServiceMap.html", "https://sst.dev/docs/console/", "https://encore.dev/docs/platform/observability/encore-flow", "https://docs.cloud.google.com/recommender/docs/key-concepts", "https://www.cloudquery.io/docs/platform/features/asset-inventory", "https://www.wiz.io/blog/the-anatomy-of-a-toxic-combination-of-risk", "https://komodor.com/blog/new-feature-gain-a-system-wide-view-with-komodor-events/", "https://docs.datadoghq.com/change_tracking/", "https://docs.aws.amazon.com/resource-explorer/latest/userguide/using-search-query-syntax.html", "https://docs.jupiterone.io/j1ql", "https://docs.hava.io/diagnose/diff-view-comparing-diagrams", "https://opencost.io/docs/specification", "https://lenshq.io/blog/lens-release-march26", "https://developers.cloudflare.com/changelog/post/2025-06-03-visualize-your-worker-architecture/", "https://github.com/cartography-cncf/cartography", "https://steampipe.io/docs" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-cloud", "polarity": "Neutral" }, { "id": "section-at-a-glance", "anchor": "at-a-glance", "label": "At a glance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#at-a-glance", "polarity": "Neutral" }, { "id": "section-how-it-works", "anchor": "how-it-works", "label": "1. How it works", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#how-it-works", "polarity": "Neutral" }, { "id": "section-pane", "anchor": "pane", "label": "2. The pane", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#pane", "polarity": "Neutral" }, { "id": "section-findings", "anchor": "findings", "label": "3. Findings", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#findings", "polarity": "Neutral" }, { "id": "section-agents", "anchor": "agents", "label": "4. For coding agents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#agents", "polarity": "Neutral" }, { "id": "section-verified", "anchor": "verified", "label": "5. Checked on real accounts", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#verified", "polarity": "Neutral" }, { "id": "section-cloud-apis", "anchor": "cloud-apis", "label": "Cloud APIs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#cloud-apis", "polarity": "Neutral" }, { "id": "section-resources", "anchor": "resources", "label": "Resources", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-cloud#resources", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-cloud:references-operations", "kind": "references", "owner": "reaktor-cloud", "incidences": [ { "node": "reaktor-cloud", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud:references-shadow-workspaces", "kind": "references", "owner": "reaktor-cloud", "incidences": [ { "node": "reaktor-cloud", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud:references-operations-observability", "kind": "references", "owner": "reaktor-cloud", "incidences": [ { "node": "reaktor-cloud", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-cloud", "incidences": [ { "node": "reaktor-cloud", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud:references-reaktor-graph-pane", "kind": "references", "owner": "reaktor-cloud", "incidences": [ { "node": "reaktor-cloud", "port": "section-resources", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-cloud:references-reaktor-agent-workspace-door", "kind": "references", "owner": "reaktor-cloud", "incidences": [ { "node": "reaktor-cloud", "port": "section-agents", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "section-door", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-cloud.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Cloud", "level": 0 }, { "id": "reaktor-cloud", "anchor": "reaktor-cloud", "title": "Reaktor Cloud", "level": 1 }, { "id": "at-a-glance", "anchor": "at-a-glance", "title": "At a glance", "level": 2 }, { "id": "how-it-works", "anchor": "how-it-works", "title": "1. How it works", "level": 2 }, { "id": "pane", "anchor": "pane", "title": "2. The pane", "level": 2 }, { "id": "resources", "anchor": "resources", "title": "Resources", "level": 3 }, { "id": "operations", "anchor": "operations", "title": "Operations", "level": 3 }, { "id": "cloud-apis", "anchor": "cloud-apis", "title": "Cloud APIs", "level": 3 }, { "id": "deploy", "anchor": "deploy", "title": "Deploy", "level": 3 }, { "id": "pipeline", "anchor": "pipeline", "title": "Pipeline", "level": 3 }, { "id": "runs", "anchor": "runs", "title": "Runs", "level": 3 }, { "id": "cost", "anchor": "cost", "title": "Cost", "level": 3 }, { "id": "findings", "anchor": "findings", "title": "3. Findings", "level": 2 }, { "id": "agents", "anchor": "agents", "title": "4. For coding agents", "level": 2 }, { "id": "verified", "anchor": "verified", "title": "5. Checked on real accounts", "level": 2 }, { "id": "limits", "anchor": "limits", "title": "6. Known limits", "level": 2 }, { "id": "compare", "anchor": "compare", "title": "7. How it compares", "level": 2 }, { "id": "roadmap", "anchor": "roadmap", "title": "8. Roadmap", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cloud", "anchor": "cloud-apis", "relation": "references", "sourceAnchor": "at-a-glance" }, { "id": "reaktor-graph-pane", "anchor": "", "relation": "references", "sourceAnchor": "resources" }, { "id": "reaktor-cloud", "anchor": "agents", "relation": "references", "sourceAnchor": "cloud-apis" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "agents" } ] }, { "id": "reaktor-competitive-analysis", "owner": "Claude", "kind": "market", "summary": "Durable positioning map for Reaktor against app generators, visual builders, workflow canvases, statechart tools, Blueprints, and AI coding agents, with shipped-vs-designed status called out.", "use": "Use when clarifying Reaktor's graph-native differentiation, competitor pressure, and where to integrate instead of compete.", "region": "background-market", "order": 0, "title": "Competitive Landscape", "nav": "Competitive Landscape", "group": "background", "subsection": "background-market", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-competitive-analysis", "revision": "490ad4b6de3883b43ec42b02eb500f2028762918fbfdf16f739f4d50abc69d73", "status": "historical", "renderingRevision": "d489a780f35af8fad02b60190ef772501e7a9e8cc50aed03d8768e6f8dd29b8a", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://v0.dev/", "https://lovable.dev/", "https://bolt.new/", "https://emergent.sh/", "https://rork.com/", "https://flutterflow.io/", "https://n8n.io/", "https://stately.ai/", "https://dev.epicgames.com/documentation/en-us/unreal-engine/blueprints-visual-scripting-in-unreal-engine", "https://code.claude.com/docs/en/overview", "https://openai.com/codex/", "https://cursor.com/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis", "polarity": "Neutral" }, { "id": "section-category", "anchor": "category", "label": "1. The category Reaktor wants", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#category", "polarity": "Neutral" }, { "id": "section-landscape", "anchor": "landscape", "label": "2. Landscape map", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#landscape", "polarity": "Neutral" }, { "id": "section-comparison", "anchor": "comparison", "label": "3. The comparison that matters", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#comparison", "polarity": "Neutral" }, { "id": "section-wins", "anchor": "wins", "label": "4. Where Reaktor can win", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#wins", "polarity": "Neutral" }, { "id": "section-competitor-strengths", "anchor": "competitor-strengths", "label": "5. Where competitors are stronger today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#competitor-strengths", "polarity": "Neutral" }, { "id": "section-strategy", "anchor": "strategy", "label": "6. Strategic posture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#strategy", "polarity": "Neutral" }, { "id": "section-45-existing-system-adoption", "anchor": "45-existing-system-adoption", "label": "4.5 Existing-system adoption", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#45-existing-system-adoption", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-competitive-analysis#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-competitive-analysis:references-reaktor-framework-overview", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-category", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-category", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-reaktor-service", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-category", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-category", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-category", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-category", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-reaktor-framework-overview-bestbuds", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-category", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "section-bestbuds", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-45-existing-system-adoption", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-reaktor-megascale-strategy", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-megascale-strategy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-codex-critic-review", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "codex-critic-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-competitive-analysis:references-claude-critic-review", "kind": "references", "owner": "reaktor-competitive-analysis", "incidences": [ { "node": "reaktor-competitive-analysis", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "claude-critic-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-competitive-analysis.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Competitive Landscape", "level": 0 }, { "id": "category", "anchor": "category", "title": "1. The category Reaktor wants", "level": 2 }, { "id": "landscape", "anchor": "landscape", "title": "2. Landscape map", "level": 2 }, { "id": "comparison", "anchor": "comparison", "title": "3. The comparison that matters", "level": 2 }, { "id": "wins", "anchor": "wins", "title": "4. Where Reaktor can win", "level": 2 }, { "id": "41-full-stack-traceability", "anchor": "41-full-stack-traceability", "title": "4.1 Full-stack traceability", "level": 3 }, { "id": "42-agent-context-that-is-better-than-source-scraping", "anchor": "42-agent-context-that-is-better-than-source-scraping", "title": "4.2 Agent context that is better than source scraping", "level": 3 }, { "id": "43-visual-programming-with-code-as-truth", "anchor": "43-visual-programming-with-code-as-truth", "title": "4.3 Visual programming with code as truth", "level": 3 }, { "id": "44-whole-system-operations", "anchor": "44-whole-system-operations", "title": "4.4 Whole-system operations", "level": 3 }, { "id": "45-existing-system-adoption", "anchor": "45-existing-system-adoption", "title": "4.5 Existing-system adoption", "level": 3 }, { "id": "competitor-strengths", "anchor": "competitor-strengths", "title": "5. Where competitors are stronger today", "level": 2 }, { "id": "strategy", "anchor": "strategy", "title": "6. Strategic posture", "level": 2 }, { "id": "use-agents-do-not-fight-agents", "anchor": "use-agents-do-not-fight-agents", "title": "Use agents, do not fight agents", "level": 3 }, { "id": "borrow-visual-ux-not-no-code-positioning", "anchor": "borrow-visual-ux-not-no-code-positioning", "title": "Borrow visual UX, not no-code positioning", "level": 3 }, { "id": "treat-the-graph-as-infrastructure", "anchor": "treat-the-graph-as-infrastructure", "title": "Treat the graph as infrastructure", "level": 3 }, { "id": "product", "anchor": "product", "title": "7. Product implications", "level": 2 }, { "id": "positioning", "anchor": "positioning", "title": "8. Positioning statement", "level": 2 }, { "id": "references", "anchor": "references", "title": "9. External references checked", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "category" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "category" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "category" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "category" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "category" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "category" }, { "id": "reaktor-framework-overview", "anchor": "bestbuds", "relation": "references", "sourceAnchor": "category" }, { "id": "reaktor-framework-overview", "anchor": "bestbuds", "relation": "references", "sourceAnchor": "41-full-stack-traceability" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "42-agent-context-that-is-better-than-source-scraping" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "43-visual-programming-with-code-as-truth" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "44-whole-system-operations" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "45-existing-system-adoption" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "codex-critic-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "claude-critic-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-component-lifecycle", "owner": "Codex", "kind": "architecture", "summary": "Simple lifecycle contract across Android, iOS, browser, Worker, server, and graph-native attach, detach, activation, and port wiring events.", "use": "Use before changing Component, ControllerEvent, LifecycleCapability, Graph.attach/detach, port event handling, Worker/server wrappers, or lifecycle telemetry.", "region": "graph-model", "order": 2, "title": "Reaktor Component Lifecycle", "nav": "Component Lifecycle", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-component-lifecycle", "revision": "9f6f560ed5c1262b9db9be9a000040c3bc181d7613d67d2a322fcc553ad9ce0b", "status": "unverified", "renderingRevision": "47614b6cd89a6e714c3d17cc15169196c76fcc40b678c2b65a35daf7638435bc", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle", "polarity": "Neutral" }, { "id": "section-current-state", "anchor": "current-state", "label": "1. Current State", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle#current-state", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "2. Principles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle#principles", "polarity": "Neutral" }, { "id": "section-planes", "anchor": "planes", "label": "3. Two Planes, One Envelope", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle#planes", "polarity": "Neutral" }, { "id": "section-host-events", "anchor": "host-events", "label": "4. Host Lifecycle Events", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle#host-events", "polarity": "Neutral" }, { "id": "section-host-mapping", "anchor": "host-mapping", "label": "5. Host Mapping By Runtime", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle#host-mapping", "polarity": "Neutral" }, { "id": "section-component-api", "anchor": "component-api", "label": "6. Component API", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle#component-api", "polarity": "Neutral" }, { "id": "section-graph-events", "anchor": "graph-events", "label": "7. Graph Lifecycle Events", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-component-lifecycle#graph-events", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-component-lifecycle:references-operations-instance-diagnostics", "kind": "references", "owner": "reaktor-component-lifecycle", "incidences": [ { "node": "reaktor-component-lifecycle", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-component-lifecycle:references-shadow-clients-agents", "kind": "references", "owner": "reaktor-component-lifecycle", "incidences": [ { "node": "reaktor-component-lifecycle", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-component-lifecycle:references-reaktor-graph-protocol-events", "kind": "references", "owner": "reaktor-component-lifecycle", "incidences": [ { "node": "reaktor-component-lifecycle", "port": "section-graph-events", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-events", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-component-lifecycle.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Component Lifecycle", "level": 0 }, { "id": "current-state", "anchor": "current-state", "title": "1. Current State", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "2. Principles", "level": 2 }, { "id": "platform-erasure", "anchor": "platform-erasure", "title": "2.1 Platform adapters translate, components do not branch", "level": 3 }, { "id": "graph-native", "anchor": "graph-native", "title": "2.2 Graph lifecycle is native, not a UI afterthought", "level": 3 }, { "id": "events-context", "anchor": "events-context", "title": "2.3 Events carry context; states stay small", "level": 3 }, { "id": "close", "anchor": "close", "title": "2.4 close() remains the hard cleanup contract", "level": 3 }, { "id": "observable", "anchor": "observable", "title": "2.5 Lifecycle is observable and deterministic", "level": 3 }, { "id": "invalid", "anchor": "invalid", "title": "2.6 Invalid transitions are findings, not silent mysteries", "level": 3 }, { "id": "planes", "anchor": "planes", "title": "3. Two Planes, One Envelope", "level": 2 }, { "id": "host-events", "anchor": "host-events", "title": "4. Host Lifecycle Events", "level": 2 }, { "id": "host-mapping", "anchor": "host-mapping", "title": "5. Host Mapping By Runtime", "level": 2 }, { "id": "component-api", "anchor": "component-api", "title": "6. Component API", "level": 2 }, { "id": "graph-events", "anchor": "graph-events", "title": "7. Graph Lifecycle Events", "level": 2 }, { "id": "graph-subinterface", "anchor": "graph-subinterface", "title": "8. Graph Lifecycle Subinterface", "level": 2 }, { "id": "why-subinterface", "anchor": "why-subinterface", "title": "Why this is a subinterface", "level": 3 }, { "id": "propagation", "anchor": "propagation", "title": "9. Propagation Rules", "level": 2 }, { "id": "host-to-root", "anchor": "host-to-root", "title": "Host to root graph", "level": 3 }, { "id": "attach-detach", "anchor": "attach-detach", "title": "Graph attach/detach", "level": 3 }, { "id": "port-propagation", "anchor": "port-propagation", "title": "Port connect/disconnect", "level": 3 }, { "id": "patches", "anchor": "patches", "title": "10. Lifecycle And Graph Patches", "level": 2 }, { "id": "examples", "anchor": "examples", "title": "11. Runtime Examples", "level": 2 }, { "id": "android", "anchor": "android", "title": "Android screen node", "level": 3 }, { "id": "ios", "anchor": "ios", "title": "iOS controller", "level": 3 }, { "id": "browser", "anchor": "browser", "title": "Browser app", "level": 3 }, { "id": "worker", "anchor": "worker", "title": "Worker service", "level": 3 }, { "id": "server", "anchor": "server", "title": "JVM server", "level": 3 }, { "id": "implementation-plan", "anchor": "implementation-plan", "title": "12. Implementation Plan", "level": 2 }, { "id": "phase-0", "anchor": "phase-0", "title": "Phase 0: Keep Compatibility", "level": 3 }, { "id": "phase-1", "anchor": "phase-1", "title": "Phase 1: Core Lifecycle Envelope", "level": 3 }, { "id": "phase-2", "anchor": "phase-2", "title": "Phase 2: Platform Bridges", "level": 3 }, { "id": "phase-3", "anchor": "phase-3", "title": "Phase 3: Graph Lifecycle Events", "level": 3 }, { "id": "phase-4", "anchor": "phase-4", "title": "Phase 4: Telemetry And Engine", "level": 3 }, { "id": "phase-5", "anchor": "phase-5", "title": "Phase 5: Commands, Tests, And Agents", "level": 3 }, { "id": "acceptance-tests", "anchor": "acceptance-tests", "title": "13. Acceptance Tests", "level": 2 }, { "id": "open-decisions", "anchor": "open-decisions", "title": "14. Open Decisions", "level": 2 }, { "id": "summary", "anchor": "summary", "title": "15. Summary", "level": 2 } ], "links": [ { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "events", "relation": "references", "sourceAnchor": "graph-events" } ] }, { "id": "reaktor-conductor", "owner": "Claude", "kind": "control-plane", "summary": "The outbound agent layer: user-defined agents, one canonical Reaktor-owned conversation stored as a causal event DAG, per-agent context packets with explicit visibility rules and documented isolation limits, protocols the operator writes as data, and Claude Code and Codex driven as ordinary supervised subprocesses so each harness keeps its own tools and configuration. Then the design half: what a turn costs, and what Reaktor would have to compile, reduce, check and measure so that a frontier model is paid only for the part of a turn it is the only thing capable of doing.", "use": "Use when driving Claude Code or Codex from Reaktor, defining your own agents or collaboration topologies, wiring an agent run into the supervised executor, or reasoning about what an agent turn costs and which work should never reach a frontier model.", "region": "agents-outbound", "order": 0, "title": "Reaktor Conductor — driving Claude Code and Codex from inside Reaktor", "nav": "Conductor", "group": "agents", "subsection": "agents-outbound", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-conductor", "revision": "6bc986056abffed449dfe5f84a86239c9643ef9bc9f4610d3b0df32341422070", "status": "unverified", "renderingRevision": "9e54f668f5005884d569f0031b507eb9853595b6bc4c2ec099d52883b1267c1a", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://openai.com/index/unrolling-the-codex-agent-loop/", "https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices", "https://openai.com/index/harness-engineering/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-conductor", "polarity": "Neutral" }, { "id": "section-what", "anchor": "what", "label": "1. What it does", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#what", "polarity": "Neutral" }, { "id": "section-harnesses", "anchor": "harnesses", "label": "2. Normal harnesses, not a special mode", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#harnesses", "polarity": "Neutral" }, { "id": "section-thread", "anchor": "thread", "label": "3. The thread is a causal graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#thread", "polarity": "Neutral" }, { "id": "section-context", "anchor": "context", "label": "4. Context packets and blind rounds", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#context", "polarity": "Neutral" }, { "id": "section-protocols", "anchor": "protocols", "label": "5. Protocols", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#protocols", "polarity": "Neutral" }, { "id": "section-execution", "anchor": "execution", "label": "6. Running a harness is an ordinary Reaktor run", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#execution", "polarity": "Neutral" }, { "id": "section-economics", "anchor": "economics", "label": "9. What a turn actually costs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#economics", "polarity": "Neutral" }, { "id": "section-measurement", "anchor": "measurement", "label": "18. What it costs to know", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#measurement", "polarity": "Neutral" }, { "id": "section-verification", "anchor": "verification", "label": "13. Verification the model does not pay for", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#verification", "polarity": "Neutral" }, { "id": "section-reduction", "anchor": "reduction", "label": "12. Reducing what the tools say", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#reduction", "polarity": "Neutral" }, { "id": "section-agent-files", "anchor": "agent-files", "label": "17. One graph, many agent-facing files", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#agent-files", "polarity": "Neutral" }, { "id": "section-build-order", "anchor": "build-order", "label": "20. What to build first, and what would stop it", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#build-order", "polarity": "Neutral" }, { "id": "section-second-call", "anchor": "second-call", "label": "16. When a second call is worth buying", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#second-call", "polarity": "Neutral" }, { "id": "section-gaps", "anchor": "gaps", "label": "8. What is missing", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#gaps", "polarity": "Neutral" }, { "id": "section-placement", "anchor": "placement", "label": "7. Where it sits", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#placement", "polarity": "Neutral" }, { "id": "section-example", "anchor": "example", "label": "A worked example", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#example", "polarity": "Neutral" }, { "id": "section-task", "anchor": "task", "label": "10. The task is the durable unit, not the turn", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#task", "polarity": "Neutral" }, { "id": "section-packet", "anchor": "packet", "label": "11. Compiling the task's context, not the thread's", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#packet", "polarity": "Neutral" }, { "id": "section-cache", "anchor": "cache", "label": "14. A surface the provider's cache can hold", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#cache", "polarity": "Neutral" }, { "id": "section-routing", "anchor": "routing", "label": "15. Choosing what runs the turn", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#routing", "polarity": "Neutral" }, { "id": "section-names", "anchor": "names", "label": "19. Names that are already taken", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#names", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-conductor#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-conductor:references-reaktor-agent-workspace", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-placement", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-protocols", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-example", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-placement", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-framework-overview", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-placement", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-agent-workspace-door", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-gaps", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "section-door", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-desktop-master-plan", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-task", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-packet", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-formal-methods", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-reduction", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-cache", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-browser-local-ai", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-routing", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-routing", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-agent-workspace-ai-gateway", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-measurement", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "section-ai-gateway", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-names", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-conductor:references-reaktor-cli", "kind": "references", "owner": "reaktor-conductor", "incidences": [ { "node": "reaktor-conductor", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-conductor.json", "sections": [ { "id": "reaktor-conductor", "anchor": "reaktor-conductor", "title": "Reaktor Conductor", "level": 1 }, { "id": "what", "anchor": "what", "title": "1. What it does", "level": 2 }, { "id": "harnesses", "anchor": "harnesses", "title": "2. Normal harnesses, not a special mode", "level": 2 }, { "id": "thread", "anchor": "thread", "title": "3. The thread is a causal graph", "level": 2 }, { "id": "context", "anchor": "context", "title": "4. Context packets and blind rounds", "level": 2 }, { "id": "protocols", "anchor": "protocols", "title": "5. Protocols", "level": 2 }, { "id": "example", "anchor": "example", "title": "A worked example", "level": 3 }, { "id": "execution", "anchor": "execution", "title": "6. Running a harness is an ordinary Reaktor run", "level": 2 }, { "id": "placement", "anchor": "placement", "title": "7. Where it sits", "level": 2 }, { "id": "gaps", "anchor": "gaps", "title": "8. What is missing", "level": 2 }, { "id": "economics", "anchor": "economics", "title": "9. What a turn actually costs", "level": 2 }, { "id": "task", "anchor": "task", "title": "10. The task is the durable unit, not the turn", "level": 2 }, { "id": "packet", "anchor": "packet", "title": "11. Compiling the task's context, not the thread's", "level": 2 }, { "id": "reduction", "anchor": "reduction", "title": "12. Reducing what the tools say", "level": 2 }, { "id": "verification", "anchor": "verification", "title": "13. Verification the model does not pay for", "level": 2 }, { "id": "cache", "anchor": "cache", "title": "14. A surface the provider's cache can hold", "level": 2 }, { "id": "routing", "anchor": "routing", "title": "15. Choosing what runs the turn", "level": 2 }, { "id": "second-call", "anchor": "second-call", "title": "16. When a second call is worth buying", "level": 2 }, { "id": "agent-files", "anchor": "agent-files", "title": "17. One graph, many agent-facing files", "level": 2 }, { "id": "measurement", "anchor": "measurement", "title": "18. What it costs to know", "level": 2 }, { "id": "names", "anchor": "names", "title": "19. Names that are already taken", "level": 2 }, { "id": "build-order", "anchor": "build-order", "title": "20. What to build first, and what would stop it", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 }, { "id": "references", "anchor": "references", "title": "References", "level": 2 } ], "links": [ { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "protocols" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "example" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "placement" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "placement" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "placement" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "gaps" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "economics" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "task" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "packet" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "reduction" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "verification" }, { "id": "reaktor-agent-workspace", "anchor": "door", "relation": "references", "sourceAnchor": "cache" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "cache" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "routing" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "routing" }, { "id": "reaktor-agent-workspace", "anchor": "ai-gateway", "relation": "references", "sourceAnchor": "measurement" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "names" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-core", "owner": "Claude", "kind": "design", "summary": "The foundation every module imports: the Feature slot registry (kills every 'is this Android?' branch), the Capability AutoCloseable resource marker, the WeakRef Adapter platform bridge, and cross-platform primitives (time/dispatchers/logging/atomics/serialization) — plus how the designed capability runtime (normalized device/network tiers) installs on it via a Feature slot. Disambiguates the four meanings of 'capability'.", "use": "Use before touching the platform boundary: registering a Feature slot, writing a platform Adapter, or branching on a device/network capability (which must be a normalized tier, never a raw model string).", "region": "framework-foundations", "order": 0, "title": "Reaktor Core — the foundation layer", "nav": "Core", "group": "framework", "subsection": "framework-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-core", "revision": "4d95132a6c2c6a50b2cbd75f598612441edf7abbe577c0b42f3768e183e23023", "status": "unverified", "renderingRevision": "c25bf6be1a3502b2402f4a6dca2ed3f54c2e9aabbd9d0fd05fefdd34c74395c6", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "scan" ], "externalLinks": [ "https://developer.chrome.com/docs/privacy-security/user-agent-client-hints", "https://privacysandbox.google.com/protections/user-agent", "https://developer.mozilla.org/en-US/docs/Web/API/Network_Information_API", "https://w3c.github.io/fingerprinting-guidance/", "https://developer.android.com/topic/performance/performance-class", "https://developer.android.com/games/optimize/adpf/thermal", "https://developer.apple.com/documentation/foundation/processinfo/thermalstate-swift.enum", "https://developer.apple.com/documentation/foundation/processinfo/islowpowermodeenabled", "https://developer.apple.com/library/archive/documentation/Performance/Conceptual/power_efficiency_guidelines_osx/RespondToThermalStateChanges.html", "https://web.dev/articles/adaptive-loading-cds-2019", "https://developer.mozilla.org/en-US/docs/Glossary/Graceful_degradation", "https://en.wikipedia.org/wiki/Object-capability_model", "https://srl.cs.jhu.edu/pubs/SRL2003-02.pdf", "https://kotlinlang.org/docs/multiplatform/multiplatform-expect-actual.html", "https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-auto-closeable.html", "https://github.com/Kotlin/kotlinx-atomicfu", "https://arkivanov.github.io/Decompose/component/lifecycle/", "https://insert-koin.io/docs/setup/why/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-core", "polarity": "Neutral" }, { "id": "section-vision", "anchor": "vision", "label": "1. Vision — erase the platform branch", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#vision", "polarity": "Neutral" }, { "id": "section-scan", "anchor": "implementation-state", "label": "2. Implementation state", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#implementation-state", "polarity": "Neutral" }, { "id": "section-concepts", "anchor": "concepts", "label": "3. The five concepts, and the four meanings of \"capability\"", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#concepts", "polarity": "Neutral" }, { "id": "section-feature", "anchor": "feature", "label": "4. Feature — the slot registry", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#feature", "polarity": "Neutral" }, { "id": "section-capability", "anchor": "capability", "label": "5. Capability — the resource marker", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#capability", "polarity": "Neutral" }, { "id": "section-adapter", "anchor": "adapter", "label": "6. Adapter — the WeakRef platform bridge", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#adapter", "polarity": "Neutral" }, { "id": "section-open", "anchor": "open", "label": "12. Open decisions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#open", "polarity": "Neutral" }, { "id": "section-phases", "anchor": "phases", "label": "11. Phased plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#phases", "polarity": "Neutral" }, { "id": "section-primitives", "anchor": "primitives", "label": "7. Primitives — the batteries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#primitives", "polarity": "Neutral" }, { "id": "section-privacy", "anchor": "privacy", "label": "9. The normalization & privacy law", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#privacy", "polarity": "Neutral" }, { "id": "section-capability-runtime", "anchor": "capability-runtime", "label": "8. The capability runtime sits on core", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#capability-runtime", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "See also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#see-also", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-core#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-core:references-reaktor-capability", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-capability-runtime", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-performance-observability", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-reaktor-service", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-reaktor-ffi", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-core:references-reaktor-server", "kind": "references", "owner": "reaktor-core", "incidences": [ { "node": "reaktor-core", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-core.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Core — the foundation layer", "level": 0 }, { "id": "vision", "anchor": "vision", "title": "1. Vision — erase the platform branch", "level": 2 }, { "id": "implementation-state", "anchor": "implementation-state", "title": "2. Implementation state", "level": 2 }, { "id": "concepts", "anchor": "concepts", "title": "3. The five concepts, and the four meanings of \"capability\"", "level": 2 }, { "id": "feature", "anchor": "feature", "title": "4. Feature — the slot registry", "level": 2 }, { "id": "capability", "anchor": "capability", "title": "5. Capability — the resource marker", "level": 2 }, { "id": "adapter", "anchor": "adapter", "title": "6. Adapter — the WeakRef platform bridge", "level": 2 }, { "id": "primitives", "anchor": "primitives", "title": "7. Primitives — the batteries", "level": 2 }, { "id": "capability-runtime", "anchor": "capability-runtime", "title": "8. The capability runtime sits on core", "level": 2 }, { "id": "privacy", "anchor": "privacy", "title": "9. The normalization & privacy law", "level": 2 }, { "id": "module", "anchor": "module", "title": "10. The reaktor-core module", "level": 2 }, { "id": "phases", "anchor": "phases", "title": "11. Phased plan", "level": 2 }, { "id": "open", "anchor": "open", "title": "12. Open decisions", "level": 2 }, { "id": "references", "anchor": "references", "title": "13. References", "level": 2 }, { "id": "reaktor-core-code", "anchor": "reaktor-core-code", "title": "reaktor-core (code)", "level": 3 }, { "id": "privacy-preserving-capability-detection", "anchor": "privacy-preserving-capability-detection", "title": "Privacy-preserving capability detection", "level": 3 }, { "id": "platform-capability-tiers", "anchor": "platform-capability-tiers", "title": "Platform capability tiers", "level": 3 }, { "id": "patterns", "anchor": "patterns", "title": "Patterns", "level": 3 }, { "id": "see-also", "anchor": "see-also", "title": "See also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-core", "anchor": "open", "relation": "references", "sourceAnchor": "concepts" }, { "id": "reaktor-core", "anchor": "phases", "relation": "references", "sourceAnchor": "feature" }, { "id": "reaktor-core", "anchor": "concepts", "relation": "references", "sourceAnchor": "capability" }, { "id": "reaktor-core", "anchor": "phases", "relation": "references", "sourceAnchor": "adapter" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "capability-runtime" }, { "id": "reaktor-core", "anchor": "feature", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-core", "anchor": "adapter", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-core", "anchor": "primitives", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-core", "anchor": "concepts", "relation": "references", "sourceAnchor": "open" }, { "id": "reaktor-core", "anchor": "feature", "relation": "references", "sourceAnchor": "open" }, { "id": "reaktor-core", "anchor": "privacy", "relation": "references", "sourceAnchor": "open" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-core", "anchor": "concepts", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-data-graph", "owner": "Claude", "kind": "design", "summary": "Logical entities, datasets, access patterns, operations and physical bindings in the canonical typed heterogeneous multiplex port graph; semantic links, query plans, lineage, lifecycle and evidence.", "use": "Use for data identity and relationships, graph-native contracts with definition/activation separation, capability validation, cross-store planning, caching, migration and lifecycle coverage.", "region": "data-model", "order": 1, "title": "The Data Graph — data within Reaktor's unified graph", "nav": "Data Graph", "group": "data", "subsection": "data-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-data-graph", "revision": "1a0b0c33c15054ab555f084cadeb2fb133665f7b66a25ff3f45e231d47527dd8", "status": "unverified", "renderingRevision": "a1e11b184d01a0dcc6a904d2c66b33703cb75f59d822c0902a5f1ed7bc18d96a", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "not-reaktor-graph", "not-memgraph", "urn-grammar" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-data-graph", "polarity": "Neutral" }, { "id": "section-what-it-is", "anchor": "what-it-is", "label": "1. What is represented", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-graph#what-it-is", "polarity": "Neutral" }, { "id": "section-identity", "anchor": "identity", "label": "2. Identity, revisions, and evidence", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-graph#identity", "polarity": "Neutral" }, { "id": "section-nodes", "anchor": "nodes", "label": "3. Nodes and typed ports", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-graph#nodes", "polarity": "Neutral" }, { "id": "section-edges", "anchor": "edges", "label": "4. Edges carry semantics", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-graph#edges", "polarity": "Neutral" }, { "id": "section-dsl", "anchor": "dsl", "label": "5. A worked composition", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-graph#dsl", "polarity": "Neutral" }, { "id": "section-execution", "anchor": "execution", "label": "6. Planning, execution, and invalidation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-graph#execution", "polarity": "Neutral" }, { "id": "section-representations", "anchor": "representations", "label": "Topology, product data and observations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-graph#representations", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-data-graph:references-reaktor-db", "kind": "references", "owner": "reaktor-data-graph", "incidences": [ { "node": "reaktor-data-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-graph:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-data-graph", "incidences": [ { "node": "reaktor-data-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-graph:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-data-graph", "incidences": [ { "node": "reaktor-data-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-graph:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-data-graph", "incidences": [ { "node": "reaktor-data-graph", "port": "section-representations", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-data-graph.json", "sections": [ { "id": "the-data-graph", "anchor": "the-data-graph", "title": "The Data Graph", "level": 1 }, { "id": "what-it-is", "anchor": "what-it-is", "title": "1. What is represented", "level": 2 }, { "id": "where-it-cannot-live", "anchor": "where-it-cannot-live", "title": "One semantic graph, modular runtime dependencies", "level": 3 }, { "id": "representations", "anchor": "representations", "title": "Topology, product data and observations", "level": 3 }, { "id": "identity", "anchor": "identity", "title": "2. Identity, revisions, and evidence", "level": 2 }, { "id": "coverage", "anchor": "coverage", "title": "Coverage and causal progress", "level": 3 }, { "id": "nodes", "anchor": "nodes", "title": "3. Nodes and typed ports", "level": 2 }, { "id": "edges", "anchor": "edges", "title": "4. Edges carry semantics", "level": 2 }, { "id": "intra-database-and-inter-database-links", "anchor": "intra-database-and-inter-database-links", "title": "Intra-database and inter-database links", "level": 3 }, { "id": "dsl", "anchor": "dsl", "title": "5. A worked composition", "level": 2 }, { "id": "execution", "anchor": "execution", "title": "6. Planning, execution, and invalidation", "level": 2 }, { "id": "producers", "anchor": "producers", "title": "7. Producers, validation, and drift", "level": 2 }, { "id": "lifecycle", "anchor": "lifecycle", "title": "8. Lifecycle and security", "level": 2 }, { "id": "limits", "anchor": "limits", "title": "9. Size, overhead, and acceptance", "level": 2 } ], "links": [ { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "representations" } ] }, { "id": "reaktor-data-implementation", "owner": "Reaktor / Codex", "kind": "plan", "summary": "Staged evidence gates, lifecycle obligations, preprint coverage and the canonical/retired document register.", "use": "Use through the Data Layer reading map; distinguish implemented source, design, deployment and qualification.", "region": "data-evidence", "order": 1, "title": "Data Implementation, Qualification and Sources", "nav": "Implementation and evidence", "group": "data", "subsection": "data-evidence", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-data-implementation", "revision": "060f54668018117ced447151459ffcce5f05dd70a4a94e3898df1b3005eacba3", "status": "unverified", "renderingRevision": "f5f040d9bbf66e54a0e7fd9692c0bef5cb62b8cd923917f2f18381062fa8fb8f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-data-implementation", "polarity": "Neutral" }, { "id": "section-status", "anchor": "status", "label": "Current boundary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-implementation#status", "polarity": "Neutral" }, { "id": "section-sequence", "anchor": "sequence", "label": "Delivery sequence", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-implementation#sequence", "polarity": "Neutral" }, { "id": "section-qualification", "anchor": "qualification", "label": "Acceptance matrix", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-implementation#qualification", "polarity": "Neutral" }, { "id": "section-lifecycle", "anchor": "lifecycle", "label": "Lifecycle as a data contract", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-implementation#lifecycle", "polarity": "Neutral" }, { "id": "section-preprint", "anchor": "preprint", "label": "Preprint coverage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-implementation#preprint", "polarity": "Neutral" }, { "id": "section-documents", "anchor": "documents", "label": "Document ownership and retirement", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-implementation#documents", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-data-implementation:references-reaktor-db", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-sequence", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-db-erasure", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-lifecycle", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-erasure", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-graph-representations", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "section-representations", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-graph-identity", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "section-identity", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-storage", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-db-consistency", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-consistency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-db-sync", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-sync", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-workflows-qualification", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-qualification", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-workflows-workflows", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-workflows", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-inspection", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-preprint", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-graph", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-data-transactions", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-mesh", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-reaktor-work", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-implementation:references-bestbuds-schema-hardening", "kind": "references", "owner": "reaktor-data-implementation", "incidences": [ { "node": "reaktor-data-implementation", "port": "section-documents", "role": "source", "ordinal": 0 }, { "node": "bestbuds-schema-hardening", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-data-implementation.json", "sections": [ { "id": "implementation-and-evidence", "anchor": "implementation-and-evidence", "title": "Implementation and evidence", "level": 1 }, { "id": "status", "anchor": "status", "title": "Current boundary", "level": 2 }, { "id": "sequence", "anchor": "sequence", "title": "Delivery sequence", "level": 2 }, { "id": "qualification", "anchor": "qualification", "title": "Acceptance matrix", "level": 2 }, { "id": "lifecycle", "anchor": "lifecycle", "title": "Lifecycle as a data contract", "level": 2 }, { "id": "preprint", "anchor": "preprint", "title": "Preprint coverage", "level": 2 }, { "id": "documents", "anchor": "documents", "title": "Document ownership and retirement", "level": 2 } ], "links": [ { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "sequence" }, { "id": "reaktor-db", "anchor": "erasure", "relation": "references", "sourceAnchor": "lifecycle" }, { "id": "reaktor-data-graph", "anchor": "representations", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-graph", "anchor": "representations", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-graph", "anchor": "identity", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-graph", "anchor": "identity", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-db", "anchor": "consistency", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-db", "anchor": "sync", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-workflows", "anchor": "qualification", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-graph", "anchor": "identity", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-workflows", "anchor": "workflows", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-data-implementation", "anchor": "qualification", "relation": "references", "sourceAnchor": "preprint" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "documents" }, { "id": "bestbuds-schema-hardening", "anchor": "", "relation": "references", "sourceAnchor": "documents" } ] }, { "id": "reaktor-data-inspection", "owner": "Reaktor / Codex", "kind": "ops", "summary": "Provider views, SQL authority profiles, bounded query receipts and remaining operator qualification.", "use": "Use through the Data Layer reading map; distinguish implemented source, design, deployment and qualification.", "region": "data-evidence", "order": 0, "title": "Data Inspection — Authority, Providers and Query Receipts", "nav": "Data inspection", "group": "data", "subsection": "data-evidence", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-data-inspection", "revision": "53443b70f46dd986bc54838d12786ee2ba774bdf5591856621fc1f72c6fe27f4", "status": "unverified", "renderingRevision": "7550342f2578c441829ac69b7f1c8aedc725aff183eb5f9719e97ec260967e99", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.postgresql.org/docs/current/ddl-rowsecurity.html", "https://www.jetbrains.com/help/datagrip/data-editor-and-viewer.html", "https://supabase.com/docs/guides/database/tables", "https://memgraph.com/lab", "https://developers.cloudflare.com/durable-objects/api/stub/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-data-inspection", "polarity": "Neutral" }, { "id": "section-authority", "anchor": "authority", "label": "Authority and strict SQL", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-inspection#authority", "polarity": "Neutral" }, { "id": "section-providers", "anchor": "providers", "label": "Provider projections", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-inspection#providers", "polarity": "Neutral" }, { "id": "section-durable-work", "anchor": "durable-work", "label": "Durable work inspection", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-inspection#durable-work", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-data-inspection:references-reaktor-workbench-layers", "kind": "references", "owner": "reaktor-data-inspection", "incidences": [ { "node": "reaktor-data-inspection", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-inspection:references-reaktor-db", "kind": "references", "owner": "reaktor-data-inspection", "incidences": [ { "node": "reaktor-data-inspection", "port": "section-providers", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-inspection:references-reaktor-data-workflows-qualification", "kind": "references", "owner": "reaktor-data-inspection", "incidences": [ { "node": "reaktor-data-inspection", "port": "section-durable-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-qualification", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-inspection:references-reaktor-data-graph-identity", "kind": "references", "owner": "reaktor-data-inspection", "incidences": [ { "node": "reaktor-data-inspection", "port": "section-durable-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "section-identity", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-data-inspection.json", "sections": [ { "id": "data-inspection", "anchor": "data-inspection", "title": "Data inspection", "level": 1 }, { "id": "authority", "anchor": "authority", "title": "Authority and strict SQL", "level": 2 }, { "id": "providers", "anchor": "providers", "title": "Provider projections", "level": 2 }, { "id": "durable-work", "anchor": "durable-work", "title": "Durable work inspection", "level": 2 } ], "links": [ { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "providers" }, { "id": "reaktor-data-workflows", "anchor": "qualification", "relation": "references", "sourceAnchor": "durable-work" }, { "id": "reaktor-data-graph", "anchor": "identity", "relation": "references", "sourceAnchor": "durable-work" } ] }, { "id": "reaktor-data-storage", "owner": "Reaktor / Codex", "kind": "architecture", "summary": "Source-grounded persistence APIs, browser SQLite/OPFS migration, graph policies and snapshot-transfer limits.", "use": "Use through the Data Layer reading map; distinguish implemented source, design, deployment and qualification.", "region": "data-model", "order": 2, "title": "Data Storage — Current APIs and Platform Boundaries", "nav": "Current storage APIs", "group": "data", "subsection": "data-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-data-storage", "revision": "41365e29fb7f34642d3c06d44388f9acc73130412afde2d5f07f1528cec8545d", "status": "unverified", "renderingRevision": "bddf515291c124195f91e5ffd949ab4d5bda8dc9113c5d12ed8c4e9cb0ab087c", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.sqlite.org/wasm/doc/trunk/persistence.md#opfs-sahpool" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-data-storage", "polarity": "Neutral" }, { "id": "section-objects", "anchor": "objects", "label": "Local object storage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-storage#objects", "polarity": "Neutral" }, { "id": "section-targets", "anchor": "targets", "label": "Target inventory", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-storage#targets", "polarity": "Neutral" }, { "id": "section-graph", "anchor": "graph", "label": "Graph access and tenancy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-storage#graph", "polarity": "Neutral" }, { "id": "section-snapshot", "anchor": "snapshot", "label": "Snapshot transfer is not synchronization", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-storage#snapshot", "polarity": "Neutral" }, { "id": "section-source-map", "anchor": "source-map", "label": "Source map", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-storage#source-map", "polarity": "Neutral" }, { "id": "section-browser", "anchor": "browser", "label": "Browser persistence and legacy migration", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-storage#browser", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-data-storage:references-reaktor-db", "kind": "references", "owner": "reaktor-data-storage", "incidences": [ { "node": "reaktor-data-storage", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-storage:references-reaktor-data-implementation", "kind": "references", "owner": "reaktor-data-storage", "incidences": [ { "node": "reaktor-data-storage", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-storage:references-reaktor-db-sync", "kind": "references", "owner": "reaktor-data-storage", "incidences": [ { "node": "reaktor-data-storage", "port": "section-browser", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-sync", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-storage:references-reaktor-multitenancy-today", "kind": "references", "owner": "reaktor-data-storage", "incidences": [ { "node": "reaktor-data-storage", "port": "section-graph", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "section-today", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-storage:references-reaktor-data-inspection", "kind": "references", "owner": "reaktor-data-storage", "incidences": [ { "node": "reaktor-data-storage", "port": "section-source-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-storage:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-data-storage", "incidences": [ { "node": "reaktor-data-storage", "port": "section-source-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-data-storage.json", "sections": [ { "id": "current-storage-apis", "anchor": "current-storage-apis", "title": "Current storage APIs", "level": 1 }, { "id": "objects", "anchor": "objects", "title": "Local object storage", "level": 2 }, { "id": "targets", "anchor": "targets", "title": "Target inventory", "level": 2 }, { "id": "browser", "anchor": "browser", "title": "Browser persistence and legacy migration", "level": 3 }, { "id": "graph", "anchor": "graph", "title": "Graph access and tenancy", "level": 2 }, { "id": "snapshot", "anchor": "snapshot", "title": "Snapshot transfer is not synchronization", "level": 2 }, { "id": "source-map", "anchor": "source-map", "title": "Source map", "level": 2 } ], "links": [ { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-db", "anchor": "sync", "relation": "references", "sourceAnchor": "browser" }, { "id": "reaktor-multitenancy", "anchor": "today", "relation": "references", "sourceAnchor": "graph" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "source-map" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "source-map" } ] }, { "id": "reaktor-data-transactions", "owner": "Reaktor / Codex", "kind": "architecture", "summary": "Caching, batching, ledgers, state machines, reconciliation, outbox admission, sagas and projection positions.", "use": "Use through the Data Layer reading map; distinguish implemented source, design, deployment and qualification.", "region": "data-integrity", "order": 1, "title": "Transactions, Ledgers and Derived State", "nav": "Transactions and derived state", "group": "data", "subsection": "data-integrity", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-data-transactions", "revision": "1d7ec3866c4d5a43bf617320ad6c38d0491a1cacb46ed87658da48810febb753", "status": "unverified", "renderingRevision": "108f086ed63e816609b14020956d5d56ef40fcb0c821e72c2e8a2d53bb500b5e", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-data-transactions", "polarity": "Neutral" }, { "id": "section-outbox", "anchor": "outbox", "label": "Durable admission and relay", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#outbox", "polarity": "Neutral" }, { "id": "section-idempotency", "anchor": "idempotency", "label": "Idempotent effects", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#idempotency", "polarity": "Neutral" }, { "id": "section-data", "anchor": "data", "label": "1. Data and state patterns", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#data", "polarity": "Neutral" }, { "id": "section-transactions", "anchor": "transactions", "label": "2. Transactional patterns", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#transactions", "polarity": "Neutral" }, { "id": "section-positions", "anchor": "positions", "label": "Projection positions and repair", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#positions", "polarity": "Neutral" }, { "id": "section-caching", "anchor": "caching", "label": "1.1 Caching", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#caching", "polarity": "Neutral" }, { "id": "section-batching", "anchor": "batching", "label": "1.2 Batching", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#batching", "polarity": "Neutral" }, { "id": "section-topology", "anchor": "topology", "label": "1.3 The authority/cache topology", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#topology", "polarity": "Neutral" }, { "id": "section-ledger-invariants", "anchor": "ledger-invariants", "label": "1.4 Ledger-style invariants for scarce or conserved things", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#ledger-invariants", "polarity": "Neutral" }, { "id": "section-reconciliation-repair", "anchor": "reconciliation-repair", "label": "1.5 Reconciliation, repair, and derived state", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#reconciliation-repair", "polarity": "Neutral" }, { "id": "section-state-machines", "anchor": "state-machines", "label": "2.1 Command-shaped APIs, state machines, and temporal truth", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#state-machines", "polarity": "Neutral" }, { "id": "section-saga", "anchor": "saga", "label": "2.2 Saga", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#saga", "polarity": "Neutral" }, { "id": "section-cqrs", "anchor": "cqrs", "label": "2.4 CQRS", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#cqrs", "polarity": "Neutral" }, { "id": "section-event-sourcing", "anchor": "event-sourcing", "label": "2.5 Event sourcing", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-transactions#event-sourcing", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-data-transactions:references-reaktor-data-storage", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-transactions:references-reaktor-db-consistency", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-consistency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-transactions:references-reaktor-data-workflows-handoff", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "section-idempotency", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-handoff", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-transactions:references-reaktor-db-sinks", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "section-topology", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-sinks", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-transactions:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "section-saga", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-transactions:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "section-saga", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-transactions:references-reaktor-data-workflows-applications", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "section-saga", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-applications", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-transactions:references-reaktor-data-implementation-qualification", "kind": "references", "owner": "reaktor-data-transactions", "incidences": [ { "node": "reaktor-data-transactions", "port": "section-positions", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "section-qualification", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-data-transactions.json", "sections": [ { "id": "transactions-and-derived-state", "anchor": "transactions-and-derived-state", "title": "Transactions and derived state", "level": 1 }, { "id": "outbox", "anchor": "outbox", "title": "Durable admission and relay", "level": 2 }, { "id": "idempotency", "anchor": "idempotency", "title": "Idempotent effects", "level": 2 }, { "id": "data", "anchor": "data", "title": "1. Data and state patterns", "level": 2 }, { "id": "caching", "anchor": "caching", "title": "1.1 Caching", "level": 3 }, { "id": "batching", "anchor": "batching", "title": "1.2 Batching", "level": 3 }, { "id": "topology", "anchor": "topology", "title": "1.3 The authority/cache topology", "level": 3 }, { "id": "ledger-invariants", "anchor": "ledger-invariants", "title": "1.4 Ledger-style invariants for scarce or conserved things", "level": 3 }, { "id": "reconciliation-repair", "anchor": "reconciliation-repair", "title": "1.5 Reconciliation, repair, and derived state", "level": 3 }, { "id": "transactions", "anchor": "transactions", "title": "2. Transactional patterns", "level": 2 }, { "id": "state-machines", "anchor": "state-machines", "title": "2.1 Command-shaped APIs, state machines, and temporal truth", "level": 3 }, { "id": "saga", "anchor": "saga", "title": "2.2 Saga", "level": 3 }, { "id": "outbox-pattern", "anchor": "outbox-pattern", "title": "2.3 Transactional outbox", "level": 3 }, { "id": "cqrs", "anchor": "cqrs", "title": "2.4 CQRS", "level": 3 }, { "id": "event-sourcing", "anchor": "event-sourcing", "title": "2.5 Event sourcing", "level": 3 }, { "id": "positions", "anchor": "positions", "title": "Projection positions and repair", "level": 2 } ], "links": [ { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-db", "anchor": "consistency", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-workflows", "anchor": "handoff", "relation": "references", "sourceAnchor": "idempotency" }, { "id": "reaktor-db", "anchor": "sinks", "relation": "references", "sourceAnchor": "topology" }, { "id": "reaktor-data-transactions", "anchor": "idempotency", "relation": "references", "sourceAnchor": "ledger-invariants" }, { "id": "reaktor-data-transactions", "anchor": "outbox", "relation": "references", "sourceAnchor": "ledger-invariants" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "saga" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "saga" }, { "id": "reaktor-data-workflows", "anchor": "applications", "relation": "references", "sourceAnchor": "saga" }, { "id": "reaktor-data-transactions", "anchor": "outbox", "relation": "references", "sourceAnchor": "outbox-pattern" }, { "id": "reaktor-db", "anchor": "sinks", "relation": "references", "sourceAnchor": "cqrs" }, { "id": "reaktor-data-implementation", "anchor": "qualification", "relation": "references", "sourceAnchor": "positions" } ] }, { "id": "reaktor-data-workflows", "owner": "Reaktor / Codex", "kind": "design", "summary": "Durable admission, idempotent effects, checkpointed execution and current/proposed adoption across Reaktor, Manna and BestBuds.", "use": "Use through the Data Layer reading map; distinguish implemented source, design, deployment and qualification.", "region": "data-delivery", "order": 2, "title": "Durable Jobs — Cloudflare Queues and Workflows", "nav": "Queues and Workflows", "group": "data", "subsection": "data-delivery", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-data-workflows", "revision": "06c466d2feb5d7d7f21aa7d4e79620f8610e6bd22fd727f244284b7a12b26236", "status": "unverified", "renderingRevision": "b380d703788ca8b041c243eecdf0689ac11077b15ce67e5f26a627ba1ea9ff7f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developers.cloudflare.com/queues/reference/delivery-guarantees/", "https://developers.cloudflare.com/queues/configuration/batching-retries/", "https://developers.cloudflare.com/queues/configuration/dead-letter-queues/", "https://developers.cloudflare.com/queues/platform/limits/", "https://developers.cloudflare.com/workflows/build/rules-of-workflows/", "https://developers.cloudflare.com/workflows/build/sleeping-and-retrying/", "https://developers.cloudflare.com/workflows/build/events-and-parameters/", "https://developers.cloudflare.com/workflows/build/workers-api/", "https://developers.cloudflare.com/queues/configuration/", "https://developers.cloudflare.com/workflows/build/trigger-workflows/", "https://docs.cloud.google.com/pubsub/docs/authenticate-push-subscriptions", "https://docs.cloud.google.com/pubsub/docs/lease-management", "https://docs.cloud.google.com/pubsub/docs/subscriber" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-data-workflows", "polarity": "Neutral" }, { "id": "section-choice", "anchor": "choice", "label": "Choose the mechanism by responsibility", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#choice", "polarity": "Neutral" }, { "id": "section-handoff", "anchor": "handoff", "label": "Durable intent and delivery", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#handoff", "polarity": "Neutral" }, { "id": "section-queues", "anchor": "queues", "label": "Queue consumer contract", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#queues", "polarity": "Neutral" }, { "id": "section-workflows", "anchor": "workflows", "label": "Extending Workflows", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#workflows", "polarity": "Neutral" }, { "id": "section-pubsub", "anchor": "pubsub", "label": "Pub/Sub and Spring execution", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#pubsub", "polarity": "Neutral" }, { "id": "section-applications", "anchor": "applications", "label": "Adoption across the three applications", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#applications", "polarity": "Neutral" }, { "id": "section-qualification", "anchor": "qualification", "label": "Evidence and acceptance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#qualification", "polarity": "Neutral" }, { "id": "section-queue-workflow", "anchor": "queue-workflow", "label": "Queue-to-Workflow handoff", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-data-workflows#queue-workflow", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-data-workflows:references-reaktor-db-workflow", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-workflow", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work-dag", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-workflows", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-dag", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work-benchmark", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-workflows", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-benchmark", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work-measurements", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-workflows", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-measurements", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work-logs", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-workflows", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-logs", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work-spring", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-pubsub", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-spring", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work-spring-orchestration", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-pubsub", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-spring-orchestration", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-work-feature-comparison", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-pubsub", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-feature-comparison", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-data-graph-representations", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-qualification", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "section-representations", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-operations-graph-evidence", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-qualification", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-data-workflows:references-reaktor-data-implementation-qualification", "kind": "references", "owner": "reaktor-data-workflows", "incidences": [ { "node": "reaktor-data-workflows", "port": "section-qualification", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "section-qualification", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-data-workflows.json", "sections": [ { "id": "queues-and-workflows", "anchor": "queues-and-workflows", "title": "Queues and Workflows", "level": 1 }, { "id": "choice", "anchor": "choice", "title": "Choose the mechanism by responsibility", "level": 2 }, { "id": "handoff", "anchor": "handoff", "title": "Durable intent and delivery", "level": 2 }, { "id": "queues", "anchor": "queues", "title": "Queue consumer contract", "level": 2 }, { "id": "workflows", "anchor": "workflows", "title": "Extending Workflows", "level": 2 }, { "id": "queue-workflow", "anchor": "queue-workflow", "title": "Queue-to-Workflow handoff", "level": 3 }, { "id": "host", "anchor": "host", "title": "Host and shared-code boundary", "level": 3 }, { "id": "pubsub", "anchor": "pubsub", "title": "Pub/Sub and Spring execution", "level": 2 }, { "id": "applications", "anchor": "applications", "title": "Adoption across the three applications", "level": 2 }, { "id": "qualification", "anchor": "qualification", "title": "Evidence and acceptance", "level": 2 }, { "id": "source-map", "anchor": "source-map", "title": "Source map", "level": 2 } ], "links": [ { "id": "reaktor-db", "anchor": "workflow", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-work", "anchor": "dag", "relation": "references", "sourceAnchor": "workflows" }, { "id": "reaktor-work", "anchor": "benchmark", "relation": "references", "sourceAnchor": "workflows" }, { "id": "reaktor-work", "anchor": "measurements", "relation": "references", "sourceAnchor": "workflows" }, { "id": "reaktor-work", "anchor": "logs", "relation": "references", "sourceAnchor": "workflows" }, { "id": "reaktor-work", "anchor": "spring", "relation": "references", "sourceAnchor": "pubsub" }, { "id": "reaktor-work", "anchor": "spring-orchestration", "relation": "references", "sourceAnchor": "pubsub" }, { "id": "reaktor-work", "anchor": "feature-comparison", "relation": "references", "sourceAnchor": "pubsub" }, { "id": "reaktor-data-graph", "anchor": "representations", "relation": "references", "sourceAnchor": "qualification" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "qualification" }, { "id": "reaktor-data-implementation", "anchor": "qualification", "relation": "references", "sourceAnchor": "qualification" } ] }, { "id": "reaktor-db", "owner": "Claude", "kind": "design", "summary": "Full data infrastructure within the main Reaktor graph: SQL-first datastore families, typed Service/FFI contracts, querying, consistency, sync, pubsub/queues, realtime, lifecycle, portability and scaling.", "use": "Use for overall data architecture, datastore selection and swaps, distributed-system guarantees, application composition, lifecycle plans and implementation acceptance.", "region": "data-model", "order": 0, "title": "Tidemark — Reaktor Data Layer", "nav": "Architecture and reading map", "group": "data", "subsection": "data-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-db", "revision": "ac05480397746c0a81eab03ec38ecabc273d01f09af853838cc27ed4967fba36", "status": "unverified", "renderingRevision": "1fd5eeb27602ed07668517c2237b1ae2f6813bcabeb88392498f5a6b0051b4a6", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://dataintensive.net/", "https://github.com/pgvector/pgvector", "https://www.paradedb.com/docs//introduction", "https://clickhouse.com/resources/engineering/what-is-columnar-database", "https://docs.cloud.google.com/pubsub/docs/reaktor-framework-overview", "https://developers.cloudflare.com/queues/reference/delivery-guarantees/", "https://developers.cloudflare.com/realtime/sfu/datachannels/", "https://developers.cloudflare.com/realtime/turn/", "https://martin.kleppmann.com/2015/05/27/logs-for-data-infrastructure.html", "https://docs.pingcap.com/tidb/stable/mysql-compatibility/", "https://memgraph.com/blog/cypher-differences-between-neo4j-and-memgraph" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-db", "polarity": "Neutral" }, { "id": "section-reading-map", "anchor": "reading-map", "label": "Data layer reading map", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#reading-map", "polarity": "Neutral" }, { "id": "section-shape", "anchor": "shape", "label": "1. System design", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#shape", "polarity": "Neutral" }, { "id": "section-graph", "anchor": "graph", "label": "2. One data graph, within the main graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#graph", "polarity": "Neutral" }, { "id": "section-sinks", "anchor": "sinks", "label": "3. Datastore families and default bindings", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#sinks", "polarity": "Neutral" }, { "id": "section-api", "anchor": "api", "label": "4. Service: one contract concept, several interaction protocols", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#api", "polarity": "Neutral" }, { "id": "section-queries", "anchor": "queries", "label": "5. Data access, intra-store links, and inter-store queries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#queries", "polarity": "Neutral" }, { "id": "section-sync", "anchor": "sync", "label": "7. Sync, offline work, and reactive data", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#sync", "polarity": "Neutral" }, { "id": "section-consistency", "anchor": "consistency", "label": "6. Transactions, authority, replication, and failure", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#consistency", "polarity": "Neutral" }, { "id": "section-workflow", "anchor": "workflow", "label": "9. Durable workflows and materialized data", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#workflow", "polarity": "Neutral" }, { "id": "section-erasure", "anchor": "erasure", "label": "10. Backup, restore, archival, deletion, and encryption", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#erasure", "polarity": "Neutral" }, { "id": "section-economics", "anchor": "economics", "label": "13. Overhead, cost, and scaling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#economics", "polarity": "Neutral" }, { "id": "section-realtime", "anchor": "realtime", "label": "8. Pubsub, queues, streams, and realtime", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#realtime", "polarity": "Neutral" }, { "id": "section-core", "anchor": "core", "label": "What is unified, and what remains specialized", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#core", "polarity": "Neutral" }, { "id": "section-ffi-is-a-service-binding-family", "anchor": "ffi-is-a-service-binding-family", "label": "FFI is a Service binding family", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#ffi-is-a-service-binding-family", "polarity": "Neutral" }, { "id": "section-obligations", "anchor": "obligations", "label": "15. Implementation sequence and acceptance gates", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#obligations", "polarity": "Neutral" }, { "id": "section-evidence", "anchor": "evidence", "label": "Source grounding and companion documents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-db#evidence", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-db:references-reaktor-data-inspection-providers", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "section-providers", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-inspection-authority", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "section-authority", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-service-source", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "section-source", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-graph", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-storage", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-transactions", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-mesh", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-work", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-inspection", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-implementation", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-bestbuds-schema-hardening", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "bestbuds-schema-hardening", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-service", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-auth-analysis", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-operations", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-manna-hld", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "manna-hld", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-companyos-migration-plan", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "companyos-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-workflows-applications", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "section-applications", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-graph-representations", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "section-representations", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-implementation-documents", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-reading-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "section-documents", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-core", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-ffi-services", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-ffi-is-a-service-binding-family", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-services", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-implementation-sequence", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "section-sequence", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-data-implementation-qualification", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-obligations", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "section-qualification", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-db:references-reaktor-ffi", "kind": "references", "owner": "reaktor-db", "incidences": [ { "node": "reaktor-db", "port": "section-evidence", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-db.json", "sections": [ { "id": "tidemark--reaktor-data-layer", "anchor": "tidemark--reaktor-data-layer", "title": "Tidemark — Reaktor Data Layer", "level": 1 }, { "id": "reading-map", "anchor": "reading-map", "title": "Data layer reading map", "level": 2 }, { "id": "shape", "anchor": "shape", "title": "1. System design", "level": 2 }, { "id": "core", "anchor": "core", "title": "What is unified, and what remains specialized", "level": 3 }, { "id": "graph", "anchor": "graph", "title": "2. One data graph, within the main graph", "level": 2 }, { "id": "identity", "anchor": "identity", "title": "Logical identity and physical identity", "level": 3 }, { "id": "sinks", "anchor": "sinks", "title": "3. Datastore families and default bindings", "level": 2 }, { "id": "profiles-instead-of-a-lowest-common-denominator", "anchor": "profiles-instead-of-a-lowest-common-denominator", "title": "Profiles instead of a lowest common denominator", "level": 3 }, { "id": "api", "anchor": "api", "title": "4. Service: one contract concept, several interaction protocols", "level": 2 }, { "id": "context-failures-and-execution", "anchor": "context-failures-and-execution", "title": "Context, failures, and execution", "level": 3 }, { "id": "ffi-is-a-service-binding-family", "anchor": "ffi-is-a-service-binding-family", "title": "FFI is a Service binding family", "level": 3 }, { "id": "queries", "anchor": "queries", "title": "5. Data access, intra-store links, and inter-store queries", "level": 2 }, { "id": "consistency", "anchor": "consistency", "title": "6. Transactions, authority, replication, and failure", "level": 2 }, { "id": "sync", "anchor": "sync", "title": "7. Sync, offline work, and reactive data", "level": 2 }, { "id": "realtime", "anchor": "realtime", "title": "8. Pubsub, queues, streams, and realtime", "level": 2 }, { "id": "workflow", "anchor": "workflow", "title": "9. Durable workflows and materialized data", "level": 2 }, { "id": "cloudflare-delivery-and-durable-execution", "anchor": "cloudflare-delivery-and-durable-execution", "title": "Cloudflare delivery and durable execution", "level": 3 }, { "id": "erasure", "anchor": "erasure", "title": "10. Backup, restore, archival, deletion, and encryption", "level": 2 }, { "id": "portability", "anchor": "portability", "title": "11. Portability and changing infrastructure", "level": 2 }, { "id": "scenarios", "anchor": "scenarios", "title": "12. Application scenarios", "level": 2 }, { "id": "economics", "anchor": "economics", "title": "13. Overhead, cost, and scaling", "level": 2 }, { "id": "limits", "anchor": "limits", "title": "14. Compared with a conventional stack", "level": 2 }, { "id": "obligations", "anchor": "obligations", "title": "15. Implementation sequence and acceptance gates", "level": 2 }, { "id": "evidence", "anchor": "evidence", "title": "Source grounding and companion documents", "level": 3 } ], "links": [ { "id": "reaktor-data-inspection", "anchor": "providers", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-inspection", "anchor": "authority", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "source", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "bestbuds-schema-hardening", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "manna-hld", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "companyos-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-workflows", "anchor": "applications", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-graph", "anchor": "representations", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-data-implementation", "anchor": "documents", "relation": "references", "sourceAnchor": "reading-map" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "core" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "core" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "identity" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "api" }, { "id": "reaktor-ffi", "anchor": "services", "relation": "references", "sourceAnchor": "ffi-is-a-service-binding-family" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "realtime" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "realtime" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "cloudflare-delivery-and-durable-execution" }, { "id": "reaktor-data-implementation", "anchor": "sequence", "relation": "references", "sourceAnchor": "obligations" }, { "id": "reaktor-data-implementation", "anchor": "qualification", "relation": "references", "sourceAnchor": "obligations" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "evidence" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "evidence" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "evidence" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "evidence" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "evidence" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "evidence" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "evidence" } ] }, { "id": "reaktor-dependeasy", "owner": "Codex", "kind": "build-tools", "summary": "Dependeasy as Reaktor's Gradle/KMP build fact producer for Reaktor CLI, desktop, MCP, and CI: current plugin behavior, target manifests, native/JS/mobile coverage, and the next adapter work.", "use": "Use after the Build Tools map when changing Dependeasy, target manifests, Kotlin target conventions, CMake/native integration, generated JS packages, CocoaPods/SwiftPM wiring, build-size/performance budgets, or CLI/workbench target metadata.", "region": "ship-toolchain", "order": 1, "title": "Dependeasy - Reaktor build control plane", "nav": "Dependeasy", "group": "ship", "subsection": "ship-toolchain", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-dependeasy", "revision": "3620797129b9c48e0a9238342ec363e6783125c5fe5815738bf0a76456e43a6a", "status": "unverified", "renderingRevision": "79487b7b1a87937cb40d5808b544bf6bdabd67170fbd8e059fb3fe8059be3790", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://kotlinlang.org/docs/native-target-support.html", "https://kotlinlang.org/docs/wasm-overview.html", "https://kotlinlang.org/docs/multiplatform/multiplatform-dsl-reference.html", "https://kotlinlang.org/docs/multiplatform/multiplatform-build-native-binaries.html", "https://kotlinlang.org/docs/multiplatform/multiplatform-cocoapods-overview.html", "https://kotlinlang.org/docs/multiplatform/multiplatform-spm-import.html", "https://kotlinlang.org/docs/multiplatform/multiplatform-spm-export.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-dependeasy", "polarity": "Neutral" }, { "id": "section-product-thesis", "anchor": "product-thesis", "label": "1. Product Thesis", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-dependeasy#product-thesis", "polarity": "Neutral" }, { "id": "section-today", "anchor": "today", "label": "2. What Dependeasy Does Today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-dependeasy#today", "polarity": "Neutral" }, { "id": "section-cli-contract", "anchor": "cli-contract", "label": "3. Reaktor CLI Integration Contract", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-dependeasy#cli-contract", "polarity": "Neutral" }, { "id": "section-ecosystem-scan", "anchor": "ecosystem-scan", "label": "4. Ecosystem Scan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-dependeasy#ecosystem-scan", "polarity": "Neutral" }, { "id": "section-target-coverage", "anchor": "target-coverage", "label": "5. Current KMP Target Coverage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-dependeasy#target-coverage", "polarity": "Neutral" }, { "id": "section-complex-kmm", "anchor": "complex-kmm", "label": "6. How This Helps Complex KMM Builds", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-dependeasy#complex-kmm", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-dependeasy:references-reaktor-build-tools", "kind": "references", "owner": "reaktor-dependeasy", "incidences": [ { "node": "reaktor-dependeasy", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-build-tools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-dependeasy:references-reaktor-cli", "kind": "references", "owner": "reaktor-dependeasy", "incidences": [ { "node": "reaktor-dependeasy", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-dependeasy.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Dependeasy - Reaktor build control plane", "level": 0 }, { "id": "product-thesis", "anchor": "product-thesis", "title": "1. Product Thesis", "level": 2 }, { "id": "today", "anchor": "today", "title": "2. What Dependeasy Does Today", "level": 2 }, { "id": "cli-contract", "anchor": "cli-contract", "title": "3. Reaktor CLI Integration Contract", "level": 2 }, { "id": "build-manifest", "anchor": "build-manifest", "title": "Build Manifest", "level": 3 }, { "id": "cli-consumers", "anchor": "cli-consumers", "title": "CLI Consumers", "level": 3 }, { "id": "integration-rules", "anchor": "integration-rules", "title": "Integration Rules", "level": 3 }, { "id": "ecosystem-scan", "anchor": "ecosystem-scan", "title": "4. Ecosystem Scan", "level": 2 }, { "id": "target-coverage", "anchor": "target-coverage", "title": "5. Current KMP Target Coverage", "level": 2 }, { "id": "complex-kmm", "anchor": "complex-kmm", "title": "6. How This Helps Complex KMM Builds", "level": 2 }, { "id": "improvements", "anchor": "improvements", "title": "7. Improvement Programs", "level": 2 }, { "id": "p0-manifest", "anchor": "p0-manifest", "title": "P0. Build Manifest and Graph API", "level": 3 }, { "id": "p1-target-matrix", "anchor": "p1-target-matrix", "title": "P1. Target Matrix DSL", "level": 3 }, { "id": "p2-dependencies", "anchor": "p2-dependencies", "title": "P2. Source-Set and Dependency Governance", "level": 3 }, { "id": "p3-native", "anchor": "p3-native", "title": "P3. Native/C++ Build Engine", "level": 3 }, { "id": "p4-apple", "anchor": "p4-apple", "title": "P4. Apple Packaging: CocoaPods and SwiftPM", "level": 3 }, { "id": "p5-js-wasm-worker", "anchor": "p5-js-wasm-worker", "title": "P5. JS, Vite, Wasm, and Worker Pipeline", "level": 3 }, { "id": "p6-doctor", "anchor": "p6-doctor", "title": "P6. Toolchain Doctor and Bootstrap", "level": 3 }, { "id": "p7-performance", "anchor": "p7-performance", "title": "P7. Performance and Build-Size Harness", "level": 3 }, { "id": "p8-release", "anchor": "p8-release", "title": "P8. Publication, Release, and Provenance", "level": 3 }, { "id": "p9-scaffolding", "anchor": "p9-scaffolding", "title": "P9. CLI-Driven Scaffolding and Migration", "level": 3 }, { "id": "p10-fixtures", "anchor": "p10-fixtures", "title": "P10. Plugin Fixtures and Conformance Lab", "level": 3 }, { "id": "p11-reproducibility", "anchor": "p11-reproducibility", "title": "P11. Reproducibility, Caches, and Remote Execution", "level": 3 }, { "id": "p12-desktop-mcp", "anchor": "p12-desktop-mcp", "title": "P12. Desktop and MCP Operations", "level": 3 }, { "id": "first-slice", "anchor": "first-slice", "title": "8. First Slice", "level": 2 }, { "id": "non-goals", "anchor": "non-goals", "title": "9. Non-Goals", "level": 2 } ], "links": [ { "id": "reaktor-build-tools", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "" } ] }, { "id": "reaktor-desktop-master-plan", "owner": "Merged", "kind": "plan", "summary": "The combined constitution and build score for Reaktor Desktop: product laws, Graph Studio and System Fabric architecture, the verified state of every surface, a decision log, trust and delivery gates, and six shippable phases — two independent plans merged into one document.", "use": "Use as the build order and acceptance contract for the desktop workbench.", "region": "workbench-surfaces", "order": 2, "title": "Reaktor Desktop Master Plan", "nav": "Desktop Master Plan", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-desktop-master-plan", "revision": "c18e7927ad62cbf6d3c085adb3dcdeafd5d95331b08939ea05f9c3f5a2c6052c", "status": "unverified", "renderingRevision": "e6a3c382508f2bda3b00dd773768ea9b10990609b5b1d4e87c9df46cf79899bc", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "4a5-repairs-applied-in-this-pass-verified-by-re-render", "measured-acceptance-result-for-this-wave" ], "externalLinks": [ "https://dev.epicgames.com/documentation/unreal-engine/graphs-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/collapsing-graphs-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/blueprint-debugger-in-unreal-engine", "https://www.jetbrains.com/help/idea/viewing-structure-and-hierarchy-of-the-source-code.html", "https://www.jetbrains.com/help/idea/find-highlight-usages.html", "https://www.jetbrains.com/help/idea/dependencies-analysis.html", "https://www.jetbrains.com/help/idea/refactoring-source-code.html", "https://docs.dapr.io/developing-applications/building-blocks/", "https://stately.ai/docs/studio", "https://stately.ai/docs/simulate-mode", "https://stately.ai/docs/inspector", "https://nodered.org/docs/user-guide/editor/workspace/", "https://docs.derivative.ca/Network_Editor" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-desktop-master-plan", "polarity": "Neutral" }, { "id": "section-1-decision", "anchor": "1-decision", "label": "1. Decision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-master-plan#1-decision", "polarity": "Neutral" }, { "id": "section-2-evidence-and-current-state-baseline", "anchor": "2-evidence-and-current-state-baseline", "label": "2. Evidence and current-state baseline", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-master-plan#2-evidence-and-current-state-baseline", "polarity": "Neutral" }, { "id": "section-3-product-laws", "anchor": "3-product-laws", "label": "3. Product laws", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-master-plan#3-product-laws", "polarity": "Neutral" }, { "id": "section-4-the-seamless-interaction-model", "anchor": "4-the-seamless-interaction-model", "label": "4. The seamless interaction model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-master-plan#4-the-seamless-interaction-model", "polarity": "Neutral" }, { "id": "section-5-machine-signal-20--atomic-design-system", "anchor": "5-machine-signal-20--atomic-design-system", "label": "5. Machine Signal 2.0 — atomic design system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-master-plan#5-machine-signal-20--atomic-design-system", "polarity": "Neutral" }, { "id": "section-6-global-shell-element-by-element", "anchor": "6-global-shell-element-by-element", "label": "6. Global shell, element by element", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-master-plan#6-global-shell-element-by-element", "polarity": "Neutral" } ], "relations": [] }, "content": "reaktor-desktop-master-plan.json", "sections": [ { "id": "reaktor-desktop-master-plan", "anchor": "reaktor-desktop-master-plan", "title": "Reaktor Desktop Master Plan", "level": 1 }, { "id": "1-decision", "anchor": "1-decision", "title": "1. Decision", "level": 2 }, { "id": "11-the-product-category", "anchor": "11-the-product-category", "title": "1.1 The product category", "level": 3 }, { "id": "12-what-reaktor-owns", "anchor": "12-what-reaktor-owns", "title": "1.2 What Reaktor owns", "level": 3 }, { "id": "13-one-decisive-product-promise", "anchor": "13-one-decisive-product-promise", "title": "1.3 One decisive product promise", "level": 3 }, { "id": "2-evidence-and-current-state-baseline", "anchor": "2-evidence-and-current-state-baseline", "title": "2. Evidence and current-state baseline", "level": 2 }, { "id": "21-what-is-already-worth-protecting", "anchor": "21-what-is-already-worth-protecting", "title": "2.1 What is already worth protecting", "level": 3 }, { "id": "22-the-gaps-that-change-the-plan", "anchor": "22-the-gaps-that-change-the-plan", "title": "2.2 The gaps that change the plan", "level": 3 }, { "id": "23-truth-labels-used-in-this-document", "anchor": "23-truth-labels-used-in-this-document", "title": "2.3 Truth labels used in this document", "level": 3 }, { "id": "build-score-1--where-the-desktop-truly-is--the-walk-verdict", "anchor": "build-score-1--where-the-desktop-truly-is--the-walk-verdict", "title": "Build score §1 — Where the Desktop truly is — the walk verdict", "level": 3 }, { "id": "11-what-is-already-excellent-and-must-not-be-broken", "anchor": "11-what-is-already-excellent-and-must-not-be-broken", "title": "1.1 What is already excellent and must not be broken", "level": 4 }, { "id": "12-the-ten-structural-gaps-the-walk-exposed", "anchor": "12-the-ten-structural-gaps-the-walk-exposed", "title": "1.2 The ten structural gaps the walk exposed", "level": 4 }, { "id": "13-the-improvement-ledger--every-improvement-area-in-one-view", "anchor": "13-the-improvement-ledger--every-improvement-area-in-one-view", "title": "1.3 The improvement ledger — every improvement area in one view", "level": 4 }, { "id": "13b-the-one-line-diagnosis", "anchor": "13b-the-one-line-diagnosis", "title": "1.3b The one-line diagnosis", "level": 4 }, { "id": "3-product-laws", "anchor": "3-product-laws", "title": "3. Product laws", "level": 2 }, { "id": "31-the-graph-is-semantic-not-decorative", "anchor": "31-the-graph-is-semantic-not-decorative", "title": "3.1 The graph is semantic, not decorative", "level": 3 }, { "id": "32-atomic-design-applies-to-the-whole-system", "anchor": "32-atomic-design-applies-to-the-whole-system", "title": "3.2 Atomic design applies to the whole system", "level": 3 }, { "id": "33-expressivity-and-composability-beat-breadth", "anchor": "33-expressivity-and-composability-beat-breadth", "title": "3.3 Expressivity and composability beat breadth", "level": 3 }, { "id": "34-one-intent-one-context-one-action-path", "anchor": "34-one-intent-one-context-one-action-path", "title": "3.4 One intent, one context, one action path", "level": 3 }, { "id": "35-desired-and-observed-never-overwrite-each-other", "anchor": "35-desired-and-observed-never-overwrite-each-other", "title": "3.5 Desired and observed never overwrite each other", "level": 3 }, { "id": "36-every-module-has-three-optional-layers", "anchor": "36-every-module-has-three-optional-layers", "title": "3.6 Every module has three optional layers", "level": 3 }, { "id": "37-specialist-tools-remain-first-class", "anchor": "37-specialist-tools-remain-first-class", "title": "3.7 Specialist tools remain first-class", "level": 3 }, { "id": "38-truth-trust-performance-and-accessibility-are-features", "anchor": "38-truth-trust-performance-and-accessibility-are-features", "title": "3.8 Truth, trust, performance, and accessibility are features", "level": 3 }, { "id": "39-no-marketing-before-a-conformance-harness", "anchor": "39-no-marketing-before-a-conformance-harness", "title": "3.9 No marketing before a conformance harness", "level": 3 }, { "id": "build-score-2--decisions--resolving-what-the-corpus-left-open", "anchor": "build-score-2--decisions--resolving-what-the-corpus-left-open", "title": "Build score §2 — Decisions — resolving what the corpus left open", "level": 3 }, { "id": "4-the-seamless-interaction-model", "anchor": "4-the-seamless-interaction-model", "title": "4. The seamless interaction model", "level": 2 }, { "id": "41-a-shared-workbenchcontext", "anchor": "41-a-shared-workbenchcontext", "title": "4.1 A shared WorkbenchContext", "level": 3 }, { "id": "42-missions-not-pane-hopping", "anchor": "42-missions-not-pane-hopping", "title": "4.2 Missions, not pane hopping", "level": 3 }, { "id": "43-target-information-architecture", "anchor": "43-target-information-architecture", "title": "4.3 Target information architecture", "level": 3 }, { "id": "44-progressive-disclosure", "anchor": "44-progressive-disclosure", "title": "4.4 Progressive disclosure", "level": 3 }, { "id": "build-score-3--the-connective-tissue--how-everything-becomes-one-instrument", "anchor": "build-score-3--the-connective-tissue--how-everything-becomes-one-instrument", "title": "Build score §3 — The connective tissue — how everything becomes one instrument", "level": 3 }, { "id": "31-workbenchcontext--one-selection-one-time-one-scope-phase-2", "anchor": "31-workbenchcontext--one-selection-one-time-one-scope-phase-2", "title": "3.1 WorkbenchContext — one selection, one time, one scope (Phase 2)", "level": 4 }, { "id": "32-the-verb-fabric--open-in-everywhere-phase-2-grows-forever", "anchor": "32-the-verb-fabric--open-in-everywhere-phase-2-grows-forever", "title": "3.2 The verb fabric — \"Open in…\" everywhere (Phase 2, grows forever)", "level": 4 }, { "id": "33-the-evidence-spine--drawer-inspector-and-panes-share-records-phase-3", "anchor": "33-the-evidence-spine--drawer-inspector-and-panes-share-records-phase-3", "title": "3.3 The evidence spine — drawer, inspector, and panes share records (Phase 3)", "level": 4 }, { "id": "34-missions--intent-that-outlives-a-pane-hop-phase-5", "anchor": "34-missions--intent-that-outlives-a-pane-hop-phase-5", "title": "3.4 Missions — intent that outlives a pane hop (Phase 5)", "level": 4 }, { "id": "35-ambient-agent--four-verbs-on-every-selection-phase-5-read-only-first", "anchor": "35-ambient-agent--four-verbs-on-every-selection-phase-5-read-only-first", "title": "3.5 Ambient agent — four verbs on every selection (Phase 5, read-only first)", "level": 4 }, { "id": "5-machine-signal-20--atomic-design-system", "anchor": "5-machine-signal-20--atomic-design-system", "title": "5. Machine Signal 2.0 — atomic design system", "level": 2 }, { "id": "51-token-architecture", "anchor": "51-token-architecture", "title": "5.1 Token architecture", "level": 3 }, { "id": "52-component-hierarchy", "anchor": "52-component-hierarchy", "title": "5.2 Component hierarchy", "level": 3 }, { "id": "53-visual-hierarchy", "anchor": "53-visual-hierarchy", "title": "5.3 Visual hierarchy", "level": 3 }, { "id": "54-accessibility-contract", "anchor": "54-accessibility-contract", "title": "5.4 Accessibility contract", "level": 3 }, { "id": "build-score-4--machine-signal-20--the-design-system-program", "anchor": "build-score-4--machine-signal-20--the-design-system-program", "title": "Build score §4 — Machine Signal 2.0 — the design-system program", "level": 3 }, { "id": "41-token-architecture-phase-12", "anchor": "41-token-architecture-phase-12", "title": "4.1 Token architecture (Phase 1–2)", "level": 4 }, { "id": "42-component-contract-phase-24", "anchor": "42-component-contract-phase-24", "title": "4.2 Component contract (Phase 2–4)", "level": 4 }, { "id": "43-accessibility-phase-2-baseline-phase-4-gate", "anchor": "43-accessibility-phase-2-baseline-phase-4-gate", "title": "4.3 Accessibility (Phase 2 baseline, Phase 4 gate)", "level": 4 }, { "id": "44-density-and-layout-behavior", "anchor": "44-density-and-layout-behavior", "title": "4.4 Density and layout behavior", "level": 4 }, { "id": "45-motion", "anchor": "45-motion", "title": "4.5 Motion", "level": 4 }, { "id": "46-the-pencil-atlas-repair-parallel-track-19-milestones", "anchor": "46-the-pencil-atlas-repair-parallel-track-19-milestones", "title": "4.6 The pencil atlas repair (parallel track, §19 milestones)", "level": 4 }, { "id": "47-atlas-inspection-addendum--direct-inspection-2026-08-18", "anchor": "47-atlas-inspection-addendum--direct-inspection-2026-08-18", "title": "4.7 Atlas inspection addendum — direct inspection, 2026-08-18", "level": 4 }, { "id": "48-six-laws-that-prevent-the-atlas-from-regressing", "anchor": "48-six-laws-that-prevent-the-atlas-from-regressing", "title": "4.8 Six laws that prevent the atlas from regressing", "level": 4 }, { "id": "build-score-4a--design-gap-audit--the-atlas-measured-against-its-own-specification", "anchor": "build-score-4a--design-gap-audit--the-atlas-measured-against-its-own-specification", "title": "Build score §4A — Design gap audit — the atlas measured against its own specification", "level": 3 }, { "id": "4a1-the-root-cause--one-hero-still-life-per-surface", "anchor": "4a1-the-root-cause--one-hero-still-life-per-surface", "title": "4A.1 The root cause — one hero still-life per surface", "level": 4 }, { "id": "4a2-the-six-systemic-failures", "anchor": "4a2-the-six-systemic-failures", "title": "4A.2 The six systemic failures", "level": 4 }, { "id": "4a3-per-surface-findings", "anchor": "4a3-per-surface-findings", "title": "4A.3 Per-surface findings", "level": 4 }, { "id": "4a4-what-the-audit-does-not-dispute", "anchor": "4a4-what-the-audit-does-not-dispute", "title": "4A.4 What the audit does not dispute", "level": 4 }, { "id": "4a5-verified-rendering-repairs", "anchor": "4a5-verified-rendering-repairs", "title": "4A.5 Verified rendering repairs", "level": 4 }, { "id": "build-score-4b--the-correction-program--from-atlas-to-cohesive-product", "anchor": "build-score-4b--the-correction-program--from-atlas-to-cohesive-product", "title": "Build score §4B — The correction program — from atlas to cohesive product", "level": 3 }, { "id": "4b1-finish-the-rendering-integrity-sweep-phase-1", "anchor": "4b1-finish-the-rendering-integrity-sweep-phase-1", "title": "4B.1 Finish the rendering-integrity sweep (Phase 1)", "level": 4 }, { "id": "4b2-kind-differentiated-node-anatomy-phase-2-blocks-s5", "anchor": "4b2-kind-differentiated-node-anatomy-phase-2-blocks-s5", "title": "4B.2 Kind-differentiated node anatomy (Phase 2, blocks S5)", "level": 4 }, { "id": "4b3-chrome-in-context--the-largest-single-credibility-win-phase-23-blocks-the-root-cause", "anchor": "4b3-chrome-in-context--the-largest-single-credibility-win-phase-23-blocks-the-root-cause", "title": "4B.3 Chrome in context — the largest single credibility win (Phase 2–3, blocks the root cause)", "level": 4 }, { "id": "4b4-instruments-that-encode-data-phase-3", "anchor": "4b4-instruments-that-encode-data-phase-3", "title": "4B.4 Instruments that encode data (Phase 3)", "level": 4 }, { "id": "4b5-the-state-matrix--from-one-moment-to-a-product-phase-34", "anchor": "4b5-the-state-matrix--from-one-moment-to-a-product-phase-34", "title": "4B.5 The state matrix — from one moment to a product (Phase 3–4)", "level": 4 }, { "id": "4b6-truth-and-governance-conformance-globally-phase-12-continuous", "anchor": "4b6-truth-and-governance-conformance-globally-phase-12-continuous", "title": "4B.6 Truth and governance conformance, globally (Phase 1–2, continuous)", "level": 4 }, { "id": "4b7-sequencing-and-the-pipeline-consequence", "anchor": "4b7-sequencing-and-the-pipeline-consequence", "title": "4B.7 Sequencing and the pipeline consequence", "level": 4 }, { "id": "6-global-shell-element-by-element", "anchor": "6-global-shell-element-by-element", "title": "6. Global shell, element by element", "level": 2 }, { "id": "61-native-window-and-lifecycle", "anchor": "61-native-window-and-lifecycle", "title": "6.1 Native window and lifecycle", "level": 3 }, { "id": "62-global-top-bar", "anchor": "62-global-top-bar", "title": "6.2 Global top bar", "level": 3 }, { "id": "63-workspace-bar", "anchor": "63-workspace-bar", "title": "6.3 Workspace bar", "level": 3 }, { "id": "64-command-palette-and-omnibox", "anchor": "64-command-palette-and-omnibox", "title": "6.4 Command palette and omnibox", "level": 3 }, { "id": "65-left-navigator", "anchor": "65-left-navigator", "title": "6.5 Left navigator", "level": 3 }, { "id": "66-center-workspace", "anchor": "66-center-workspace", "title": "6.6 Center workspace", "level": 3 }, { "id": "67-inspector", "anchor": "67-inspector", "title": "6.7 Inspector", "level": 3 }, { "id": "68-evidence-drawer", "anchor": "68-evidence-drawer", "title": "6.8 Evidence drawer", "level": 3 }, { "id": "69-status-bar", "anchor": "69-status-bar", "title": "6.9 Status bar", "level": 3 }, { "id": "610-cross-cut-interaction-states", "anchor": "610-cross-cut-interaction-states", "title": "6.10 Cross-cut interaction states", "level": 3 }, { "id": "build-score-5--the-shell-element-by-element", "anchor": "build-score-5--the-shell-element-by-element", "title": "Build score §5 — The shell, element by element", "level": 3 }, { "id": "51-window--lifecycle", "anchor": "51-window--lifecycle", "title": "5.1 Window & lifecycle", "level": 4 }, { "id": "52-mode-strip", "anchor": "52-mode-strip", "title": "5.2 Mode strip", "level": 4 }, { "id": "53-context-row-breadcrumb-bar", "anchor": "53-context-row-breadcrumb-bar", "title": "5.3 Context row (breadcrumb bar)", "level": 4 }, { "id": "54-left-rail", "anchor": "54-left-rail", "title": "5.4 Left rail", "level": 4 }, { "id": "55-search-d15", "anchor": "55-search-d15", "title": "5.5 Search (D15)", "level": 4 }, { "id": "56-inspector-right-rail", "anchor": "56-inspector-right-rail", "title": "5.6 Inspector (right rail)", "level": 4 }, { "id": "57-evidence-drawer", "anchor": "57-evidence-drawer", "title": "5.7 Evidence drawer", "level": 4 }, { "id": "58-status-bar--keyboard", "anchor": "58-status-bar--keyboard", "title": "5.8 Status bar & keyboard", "level": 4 }, { "id": "59-deletions-phase-1-gated-by-deadcodeabsencetest", "anchor": "59-deletions-phase-1-gated-by-deadcodeabsencetest", "title": "5.9 Deletions (Phase 1, gated by DeadCodeAbsenceTest)", "level": 4 }, { "id": "7-canonical-technical-architecture", "anchor": "7-canonical-technical-architecture", "title": "7. Canonical technical architecture", "level": 2 }, { "id": "71-separate-program-observation-history-and-presentation", "anchor": "71-separate-program-observation-history-and-presentation", "title": "7.1 Separate program, observation, history, and presentation", "level": 3 }, { "id": "72-evidence-model", "anchor": "72-evidence-model", "title": "7.2 Evidence model", "level": 3 }, { "id": "73-registry-and-source-tiers", "anchor": "73-registry-and-source-tiers", "title": "7.3 Registry and source tiers", "level": 3 }, { "id": "74-one-complete-loop", "anchor": "74-one-complete-loop", "title": "7.4 One complete loop", "level": 3 }, { "id": "75-dependency-direction", "anchor": "75-dependency-direction", "title": "7.5 Dependency direction", "level": 3 }, { "id": "76-runtime-ownership-and-lifecycle", "anchor": "76-runtime-ownership-and-lifecycle", "title": "7.6 Runtime ownership and lifecycle", "level": 3 }, { "id": "77-contracts-and-polyglot-boundaries", "anchor": "77-contracts-and-polyglot-boundaries", "title": "7.7 Contracts and polyglot boundaries", "level": 3 }, { "id": "78-extension-sdk", "anchor": "78-extension-sdk", "title": "7.8 Extension SDK", "level": 3 }, { "id": "79-tool-cooperation-protocol", "anchor": "79-tool-cooperation-protocol", "title": "7.9 Tool Cooperation Protocol", "level": 3 }, { "id": "710-mcp-and-agent-boundary", "anchor": "710-mcp-and-agent-boundary", "title": "7.10 MCP and agent boundary", "level": 3 }, { "id": "build-score-18--framework-workstream--the-levers-and-the-blockers", "anchor": "build-score-18--framework-workstream--the-levers-and-the-blockers", "title": "Build score §18 — Framework workstream — the levers and the blockers", "level": 3 }, { "id": "8-system-canvas--graph-studio--the-heart-of-reaktor", "anchor": "8-system-canvas--graph-studio--the-heart-of-reaktor", "title": "8. System Canvas / Graph Studio — the heart of Reaktor", "level": 2 }, { "id": "81-benchmark-boundary-and-durable-advantage", "anchor": "81-benchmark-boundary-and-durable-advantage", "title": "8.1 Benchmark, boundary, and durable advantage", "level": 3 }, { "id": "82-one-canvas-six-independent-dimensions", "anchor": "82-one-canvas-six-independent-dimensions", "title": "8.2 One canvas, six independent dimensions", "level": 3 }, { "id": "83-semantic-depth-and-progressive-disclosure", "anchor": "83-semantic-depth-and-progressive-disclosure", "title": "8.3 Semantic depth and progressive disclosure", "level": 3 }, { "id": "84-full-graph-studio-anatomy", "anchor": "84-full-graph-studio-anatomy", "title": "8.4 Full Graph Studio anatomy", "level": 3 }, { "id": "studio-control-deck", "anchor": "studio-control-deck", "title": "Studio control deck", "level": 4 }, { "id": "left-explorer", "anchor": "left-explorer", "title": "Left explorer", "level": 4 }, { "id": "canvas", "anchor": "canvas", "title": "Canvas", "level": 4 }, { "id": "inspector", "anchor": "inspector", "title": "Inspector", "level": 4 }, { "id": "evidence-and-execution-drawer", "anchor": "evidence-and-execution-drawer", "title": "Evidence and execution drawer", "level": 4 }, { "id": "context-continuity", "anchor": "context-continuity", "title": "Context continuity", "level": 4 }, { "id": "85-atomic-graph-grammar", "anchor": "85-atomic-graph-grammar", "title": "8.5 Atomic graph grammar", "level": 3 }, { "id": "port-roles", "anchor": "port-roles", "title": "Port roles", "level": 4 }, { "id": "relationship-grammar", "anchor": "relationship-grammar", "title": "Relationship grammar", "level": 4 }, { "id": "86-query-selection-lens-and-deep-link-model", "anchor": "86-query-selection-lens-and-deep-link-model", "title": "8.6 Query, selection, lens, and deep-link model", "level": 3 }, { "id": "87-authoring-and-connection-interaction-grammar", "anchor": "87-authoring-and-connection-interaction-grammar", "title": "8.7 Authoring and connection interaction grammar", "level": 3 }, { "id": "change-lifecycle", "anchor": "change-lifecycle", "title": "Change lifecycle", "level": 4 }, { "id": "88-compiler-findings-and-materialization", "anchor": "88-compiler-findings-and-materialization", "title": "8.8 Compiler, findings, and materialization", "level": 3 }, { "id": "89-behavior-vocabulary-and-blueprint-grade-baseline", "anchor": "89-behavior-vocabulary-and-blueprint-grade-baseline", "title": "8.9 Behavior vocabulary and Blueprint-grade baseline", "level": 3 }, { "id": "810-runtime-debugger-causal-trace-and-time-travel", "anchor": "810-runtime-debugger-causal-trace-and-time-travel", "title": "8.10 Runtime debugger, causal trace, and time travel", "level": 3 }, { "id": "811-inspector-tabs-and-selection-contract", "anchor": "811-inspector-tabs-and-selection-contract", "title": "8.11 Inspector tabs and selection contract", "level": 3 }, { "id": "812-drawer-changes-agents-and-execution", "anchor": "812-drawer-changes-agents-and-execution", "title": "8.12 Drawer, changes, agents, and execution", "level": 3 }, { "id": "813-truth-effect-permission-and-proposal-state", "anchor": "813-truth-effect-permission-and-proposal-state", "title": "8.13 Truth, effect, permission, and proposal state", "level": 3 }, { "id": "814-keyboard-accessibility-and-textual-parity", "anchor": "814-keyboard-accessibility-and-textual-parity", "title": "8.14 Keyboard, accessibility, and textual parity", "level": 3 }, { "id": "815-rendering-and-scale-architecture", "anchor": "815-rendering-and-scale-architecture", "title": "8.15 Rendering and scale architecture", "level": 3 }, { "id": "816-non-happy-path-product-contract", "anchor": "816-non-happy-path-product-contract", "title": "8.16 Non-happy-path product contract", "level": 3 }, { "id": "817-technical-ownership-and-dependency-direction", "anchor": "817-technical-ownership-and-dependency-direction", "title": "8.17 Technical ownership and dependency direction", "level": 3 }, { "id": "818-graph-delivery-gates-and-claim-ladder", "anchor": "818-graph-delivery-gates-and-claim-ladder", "title": "8.18 Graph delivery gates and claim ladder", "level": 3 }, { "id": "graph-g0--honest-leak-free-viewer", "anchor": "graph-g0--honest-leak-free-viewer", "title": "Graph G0 — honest, leak-free viewer", "level": 4 }, { "id": "graph-g1--canonical-readquery-wedge", "anchor": "graph-g1--canonical-readquery-wedge", "title": "Graph G1 — canonical read/query wedge", "level": 4 }, { "id": "graph-g2--correct-draft-editor", "anchor": "graph-g2--correct-draft-editor", "title": "Graph G2 — correct draft editor", "level": 4 }, { "id": "graph-g3--compilerunobserve-vertical-slice", "anchor": "graph-g3--compilerunobserve-vertical-slice", "title": "Graph G3 — compile/run/observe vertical slice", "level": 4 }, { "id": "graph-g4--debugger-and-sandbox-time-travel", "anchor": "graph-g4--debugger-and-sandbox-time-travel", "title": "Graph G4 — debugger and sandbox time travel", "level": 4 }, { "id": "graph-g5--beyond-blueprints-proof", "anchor": "graph-g5--beyond-blueprints-proof", "title": "Graph G5 — beyond-Blueprints proof", "level": 4 }, { "id": "graph-g6--scale-extension-and-polyglot-conformance", "anchor": "graph-g6--scale-extension-and-polyglot-conformance", "title": "Graph G6 — scale, extension, and polyglot conformance", "level": 4 }, { "id": "graph-g7--field-proof", "anchor": "graph-g7--field-proof", "title": "Graph G7 — field proof", "level": 4 }, { "id": "819-decisive-acceptance-journeys", "anchor": "819-decisive-acceptance-journeys", "title": "8.19 Decisive acceptance journeys", "level": 3 }, { "id": "journey-a--ten-minute-brownfield-map", "anchor": "journey-a--ten-minute-brownfield-map", "title": "Journey A — ten-minute brownfield map", "level": 4 }, { "id": "journey-b--blueprint-grade-behavior-loop", "anchor": "journey-b--blueprint-grade-behavior-loop", "title": "Journey B — Blueprint-grade behavior loop", "level": 4 }, { "id": "journey-c--full-system-governed-change", "anchor": "journey-c--full-system-governed-change", "title": "Journey C — full-system governed change", "level": 4 }, { "id": "820-pencil-implementation-disposition", "anchor": "820-pencil-implementation-disposition", "title": "8.20 Pencil implementation disposition", "level": 3 }, { "id": "821-system-fabric-projection--data-messaging-compute-and-cloud-are-graph-native", "anchor": "821-system-fabric-projection--data-messaging-compute-and-cloud-are-graph-native", "title": "8.21 System Fabric projection — data, messaging, compute, and cloud are graph-native", "level": 3 }, { "id": "system-fabric-lenses", "anchor": "system-fabric-lenses", "title": "System Fabric lenses", "level": 4 }, { "id": "desired-observed-and-historical-planes", "anchor": "desired-observed-and-historical-planes", "title": "Desired, observed, and historical planes", "level": 4 }, { "id": "inspector-contract-for-infrastructure-entities", "anchor": "inspector-contract-for-infrastructure-entities", "title": "Inspector contract for infrastructure entities", "level": 4 }, { "id": "system-fabric-performance-and-honesty-contract", "anchor": "system-fabric-performance-and-honesty-contract", "title": "System Fabric performance and honesty contract", "level": 4 }, { "id": "build-score-6--graph--the-heart-from-impressive-viewer-to-the-common-surface", "anchor": "build-score-6--graph--the-heart-from-impressive-viewer-to-the-common-surface", "title": "Build score §6 — Graph — the heart, from impressive viewer to the common surface", "level": 3 }, { "id": "9-build-workspace--develop-preview-ui-and-inner-loop", "anchor": "9-build-workspace--develop-preview-ui-and-inner-loop", "title": "9. Build workspace — Develop, Preview, UI, and inner loop", "level": 2 }, { "id": "91-developdevtools-surface-contract", "anchor": "91-developdevtools-surface-contract", "title": "9.1 Develop/DevTools surface contract", "level": 3 }, { "id": "92-preview-control-anatomy", "anchor": "92-preview-control-anatomy", "title": "9.2 Preview control anatomy", "level": 3 }, { "id": "93-ui-family--all-eight-authored-subpanes", "anchor": "93-ui-family--all-eight-authored-subpanes", "title": "9.3 UI family — all eight authored subpanes", "level": 3 }, { "id": "build-score-7--devtools--the-inner-loop-becomes-one-loop", "anchor": "build-score-7--devtools--the-inner-loop-becomes-one-loop", "title": "Build score §7 — DevTools — the inner loop becomes one loop", "level": 3 }, { "id": "build-score-16--ui--the-design-system-audits-itself", "anchor": "build-score-16--ui--the-design-system-audits-itself", "title": "Build score §16 — UI — the design system audits itself", "level": 3 }, { "id": "10-ambient-agent-and-agent-workspace", "anchor": "10-ambient-agent-and-agent-workspace", "title": "10. Ambient Agent and Agent workspace", "level": 2 }, { "id": "101-the-four-local-actions", "anchor": "101-the-four-local-actions", "title": "10.1 The four local actions", "level": 3 }, { "id": "102-agent-family--all-nine-authored-subpanes", "anchor": "102-agent-family--all-nine-authored-subpanes", "title": "10.2 Agent family — all nine authored subpanes", "level": 3 }, { "id": "103-critic-and-review", "anchor": "103-critic-and-review", "title": "10.3 Critic and review", "level": 3 }, { "id": "build-score-17--agent--governed-collaboration-not-a-chat-box", "anchor": "build-score-17--agent--governed-collaboration-not-a-chat-box", "title": "Build score §17 — Agent — governed collaboration, not a chat box", "level": 3 }, { "id": "11-ai-workspace--models-as-an-operable-subsystem", "anchor": "11-ai-workspace--models-as-an-operable-subsystem", "title": "11. AI workspace — models as an operable subsystem", "level": 2 }, { "id": "build-score-15--ai--an-operable-subsystem-honestly-gated", "anchor": "build-score-15--ai--an-operable-subsystem-honestly-gated", "title": "Build score §15 — AI — an operable subsystem, honestly gated", "level": 3 }, { "id": "12-state--data-studio--one-multi-engine-data-fabric", "anchor": "12-state--data-studio--one-multi-engine-data-fabric", "title": "12. State / Data Studio — one multi-engine data fabric", "level": 2 }, { "id": "121-the-authority-rule", "anchor": "121-the-authority-rule", "title": "12.1 The authority rule", "level": 3 }, { "id": "122-canonical-data-model", "anchor": "122-canonical-data-model", "title": "12.2 Canonical data model", "level": 3 }, { "id": "123-engine-adapters-and-exact-scope", "anchor": "123-engine-adapters-and-exact-scope", "title": "12.3 Engine adapters and exact scope", "level": 3 }, { "id": "124-unified-query-contract", "anchor": "124-unified-query-contract", "title": "12.4 Unified query contract", "level": 3 }, { "id": "125-data-studio-anatomy", "anchor": "125-data-studio-anatomy", "title": "12.5 Data Studio anatomy", "level": 3 }, { "id": "126-schema-contracts-lineage-and-change-impact", "anchor": "126-schema-contracts-lineage-and-change-impact", "title": "12.6 Schema, contracts, lineage, and change impact", "level": 3 }, { "id": "127-governed-data-mutation-grammar", "anchor": "127-governed-data-mutation-grammar", "title": "12.7 Governed data mutation grammar", "level": 3 }, { "id": "128-data-scale-privacy-and-correctness-gates", "anchor": "128-data-scale-privacy-and-correctness-gates", "title": "12.8 Data scale, privacy, and correctness gates", "level": 3 }, { "id": "build-score-8--database--the-reference-family-deepened", "anchor": "build-score-8--database--the-reference-family-deepened", "title": "Build score §8 — Database — the reference family, deepened", "level": 3 }, { "id": "13-trust-workspace--identity-authorization-and-security", "anchor": "13-trust-workspace--identity-authorization-and-security", "title": "13. Trust workspace — identity, authorization, and security", "level": 2 }, { "id": "build-score-9--auth--findings-today-simulator-next", "anchor": "build-score-9--auth--findings-today-simulator-next", "title": "Build score §9 — Auth — findings today, simulator next", "level": 3 }, { "id": "14-prove-workspace--testing-and-gates", "anchor": "14-prove-workspace--testing-and-gates", "title": "14. Prove workspace — testing and gates", "level": 2 }, { "id": "build-score-12--testing--one-test-model-over-seven-harnesses-d9", "anchor": "build-score-12--testing--one-test-model-over-seven-harnesses-d9", "title": "Build score §12 — Testing — one test model over seven harnesses (D9)", "level": 3 }, { "id": "15-operate-deploy-and-cloud", "anchor": "15-operate-deploy-and-cloud", "title": "15. Operate: Deploy and Cloud", "level": 2 }, { "id": "151-deploy-surfaces", "anchor": "151-deploy-surfaces", "title": "15.1 Deploy surfaces", "level": 3 }, { "id": "152-system-fabric--the-entire-operable-cloud-layer", "anchor": "152-system-fabric--the-entire-operable-cloud-layer", "title": "15.2 System Fabric — the entire operable cloud layer", "level": 3 }, { "id": "153-resource-identity-and-hierarchy", "anchor": "153-resource-identity-and-hierarchy", "title": "15.3 Resource identity and hierarchy", "level": 3 }, { "id": "154-provider-and-target-coverage", "anchor": "154-provider-and-target-coverage", "title": "15.4 Provider and target coverage", "level": 3 }, { "id": "cloudflare", "anchor": "cloudflare", "title": "Cloudflare", "level": 4 }, { "id": "google-cloud", "anchor": "google-cloud", "title": "Google Cloud", "level": 4 }, { "id": "kubernetes--k3s", "anchor": "kubernetes--k3s", "title": "Kubernetes / k3s", "level": 4 }, { "id": "servers-and-processes", "anchor": "servers-and-processes", "title": "Servers and processes", "level": 4 }, { "id": "data-systems", "anchor": "data-systems", "title": "Data systems", "level": 4 }, { "id": "155-messaging-and-event-fabric", "anchor": "155-messaging-and-event-fabric", "title": "15.5 Messaging and event fabric", "level": 3 }, { "id": "156-desiredobserved-reconciliation-and-incident-context", "anchor": "156-desiredobserved-reconciliation-and-incident-context", "title": "15.6 Desired/observed reconciliation and incident context", "level": 3 }, { "id": "157-system-fabric-workspace-anatomy", "anchor": "157-system-fabric-workspace-anatomy", "title": "15.7 System Fabric workspace anatomy", "level": 3 }, { "id": "158-governed-infrastructure-operations", "anchor": "158-governed-infrastructure-operations", "title": "15.8 Governed infrastructure operations", "level": 3 }, { "id": "159-adapter-ownership-and-evolution-of-reaktor-cloud", "anchor": "159-adapter-ownership-and-evolution-of-reaktor-cloud", "title": "15.9 Adapter ownership and evolution of reaktor-cloud", "level": 3 }, { "id": "1510-safety-scale-and-conformance-gates", "anchor": "1510-safety-scale-and-conformance-gates", "title": "15.10 Safety, scale, and conformance gates", "level": 3 }, { "id": "build-score-10--cloud--from-inventory-to-fleet-truth", "anchor": "build-score-10--cloud--from-inventory-to-fleet-truth", "title": "Build score §10 — Cloud — from inventory to fleet truth", "level": 3 }, { "id": "build-score-11--deploy--release-truth-as-a-first-class-family-d9", "anchor": "build-score-11--deploy--release-truth-as-a-first-class-family-d9", "title": "Build score §11 — Deploy — release truth as a first-class family (D9)", "level": 3 }, { "id": "16-observe-workspace--telemetry-as-graph-evidence", "anchor": "16-observe-workspace--telemetry-as-graph-evidence", "title": "16. Observe workspace — telemetry as graph evidence", "level": 2 }, { "id": "build-score-13--telemetry--evidence-pipeline-first-dashboards-never", "anchor": "build-score-13--telemetry--evidence-pipeline-first-dashboards-never", "title": "Build score §13 — Telemetry — evidence pipeline first, dashboards never", "level": 3 }, { "id": "17-learn-workspace--analytics-and-economics", "anchor": "17-learn-workspace--analytics-and-economics", "title": "17. Learn workspace — analytics and economics", "level": 2 }, { "id": "build-score-14--analytics--product-truth-with-privacy-rails", "anchor": "build-score-14--analytics--product-truth-with-privacy-rails", "title": "Build score §14 — Analytics — product truth with privacy rails", "level": 3 }, { "id": "18-universal-surface-contract", "anchor": "18-universal-surface-contract", "title": "18. Universal surface contract", "level": 2 }, { "id": "181-required-data-states", "anchor": "181-required-data-states", "title": "18.1 Required data states", "level": 3 }, { "id": "182-required-action-states", "anchor": "182-required-action-states", "title": "18.2 Required action states", "level": 3 }, { "id": "183-required-interaction-states", "anchor": "183-required-interaction-states", "title": "18.3 Required interaction states", "level": 3 }, { "id": "184-truth-cannot-be-bypassed", "anchor": "184-truth-cannot-be-bypassed", "title": "18.4 Truth cannot be bypassed", "level": 3 }, { "id": "185-surface-coverage-gate", "anchor": "185-surface-coverage-gate", "title": "18.5 Surface coverage gate", "level": 3 }, { "id": "186-selection-inspector-drawer-and-responsive-invariants", "anchor": "186-selection-inspector-drawer-and-responsive-invariants", "title": "18.6 Selection, inspector, drawer, and responsive invariants", "level": 3 }, { "id": "build-score-20--gates-and-tests-added-by-this-plan", "anchor": "build-score-20--gates-and-tests-added-by-this-plan", "title": "Build score §20 — Gates and tests added by this plan", "level": 3 }, { "id": "19-trust-before-autonomy", "anchor": "19-trust-before-autonomy", "title": "19. Trust before autonomy", "level": 2 }, { "id": "191-workspace-trust-and-isolation", "anchor": "191-workspace-trust-and-isolation", "title": "19.1 Workspace trust and isolation", "level": 3 }, { "id": "192-plans-and-approvals", "anchor": "192-plans-and-approvals", "title": "19.2 Plans and approvals", "level": 3 }, { "id": "193-authorization-and-privacy", "anchor": "193-authorization-and-privacy", "title": "19.3 Authorization and privacy", "level": 3 }, { "id": "194-mcp-split", "anchor": "194-mcp-split", "title": "19.4 MCP split", "level": 3 }, { "id": "195-plugin-and-extension-security", "anchor": "195-plugin-and-extension-security", "title": "19.5 Plugin and extension security", "level": 3 }, { "id": "20-performance-and-scale-budgets", "anchor": "20-performance-and-scale-budgets", "title": "20. Performance and scale budgets", "level": 2 }, { "id": "201-product-budgets", "anchor": "201-product-budgets", "title": "20.1 Product budgets", "level": 3 }, { "id": "202-graphmodel-budgets", "anchor": "202-graphmodel-budgets", "title": "20.2 Graph/model budgets", "level": 3 }, { "id": "21-release-factory-and-operability", "anchor": "21-release-factory-and-operability", "title": "21. Release factory and operability", "level": 2 }, { "id": "211-mandatory-reproducible-ci", "anchor": "211-mandatory-reproducible-ci", "title": "21.1 Mandatory reproducible CI", "level": 3 }, { "id": "212-native-product-shipping", "anchor": "212-native-product-shipping", "title": "21.2 Native product shipping", "level": 3 }, { "id": "213-telemetry-and-slos", "anchor": "213-telemetry-and-slos", "title": "21.3 Telemetry and SLOs", "level": 3 }, { "id": "214-recovery", "anchor": "214-recovery", "title": "21.4 Recovery", "level": 3 }, { "id": "22-first-three-end-to-end-product-proofs", "anchor": "22-first-three-end-to-end-product-proofs", "title": "22. First three end-to-end product proofs", "level": 2 }, { "id": "proof-a--ten-minute-brownfield-x-ray", "anchor": "proof-a--ten-minute-brownfield-x-ray", "title": "Proof A — ten-minute brownfield x-ray", "level": 3 }, { "id": "proof-b--programmable-graph-loop", "anchor": "proof-b--programmable-graph-loop", "title": "Proof B — programmable graph loop", "level": 3 }, { "id": "proof-c--feature-to-production-symphony", "anchor": "proof-c--feature-to-production-symphony", "title": "Proof C — feature-to-production symphony", "level": 3 }, { "id": "proof-d--system-fabric-inspect-query-trace-and-reconcile", "anchor": "proof-d--system-fabric-inspect-query-trace-and-reconcile", "title": "Proof D — System Fabric inspect, query, trace, and reconcile", "level": 3 }, { "id": "23-delivery-program-and-gates", "anchor": "23-delivery-program-and-gates", "title": "23. Delivery program and gates", "level": 2 }, { "id": "gate-0--containment-and-unsafe-primitive-correction-weeks-02", "anchor": "gate-0--containment-and-unsafe-primitive-correction-weeks-02", "title": "Gate 0 — containment and unsafe primitive correction (weeks 0–2)", "level": 3 }, { "id": "gate-1--one-product-contract-and-trust-kernel-weeks-28", "anchor": "gate-1--one-product-contract-and-trust-kernel-weeks-28", "title": "Gate 1 — one product contract and trust kernel (weeks 2–8)", "level": 3 }, { "id": "gate-2--canonical-model-registry-and-read-wedge-weeks-412-parallel", "anchor": "gate-2--canonical-model-registry-and-read-wedge-weeks-412-parallel", "title": "Gate 2 — canonical model, registry, and read wedge (weeks 4–12, parallel)", "level": 3 }, { "id": "gate-3--release-factory-and-product-integrity-weeks-414-parallel", "anchor": "gate-3--release-factory-and-product-integrity-weeks-414-parallel", "title": "Gate 3 — release factory and product integrity (weeks 4–14, parallel)", "level": 3 }, { "id": "gate-4--edit-compile-persist-and-vertical-symphony-weeks-1022", "anchor": "gate-4--edit-compile-persist-and-vertical-symphony-weeks-1022", "title": "Gate 4 — edit, compile, persist, and vertical symphony (weeks 10–22)", "level": 3 }, { "id": "gate-5--operational-design-partner-beta-weeks-1830", "anchor": "gate-5--operational-design-partner-beta-weeks-1830", "title": "Gate 5 — operational design-partner beta (weeks 18–30)", "level": 3 }, { "id": "gate-6--field-proof-60-measured-days-after-gate-5", "anchor": "gate-6--field-proof-60-measured-days-after-gate-5", "title": "Gate 6 — field proof (60 measured days after Gate 5)", "level": 3 }, { "id": "gate-7--extension-ecosystem-and-scale-claims", "anchor": "gate-7--extension-ecosystem-and-scale-claims", "title": "Gate 7 — extension ecosystem and scale claims", "level": 3 }, { "id": "build-score-19--sequencing--six-phases-each-independently-shippable", "anchor": "build-score-19--sequencing--six-phases-each-independently-shippable", "title": "Build score §19 — Sequencing — six phases, each independently shippable", "level": 3 }, { "id": "24-workstreams-and-ownership", "anchor": "24-workstreams-and-ownership", "title": "24. Workstreams and ownership", "level": 2 }, { "id": "25-success-metrics", "anchor": "25-success-metrics", "title": "25. Success metrics", "level": 2 }, { "id": "product-outcomes", "anchor": "product-outcomes", "title": "Product outcomes", "level": 3 }, { "id": "guardrail-metrics", "anchor": "guardrail-metrics", "title": "Guardrail metrics", "level": 3 }, { "id": "26-migration-and-deprecation", "anchor": "26-migration-and-deprecation", "title": "26. Migration and deprecation", "level": 2 }, { "id": "27-open-decisions-which-must-be-resolved-deliberately", "anchor": "27-open-decisions-which-must-be-resolved-deliberately", "title": "27. Open decisions which must be resolved deliberately", "level": 2 }, { "id": "appendix-a--exhaustive-surface-disposition", "anchor": "appendix-a--exhaustive-surface-disposition", "title": "Appendix A — exhaustive surface disposition", "level": 2 }, { "id": "build-score-appendix-a--full-surface-disposition-74-authored--app-only", "anchor": "build-score-appendix-a--full-surface-disposition-74-authored--app-only", "title": "Build score appendix A — full surface disposition (74 authored + app-only)", "level": 3 }, { "id": "appendix-b--every-authored-pencil-action", "anchor": "appendix-b--every-authored-pencil-action", "title": "Appendix B — every authored Pencil action", "level": 2 }, { "id": "build-score-appendix-b--authored-action-disposition", "anchor": "build-score-appendix-b--authored-action-disposition", "title": "Build score appendix B — authored-action disposition", "level": 3 }, { "id": "appendix-c--reaktor-framework-leverage-map", "anchor": "appendix-c--reaktor-framework-leverage-map", "title": "Appendix C — Reaktor framework leverage map", "level": 2 }, { "id": "appendix-d--release-acceptance-matrix", "anchor": "appendix-d--release-acceptance-matrix", "title": "Appendix D — release acceptance matrix", "level": 2 }, { "id": "appendix-e--principal-evidence-map", "anchor": "appendix-e--principal-evidence-map", "title": "Appendix E — principal evidence map", "level": 2 }, { "id": "appendix-f--pencil-reference-contract-checkpoint", "anchor": "appendix-f--pencil-reference-contract-checkpoint", "title": "Appendix F — Pencil reference-contract checkpoint", "level": 2 }, { "id": "implemented-reference-contract", "anchor": "implemented-reference-contract", "title": "Implemented reference contract", "level": 3 }, { "id": "machine-signal-20-primitives-landed-in-the-reference-library", "anchor": "machine-signal-20-primitives-landed-in-the-reference-library", "title": "Machine Signal 2.0 primitives landed in the reference library", "level": 3 }, { "id": "reference-surfaces-updated", "anchor": "reference-surfaces-updated", "title": "Reference surfaces updated", "level": 3 }, { "id": "acceptance-evidence", "anchor": "acceptance-evidence", "title": "Acceptance evidence", "level": 3 }, { "id": "explicitly-not-complete", "anchor": "explicitly-not-complete", "title": "Explicitly not complete", "level": 3 }, { "id": "appendix-g--graph-studio-second-wave-checkpoint", "anchor": "appendix-g--graph-studio-second-wave-checkpoint", "title": "Appendix G — Graph Studio second-wave checkpoint", "level": 2 }, { "id": "reusable-graph-primitives-added", "anchor": "reusable-graph-primitives-added", "title": "Reusable graph primitives added", "level": 3 }, { "id": "full-system-graph-reference", "anchor": "full-system-graph-reference", "title": "Full-system graph reference", "level": 3 }, { "id": "measured-result", "anchor": "measured-result", "title": "Measured result", "level": 3 }, { "id": "appendix-h--system-fabric-and-data-studio-checkpoint", "anchor": "appendix-h--system-fabric-and-data-studio-checkpoint", "title": "Appendix H — System Fabric and Data Studio checkpoint", "level": 2 }, { "id": "verified-starting-point", "anchor": "verified-starting-point", "title": "Verified starting point", "level": 3 }, { "id": "immediate-stop-ship-findings-captured-by-gate-0", "anchor": "immediate-stop-ship-findings-captured-by-gate-0", "title": "Immediate stop-ship findings captured by Gate 0", "level": 3 }, { "id": "reusable-pencil-primitives-added", "anchor": "reusable-pencil-primitives-added", "title": "Reusable Pencil primitives added", "level": 3 }, { "id": "reference-frames-updated", "anchor": "reference-frames-updated", "title": "Reference frames updated", "level": 3 }, { "id": "explicitly-not-implemented-yet", "anchor": "explicitly-not-implemented-yet", "title": "Explicitly not implemented yet", "level": 3 }, { "id": "28-final-product-bar", "anchor": "28-final-product-bar", "title": "28. Final product bar", "level": 2 }, { "id": "build-score-appendix-c--what-this-plan-deliberately-does-not-do", "anchor": "build-score-appendix-c--what-this-plan-deliberately-does-not-do", "title": "Build score appendix C — what this plan deliberately does not do", "level": 3 } ], "links": [] }, { "id": "reaktor-desktop-v3", "owner": "Prototype", "kind": "artifact", "summary": "Interactive high-fidelity desktop workbench artifact.", "use": "Use to inspect the current visual target and interaction model.", "region": "background-research", "order": 8, "title": "Reaktor Desktop v3", "nav": "Desktop v3", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-desktop-v3", "revision": "4a4c32bbb0478705da4afe5fba173d5ea318c10d5e2da9f2225554efa1dd4a99", "status": "historical", "renderingRevision": "f7a06d8c823e0a79d28793b3145efa44fd3e5dc57c10d9d3bab464e7e7a87a36", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-desktop-v3", "polarity": "Neutral" }, { "id": "section-interactive-artifact", "anchor": "interactive-artifact", "label": "Interactive artifact", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-v3#interactive-artifact", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-desktop-v3#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-desktop-v3:references-reaktor-architecture-analysis", "kind": "references", "owner": "reaktor-desktop-v3", "incidences": [ { "node": "reaktor-desktop-v3", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-architecture-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-desktop-v3:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-desktop-v3", "incidences": [ { "node": "reaktor-desktop-v3", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-desktop-v3:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-desktop-v3", "incidences": [ { "node": "reaktor-desktop-v3", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-desktop-v3:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-desktop-v3", "incidences": [ { "node": "reaktor-desktop-v3", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-desktop-v3:references-reaktor-workbench-roadmap", "kind": "references", "owner": "reaktor-desktop-v3", "incidences": [ { "node": "reaktor-desktop-v3", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-desktop-v3:references-reaktor-arena", "kind": "references", "owner": "reaktor-desktop-v3", "incidences": [ { "node": "reaktor-desktop-v3", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-arena", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-desktop-v3.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Desktop v3", "level": 0 }, { "id": "interactive-artifact", "anchor": "interactive-artifact", "title": "Interactive artifact", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-architecture-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-arena", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-devops", "owner": "Claude", "kind": "build-tools", "summary": "The build/deploy/operate plane: deployment and capacity as graph operations, one app partitioned across runtime targets and GCP/k3s cells, Dagger pipeline-as-code, Pulumi materializers, gated operations, Reaktor-managed capacity, customer-owned GCP cell attachment, and reaktorDesktop as the developer portal.", "use": "Use before changing the build/deploy/ops pipeline, Kotlin platform model, deployment partitioning, GCP cell capacity operations, customer-owned cluster attachment, gated deploy operations, or the reaktorDesktop Deploy pane.", "region": "ship-toolchain", "order": 3, "title": "Reaktor DevOps — build, deploy, and operate the graph", "nav": "DevOps", "group": "ship", "subsection": "ship-toolchain", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-devops", "revision": "9b9e4c44c7c219f3af6fd7ab6ddccf09c8e8d77b2ec2b4620888d8a1196b2096", "status": "unverified", "renderingRevision": "f41df827e7a289d405374d06030b73c96adf1df1d9f5e52274bec3e7bfc62b69", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.pulumi.com/docs/", "https://www.pulumi.com/docs/using-pulumi/automation-api/", "https://developer.hashicorp.com/terraform", "https://opentofu.org/", "https://www.crossplane.io/", "https://argo-cd.readthedocs.io/", "https://fluxcd.io/", "https://opengitops.dev/", "https://argoproj.github.io/rollouts/", "https://dagger.io/", "https://docs.github.com/actions", "https://spinnaker.io/", "https://kubernetes.io/", "https://k3s.io/", "https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/", "https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/", "https://backstage.io/", "https://backstage.io/docs/features/software-catalog/", "https://backstage.io/docs/features/software-templates/", "https://humanitec.com/", "https://www.getport.io/", "https://score.dev/", "https://clutch.sh/", "https://teamtopologies.com/", "https://engineering.atspotify.com/2020/08/how-we-use-golden-paths-to-solve-fragmentation-in-our-software-ecosystem/", "https://netflixtechblog.com/", "https://12factor.net/", "https://vercel.com/docs/deployments/preview-deployments", "https://fly.io/", "https://sre.google/books/", "https://dora.dev/", "https://queue.acm.org/detail.cfm?id=1142065" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-devops", "polarity": "Neutral" }, { "id": "section-requirements", "anchor": "requirements", "label": "1. What teams actually need from devops", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#requirements", "polarity": "Neutral" }, { "id": "section-landscape", "anchor": "landscape", "label": "2. The landscape — what the industry built, and what it learned", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#landscape", "polarity": "Neutral" }, { "id": "section-gaps", "anchor": "gaps", "label": "3. What today's tools still get wrong", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#gaps", "polarity": "Neutral" }, { "id": "section-bet", "anchor": "bet", "label": "4. Reaktor's bet — deployment is a graph operation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#bet", "polarity": "Neutral" }, { "id": "section-design", "anchor": "design", "label": "5. The design, component by component", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#design", "polarity": "Neutral" }, { "id": "section-prior-art", "anchor": "prior-art", "label": "6. Relationship to Backstage & Crossplane — what we adopt, what we build", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#prior-art", "polarity": "Neutral" }, { "id": "section-environments", "anchor": "environments", "label": "5.4 Environments, GitOps & safe releases", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#environments", "polarity": "Neutral" }, { "id": "section-operations", "anchor": "operations", "label": "5.5 Operations on the graph — safe, audited, agent-runnable", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#operations", "polarity": "Neutral" }, { "id": "section-desktop", "anchor": "desktop", "label": "5.7 reaktorDesktop — the developer portal", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#desktop", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "See also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#see-also", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devops#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-devops:references-operations", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-operations-delivery", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-secrets-management", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-requirements", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-performance-observability", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-requirements", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-reaktor-server", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-bet", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-bet", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-environments", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-environments", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-reaktor-server-progressive-delivery", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-environments", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-progressive-delivery", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-operations", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-codex-roadmap", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-desktop", "role": "source", "ordinal": 0 }, { "node": "codex-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-reaktor-cli", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devops:references-auth-analysis", "kind": "references", "owner": "reaktor-devops", "incidences": [ { "node": "reaktor-devops", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-devops.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor DevOps — build, deploy, and operate the graph", "level": 0 }, { "id": "requirements", "anchor": "requirements", "title": "1. What teams actually need from devops", "level": 2 }, { "id": "landscape", "anchor": "landscape", "title": "2. The landscape — what the industry built, and what it learned", "level": 2 }, { "id": "gaps", "anchor": "gaps", "title": "3. What today's tools still get wrong", "level": 2 }, { "id": "bet", "anchor": "bet", "title": "4. Reaktor's bet — deployment is a graph operation", "level": 2 }, { "id": "design", "anchor": "design", "title": "5. The design, component by component", "level": 2 }, { "id": "model", "anchor": "model", "title": "5.1 One typed platform model → materializers", "level": 3 }, { "id": "partition", "anchor": "partition", "title": "5.2 Deployment = partition the graph", "level": 3 }, { "id": "dagger", "anchor": "dagger", "title": "5.3 Dagger — the pipeline as code", "level": 3 }, { "id": "environments", "anchor": "environments", "title": "5.4 Environments, GitOps & safe releases", "level": 3 }, { "id": "operations", "anchor": "operations", "title": "5.5 Operations on the graph — safe, audited, agent-runnable", "level": 3 }, { "id": "fleet", "anchor": "fleet", "title": "5.6 GCP fleet operations — capacity and customer-owned cells", "level": 3 }, { "id": "desktop", "anchor": "desktop", "title": "5.7 reaktorDesktop — the developer portal", "level": 3 }, { "id": "prior-art", "anchor": "prior-art", "title": "6. Relationship to Backstage & Crossplane — what we adopt, what we build", "level": 2 }, { "id": "coverage", "anchor": "coverage", "title": "7. What we cover, and what we don't", "level": 2 }, { "id": "phases", "anchor": "phases", "title": "8. Build plan", "level": 2 }, { "id": "open", "anchor": "open", "title": "9. Open decisions", "level": 2 }, { "id": "references", "anchor": "references", "title": "10. References", "level": 2 }, { "id": "infrastructure-as-code--gitops", "anchor": "infrastructure-as-code--gitops", "title": "Infrastructure as code & GitOps", "level": 3 }, { "id": "cicd--pipelines", "anchor": "cicd--pipelines", "title": "CI/CD & pipelines", "level": 3 }, { "id": "orchestration", "anchor": "orchestration", "title": "Orchestration", "level": 3 }, { "id": "platform-engineering--internal-developer-platforms", "anchor": "platform-engineering--internal-developer-platforms", "title": "Platform engineering & internal developer platforms", "level": 3 }, { "id": "developer-experience--method", "anchor": "developer-experience--method", "title": "Developer experience & method", "level": 3 }, { "id": "see-also", "anchor": "see-also", "title": "See also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "requirements" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "bet" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "bet" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "environments" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "environments" }, { "id": "reaktor-server", "anchor": "progressive-delivery", "relation": "references", "sourceAnchor": "environments" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "operations" }, { "id": "codex-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "desktop" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "coverage" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "open" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-devtools", "owner": "Claude", "kind": "architecture", "summary": "The workbench pane that mirrors real Android and iOS phones side by side and shows what the app is doing: the UI tree from each phone with parity and accessibility checks, network capture with a query language, HAR export, network conditions and blocking, logs, a timeline whose filmstrip replays the screen, Lighthouse-style audits scored on Lighthouse's curve against Android vitals and Apple thresholds, graph port stats and device controls. Compared with Chrome DevTools, Lighthouse, Android Studio, Xcode, VS Code, Flutter and React Native DevTools, Unreal's tools and measure.sh.", "use": "Read before changing the DevTools pane, the reaktor-devtools agent or reaktor-io's HTTP capture. Section 1 is the architecture and the capability table, section 3 the audit scoring with its sources, section 5 the known limits and section 7 the roadmap ordered by value.", "region": "operations-diagnostics", "order": 3, "title": "Reaktor DevTools", "nav": "DevTools", "group": "operations", "subsection": "operations-diagnostics", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-devtools", "revision": "234c4f6970543dca39059afdeefe937ff6041a3946785d22e7fc72d1c9e97c40", "status": "unverified", "renderingRevision": "24c420df38d97f7cd15b2957b16d3a275ccce1f775ab41b498de5c5114be7519", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developer.chrome.com/docs/devtools", "https://developer.chrome.com/blog/chrome-devtools-mcp", "https://developer.chrome.com/docs/lighthouse/performance/performance-scoring", "https://developer.android.com/studio/debug/layout-inspector", "https://developer.android.com/studio/profile/jank-detection", "https://developer.android.com/studio/debug/logcat", "https://developer.android.com/topic/performance/vitals/render", "https://developer.android.com/topic/performance/vitals/launch-time", "https://developer.android.com/topic/performance/vitals/anr", "https://developer.apple.com/documentation/xcode/understanding-hangs-in-your-app", "https://developer.apple.com/documentation/xcode/understanding-hitches-in-your-app", "https://developer.apple.com/documentation/xcode/reducing-your-app-s-launch-time", "https://code.visualstudio.com/docs/debugtest/debugging", "https://docs.flutter.dev/tools/devtools/performance", "https://reactnative.dev/docs/react-native-devtools", "https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-insights-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/animation-rewind-debugger-in-unreal-engine", "https://measure.sh/docs", "https://github.com/bamlab/flashlight" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-devtools", "polarity": "Neutral" }, { "id": "section-at-a-glance", "anchor": "at-a-glance", "label": "At a glance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devtools#at-a-glance", "polarity": "Neutral" }, { "id": "section-operations-and-shadow-integration", "anchor": "operations-and-shadow-integration", "label": "Operations and Shadow integration", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devtools#operations-and-shadow-integration", "polarity": "Neutral" }, { "id": "section-how-it-works", "anchor": "how-it-works", "label": "1. How it works", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devtools#how-it-works", "polarity": "Neutral" }, { "id": "section-tabs", "anchor": "tabs", "label": "2. The pane, tab by tab", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devtools#tabs", "polarity": "Neutral" }, { "id": "section-audits", "anchor": "audits", "label": "3. How the audit scores work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devtools#audits", "polarity": "Neutral" }, { "id": "section-verified", "anchor": "verified", "label": "4. Checked on real phones", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devtools#verified", "polarity": "Neutral" }, { "id": "section-investigation", "anchor": "investigation", "label": "The investigation model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-devtools#investigation", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-devtools:references-operations", "kind": "references", "owner": "reaktor-devtools", "incidences": [ { "node": "reaktor-devtools", "port": "section-operations-and-shadow-integration", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devtools:references-operations-instance-diagnostics", "kind": "references", "owner": "reaktor-devtools", "incidences": [ { "node": "reaktor-devtools", "port": "section-operations-and-shadow-integration", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devtools:references-operations-profiling", "kind": "references", "owner": "reaktor-devtools", "incidences": [ { "node": "reaktor-devtools", "port": "section-operations-and-shadow-integration", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devtools:references-shadow-clients-agents", "kind": "references", "owner": "reaktor-devtools", "incidences": [ { "node": "reaktor-devtools", "port": "section-operations-and-shadow-integration", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devtools:references-operations-crashlytics", "kind": "references", "owner": "reaktor-devtools", "incidences": [ { "node": "reaktor-devtools", "port": "section-operations-and-shadow-integration", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "section-shadow-investigation", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-devtools:references-reaktor-graph-pane", "kind": "references", "owner": "reaktor-devtools", "incidences": [ { "node": "reaktor-devtools", "port": "section-how-it-works", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-devtools.json", "sections": [ { "id": "reaktor-devtools", "anchor": "reaktor-devtools", "title": "Reaktor DevTools", "level": 1 }, { "id": "at-a-glance", "anchor": "at-a-glance", "title": "At a glance", "level": 2 }, { "id": "operations-and-shadow-integration", "anchor": "operations-and-shadow-integration", "title": "Operations and Shadow integration", "level": 2 }, { "id": "how-it-works", "anchor": "how-it-works", "title": "1. How it works", "level": 2 }, { "id": "tabs", "anchor": "tabs", "title": "2. The pane, tab by tab", "level": 2 }, { "id": "screens", "anchor": "screens", "title": "Screens", "level": 3 }, { "id": "elements", "anchor": "elements", "title": "Elements", "level": 3 }, { "id": "network", "anchor": "network", "title": "Network", "level": 3 }, { "id": "timeline", "anchor": "timeline", "title": "Timeline and replay", "level": 3 }, { "id": "audits-tab", "anchor": "audits-tab", "title": "Audits", "level": 3 }, { "id": "graph", "anchor": "graph", "title": "Graph", "level": 3 }, { "id": "device", "anchor": "device", "title": "Device", "level": 3 }, { "id": "sessions", "anchor": "sessions", "title": "Saved sessions", "level": 3 }, { "id": "agents", "anchor": "agents", "title": "For coding agents", "level": 3 }, { "id": "audits", "anchor": "audits", "title": "3. How the audit scores work", "level": 2 }, { "id": "verified", "anchor": "verified", "title": "4. Checked on real phones", "level": 2 }, { "id": "limits", "anchor": "limits", "title": "5. Known limits", "level": 2 }, { "id": "compare", "anchor": "compare", "title": "6. How it compares", "level": 2 }, { "id": "roadmap", "anchor": "roadmap", "title": "7. Roadmap", "level": 2 }, { "id": "design", "anchor": "design", "title": "8. Design direction", "level": 2 }, { "id": "investigation", "anchor": "investigation", "title": "The investigation model", "level": 3 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "operations-and-shadow-integration" }, { "id": "operations-crashlytics", "anchor": "", "relation": "references", "sourceAnchor": "operations-and-shadow-integration" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "operations-and-shadow-integration" }, { "id": "shadow-verification", "anchor": "privacy-and-effect-safety", "relation": "references", "sourceAnchor": "operations-and-shadow-integration" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "operations-and-shadow-integration" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "operations-and-shadow-integration" }, { "id": "reaktor-graph-pane", "anchor": "", "relation": "references", "sourceAnchor": "how-it-works" } ] }, { "id": "reaktor-distributed-actors", "owner": "Codex", "kind": "architecture", "summary": "Location-transparent actors across k3s JVM pods and Cloudflare Durable Objects.", "use": "Use for cluster membership, sharding, supervision, and durable transport planning.", "region": "graph-model", "order": 5, "title": "Reaktor Distributed Actors", "nav": "Distributed Actors", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-distributed-actors", "revision": "0556f0883bd3262a1cbc1e54c1ff7e3488fd08bf500e7c1af7c37e0e18bd5bdd", "status": "unverified", "renderingRevision": "96caae214ffc4ed6cc22d1fcbf8483488849393dcf0f320be0bc22e407aec7df", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.erlang.org/doc/design_principles/des_princ.html", "https://learn.microsoft.com/en-us/dotnet/orleans/overview", "https://doc.akka.io/docs/akka/current/typed/cluster-sharding.html", "https://cloud.google.com/pubsub/docs/ordering", "https://developers.cloudflare.com/durable-objects/", "https://www.cs.cornell.edu/home/sam/FBS/abstracts.html#hayashibara", "https://en.wikipedia.org/wiki/Rendezvous_hashing", "https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-distributed-actors", "polarity": "Neutral" }, { "id": "section-summary", "anchor": "summary", "label": "1. Executive summary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#summary", "polarity": "Neutral" }, { "id": "section-today", "anchor": "today", "label": "2. What exists today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#today", "polarity": "Neutral" }, { "id": "section-erlang-bar", "anchor": "erlang-bar", "label": "3. The Erlang/OTP bar — what \"used like Erlang\" means", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#erlang-bar", "polarity": "Neutral" }, { "id": "section-mapping", "anchor": "mapping", "label": "4. Erlang/OTP ↔ Reaktor mapping", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#mapping", "polarity": "Neutral" }, { "id": "section-substrate", "anchor": "substrate", "label": "5. Substrate reality check", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#substrate", "polarity": "Neutral" }, { "id": "section-two-runtimes", "anchor": "two-runtimes", "label": "6. Two runtimes, one ActorRef", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#two-runtimes", "polarity": "Neutral" }, { "id": "section-edge", "anchor": "edge", "label": "16. Cloudflare edge actors", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#edge", "polarity": "Neutral" }, { "id": "section-sharding", "anchor": "sharding", "label": "9. Sharding & the coordinator", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#sharding", "polarity": "Neutral" }, { "id": "section-delivery", "anchor": "delivery", "label": "14. Delivery & ordering", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#delivery", "polarity": "Neutral" }, { "id": "section-observability", "anchor": "observability", "label": "20. Observability", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#observability", "polarity": "Neutral" }, { "id": "section-chaos", "anchor": "chaos", "label": "21. Chaos & correctness testing", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#chaos", "polarity": "Neutral" }, { "id": "section-references-3", "anchor": "references-3", "label": "Spec & peer designs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#references-3", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-distributed-actors#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-distributed-actors:references-reaktor-multitenancy-edge", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "section-edge", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-substrate", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-db-consistency", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-substrate", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-consistency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-notifications-design", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-delivery", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-performance-observability", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-observability", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-chaos", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-server", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-distributed-actors:references-reaktor-megascale-strategy", "kind": "references", "owner": "reaktor-distributed-actors", "incidences": [ { "node": "reaktor-distributed-actors", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-megascale-strategy", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-distributed-actors.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Distributed Actors", "level": 0 }, { "id": "summary", "anchor": "summary", "title": "1. Executive summary", "level": 2 }, { "id": "today", "anchor": "today", "title": "2. What exists today", "level": 2 }, { "id": "erlang-bar", "anchor": "erlang-bar", "title": "3. The Erlang/OTP bar — what \"used like Erlang\" means", "level": 2 }, { "id": "location-transparency", "anchor": "location-transparency", "title": "Location transparency", "level": 4 }, { "id": "let-it-crash", "anchor": "let-it-crash", "title": "Let-it-crash", "level": 4 }, { "id": "supervision-trees", "anchor": "supervision-trees", "title": "Supervision trees", "level": 4 }, { "id": "links--monitors", "anchor": "links--monitors", "title": "Links & monitors", "level": 4 }, { "id": "node-membership", "anchor": "node-membership", "title": "Node membership", "level": 4 }, { "id": "cheap-numerous-addressable", "anchor": "cheap-numerous-addressable", "title": "Cheap, numerous, addressable", "level": 4 }, { "id": "back-pressure", "anchor": "back-pressure", "title": "Back-pressure", "level": 4 }, { "id": "hot-failover", "anchor": "hot-failover", "title": "Hot failover", "level": 4 }, { "id": "mapping", "anchor": "mapping", "title": "4. Erlang/OTP ↔ Reaktor mapping", "level": 2 }, { "id": "substrate", "anchor": "substrate", "title": "5. Substrate reality check", "level": 2 }, { "id": "two-runtimes", "anchor": "two-runtimes", "title": "6. Two runtimes, one ActorRef", "level": 2 }, { "id": "core-jvm-actors-on-k3s", "anchor": "core-jvm-actors-on-k3s", "title": "core JVM actors on k3s", "level": 4 }, { "id": "edge-cloudflare-durable-objects", "anchor": "edge-cloudflare-durable-objects", "title": "edge Cloudflare Durable Objects", "level": 4 }, { "id": "two-runtimes-2", "anchor": "two-runtimes-2", "title": "The unifying reference", "level": 4 }, { "id": "membership", "anchor": "membership", "title": "7. Cluster membership (the EPMD / net_kernel replacement)", "level": 2 }, { "id": "membership-2", "anchor": "membership-2", "title": "7.1 Stable identities via StatefulSet", "level": 3 }, { "id": "membership-3", "anchor": "membership-3", "title": "7.2 Discovery + failure detection", "level": 3 }, { "id": "addressing", "anchor": "addressing", "title": "8. Addressing & the grain directory", "level": 2 }, { "id": "addressing-2", "anchor": "addressing-2", "title": "8.1 Cluster address", "level": 3 }, { "id": "addressing-3", "anchor": "addressing-3", "title": "8.2 Resolution", "level": 3 }, { "id": "addressing-4", "anchor": "addressing-4", "title": "8.3 The directory", "level": 3 }, { "id": "sharding", "anchor": "sharding", "title": "9. Sharding & the coordinator", "level": 2 }, { "id": "sharding-2", "anchor": "sharding-2", "title": "9.1 The coordinator", "level": 3 }, { "id": "transport", "anchor": "transport", "title": "10. Remote transport", "level": 2 }, { "id": "virtual", "anchor": "virtual", "title": "11. Virtual actors (Orleans grains)", "level": 2 }, { "id": "activation", "anchor": "activation", "title": "Activation", "level": 4 }, { "id": "passivation", "anchor": "passivation", "title": "Passivation", "level": 4 }, { "id": "migration", "anchor": "migration", "title": "Migration", "level": 4 }, { "id": "affinity", "anchor": "affinity", "title": "Affinity", "level": 4 }, { "id": "state", "anchor": "state", "title": "12. State & recovery", "level": 2 }, { "id": "supervision", "anchor": "supervision", "title": "13. Distributed supervision", "level": 2 }, { "id": "supervision-2", "anchor": "supervision-2", "title": "13.1 Node-level supervision", "level": 3 }, { "id": "supervision-3", "anchor": "supervision-3", "title": "13.2 watch / monitor across the network", "level": 3 }, { "id": "supervision-4", "anchor": "supervision-4", "title": "13.3 Poison-message handling", "level": 3 }, { "id": "delivery", "anchor": "delivery", "title": "14. Delivery & ordering", "level": 2 }, { "id": "splitbrain", "anchor": "splitbrain", "title": "15. Split-brain & single-writer safety", "level": 2 }, { "id": "edge", "anchor": "edge", "title": "16. Cloudflare edge actors", "level": 2 }, { "id": "edge-2", "anchor": "edge-2", "title": "16.1 DO as ActorRef", "level": 3 }, { "id": "edge-3", "anchor": "edge-3", "title": "16.2 Edge ↔ core bridge", "level": 3 }, { "id": "topology", "anchor": "topology", "title": "17. Global topology", "level": 2 }, { "id": "k3s", "anchor": "k3s", "title": "18. k3s manifests", "level": 2 }, { "id": "multiregion", "anchor": "multiregion", "title": "19. Multi-region", "level": 2 }, { "id": "observability", "anchor": "observability", "title": "20. Observability", "level": 2 }, { "id": "chaos", "anchor": "chaos", "title": "21. Chaos & correctness testing", "level": 2 }, { "id": "plan", "anchor": "plan", "title": "22. Phased plan", "level": 2 }, { "id": "wire-format--externalised-state", "anchor": "wire-format--externalised-state", "title": "Wire format & externalised state", "level": 4 }, { "id": "single-region-membership--grpc-transport", "anchor": "single-region-membership--grpc-transport", "title": "Single-region membership + gRPC transport", "level": 4 }, { "id": "sharding--coordinator--location-transparent-actorref", "anchor": "sharding--coordinator--location-transparent-actorref", "title": "Sharding + coordinator + location-transparent ActorRef", "level": 4 }, { "id": "virtual-actors", "anchor": "virtual-actors", "title": "Virtual actors", "level": 4 }, { "id": "pubsub-durable-path--idempotent-receive", "anchor": "pubsub-durable-path--idempotent-receive", "title": "Pub/Sub durable path + idempotent receive", "level": 4 }, { "id": "distributed-supervision--watchmonitor", "anchor": "distributed-supervision--watchmonitor", "title": "Distributed supervision + watch/monitor", "level": 4 }, { "id": "cloudflare-edge-actors-under-one-actorref", "anchor": "cloudflare-edge-actors-under-one-actorref", "title": "Cloudflare edge actors under one ActorRef", "level": 4 }, { "id": "split-brain-safety--multi-region", "anchor": "split-brain-safety--multi-region", "title": "Split-brain safety + multi-region", "level": 4 }, { "id": "observability--chaos-suite", "anchor": "observability--chaos-suite", "title": "Observability + chaos suite", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "23. Risks & open questions", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Risks", "level": 4 }, { "id": "risks-3", "anchor": "risks-3", "title": "Open questions", "level": 4 }, { "id": "references", "anchor": "references", "title": "24. References", "level": 2 }, { "id": "references-2", "anchor": "references-2", "title": "Real code this design builds on", "level": 4 }, { "id": "references-3", "anchor": "references-3", "title": "Spec & peer designs", "level": 4 }, { "id": "references-4", "anchor": "references-4", "title": "External — distributed actor systems", "level": 4 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-multitenancy", "anchor": "edge", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "substrate" }, { "id": "reaktor-db", "anchor": "consistency", "relation": "references", "sourceAnchor": "substrate" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "delivery" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "observability" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "chaos" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "risks-3" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "references-4" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-megascale-strategy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-essays", "owner": "Claude + Codex", "kind": "overview", "summary": "Two independent technical essays written to the same brief without either author seeing the other's work: Claude (Fable 5) argues from what a live runtime graph makes possible, Codex argues from what a small trusted semantic kernel makes provable. Both are reproduced verbatim.", "use": "Read first for the shortest statement of what Reaktor is and why it matters — to developers, to end users, and to investors — then read the Framework Overview for the full model.", "region": "start-here-core", "order": 2, "title": "Reaktor Essays — Two Readings", "nav": "Reaktor Essays", "group": "start-here", "subsection": "start-here-core", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-essays", "revision": "ff128f7714c56f094e8ec28b599581b861ca41c1f30536c0e699c37bfbaa0be3", "status": "unverified", "renderingRevision": "4adf76bfe713df7999a85bcd9e9ab746a1b46996fa6611cae09225ece94ed9ee", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://claude.ai/code/artifact/3b865775-c7b6-42e3-abc1-8bdcf4a1650e" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-essays", "polarity": "Neutral" }, { "id": "section-essay-one--claude-fable-5", "anchor": "essay-one--claude-fable-5", "label": "Essay one — Claude (Fable 5)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-essays#essay-one--claude-fable-5", "polarity": "Neutral" }, { "id": "section-essay-two--codex", "anchor": "essay-two--codex", "label": "Essay two — Codex", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-essays#essay-two--codex", "polarity": "Neutral" }, { "id": "section-v-one-data-plane-many-languages", "anchor": "v-one-data-plane-many-languages", "label": "V. One data plane, many languages", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-essays#v-one-data-plane-many-languages", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-essays:references-flexbuffer-performance-review", "kind": "references", "owner": "reaktor-essays", "incidences": [ { "node": "reaktor-essays", "port": "section-v-one-data-plane-many-languages", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-essays:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "reaktor-essays", "incidences": [ { "node": "reaktor-essays", "port": "section-v-one-data-plane-many-languages", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-essays.json", "sections": [ { "id": "reaktor-essays--two-readings", "anchor": "reaktor-essays--two-readings", "title": "Reaktor Essays — Two Readings", "level": 1 }, { "id": "essay-one--claude-fable-5", "anchor": "essay-one--claude-fable-5", "title": "Essay one — Claude (Fable 5)", "level": 2 }, { "id": "the-reaktor-thesis", "anchor": "the-reaktor-thesis", "title": "The Reaktor Thesis", "level": 3 }, { "id": "i-the-system-is-invisible", "anchor": "i-the-system-is-invisible", "title": "I. The system is invisible", "level": 3 }, { "id": "ii-the-graph-is-the-system", "anchor": "ii-the-graph-is-the-system", "title": "II. The graph is the system", "level": 3 }, { "id": "iii-primitives-chosen-like-basis-vectors", "anchor": "iii-primitives-chosen-like-basis-vectors", "title": "III. Primitives chosen like basis vectors", "level": 3 }, { "id": "iv-what-a-live-graph-buys", "anchor": "iv-what-a-live-graph-buys", "title": "IV. What a live graph buys", "level": 3 }, { "id": "v-one-data-plane-many-languages", "anchor": "v-one-data-plane-many-languages", "title": "V. One data plane, many languages", "level": 3 }, { "id": "vi-why-kotlin", "anchor": "vi-why-kotlin", "title": "VI. Why Kotlin", "level": 3 }, { "id": "vii-stability-as-a-program-not-a-hope", "anchor": "vii-stability-as-a-program-not-a-hope", "title": "VII. Stability as a program, not a hope", "level": 3 }, { "id": "viii-opinionated-where-it-counts", "anchor": "viii-opinionated-where-it-counts", "title": "VIII. Opinionated where it counts", "level": 3 }, { "id": "ix-what-this-means-for-you", "anchor": "ix-what-this-means-for-you", "title": "IX. What this means for you", "level": 3 }, { "id": "x-the-bet", "anchor": "x-the-bet", "title": "X. The bet", "level": 3 }, { "id": "essay-two--codex", "anchor": "essay-two--codex", "title": "Essay two — Codex", "level": 2 }, { "id": "reaktor-as-a-trustworthy-programmable-runtime", "anchor": "reaktor-as-a-trustworthy-programmable-runtime", "title": "Reaktor as a trustworthy programmable runtime", "level": 3 } ], "links": [ { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "v-one-data-plane-many-languages" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "v-one-data-plane-many-languages" } ] }, { "id": "reaktor-examples-capabilities", "owner": "Reaktor", "kind": "design", "summary": "7 worked bolt-on capabilities designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "capability-navigation", "src": "/docs/img/theory/capability-navigation.svg", "alt": "Navigation: nested containers, deep links and modal return", "text": "How does a route cross a nested feature boundary?\nKotlin parses the incoming URL into a typed payload, resolves the container path and computes the return continuation.\nentry: Deep-link resolver (N12)\nentry.destination: P11; RouteAddressV1; Offer\ncontainer: Feature container (N10)\ncontainer.destination: P11; RouteAddressV1; Require\ncontainer.child: P19; AccountRouteV1; Require\ncontainer.owner: P24; OwnerRefV1; Neutral\nroute: Account route (N12)\nroute.export: P19; AccountRouteV1; Offer\nroute.destination: P11; AccountRouteV1; Offer\nroute.authority: P20; RouteGrantV1; Require\nroute.owned: P24; DefinitionRefV1; Neutral\nscreen: Account Surface (N11)\nscreen.route: P11; AccountRouteV1; Require\nscreen.approve: P11; ApprovalRouteV1; Offer\nmodal: Approval Surface (N11)\nmodal.route: P11; ApprovalRouteV1; Require\nmodal.continuation: P24; ContinuationRefV1; Neutral\ngate: Route policy (N33)\ngate.grant: P20; RouteGrantV1; Offer\nentry (H36): provider[0]=entry.destination; consumer[0]=container.destination\nexport (H30): provider[0]=route.export; consumer[0]=container.child\nscreen (H36): provider[0]=route.destination; consumer[0]=screen.route\nmodal (H36): provider[0]=screen.approve; consumer[0]=modal.route\ngrant (H23): provider[0]=gate.grant; consumer[0]=route.authority\nownership (H19): parent[0]=container.owner; child[1]=route.owned; return[2]=modal.continuation" }, { "id": "capability-auth", "src": "/docs/img/theory/capability-auth.svg", "alt": "Authorization: delegation, expiry and effect admission", "text": "Can a delegated agent execute the same operation a human proposed?\nNormal Kotlin policy code evaluates principal, resource, operation, revision and time, then produces a bounded decision for the current request.\nhuman: Human principal (N33)\nhuman.delegation: P24; PrincipalRefV1; Neutral\nagent: Agent proposer (N39)\nagent.proposal: P01; EffectProposalV1; Offer\nagent.identity: P24; PrincipalRefV1; Neutral\npolicy: Policy evaluator (N33)\npolicy.decision: P20; PolicyDecisionV1; Offer\ngate: Effect admission (N33)\ngate.proposal: P01; EffectProposalV1; Require\ngate.policy: P20; PolicyDecisionV1; Require\ngate.effect: P02; PrivilegedOperationV1; Require\ngate.receipt: P24; EffectReceiptV1; Offer\ngate.admission: P24; AuthorityRefV1; Neutral\nservice: Privileged service (N19)\nservice.operation: P02; PrivilegedOperationV1; Offer\nservice.resource: P24; ResourceRefV1; Neutral\nreceipt: Audit receipt (N37)\nreceipt.effect: P24; EffectReceiptV1; Require\nproposal (H02): provider[0]=agent.proposal; consumer[0]=gate.proposal\ndecision (H23): provider[0]=policy.decision; consumer[0]=gate.policy\nexecute (H05): provider[0]=service.operation; consumer[0]=gate.effect\nreceipt (H27): provider[0]=gate.receipt; consumer[0]=receipt.effect\ndelegation (H23): delegator[0]=human.delegation; delegate[1]=agent.identity; resource[2]=service.resource; admission[3]=gate.admission" }, { "id": "capability-telemetry", "src": "/docs/img/theory/capability-telemetry.svg", "alt": "Telemetry: graph attribution, sampling and privacy", "text": "How can a span identify a graph operation without leaking its payload?\nA Kotlin sampler uses deterministic operation identity and declared budget. The interceptor emits approved metadata before any exporter runs.\napp: Application operation (N02)\napp.span: P24; SpanEnvelopeV1; Offer\napp.definition: P24; DefinitionRefV1; Neutral\ninterceptor: Port interceptor (N38)\ninterceptor.span: P24; SpanEnvelopeV1; Require\ninterceptor.capture: P20; CaptureGrantV1; Require\ninterceptor.envelope: P01; RedactedSpanV1; Offer\ninterceptor.activation: P24; ActivationRefV1; Neutral\npolicy: Capture / privacy policy (N33)\npolicy.grant: P20; CaptureGrantV1; Offer\nsampler: Sampling logic (N01)\nsampler.input: P01; RedactedSpanV1; Require\nsampler.selected: P04; RedactedSpanV1; Offer\nexporter: OTel exporter (N19)\nexporter.input: P04; RedactedSpanV1; Require\nexporter.backend: P02; TelemetryBatchV1; Require\ncollector: Observability backend (N30)\ncollector.ingest: P02; TelemetryBatchV1; Offer\ncollector.observation: P24; ObservationRefV1; Neutral\nspan (H04): provider[0]=app.span; consumer[0]=interceptor.span\npolicy (H23): provider[0]=policy.grant; consumer[0]=interceptor.capture\nsample (H02): provider[0]=interceptor.envelope; consumer[0]=sampler.input\nexport (H02): provider[0]=sampler.selected; consumer[0]=exporter.input\nbackend (H05): provider[0]=collector.ingest; consumer[0]=exporter.backend\nattribution (H27): definition[0]=app.definition; activation[1]=interceptor.activation; observation[2]=collector.observation" }, { "id": "capability-services", "src": "/docs/img/theory/capability-services.svg", "alt": "Service composition: retry, fallback and contract evolution", "text": "When is a fallback semantically compatible with the primary service?\nOrdinary Kotlin evaluates error class, deadline and fallback freshness. Typed request/response DTOs remain shared KMP code.\nclient: Typed client logic (N02)\nclient.primary: P02; SearchV1; Require\nclient.fallback: P02; SearchV1; Require\nclient.budget: P08; CallBudgetV1; Require\nclient.authority: P20; ServiceGrantV1; Require\nclient.selector: P24; SelectorRefV1; Neutral\nprimary: Primary service (N19)\nprimary.api: P02; SearchV1; Offer\nprimary.profile: P24; ServiceProfileV1; Neutral\nprimary.implementation: P24; ImplementationRefV1; Neutral\nfallback: Qualified fallback (N19)\nfallback.api: P02; SearchV1; Offer\nfallback.profile: P24; ServiceProfileV1; Neutral\nfallback.implementation: P24; ImplementationRefV1; Neutral\nbreaker: Circuit / budget state (N05)\nbreaker.budget: P08; CallBudgetV1; Offer\npolicy: Invocation policy (N33)\npolicy.grant: P20; ServiceGrantV1; Offer\nschema: Versioned service contract (N31)\nschema.contract: P24; ContractRefV1; Neutral\nprimary (H05): provider[0]=primary.api; consumer[0]=client.primary\nfallback (H05): provider[0]=fallback.api; consumer[0]=client.fallback\nbudget (H02): provider[0]=breaker.budget; consumer[0]=client.budget\ngrant (H23): provider[0]=policy.grant; consumer[0]=client.authority\npreference (H33): preferred[0]=primary.profile; fallback[1]=fallback.profile; selector[2]=client.selector\ncontract (H25): contract[0]=schema.contract; implementation[1]=primary.implementation; implementation[2]=fallback.implementation" }, { "id": "capability-partitioning", "src": "/docs/img/theory/capability-partitioning.svg", "alt": "Partitioning: graph cut with exported contracts and fences", "text": "Which semantics must be preserved when a region moves to another host?\nA common Kotlin cost function ranks legal placements after policy and target capability checks; it cannot override failed legality checks.\nplanner: Placement planner (N28)\nplanner.plan: P24; PlacementPlanV1; Neutral\nedge: Edge host (N27)\nedge.profile: P24; HostProfileV1; Neutral\nservice: Service export (N19)\nservice.compute: P02; ComputeV1; Require\nservice.export: P24; ContractRefV1; Neutral\nnative: Native host (N27)\nnative.profile: P24; HostProfileV1; Neutral\nkernel: Native algorithm (N16)\nkernel.compute: P02; ComputeV1; Offer\nkernel.storage: P02; ConditionalStateV1; Require\nkernel.implementation: P24; ImplementationRefV1; Neutral\nstate: State authority (N21)\nstate.conditional: P02; ConditionalStateV1; Offer\nstate.fence: P24; FenceRefV1; Neutral\ncall (H05): provider[0]=kernel.compute; consumer[0]=service.compute\nstate (H05): provider[0]=state.conditional; consumer[0]=kernel.storage\nplacement (H21): planner[0]=planner.plan; edge[1]=edge.profile; native[2]=native.profile\nboundary (H30): export[0]=service.export; implementation[1]=kernel.implementation; authority[2]=state.fence" }, { "id": "capability-ffi", "src": "/docs/img/theory/capability-ffi.svg", "alt": "FFI: typed call, owned bytes and target admission", "text": "Who releases a buffer after a foreign call fails?\nKotlin prepares a typed request and invokes the admitted bridge. The adapter maps serialization, error values and resource cleanup onto the target ABI.\nlogic: Common Kotlin logic (N01)\nlogic.call: P02; NativeComputeV1; Require\nbridge: FFI transport adapter (N15)\nbridge.call: P02; NativeComputeV1; Offer\nbridge.native: P02; NativeComputeV1; Require\nbridge.admission: P20; HostGrantV1; Require\nbridge.failure: P04; ForeignFailureV1; Offer\nbridge.release: P24; ReleaseProtocolV1; Neutral\nnative: Foreign function library (N16)\nnative.compute: P02; NativeComputeV1; Offer\nnative.buffer: P17; BufferLeaseV1; Require\nnative.borrow: P24; BorrowRefV1; Neutral\npool: Native buffer owner (N26)\npool.lease: P17; BufferLeaseV1; Offer\npool.allocator: P24; AllocatorRefV1; Neutral\npolicy: Host capability gate (N33)\npolicy.grant: P20; HostGrantV1; Offer\nerror: Error / cancellation adapter (N15)\nerror.failure: P04; ForeignFailureV1; Require\ninvoke (H05): provider[0]=bridge.call; consumer[0]=logic.call\nnative (H05): provider[0]=native.compute; consumer[0]=bridge.native\nbuffer (H01): provider[0]=pool.lease; consumer[0]=native.buffer\ngrant (H23): provider[0]=policy.grant; consumer[0]=bridge.admission\nerror (H02): provider[0]=bridge.failure; consumer[0]=error.failure\nownership (H19): allocator[0]=pool.allocator; borrower[1]=native.borrow; adapter[2]=bridge.release" }, { "id": "capability-code-push", "src": "/docs/img/theory/capability-code-push.svg", "alt": "Subgraph code push: state migration and old-call draining", "text": "How does a replacement preserve both callers and mutable state?\nThe migration is an ordinary Kotlin function with declared preconditions. The host publishes a candidate epoch only after state and exported-contract checks.\ncandidate: Replacement region (N10)\ncandidate.source: P23; SourceRevisionV1; Offer\ncandidate.stateSchema: P24; SchemaRefV1; Neutral\ncandidate.definition: P24; DefinitionRefV1; Neutral\nbuild: Kotlin/JS packager (N34)\nbuild.source: P23; SourceRevisionV1; Require\nbuild.bundle: P23; BundleRefV1; Offer\ncheck: Compatibility / Shadow checks (N36)\ncheck.bundle: P23; BundleRefV1; Require\ncheck.evidence: P24; EvidenceSetV1; Offer\npolicy: Publication authority (N33)\npolicy.evidence: P24; EvidenceSetV1; Require\npolicy.decision: P20; PublishDecisionV1; Offer\nhost: Target host loader (N27)\nhost.admission: P20; PublishDecisionV1; Require\nhost.state: P02; MigrationCommitV1; Require\nhost.publisher: P24; HostRefV1; Neutral\nold: Old activation epoch (N10)\nold.stateSchema: P24; SchemaRefV1; Neutral\nold.epoch: P24; ActivationRefV1; Neutral\nstate: State authority (N21)\nstate.conditional: P02; MigrationCommitV1; Offer\nstate.version: P24; StateVersionV1; Neutral\nbuild (H26): provider[0]=candidate.source; consumer[0]=build.source\ntest (H26): provider[0]=build.bundle; consumer[0]=check.bundle\nevidence (H28): provider[0]=check.evidence; consumer[0]=policy.evidence\npublish (H23): provider[0]=policy.decision; consumer[0]=host.admission\nstate (H05): provider[0]=state.conditional; consumer[0]=host.state\nmigration (H35): old[0]=old.stateSchema; new[1]=candidate.stateSchema; authority[2]=state.version\nactivation (H29): old[0]=old.epoch; new[1]=candidate.definition; publisher[2]=host.publisher" } ], "region": "theory-examples", "order": 3, "title": "Bolt-on capabilities — worked graph designs", "nav": "Bolt-on capabilities — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-capabilities", "revision": "f50d837aebde4c4498c2fa26a02056d919dc914127b8f38cef96c1e5e09011e4", "status": "design", "renderingRevision": "aac3b2e666a38a9eed7406a4d5b2ba32df6efdea7c7bfa12cecf2834a44ae0e5", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1", "logic-and-ownership-2", "failure-and-qualification-2", "hyperedge-roles-2", "kotlin-common-declaration-2", "logic-and-ownership-3", "failure-and-qualification-3", "hyperedge-roles-3", "kotlin-common-declaration-3", "logic-and-ownership-4", "failure-and-qualification-4", "hyperedge-roles-4", "kotlin-common-declaration-4", "logic-and-ownership-5", "failure-and-qualification-5", "hyperedge-roles-5", "kotlin-common-declaration-5", "logic-and-ownership-6", "failure-and-qualification-6", "hyperedge-roles-6", "kotlin-common-declaration-6" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities", "polarity": "Neutral" }, { "id": "section-capability-navigation", "anchor": "capability-navigation", "label": "Navigation: nested containers, deep links and modal return", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities#capability-navigation", "polarity": "Neutral" }, { "id": "section-capability-auth", "anchor": "capability-auth", "label": "Authorization: delegation, expiry and effect admission", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities#capability-auth", "polarity": "Neutral" }, { "id": "section-capability-telemetry", "anchor": "capability-telemetry", "label": "Telemetry: graph attribution, sampling and privacy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities#capability-telemetry", "polarity": "Neutral" }, { "id": "section-capability-services", "anchor": "capability-services", "label": "Service composition: retry, fallback and contract evolution", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities#capability-services", "polarity": "Neutral" }, { "id": "section-capability-partitioning", "anchor": "capability-partitioning", "label": "Partitioning: graph cut with exported contracts and fences", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities#capability-partitioning", "polarity": "Neutral" }, { "id": "section-capability-ffi", "anchor": "capability-ffi", "label": "FFI: typed call, owned bytes and target admission", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities#capability-ffi", "polarity": "Neutral" }, { "id": "section-capability-code-push", "anchor": "capability-code-push", "label": "Subgraph code push: state migration and old-call draining", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-capabilities#capability-code-push", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-capabilities:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-capabilities", "incidences": [ { "node": "reaktor-examples-capabilities", "port": "section-capability-navigation", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-capabilities:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-capabilities", "incidences": [ { "node": "reaktor-examples-capabilities", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-capabilities:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-capabilities", "incidences": [ { "node": "reaktor-examples-capabilities", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-capabilities.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Bolt-on capabilities — worked graph designs", "level": 0 }, { "id": "capability-navigation", "anchor": "capability-navigation", "title": "Navigation: nested containers, deep links and modal return", "level": 2 }, { "id": "capability-navigation-logic", "anchor": "capability-navigation-logic", "title": "Logic and ownership", "level": 3 }, { "id": "capability-navigation-qualification", "anchor": "capability-navigation-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "capability-navigation-relations", "anchor": "capability-navigation-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "capability-navigation-kotlin", "anchor": "capability-navigation-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "capability-auth", "anchor": "capability-auth", "title": "Authorization: delegation, expiry and effect admission", "level": 2 }, { "id": "capability-auth-logic", "anchor": "capability-auth-logic", "title": "Logic and ownership", "level": 3 }, { "id": "capability-auth-qualification", "anchor": "capability-auth-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "capability-auth-relations", "anchor": "capability-auth-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "capability-auth-kotlin", "anchor": "capability-auth-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "capability-telemetry", "anchor": "capability-telemetry", "title": "Telemetry: graph attribution, sampling and privacy", "level": 2 }, { "id": "capability-telemetry-logic", "anchor": "capability-telemetry-logic", "title": "Logic and ownership", "level": 3 }, { "id": "capability-telemetry-qualification", "anchor": "capability-telemetry-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "capability-telemetry-relations", "anchor": "capability-telemetry-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "capability-telemetry-kotlin", "anchor": "capability-telemetry-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "capability-services", "anchor": "capability-services", "title": "Service composition: retry, fallback and contract evolution", "level": 2 }, { "id": "capability-services-logic", "anchor": "capability-services-logic", "title": "Logic and ownership", "level": 3 }, { "id": "capability-services-qualification", "anchor": "capability-services-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "capability-services-relations", "anchor": "capability-services-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "capability-services-kotlin", "anchor": "capability-services-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "capability-partitioning", "anchor": "capability-partitioning", "title": "Partitioning: graph cut with exported contracts and fences", "level": 2 }, { "id": "capability-partitioning-logic", "anchor": "capability-partitioning-logic", "title": "Logic and ownership", "level": 3 }, { "id": "capability-partitioning-qualification", "anchor": "capability-partitioning-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "capability-partitioning-relations", "anchor": "capability-partitioning-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "capability-partitioning-kotlin", "anchor": "capability-partitioning-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "capability-ffi", "anchor": "capability-ffi", "title": "FFI: typed call, owned bytes and target admission", "level": 2 }, { "id": "capability-ffi-logic", "anchor": "capability-ffi-logic", "title": "Logic and ownership", "level": 3 }, { "id": "capability-ffi-qualification", "anchor": "capability-ffi-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "capability-ffi-relations", "anchor": "capability-ffi-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "capability-ffi-kotlin", "anchor": "capability-ffi-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "capability-code-push", "anchor": "capability-code-push", "title": "Subgraph code push: state migration and old-call draining", "level": 2 }, { "id": "capability-code-push-logic", "anchor": "capability-code-push-logic", "title": "Logic and ownership", "level": 3 }, { "id": "capability-code-push-qualification", "anchor": "capability-code-push-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "capability-code-push-relations", "anchor": "capability-code-push-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "capability-code-push-kotlin", "anchor": "capability-code-push-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "capability-navigation" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "capability-auth" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "capability-telemetry" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "capability-services" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "capability-partitioning" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "capability-ffi" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "capability-code-push" } ] }, { "id": "reaktor-examples-distributed", "owner": "Reaktor", "kind": "design", "summary": "5 worked distributed systems designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "distributed-events", "src": "/docs/img/theory/distributed-events.svg", "alt": "Event pipeline: durable admission, work and projections", "text": "What does an acknowledgement actually promise?\nA common Kotlin handler computes the new value; the authority compares the prior version and records the operation key in the same commit.\ningest: Admission service (N19)\ningest.command: P03; WorkCommandV1; Offer\ningest.operation: P24; OperationRefV1; Neutral\nqueue: Durable queue (N24)\nqueue.command: P03; WorkCommandV1; Require\nqueue.delivery: P04; DeliveryV1; Offer\nqueue.deliveryRef: P24; DeliveryRefV1; Neutral\nworker: Processing actor (N05)\nworker.delivery: P04; DeliveryV1; Require\nworker.effect: P02; EffectCommitV1; Require\nworker.span: P24; TraceV1; Offer\nledger: Effect ledger (N21)\nledger.commit: P02; EffectCommitV1; Offer\nledger.events: P04; CommittedEventV1; Offer\nledger.receipt: P24; ReceiptRefV1; Neutral\nview: Materialized view (N22)\nview.events: P04; CommittedEventV1; Require\ntrace: Telemetry collector (N38)\ntrace.span: P24; TraceV1; Require\nadmit (H02): provider[0]=ingest.command; consumer[0]=queue.command\ndelivery (H02): provider[0]=queue.delivery; consumer[0]=worker.delivery\ncommit (H05): provider[0]=ledger.commit; consumer[0]=worker.effect\nproject (H02): provider[0]=ledger.events; consumer[0]=view.events\ntrace (H04): provider[0]=worker.span; consumer[0]=trace.span\nlineage (H27): intent[0]=ingest.operation; delivery[1]=queue.deliveryRef; effect[2]=ledger.receipt" }, { "id": "distributed-actors", "src": "/docs/img/theory/distributed-actors.svg", "alt": "Sharded actors: routing, supervision and replica epochs", "text": "Which actor instance owns a key after a placement change?\nKotlin hashes a domain key using the published placement epoch. The mailbox handler serializes local state transitions and checks fencing at the storage authority.\nregistry: Placement registry (N21)\nregistry.map: P01; PlacementMapV1; Offer\nrouter: Key router (N22)\nrouter.placement: P01; PlacementMapV1; Require\nrouter.a: P02; ActorCommandV1; Require\nrouter.b: P02; ActorCommandV1; Require\nrouter.keyspace: P24; KeyspaceRefV1; Neutral\nsupervisor: Actor supervisor (N05)\nsupervisor.supervisor: P24; SupervisorRefV1; Neutral\na: Actor shard A (N05)\na.mailbox: P02; ActorCommandV1; Offer\na.log: P02; ActorAppendV1; Require\na.range: P24; RangeRefV1; Neutral\na.activation: P24; ActivationRefV1; Neutral\nb: Actor shard B (N05)\nb.mailbox: P02; ActorCommandV1; Offer\nb.log: P02; ActorAppendV1; Require\nb.range: P24; RangeRefV1; Neutral\nb.activation: P24; ActivationRefV1; Neutral\nlog: State log (N24)\nlog.appendA: P02; ActorAppendV1; Offer\nlog.appendB: P02; ActorAppendV1; Offer\nplacement (H02): provider[0]=registry.map; consumer[0]=router.placement\na (H05): provider[0]=a.mailbox; consumer[0]=router.a\nb (H05): provider[0]=b.mailbox; consumer[0]=router.b\nlogA (H05): provider[0]=log.appendA; consumer[0]=a.log\nlogB (H05): provider[0]=log.appendB; consumer[0]=b.log\npartition (H15): router[0]=router.keyspace; shard[1]=a.range; shard[2]=b.range\nsupervision (H18): supervisor[0]=supervisor.supervisor; child[1]=a.activation; child[2]=b.activation" }, { "id": "distributed-saga", "src": "/docs/img/theory/distributed-saga.svg", "alt": "Distributed order saga: reservations and irreversible effects", "text": "Which state allows recovery after partial success?\nOrdinary Kotlin implements the transition function from journal state and new receipts; each external step remains an explicit effect boundary.\ncoordinator: Durable saga coordinator (N06)\ncoordinator.stock: P02; ReservationV1; Require\ncoordinator.payment: P02; ChargeV1; Require\ncoordinator.dispatch: P02; DispatchV1; Require\ncoordinator.authority: P20; OrderGrantV1; Require\ncoordinator.state: P02; SagaCommitV1; Require\ncoordinator.step: P24; SagaStepRefV1; Neutral\napprove: Order approval (N33)\napprove.grant: P20; OrderGrantV1; Offer\nstock: Stock service (N19)\nstock.reserve: P02; ReservationV1; Offer\nstock.release: P24; CompensationRefV1; Neutral\npayment: Payment service (N19)\npayment.charge: P02; ChargeV1; Offer\npayment.refund: P24; CompensationRefV1; Neutral\ndispatch: Dispatch service (N19)\ndispatch.submit: P02; DispatchV1; Offer\ndispatch.cancel: P24; CompensationRefV1; Neutral\njournal: Saga journal (N21)\njournal.commit: P02; SagaCommitV1; Offer\nstock (H05): provider[0]=stock.reserve; consumer[0]=coordinator.stock\npay (H05): provider[0]=payment.charge; consumer[0]=coordinator.payment\nship (H05): provider[0]=dispatch.submit; consumer[0]=coordinator.dispatch\ngrant (H23): provider[0]=approve.grant; consumer[0]=coordinator.authority\njournal (H05): provider[0]=journal.commit; consumer[0]=coordinator.state\ncompensation (H17): coordinator[0]=coordinator.step; stock[1]=stock.release; payment[2]=payment.refund; dispatch[3]=dispatch.cancel" }, { "id": "distributed-hybrid", "src": "/docs/img/theory/distributed-hybrid.svg", "alt": "Hybrid compute: edge admission and native regional processing", "text": "How is a graph partition lowered across incompatible hosts?\nCommon Kotlin selects a qualified placement from declared host capabilities. The target adapter invokes the native kernel and publishes an artifact receipt.\nedge: Edge admission (N27)\nedge.authority: P20; WorkloadGrantV1; Require\nedge.scheduler: P02; AllocateV1; Require\nedge.workload: P24; WorkloadRefV1; Neutral\npolicy: Workload policy (N33)\npolicy.grant: P20; WorkloadGrantV1; Offer\nscheduler: Regional scheduler (N28)\nscheduler.allocate: P02; AllocateV1; Offer\nscheduler.region: P24; RegionRefV1; Neutral\nnative: Native compute host (N16)\nnative.input: P02; ArtifactReadV1; Require\nnative.output: P02; ArtifactWriteV1; Require\nnative.receipt: P03; ComputeReceiptV1; Offer\nnative.host: P24; HostProfileV1; Neutral\nartifact: Input / result artifacts (N26)\nartifact.read: P02; ArtifactReadV1; Offer\nartifact.write: P02; ArtifactWriteV1; Offer\nresult: Result service (N19)\nresult.receipt: P03; ComputeReceiptV1; Require\nauthorize (H23): provider[0]=policy.grant; consumer[0]=edge.authority\nplace (H05): provider[0]=scheduler.allocate; consumer[0]=edge.scheduler\ninput (H05): provider[0]=artifact.read; consumer[0]=native.input\noutput (H05): provider[0]=artifact.write; consumer[0]=native.output\nreceipt (H02): provider[0]=native.receipt; consumer[0]=result.receipt\nplacement (H21): region[0]=scheduler.region; host[1]=native.host; workload[2]=edge.workload" }, { "id": "distributed-release", "src": "/docs/img/theory/distributed-release.svg", "alt": "Distributed release: exact artifacts and partial rollout", "text": "What happens when only some hosts accept a candidate?\nKotlin computes a candidate plan from observed host receipts, but only the independent gate grants execution for the fingerprinted plan.\nbuild: Compiler / packager (N34)\nbuild.artifacts: P23; ArtifactVectorV1; Offer\nbundle: Release artifacts (N35)\nbundle.input: P23; ArtifactVectorV1; Require\nbundle.artifacts: P23; ArtifactVectorV1; Offer\nbundle.revision: P24; RevisionRefV1; Neutral\nshadow: Shadow scenarios (N36)\nshadow.candidate: P23; ArtifactVectorV1; Require\nshadow.evidence: P24; EvidenceSetV1; Offer\ngate: Independent release gate (N33)\ngate.evidence: P24; EvidenceSetV1; Require\ngate.decision: P20; ReleaseDecisionV1; Offer\nrollout: Rollout controller (N40)\nrollout.authority: P20; ReleaseDecisionV1; Require\nrollout.a: P02; AdmissionRequestV1; Require\nrollout.b: P02; AdmissionRequestV1; Require\nrollout.reconciler: P24; ControllerRefV1; Neutral\na: Host cohort A (N27)\na.admit: P02; AdmissionRequestV1; Offer\na.epoch: P24; ActivationRefV1; Neutral\nb: Host cohort B (N27)\nb.admit: P02; AdmissionRequestV1; Offer\nb.epoch: P24; ActivationRefV1; Neutral\nbundle (H26): provider[0]=build.artifacts; consumer[0]=bundle.input\ntest (H26): provider[0]=bundle.artifacts; consumer[0]=shadow.candidate\nproof (H28): provider[0]=shadow.evidence; consumer[0]=gate.evidence\ndecision (H23): provider[0]=gate.decision; consumer[0]=rollout.authority\na (H05): provider[0]=a.admit; consumer[0]=rollout.a\nb (H05): provider[0]=b.admit; consumer[0]=rollout.b\ncohort (H29): candidate[0]=bundle.revision; host[1]=a.epoch; host[2]=b.epoch; reconciler[3]=rollout.reconciler" } ], "region": "theory-examples", "order": 2, "title": "Distributed systems — worked graph designs", "nav": "Distributed systems — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-distributed", "revision": "95911369b4b80f8243e9d3cf20a9e1d88ccbf09b22c095f7447c8d2af7275627", "status": "design", "renderingRevision": "e8758f9d29616d457f1e731c19d4957d0387c9c7bb2a639201ab0facfd2b7f1e", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1", "logic-and-ownership-2", "failure-and-qualification-2", "hyperedge-roles-2", "kotlin-common-declaration-2", "logic-and-ownership-3", "failure-and-qualification-3", "hyperedge-roles-3", "kotlin-common-declaration-3", "logic-and-ownership-4", "failure-and-qualification-4", "hyperedge-roles-4", "kotlin-common-declaration-4" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-distributed", "polarity": "Neutral" }, { "id": "section-distributed-events", "anchor": "distributed-events", "label": "Event pipeline: durable admission, work and projections", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-distributed#distributed-events", "polarity": "Neutral" }, { "id": "section-distributed-actors", "anchor": "distributed-actors", "label": "Sharded actors: routing, supervision and replica epochs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-distributed#distributed-actors", "polarity": "Neutral" }, { "id": "section-distributed-saga", "anchor": "distributed-saga", "label": "Distributed order saga: reservations and irreversible effects", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-distributed#distributed-saga", "polarity": "Neutral" }, { "id": "section-distributed-hybrid", "anchor": "distributed-hybrid", "label": "Hybrid compute: edge admission and native regional processing", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-distributed#distributed-hybrid", "polarity": "Neutral" }, { "id": "section-distributed-release", "anchor": "distributed-release", "label": "Distributed release: exact artifacts and partial rollout", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-distributed#distributed-release", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-distributed:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-distributed", "incidences": [ { "node": "reaktor-examples-distributed", "port": "section-distributed-events", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-distributed:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-distributed", "incidences": [ { "node": "reaktor-examples-distributed", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-distributed:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-distributed", "incidences": [ { "node": "reaktor-examples-distributed", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-distributed.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Distributed systems — worked graph designs", "level": 0 }, { "id": "distributed-events", "anchor": "distributed-events", "title": "Event pipeline: durable admission, work and projections", "level": 2 }, { "id": "distributed-events-logic", "anchor": "distributed-events-logic", "title": "Logic and ownership", "level": 3 }, { "id": "distributed-events-qualification", "anchor": "distributed-events-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "distributed-events-relations", "anchor": "distributed-events-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "distributed-events-kotlin", "anchor": "distributed-events-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "distributed-actors", "anchor": "distributed-actors", "title": "Sharded actors: routing, supervision and replica epochs", "level": 2 }, { "id": "distributed-actors-logic", "anchor": "distributed-actors-logic", "title": "Logic and ownership", "level": 3 }, { "id": "distributed-actors-qualification", "anchor": "distributed-actors-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "distributed-actors-relations", "anchor": "distributed-actors-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "distributed-actors-kotlin", "anchor": "distributed-actors-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "distributed-saga", "anchor": "distributed-saga", "title": "Distributed order saga: reservations and irreversible effects", "level": 2 }, { "id": "distributed-saga-logic", "anchor": "distributed-saga-logic", "title": "Logic and ownership", "level": 3 }, { "id": "distributed-saga-qualification", "anchor": "distributed-saga-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "distributed-saga-relations", "anchor": "distributed-saga-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "distributed-saga-kotlin", "anchor": "distributed-saga-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "distributed-hybrid", "anchor": "distributed-hybrid", "title": "Hybrid compute: edge admission and native regional processing", "level": 2 }, { "id": "distributed-hybrid-logic", "anchor": "distributed-hybrid-logic", "title": "Logic and ownership", "level": 3 }, { "id": "distributed-hybrid-qualification", "anchor": "distributed-hybrid-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "distributed-hybrid-relations", "anchor": "distributed-hybrid-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "distributed-hybrid-kotlin", "anchor": "distributed-hybrid-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "distributed-release", "anchor": "distributed-release", "title": "Distributed release: exact artifacts and partial rollout", "level": 2 }, { "id": "distributed-release-logic", "anchor": "distributed-release-logic", "title": "Logic and ownership", "level": 3 }, { "id": "distributed-release-qualification", "anchor": "distributed-release-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "distributed-release-relations", "anchor": "distributed-release-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "distributed-release-kotlin", "anchor": "distributed-release-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "distributed-events" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "distributed-actors" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "distributed-saga" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "distributed-hybrid" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "distributed-release" } ] }, { "id": "reaktor-examples-games", "owner": "Reaktor", "kind": "design", "summary": "2 worked multiplayer games designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "game-authoritative", "src": "/docs/img/theory/game-authoritative.svg", "alt": "Multiplayer: authoritative simulation and client prediction", "text": "How are predicted client state and authoritative state reconciled?\nKotlin implements prediction, sequence-number filtering and reconciliation; the server alone admits simulation-changing commands.\ninput: Player input (N13)\ninput.command: P04; PlayerCommandV1; Offer\ninput.intent: P04; InputIntentV1; Offer\nprediction: Prediction / rendering (N11)\nprediction.intent: P04; InputIntentV1; Require\nprediction.authoritative: P01; GameSnapshotV1; Require\nprediction.ack: P24; AckPositionV1; Neutral\nroom: Authoritative room actor (N05)\nroom.command: P04; PlayerCommandV1; Require\nroom.physics: P02; SimulationStepV1; Require\nroom.tick: P15; TickV1; Require\nroom.snapshot: P01; GameSnapshotV1; Offer\nroom.event: P04; MatchEventV1; Offer\nroom.position: P24; TickPositionV1; Neutral\nphysics: Simulation kernel (N16)\nphysics.step: P02; SimulationStepV1; Offer\nclock: Server tick clock (N09)\nclock.tick: P15; TickV1; Offer\nclock.clock: P24; ClockRefV1; Neutral\nlog: Match event log (N24)\nlog.event: P04; MatchEventV1; Require\ncommand (H02): provider[0]=input.command; consumer[0]=room.command\npredict (H02): provider[0]=input.intent; consumer[0]=prediction.intent\nsimulate (H05): provider[0]=physics.step; consumer[0]=room.physics\ntick (H02): provider[0]=clock.tick; consumer[0]=room.tick\nsnapshot (H02): provider[0]=room.snapshot; consumer[0]=prediction.authoritative\nlog (H02): provider[0]=room.event; consumer[0]=log.event\nalignment (H31): clock[0]=clock.clock; simulation[1]=room.position; client[2]=prediction.ack" }, { "id": "game-world", "src": "/docs/img/theory/game-world.svg", "alt": "Multiplayer: world partitions, sessions and entity handoff", "text": "What fences an entity when a player crosses a world partition?\nCommon Kotlin rules operate over one cell activation; migration reconstructs the entity under a new fenced owner.\nsession: Player session router (N22)\nsession.a: P02; WorldSessionV1; Require\nsession.b: P02; WorldSessionV1; Require\nsession.session: P07; PlayerSessionV1; Offer\na: World cell A (N05)\na.session: P02; WorldSessionV1; Offer\na.authority: P02; EntityLeaseV1; Require\na.entity: P24; EntityEpochV1; Neutral\na.rules: P24; ActivationRefV1; Neutral\nb: World cell B (N05)\nb.session: P02; WorldSessionV1; Offer\nb.authority: P02; EntityLeaseV1; Require\nb.entity: P24; EntityEpochV1; Neutral\nb.rules: P24; ActivationRefV1; Neutral\nauthority: Entity lease authority (N21)\nauthority.leaseA: P02; EntityLeaseV1; Offer\nauthority.leaseB: P02; EntityLeaseV1; Offer\nauthority.fence: P24; FenceRefV1; Neutral\nclient: Player Surface (N11)\nclient.session: P07; PlayerSessionV1; Require\nbuild: World rules bundle (N35)\nbuild.revision: P24; RevisionRefV1; Neutral\na (H05): provider[0]=a.session; consumer[0]=session.a\nb (H05): provider[0]=b.session; consumer[0]=session.b\nleaseA (H05): provider[0]=authority.leaseA; consumer[0]=a.authority\nleaseB (H05): provider[0]=authority.leaseB; consumer[0]=b.authority\nsession (H06): provider[0]=session.session; consumer[0]=client.session\nhandoff (H35): old[0]=a.entity; new[1]=b.entity; fence[2]=authority.fence\nrules (H29): bundle[0]=build.revision; cell[1]=a.rules; cell[2]=b.rules" } ], "region": "theory-examples", "order": 5, "title": "Multiplayer games — worked graph designs", "nav": "Multiplayer games — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-games", "revision": "e130d6a96fba81f1942d2393355cc05fd98a013c0857ff140810617d9fb55bfa", "status": "design", "renderingRevision": "4871366fc923822b796e3e69f533e67923c0dd58501259b4afe7f1fc03c70ebf", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-games", "polarity": "Neutral" }, { "id": "section-game-authoritative", "anchor": "game-authoritative", "label": "Multiplayer: authoritative simulation and client prediction", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-games#game-authoritative", "polarity": "Neutral" }, { "id": "section-game-world", "anchor": "game-world", "label": "Multiplayer: world partitions, sessions and entity handoff", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-games#game-world", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-games:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-games", "incidences": [ { "node": "reaktor-examples-games", "port": "section-game-authoritative", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-games:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-games", "incidences": [ { "node": "reaktor-examples-games", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-games:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-games", "incidences": [ { "node": "reaktor-examples-games", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-games.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Multiplayer games — worked graph designs", "level": 0 }, { "id": "game-authoritative", "anchor": "game-authoritative", "title": "Multiplayer: authoritative simulation and client prediction", "level": 2 }, { "id": "game-authoritative-logic", "anchor": "game-authoritative-logic", "title": "Logic and ownership", "level": 3 }, { "id": "game-authoritative-qualification", "anchor": "game-authoritative-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "game-authoritative-relations", "anchor": "game-authoritative-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "game-authoritative-kotlin", "anchor": "game-authoritative-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "game-world", "anchor": "game-world", "title": "Multiplayer: world partitions, sessions and entity handoff", "level": 2 }, { "id": "game-world-logic", "anchor": "game-world-logic", "title": "Logic and ownership", "level": 3 }, { "id": "game-world-qualification", "anchor": "game-world-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "game-world-relations", "anchor": "game-world-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "game-world-kotlin", "anchor": "game-world-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "game-authoritative" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "game-world" } ] }, { "id": "reaktor-examples-iot", "owner": "Reaktor", "kind": "design", "summary": "2 worked iot designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "iot-sensor", "src": "/docs/img/theory/iot-sensor.svg", "alt": "IoT: constrained sensors, gateway buffering and ingestion", "text": "What can a gateway acknowledge during a cloud outage?\nKotlin common logic validates units and groups samples at the gateway; constrained firmware remains an explicit external system boundary when Kotlin/JS cannot execute there.\nsensor: Sensor firmware boundary (N30)\nsensor.sample: P04; SensorSampleV1; Offer\nsensor.identity: P24; DeviceRefV1; Neutral\ngateway: Gateway actor (N05)\ngateway.sample: P04; SensorSampleV1; Require\ngateway.buffer: P02; GatewayAppendV1; Require\ngateway.upload: P02; SensorBatchV1; Require\ngateway.health: P24; DeviceHealthV1; Offer\nbuffer: Gateway durable buffer (N24)\nbuffer.append: P02; GatewayAppendV1; Offer\nbuffer.position: P24; LogPositionV1; Neutral\ningest: Cloud ingestion (N19)\ningest.batch: P02; SensorBatchV1; Offer\ningest.storage: P02; SeriesAppendV1; Require\nseries: Time-series authority (N21)\nseries.append: P02; SeriesAppendV1; Offer\nseries.receipt: P24; ReceiptRefV1; Neutral\nhealth: Fleet health view (N22)\nhealth.events: P24; DeviceHealthV1; Require\nsample (H02): provider[0]=sensor.sample; consumer[0]=gateway.sample\nbuffer (H05): provider[0]=buffer.append; consumer[0]=gateway.buffer\nupload (H05): provider[0]=ingest.batch; consumer[0]=gateway.upload\nstore (H05): provider[0]=series.append; consumer[0]=ingest.storage\nhealth (H04): provider[0]=gateway.health; consumer[0]=health.events\nlineage (H27): device[0]=sensor.identity; gateway[1]=buffer.position; cloud[2]=series.receipt" }, { "id": "iot-command", "src": "/docs/img/theory/iot-command.svg", "alt": "IoT: commissioning, scoped commands and signed firmware", "text": "Which authority permits a physical command or firmware update?\nKotlin evaluates commissioning identity and command scope at the gateway. Firmware admission remains in the target bootloader or update authority.\noperator: Operator proposal (N20)\noperator.intent: P03; DeviceIntentV1; Offer\noperator.principal: P24; PrincipalRefV1; Neutral\npolicy: Device policy (N33)\npolicy.grant: P20; DeviceGrantV1; Offer\npolicy.policy: P24; PolicyRefV1; Neutral\ncommand: Command service (N19)\ncommand.intent: P03; DeviceIntentV1; Require\ncommand.authority: P20; DeviceGrantV1; Require\ncommand.deliver: P02; DeviceCommandV1; Require\ngateway: Gateway executor (N27)\ngateway.execute: P02; DeviceCommandV1; Offer\ngateway.device: P02; DeviceProtocolV1; Require\ngateway.artifact: P23; FirmwareRefV1; Require\ngateway.executor: P24; HostRefV1; Neutral\ndevice: Device controller boundary (N30)\ndevice.command: P02; DeviceProtocolV1; Offer\ndevice.identity: P24; DeviceRefV1; Neutral\nbundle: Signed firmware artifact (N35)\nbundle.artifact: P23; FirmwareRefV1; Offer\nproposal (H02): provider[0]=operator.intent; consumer[0]=command.intent\ngrant (H23): provider[0]=policy.grant; consumer[0]=command.authority\ndeliver (H05): provider[0]=gateway.execute; consumer[0]=command.deliver\ndevice (H05): provider[0]=device.command; consumer[0]=gateway.device\nartifact (H26): provider[0]=bundle.artifact; consumer[0]=gateway.artifact\nadmission (H23): principal[0]=operator.principal; resource[1]=device.identity; policy[2]=policy.policy; executor[3]=gateway.executor" } ], "region": "theory-examples", "order": 7, "title": "IoT — worked graph designs", "nav": "IoT — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-iot", "revision": "37e9edc4a96a094868b7a0572d0167934d7623dd3105c9d2033d50c3ff4c6b2b", "status": "design", "renderingRevision": "7997787212d775de98f87d8b4f05c8090bded01ba065151a56324d9e53d51b50", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-iot", "polarity": "Neutral" }, { "id": "section-iot-sensor", "anchor": "iot-sensor", "label": "IoT: constrained sensors, gateway buffering and ingestion", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-iot#iot-sensor", "polarity": "Neutral" }, { "id": "section-iot-command", "anchor": "iot-command", "label": "IoT: commissioning, scoped commands and signed firmware", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-iot#iot-command", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-iot:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-iot", "incidences": [ { "node": "reaktor-examples-iot", "port": "section-iot-sensor", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-iot:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-iot", "incidences": [ { "node": "reaktor-examples-iot", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-iot:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-iot", "incidences": [ { "node": "reaktor-examples-iot", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-iot.json", "sections": [ { "id": "preamble", "anchor": "", "title": "IoT — worked graph designs", "level": 0 }, { "id": "iot-sensor", "anchor": "iot-sensor", "title": "IoT: constrained sensors, gateway buffering and ingestion", "level": 2 }, { "id": "iot-sensor-logic", "anchor": "iot-sensor-logic", "title": "Logic and ownership", "level": 3 }, { "id": "iot-sensor-qualification", "anchor": "iot-sensor-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "iot-sensor-relations", "anchor": "iot-sensor-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "iot-sensor-kotlin", "anchor": "iot-sensor-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "iot-command", "anchor": "iot-command", "title": "IoT: commissioning, scoped commands and signed firmware", "level": 2 }, { "id": "iot-command-logic", "anchor": "iot-command-logic", "title": "Logic and ownership", "level": 3 }, { "id": "iot-command-qualification", "anchor": "iot-command-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "iot-command-relations", "anchor": "iot-command-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "iot-command-kotlin", "anchor": "iot-command-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "iot-sensor" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "iot-command" } ] }, { "id": "reaktor-examples-mobile", "owner": "Reaktor", "kind": "design", "summary": "5 worked mobile apps designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "mobile-community", "src": "/docs/img/theory/mobile-community.svg", "alt": "Community app: nested navigation and authenticated messaging", "text": "How does opening a deep link lead to a scoped service effect?\nValidate a draft with an ordinary Kotlin function, then invoke the typed send port. Derive trace context from the selected route and operation ID.\nroute: App routes (N12)\nroute.destination: P11; ConversationRouteV1; Offer\nscreen: Conversation Surface (N11)\nscreen.route: P11; ConversationRouteV1; Require\nscreen.intent: P04; MessageIntentV1; Offer\ncontroller: Conversation logic (N02)\ncontroller.input: P04; MessageIntentV1; Require\ncontroller.authority: P20; ScopedGrantV1; Require\ncontroller.send: P02; SendMessageV1; Require\ncontroller.span: P24; TraceEnvelopeV1; Offer\ncontroller.effect: P24; EffectRefV1; Neutral\nauth: Session boundary (N33)\nauth.grant: P20; ScopedGrantV1; Offer\nauth.principal: P24; PrincipalV1; Neutral\nchat: Messaging service (N19)\nchat.send: P02; SendMessageV1; Offer\nchat.storage: P02; MessageLedgerV1; Require\nlog: Message authority (N21)\nlog.append: P02; MessageLedgerV1; Offer\nlog.resource: P24; ConversationRefV1; Neutral\ntrace: Trace exporter (N38)\ntrace.span: P24; TraceEnvelopeV1; Require\nnav (H36): provider[0]=route.destination; consumer[0]=screen.route\nintent (H02): provider[0]=screen.intent; consumer[0]=controller.input\ngrant (H23): provider[0]=auth.grant; consumer[0]=controller.authority\nservice (H05): provider[0]=chat.send; consumer[0]=controller.send\npersist (H05): provider[0]=log.append; consumer[0]=chat.storage\nobserve (H04): provider[0]=controller.span; consumer[0]=trace.span\nscope (H23): principal[0]=auth.principal; effect[1]=controller.effect; resource[2]=log.resource" }, { "id": "mobile-offline", "src": "/docs/img/theory/mobile-offline.svg", "alt": "Offline field notebook: local edits and reconciled sync", "text": "Who owns an edit when a mobile device is disconnected?\nA common Kotlin merge function computes a candidate from base, local and remote values; conflicts remain explicit values for the Surface.\nview: Notebook Surface (N11)\nview.edit: P04; EditIntentV1; Offer\nedit: Local edit logic (N02)\nedit.input: P04; EditIntentV1; Require\nedit.store: P02; LocalMutationV1; Require\nstore: Local durable store (N21)\nstore.commit: P02; LocalMutationV1; Offer\nstore.pending: P01; PendingBatchV1; Offer\nstore.revision: P24; RevisionRefV1; Neutral\nsync: Sync agent (N25)\nsync.pending: P01; PendingBatchV1; Require\nsync.remote: P02; SyncBatchV1; Require\nsync.reconciler: P24; ImplementationRefV1; Neutral\napi: Notebook service (N19)\napi.reconcile: P02; SyncBatchV1; Offer\napi.storage: P02; ConditionalWriteV1; Require\napi.authority: P20; WorkspaceGrantV1; Require\nauthority: Notebook authority (N21)\nauthority.conditional: P02; ConditionalWriteV1; Offer\nauthority.revision: P24; RevisionRefV1; Neutral\npolicy: Workspace policy (N33)\npolicy.grant: P20; WorkspaceGrantV1; Offer\ninput (H02): provider[0]=view.edit; consumer[0]=edit.input\nlocal (H05): provider[0]=store.commit; consumer[0]=edit.store\npending (H02): provider[0]=store.pending; consumer[0]=sync.pending\nremote (H05): provider[0]=api.reconcile; consumer[0]=sync.remote\nwrite (H05): provider[0]=authority.conditional; consumer[0]=api.storage\ngrant (H23): provider[0]=policy.grant; consumer[0]=api.authority\nlineage (H27): localRevision[0]=store.revision; remoteRevision[1]=authority.revision; reconciler[2]=sync.reconciler" }, { "id": "mobile-camera", "src": "/docs/img/theory/mobile-camera.svg", "alt": "Camera pipeline: permission, native buffers and inference", "text": "Which boundary can carry a pointer and which requires bytes?\nUse ordinary Kotlin to crop and decide whether to upload. Invoke native compute through the qualified FFI adapter; the graph exposes the lease contract.\nsurface: Capture Surface (N11)\nsurface.preview: P08; PreviewStateV1; Require\nsurface.result: P01; DetectionV1; Require\nsurface.upload: P02; MediaUploadV1; Require\npermission: Camera permission (N33)\npermission.grant: P20; DeviceGrantV1; Offer\ncamera: Camera adapter (N15)\ncamera.permission: P20; DeviceGrantV1; Require\ncamera.preview: P08; PreviewStateV1; Offer\ncamera.frame: P16; OwnedFrameV1; Offer\ncamera.release: P24; ReleaseRefV1; Neutral\npool: Owned frame pool (N26)\npool.frame: P16; OwnedFrameV1; Require\npool.borrow: P17; FrameLeaseV1; Offer\npool.owner: P24; ResourceOwnerV1; Neutral\nnative: Native inference kernel (N16)\nnative.input: P17; FrameLeaseV1; Require\nnative.result: P01; DetectionV1; Offer\nnative.borrower: P24; BorrowScopeV1; Neutral\nupload: Upload service (N19)\nupload.put: P02; MediaUploadV1; Offer\nupload.store: P02; ObjectPutV1; Require\nblob: Object store (N26)\nblob.put: P02; ObjectPutV1; Offer\npermission (H23): provider[0]=permission.grant; consumer[0]=camera.permission\npreview (H02): provider[0]=camera.preview; consumer[0]=surface.preview\nframe (H02): provider[0]=camera.frame; consumer[0]=pool.frame\nborrow (H01): provider[0]=pool.borrow; consumer[0]=native.input\nresult (H02): provider[0]=native.result; consumer[0]=surface.result\nupload (H05): provider[0]=upload.put; consumer[0]=surface.upload\nstorage (H05): provider[0]=blob.put; consumer[0]=upload.store\nlifetime (H19): owner[0]=pool.owner; borrower[1]=native.borrower; release[2]=camera.release" }, { "id": "mobile-purchase", "src": "/docs/img/theory/mobile-purchase.svg", "alt": "Mobile purchase: deep link, payment and durable receipt", "text": "What survives a repeated checkout request?\nCompute totals with a shared Kotlin pricing function. Reuse one idempotency key across retried payment attempts and reconcile provider receipts.\nroute: Purchase route (N12)\nroute.order: P11; OrderRouteV1; Offer\ncheckout: Checkout logic (N02)\ncheckout.order: P11; OrderRouteV1; Require\ncheckout.grant: P20; PurchaseGrantV1; Require\ncheckout.pay: P02; ChargeV1; Require\ncheckout.commit: P02; PurchaseCommitV1; Require\ncheckout.intent: P24; PurchaseIntentV1; Neutral\nsession: Principal boundary (N33)\nsession.grant: P20; PurchaseGrantV1; Offer\npayment: Payment adapter (N30)\npayment.charge: P02; ChargeV1; Offer\npayment.effect: P24; ExternalEffectRefV1; Neutral\nledger: Purchase ledger (N21)\nledger.commit: P02; PurchaseCommitV1; Offer\nledger.receipt: P03; PurchaseReceiptV1; Offer\nledger.authority: P24; TransactionAuthorityV1; Neutral\nevents: Receipt outbox (N24)\nevents.receipt: P03; PurchaseReceiptV1; Require\nentry (H36): provider[0]=route.order; consumer[0]=checkout.order\nauth (H23): provider[0]=session.grant; consumer[0]=checkout.grant\npay (H05): provider[0]=payment.charge; consumer[0]=checkout.pay\ncommit (H05): provider[0]=ledger.commit; consumer[0]=checkout.commit\noutbox (H02): provider[0]=ledger.receipt; consumer[0]=events.receipt\npurchase (H16): authority[0]=ledger.authority; intent[1]=checkout.intent; externalEffect[2]=payment.effect" }, { "id": "mobile-feature-update", "src": "/docs/img/theory/mobile-feature-update.svg", "alt": "Mobile feature region: signed subgraph code push", "text": "Which feature can be replaced while an old screen is still active?\nThe graph DSL constructs the exported feature boundary; arbitrary common logic compiles to Kotlin/JS. A host-qualified loader publishes a new activation only after contract and artifact checks.\nshell: Stable app shell (N27)\nshell.routes: P19; RouteExportsV1; Require\nshell.feature: P02; FeatureContractV1; Require\nroutes: Feature route exports (N12)\nroutes.export: P19; RouteExportsV1; Offer\nold: Active feature epoch (N10)\nold.feature: P02; FeatureContractV1; Offer\nold.epoch: P24; ActivationRefV1; Neutral\nloader: JS host / FFI adapter (N15)\nloader.bundle: P23; BundleRefV1; Require\nloader.admission: P20; AdmissionV1; Require\nloader.publisher: P24; HostRefV1; Neutral\nbuild: Feature packager (N34)\nbuild.bundle: P23; BundleRefV1; Offer\nartifact: Signed bundle (N35)\nartifact.input: P23; BundleRefV1; Require\nartifact.bundle: P23; BundleRefV1; Offer\nartifact.revision: P24; RevisionRefV1; Neutral\ngate: Host admission gate (N33)\ngate.decision: P20; AdmissionV1; Offer\nroutes (H30): provider[0]=routes.export; consumer[0]=shell.routes\ncalls (H05): provider[0]=old.feature; consumer[0]=shell.feature\nbundle (H26): provider[0]=build.bundle; consumer[0]=artifact.input\nfetch (H26): provider[0]=artifact.bundle; consumer[0]=loader.bundle\nadmit (H23): provider[0]=gate.decision; consumer[0]=loader.admission\ncohort (H29): oldActivation[0]=old.epoch; candidate[1]=artifact.revision; publisher[2]=loader.publisher" } ], "region": "theory-examples", "order": 0, "title": "Mobile apps — worked graph designs", "nav": "Mobile apps — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-mobile", "revision": "68626214f588719d3694aa2d2e6c492ed9f98e4dff3d9e3ea6e93ae89989e348", "status": "design", "renderingRevision": "cb2aa06966a49c5b0cbd4221cd0f4dd5c228ed6b53ce96dd60fd7644d5d136b0", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1", "logic-and-ownership-2", "failure-and-qualification-2", "hyperedge-roles-2", "kotlin-common-declaration-2", "logic-and-ownership-3", "failure-and-qualification-3", "hyperedge-roles-3", "kotlin-common-declaration-3", "logic-and-ownership-4", "failure-and-qualification-4", "hyperedge-roles-4", "kotlin-common-declaration-4" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-mobile", "polarity": "Neutral" }, { "id": "section-mobile-community", "anchor": "mobile-community", "label": "Community app: nested navigation and authenticated messaging", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-mobile#mobile-community", "polarity": "Neutral" }, { "id": "section-mobile-offline", "anchor": "mobile-offline", "label": "Offline field notebook: local edits and reconciled sync", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-mobile#mobile-offline", "polarity": "Neutral" }, { "id": "section-mobile-camera", "anchor": "mobile-camera", "label": "Camera pipeline: permission, native buffers and inference", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-mobile#mobile-camera", "polarity": "Neutral" }, { "id": "section-mobile-purchase", "anchor": "mobile-purchase", "label": "Mobile purchase: deep link, payment and durable receipt", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-mobile#mobile-purchase", "polarity": "Neutral" }, { "id": "section-mobile-feature-update", "anchor": "mobile-feature-update", "label": "Mobile feature region: signed subgraph code push", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-mobile#mobile-feature-update", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-mobile:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-mobile", "incidences": [ { "node": "reaktor-examples-mobile", "port": "section-mobile-community", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-mobile:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-mobile", "incidences": [ { "node": "reaktor-examples-mobile", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-mobile:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-mobile", "incidences": [ { "node": "reaktor-examples-mobile", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-mobile.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Mobile apps — worked graph designs", "level": 0 }, { "id": "mobile-community", "anchor": "mobile-community", "title": "Community app: nested navigation and authenticated messaging", "level": 2 }, { "id": "mobile-community-logic", "anchor": "mobile-community-logic", "title": "Logic and ownership", "level": 3 }, { "id": "mobile-community-qualification", "anchor": "mobile-community-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "mobile-community-relations", "anchor": "mobile-community-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "mobile-community-kotlin", "anchor": "mobile-community-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "mobile-offline", "anchor": "mobile-offline", "title": "Offline field notebook: local edits and reconciled sync", "level": 2 }, { "id": "mobile-offline-logic", "anchor": "mobile-offline-logic", "title": "Logic and ownership", "level": 3 }, { "id": "mobile-offline-qualification", "anchor": "mobile-offline-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "mobile-offline-relations", "anchor": "mobile-offline-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "mobile-offline-kotlin", "anchor": "mobile-offline-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "mobile-camera", "anchor": "mobile-camera", "title": "Camera pipeline: permission, native buffers and inference", "level": 2 }, { "id": "mobile-camera-logic", "anchor": "mobile-camera-logic", "title": "Logic and ownership", "level": 3 }, { "id": "mobile-camera-qualification", "anchor": "mobile-camera-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "mobile-camera-relations", "anchor": "mobile-camera-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "mobile-camera-kotlin", "anchor": "mobile-camera-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "mobile-purchase", "anchor": "mobile-purchase", "title": "Mobile purchase: deep link, payment and durable receipt", "level": 2 }, { "id": "mobile-purchase-logic", "anchor": "mobile-purchase-logic", "title": "Logic and ownership", "level": 3 }, { "id": "mobile-purchase-qualification", "anchor": "mobile-purchase-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "mobile-purchase-relations", "anchor": "mobile-purchase-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "mobile-purchase-kotlin", "anchor": "mobile-purchase-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "mobile-feature-update", "anchor": "mobile-feature-update", "title": "Mobile feature region: signed subgraph code push", "level": 2 }, { "id": "mobile-feature-update-logic", "anchor": "mobile-feature-update-logic", "title": "Logic and ownership", "level": 3 }, { "id": "mobile-feature-update-qualification", "anchor": "mobile-feature-update-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "mobile-feature-update-relations", "anchor": "mobile-feature-update-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "mobile-feature-update-kotlin", "anchor": "mobile-feature-update-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "mobile-community" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "mobile-offline" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "mobile-camera" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "mobile-purchase" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "mobile-feature-update" } ] }, { "id": "reaktor-examples-robotics", "owner": "Reaktor", "kind": "design", "summary": "2 worked robotic fleets designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "robot-allocation", "src": "/docs/img/theory/robot-allocation.svg", "alt": "Robotic fleet: mission allocation and local safety", "text": "Which decisions stay on the robot when fleet connectivity fails?\nA Kotlin allocation algorithm searches feasible assignments from a versioned demand/capacity cut; local motion logic remains in the qualified robot controller.\nplanner: Fleet mission planner (N01)\nplanner.capacity: P01; FleetCapacityV1; Require\nplanner.mission: P01; MissionProposalV1; Offer\nplanner.demand: P24; DemandRefV1; Neutral\ncapacity: Robot capacity view (N22)\ncapacity.snapshot: P01; FleetCapacityV1; Offer\ncapacity.supply: P24; SupplyRefV1; Neutral\nmission: Mission service (N19)\nmission.proposal: P01; MissionProposalV1; Require\nmission.assign: P02; MissionAssignV1; Offer\nmission.assignment: P24; AssignmentRefV1; Neutral\nrobot: Robot mission actor (N05)\nrobot.mission: P02; MissionAssignV1; Require\nrobot.motion: P20; MotionGrantV1; Require\nrobot.actuate: P02; MotionCommandV1; Require\nsafety: Local safety controller (N33)\nsafety.grant: P20; MotionGrantV1; Offer\nactuator: Actuator adapter (N15)\nactuator.move: P02; MotionCommandV1; Offer\ncapacity (H02): provider[0]=capacity.snapshot; consumer[0]=planner.capacity\nplan (H02): provider[0]=planner.mission; consumer[0]=mission.proposal\ndelivery (H05): provider[0]=mission.assign; consumer[0]=robot.mission\nsafe (H23): provider[0]=safety.grant; consumer[0]=robot.motion\nactuator (H05): provider[0]=actuator.move; consumer[0]=robot.actuate\nallocation (H09): demand[0]=planner.demand; supply[1]=capacity.supply; assignment[2]=mission.assignment" }, { "id": "robot-localization", "src": "/docs/img/theory/robot-localization.svg", "alt": "Robotic fleet: sensor fusion, native kernels and clock domains", "text": "How are measurements from different clocks combined?\nKotlin selects an aligned sample window and invokes a qualified native kernel. Pose estimates retain covariance and source timestamps.\nlidar: Lidar adapter (N15)\nlidar.sample: P06; LidarSampleV1; Offer\nlidar.clock: P24; ClockRefV1; Neutral\nimu: IMU adapter (N15)\nimu.sample: P06; ImuSampleV1; Offer\nimu.clock: P24; ClockRefV1; Neutral\nalign: Clock alignment (N07)\nalign.lidar: P06; LidarSampleV1; Require\nalign.imu: P06; ImuSampleV1; Require\nalign.kernel: P02; FusionStepV1; Require\nalign.policy: P24; TimeAlignmentV1; Neutral\nfusion: Native fusion kernel (N16)\nfusion.compute: P02; FusionStepV1; Offer\nfusion.pose: P09; PoseEstimateV1; Offer\npose: Pose authority (N21)\npose.update: P09; PoseEstimateV1; Require\npose.snapshot: P01; PoseSnapshotV1; Offer\nfleet: Fleet pose subscriber (N22)\nfleet.pose: P01; PoseSnapshotV1; Require\nlidar (H02): provider[0]=lidar.sample; consumer[0]=align.lidar\nimu (H02): provider[0]=imu.sample; consumer[0]=align.imu\nfuse (H05): provider[0]=fusion.compute; consumer[0]=align.kernel\npose (H02): provider[0]=fusion.pose; consumer[0]=pose.update\npublish (H02): provider[0]=pose.snapshot; consumer[0]=fleet.pose\ntime (H31): lidarClock[0]=lidar.clock; imuClock[1]=imu.clock; alignment[2]=align.policy" } ], "region": "theory-examples", "order": 6, "title": "Robotic fleets — worked graph designs", "nav": "Robotic fleets — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-robotics", "revision": "b0b0f479287474b028b2e50b6a52c3f644b97d0427e174d95bc7ce941491381a", "status": "design", "renderingRevision": "c6bc9c52d36a978ec85c713debdd6586320b9bbcef6acf0159371d5131e20a15", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-robotics", "polarity": "Neutral" }, { "id": "section-robot-allocation", "anchor": "robot-allocation", "label": "Robotic fleet: mission allocation and local safety", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-robotics#robot-allocation", "polarity": "Neutral" }, { "id": "section-robot-localization", "anchor": "robot-localization", "label": "Robotic fleet: sensor fusion, native kernels and clock domains", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-robotics#robot-localization", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-robotics:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-robotics", "incidences": [ { "node": "reaktor-examples-robotics", "port": "section-robot-allocation", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-robotics:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-robotics", "incidences": [ { "node": "reaktor-examples-robotics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-robotics:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-robotics", "incidences": [ { "node": "reaktor-examples-robotics", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-robotics.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Robotic fleets — worked graph designs", "level": 0 }, { "id": "robot-allocation", "anchor": "robot-allocation", "title": "Robotic fleet: mission allocation and local safety", "level": 2 }, { "id": "robot-allocation-logic", "anchor": "robot-allocation-logic", "title": "Logic and ownership", "level": 3 }, { "id": "robot-allocation-qualification", "anchor": "robot-allocation-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "robot-allocation-relations", "anchor": "robot-allocation-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "robot-allocation-kotlin", "anchor": "robot-allocation-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "robot-localization", "anchor": "robot-localization", "title": "Robotic fleet: sensor fusion, native kernels and clock domains", "level": 2 }, { "id": "robot-localization-logic", "anchor": "robot-localization-logic", "title": "Logic and ownership", "level": 3 }, { "id": "robot-localization-qualification", "anchor": "robot-localization-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "robot-localization-relations", "anchor": "robot-localization-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "robot-localization-kotlin", "anchor": "robot-localization-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "robot-allocation" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "robot-localization" } ] }, { "id": "reaktor-examples-web", "owner": "Reaktor", "kind": "design", "summary": "5 worked websites designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "web-content", "src": "/docs/img/theory/web-content.svg", "alt": "Content website: browser, edge cache and source publication", "text": "Which revision did a reader receive through a cache?\nAn ordinary Kotlin renderer can compose a page model and apply URL routing. Cache keys include source and rendering revisions.\nroute: URL routes (N12)\nroute.page: P11; PageRouteV1; Offer\nreader: Page renderer (N11)\nreader.route: P11; PageRouteV1; Require\nreader.fetch: P02; PageReadV1; Require\nedge: Edge page service (N19)\nedge.read: P02; PageReadV1; Offer\nedge.cache: P02; VersionedPageV1; Require\ncache: Revision cache (N25)\ncache.lookup: P02; VersionedPageV1; Offer\ncache.artifact: P23; PageArtifactV1; Require\ncache.served: P24; PublicationRefV1; Neutral\ncms: Content authority (N21)\ncms.content: P01; ContentRevisionV1; Offer\ncms.source: P24; RevisionRefV1; Neutral\nbuild: Page compiler (N34)\nbuild.source: P01; ContentRevisionV1; Require\nbuild.page: P23; PageArtifactV1; Offer\nbuild.artifact: P24; ArtifactRefV1; Neutral\nroute (H36): provider[0]=route.page; consumer[0]=reader.route\nfetch (H05): provider[0]=edge.read; consumer[0]=reader.fetch\ncache (H05): provider[0]=cache.lookup; consumer[0]=edge.cache\nsource (H02): provider[0]=cms.content; consumer[0]=build.source\npublish (H26): provider[0]=build.page; consumer[0]=cache.artifact\nprovenance (H27): source[0]=cms.source; artifact[1]=build.artifact; served[2]=cache.served" }, { "id": "web-commerce", "src": "/docs/img/theory/web-commerce.svg", "alt": "Commerce website: checkout, stock reservation and compensation", "text": "How do independent payment and inventory authorities coordinate?\nA Kotlin state machine chooses reserve, charge, commit or compensate from durable saga state and observed receipts.\nview: Checkout Surface (N11)\nview.order: P04; OrderIntentV1; Offer\norder: Order saga (N06)\norder.intent: P04; OrderIntentV1; Require\norder.authority: P20; CheckoutGrantV1; Require\norder.reserve: P02; ReservationV1; Require\norder.payment: P02; ChargeV1; Require\norder.dispatch: P03; DispatchV1; Offer\norder.compensation: P24; SagaRefV1; Neutral\nauth: Tenant / principal gate (N33)\nauth.grant: P20; CheckoutGrantV1; Offer\nstock: Inventory authority (N21)\nstock.reserve: P02; ReservationV1; Offer\nstock.reservation: P24; ReservationRefV1; Neutral\npayment: Payment provider (N30)\npayment.charge: P02; ChargeV1; Offer\npayment.chargeRef: P24; ChargeRefV1; Neutral\nfulfil: Fulfilment queue (N24)\nfulfil.command: P03; DispatchV1; Require\nintent (H02): provider[0]=view.order; consumer[0]=order.intent\ngrant (H23): provider[0]=auth.grant; consumer[0]=order.authority\nstock (H05): provider[0]=stock.reserve; consumer[0]=order.reserve\npayment (H05): provider[0]=payment.charge; consumer[0]=order.payment\ndispatch (H02): provider[0]=order.dispatch; consumer[0]=fulfil.command\nsaga (H17): reservation[0]=stock.reservation; charge[1]=payment.chargeRef; coordinator[2]=order.compensation" }, { "id": "web-collaboration", "src": "/docs/img/theory/web-collaboration.svg", "alt": "Collaborative editor: sessions, replicas and workspace authority", "text": "What is shared state and what is ephemeral presence?\nKotlin applies a specified CRDT merge algorithm to deltas; graph queries expose participants and log position while ordinary code implements the algorithm.\neditor: Document Surface (N11)\neditor.delta: P04; CRDTDeltaV1; Offer\nreplica: Local CRDT replica (N25)\nreplica.delta: P04; CRDTDeltaV1; Require\nreplica.session: P07; DocumentSessionV1; Require\nreplica.state: P24; ReplicaRefV1; Neutral\nroom: Room actor (N05)\nroom.session: P07; DocumentSessionV1; Offer\nroom.log: P02; DocumentAppendV1; Require\nroom.authority: P20; DocumentGrantV1; Require\nroom.presence: P04; PresenceV1; Offer\nroom.epoch: P24; ActivationRefV1; Neutral\npolicy: Workspace policy (N33)\npolicy.grant: P20; DocumentGrantV1; Offer\nlog: Document update log (N24)\nlog.append: P02; DocumentAppendV1; Offer\nlog.position: P24; LogPositionV1; Neutral\npresence: Presence TTL view (N22)\npresence.events: P04; PresenceV1; Require\nedit (H02): provider[0]=editor.delta; consumer[0]=replica.delta\nsession (H06): provider[0]=room.session; consumer[0]=replica.session\npersist (H05): provider[0]=log.append; consumer[0]=room.log\ngrant (H23): provider[0]=policy.grant; consumer[0]=room.authority\npresence (H02): provider[0]=room.presence; consumer[0]=presence.events\nreplicas (H14): local[0]=replica.state; durable[1]=log.position; coordinator[2]=room.epoch" }, { "id": "web-manna-docs", "src": "/docs/img/theory/web-manna-docs.svg", "alt": "Manna documentation: native reader, cited questions and PDF jobs", "text": "How is a question or PDF tied to one documentation revision?\nLexical retrieval ranks source sections and passes a bounded context into the answer pipeline. A durable workflow renders the pinned edition separately from the request.\nreader: Native documentation reader (N11)\nreader.request: P02; DocumentationReadV1; Require\nreader.answer: P01; CitedAnswerV1; Require\nreader.questionRef: P24; QuestionRefV1; Neutral\napi: Documentation service (N19)\napi.read: P02; DocumentationReadV1; Offer\napi.corpus: P02; CorpusReadV1; Require\napi.sections: P01; SectionPackV1; Offer\napi.export: P03; ExportIntentV1; Offer\ncorpus: Revisioned docs corpus (N26)\ncorpus.fetch: P02; CorpusReadV1; Offer\nretrieval: Bounded section retrieval (N22)\nretrieval.documents: P01; SectionPackV1; Require\nretrieval.context: P01; CitedContextV1; Offer\nretrieval.sourceRefs: P24; SourceRefSetV1; Neutral\nmodel: Answer model adapter (N18)\nmodel.context: P01; CitedContextV1; Require\nmodel.answer: P01; CitedAnswerV1; Offer\nmodel.answerRef: P24; AnswerRefV1; Neutral\njob: PDF export workflow (N06)\njob.start: P03; ExportIntentV1; Require\njob.output: P02; EditionPutV1; Require\npdf: Reading edition store (N26)\npdf.put: P02; EditionPutV1; Offer\nrequest (H05): provider[0]=api.read; consumer[0]=reader.request\nsource (H05): provider[0]=corpus.fetch; consumer[0]=api.corpus\nsections (H02): provider[0]=api.sections; consumer[0]=retrieval.documents\ncontext (H02): provider[0]=retrieval.context; consumer[0]=model.context\nanswer (H02): provider[0]=model.answer; consumer[0]=reader.answer\nexport (H03): provider[0]=api.export; consumer[0]=job.start\nstore (H05): provider[0]=pdf.put; consumer[0]=job.output\nevidence (H28): question[0]=reader.questionRef; sources[1]=retrieval.sourceRefs; answer[2]=model.answerRef" }, { "id": "web-multitenant", "src": "/docs/img/theory/web-multitenant.svg", "alt": "Tenant dashboard: scoped routes and mediated data access", "text": "Where does tenant identity become an enforced constraint?\nCommon Kotlin builds a typed query from validated request fields; server adapters materialize the verified tenant and principal context.\nroute: Workspace route (N12)\nroute.workspace: P11; WorkspaceRouteV1; Offer\nsurface: Dashboard Surface (N11)\nsurface.route: P11; WorkspaceRouteV1; Require\nsurface.read: P02; DashboardReadV1; Require\nverify: Principal verifier (N33)\nverify.context: P20; VerifiedContextV1; Offer\nverify.principalRef: P24; PrincipalRefV1; Neutral\nservice: Dashboard service (N19)\nservice.principal: P20; VerifiedContextV1; Require\nservice.dashboard: P02; DashboardReadV1; Offer\nservice.policy: P20; DataGrantV1; Require\nservice.storage: P02; ScopedQueryV1; Require\npolicy: Row / resource policy (N33)\npolicy.grant: P20; DataGrantV1; Offer\npolicy.policyRef: P24; PolicyRefV1; Neutral\ndb: Workspace authority (N21)\ndb.query: P02; ScopedQueryV1; Offer\ndb.authorityRef: P24; AuthorityRefV1; Neutral\nroute (H36): provider[0]=route.workspace; consumer[0]=surface.route\ngrant (H23): provider[0]=verify.context; consumer[0]=service.principal\nread (H05): provider[0]=service.dashboard; consumer[0]=surface.read\npolicy (H23): provider[0]=policy.grant; consumer[0]=service.policy\nquery (H05): provider[0]=db.query; consumer[0]=service.storage\nscope (H34): principal[0]=verify.principalRef; policy[1]=policy.policyRef; authority[2]=db.authorityRef" } ], "region": "theory-examples", "order": 1, "title": "Websites — worked graph designs", "nav": "Websites — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-web", "revision": "d96bd251ac3fbfbb06c2e03afbf9a079c029540743f39f49b294801b5ba3e2e3", "status": "design", "renderingRevision": "32f36761b707611c3e3d61f5bacbb6703761d6d1c457d025dc33f0f1bee89fec", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1", "logic-and-ownership-2", "failure-and-qualification-2", "hyperedge-roles-2", "kotlin-common-declaration-2", "logic-and-ownership-3", "failure-and-qualification-3", "hyperedge-roles-3", "kotlin-common-declaration-3", "logic-and-ownership-4", "failure-and-qualification-4", "hyperedge-roles-4", "kotlin-common-declaration-4" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-web", "polarity": "Neutral" }, { "id": "section-web-content", "anchor": "web-content", "label": "Content website: browser, edge cache and source publication", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-web#web-content", "polarity": "Neutral" }, { "id": "section-web-commerce", "anchor": "web-commerce", "label": "Commerce website: checkout, stock reservation and compensation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-web#web-commerce", "polarity": "Neutral" }, { "id": "section-web-collaboration", "anchor": "web-collaboration", "label": "Collaborative editor: sessions, replicas and workspace authority", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-web#web-collaboration", "polarity": "Neutral" }, { "id": "section-web-manna-docs", "anchor": "web-manna-docs", "label": "Manna documentation: native reader, cited questions and PDF jobs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-web#web-manna-docs", "polarity": "Neutral" }, { "id": "section-web-multitenant", "anchor": "web-multitenant", "label": "Tenant dashboard: scoped routes and mediated data access", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-web#web-multitenant", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-web:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-web", "incidences": [ { "node": "reaktor-examples-web", "port": "section-web-content", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-web:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-web", "incidences": [ { "node": "reaktor-examples-web", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-web:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-web", "incidences": [ { "node": "reaktor-examples-web", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-web.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Websites — worked graph designs", "level": 0 }, { "id": "web-content", "anchor": "web-content", "title": "Content website: browser, edge cache and source publication", "level": 2 }, { "id": "web-content-logic", "anchor": "web-content-logic", "title": "Logic and ownership", "level": 3 }, { "id": "web-content-qualification", "anchor": "web-content-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "web-content-relations", "anchor": "web-content-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "web-content-kotlin", "anchor": "web-content-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "web-commerce", "anchor": "web-commerce", "title": "Commerce website: checkout, stock reservation and compensation", "level": 2 }, { "id": "web-commerce-logic", "anchor": "web-commerce-logic", "title": "Logic and ownership", "level": 3 }, { "id": "web-commerce-qualification", "anchor": "web-commerce-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "web-commerce-relations", "anchor": "web-commerce-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "web-commerce-kotlin", "anchor": "web-commerce-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "web-collaboration", "anchor": "web-collaboration", "title": "Collaborative editor: sessions, replicas and workspace authority", "level": 2 }, { "id": "web-collaboration-logic", "anchor": "web-collaboration-logic", "title": "Logic and ownership", "level": 3 }, { "id": "web-collaboration-qualification", "anchor": "web-collaboration-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "web-collaboration-relations", "anchor": "web-collaboration-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "web-collaboration-kotlin", "anchor": "web-collaboration-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "web-manna-docs", "anchor": "web-manna-docs", "title": "Manna documentation: native reader, cited questions and PDF jobs", "level": 2 }, { "id": "web-manna-docs-logic", "anchor": "web-manna-docs-logic", "title": "Logic and ownership", "level": 3 }, { "id": "web-manna-docs-qualification", "anchor": "web-manna-docs-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "web-manna-docs-relations", "anchor": "web-manna-docs-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "web-manna-docs-kotlin", "anchor": "web-manna-docs-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "web-multitenant", "anchor": "web-multitenant", "title": "Tenant dashboard: scoped routes and mediated data access", "level": 2 }, { "id": "web-multitenant-logic", "anchor": "web-multitenant-logic", "title": "Logic and ownership", "level": 3 }, { "id": "web-multitenant-qualification", "anchor": "web-multitenant-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "web-multitenant-relations", "anchor": "web-multitenant-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "web-multitenant-kotlin", "anchor": "web-multitenant-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "web-content" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "web-commerce" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "web-collaboration" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "web-manna-docs" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "web-multitenant" } ] }, { "id": "reaktor-examples-workflows", "owner": "Reaktor", "kind": "design", "summary": "2 worked workflows designs with port profiles, hyperedge roles, arbitrary Kotlin logic and explicit failure conditions.", "use": "Read a worked design, then inspect its revisioned definition and interactive Blueprint graph.", "diagrams": [ { "id": "workflow-onboarding", "src": "/docs/img/theory/workflow-onboarding.svg", "alt": "Workflow: human approval with deadline and durable resumption", "text": "How can a workflow wait days without losing its decision context?\nKotlin reconstructs the transition from checkpoint state and a typed decision; deadline and cancellation are explicit events.\nworkflow: Onboarding workflow (N06)\nworkflow.proposal: P03; ReviewRequestV1; Offer\nworkflow.decision: P03; ReviewDecisionV1; Require\nworkflow.deadline: P15; DeadlineV1; Require\nworkflow.identity: P02; IdentityCreateV1; Require\nworkflow.state: P02; WorkflowCheckpointV1; Require\nworkflow.revision: P24; ProposalRefV1; Neutral\nhuman: Human approval (N20)\nhuman.proposal: P03; ReviewRequestV1; Require\nhuman.decision: P03; ReviewDecisionV1; Offer\nhuman.principal: P24; PrincipalRefV1; Neutral\ntimer: Deadline clock (N09)\ntimer.tick: P15; DeadlineV1; Offer\nidentity: Identity provider (N30)\nidentity.create: P02; IdentityCreateV1; Offer\njournal: Checkpoint authority (N21)\njournal.checkpoint: P02; WorkflowCheckpointV1; Offer\npolicy: Activation policy (N33)\npolicy.policy: P24; PolicyRefV1; Neutral\nreview (H02): provider[0]=workflow.proposal; consumer[0]=human.proposal\ndecision (H02): provider[0]=human.decision; consumer[0]=workflow.decision\ndeadline (H02): provider[0]=timer.tick; consumer[0]=workflow.deadline\nidentity (H05): provider[0]=identity.create; consumer[0]=workflow.identity\nstate (H05): provider[0]=journal.checkpoint; consumer[0]=workflow.state\napproval (H23): principal[0]=human.principal; proposal[1]=workflow.revision; policy[2]=policy.policy" }, { "id": "workflow-reconciliation", "src": "/docs/img/theory/workflow-reconciliation.svg", "alt": "Workflow: settlement reconciliation and exception handling", "text": "How does reconciliation distinguish a late receipt from a failed effect?\nA Kotlin comparison function classifies missing, duplicate, late and mismatched entries for a stated reconciliation cut.\nrun: Reconciliation workflow (N06)\nrun.findings: P01; MismatchSetV1; Require\nrun.proposal: P03; ResolutionProposalV1; Offer\nrun.receipt: P24; ReconciliationReceiptV1; Offer\nbank: Payment statement source (N30)\nbank.statement: P01; StatementV1; Offer\nbank.cut: P24; SourceCutV1; Neutral\nledger: Internal settlement ledger (N21)\nledger.snapshot: P01; SettlementSnapshotV1; Offer\nledger.cut: P24; SourceCutV1; Neutral\njoin: Temporal join (N07)\njoin.external: P01; StatementV1; Require\njoin.internal: P01; SettlementSnapshotV1; Require\njoin.findings: P01; MismatchSetV1; Offer\njoin.window: P24; WindowSpecV1; Neutral\nreview: Exception review (N20)\nreview.proposal: P03; ResolutionProposalV1; Require\nreceipt: Reconciliation evidence (N37)\nreceipt.input: P24; ReconciliationReceiptV1; Require\nstatement (H02): provider[0]=bank.statement; consumer[0]=join.external\nledger (H02): provider[0]=ledger.snapshot; consumer[0]=join.internal\nmismatch (H02): provider[0]=join.findings; consumer[0]=run.findings\nreview (H02): provider[0]=run.proposal; consumer[0]=review.proposal\nevidence (H27): provider[0]=run.receipt; consumer[0]=receipt.input\ncut (H11): external[0]=bank.cut; internal[1]=ledger.cut; join[2]=join.window" } ], "region": "theory-examples", "order": 4, "title": "Workflows — worked graph designs", "nav": "Workflows — worked graph designs", "group": "theory", "subsection": "theory-examples", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-examples-workflows", "revision": "44e4e382828b5a898f854c7373d097af27de07ae5880d0415ce281940cd172fe", "status": "design", "renderingRevision": "be2ba1e80beb777b1b0b6e28291eaeaebabb183ea7d056a5f7f05020f5b34cf1", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "logic-and-ownership", "failure-and-qualification", "hyperedge-roles", "kotlin-common-declaration", "logic-and-ownership-1", "failure-and-qualification-1", "hyperedge-roles-1", "kotlin-common-declaration-1" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-examples-workflows", "polarity": "Neutral" }, { "id": "section-workflow-onboarding", "anchor": "workflow-onboarding", "label": "Workflow: human approval with deadline and durable resumption", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-workflows#workflow-onboarding", "polarity": "Neutral" }, { "id": "section-workflow-reconciliation", "anchor": "workflow-reconciliation", "label": "Workflow: settlement reconciliation and exception handling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-examples-workflows#workflow-reconciliation", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-examples-workflows:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-examples-workflows", "incidences": [ { "node": "reaktor-examples-workflows", "port": "section-workflow-onboarding", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-workflows:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-examples-workflows", "incidences": [ { "node": "reaktor-examples-workflows", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-examples-workflows:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-examples-workflows", "incidences": [ { "node": "reaktor-examples-workflows", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-examples-workflows.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Workflows — worked graph designs", "level": 0 }, { "id": "workflow-onboarding", "anchor": "workflow-onboarding", "title": "Workflow: human approval with deadline and durable resumption", "level": 2 }, { "id": "workflow-onboarding-logic", "anchor": "workflow-onboarding-logic", "title": "Logic and ownership", "level": 3 }, { "id": "workflow-onboarding-qualification", "anchor": "workflow-onboarding-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "workflow-onboarding-relations", "anchor": "workflow-onboarding-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "workflow-onboarding-kotlin", "anchor": "workflow-onboarding-kotlin", "title": "Kotlin common declaration", "level": 3 }, { "id": "workflow-reconciliation", "anchor": "workflow-reconciliation", "title": "Workflow: settlement reconciliation and exception handling", "level": 2 }, { "id": "workflow-reconciliation-logic", "anchor": "workflow-reconciliation-logic", "title": "Logic and ownership", "level": 3 }, { "id": "workflow-reconciliation-qualification", "anchor": "workflow-reconciliation-qualification", "title": "Failure and qualification", "level": 3 }, { "id": "workflow-reconciliation-relations", "anchor": "workflow-reconciliation-relations", "title": "Hyperedge roles", "level": 3 }, { "id": "workflow-reconciliation-kotlin", "anchor": "workflow-reconciliation-kotlin", "title": "Kotlin common declaration", "level": 3 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "workflow-onboarding" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "workflow-reconciliation" } ] }, { "id": "reaktor-ffi-design", "owner": "Claude", "kind": "prior", "summary": "Merged into the canonical Reaktor FFI document.", "use": "Use for history only; prefer the Reaktor FFI document.", "region": "ffi", "order": 2, "title": "Reaktor Switchboard — the FFI design", "nav": "FFI Design (merged)", "group": "flexbuffers-ffi", "subsection": "ffi", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-ffi-design", "revision": "a30a1d740a7893100a55313fbe2871b1f1d9e6e50581ee518fd1f168a19ac97a", "status": "unverified", "renderingRevision": "860d783b201a6f3ac6768d357013a09b7dd013536d13e85d3e9af517b7ef58d3", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-ffi-design", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi-design#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-ffi-design:references-reaktor-ffi", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi-design:references-reaktor-ffi-frames", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-frames", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi-design:references-reaktor-ffi-services", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-services", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi-design:references-reaktor-ffi-trunks", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-trunks", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi-design:references-reaktor-ffi-roadmap", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-roadmap", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi-design:references-flexbuffer-performance-review", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi-design:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi-design:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-ffi-design", "incidences": [ { "node": "reaktor-ffi-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-ffi-design.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Switchboard — the FFI design", "level": 0 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "frames", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "services", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "trunks", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ffi", "anchor": "roadmap", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-ffi", "owner": "Claude", "kind": "module", "summary": "Current native hello proof and transport TODOs, plus proposed Switchboard typed frames, cross-language Flow, C ABI, graph representation, buffer ownership, mutable-runtime design input and acceptance gates. Refreshed against October codec failures; no production frame/hop latency is measured.", "use": "Use before implementing or reviewing any cross-language interop: the frame protocol, typed service codegen, stream/backpressure semantics, trunk catalog and C ABI, Hermes runtime, host-framework packaging, RPC integration, or FFI graph representation.", "region": "ffi", "order": 0, "title": "Reaktor FFI — Switchboard, the universal language bridge", "nav": "FFI", "group": "flexbuffers-ffi", "subsection": "ffi", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-ffi", "revision": "2ef19be2c632093b7a450b2bb842f3a589b7aa17a084865c826f742ccf70c83d", "status": "unverified", "renderingRevision": "1bb1c6f09601614cc1ff90ff76316e814d49420be731c0c32c97952e25b47132", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-ffi", "polarity": "Neutral" }, { "id": "section-goals", "anchor": "goals", "label": "1. Goals and requirements", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#goals", "polarity": "Neutral" }, { "id": "section-current-map", "anchor": "current-map", "label": "2. Current state: what exists in code today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#current-map", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "3. Design principles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#principles", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "4. Conceptual model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#model", "polarity": "Neutral" }, { "id": "section-frames", "anchor": "frames", "label": "5. Frame protocol v1", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#frames", "polarity": "Neutral" }, { "id": "section-services", "anchor": "services", "label": "6. Typed services: the only API most code sees", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#services", "polarity": "Neutral" }, { "id": "section-graph-representation", "anchor": "graph-representation", "label": "10. Graph representation and observability", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#graph-representation", "polarity": "Neutral" }, { "id": "section-trunks", "anchor": "trunks", "label": "8. Memory, frames, and trunks", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#trunks", "polarity": "Neutral" }, { "id": "section-roadmap", "anchor": "roadmap", "label": "15. Roadmap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#roadmap", "polarity": "Neutral" }, { "id": "section-performance", "anchor": "performance", "label": "13. Performance position", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#performance", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#related-docs", "polarity": "Neutral" }, { "id": "section-async", "anchor": "async", "label": "7. Sync and asynchronous models across languages", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#async", "polarity": "Neutral" }, { "id": "section-security", "anchor": "security", "label": "12. Security", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ffi#security", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-ffi:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-trunks", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-flexbuffer-performance-review", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-performance", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-reaktor-service", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-principles", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-reaktor-service-request-response", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-services", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "section-request-response", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-reaktor-surface-renderers", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-async", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-flatbuffers-flexbuffers-mutable-memory-05-mutable-memory-chapter-24", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-trunks", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "port": "section-chapter-24", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-reaktor-graph-protocol-visualise", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-graph-representation", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-visualise", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-flexbuffer-performance-review-stability", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-security", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "section-stability", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-flexbuffer-performance-review-android-bulk", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-performance", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "section-android-bulk", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-performance-observability", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ffi:references-reaktor-capability", "kind": "references", "owner": "reaktor-ffi", "incidences": [ { "node": "reaktor-ffi", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-ffi.json", "sections": [ { "id": "reaktor-ffi--switchboard-the-universal-language-bridge", "anchor": "reaktor-ffi--switchboard-the-universal-language-bridge", "title": "Reaktor FFI — Switchboard, the universal language bridge", "level": 1 }, { "id": "goals", "anchor": "goals", "title": "1. Goals and requirements", "level": 2 }, { "id": "current-map", "anchor": "current-map", "title": "2. Current state: what exists in code today", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "3. Design principles", "level": 2 }, { "id": "model", "anchor": "model", "title": "4. Conceptual model", "level": 2 }, { "id": "frames", "anchor": "frames", "title": "5. Frame protocol v1", "level": 2 }, { "id": "services", "anchor": "services", "title": "6. Typed services: the only API most code sees", "level": 2 }, { "id": "async", "anchor": "async", "title": "7. Sync and asynchronous models across languages", "level": 2 }, { "id": "trunks", "anchor": "trunks", "title": "8. Memory, frames, and trunks", "level": 2 }, { "id": "hermes", "anchor": "hermes", "title": "9. Hermes runtime", "level": 2 }, { "id": "graph-representation", "anchor": "graph-representation", "title": "10. Graph representation and observability", "level": 2 }, { "id": "rpc", "anchor": "rpc", "title": "11. gRPC and kotlinx.rpc are trunks, not competitors", "level": 2 }, { "id": "security", "anchor": "security", "title": "12. Security", "level": 2 }, { "id": "performance", "anchor": "performance", "title": "13. Performance position", "level": 2 }, { "id": "migration", "anchor": "migration", "title": "14. Migration from current code", "level": 2 }, { "id": "roadmap", "anchor": "roadmap", "title": "15. Roadmap", "level": 2 }, { "id": "acceptance-tests", "anchor": "acceptance-tests", "title": "16. Acceptance tests", "level": 2 }, { "id": "open-decisions", "anchor": "open-decisions", "title": "17. Open decisions", "level": 2 }, { "id": "non-goals", "anchor": "non-goals", "title": "18. Non-goals", "level": 2 }, { "id": "implementation-notes", "anchor": "implementation-notes", "title": "19. Implementation notes from live code", "level": 2 }, { "id": "lineage", "anchor": "lineage", "title": "20. Doc lineage", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "principles" }, { "id": "reaktor-service", "anchor": "request-response", "relation": "references", "sourceAnchor": "services" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "async" }, { "id": "flatbuffers-flexbuffers-mutable-memory-05-mutable-memory", "anchor": "chapter-24", "relation": "references", "sourceAnchor": "trunks" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "trunks" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "hermes" }, { "id": "reaktor-graph-protocol", "anchor": "visualise", "relation": "references", "sourceAnchor": "graph-representation" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "graph-representation" }, { "id": "flexbuffer-performance-review", "anchor": "stability", "relation": "references", "sourceAnchor": "security" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "performance" }, { "id": "flexbuffer-performance-review", "anchor": "android-bulk", "relation": "references", "sourceAnchor": "performance" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-formal-methods", "owner": "Claude", "kind": "architecture", "summary": "How Reaktor makes applications inherit machine-checked guarantees: the graph as executable and specification IR, a semantic boundary where effects happen only through modeled primitives with one labeled unsafe door, module-contributed invariants as data, GraphPatch as a formal transition system, a verification portfolio from deterministic checks through SMT, Alloy, TLA+/Quint and Lean, counterexamples returned to coding agents as structured findings, model-based and trace-conformance testing, and a machine-readable assurance manifest.", "use": "Read after Stable Foundations and Verified Foundations when designing reaktor-verify, the effect boundary, module SPEC invariants, or any agent surface that proposes graph mutations.", "region": "graph-correctness", "order": 2, "title": "Reaktor Formal Methods — a correctness-carrying platform for agents", "nav": "Formal Methods", "group": "graph", "subsection": "graph-correctness", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-formal-methods", "revision": "f2a931061deac06b55b34ee9096dfb06f2afaa2b4d33e01bde0229c512a93eac", "status": "unverified", "renderingRevision": "07046d892819567ef9ec0528d509a52c64a3a495697f0f8ea51e4134976a7712", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://blog.janestreet.com/formal-methods-at-jane-street-index/", "https://blog.janestreet.com/proofs-and-refutations-using-z3/", "https://blog.janestreet.com/getting-from-tested-to-battle-tested/", "https://github.com/UnitTestBot/ksmt", "https://quint.sh/", "https://quint.sh/docs/model-based-testing", "https://quint.sh/docs/development-docs/architecture-decision-records/adr004-effect-system", "https://apalache-mc.org/docs/apalache/index.html", "https://alloytools.org/", "https://github.com/AlloyTools/org.alloytools.alloy", "https://practicalalloy.github.io/", "https://lamport.azurewebsites.net/tla/science-book.html", "https://lamport.azurewebsites.net/tla/book.html", "https://program-proofs.com/", "https://lean-lang.org/theorem_proving_in_lean4/", "https://kotlinlang.org/docs/lincheck-guide.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-formal-methods", "polarity": "Neutral" }, { "id": "section-how-to-read", "anchor": "how-to-read", "label": "0. How to read this", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#how-to-read", "polarity": "Neutral" }, { "id": "section-claim", "anchor": "claim", "label": "1. The claim", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#claim", "polarity": "Neutral" }, { "id": "section-agents", "anchor": "agents", "label": "2. Why agents change the economics", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#agents", "polarity": "Neutral" }, { "id": "section-today", "anchor": "today", "label": "3. What exists today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#today", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "4. One graph, many interpreters", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#architecture", "polarity": "Neutral" }, { "id": "section-boundary", "anchor": "boundary", "label": "5. The semantic boundary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#boundary", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#related-docs", "polarity": "Neutral" }, { "id": "section-today-effects", "anchor": "today-effects", "label": "3.1 The effect surface is invisible to the graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#today-effects", "polarity": "Neutral" }, { "id": "section-modeled-node", "anchor": "modeled-node", "label": "5.1 The modeled node", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#modeled-node", "polarity": "Neutral" }, { "id": "section-effect-kinds", "anchor": "effect-kinds", "label": "6.1 The effect vocabulary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#effect-kinds", "polarity": "Neutral" }, { "id": "section-guarantee-modules", "anchor": "guarantee-modules", "label": "7.3 What each module contributes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#guarantee-modules", "polarity": "Neutral" }, { "id": "section-transition-which", "anchor": "transition-which", "label": "8.1 Which patch", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#transition-which", "polarity": "Neutral" }, { "id": "section-canvas", "anchor": "canvas", "label": "12. The canvas as the verification interface", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#canvas", "polarity": "Neutral" }, { "id": "section-conformance", "anchor": "conformance", "label": "13. Closing the gap between model and implementation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-formal-methods#conformance", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-formal-methods:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-visual-language-language", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-claim", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "section-language", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-graph-kernel-analysis-kernel", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-today-effects", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "section-kernel", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-graph-kernel-analysis-kernel-ontology", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-architecture", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "section-kernel-ontology", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-modeled-node", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-effect-kinds", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-work-contract", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-guarantee-modules", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-contract", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-work-tests", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-guarantee-modules", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-tests", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-deep-link-integration", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-guarantee-modules", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor_graph_visitors_design-mutations", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-transition-which", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "section-mutations", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-visual-language-agentic", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-canvas", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "section-agentic", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-conformance", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-essays", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-server", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-work", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-auth-analysis", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-formal-methods:references-reaktor-desktop-master-plan", "kind": "references", "owner": "reaktor-formal-methods", "incidences": [ { "node": "reaktor-formal-methods", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-formal-methods.json", "sections": [ { "id": "reaktor-formal-methods--a-correctness-carrying-platform-for-agents", "anchor": "reaktor-formal-methods--a-correctness-carrying-platform-for-agents", "title": "Reaktor Formal Methods — a correctness-carrying platform for agents", "level": 1 }, { "id": "how-to-read", "anchor": "how-to-read", "title": "0. How to read this", "level": 2 }, { "id": "claim", "anchor": "claim", "title": "1. The claim", "level": 2 }, { "id": "agents", "anchor": "agents", "title": "2. Why agents change the economics", "level": 2 }, { "id": "today", "anchor": "today", "title": "3. What exists today", "level": 2 }, { "id": "today-effects", "anchor": "today-effects", "title": "3.1 The effect surface is invisible to the graph", "level": 3 }, { "id": "today-mutation", "anchor": "today-mutation", "title": "3.2 Identity, wiring, mutation, validation", "level": 3 }, { "id": "today-authority", "anchor": "today-authority", "title": "3.3 Authority", "level": 3 }, { "id": "today-agents", "anchor": "today-agents", "title": "3.4 The agent path", "level": 3 }, { "id": "today-evidence", "anchor": "today-evidence", "title": "3.5 Evidence machinery that already exists", "level": 3 }, { "id": "today-tests", "anchor": "today-tests", "title": "3.6 Tests and CI", "level": 3 }, { "id": "today-defects", "anchor": "today-defects", "title": "3.7 What review did not catch", "level": 3 }, { "id": "architecture", "anchor": "architecture", "title": "4. One graph, many interpreters", "level": 2 }, { "id": "boundary", "anchor": "boundary", "title": "5. The semantic boundary", "level": 2 }, { "id": "modeled-node", "anchor": "modeled-node", "title": "5.1 The modeled node", "level": 3 }, { "id": "boundary-canvas", "anchor": "boundary-canvas", "title": "5.2 What the canvas shows", "level": 3 }, { "id": "effects", "anchor": "effects", "title": "6. Effects and capabilities", "level": 2 }, { "id": "effect-kinds", "anchor": "effect-kinds", "title": "6.1 The effect vocabulary", "level": 3 }, { "id": "capability-effect", "anchor": "capability-effect", "title": "6.2 Capability offers, grants, decisions, effects", "level": 3 }, { "id": "guarantees", "anchor": "guarantees", "title": "7. Guarantees as data", "level": 2 }, { "id": "guarantee-types", "anchor": "guarantee-types", "title": "7.1 The vocabulary", "level": 3 }, { "id": "guarantee-module", "anchor": "guarantee-module", "title": "7.2 Where they live", "level": 3 }, { "id": "guarantee-modules", "anchor": "guarantee-modules", "title": "7.3 What each module contributes", "level": 3 }, { "id": "transition", "anchor": "transition", "title": "8. Mutation as a transition system", "level": 2 }, { "id": "transition-which", "anchor": "transition-which", "title": "8.1 Which patch", "level": 3 }, { "id": "transition-laws", "anchor": "transition-laws", "title": "8.2 The laws", "level": 3 }, { "id": "transition-authority", "anchor": "transition-authority", "title": "8.3 Where the obligations plug in", "level": 3 }, { "id": "transition-editor", "anchor": "transition-editor", "title": "8.4 What changes in the editor first", "level": 3 }, { "id": "spec-ir", "anchor": "spec-ir", "title": "9. The specification IR", "level": 2 }, { "id": "spec-ast", "anchor": "spec-ast", "title": "9.1 The language", "level": 3 }, { "id": "spec-dsl", "anchor": "spec-dsl", "title": "9.2 The DSL", "level": 3 }, { "id": "portfolio", "anchor": "portfolio", "title": "10. The verification portfolio", "level": 2 }, { "id": "agent-loop", "anchor": "agent-loop", "title": "11. The agent loop", "level": 2 }, { "id": "agent-pipeline", "anchor": "agent-pipeline", "title": "11.1 The pipeline", "level": 3 }, { "id": "agent-finding", "anchor": "agent-finding", "title": "11.2 The finding", "level": 3 }, { "id": "agent-transport", "anchor": "agent-transport", "title": "11.3 How agents reach it", "level": 3 }, { "id": "canvas", "anchor": "canvas", "title": "12. The canvas as the verification interface", "level": 2 }, { "id": "conformance", "anchor": "conformance", "title": "13. Closing the gap between model and implementation", "level": 2 }, { "id": "manifest", "anchor": "manifest", "title": "14. The assurance manifest", "level": 2 }, { "id": "example", "anchor": "example", "title": "15. Worked example: BestBuds chat", "level": 2 }, { "id": "example-today", "anchor": "example-today", "title": "15.1 The graph today", "level": 3 }, { "id": "example-invariant", "anchor": "example-invariant", "title": "15.2 The invariant", "level": 3 }, { "id": "example-finding", "anchor": "example-finding", "title": "15.3 The patch and the finding", "level": 3 }, { "id": "example-boundary", "anchor": "example-boundary", "title": "15.4 The boundary", "level": 3 }, { "id": "example-manifest", "anchor": "example-manifest", "title": "15.5 What the manifest says", "level": 3 }, { "id": "build-order", "anchor": "build-order", "title": "16. What to build, in what order", "level": 2 }, { "id": "first-experiment", "anchor": "first-experiment", "title": "16.1 The first experiment", "level": 3 }, { "id": "limits", "anchor": "limits", "title": "17. What this does not claim", "level": 2 }, { "id": "open", "anchor": "open", "title": "18. Open questions", "level": 2 }, { "id": "reading", "anchor": "reading", "title": "19. Reading list", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 }, { "id": "references", "anchor": "references", "title": "References", "level": 2 } ], "links": [ { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-visual-language", "anchor": "language", "relation": "references", "sourceAnchor": "claim" }, { "id": "graph-kernel-analysis", "anchor": "kernel", "relation": "references", "sourceAnchor": "today-effects" }, { "id": "graph-kernel-analysis", "anchor": "kernel-ontology", "relation": "references", "sourceAnchor": "architecture" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "modeled-node" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "effect-kinds" }, { "id": "reaktor-work", "anchor": "contract", "relation": "references", "sourceAnchor": "guarantee-modules" }, { "id": "reaktor-work", "anchor": "tests", "relation": "references", "sourceAnchor": "guarantee-modules" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "guarantee-modules" }, { "id": "reaktor_graph_visitors_design", "anchor": "mutations", "relation": "references", "sourceAnchor": "transition-which" }, { "id": "reaktor-visual-language", "anchor": "language", "relation": "references", "sourceAnchor": "spec-dsl" }, { "id": "reaktor-visual-language", "anchor": "agentic", "relation": "references", "sourceAnchor": "canvas" }, { "id": "reaktor-work", "anchor": "tests", "relation": "references", "sourceAnchor": "conformance" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "conformance" }, { "id": "reaktor-work", "anchor": "tests", "relation": "references", "sourceAnchor": "build-order" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-framework-overview", "owner": "Claude", "kind": "overview", "summary": "The single holistic overview for beginners and experts: the full-stack-modules + Turing-complete-wiring model, the Unreal Engine analogy, the graph and its visitors, a real BestBuds worked example, and every subsystem — with an honest shipped-vs-designed map.", "use": "Read first to understand the full Reaktor model before diving into graph, visitors, modules, control plane, or subsystem docs.", "region": "start-here-core", "order": 1, "title": "Reaktor Framework Overview", "nav": "Framework Overview", "group": "start-here", "subsection": "start-here-core", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-framework-overview", "revision": "c0996146d6a571ce5b79fdad0d5146b1cc9797c82d29f55c0928887720fd80ed", "status": "unverified", "renderingRevision": "f165fa6a1029be176659f4995d5d61fcd5deff89d65964660a3fd1190d53960c", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-framework-overview", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "1. The model: full-stack modules and a graph that wires them", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#model", "polarity": "Neutral" }, { "id": "section-unreal", "anchor": "unreal", "label": "2. The Unreal Engine model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#unreal", "polarity": "Neutral" }, { "id": "section-expo-dapr", "anchor": "expo-dapr", "label": "3. Familiar analogies: Expo, Dapr — and what's new", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#expo-dapr", "polarity": "Neutral" }, { "id": "section-lifecycle", "anchor": "lifecycle", "label": "4. One model across the whole lifecycle", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#lifecycle", "polarity": "Neutral" }, { "id": "section-authorship", "anchor": "authorship", "label": "5. Expanding what people and AI agents can build", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#authorship", "polarity": "Neutral" }, { "id": "section-graph", "anchor": "graph", "label": "6. The graph system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#graph", "polarity": "Neutral" }, { "id": "section-media", "anchor": "media", "label": "7.11 Media — reaktor-media", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#media", "polarity": "Neutral" }, { "id": "section-io", "anchor": "io", "label": "7.7 reaktor-io — the transport spine", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#io", "polarity": "Neutral" }, { "id": "section-bestbuds", "anchor": "bestbuds", "label": "7.0 BestBuds, end to end", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#bestbuds", "polarity": "Neutral" }, { "id": "section-12-the-graph-wires-them", "anchor": "12-the-graph-wires-them", "label": "1.2 The graph wires them", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#12-the-graph-wires-them", "polarity": "Neutral" }, { "id": "section-turing-complete-wiring", "anchor": "turing-complete-wiring", "label": "1.3 Wiring that is also a program", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#turing-complete-wiring", "polarity": "Neutral" }, { "id": "section-visitors", "anchor": "visitors", "label": "6.5 Visitors: one traversal, many interpretations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#visitors", "polarity": "Neutral" }, { "id": "section-system-graph", "anchor": "system-graph", "label": "6.7 The unified system graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#system-graph", "polarity": "Neutral" }, { "id": "section-core", "anchor": "core", "label": "7.1 reaktor-core — the foundation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#core", "polarity": "Neutral" }, { "id": "section-ui", "anchor": "ui", "label": "7.2 UI: Compose-first, with React × Compose ahead", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#ui", "polarity": "Neutral" }, { "id": "section-auth", "anchor": "auth", "label": "7.3 reaktor-auth and multitenancy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#auth", "polarity": "Neutral" }, { "id": "section-service", "anchor": "service", "label": "7.4 reaktor-service — the service layer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#service", "polarity": "Neutral" }, { "id": "section-actors", "anchor": "actors", "label": "7.5 The actor model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#actors", "polarity": "Neutral" }, { "id": "section-data", "anchor": "data", "label": "7.6 The data layer — reaktor-db", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#data", "polarity": "Neutral" }, { "id": "section-flexbuffers", "anchor": "flexbuffers", "label": "7.8 FlexBuffers — reaktor-flexbuffer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#flexbuffers", "polarity": "Neutral" }, { "id": "section-ffi", "anchor": "ffi", "label": "7.9 FFI — reaktor-ffi", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#ffi", "polarity": "Neutral" }, { "id": "section-work", "anchor": "work", "label": "7.10 Background work — reaktor-work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#work", "polarity": "Neutral" }, { "id": "section-notifications", "anchor": "notifications", "label": "7.12 Notifications — reaktor-notification", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#notifications", "polarity": "Neutral" }, { "id": "section-device", "anchor": "device", "label": "7.13 Deep links and device capabilities", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#device", "polarity": "Neutral" }, { "id": "section-telemetry", "anchor": "telemetry", "label": "7.14 Telemetry, analytics, and performance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#telemetry", "polarity": "Neutral" }, { "id": "section-fabric", "anchor": "fabric", "label": "7.15 The distributed fabric", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#fabric", "polarity": "Neutral" }, { "id": "section-authoring", "anchor": "authoring", "label": "8. The authoring surface", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#authoring", "polarity": "Neutral" }, { "id": "section-further-reading", "anchor": "further-reading", "label": "10. Further reading", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#further-reading", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-framework-overview#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-framework-overview:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-12-the-graph-wires-them", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-turing-complete-wiring", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-cli", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-unreal", "role": "source", "ordinal": 0 }, { "node": "reaktor-cli", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-unreal", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-arena", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-unreal", "role": "source", "ordinal": 0 }, { "node": "reaktor-arena", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-authorship", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-visitors", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-system-graph", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-system-graph", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-core", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-core", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-surface-renderers", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-ui", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-auth-analysis", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-auth", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-auth", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-service", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-service", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-actors", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-actors", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-db-reading-map", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-data", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-reading-map", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-db", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-data", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-flexbuffer-performance-review", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-flexbuffers", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-flexbuffers", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-flexbuffers", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-ffi", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-ffi", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-work", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-notifications-design", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-notifications", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-deep-link-integration", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-device", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-telemetry", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-performance-observability", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-telemetry", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-server", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-fabric", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-fabric", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-mesh", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-fabric", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-capability", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-fabric", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-authoring", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-browser-local-ai", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-authoring", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-devops", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-authoring", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-secrets-management", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-authoring", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-flow-analysis", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-further-reading", "role": "source", "ordinal": 0 }, { "node": "flow-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-further-reading", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-framework-overview:references-reaktor-competitive-analysis", "kind": "references", "owner": "reaktor-framework-overview", "incidences": [ { "node": "reaktor-framework-overview", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-framework-overview.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Framework Overview", "level": 0 }, { "id": "model", "anchor": "model", "title": "1. The model: full-stack modules and a graph that wires them", "level": 2 }, { "id": "11-modules-are-full-stack", "anchor": "11-modules-are-full-stack", "title": "1.1 Modules are full-stack", "level": 3 }, { "id": "12-the-graph-wires-them", "anchor": "12-the-graph-wires-them", "title": "1.2 The graph wires them", "level": 3 }, { "id": "turing-complete-wiring", "anchor": "turing-complete-wiring", "title": "1.3 Wiring that is also a program", "level": 3 }, { "id": "unreal", "anchor": "unreal", "title": "2. The Unreal Engine model", "level": 2 }, { "id": "expo-dapr", "anchor": "expo-dapr", "title": "3. Familiar analogies: Expo, Dapr — and what's new", "level": 2 }, { "id": "lifecycle", "anchor": "lifecycle", "title": "4. One model across the whole lifecycle", "level": 2 }, { "id": "authorship", "anchor": "authorship", "title": "5. Expanding what people and AI agents can build", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "6. The graph system", "level": 2 }, { "id": "graph-model", "anchor": "graph-model", "title": "6.1 What a graph is", "level": 3 }, { "id": "ports", "anchor": "ports", "title": "6.2 Ports, edges, and wiring", "level": 3 }, { "id": "capabilities", "anchor": "capabilities", "title": "6.3 Capabilities: behavior composed, not inherited", "level": 3 }, { "id": "navigation", "anchor": "navigation", "title": "6.4 Navigation is graph-native", "level": 3 }, { "id": "visitors", "anchor": "visitors", "title": "6.5 Visitors: one traversal, many interpretations", "level": 3 }, { "id": "snapshots", "anchor": "snapshots", "title": "6.6 Snapshots and safe mutation", "level": 3 }, { "id": "system-graph", "anchor": "system-graph", "title": "6.7 The unified system graph", "level": 3 }, { "id": "polyglot", "anchor": "polyglot", "title": "6.8 Polyglot: one graph, every target", "level": 3 }, { "id": "subsystems", "anchor": "subsystems", "title": "7. The full-stack subsystems", "level": 2 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "7.0 BestBuds, end to end", "level": 3 }, { "id": "core", "anchor": "core", "title": "7.1 reaktor-core — the foundation", "level": 3 }, { "id": "ui", "anchor": "ui", "title": "7.2 UI: Compose-first, with React × Compose ahead", "level": 3 }, { "id": "auth", "anchor": "auth", "title": "7.3 reaktor-auth and multitenancy", "level": 3 }, { "id": "service", "anchor": "service", "title": "7.4 reaktor-service — the service layer", "level": 3 }, { "id": "actors", "anchor": "actors", "title": "7.5 The actor model", "level": 3 }, { "id": "data", "anchor": "data", "title": "7.6 The data layer — reaktor-db", "level": 3 }, { "id": "io", "anchor": "io", "title": "7.7 reaktor-io — the transport spine", "level": 3 }, { "id": "flexbuffers", "anchor": "flexbuffers", "title": "7.8 FlexBuffers — reaktor-flexbuffer", "level": 3 }, { "id": "ffi", "anchor": "ffi", "title": "7.9 FFI — reaktor-ffi", "level": 3 }, { "id": "work", "anchor": "work", "title": "7.10 Background work — reaktor-work", "level": 3 }, { "id": "media", "anchor": "media", "title": "7.11 Media — reaktor-media", "level": 3 }, { "id": "notifications", "anchor": "notifications", "title": "7.12 Notifications — reaktor-notification", "level": 3 }, { "id": "device", "anchor": "device", "title": "7.13 Deep links and device capabilities", "level": 3 }, { "id": "telemetry", "anchor": "telemetry", "title": "7.14 Telemetry, analytics, and performance", "level": 3 }, { "id": "fabric", "anchor": "fabric", "title": "7.15 The distributed fabric", "level": 3 }, { "id": "module-map", "anchor": "module-map", "title": "Module map", "level": 3 }, { "id": "authoring", "anchor": "authoring", "title": "8. The authoring surface", "level": 2 }, { "id": "status", "anchor": "status", "title": "9. What runs today, and where it goes", "level": 2 }, { "id": "further-reading", "anchor": "further-reading", "title": "10. Further reading", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "12-the-graph-wires-them" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "turing-complete-wiring" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "unreal" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "unreal" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "unreal" }, { "id": "reaktor-arena", "anchor": "", "relation": "references", "sourceAnchor": "unreal" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "expo-dapr" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "authorship" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "authorship" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "visitors" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "system-graph" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "system-graph" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "core" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "ui" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "ui" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "ui" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "auth" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "auth" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "service" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "actors" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "actors" }, { "id": "reaktor-db", "anchor": "reading-map", "relation": "references", "sourceAnchor": "data" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "data" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "flexbuffers" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "flexbuffers" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "flexbuffers" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "ffi" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "work" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "notifications" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "device" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "telemetry" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "telemetry" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "fabric" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "fabric" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "fabric" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "fabric" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "module-map" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "module-map" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "reaktor-cli", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "authoring" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "flow-analysis", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "further-reading" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-gemini-devops-agent", "owner": "Codex", "kind": "ops", "summary": "Bounded Antigravity CLI handoff layer for delegating BestBuds/Reaktor build, test, deploy, log, replay, and live-ops execution to Gemini 3.5 Flash High.", "use": "Use before handing DevOps execution from Codex or Claude to Antigravity CLI, adding agent-run recipes, or wiring build/test/deploy operations into reaktorDesktop.", "region": "agents-in-products", "order": 3, "title": "Gemini DevOps Agent", "nav": "Gemini DevOps Agent", "group": "agents", "subsection": "agents-in-products", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-gemini-devops-agent", "revision": "51b171390849154efae49c85d18d9145ad5600c462ecefb27b4d7b92c88a36ac", "status": "unverified", "renderingRevision": "6dc20c8e592abc2c1a0c8cc770f329145ba3ee7f2d3ab36695b54afa16d4d0d8", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "scanned" ], "externalLinks": [ "https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/", "https://antigravity.google/docs/gcli-migration", "https://a2a-protocol.org/latest/specification/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent", "polarity": "Neutral" }, { "id": "section-scanned", "anchor": "implementation-evidence", "label": "Implementation evidence", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent#implementation-evidence", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "Execution model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent#model", "polarity": "Neutral" }, { "id": "section-tooling", "anchor": "tooling", "label": "Repo tooling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent#tooling", "polarity": "Neutral" }, { "id": "section-a2a", "anchor": "a2a", "label": "A2A orchestration", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent#a2a", "polarity": "Neutral" }, { "id": "section-recipes", "anchor": "recipes", "label": "Recipe matrix", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent#recipes", "polarity": "Neutral" }, { "id": "section-safety", "anchor": "safety", "label": "Safety classes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent#safety", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-gemini-devops-agent#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-gemini-devops-agent:references-reaktor-devops", "kind": "references", "owner": "reaktor-gemini-devops-agent", "incidences": [ { "node": "reaktor-gemini-devops-agent", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-gemini-devops-agent:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-gemini-devops-agent", "incidences": [ { "node": "reaktor-gemini-devops-agent", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-gemini-devops-agent:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-gemini-devops-agent", "incidences": [ { "node": "reaktor-gemini-devops-agent", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-gemini-devops-agent:references-security-plan", "kind": "references", "owner": "reaktor-gemini-devops-agent", "incidences": [ { "node": "reaktor-gemini-devops-agent", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-gemini-devops-agent:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-gemini-devops-agent", "incidences": [ { "node": "reaktor-gemini-devops-agent", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-gemini-devops-agent:references-auth-analysis", "kind": "references", "owner": "reaktor-gemini-devops-agent", "incidences": [ { "node": "reaktor-gemini-devops-agent", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-gemini-devops-agent.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Gemini DevOps Agent", "level": 0 }, { "id": "implementation-evidence", "anchor": "implementation-evidence", "title": "Implementation evidence", "level": 2 }, { "id": "model", "anchor": "model", "title": "Execution model", "level": 2 }, { "id": "tooling", "anchor": "tooling", "title": "Repo tooling", "level": 2 }, { "id": "a2a", "anchor": "a2a", "title": "A2A orchestration", "level": 2 }, { "id": "recipes", "anchor": "recipes", "title": "Recipe matrix", "level": 2 }, { "id": "safety", "anchor": "safety", "title": "Safety classes", "level": 2 }, { "id": "prompt", "anchor": "prompt", "title": "Prompt constraints", "level": 2 }, { "id": "examples", "anchor": "examples", "title": "Handoff examples", "level": 2 }, { "id": "desktop", "anchor": "desktop", "title": "Productionization path", "level": 2 }, { "id": "not-own", "anchor": "not-own", "title": "What Antigravity should not own", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 }, { "id": "references", "anchor": "references", "title": "References", "level": 2 } ], "links": [ { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-graph-distribution-theory", "summary": "Execution profiles, graph cuts, authority-mediated changes, code push, epochs, migration, draining and evidence.", "kind": "design", "owner": "Reaktor", "use": "Read the theory and distinguish structural checks from runtime, target and deployment qualification.", "region": "theory-foundations", "order": 7, "title": "Graph composition, distribution and safe change", "nav": "Distribution and change", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-distribution-theory", "revision": "c86c523af6599698ba7736218967657ceb565503950989bdc902f0b08394290a", "status": "design", "renderingRevision": "928ffc2fc0565c3be40c182e433f5c9e524d66500734fe364d555f92e0422256", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-distribution-theory", "polarity": "Neutral" }, { "id": "section-execution-profiles", "anchor": "execution-profiles", "label": "Execution profiles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-distribution-theory#execution-profiles", "polarity": "Neutral" }, { "id": "section-partitioning-as-a-constrained-graph-cut", "anchor": "partitioning-as-a-constrained-graph-cut", "label": "Partitioning as a constrained graph cut", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-distribution-theory#partitioning-as-a-constrained-graph-cut", "polarity": "Neutral" }, { "id": "section-one-change-path-for-humans-and-agents", "anchor": "one-change-path-for-humans-and-agents", "label": "One change path for humans and agents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-distribution-theory#one-change-path-for-humans-and-agents", "polarity": "Neutral" }, { "id": "section-activation-replacement-and-draining", "anchor": "activation-replacement-and-draining", "label": "Activation, replacement and draining", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-distribution-theory#activation-replacement-and-draining", "polarity": "Neutral" }, { "id": "section-visibility-and-evidence", "anchor": "visibility-and-evidence", "label": "Visibility and evidence", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-distribution-theory#visibility-and-evidence", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-distribution-theory:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-graph-distribution-theory", "incidences": [ { "node": "reaktor-graph-distribution-theory", "port": "section-partitioning-as-a-constrained-graph-cut", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-distribution-theory:requires-reaktor-graph-theory", "kind": "requires", "owner": "reaktor-graph-distribution-theory", "incidences": [ { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-distribution-theory:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-graph-distribution-theory", "incidences": [ { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-distribution-theory:derived-from-engine-preprint-evolution", "kind": "derived-from", "owner": "reaktor-graph-distribution-theory", "incidences": [ { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evolution", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-distribution-theory:references-architecture-atlas-semantics", "kind": "references", "owner": "reaktor-graph-distribution-theory", "incidences": [ { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-semantics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-distribution-theory:references-architecture-atlas-evolution", "kind": "references", "owner": "reaktor-graph-distribution-theory", "incidences": [ { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-evolution", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-distribution-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Graph composition, distribution and safe change", "level": 0 }, { "id": "execution-profiles", "anchor": "execution-profiles", "title": "Execution profiles", "level": 2 }, { "id": "partitioning-as-a-constrained-graph-cut", "anchor": "partitioning-as-a-constrained-graph-cut", "title": "Partitioning as a constrained graph cut", "level": 2 }, { "id": "one-change-path-for-humans-and-agents", "anchor": "one-change-path-for-humans-and-agents", "title": "One change path for humans and agents", "level": 2 }, { "id": "activation-replacement-and-draining", "anchor": "activation-replacement-and-draining", "title": "Activation, replacement and draining", "level": 2 }, { "id": "visibility-and-evidence", "anchor": "visibility-and-evidence", "title": "Visibility and evidence", "level": 2 } ], "links": [ { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "partitioning-as-a-constrained-graph-cut" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "partitioning-as-a-constrained-graph-cut" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "partitioning-as-a-constrained-graph-cut" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "partitioning-as-a-constrained-graph-cut" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "visibility-and-evidence" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "visibility-and-evidence" } ] }, { "id": "reaktor-graph-hierarchical-ui", "owner": "Codex", "kind": "design", "summary": "Independent scope, semantic layers, detail and time: nested ports, stable boundary summaries, source/runtime selection, extraction and live scene behavior.", "use": "Use before changing graph layout, reaktor-flow projections, Reaktor Engine graph navigation, ServiceNode cross-system stitching, or unified graph source visualization.", "region": "graph-model", "order": 9, "title": "Reaktor Graph Navigation, Layers and Live Views", "nav": "Hierarchical Graph UI", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui", "revision": "c0d9f265e6c2bb01407c7ad5acab89ab161c5c71dfcda9495102d57daa486a9f", "status": "unverified", "renderingRevision": "02d1c3d8c363b508e4f1eed4901bebec0d5df529b052acb5590856abb84ee9c3", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://c4model.com/", "https://eclipse.dev/elk/documentation/tooldevelopers/graphdatastructure.html", "https://eclipse.dev/elk/reference/algorithms/org-eclipse-elk-layered.html", "https://dev.epicgames.com/documentation/unreal-engine/collapsing-graphs-in-unreal-engine?lang=en-US" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui", "polarity": "Neutral" }, { "id": "section-problem", "anchor": "problem", "label": "1. The problem: retain the whole system without flattening it", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#problem", "polarity": "Neutral" }, { "id": "section-c4", "anchor": "c4", "label": "2. Architectural levels are useful presets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#c4", "polarity": "Neutral" }, { "id": "section-levels", "anchor": "levels", "label": "3. Scope and detail presets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#levels", "polarity": "Neutral" }, { "id": "section-scope", "anchor": "scope", "label": "4. Scope, layers, time and mode are separate", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#scope", "polarity": "Neutral" }, { "id": "section-document", "anchor": "document", "label": "5. Hierarchical view documents are projections", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#document", "polarity": "Neutral" }, { "id": "section-rendering", "anchor": "rendering", "label": "6. Rendering and incremental update rules", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#rendering", "polarity": "Neutral" }, { "id": "section-service-nodes", "anchor": "service-nodes", "label": "7. Service and FFI boundaries connect the system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#service-nodes", "polarity": "Neutral" }, { "id": "section-fixture-ledger", "anchor": "fixture-ledger", "label": "Fixture and identity ledger", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#fixture-ledger", "polarity": "Neutral" }, { "id": "section-decision-table", "anchor": "decision-table", "label": "Decision table for the consistency pass", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#decision-table", "polarity": "Neutral" }, { "id": "section-acceptance-tests", "anchor": "acceptance-tests", "label": "11. Workflow acceptance tests", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#acceptance-tests", "polarity": "Neutral" }, { "id": "section-real-app-topology", "anchor": "real-app-topology", "label": "The real application view: topology, behavior and execution", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#real-app-topology", "polarity": "Neutral" }, { "id": "section-continuous-zoom", "anchor": "continuous-zoom", "label": "Zoom from the whole application to a port", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#continuous-zoom", "polarity": "Neutral" }, { "id": "section-system-map", "anchor": "system-map", "label": "The system map: four linked states over one graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#system-map", "polarity": "Neutral" }, { "id": "section-dense-topology", "anchor": "dense-topology", "label": "Dense application topology with mixed detail", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#dense-topology", "polarity": "Neutral" }, { "id": "section-selection-across-tools", "anchor": "selection-across-tools", "label": "Carry one selected subject through the tools", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#selection-across-tools", "polarity": "Neutral" }, { "id": "section-implementation-plan", "anchor": "implementation-plan", "label": "10. Incremental implementation plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-hierarchical-ui#implementation-plan", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-hierarchical-ui:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-graph-pane", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-atlas-revamp-5.6-ultra-board-ZCxzu", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-system-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-ZCxzu", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-atlas-revamp-5.6-ultra-board-DBc14", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-system-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-DBc14", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-atlas-revamp-5.6-ultra-board-pxsmW", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-system-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-pxsmW", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-atlas-revamp-5.6-ultra-board-Pu9Sf", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-system-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-Pu9Sf", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-visual-language-road-grammar", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-system-map", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "section-road-grammar", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-unified-system-graph-canonical", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-document", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-canonical", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-document", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-atlas-revamp-5.6-ultra-board-FsQx4", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-dense-topology", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-FsQx4", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-graph-protocol-boundaries", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-service-nodes", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-boundaries", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-unified-system-graph-cloud-imports", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-service-nodes", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-cloud-imports", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-atlas-revamp-5.6-ultra-board-LODux", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-real-app-topology", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-LODux", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-unified-system-graph-existing", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-real-app-topology", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-existing", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-unified-system-graph-coverage-matrix", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-decision-table", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-coverage-matrix", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-reaktor-unified-system-graph-operations", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-selection-across-tools", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-operations", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-hierarchical-ui:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-graph-hierarchical-ui", "incidences": [ { "node": "reaktor-graph-hierarchical-ui", "port": "section-implementation-plan", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-hierarchical-ui.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Graph Navigation, Layers and Live Views", "level": 0 }, { "id": "problem", "anchor": "problem", "title": "1. The problem: retain the whole system without flattening it", "level": 2 }, { "id": "c4", "anchor": "c4", "title": "2. Architectural levels are useful presets", "level": 2 }, { "id": "levels", "anchor": "levels", "title": "3. Scope and detail presets", "level": 2 }, { "id": "continuous-zoom", "anchor": "continuous-zoom", "title": "Zoom from the whole application to a port", "level": 3 }, { "id": "system-map", "anchor": "system-map", "title": "The system map: four linked states over one graph", "level": 3 }, { "id": "map-instrument", "anchor": "map-instrument", "title": "Map viewport instrument and explain view", "level": 3 }, { "id": "route-navigation", "anchor": "route-navigation", "title": "Select and save routes through the system", "level": 3 }, { "id": "landscape", "anchor": "landscape", "title": "L0: Product landscape", "level": 3 }, { "id": "runtime-island", "anchor": "runtime-island", "title": "L1: Runtime island or authority domain", "level": 3 }, { "id": "subgraph", "anchor": "subgraph", "title": "L2: Graph scope or reusable composition", "level": 3 }, { "id": "component-flow", "anchor": "component-flow", "title": "L3: Component behavior and interfaces", "level": 3 }, { "id": "detail", "anchor": "detail", "title": "L4: Source, operation or execution detail", "level": 3 }, { "id": "scope", "anchor": "scope", "title": "4. Scope, layers, time and mode are separate", "level": 2 }, { "id": "document", "anchor": "document", "title": "5. Hierarchical view documents are projections", "level": 2 }, { "id": "rendering", "anchor": "rendering", "title": "6. Rendering and incremental update rules", "level": 2 }, { "id": "summary-nodes", "anchor": "summary-nodes", "title": "Child scope summaries", "level": 3 }, { "id": "boundary-portals", "anchor": "boundary-portals", "title": "Boundary portals and bundles", "level": 3 }, { "id": "layout-strategies", "anchor": "layout-strategies", "title": "Layout strategies", "level": 3 }, { "id": "dense-topology", "anchor": "dense-topology", "title": "Dense application topology with mixed detail", "level": 3 }, { "id": "service-nodes", "anchor": "service-nodes", "title": "7. Service and FFI boundaries connect the system", "level": 2 }, { "id": "unified-graph", "anchor": "unified-graph", "title": "8. Native, imported and observed facts share the model", "level": 2 }, { "id": "engine-ui", "anchor": "engine-ui", "title": "9. Persistent super-IDE interaction contract", "level": 2 }, { "id": "real-app-topology", "anchor": "real-app-topology", "title": "The real application view: topology, behavior and execution", "level": 3 }, { "id": "decision-table", "anchor": "decision-table", "title": "Decision table for the consistency pass", "level": 3 }, { "id": "fixture-ledger", "anchor": "fixture-ledger", "title": "Fixture and identity ledger", "level": 3 }, { "id": "selection-across-tools", "anchor": "selection-across-tools", "title": "Carry one selected subject through the tools", "level": 3 }, { "id": "inspect-element", "anchor": "inspect-element", "title": "Inspect an element, reveal its entire feature", "level": 3 }, { "id": "route-controls", "anchor": "route-controls", "title": "Run, simulate and reconcile a route", "level": 3 }, { "id": "grouping-is-not-extraction", "anchor": "grouping-is-not-extraction", "title": "Grouping is not extraction", "level": 3 }, { "id": "implementation-plan", "anchor": "implementation-plan", "title": "10. Incremental implementation plan", "level": 2 }, { "id": "phase-0", "anchor": "phase-0", "title": "Phase 0: Baseline and fixtures", "level": 3 }, { "id": "phase-1", "anchor": "phase-1", "title": "Phase 1: Scope and context index", "level": 3 }, { "id": "phase-2", "anchor": "phase-2", "title": "Phase 2: Layered scope-local projections", "level": 3 }, { "id": "phase-3", "anchor": "phase-3", "title": "Phase 3: Exact boundaries and stable updates", "level": 3 }, { "id": "phase-4", "anchor": "phase-4", "title": "Phase 4: Selected bindings and composition", "level": 3 }, { "id": "phase-5", "anchor": "phase-5", "title": "Phase 5: Connected source and execution evidence", "level": 3 }, { "id": "phase-6", "anchor": "phase-6", "title": "Phase 6: Shared commands and specialized instruments", "level": 3 }, { "id": "acceptance-tests", "anchor": "acceptance-tests", "title": "11. Workflow acceptance tests", "level": 2 }, { "id": "open-decisions", "anchor": "open-decisions", "title": "12. Decisions still requiring implementation evidence", "level": 2 }, { "id": "summary", "anchor": "summary", "title": "13. Intended outcome", "level": 2 } ], "links": [ { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-pane", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-ZCxzu", "relation": "references", "sourceAnchor": "system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-DBc14", "relation": "references", "sourceAnchor": "system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-pxsmW", "relation": "references", "sourceAnchor": "system-map" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-Pu9Sf", "relation": "references", "sourceAnchor": "system-map" }, { "id": "reaktor-visual-language", "anchor": "road-grammar", "relation": "references", "sourceAnchor": "system-map" }, { "id": "reaktor-unified-system-graph", "anchor": "canonical", "relation": "references", "sourceAnchor": "document" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "document" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-FsQx4", "relation": "references", "sourceAnchor": "dense-topology" }, { "id": "reaktor-graph-protocol", "anchor": "boundaries", "relation": "references", "sourceAnchor": "service-nodes" }, { "id": "reaktor-unified-system-graph", "anchor": "cloud-imports", "relation": "references", "sourceAnchor": "service-nodes" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-FsQx4", "relation": "references", "sourceAnchor": "real-app-topology" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-LODux", "relation": "references", "sourceAnchor": "real-app-topology" }, { "id": "reaktor-unified-system-graph", "anchor": "existing", "relation": "references", "sourceAnchor": "real-app-topology" }, { "id": "reaktor-visual-language", "anchor": "road-grammar", "relation": "references", "sourceAnchor": "decision-table" }, { "id": "reaktor-unified-system-graph", "anchor": "coverage-matrix", "relation": "references", "sourceAnchor": "decision-table" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-LODux", "relation": "references", "sourceAnchor": "selection-across-tools" }, { "id": "reaktor-unified-system-graph", "anchor": "operations", "relation": "references", "sourceAnchor": "selection-across-tools" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "implementation-plan" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "system-map", "relation": "references", "sourceAnchor": "acceptance-tests" } ] }, { "id": "reaktor-graph-language-theory", "summary": "Graph declarations plus arbitrary common Kotlin, ordinary KMP interoperability, Kotlin/JS lowering, graph/system access and qualified FFI.", "kind": "design", "owner": "Reaktor", "use": "Read the theory and distinguish structural checks from runtime, target and deployment qualification.", "region": "theory-foundations", "order": 6, "title": "The Reaktor graph language — Kotlin common DSL and arbitrary logic", "nav": "Kotlin graph language", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-language-theory", "revision": "d15bf5561eda651db8ef77b7fdeb47cf9779a44250e6ebf3f2d21469b8402bf1", "status": "design", "renderingRevision": "4705a25dbc7a2cc9c305b2c09b8d9e0a5ed5c6c0545dd2c47942e28504fdaadf", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://kotlinlang.org/docs/type-safe-builders.html", "https://kotlinlang.org/docs/js-overview.html", "https://kotlinlang.org/docs/js-to-kotlin-interop.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-language-theory", "polarity": "Neutral" }, { "id": "section-declarations-implementations-and-source-ownership", "anchor": "declarations-implementations-and-source-ownership", "label": "Declarations, implementations and source ownership", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-language-theory#declarations-implementations-and-source-ownership", "polarity": "Neutral" }, { "id": "section-arbitrary-common-logic-and-existing-runtime-ports", "anchor": "arbitrary-common-logic-and-existing-runtime-ports", "label": "Arbitrary common logic and existing runtime ports", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-language-theory#arbitrary-common-logic-and-existing-runtime-ports", "polarity": "Neutral" }, { "id": "section-graph-access-and-distributed-system-access", "anchor": "graph-access-and-distributed-system-access", "label": "Graph access and distributed system access", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-language-theory#graph-access-and-distributed-system-access", "polarity": "Neutral" }, { "id": "section-kotlinjs-deployment-and-reaktor-ffi", "anchor": "kotlinjs-deployment-and-reaktor-ffi", "label": "Kotlin/JS deployment and Reaktor FFI", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-language-theory#kotlinjs-deployment-and-reaktor-ffi", "polarity": "Neutral" }, { "id": "section-code-push-is-a-region-protocol", "anchor": "code-push-is-a-region-protocol", "label": "Code push is a region protocol", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-language-theory#code-push-is-a-region-protocol", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-language-theory:references-reaktor-ffi", "kind": "references", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "section-kotlinjs-deployment-and-reaktor-ffi", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-language-theory:references-reaktor-examples-mobile-mobile-feature-update", "kind": "references", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "section-code-push-is-a-region-protocol", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-mobile", "port": "section-mobile-feature-update", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-language-theory:references-reaktor-examples-distributed-distributed-release", "kind": "references", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "section-code-push-is-a-region-protocol", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-distributed", "port": "section-distributed-release", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-language-theory:references-reaktor-examples-capabilities-capability-code-push", "kind": "references", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "section-code-push-is-a-region-protocol", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-capabilities", "port": "section-capability-code-push", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-language-theory:requires-reaktor-graph-theory", "kind": "requires", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-language-theory:references-reaktor-graph-distribution-theory", "kind": "references", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-language-theory:derived-from-architecture-atlas-language", "kind": "derived-from", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-language-theory:references-reaktor-service", "kind": "references", "owner": "reaktor-graph-language-theory", "incidences": [ { "node": "reaktor-graph-language-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-language-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "The Reaktor graph language — Kotlin common DSL and arbitrary logic", "level": 0 }, { "id": "declarations-implementations-and-source-ownership", "anchor": "declarations-implementations-and-source-ownership", "title": "Declarations, implementations and source ownership", "level": 2 }, { "id": "arbitrary-common-logic-and-existing-runtime-ports", "anchor": "arbitrary-common-logic-and-existing-runtime-ports", "title": "Arbitrary common logic and existing runtime ports", "level": 2 }, { "id": "graph-access-and-distributed-system-access", "anchor": "graph-access-and-distributed-system-access", "title": "Graph access and distributed system access", "level": 2 }, { "id": "kotlinjs-deployment-and-reaktor-ffi", "anchor": "kotlinjs-deployment-and-reaktor-ffi", "title": "Kotlin/JS deployment and Reaktor FFI", "level": 2 }, { "id": "code-push-is-a-region-protocol", "anchor": "code-push-is-a-region-protocol", "title": "Code push is a region protocol", "level": 2 } ], "links": [ { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "kotlinjs-deployment-and-reaktor-ffi" }, { "id": "reaktor-examples-mobile", "anchor": "mobile-feature-update", "relation": "references", "sourceAnchor": "code-push-is-a-region-protocol" }, { "id": "reaktor-examples-distributed", "anchor": "distributed-release", "relation": "references", "sourceAnchor": "code-push-is-a-region-protocol" }, { "id": "reaktor-examples-capabilities", "anchor": "capability-code-push", "relation": "references", "sourceAnchor": "code-push-is-a-region-protocol" } ] }, { "id": "reaktor-graph-migration-plan", "owner": "Codex", "kind": "migration", "summary": "Tighten RouteBinding, navigation edges, themed UI scope, and graph runtime ergonomics.", "use": "Use when evolving reaktor-graph without breaking product apps.", "region": "background-research", "order": 0, "title": "Reaktor Graph Migration Plan", "nav": "Graph Migration", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-migration-plan", "revision": "6b24034d176e76b47cf73d8dcd96e9732f245590597aaa2c33c7af0fb4ca9d7d", "status": "historical", "renderingRevision": "13f29bbc331c40fffb84a5af46d80e3bc1a559fd5b25ad5d49bab87867728cb7", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan", "polarity": "Neutral" }, { "id": "section-situation", "anchor": "situation", "label": "1. Situation & Goals", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#situation", "polarity": "Neutral" }, { "id": "section-polyglot", "anchor": "polyglot", "label": "2. Polyglot Graph Design", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#polyglot", "polarity": "Neutral" }, { "id": "section-memstore", "anchor": "memstore", "label": "3. In-Memory Reactive Store", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#memstore", "polarity": "Neutral" }, { "id": "section-topology", "anchor": "topology", "label": "4. Navigation Topology", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#topology", "polarity": "Neutral" }, { "id": "section-decomposition", "anchor": "decomposition", "label": "5. State Decomposition", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#decomposition", "polarity": "Neutral" }, { "id": "section-services", "anchor": "services", "label": "6. Service Modeling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#services", "polarity": "Neutral" }, { "id": "section-selfviz", "anchor": "selfviz", "label": "7. Self-Referential Visualization", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#selfviz", "polarity": "Neutral" }, { "id": "section-dualrenderer", "anchor": "dualrenderer", "label": "8. Dual Renderer Architecture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#dualrenderer", "polarity": "Neutral" }, { "id": "section-migration", "anchor": "migration", "label": "9. Migration File Map", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#migration", "polarity": "Neutral" }, { "id": "section-sprints", "anchor": "sprints", "label": "10. Sprint Plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#sprints", "polarity": "Neutral" }, { "id": "section-risks", "anchor": "risks", "label": "11. Risk Matrix", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#risks", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-migration-plan#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-migration-plan:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-graph-migration-plan", "incidences": [ { "node": "reaktor-graph-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-migration-plan:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "reaktor-graph-migration-plan", "incidences": [ { "node": "reaktor-graph-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-migration-plan:references-reaktor-surface-renderers", "kind": "references", "owner": "reaktor-graph-migration-plan", "incidences": [ { "node": "reaktor-graph-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-migration-plan:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "reaktor-graph-migration-plan", "incidences": [ { "node": "reaktor-graph-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-migration-plan:references-engine-website-implementation-report", "kind": "references", "owner": "reaktor-graph-migration-plan", "incidences": [ { "node": "reaktor-graph-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "engine-website-implementation-report", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-migration-plan:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-graph-migration-plan", "incidences": [ { "node": "reaktor-graph-migration-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-migration-plan.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Graph Migration Plan", "level": 0 }, { "id": "situation", "anchor": "situation", "title": "1. Situation & Goals", "level": 2 }, { "id": "what-exists-today", "anchor": "what-exists-today", "title": "What exists today", "level": 3 }, { "id": "goals", "anchor": "goals", "title": "Goals", "level": 3 }, { "id": "g1--polyglot-graph-application", "anchor": "g1--polyglot-graph-application", "title": "G1 — Polyglot Graph Application", "level": 4 }, { "id": "g2--reactive-in-memory-store", "anchor": "g2--reactive-in-memory-store", "title": "G2 — Reactive In-Memory Store", "level": 4 }, { "id": "g3--common-core-dual-renderers", "anchor": "g3--common-core-dual-renderers", "title": "G3 — Common Core, Dual Renderers", "level": 4 }, { "id": "g4--self-referential-visualization", "anchor": "g4--self-referential-visualization", "title": "G4 — Self-Referential Visualization", "level": 4 }, { "id": "polyglot", "anchor": "polyglot", "title": "2. Polyglot Graph Design", "level": 2 }, { "id": "21-current-js-target-surface", "anchor": "21-current-js-target-surface", "title": "2.1 Current JS Target Surface", "level": 3 }, { "id": "22-typescript-interop-architecture", "anchor": "22-typescript-interop-architecture", "title": "2.2 TypeScript Interop Architecture", "level": 3 }, { "id": "23-react-hook-api-design", "anchor": "23-react-hook-api-design", "title": "2.3 React Hook API Design", "level": 3 }, { "id": "24-kotlin-exports-needed", "anchor": "24-kotlin-exports-needed", "title": "2.4 Kotlin Exports Needed", "level": 3 }, { "id": "memstore", "anchor": "memstore", "title": "3. In-Memory Reactive Store", "level": 2 }, { "id": "31-design-principles", "anchor": "31-design-principles", "title": "3.1 Design Principles", "level": 3 }, { "id": "port-aligned", "anchor": "port-aligned", "title": "Port-Aligned", "level": 4 }, { "id": "scoped-lifetime", "anchor": "scoped-lifetime", "title": "Scoped Lifetime", "level": 4 }, { "id": "observable", "anchor": "observable", "title": "Observable", "level": 4 }, { "id": "32-architecture", "anchor": "32-architecture", "title": "3.2 Architecture", "level": 3 }, { "id": "33-store-node-implementation", "anchor": "33-store-node-implementation", "title": "3.3 Store Node Implementation", "level": 3 }, { "id": "34-store-slot-types-kotlin--shared-by-both-renderers", "anchor": "34-store-slot-types-kotlin--shared-by-both-renderers", "title": "3.4 Store Slot Types (Kotlin — shared by both renderers)", "level": 3 }, { "id": "35-typescript-access-via-react-hooks", "anchor": "35-typescript-access-via-react-hooks", "title": "3.5 TypeScript Access via React Hooks", "level": 3 }, { "id": "36-how-this-relates-to-the-object-database", "anchor": "36-how-this-relates-to-the-object-database", "title": "3.6 How This Relates to the Object Database", "level": 3 }, { "id": "topology", "anchor": "topology", "title": "4. Navigation Topology", "level": 2 }, { "id": "41-current-hash-based-mode-switching", "anchor": "41-current-hash-based-mode-switching", "title": "4.1 Current: Hash-Based Mode Switching", "level": 3 }, { "id": "42-target-graph-navigation-with-url-sync", "anchor": "42-target-graph-navigation-with-url-sync", "title": "4.2 Target: Graph Navigation with URL Sync", "level": 3 }, { "id": "43-url-mapping", "anchor": "43-url-mapping", "title": "4.3 URL Mapping", "level": 3 }, { "id": "decomposition", "anchor": "decomposition", "title": "5. State Decomposition", "level": 2 }, { "id": "51-decomposition-map", "anchor": "51-decomposition-map", "title": "5.1 Decomposition Map", "level": 3 }, { "id": "52-beforeafter-comparison", "anchor": "52-beforeafter-comparison", "title": "5.2 Before/After Comparison", "level": 3 }, { "id": "before-god-object", "anchor": "before-god-object", "title": "Before: God Object", "level": 4 }, { "id": "after-targeted-subscriptions", "anchor": "after-targeted-subscriptions", "title": "After: Targeted Subscriptions", "level": 4 }, { "id": "services", "anchor": "services", "title": "6. Service Modeling", "level": 2 }, { "id": "61-current-mock-services", "anchor": "61-current-mock-services", "title": "6.1 Current Mock Services", "level": 3 }, { "id": "62-target-servicenode-with-typed-handlers", "anchor": "62-target-servicenode-with-typed-handlers", "title": "6.2 Target: ServiceNode with Typed Handlers", "level": 3 }, { "id": "selfviz", "anchor": "selfviz", "title": "7. Self-Referential Visualization", "level": 2 }, { "id": "71-data-pipeline", "anchor": "71-data-pipeline", "title": "7.1 Data Pipeline", "level": 3 }, { "id": "72-what-gets-visualized", "anchor": "72-what-gets-visualized", "title": "7.2 What Gets Visualized", "level": 3 }, { "id": "73-replacing-hardcoded-data", "anchor": "73-replacing-hardcoded-data", "title": "7.3 Replacing Hardcoded Data", "level": 3 }, { "id": "before-hardcoded-mock", "anchor": "before-hardcoded-mock", "title": "Before: Hardcoded Mock", "level": 4 }, { "id": "after-live-graph", "anchor": "after-live-graph", "title": "After: Live Graph", "level": 4 }, { "id": "dualrenderer", "anchor": "dualrenderer", "title": "8. Dual Renderer Architecture", "level": 2 }, { "id": "81-module-layout", "anchor": "81-module-layout", "title": "8.1 Module Layout", "level": 3 }, { "id": "82-shared-graph-definition", "anchor": "82-shared-graph-definition", "title": "8.2 Shared Graph Definition", "level": 3 }, { "id": "83-renderer-specific-wiring", "anchor": "83-renderer-specific-wiring", "title": "8.3 Renderer-Specific Wiring", "level": 3 }, { "id": "web-renderer-react", "anchor": "web-renderer-react", "title": "Web Renderer (React)", "level": 4 }, { "id": "desktop-renderer-compose", "anchor": "desktop-renderer-compose", "title": "Desktop Renderer (Compose)", "level": 4 }, { "id": "migration", "anchor": "migration", "title": "9. Migration File Map", "level": 2 }, { "id": "91-new-kotlin-files-commonmain--shared", "anchor": "91-new-kotlin-files-commonmain--shared", "title": "9.1 New Kotlin Files (commonMain — shared)", "level": 3 }, { "id": "92-new-kotlin-files-jsmain--web-bridge", "anchor": "92-new-kotlin-files-jsmain--web-bridge", "title": "9.2 New Kotlin Files (jsMain — web bridge)", "level": 3 }, { "id": "93-new-typescriptreact-files", "anchor": "93-new-typescriptreact-files", "title": "9.3 New TypeScript/React Files", "level": 3 }, { "id": "94-modified-react-files", "anchor": "94-modified-react-files", "title": "9.4 Modified React Files", "level": 3 }, { "id": "sprints", "anchor": "sprints", "title": "10. Sprint Plan", "level": 2 }, { "id": "11-memorystore-implementation", "anchor": "11-memorystore-implementation", "title": "1.1 MemoryStore implementation", "level": 4 }, { "id": "12-shared-state-types", "anchor": "12-shared-state-types", "title": "1.2 Shared state types", "level": 4 }, { "id": "13-js-export-additions", "anchor": "13-js-export-additions", "title": "1.3 JS export additions", "level": 4 }, { "id": "14-react-hooks", "anchor": "14-react-hooks", "title": "1.4 React hooks", "level": 4 }, { "id": "deliverable", "anchor": "deliverable", "title": "Deliverable:", "level": 4 }, { "id": "21-graph-topology", "anchor": "21-graph-topology", "title": "2.1 Graph topology", "level": 4 }, { "id": "22-mode-switching-via-navigation", "anchor": "22-mode-switching-via-navigation", "title": "2.2 Mode switching via navigation", "level": 4 }, { "id": "23-agent-sub-navigation", "anchor": "23-agent-sub-navigation", "title": "2.3 Agent sub-navigation", "level": 4 }, { "id": "deliverable-1", "anchor": "deliverable-1", "title": "Deliverable:", "level": 4 }, { "id": "31-scenariocontext--store-adapter", "anchor": "31-scenariocontext--store-adapter", "title": "3.1 ScenarioContext → Store adapter", "level": 4 }, { "id": "32-per-screen-state-migration-one-screen-at-a-time", "anchor": "32-per-screen-state-migration-one-screen-at-a-time", "title": "3.2 Per-screen state migration (one screen at a time)", "level": 4 }, { "id": "33-scenariocontext-removal", "anchor": "33-scenariocontext-removal", "title": "3.3 ScenarioContext removal", "level": 4 }, { "id": "deliverable-2", "anchor": "deliverable-2", "title": "Deliverable:", "level": 4 }, { "id": "41-service-migration", "anchor": "41-service-migration", "title": "4.1 Service migration", "level": 4 }, { "id": "42-self-referential-graph-visualization", "anchor": "42-self-referential-graph-visualization", "title": "4.2 Self-referential graph visualization", "level": 4 }, { "id": "43-inspector-from-live-graph", "anchor": "43-inspector-from-live-graph", "title": "4.3 Inspector from live graph", "level": 4 }, { "id": "deliverable-3", "anchor": "deliverable-3", "title": "Deliverable:", "level": 4 }, { "id": "51-engine-module-alignment", "anchor": "51-engine-module-alignment", "title": "5.1 Engine module alignment", "level": 4 }, { "id": "52-kotlinjs-bundle-optimization", "anchor": "52-kotlinjs-bundle-optimization", "title": "5.2 Kotlin/JS bundle optimization", "level": 4 }, { "id": "53-cloudflare-workers-deployment", "anchor": "53-cloudflare-workers-deployment", "title": "5.3 Cloudflare Workers deployment", "level": 4 }, { "id": "54-cleanup", "anchor": "54-cleanup", "title": "5.4 Cleanup", "level": 4 }, { "id": "deliverable-4", "anchor": "deliverable-4", "title": "Deliverable:", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "11. Risk Matrix", "level": 2 }, { "id": "summary", "anchor": "summary", "title": "Summary", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-graph-migration-plan", "anchor": "situation", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "polyglot", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "memstore", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "topology", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "decomposition", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "services", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "selfviz", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "dualrenderer", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "migration", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "sprints", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-migration-plan", "anchor": "risks", "relation": "references", "sourceAnchor": "" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "engine-website-implementation-report", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-graph-pane", "owner": "Claude", "kind": "architecture", "summary": "The workbench pane that shows a running app's graph in the visual language of Unreal Blueprints: every feature as a frame packed to the window's shape, nodes with coloured headers, pins coloured by what flows through them, dashed links for the routes between screens, calls pulsing along wires, watched pin values from a phone, an execution trace, a summary card and an outline of the whole system. Reads this desktop or a phone over the DevTools agent; ELK layout; findings for unwired, duplicate, cyclic, layered and unreachable wiring; a ports table and MCP reads. Compared with Unreal Blueprints, Nx, IntelliJ, dependency-cruiser, SonarQube, Kiali, NiFi and Stately.", "use": "Read before changing the Graph pane, Graph.shape() in reaktor-graph, the graph.shape and port.watch DevTools capabilities or reaktor-flow's GraphCanvas. Section 1 is the pipeline from graph to map, section 3 the findings, section 6 the known limits and section 8 the roadmap ordered by value.", "region": "workbench-surfaces", "order": 5, "title": "Reaktor Graph", "nav": "Graph", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-pane", "revision": "7f8b624dbc0bd3ddfdad95249175d128fa6d17d5e221a8a40b068b6548821e24", "status": "unverified", "renderingRevision": "918e30d2bb605556a79b74a3da1a5b8025d913ce51c50eae04d284589c6488de", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-pane", "polarity": "Neutral" }, { "id": "section-at-a-glance", "anchor": "at-a-glance", "label": "At a glance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-pane#at-a-glance", "polarity": "Neutral" }, { "id": "section-how-it-works", "anchor": "how-it-works", "label": "1. How it works", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-pane#how-it-works", "polarity": "Neutral" }, { "id": "section-pane", "anchor": "pane", "label": "2. The pane", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-pane#pane", "polarity": "Neutral" }, { "id": "section-findings", "anchor": "findings", "label": "3. Findings", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-pane#findings", "polarity": "Neutral" }, { "id": "section-agents", "anchor": "agents", "label": "4. For coding agents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-pane#agents", "polarity": "Neutral" }, { "id": "section-verified", "anchor": "verified", "label": "5. Checked on the real app", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-pane#verified", "polarity": "Neutral" }, { "id": "section-whole-system", "anchor": "whole-system", "label": "The whole system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-pane#whole-system", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-pane:references-operations-graph-evidence", "kind": "references", "owner": "reaktor-graph-pane", "incidences": [ { "node": "reaktor-graph-pane", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-pane:references-operations", "kind": "references", "owner": "reaktor-graph-pane", "incidences": [ { "node": "reaktor-graph-pane", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-pane:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-graph-pane", "incidences": [ { "node": "reaktor-graph-pane", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-pane:references-reaktor-cloud", "kind": "references", "owner": "reaktor-graph-pane", "incidences": [ { "node": "reaktor-graph-pane", "port": "section-at-a-glance", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-pane:references-reaktor-workbench-links", "kind": "references", "owner": "reaktor-graph-pane", "incidences": [ { "node": "reaktor-graph-pane", "port": "section-pane", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-links", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-pane.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Graph", "level": 0 }, { "id": "reaktor-graph", "anchor": "reaktor-graph", "title": "Reaktor Graph", "level": 1 }, { "id": "at-a-glance", "anchor": "at-a-glance", "title": "At a glance", "level": 2 }, { "id": "how-it-works", "anchor": "how-it-works", "title": "1. How it works", "level": 2 }, { "id": "pane", "anchor": "pane", "title": "2. The pane", "level": 2 }, { "id": "whole-system", "anchor": "whole-system", "title": "The whole system", "level": 3 }, { "id": "findings", "anchor": "findings", "title": "3. Findings", "level": 2 }, { "id": "agents", "anchor": "agents", "title": "4. For coding agents", "level": 2 }, { "id": "verified", "anchor": "verified", "title": "5. Checked on the real app", "level": 2 }, { "id": "limits", "anchor": "limits", "title": "6. Known limits", "level": 2 }, { "id": "compare", "anchor": "compare", "title": "7. How it compares", "level": 2 }, { "id": "roadmap", "anchor": "roadmap", "title": "8. Roadmap", "level": 2 } ], "links": [ { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "at-a-glance" }, { "id": "reaktor-workbench-links", "anchor": "", "relation": "references", "sourceAnchor": "pane" } ] }, { "id": "reaktor-graph-precedents", "summary": "Primary sources for Kotlin DSLs, open-system composition, MLIR and dataflow scheduling with explicit scope and inference.", "kind": "design", "owner": "Reaktor", "use": "Read the theory and distinguish structural checks from runtime, target and deployment qualification.", "region": "theory-foundations", "order": 8, "title": "Graph model precedents and their limits", "nav": "Precedents", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-precedents", "revision": "3003d20edefd4315dd14d6ee1a761dfd25c107b4e9a14ce0913a22a42d31a667", "status": "design", "renderingRevision": "2928f4cfd207246473bb18770e2b8fe10aa248e4fc6c4c5769fcdb7fa33fad1a", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://arxiv.org/abs/1502.00872", "https://mlir.llvm.org/docs/LangRef/", "https://ptolemy.berkeley.edu/publications/papers/87/staticscheduling/", "https://kotlinlang.org/docs/type-safe-builders.html", "https://kotlinlang.org/docs/js-overview.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-precedents", "polarity": "Neutral" }, { "id": "section-boundaries-and-algebraic-composition", "anchor": "boundaries-and-algebraic-composition", "label": "Boundaries and algebraic composition", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-precedents#boundaries-and-algebraic-composition", "polarity": "Neutral" }, { "id": "section-extensible-compiler-representations", "anchor": "extensible-compiler-representations", "label": "Extensible compiler representations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-precedents#extensible-compiler-representations", "polarity": "Neutral" }, { "id": "section-scheduling-is-profile-specific", "anchor": "scheduling-is-profile-specific", "label": "Scheduling is profile-specific", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-precedents#scheduling-is-profile-specific", "polarity": "Neutral" }, { "id": "section-kotlin-as-the-host-language", "anchor": "kotlin-as-the-host-language", "label": "Kotlin as the host language", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-precedents#kotlin-as-the-host-language", "polarity": "Neutral" }, { "id": "section-how-to-judge-a-new-analogy", "anchor": "how-to-judge-a-new-analogy", "label": "How to judge a new analogy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-precedents#how-to-judge-a-new-analogy", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-precedents:explains-reaktor-graph-theory", "kind": "explains", "owner": "reaktor-graph-precedents", "incidences": [ { "node": "reaktor-graph-precedents", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-precedents:derived-from-architecture-atlas-workbench", "kind": "derived-from", "owner": "reaktor-graph-precedents", "incidences": [ { "node": "reaktor-graph-precedents", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-precedents:references-engine-preprint-evaluation", "kind": "references", "owner": "reaktor-graph-precedents", "incidences": [ { "node": "reaktor-graph-precedents", "port": "page", "role": "source", "ordinal": 0 }, { "node": "engine-preprint-evaluation", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-precedents.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Graph model precedents and their limits", "level": 0 }, { "id": "boundaries-and-algebraic-composition", "anchor": "boundaries-and-algebraic-composition", "title": "Boundaries and algebraic composition", "level": 2 }, { "id": "extensible-compiler-representations", "anchor": "extensible-compiler-representations", "title": "Extensible compiler representations", "level": 2 }, { "id": "scheduling-is-profile-specific", "anchor": "scheduling-is-profile-specific", "title": "Scheduling is profile-specific", "level": 2 }, { "id": "kotlin-as-the-host-language", "anchor": "kotlin-as-the-host-language", "title": "Kotlin as the host language", "level": 2 }, { "id": "how-to-judge-a-new-analogy", "anchor": "how-to-judge-a-new-analogy", "title": "How to judge a new analogy", "level": 2 } ], "links": [] }, { "id": "reaktor-graph-protocol", "owner": "Claude", "kind": "architecture", "summary": "The rgp/1 wire protocol: one connection over many targets with a session each, six independently-enabled domains (Mesh, Graph, Wire, Revision, Edit, Value) with typed commands, events and payloads, handle-based lazy resolution so a twenty-thousand-node graph is tractable, Kubernetes-style list-then-watch cursors where a gap is an error rather than silence, producer-side selectors, credited streams that drop rather than block the runtime being inspected, a patch-based write path that must declare document/source/runtime, and a derived revision digest that makes one system running several deployed revisions present honestly as several graphs. Includes a comparison against Chrome DevTools Protocol, LSP, DAP, the Kubernetes watch API, Erlang tracing and OpenTelemetry: what is borrowed, and what is refused.", "use": "Read when implementing or consuming graph inspection and modification across runtimes, or when deciding how deployment skew and backwards compatibility are represented. This is a specification, not a shipped protocol.", "region": "graph-model", "order": 7, "title": "Reaktor Graph Protocol", "nav": "Graph Protocol", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-protocol", "revision": "cd7dca7fae48e7c5dcc38d210813f56986c403eca0ef410d54be03eb3a023dc9", "status": "unverified", "renderingRevision": "957020ff7cfc89cf1ba6372b2838d78e056b0ff20f19f622b9bddc06b8e825f2", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-protocol", "polarity": "Neutral" }, { "id": "section-shape", "anchor": "shape", "label": "1. Shape of the protocol", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#shape", "polarity": "Neutral" }, { "id": "section-prior-art", "anchor": "prior-art", "label": "2. Prior art", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#prior-art", "polarity": "Neutral" }, { "id": "section-identity", "anchor": "identity", "label": "3. Identity", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#identity", "polarity": "Neutral" }, { "id": "section-targets", "anchor": "targets", "label": "4. Targets and sessions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#targets", "polarity": "Neutral" }, { "id": "section-framing", "anchor": "framing", "label": "5. Framing and payloads", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#framing", "polarity": "Neutral" }, { "id": "section-mesh-domain", "anchor": "mesh-domain", "label": "6. Domain: Mesh", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#mesh-domain", "polarity": "Neutral" }, { "id": "section-revision-domain", "anchor": "revision-domain", "label": "9. Domain: Revision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#revision-domain", "polarity": "Neutral" }, { "id": "section-graph-domain", "anchor": "graph-domain", "label": "7. Domain: Graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#graph-domain", "polarity": "Neutral" }, { "id": "section-wire-domain", "anchor": "wire-domain", "label": "8. Domain: Wire", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#wire-domain", "polarity": "Neutral" }, { "id": "section-edit-domain", "anchor": "edit-domain", "label": "10. Domain: Edit", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#edit-domain", "polarity": "Neutral" }, { "id": "section-value-domain", "anchor": "value-domain", "label": "11. Domain: Value", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#value-domain", "polarity": "Neutral" }, { "id": "section-open-decisions", "anchor": "open-decisions", "label": "18. Open decisions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#open-decisions", "polarity": "Neutral" }, { "id": "section-cost", "anchor": "cost", "label": "13. Cost, and the rule that protects the target", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#cost", "polarity": "Neutral" }, { "id": "section-revision-digest", "anchor": "revision-digest", "label": "The revision digest is derived, not declared", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#revision-digest", "polarity": "Neutral" }, { "id": "section-events", "anchor": "events", "label": "Event vocabulary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#events", "polarity": "Neutral" }, { "id": "section-boundaries", "anchor": "boundaries", "label": "Cross-runtime boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#boundaries", "polarity": "Neutral" }, { "id": "section-visualise", "anchor": "visualise", "label": "14. What the renderer receives", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#visualise", "polarity": "Neutral" }, { "id": "section-ghosts", "anchor": "ghosts", "label": "Ghosts, and the diff", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#ghosts", "polarity": "Neutral" }, { "id": "section-write-targets", "anchor": "write-targets", "label": "Three write targets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#write-targets", "polarity": "Neutral" }, { "id": "section-related", "anchor": "related", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-protocol#related", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-protocol:references-reaktor-ffi", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-shape", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-ffi-frames", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-framing", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-frames", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-component-lifecycle-graph-events", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-events", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "section-graph-events", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-graph-hierarchical-ui-service-nodes", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-boundaries", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-service-nodes", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-service", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-boundaries", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-atlas-review-fable-5", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-ghosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-review-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-graph-hierarchical-ui-scope", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-ghosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-scope", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-edit-domain", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-write-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-visualise", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-visualise", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-ffi-graph-representation", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-visualise", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-graph-representation", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-agentic-tooling-change", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-open-decisions", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "section-change", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-component-lifecycle", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-protocol:references-reaktor-formal-methods", "kind": "references", "owner": "reaktor-graph-protocol", "incidences": [ { "node": "reaktor-graph-protocol", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-protocol.json", "sections": [ { "id": "reaktor-graph-protocol", "anchor": "reaktor-graph-protocol", "title": "Reaktor Graph Protocol", "level": 1 }, { "id": "shape", "anchor": "shape", "title": "1. Shape of the protocol", "level": 2 }, { "id": "prior-art", "anchor": "prior-art", "title": "2. Prior art", "level": 2 }, { "id": "identity", "anchor": "identity", "title": "3. Identity", "level": 2 }, { "id": "revision-digest", "anchor": "revision-digest", "title": "The revision digest is derived, not declared", "level": 3 }, { "id": "targets", "anchor": "targets", "title": "4. Targets and sessions", "level": 2 }, { "id": "framing", "anchor": "framing", "title": "5. Framing and payloads", "level": 2 }, { "id": "message-shapes", "anchor": "message-shapes", "title": "Message shapes", "level": 3 }, { "id": "encoding", "anchor": "encoding", "title": "Encoding", "level": 3 }, { "id": "handles", "anchor": "handles", "title": "Handles", "level": 3 }, { "id": "mesh-domain", "anchor": "mesh-domain", "title": "6. Domain: Mesh", "level": 2 }, { "id": "graph-domain", "anchor": "graph-domain", "title": "7. Domain: Graph", "level": 2 }, { "id": "cursors", "anchor": "cursors", "title": "List-then-watch", "level": 3 }, { "id": "selectors", "anchor": "selectors", "title": "Selectors are evaluated in the target", "level": 3 }, { "id": "events", "anchor": "events", "title": "Event vocabulary", "level": 3 }, { "id": "boundaries", "anchor": "boundaries", "title": "Cross-runtime boundaries", "level": 3 }, { "id": "wire-domain", "anchor": "wire-domain", "title": "8. Domain: Wire", "level": 2 }, { "id": "revision-domain", "anchor": "revision-domain", "title": "9. Domain: Revision", "level": 2 }, { "id": "compat", "anchor": "compat", "title": "Compatibility is computed", "level": 3 }, { "id": "channels", "anchor": "channels", "title": "Channels", "level": 3 }, { "id": "retirement", "anchor": "retirement", "title": "Retirement as a query", "level": 3 }, { "id": "ghosts", "anchor": "ghosts", "title": "Ghosts, and the diff", "level": 3 }, { "id": "edit-domain", "anchor": "edit-domain", "title": "10. Domain: Edit", "level": 2 }, { "id": "write-targets", "anchor": "write-targets", "title": "Three write targets", "level": 3 }, { "id": "prepare", "anchor": "prepare", "title": "Prepare is not execute", "level": 3 }, { "id": "value-domain", "anchor": "value-domain", "title": "11. Domain: Value", "level": 2 }, { "id": "errors", "anchor": "errors", "title": "12. Errors", "level": 2 }, { "id": "cost", "anchor": "cost", "title": "13. Cost, and the rule that protects the target", "level": 2 }, { "id": "visualise", "anchor": "visualise", "title": "14. What the renderer receives", "level": 2 }, { "id": "security", "anchor": "security", "title": "15. Security", "level": 2 }, { "id": "conformance", "anchor": "conformance", "title": "16. Protocol versioning and conformance", "level": 2 }, { "id": "plan", "anchor": "plan", "title": "17. Implementation order", "level": 2 }, { "id": "open-decisions", "anchor": "open-decisions", "title": "18. Open decisions", "level": 2 }, { "id": "related", "anchor": "related", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-graph-protocol", "anchor": "prior-art", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "revision-domain", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "mesh-domain", "relation": "references", "sourceAnchor": "shape" }, { "id": "reaktor-graph-protocol", "anchor": "graph-domain", "relation": "references", "sourceAnchor": "shape" }, { "id": "reaktor-graph-protocol", "anchor": "wire-domain", "relation": "references", "sourceAnchor": "shape" }, { "id": "reaktor-graph-protocol", "anchor": "revision-domain", "relation": "references", "sourceAnchor": "shape" }, { "id": "reaktor-graph-protocol", "anchor": "edit-domain", "relation": "references", "sourceAnchor": "shape" }, { "id": "reaktor-graph-protocol", "anchor": "value-domain", "relation": "references", "sourceAnchor": "shape" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "shape" }, { "id": "reaktor-graph-protocol", "anchor": "revision-domain", "relation": "references", "sourceAnchor": "prior-art" }, { "id": "reaktor-ffi", "anchor": "frames", "relation": "references", "sourceAnchor": "framing" }, { "id": "reaktor-component-lifecycle", "anchor": "graph-events", "relation": "references", "sourceAnchor": "events" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "service-nodes", "relation": "references", "sourceAnchor": "boundaries" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "boundaries" }, { "id": "reaktor-graph-protocol", "anchor": "wire-domain", "relation": "references", "sourceAnchor": "boundaries" }, { "id": "reaktor-graph-protocol", "anchor": "value-domain", "relation": "references", "sourceAnchor": "wire-domain" }, { "id": "reaktor-graph-protocol", "anchor": "prior-art", "relation": "references", "sourceAnchor": "revision-domain" }, { "id": "reaktor-ffi", "anchor": "frames", "relation": "references", "sourceAnchor": "compat" }, { "id": "reaktor-atlas-review-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "ghosts" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "scope", "relation": "references", "sourceAnchor": "ghosts" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "edit-domain" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "write-targets" }, { "id": "reaktor-graph-protocol", "anchor": "open-decisions", "relation": "references", "sourceAnchor": "value-domain" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "visualise" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "visualise" }, { "id": "reaktor-ffi", "anchor": "graph-representation", "relation": "references", "sourceAnchor": "visualise" }, { "id": "reaktor-graph-protocol", "anchor": "value-domain", "relation": "references", "sourceAnchor": "security" }, { "id": "reaktor-agentic-tooling", "anchor": "change", "relation": "references", "sourceAnchor": "open-decisions" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "related" } ] }, { "id": "reaktor-graph-refinement-plan", "owner": "Claude", "kind": "plan", "summary": "Stronger types, port shapes, hook controllers, behavior actors, route tables, and module supervision.", "use": "Use for the next expressiveness pass over reaktor-graph and reaktor-graph-port.", "region": "graph-migration", "order": 0, "title": "Reaktor Graph Refinement Plan", "nav": "Graph Refinement", "group": "graph", "subsection": "graph-migration", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-refinement-plan", "revision": "43f22dd545dc573f273624d935eff3a05aaa1fc8e29155672e5d457832875a24", "status": "unverified", "renderingRevision": "776516d34ba0b2dd6e522c65664bda4e774a6ef9d17ba7a8035eaad1ae111b61", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan", "polarity": "Neutral" }, { "id": "section-table-of-contents", "anchor": "table-of-contents", "label": "Table of Contents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#table-of-contents", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "✜ 1. Principles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#principles", "polarity": "Neutral" }, { "id": "section-snapshot", "anchor": "snapshot", "label": "✓ 2. Snapshot — What Already Works", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#snapshot", "polarity": "Neutral" }, { "id": "section-diagnosis", "anchor": "diagnosis", "label": "✗ 3. Diagnosis — Where Expressiveness Leaks", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#diagnosis", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "⧉ 4. Mental Model — Five Layers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#model", "polarity": "Neutral" }, { "id": "section-layer0", "anchor": "layer0", "label": "⦿ 5. Layer 0 — Atomic Primitives", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#layer0", "polarity": "Neutral" }, { "id": "section-layer1", "anchor": "layer1", "label": "◇ 6. Layer 1 — Port Shapes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#layer1", "polarity": "Neutral" }, { "id": "section-layer2", "anchor": "layer2", "label": "⚛ 7. Layer 2 — Reactive Nodes (Hooks & Behaviors)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#layer2", "polarity": "Neutral" }, { "id": "section-layer3", "anchor": "layer3", "label": "↪ 8. Layer 3 — Routing & Container Idioms", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#layer3", "polarity": "Neutral" }, { "id": "section-layer4", "anchor": "layer4", "label": "⚘ 9. Layer 4 — Module Composition & Supervision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#layer4", "polarity": "Neutral" }, { "id": "section-walkthrough", "anchor": "walkthrough", "label": "✍ 10. End-to-end Walkthrough — ChatGraph Re-imagined", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#walkthrough", "polarity": "Neutral" }, { "id": "section-migration", "anchor": "migration", "label": "↻ 11. Migration — Additive Path", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#migration", "polarity": "Neutral" }, { "id": "section-nongoals", "anchor": "nongoals", "label": "⊘ 12. Non-Goals", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#nongoals", "polarity": "Neutral" }, { "id": "section-open", "anchor": "open", "label": "? 13. Open Questions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#open", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-refinement-plan#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-refinement-plan:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-graph-refinement-plan", "incidences": [ { "node": "reaktor-graph-refinement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-refinement-plan:references-reaktor-graph-migration-plan", "kind": "references", "owner": "reaktor-graph-refinement-plan", "incidences": [ { "node": "reaktor-graph-refinement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-refinement-plan:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-graph-refinement-plan", "incidences": [ { "node": "reaktor-graph-refinement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-refinement-plan:references-reaktor-service", "kind": "references", "owner": "reaktor-graph-refinement-plan", "incidences": [ { "node": "reaktor-graph-refinement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-refinement-plan:references-reaktor-work", "kind": "references", "owner": "reaktor-graph-refinement-plan", "incidences": [ { "node": "reaktor-graph-refinement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-refinement-plan:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-graph-refinement-plan", "incidences": [ { "node": "reaktor-graph-refinement-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-refinement-plan.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Graph Refinement Plan", "level": 0 }, { "id": "table-of-contents", "anchor": "table-of-contents", "title": "Table of Contents", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "✜ 1. Principles", "level": 2 }, { "id": "snapshot", "anchor": "snapshot", "title": "✓ 2. Snapshot — What Already Works", "level": 2 }, { "id": "diagnosis", "anchor": "diagnosis", "title": "✗ 3. Diagnosis — Where Expressiveness Leaks", "level": 2 }, { "id": "model", "anchor": "model", "title": "⧉ 4. Mental Model — Five Layers", "level": 2 }, { "id": "layer0", "anchor": "layer0", "title": "⦿ 5. Layer 0 — Atomic Primitives", "level": 2 }, { "id": "before", "anchor": "before", "title": "Before", "level": 5 }, { "id": "after", "anchor": "after", "title": "After", "level": 5 }, { "id": "layer1", "anchor": "layer1", "title": "◇ 6. Layer 1 — Port Shapes", "level": 2 }, { "id": "port-shape-declaration-dsl", "anchor": "port-shape-declaration-dsl", "title": "Port-shape declaration DSL", "level": 3 }, { "id": "layer2", "anchor": "layer2", "title": "⚛ 7. Layer 2 — Reactive Nodes (Hooks & Behaviors)", "level": 2 }, { "id": "hooks", "anchor": "hooks", "title": "7.1 Hook nodes — React-flavored controllers", "level": 3 }, { "id": "behavior-actors", "anchor": "behavior-actors", "title": "7.2 Behavior actors — Akka Typed-flavored mailboxes", "level": 3 }, { "id": "exposed", "anchor": "exposed", "title": "7.3 exposed { } — one place declares the node's public surface", "level": 3 }, { "id": "before--bestbudskt404-411", "anchor": "before--bestbudskt404-411", "title": "Before — BestBuds.kt:404-411", "level": 5 }, { "id": "after-1", "anchor": "after-1", "title": "After", "level": 5 }, { "id": "layer3", "anchor": "layer3", "title": "↪ 8. Layer 3 — Routing & Container Idioms", "level": 2 }, { "id": "routes", "anchor": "routes", "title": "8.1 Declarative route tables (D1, D9)", "level": 3 }, { "id": "typed-results", "anchor": "typed-results", "title": "8.2 Typed result returns (refines D8 for navigation)", "level": 3 }, { "id": "containers", "anchor": "containers", "title": "8.3 Container with reactive selection (D6)", "level": 3 }, { "id": "modules", "anchor": "modules", "title": "8.4 Modules — reusable subgraph contracts (D10)", "level": 3 }, { "id": "layer4", "anchor": "layer4", "title": "⚘ 9. Layer 4 — Module Composition & Supervision", "level": 2 }, { "id": "91-supervision-trees-rooted-in-the-graph-hierarchy", "anchor": "91-supervision-trees-rooted-in-the-graph-hierarchy", "title": "9.1 Supervision trees rooted in the graph hierarchy", "level": 3 }, { "id": "92-cross-graph-mesh--explicit-named-edges", "anchor": "92-cross-graph-mesh--explicit-named-edges", "title": "9.2 Cross-graph mesh — explicit named edges", "level": 3 }, { "id": "93-visitor-with-mutation--framework-level-transforms", "anchor": "93-visitor-with-mutation--framework-level-transforms", "title": "9.3 Visitor with mutation — framework-level transforms", "level": 3 }, { "id": "walkthrough", "anchor": "walkthrough", "title": "✍ 10. End-to-end Walkthrough — ChatGraph Re-imagined", "level": 2 }, { "id": "migration", "anchor": "migration", "title": "↻ 11. Migration — Additive Path", "level": 2 }, { "id": "nongoals", "anchor": "nongoals", "title": "⊘ 12. Non-Goals", "level": 2 }, { "id": "open", "anchor": "open", "title": "? 13. Open Questions", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-graph-refinement-plan", "anchor": "principles", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "snapshot", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "diagnosis", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "model", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "layer0", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "layer1", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "layer2", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "layer3", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "layer4", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "walkthrough", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "migration", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "nongoals", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "open", "relation": "references", "sourceAnchor": "table-of-contents" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-graph-sources", "owner": "Claude", "kind": "design", "summary": "Show existing Python, Go, Spring, JS, and other services in the Reaktor graph without pretending Reaktor fully owns them. Each node says how it was learned, how trusted it is, and how fresh it is; those facts decide whether the desktop can only inspect it, open source, wrap it, or safely mutate it.", "use": "Use when planning how existing non-Reaktor code enters the system graph: source scanning, runtime observation, ServiceNode wrapping, source navigation, and action gating by trust level.", "region": "graph-model", "order": 8, "title": "Reaktor Graph Sources - bring existing systems into the graph", "nav": "Graph Sources", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-sources", "revision": "8d65c1e9eeae6832cad7a0472c6112312af10beb5fea2e8bc8fcfbc147412eda", "status": "unverified", "renderingRevision": "03dd23af655be678d1736f8a3798c3362f5457fee188f8778b7597a1c6d683ff", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-sources", "polarity": "Neutral" }, { "id": "section-the-short-version", "anchor": "the-short-version", "label": "The Short Version", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#the-short-version", "polarity": "Neutral" }, { "id": "section-current-state", "anchor": "current-state", "label": "Current State", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#current-state", "polarity": "Neutral" }, { "id": "section-four-ways-a-system-enters-the-graph", "anchor": "four-ways-a-system-enters-the-graph", "label": "Four Ways A System Enters The Graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#four-ways-a-system-enters-the-graph", "polarity": "Neutral" }, { "id": "section-how-existing-code-moves-toward-reaktor", "anchor": "how-existing-code-moves-toward-reaktor", "label": "How Existing Code Moves Toward Reaktor", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#how-existing-code-moves-toward-reaktor", "polarity": "Neutral" }, { "id": "section-what-a-graph-source-emits", "anchor": "what-a-graph-source-emits", "label": "What A Graph Source Emits", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#what-a-graph-source-emits", "polarity": "Neutral" }, { "id": "section-source-scanning", "anchor": "source-scanning", "label": "Source Scanning", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#source-scanning", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "See Also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#see-also", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-sources#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-sources:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-the-short-version", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor_graph_visitors_design-snapshot-consistency", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-what-a-graph-source-emits", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "section-snapshot-consistency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor-server", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor-capability", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-reaktor-service", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-sources:references-security-plan", "kind": "references", "owner": "reaktor-graph-sources", "incidences": [ { "node": "reaktor-graph-sources", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-sources.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Graph Sources - bring existing systems into the graph", "level": 0 }, { "id": "the-short-version", "anchor": "the-short-version", "title": "The Short Version", "level": 2 }, { "id": "current-state", "anchor": "current-state", "title": "Current State", "level": 2 }, { "id": "four-ways-a-system-enters-the-graph", "anchor": "four-ways-a-system-enters-the-graph", "title": "Four Ways A System Enters The Graph", "level": 2 }, { "id": "how-existing-code-moves-toward-reaktor", "anchor": "how-existing-code-moves-toward-reaktor", "title": "How Existing Code Moves Toward Reaktor", "level": 2 }, { "id": "what-a-graph-source-emits", "anchor": "what-a-graph-source-emits", "title": "What A Graph Source Emits", "level": 2 }, { "id": "source-scanning", "anchor": "source-scanning", "title": "Source Scanning", "level": 2 }, { "id": "runtime-observation", "anchor": "runtime-observation", "title": "Runtime Observation", "level": 2 }, { "id": "wrapping", "anchor": "wrapping", "title": "Wrapping", "level": 2 }, { "id": "what-actions-should-be-allowed", "anchor": "what-actions-should-be-allowed", "title": "What Actions Should Be Allowed", "level": 2 }, { "id": "implementation-plan", "anchor": "implementation-plan", "title": "Implementation Plan", "level": 2 }, { "id": "what-happened-to-graphify", "anchor": "what-happened-to-graphify", "title": "What Happened To Graphify", "level": 2 }, { "id": "open-decisions", "anchor": "open-decisions", "title": "Open Decisions", "level": 2 }, { "id": "see-also", "anchor": "see-also", "title": "See Also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "the-short-version" }, { "id": "reaktor_graph_visitors_design", "anchor": "snapshot-consistency", "relation": "references", "sourceAnchor": "what-a-graph-source-emits" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-graph-substrate-redesign", "owner": "Astra / Codex", "kind": "architecture", "summary": "Proposed port-graph evolution: pure data, typed maps, owned runtimes, portable Kotlin logic and integration contracts for all 34 framework module/build directories, 13 desktop modes and 74 authored subpanes.", "use": "Use for graph kernel and DSL decisions, HLD, Kotlin contracts, module hooks, observation feeds, shared Workbench context and performance/DX acceptance; this is a design proposal, not a shipped runtime.", "region": "graph-model", "order": 0, "title": "Reaktor Graph — Data-oriented Substrate and Typed Maps", "nav": "Graph Substrate Redesign", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-substrate-redesign", "revision": "c110590be06db4f99a6dfe8928d971b1be067f57c9f9d93e270699fcee430f36", "status": "unverified", "renderingRevision": "3ff75986cf176c32cf4d72fd213b0cb66e35b742818f9c3f1c3735680815ed54", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://dev.epicgames.com/documentation/unreal-engine/nodes-in-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/en-us/unreal-engine/functions-in-unreal-engine", "https://dev.epicgames.com/documentation/unreal-engine/blueprint-debugging-example-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/overview-of-mass-entity-in-unreal-engine", "https://docs.n8n.io/deploy/host-n8n/configure-n8n/scaling/enable-queue-mode", "https://docs.temporal.io/workflow-execution", "https://developers.google.com/maps/documentation/javascript/datalayer", "https://docs.pixxel.space/documentation/analytics-tools/visualizations/bands", "https://kotlinlang.org/docs/type-safe-builders.html", "https://kotlinlang.org/docs/ksp-overview.html", "https://component-model.bytecodealliance.org/design/wit.html", "https://alloytools.org/spec.html", "https://lamport.azurewebsites.net/tla/tla.html", "https://developers.cloudflare.com/queues/reference/delivery-guarantees/", "https://www.cs.virginia.edu/~robins/Turing_Paper_1936.pdf", "https://developer.apple.com/app-store/review/guidelines/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign", "polarity": "Neutral" }, { "id": "section-1-decisions-that-hold-the-design-together", "anchor": "1-decisions-that-hold-the-design-together", "label": "1. Decisions that hold the design together", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#1-decisions-that-hold-the-design-together", "polarity": "Neutral" }, { "id": "section-2-what-the-current-system-gives-us", "anchor": "2-what-the-current-system-gives-us", "label": "2. What the current system gives us", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#2-what-the-current-system-gives-us", "polarity": "Neutral" }, { "id": "section-3-lessons-from-related-systems", "anchor": "3-lessons-from-related-systems", "label": "3. Lessons from related systems", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#3-lessons-from-related-systems", "polarity": "Neutral" }, { "id": "section-4-hld-one-semantic-model-several-execution-planes", "anchor": "4-hld-one-semantic-model-several-execution-planes", "label": "4. HLD: one semantic model, several execution planes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#4-hld-one-semantic-model-several-execution-planes", "polarity": "Neutral" }, { "id": "section-5-semantic-model", "anchor": "5-semantic-model", "label": "5. Semantic model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#5-semantic-model", "polarity": "Neutral" }, { "id": "section-6-data-oriented-storage-with-a-pleasant-api", "anchor": "6-data-oriented-storage-with-a-pleasant-api", "label": "6. Data-oriented storage with a pleasant API", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#6-data-oriented-storage-with-a-pleasant-api", "polarity": "Neutral" }, { "id": "section-23-independent-review-claude", "anchor": "23-independent-review-claude", "label": "23. Independent review (Claude)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#23-independent-review-claude", "polarity": "Neutral" }, { "id": "section-ecosystem-integration", "anchor": "ecosystem-integration", "label": "22. Complete framework and desktop integration", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#ecosystem-integration", "polarity": "Neutral" }, { "id": "section-reconcile-the-existing-documents", "anchor": "reconcile-the-existing-documents", "label": "Reconcile the existing documents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-substrate-redesign#reconcile-the-existing-documents", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-substrate-redesign:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-formal-methods", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-ui-ux-audit-2026-09-08", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-framework-overview", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-essays", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-verified-foundations-fable-5", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-core", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-capability", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-component-lifecycle", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-service", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-work", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-ffi", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-auth-analysis", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-db", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-server", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-substrate-redesign:references-reaktor-conductor", "kind": "references", "owner": "reaktor-graph-substrate-redesign", "incidences": [ { "node": "reaktor-graph-substrate-redesign", "port": "section-reconcile-the-existing-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-substrate-redesign.json", "sections": [ { "id": "reaktor-graph--data-oriented-substrate-and-typed-maps", "anchor": "reaktor-graph--data-oriented-substrate-and-typed-maps", "title": "Reaktor Graph — Data-oriented Substrate and Typed Maps", "level": 1 }, { "id": "1-decisions-that-hold-the-design-together", "anchor": "1-decisions-that-hold-the-design-together", "title": "1. Decisions that hold the design together", "level": 2 }, { "id": "2-what-the-current-system-gives-us", "anchor": "2-what-the-current-system-gives-us", "title": "2. What the current system gives us", "level": 2 }, { "id": "review-scope-and-source-status", "anchor": "review-scope-and-source-status", "title": "Review scope and source status", "level": 3 }, { "id": "reconcile-the-existing-documents", "anchor": "reconcile-the-existing-documents", "title": "Reconcile the existing documents", "level": 3 }, { "id": "3-lessons-from-related-systems", "anchor": "3-lessons-from-related-systems", "title": "3. Lessons from related systems", "level": 2 }, { "id": "4-hld-one-semantic-model-several-execution-planes", "anchor": "4-hld-one-semantic-model-several-execution-planes", "title": "4. HLD: one semantic model, several execution planes", "level": 2 }, { "id": "module-placement", "anchor": "module-placement", "title": "Module placement", "level": 3 }, { "id": "5-semantic-model", "anchor": "5-semantic-model", "title": "5. Semantic model", "level": 2 }, { "id": "graph-node-port-and-edge", "anchor": "graph-node-port-and-edge", "title": "Graph, node, port and edge", "level": 3 }, { "id": "capabilities", "anchor": "capabilities", "title": "Capabilities", "level": 3 }, { "id": "fractal-composition", "anchor": "fractal-composition", "title": "Fractal composition", "level": 3 }, { "id": "identity-revision-and-time", "anchor": "identity-revision-and-time", "title": "Identity, revision and time", "level": 3 }, { "id": "6-data-oriented-storage-with-a-pleasant-api", "anchor": "6-data-oriented-storage-with-a-pleasant-api", "title": "6. Data-oriented storage with a pleasant API", "level": 2 }, { "id": "incrementality-and-scheduling", "anchor": "incrementality-and-scheduling", "title": "Incrementality and scheduling", "level": 3 }, { "id": "performance-acceptance-not-invented-speedups", "anchor": "performance-acceptance-not-invented-speedups", "title": "Performance acceptance, not invented speedups", "level": 3 }, { "id": "7-maps-a-common-skeleton-with-typed-overlays", "anchor": "7-maps-a-common-skeleton-with-typed-overlays", "title": "7. Maps: a common skeleton with typed overlays", "level": 2 }, { "id": "map-algebra", "anchor": "map-algebra", "title": "Map algebra", "level": 3 }, { "id": "useful-maps-with-actual-questions", "anchor": "useful-maps-with-actual-questions", "title": "Useful maps, with actual questions", "level": 3 }, { "id": "flow-selection-differs-from-map-selection", "anchor": "flow-selection-differs-from-map-selection", "title": "Flow selection differs from map selection", "level": 3 }, { "id": "8-traversals-and-visitors", "anchor": "8-traversals-and-visitors", "title": "8. Traversals and visitors", "level": 2 }, { "id": "dead-screen-analysis-must-be-honest", "anchor": "dead-screen-analysis-must-be-honest", "title": "Dead-screen analysis must be honest", "level": 3 }, { "id": "9-services-and-ffi", "anchor": "9-services-and-ffi", "title": "9. Services and FFI", "level": 2 }, { "id": "10-async-channels-subscriptions-and-durable-work", "anchor": "10-async-channels-subscriptions-and-durable-work", "title": "10. Async: channels, subscriptions and durable work", "level": 2 }, { "id": "delivery-policy-must-be-data", "anchor": "delivery-policy-must-be-data", "title": "Delivery policy must be data", "level": 3 }, { "id": "11-distributed-stitching-and-runtime-ownership", "anchor": "11-distributed-stitching-and-runtime-ownership", "title": "11. Distributed stitching and runtime ownership", "level": 2 }, { "id": "12-kotlin-authoring-portable-logic-and-turing-completeness", "anchor": "12-kotlin-authoring-portable-logic-and-turing-completeness", "title": "12. Kotlin authoring, portable logic and Turing completeness", "level": 2 }, { "id": "two-stages-in-one-language-experience", "anchor": "two-stages-in-one-language-experience", "title": "Two stages in one language experience", "level": 3 }, { "id": "what-turing-completeness-does-and-does-not-mean", "anchor": "what-turing-completeness-does-and-does-not-mean", "title": "What Turing completeness does and does not mean", "level": 3 }, { "id": "code-push-classification", "anchor": "code-push-classification", "title": "Code push classification", "level": 3 }, { "id": "runtime-replacement-protocol", "anchor": "runtime-replacement-protocol", "title": "Runtime replacement protocol", "level": 3 }, { "id": "13-important-kotlin-interfaces", "anchor": "13-important-kotlin-interfaces", "title": "13. Important Kotlin interfaces", "level": 2 }, { "id": "identity-pure-graph-data-and-authoring", "anchor": "identity-pure-graph-data-and-authoring", "title": "Identity, pure graph data and authoring", "level": 3 }, { "id": "maps-traversal-and-visitors", "anchor": "maps-traversal-and-visitors", "title": "Maps, traversal and visitors", "level": 3 }, { "id": "services-and-async-capabilities", "anchor": "services-and-async-capabilities", "title": "Services and async capabilities", "level": 3 }, { "id": "portable-program-shape", "anchor": "portable-program-shape", "title": "Portable program shape", "level": 3 }, { "id": "patches-and-execution-plans", "anchor": "patches-and-execution-plans", "title": "Patches and execution plans", "level": 3 }, { "id": "tests-and-assurance-evidence", "anchor": "tests-and-assurance-evidence", "title": "Tests and assurance evidence", "level": 3 }, { "id": "14-modification-protocol-for-developers-and-agents", "anchor": "14-modification-protocol-for-developers-and-agents", "title": "14. Modification protocol for developers and agents", "level": 2 }, { "id": "atomic-patches-and-source-ownership", "anchor": "atomic-patches-and-source-ownership", "title": "Atomic patches and source ownership", "level": 3 }, { "id": "distributed-changes", "anchor": "distributed-changes", "title": "Distributed changes", "level": 3 }, { "id": "agent-and-mcp-interface", "anchor": "agent-and-mcp-interface", "title": "Agent and MCP interface", "level": 3 }, { "id": "15-tests-as-graph-entities", "anchor": "15-tests-as-graph-entities", "title": "15. Tests as graph entities", "level": 2 }, { "id": "16-formal-methods-with-useful-limited-claims", "anchor": "16-formal-methods-with-useful-limited-claims", "title": "16. Formal methods with useful, limited claims", "level": 2 }, { "id": "17-bestbuds-worked-example-send-a-message-and-diagnose-failure", "anchor": "17-bestbuds-worked-example-send-a-message-and-diagnose-failure", "title": "17. BestBuds worked example: send a message and diagnose failure", "level": 2 }, { "id": "preserve-the-kotlin-dx", "anchor": "preserve-the-kotlin-dx", "title": "Preserve the Kotlin DX", "level": 3 }, { "id": "auth-and-database-detail-must-remain-useful", "anchor": "auth-and-database-detail-must-remain-useful", "title": "Auth and database detail must remain useful", "level": 3 }, { "id": "18-workbench-and-design-implications", "anchor": "18-workbench-and-design-implications", "title": "18. Workbench and design implications", "level": 2 }, { "id": "19-migration-preserve-the-graph-replace-its-load-bearing-internals", "anchor": "19-migration-preserve-the-graph-replace-its-load-bearing-internals", "title": "19. Migration: preserve the graph, replace its load-bearing internals", "level": 2 }, { "id": "compatibility-rules", "anchor": "compatibility-rules", "title": "Compatibility rules", "level": 3 }, { "id": "20-requirement-to-acceptance-matrix", "anchor": "20-requirement-to-acceptance-matrix", "title": "20. Requirement-to-acceptance matrix", "level": 2 }, { "id": "21-decisions-still-requiring-experiments", "anchor": "21-decisions-still-requiring-experiments", "title": "21. Decisions still requiring experiments", "level": 2 }, { "id": "ecosystem-integration", "anchor": "ecosystem-integration", "title": "22. Complete framework and desktop integration", "level": 2 }, { "id": "221-expanded-review-scope-and-current-seams", "anchor": "221-expanded-review-scope-and-current-seams", "title": "22.1 Expanded review scope and current seams", "level": 3 }, { "id": "222-six-ways-a-module-connects-to-the-substrate", "anchor": "222-six-ways-a-module-connects-to-the-substrate", "title": "22.2 Six ways a module connects to the substrate", "level": 3 }, { "id": "223-every-framework-module-and-build", "anchor": "223-every-framework-module-and-build", "title": "22.3 Every framework module and build", "level": 3 }, { "id": "224-every-desktop-mode-and-authored-family", "anchor": "224-every-desktop-mode-and-authored-family", "title": "22.4 Every desktop mode and authored family", "level": 3 }, { "id": "225-one-graph-also-describes-reaktor-itself", "anchor": "225-one-graph-also-describes-reaktor-itself", "title": "22.5 One graph also describes Reaktor itself", "level": 3 }, { "id": "226-hooks-are-contracted-boundaries-not-arbitrary-callbacks-everywhere", "anchor": "226-hooks-are-contracted-boundaries-not-arbitrary-callbacks-everywhere", "title": "22.6 Hooks are contracted boundaries, not arbitrary callbacks everywhere", "level": 3 }, { "id": "227-observation-and-projection-protocol", "anchor": "227-observation-and-projection-protocol", "title": "22.7 Observation and projection protocol", "level": 3 }, { "id": "228-kotlin-integration-contracts", "anchor": "228-kotlin-integration-contracts", "title": "22.8 Kotlin integration contracts", "level": 3 }, { "id": "229-integration-release-gates", "anchor": "229-integration-release-gates", "title": "22.9 Integration release gates", "level": 3 }, { "id": "validation-of-this-document", "anchor": "validation-of-this-document", "title": "Validation of this document", "level": 3 }, { "id": "23-independent-review-claude", "anchor": "23-independent-review-claude", "title": "23. Independent review (Claude)", "level": 2 }, { "id": "231-summary-judgment", "anchor": "231-summary-judgment", "title": "23.1 Summary judgment", "level": 3 }, { "id": "232-defects-in-the-contract-specimen", "anchor": "232-defects-in-the-contract-specimen", "title": "23.2 Defects in the contract specimen", "level": 3 }, { "id": "233-programme-risk-19-against-22", "anchor": "233-programme-risk-19-against-22", "title": "23.3 Programme risk: §19 against §22", "level": 3 }, { "id": "234-the-missing-artifact-a-kernel-v0", "anchor": "234-the-missing-artifact-a-kernel-v0", "title": "23.4 The missing artifact: a kernel v0", "level": 3 }, { "id": "235-what-should-survive-unchanged", "anchor": "235-what-should-survive-unchanged", "title": "23.5 What should survive unchanged", "level": 3 }, { "id": "236-verification-log", "anchor": "236-verification-log", "title": "23.6 Verification log", "level": 3 } ], "links": [ { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "ecosystem-integration", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-verified-foundations-fable-5", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "reconcile-the-existing-documents" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "ecosystem-integration", "relation": "references", "sourceAnchor": "module-placement" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "16-formal-methods-with-useful-limited-claims" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "18-workbench-and-design-implications" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "221-expanded-review-scope-and-current-seams" } ] }, { "id": "reaktor-graph-theory", "summary": "Typed nested port hypergraphs, identity/revision/activation, open dialects, composition and implementation boundaries.", "kind": "design", "owner": "Reaktor", "use": "Read the theory and distinguish structural checks from runtime, target and deployment qualification.", "region": "theory-foundations", "order": 0, "title": "Reaktor graph theory — the model and its boundaries", "nav": "Graph theory", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-theory", "revision": "69a68f23dc5f063f951f379a7b18761e801071783d979e38bb041f45b62eab06", "status": "design", "renderingRevision": "998b1acfc05058a5e582a26fb786b03a43a99e1691fd8096eca029ed54fafda6", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "what-this-wave-establishes" ], "externalLinks": [ "https://opentelemetry.io/docs/concepts/context-propagation/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-theory", "polarity": "Neutral" }, { "id": "section-a-small-example-before-the-notation", "anchor": "a-small-example-before-the-notation", "label": "A small example before the notation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#a-small-example-before-the-notation", "polarity": "Neutral" }, { "id": "section-formal-structure", "anchor": "formal-structure", "label": "Formal structure", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#formal-structure", "polarity": "Neutral" }, { "id": "section-identity-revision-and-activation", "anchor": "identity-revision-and-activation", "label": "Identity, revision and activation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#identity-revision-and-activation", "polarity": "Neutral" }, { "id": "section-composition-and-nested-regions", "anchor": "composition-and-nested-regions", "label": "Composition and nested regions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#composition-and-nested-regions", "polarity": "Neutral" }, { "id": "section-open-dialects-and-orthogonal-facets", "anchor": "open-dialects-and-orthogonal-facets", "label": "Open dialects and orthogonal facets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#open-dialects-and-orthogonal-facets", "polarity": "Neutral" }, { "id": "section-four-views-of-one-system", "anchor": "four-views-of-one-system", "label": "Four views of one system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#four-views-of-one-system", "polarity": "Neutral" }, { "id": "structural-core", "anchor": "structural-core", "label": "A small structural core", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#structural-core", "polarity": "Neutral" }, { "id": "coverage", "anchor": "coverage-and-admission", "label": "Coverage and target admission", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#coverage-and-admission", "polarity": "Neutral" }, { "id": "semantic-checks", "anchor": "required-semantic-checks", "label": "Missing checks, rather than missing business node types", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-theory#required-semantic-checks", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-theory:references-reaktor-graph-vocabulary-theory", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:references-reaktor-hyperedge-theory", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-hyperedge-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:references-reaktor-graph-language-theory", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:references-reaktor-graph-distribution-theory", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:references-reaktor-graph-precedents", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-precedents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "section-a-small-example-before-the-notation", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:references-reaktor-examples-mobile-mobile-community", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "section-a-small-example-before-the-notation", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-mobile", "port": "section-mobile-community", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:requires-reaktor-graph-vocabulary-theory", "kind": "requires", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:requires-reaktor-hyperedge-theory", "kind": "requires", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-hyperedge-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:explains-reaktor-graph-language-theory", "kind": "explains", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:explains-reaktor-system-atlas", "kind": "explains", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:derived-from-architecture-atlas-foundations", "kind": "derived-from", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:reading-reaktor-port-theory", "kind": "explains", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-port-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:reading-reaktor-nested-graphs-theory", "kind": "explains", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-theory:reading-reaktor-graph-views-theory", "kind": "explains", "owner": "reaktor-graph-theory", "incidences": [ { "node": "reaktor-graph-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-views-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor graph theory — the model and its boundaries", "level": 0 }, { "id": "a-small-example-before-the-notation", "anchor": "a-small-example-before-the-notation", "title": "A small example before the notation", "level": 2 }, { "id": "formal-structure", "anchor": "formal-structure", "title": "Formal structure", "level": 2 }, { "id": "identity-revision-and-activation", "anchor": "identity-revision-and-activation", "title": "Identity, revision and activation", "level": 2 }, { "id": "composition-and-nested-regions", "anchor": "composition-and-nested-regions", "title": "Composition and nested regions", "level": 2 }, { "id": "open-dialects-and-orthogonal-facets", "anchor": "open-dialects-and-orthogonal-facets", "title": "Open dialects and orthogonal facets", "level": 2 }, { "id": "four-views-of-one-system", "anchor": "four-views-of-one-system", "title": "Four views of one system", "level": 2 }, { "id": "implementation-boundary", "anchor": "implementation-boundary", "title": "Implementation boundary", "level": 2 }, { "id": "structural-core", "anchor": "structural-core", "title": "A small structural core", "level": 2 }, { "id": "coverage-and-admission", "anchor": "coverage-and-admission", "title": "Coverage and target admission", "level": 2 }, { "id": "required-semantic-checks", "anchor": "required-semantic-checks", "title": "Missing checks, rather than missing business node types", "level": 2 } ], "links": [ { "id": "reaktor-graph-vocabulary-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-port-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-nested-graphs-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-views-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-distribution-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-precedents", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "a-small-example-before-the-notation" }, { "id": "reaktor-examples-mobile", "anchor": "mobile-community", "relation": "references", "sourceAnchor": "a-small-example-before-the-notation" }, { "id": "reaktor-system-atlas", "anchor": "", "relation": "references", "sourceAnchor": "composition-and-nested-regions" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "node-classification", "relation": "references", "sourceAnchor": "structural-core" }, { "id": "reaktor-port-theory", "anchor": "port-classification", "relation": "references", "sourceAnchor": "structural-core" }, { "id": "reaktor-hyperedge-theory", "anchor": "hyperedge-classification", "relation": "references", "sourceAnchor": "structural-core" } ] }, { "id": "reaktor-graph-views-theory", "kind": "design", "owner": "Reaktor", "region": "theory-foundations", "use": "Read the semantic theory, diagrams and concrete source mappings; distinguish declared profiles from qualified runtime behavior.", "order": 5, "summary": "Subgraph views, visitors and traversals: 5 diagrammed designs, with legends, domains, Reaktor examples and explicit laws.", "diagrams": [ { "id": "view-structural", "src": "/docs/img/theory/view-structural.svg", "alt": "Structural traversal and connectivity traversal", "text": "What does the selector traverse, and what does the visitor derive?\nStructuralSelector follows graph → nodes → ports → edges. ConnectivitySelector follows a node through its consumer dependencies. DepthFirstTraverser calls exit callbacks after descendants; BreadthFirstTraverser invokes visit while scanning levels and currently does not invoke exit callbacks. A custom selector chooses the relation/direction needed by a bounded view.\nvisitors\ninspection\ncomposition\nConnectivitySelector is not automatically an outgoing product-flow trace; service flows may need both directions and selected relation profiles.\nHierarchyVisitor relies on balanced exit callbacks, so use it with the depth-first traverser, not the current breadth-first traverser.\nDeclared product-flow nodes; omit unrelated service and evidence resources.\nAdmitted nodes: route, surface, service, store\nroute: Conversation RouteBinding (N12)\nroute.surface: P08; ConversationStateV1; Offer\nsurface: Conversation ComposeNode (N11)\nsurface.state: P08; ConversationStateV1; Require\nsurface.send: P02; MessagingApiV1; Require\nservice: MessagingService send (N02)\nservice.api: P02; MessagingApiV1; Offer\nservice.write: P09; MessagePatchV1; Require\nservice.observe: P24; PortInvocationV1; Offer\nstore: Message authority (N21)\nstore.write: P09; MessagePatchV1; Offer\nspans: PortTelemetryInterceptor spans (N37)\nspans.input: P24; PortInvocationV1; Require\nspans.evidence: P24; TraceEvidenceV1; Offer\nshadow: Shadow capture with redacted fixtures (N36)\nshadow.evidence: P24; ShadowCaptureV1; Offer\nvisitor: Flow debugger visitor (N38)\nvisitor.trace: P24; TraceEvidenceV1; Require\nvisitor.shadow: P24; ShadowCaptureV1; Require\nfinding: Flow finding with coverage (N37)\nfinding.finding: P24; TraceEvidenceV1; Require\nunrelated: Unrelated campaign service (N02)\nunrelated.api: P02; CampaignApiV1; Offer\nstate (H02): source[0]=route.surface; sink[0]=surface.state\nsend-rpc (H05): caller[0]=surface.send; callee[0]=service.api\nconditional-write (H05): caller[0]=service.write; callee[0]=store.write\nport-observation (H01): provider[0]=service.observe; consumer[0]=spans.input\ntrace-evidence (H27): input[0]=spans.evidence; transform[0]=visitor.trace; output[0]=finding.finding\nshadow-evidence (H28): evidence[0]=shadow.evidence; verifier[0]=visitor.shadow; claim[0]=finding.finding" }, { "id": "view-principal", "src": "/docs/img/theory/view-principal.svg", "alt": "A principal-scoped RBAC view", "text": "Which graph nodes and port contracts may this human or agent principal discover?\nEvaluate AuthContext against AuthRequirement for the requested inspect action, environment and graph revision. A query admits only authorized node/port/facet identities, then applies disclosure rules to boundary stubs. A delegated agent may receive a narrower view than its human sponsor. This illustration declares a read-only agent grant; it does not authorize send or deployment.\nRBAC\nauth\nagents\nSecuredProviderPort and SecuredConsumerPort exist; an end-to-end principal-filtered query engine remains integration work.\nFilter before returning data or embeddings. Omitted nodes do not establish nonexistence; revealing relation degree or a redacted name may itself disclose data.\nExample inspect policy admits principal, policy and conversation read; send and private identity are not admitted.\nAdmitted nodes: principal, policy, read\nprincipal: Agent principal: conversation read (N33)\nprincipal.identity: P20; ScopedInspectContextV1; Neutral\npolicy: LocalAuthorizer inspect requirement (N33)\npolicy.decision: P20; ScopedInspectContextV1; Offer\nread: Permitted conversation read (N02)\nread.grant: P20; ScopedInspectContextV1; Require\nsend: Send operation outside this grant (N02)\nsend.grant: P20; ScopedSendContextV1; Require\nprivate: Private identity region outside this view (N21)\nprivate.inspect: P24; PrivateIdentityV1; Offer\ninspect-only (H23): principal[0]=principal.identity; policy[0]=policy.decision; resource[0]=read.grant" }, { "id": "view-telemetry", "src": "/docs/img/theory/view-telemetry.svg", "alt": "Measured end-to-end latency view", "text": "How long did one send-message intent take to reach the chosen completion milestone?\nSelect the route → Surface → service → authority flow, then join actual spans by trace/operation identity, graph revision and activation. PortTelemetryInterceptor records monotonic elapsed durations at instrumented calls. An E2E finding uses observed start/end milestones and causal span links; it does not sum overlapping spans or derive latency from diagram geometry.\ntelemetry\ndistributed systems\nmobile\nNo measured values are fabricated in this design. Missing context, sampling, uninstrumented callbacks and clock uncertainty remain visible coverage gaps.\nReference-shaped ports are skipped by the interceptor; returned-object calls need their own instrumentation. Queue wait and client render may lie outside a service span.\nFlow identities plus authorized span evidence; exclude unrelated campaign and uncaptured Shadow resources.\nAdmitted nodes: route, surface, service, store, spans, visitor, finding\nroute: Conversation RouteBinding (N12)\nroute.surface: P08; ConversationStateV1; Offer\nsurface: Conversation ComposeNode (N11)\nsurface.state: P08; ConversationStateV1; Require\nsurface.send: P02; MessagingApiV1; Require\nservice: MessagingService send (N02)\nservice.api: P02; MessagingApiV1; Offer\nservice.write: P09; MessagePatchV1; Require\nservice.observe: P24; PortInvocationV1; Offer\nstore: Message authority (N21)\nstore.write: P09; MessagePatchV1; Offer\nspans: PortTelemetryInterceptor spans (N37)\nspans.input: P24; PortInvocationV1; Require\nspans.evidence: P24; TraceEvidenceV1; Offer\nshadow: Shadow capture with redacted fixtures (N36)\nshadow.evidence: P24; ShadowCaptureV1; Offer\nvisitor: Flow debugger visitor (N38)\nvisitor.trace: P24; TraceEvidenceV1; Require\nvisitor.shadow: P24; ShadowCaptureV1; Require\nfinding: Flow finding with coverage (N37)\nfinding.finding: P24; TraceEvidenceV1; Require\nunrelated: Unrelated campaign service (N02)\nunrelated.api: P02; CampaignApiV1; Offer\nstate (H02): source[0]=route.surface; sink[0]=surface.state\nsend-rpc (H05): caller[0]=surface.send; callee[0]=service.api\nconditional-write (H05): caller[0]=service.write; callee[0]=store.write\nport-observation (H01): provider[0]=service.observe; consumer[0]=spans.input\ntrace-evidence (H27): input[0]=spans.evidence; transform[0]=visitor.trace; output[0]=finding.finding\nshadow-evidence (H28): evidence[0]=shadow.evidence; verifier[0]=visitor.shadow; claim[0]=finding.finding" }, { "id": "view-debugger", "src": "/docs/img/theory/view-debugger.svg", "alt": "One flow in a Shadow-backed debugger", "text": "Can an operator reproduce and step through this exact send-message path with scoped captured data?\nThe flow visitor identifies source-owned nodes, ports, RPC hops and state authority. It produces a debugger plan bound to source maps, artifacts, graph revision, activation, and a redacted Shadow capture. Admission then creates an isolated scenario and attaches qualified target debuggers. The visitor itself stays read-only; running the debugger is a separately authorized command.\ndebugging\nShadow\nproduct flows\nShadow capture fidelity, native FFI state and external effects have declared gaps; a full arbitrary-system debugger is a target integration, not an existing visitor guarantee.\nReplay data can be sensitive. Verify redaction, workspace access, effect suppression and target support before starting an isolated run.\nSelected send-message flow plus its permitted spans, redacted Shadow capture and debugger plan inputs.\nAdmitted nodes: route, surface, service, store, spans, shadow, visitor, finding\nroute: Conversation RouteBinding (N12)\nroute.surface: P08; ConversationStateV1; Offer\nsurface: Conversation ComposeNode (N11)\nsurface.state: P08; ConversationStateV1; Require\nsurface.send: P02; MessagingApiV1; Require\nservice: MessagingService send (N02)\nservice.api: P02; MessagingApiV1; Offer\nservice.write: P09; MessagePatchV1; Require\nservice.observe: P24; PortInvocationV1; Offer\nstore: Message authority (N21)\nstore.write: P09; MessagePatchV1; Offer\nspans: PortTelemetryInterceptor spans (N37)\nspans.input: P24; PortInvocationV1; Require\nspans.evidence: P24; TraceEvidenceV1; Offer\nshadow: Shadow capture with redacted fixtures (N36)\nshadow.evidence: P24; ShadowCaptureV1; Offer\nvisitor: Flow debugger visitor (N38)\nvisitor.trace: P24; TraceEvidenceV1; Require\nvisitor.shadow: P24; ShadowCaptureV1; Require\nfinding: Flow finding with coverage (N37)\nfinding.finding: P24; TraceEvidenceV1; Require\nunrelated: Unrelated campaign service (N02)\nunrelated.api: P02; CampaignApiV1; Offer\nstate (H02): source[0]=route.surface; sink[0]=surface.state\nsend-rpc (H05): caller[0]=surface.send; callee[0]=service.api\nconditional-write (H05): caller[0]=service.write; callee[0]=store.write\nport-observation (H01): provider[0]=service.observe; consumer[0]=spans.input\ntrace-evidence (H27): input[0]=spans.evidence; transform[0]=visitor.trace; output[0]=finding.finding\nshadow-evidence (H28): evidence[0]=shadow.evidence; verifier[0]=visitor.shadow; claim[0]=finding.finding" }, { "id": "view-code-push", "src": "/docs/img/theory/view-code-push.svg", "alt": "A code-push eligibility view", "text": "Which region can this qualified host replace while preserving boundary and state laws?\nVisit the RGL definition and source/artifact dependencies. Compute a candidate closure, record every crossing port, then filter by Kotlin/JS compilation, qualified FFI target, installed capability, authority, lifetime/drain, dependency and state-migration rules. Eligible regions enter an admitted release plan; structural reachability alone never makes a region deployable.\nRGL\ncode push\npartitioning\nAn active borrowed resource, incompatible checkpoint, unqualified target ABI or unresolved policy makes the cut ineligible.\nA graph visitor can prepare findings and a release proposal; it cannot waive the host admission/reconciliation protocol.\nIllustrative candidate region only; crossing lifecycle/checkpoint/artifact contracts must be reported and qualified before deployment.\nAdmitted nodes: bundle, region\nhost: Qualified JS + FFI host (N27)\nhost.feature: P23; RegionBundleV1; Require\nhost.epoch: P21; RegionActivationV1; Offer\nbundle: Common Kotlin JS bundle (N35)\nbundle.artifact: P23; RegionBundleV1; Offer\nregion: Feature boundary (N10)\nregion.lifecycle: P21; RegionActivationV1; Require\nregion.checkpoint: P22; FeatureStateV1; Offer\nmigrate: State migration controller (N40)\nmigrate.state: P22; FeatureStateV1; Require\nartifact (H26): consumer[0]=host.feature; dependency[0]=bundle.artifact\nactivate (H29): release[0]=bundle.artifact; image[0]=host.epoch; localRoot[0]=region.lifecycle\ncheckpoint-binding (H01): provider[0]=region.checkpoint; consumer[0]=migrate.state" } ], "title": "Subgraph views, visitors and traversals", "nav": "Subgraph views", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-views-theory", "revision": "0416247343c7e2ceaf1ed34699c30fd6a95e0ad8fd6000fc4879b5b137b5e177", "status": "design", "renderingRevision": "b50160d1a49afcf209d6bb988ba3f36973634ab8c34725164c53c513777b03e5", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://opentelemetry.io/docs/concepts/context-propagation/", "https://opentelemetry.io/docs/specs/otel/trace/api/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-views-theory", "polarity": "Neutral" }, { "id": "view-structural", "anchor": "view-structural", "label": "Structural traversal and connectivity traversal", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-views-theory#view-structural", "polarity": "Neutral" }, { "id": "view-principal", "anchor": "view-principal", "label": "A principal-scoped RBAC view", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-views-theory#view-principal", "polarity": "Neutral" }, { "id": "view-telemetry", "anchor": "view-telemetry", "label": "Measured end-to-end latency view", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-views-theory#view-telemetry", "polarity": "Neutral" }, { "id": "view-debugger", "anchor": "view-debugger", "label": "One flow in a Shadow-backed debugger", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-views-theory#view-debugger", "polarity": "Neutral" }, { "id": "view-code-push", "anchor": "view-code-push", "label": "A code-push eligibility view", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-views-theory#view-code-push", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-views-theory:view-structural-module", "kind": "references", "owner": "reaktor-graph-views-theory", "incidences": [ { "node": "reaktor-graph-views-theory", "port": "view-structural", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-views-theory:view-principal-module", "kind": "references", "owner": "reaktor-graph-views-theory", "incidences": [ { "node": "reaktor-graph-views-theory", "port": "view-principal", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-views-theory:view-telemetry-module", "kind": "references", "owner": "reaktor-graph-views-theory", "incidences": [ { "node": "reaktor-graph-views-theory", "port": "view-telemetry", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-views-theory:view-debugger-module", "kind": "references", "owner": "reaktor-graph-views-theory", "incidences": [ { "node": "reaktor-graph-views-theory", "port": "view-debugger", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-views-theory:view-code-push-module", "kind": "references", "owner": "reaktor-graph-views-theory", "incidences": [ { "node": "reaktor-graph-views-theory", "port": "view-code-push", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-views-theory:topic-reaktor-nested-graphs-theory", "kind": "explains", "owner": "reaktor-graph-views-theory", "incidences": [ { "node": "reaktor-graph-views-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-views-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Subgraph views, visitors and traversals", "level": 0 }, { "id": "selection-traversal-and-observation-are-different", "anchor": "selection-traversal-and-observation-are-different", "title": "Selection, traversal and observation are different", "level": 2 }, { "id": "one-system-several-lenses", "anchor": "one-system-several-lenses", "title": "One system, several lenses", "level": 2 }, { "id": "authorization-before-retrieval", "anchor": "authorization-before-retrieval", "title": "Authorization before retrieval", "level": 2 }, { "id": "telemetry-uses-evidence-not-arrows", "anchor": "telemetry-uses-evidence-not-arrows", "title": "Telemetry uses evidence, not arrows", "level": 2 }, { "id": "findings-become-plans-through-admission", "anchor": "findings-become-plans-through-admission", "title": "Findings become plans through admission", "level": 2 }, { "id": "view-structural", "anchor": "view-structural", "title": "Structural traversal and connectivity traversal", "level": 2 }, { "id": "view-principal", "anchor": "view-principal", "title": "A principal-scoped RBAC view", "level": 2 }, { "id": "view-telemetry", "anchor": "view-telemetry", "title": "Measured end-to-end latency view", "level": 2 }, { "id": "view-debugger", "anchor": "view-debugger", "title": "One flow in a Shadow-backed debugger", "level": 2 }, { "id": "view-code-push", "anchor": "view-code-push", "title": "A code-push eligibility view", "level": 2 } ], "links": [ { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "authorization-before-retrieval" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "view-structural" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "view-principal" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "view-telemetry" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "view-debugger" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "view-code-push" } ] }, { "id": "reaktor-graph-vocabulary-theory", "summary": "Nodes: task designs, behavior classes, compositions and domain roles.", "kind": "design", "owner": "Reaktor", "use": "Read the theory and distinguish structural checks from runtime, target and deployment qualification.", "region": "theory-foundations", "order": 1, "diagrams": [ { "id": "type-n01", "src": "/docs/img/theory/type-n01.svg", "alt": "N01 · Pure computation — Rank a feed without fetching data", "text": "Which posts should appear first for this reader?\nA repository supplies candidate posts and a versioned preference snapshot. A pure Kotlin scorer returns ranked IDs; pagination and rendering consume the same result. Network retrieval and impression writes stay outside the scorer, so identical snapshots can be replayed in Shadow.\nmobile\nweb\nanalytics\nNo hidden effects; cache only against declared inputs and semantic version.\nPure computation can be memoized only with all semantic inputs, including the ranking/model revision.\nposts: Candidate posts (N22)\nposts.candidates: P01; PostCandidatesV2; Offer\npreferences: Reader preferences (N21)\npreferences.snapshot: P01; PreferenceSnapshotV1; Offer\nrank: Kotlin feed scorer (N01)\nrank.posts: P01; PostCandidatesV2; Require\nrank.preferences: P01; PreferenceSnapshotV1; Require\nrank.ranked: P01; RankedPostIdsV1; Offer\npage: Feed pagination (N04)\npage.ranked: P01; RankedPostIdsV1; Require\npage.page: P01; FeedPageV1; Offer\nui: Feed Surface (N11)\nui.page: P01; FeedPageV1; Require\nui.visible: P04; PostVisibleEventV1; Offer\nimpression: Impression recorder (N02)\nimpression.visible: P04; PostVisibleEventV1; Require\ncandidates (H02): source[0]=posts.candidates; target[0]=rank.posts\npreferences (H02): source[0]=preferences.snapshot; target[0]=rank.preferences\nranked (H02): source[0]=rank.ranked; target[0]=page.ranked\npage (H02): source[0]=page.page; target[0]=ui.page\nseen (H04): publisher[0]=ui.visible; subscriber[0]=impression.visible" }, { "id": "type-n02", "src": "/docs/img/theory/type-n02.svg", "alt": "N02 · Effectful operation — Upload a profile photo", "text": "How does selecting a photo become a durable profile change?\nThe upload operation owns the external write. It obtains an authorized object key, writes bytes, and updates the profile only after a storage receipt. A failed profile update leaves a named orphan for cleanup instead of pretending both services committed atomically.\nmessaging\ncommerce\nservices\nEffects and required grants are explicit; timeout does not imply no effect.\nCancellation after upload does not undo a committed object; cleanup is a separately authorized effect.\npicker: Photo picker (N13)\npicker.photo: P01; SelectedPhotoV1; Offer\nupload: Profile photo upload (N02)\nupload.photo: P01; SelectedPhotoV1; Require\nupload.grant: P20; ObjectWriteGrantV1; Require\nupload.put: P02; PutPhotoRequestReceiptV1; Require\nupload.commit: P09; ProfilePhotoCompareVersionV1; Require\nupload.orphan: P03; OrphanPhotoCleanupV1; Neutral\npolicy: Upload policy (N33)\npolicy.grant: P20; ObjectWriteGrantV1; Offer\nobjects: R2 object store (N26)\nobjects.put: P02; PutPhotoRequestReceiptV1; Offer\nobjects.delete: P02; DeleteObjectRequestReceiptV1; Offer\nprofile: Profile authority (N21)\nprofile.photo: P09; ProfilePhotoCompareVersionV1; Offer\ncleanup: Orphan cleanup (N06)\ncleanup.remove: P03; OrphanPhotoCleanupV1; Neutral\ncleanup.delete: P02; DeleteObjectRequestReceiptV1; Require\nselection (H02): source[0]=picker.photo; target[0]=upload.photo\ngrant (H23): principal[0]=policy.grant; resource[0]=upload.grant\nwrite (H05): caller[0]=upload.put; callee[0]=objects.put\ncommit (H05): caller[0]=upload.commit; callee[0]=profile.photo\norphan (H17): forward[0]=upload.orphan; compensation[0]=cleanup.remove\nremove (H05): caller[0]=cleanup.delete; callee[0]=objects.delete" }, { "id": "type-n03", "src": "/docs/img/theory/type-n03.svg", "alt": "N03 · Decision / pattern match — Choose the next onboarding screen", "text": "Should a returning user see home, consent, or profile setup?\nA decision evaluates the session, accepted terms version and profile completeness as data. Its three outcomes feed explicit destinations through RouteNode bindings. The decision has no hidden navigation effect; session expiry can select sign-in without granting any backend permission.\nnavigation\nauth\nfeature flags\nDefine exhaustive cases and defaults; guards are pure in the selected profile.\nMutually exclusive branches need a declared exhaustive predicate; a drawn fork alone supplies neither condition nor exhaustiveness.\nsession: Session hydration (N25)\nsession.snapshot: P01; OnboardingSnapshotV1; Offer\ndecide: Onboarding decision (N03)\ndecide.snapshot: P01; OnboardingSnapshotV1; Require\ndecide.signedOut: P12; SignInRouteIntentV1; Offer\ndecide.needsConsent: P12; ConsentRouteIntentV1; Offer\ndecide.ready: P12; HomeRouteIntentV1; Offer\nsignin: Sign-in route (N12)\nsignin.enter: P12; SignInRouteIntentV1; Require\nconsent: Consent route (N12)\nconsent.enter: P12; ConsentRouteIntentV1; Require\nhome: Home route (N12)\nhome.enter: P12; HomeRouteIntentV1; Require\nsnapshot (H02): source[0]=session.snapshot; target[0]=decide.snapshot\nsigned-out (H36): source[0]=decide.signedOut; target[0]=signin.enter\nneeds-consent (H36): source[0]=decide.needsConsent; target[0]=consent.enter\nready (H36): source[0]=decide.ready; target[0]=home.enter" }, { "id": "type-n04", "src": "/docs/img/theory/type-n04.svg", "alt": "N04 · Loop / recursive region — Load more search results", "text": "How can scrolling fetch more results without looping forever?\nA cursor loop requests one page, appends unique results, and advances only when the server returns a new cursor. End-of-list and cancellation exit the region. The loop is ordinary Kotlin common logic rather than one graph node per iteration.\nanalytics\nworkflows\ncompilers\nSpecify continuation/state semantics and resource budgets; a cycle is not a schedule.\nReject repeated cursors and impose a request budget; recursion in code is not a graph containment cycle.\nscroll: Load-more interaction (N13)\nscroll.more: P04; LoadMoreIntentV1; Offer\nloop: Search pagination loop (N04)\nloop.more: P04; LoadMoreIntentV1; Require\nloop.fetch: P02; SearchPageRequestResponseV2; Require\nloop.append: P09; AppendSearchPageV1; Require\nloop.cursor: P01; NextSearchCursorV1; Require\nloop.cancel: P14; SearchCancellationV1; Require\nsearch: Search service (N19)\nsearch.page: P02; SearchPageRequestResponseV2; Offer\nlist: Result list state (N05)\nlist.append: P09; AppendSearchPageV1; Offer\nlist.cursor: P01; NextSearchCursorV1; Offer\nlist.state: P08; SearchListStateV1; Offer\nview: Search Surface (N11)\nview.state: P08; SearchListStateV1; Require\nview.leave: P14; SearchCancellationV1; Offer\nload (H04): publisher[0]=scroll.more; subscriber[0]=loop.more\nfetch (H05): caller[0]=loop.fetch; callee[0]=search.page\nappend (H05): caller[0]=loop.append; callee[0]=list.append\ncursor (H02): source[0]=list.cursor; target[0]=loop.cursor\nrender (H02): source[0]=list.state; target[0]=view.state\ncancel (H03): source[0]=view.leave; target[0]=loop.cancel" }, { "id": "type-n05", "src": "/docs/img/theory/type-n05.svg", "alt": "N05 · Actor / statechart — Serialize messages in one conversation", "text": "How do concurrent sends preserve conversation state?\nA conversation actor serializes commands against its state. Admission checks precede mailbox entry, persistence produces a revisioned receipt, and subscribers observe the committed sequence. The actor is a state owner; it does not create global order across unrelated conversations.\nmessaging\ngames\ndistributed systems\nOwns state and event ordering; hierarchy does not itself provide durability.\nMailbox serialization is local to its activation; durable recovery and duplicate-command handling require journal and command-ID contracts.\nalice: Alice sender (N11)\nalice.send: P03; ConversationCommandReceiptV1; Require\nbob: Bob sender (N11)\nbob.send: P03; ConversationCommandReceiptV1; Require\nauth: Conversation access policy (N33)\nauth.grant: P20; ConversationWriteGrantV1; Offer\nactor: Conversation actor (N05)\nactor.alice: P03; ConversationCommandReceiptV1; Offer\nactor.bob: P03; ConversationCommandReceiptV1; Offer\nactor.admission: P20; ConversationWriteGrantV1; Require\nactor.append: P02; AppendMessageAtRevisionV1; Require\nactor.committed: P04; CommittedMessageV1; Offer\njournal: Message journal (N21)\njournal.append: P02; AppendMessageAtRevisionV1; Offer\nevents: Conversation subscribers (N24)\nevents.committed: P04; CommittedMessageV1; Require\nalice-send (H05): caller[0]=alice.send; callee[0]=actor.alice\nbob-send (H05): caller[0]=bob.send; callee[0]=actor.bob\nadmission (H23): principal[0]=auth.grant; resource[0]=actor.admission\npersist (H05): caller[0]=actor.append; callee[0]=journal.append\ncommitted (H04): publisher[0]=actor.committed; subscriber[0]=events.committed" }, { "id": "type-n06", "src": "/docs/img/theory/type-n06.svg", "alt": "N06 · Workflow / saga — Recover a checkout after payment fails", "text": "What happens when inventory is reserved but payment is declined?\nThe checkout saga records each completed step. A declined charge schedules reservation release; a timed-out charge enters reconciliation before any compensation decision. A confirmed charge schedules order confirmation. Compensation is an explicit later operation, and retries use the recorded command identity and receipts.\nonboarding\ncommerce\nworkflows\nVersion durable continuations; make retries, unknown results and compensation explicit.\nA timeout is an unknown payment outcome; reconciliation must precede a new charge or refund.\ncheckout: Checkout saga (N06)\ncheckout.reserve: P03; ReserveStockReceiptV1; Require\ncheckout.charge: P03; ChargePaymentReceiptV1; Require\ncheckout.confirm: P03; ConfirmOrderReceiptV1; Require\ncheckout.record: P02; RecordSagaStepV1; Require\ncheckout.release: P03; ReleaseReservationCommandV1; Neutral\ncheckout.unknown: P12; UnknownChargeOutcomeV1; Offer\ncheckout.settled: P01; ReconciledChargeOutcomeV1; Require\nstock: Inventory reservation (N21)\nstock.reserve: P03; ReserveStockReceiptV1; Offer\nstock.release: P02; ReleaseStockReceiptV1; Offer\npayment: Payment adapter (N19)\npayment.charge: P03; ChargePaymentReceiptV1; Offer\npayment.status: P02; ChargeStatusByCommandIdV1; Offer\norders: Order authority (N21)\norders.confirm: P03; ConfirmOrderReceiptV1; Offer\nrelease: Reservation release (N02)\nrelease.release: P03; ReleaseReservationCommandV1; Neutral\nrelease.stock: P02; ReleaseStockReceiptV1; Require\njournal: Checkout step journal (N21)\njournal.append: P02; RecordSagaStepV1; Offer\nreconcile: Unknown payment reconciliation (N06)\nreconcile.unknown: P12; UnknownChargeOutcomeV1; Require\nreconcile.status: P02; ChargeStatusByCommandIdV1; Require\nreconcile.settled: P01; ReconciledChargeOutcomeV1; Offer\nreserve (H05): caller[0]=checkout.reserve; callee[0]=stock.reserve\ncharge (H05): caller[0]=checkout.charge; callee[0]=payment.charge\nconfirm (H05): caller[0]=checkout.confirm; callee[0]=orders.confirm\nrecord (H05): caller[0]=checkout.record; callee[0]=journal.append\ncompensate (H17): forward[0]=checkout.release; compensation[0]=release.release\nstock-release (H05): caller[0]=release.stock; callee[0]=stock.release\nunknown-charge (H03): source[0]=checkout.unknown; target[0]=reconcile.unknown\ncharge-status (H05): caller[0]=reconcile.status; callee[0]=payment.status\nsettled-charge (H02): source[0]=reconcile.settled; target[0]=checkout.settled" }, { "id": "type-n07", "src": "/docs/img/theory/type-n07.svg", "alt": "N07 · Stream operator — Debounce search as someone types", "text": "How does a search box avoid sending one request per keystroke?\nA stream operator normalizes terms, debounces input, and replaces the previous search request. A result carries its query generation so a slow old response cannot overwrite a newer one. Empty input clears the list without fetching.\ntelemetry\nmedia\nIoT\nSpecify demand, buffering, event-time policy, loss and cancellation.\nDebouncing changes timing; it does not preserve every input event or provide durable delivery.\ninput: Search input (N13)\ninput.term: P08; SearchTermStateV1; Offer\ndebounce: Debounce and distinct terms (N07)\ndebounce.term: P08; SearchTermStateV1; Require\ndebounce.query: P04; SearchGenerationV1; Offer\ndebounce.empty: P12; ClearSearchResultsV1; Offer\nrequest: Latest-search controller (N05)\nrequest.query: P04; SearchGenerationV1; Require\nrequest.fetch: P02; SearchGenerationResponseV1; Require\nrequest.result: P08; SearchResultStateV1; Offer\nrequest.clear: P12; ClearSearchResultsV1; Require\napi: Search API (N19)\napi.search: P02; SearchGenerationResponseV1; Offer\nsurface: Result Surface (N11)\nsurface.result: P08; SearchResultStateV1; Require\nterms (H02): source[0]=input.term; target[0]=debounce.term\nlatest (H04): publisher[0]=debounce.query; subscriber[0]=request.query\nfetch (H05): caller[0]=request.fetch; callee[0]=api.search\ndisplay (H02): source[0]=request.result; target[0]=surface.result\nempty (H03): source[0]=debounce.empty; target[0]=request.clear" }, { "id": "type-n08", "src": "/docs/img/theory/type-n08.svg", "alt": "N08 · Fork / join / scheduler — Build a dashboard from three services", "text": "Which data can load concurrently, and when is the page ready?\nA scheduler starts account, activity and recommendation reads concurrently. Account and activity are required for readiness; recommendations may produce a declared fallback. The readiness join is separate from the optional panel so one slow recommendation service does not block the whole screen.\nmedia\ndistributed systems\nworkflows\nChoose all/any/quorum semantics, including failure and abandoned branches.\nJoin failure and cancellation are explicit outcomes; parallel reads do not produce a consistent database snapshot automatically.\nload: Dashboard scheduler (N08)\nload.account: P02; AccountReadV1; Require\nload.activity: P02; ActivityReadV1; Require\nload.recommend: P02; RecommendationReadV1; Require\naccount: Account API (N19)\naccount.read: P02; AccountReadV1; Offer\naccount.done: P13; DashboardRequiredPartsV1; Offer\nactivity: Activity API (N19)\nactivity.read: P02; ActivityReadV1; Offer\nactivity.done: P13; DashboardRequiredPartsV1; Offer\nrecommend: Recommendations API (N19)\nrecommend.read: P02; RecommendationReadV1; Offer\nrecommend.panel: P08; RecommendationPanelStateV1; Offer\nready: Required-data join (N01)\nready.parts: P13; DashboardRequiredPartsV1; Require\nready.state: P08; DashboardReadyStateV1; Offer\nui: Dashboard Surface (N11)\nui.required: P08; DashboardReadyStateV1; Require\nui.optional: P08; RecommendationPanelStateV1; Require\naccount (H05): caller[0]=load.account; callee[0]=account.read\nactivity (H05): caller[0]=load.activity; callee[0]=activity.read\nrecommend (H05): caller[0]=load.recommend; callee[0]=recommend.read\nready (H09): source[0]=account.done; source[1]=activity.done; result[0]=ready.parts\ndisplay (H02): source[0]=ready.state; target[0]=ui.required\noptional (H02): source[0]=recommend.panel; target[0]=ui.optional" }, { "id": "type-n09", "src": "/docs/img/theory/type-n09.svg", "alt": "N09 · Timer / clock source — Expire an unpaid reservation", "text": "When does a held seat become available again?\nA deadline source emits an expiry candidate. The reservation authority compares the recorded deadline and revision before releasing the seat, because payment or renewal may have already changed it. A notification follows a release receipt.\nworkflows\ngames\nIoT\nDistinguish logical, event and wall clocks; inject clocks for replay.\nA clock event is a hint to recheck authority; clock drift and duplicate delivery must not release a paid reservation.\ntimer: Reservation deadline clock (N09)\ntimer.expired: P15; ReservationExpiryCandidateV1; Offer\ntimer.schedule: P01; ReservationDeadlineV1; Require\nreservation: Seat reservation authority (N21)\nreservation.expire: P15; ReservationExpiryCandidateV1; Require\nreservation.paid: P09; MarkReservationPaidAtVersionV1; Offer\nreservation.released: P04; ReservationReleasedV1; Offer\nreservation.deadline: P01; ReservationDeadlineV1; Offer\npayment: Payment completion (N02)\npayment.paid: P09; MarkReservationPaidAtVersionV1; Require\nnotify: Availability notification (N02)\nnotify.released: P04; ReservationReleasedV1; Require\nexpiry (H04): publisher[0]=timer.expired; subscriber[0]=reservation.expire\npaid (H05): caller[0]=payment.paid; callee[0]=reservation.paid\nreleased (H04): publisher[0]=reservation.released; subscriber[0]=notify.released\nschedule (H02): source[0]=reservation.deadline; target[0]=timer.schedule" }, { "id": "type-n10", "src": "/docs/img/theory/type-n10.svg", "alt": "N10 · Function / blueprint region — Reuse a conversation feature in two apps", "text": "How can the same feature run with different hosts?\nA blueprint region exports open-conversation, send and message-state interfaces. Mobile and desktop bind their own presentation and transport adapters to that boundary. Internal repository ownership remains explicit instead of exposing every implementation node.\nmobile\nweb\ncomposition\nStable exported interface; instantiate fresh owned state, not copied global identity.\nA blueprint definition is reusable; instances have separate runtime identities, subscriptions and lifecycle.\nfeature: Conversation blueprint (N10)\nfeature.mobile: P21; ConversationInstanceLifecycleV1; Neutral\nfeature.desktop: P21; ConversationInstanceLifecycleV1; Neutral\nfeature.resources: P21; ConversationResourceScopeV1; Offer\nfeature.send: P02; SendMessageRequestResponseV1; Require\nfeature.messages: P08; ConversationMessagesStateV1; Require\nrepo: Message repository (N21)\nrepo.scope: P21; ConversationResourceScopeV1; Require\nrepo.messages: P08; ConversationMessagesStateV1; Offer\nmobile: Mobile host (N27)\nmobile.conversation: P21; ConversationInstanceLifecycleV1; Neutral\ndesktop: Desktop host (N27)\ndesktop.conversation: P21; ConversationInstanceLifecycleV1; Neutral\nservice: Messaging service (N19)\nservice.send: P02; SendMessageRequestResponseV1; Offer\nmobile-instance (H20): factory[0]=feature.mobile; instance[0]=mobile.conversation\ndesktop-instance (H20): factory[0]=feature.desktop; instance[0]=desktop.conversation\nrepository (H19): owner[0]=feature.resources; resource[0]=repo.scope\nsend (H05): caller[0]=feature.send; callee[0]=service.send\nexport (H30): export[0]=repo.messages; import[0]=feature.messages" }, { "id": "type-n11", "src": "/docs/img/theory/type-n11.svg", "alt": "N11 · Surface / view component — Render loading, error and content states", "text": "How does a profile screen remain understandable while data loads?\nA Surface renders a sealed profile state and emits retry or edit intents. The interactor owns the loading transition and service request. Rendering can use Compose while the same common state and intents bind to a website presentation.\nmobile\nweb\ndesktop\nInteraction semantics are shared; native renderer behavior is qualified separately.\nA Surface is a presentation role, not a separate state authority or a guarantee that all targets implement identical widgets.\nui: Profile Surface (N11)\nui.view: P08; ProfileLoadingErrorContentV1; Require\nui.retry: P04; RetryProfileIntentV1; Offer\nui.edit: P11; EditProfileRouteIntentV1; Offer\nstate: Profile interactor (N05)\nstate.view: P08; ProfileLoadingErrorContentV1; Offer\nstate.retry: P04; RetryProfileIntentV1; Require\nstate.fetch: P02; GetProfileRequestResponseV1; Require\nservice: Profile service (N19)\nservice.get: P02; GetProfileRequestResponseV1; Offer\nroute: Edit-profile RouteNode (N12)\nroute.enter: P11; EditProfileRouteIntentV1; Require\nrender (H02): source[0]=state.view; target[0]=ui.view\nretry (H04): publisher[0]=ui.retry; subscriber[0]=state.retry\nfetch (H05): caller[0]=state.fetch; callee[0]=service.get\nedit (H36): source[0]=ui.edit; target[0]=route.enter" }, { "id": "type-n12", "src": "/docs/img/theory/type-n12.svg", "alt": "N12 · Route / navigation — Open a chat link and return an attachment", "text": "How does a deep link enter a nested screen and preserve the back result?\nThe link resolver validates a conversation ID, an access check selects sign-in or chat, and RouteNode exposes routeBinding and navBinding to Compose. The attachment picker returns a selected asset to chat through back(return), rather than writing a global navigation store.\nmobile\nweb\ndeep links\nMake route state, permissions and unsupported destinations explicit.\nRoute permission controls presentation; the messaging service must independently authorize every sensitive request.\nlink: Deep-link resolver (N15)\nlink.payload: P01; ConversationRoutePayloadV1; Offer\naccess: Conversation access decision (N03)\naccess.payload: P01; ConversationRoutePayloadV1; Require\naccess.signIn: P11; SignInRoutePayloadV1; Offer\naccess.chat: P11; ConversationRoutePayloadV1; Offer\nsignin: Sign-in RouteNode (N12)\nsignin.push: P11; SignInRoutePayloadV1; Require\nchat: Chat RouteNode (N12)\nchat.push: P11; ConversationRoutePayloadV1; Require\nchat.routeBinding: P08; RouteBindingConversationV1; Offer\nchat.attachment: P11; AttachmentPickerPayloadV1; Offer\nchat.attachmentResult: P01; SelectedAttachmentV1; Require\ncompose: Compose chat binding (N11)\ncompose.routeBinding: P08; RouteBindingConversationV1; Require\npicker: Attachment RouteNode (N12)\npicker.push: P11; AttachmentPickerPayloadV1; Require\npicker.return: P01; SelectedAttachmentV1; Offer\nintent (H02): source[0]=link.payload; target[0]=access.payload\ndenied (H36): source[0]=access.signIn; target[0]=signin.push\nallowed (H36): source[0]=access.chat; target[0]=chat.push\nrender (H30): export[0]=chat.routeBinding; import[0]=compose.routeBinding\nattachment (H36): source[0]=chat.attachment; target[0]=picker.push\nback-result (H36): source[0]=picker.return; target[0]=chat.attachmentResult" }, { "id": "type-n13", "src": "/docs/img/theory/type-n13.svg", "alt": "N13 · Input / interaction source — Turn drag gestures into an edit", "text": "When does moving a graph card become a saved layout change?\nPointer samples update a local drag preview. Pointer-up creates one layout proposal against the starting revision; cancellation discards the preview. The save authority validates that revision before producing a receipt.\nmobile\ndesktop\ngames\nDeclare focus, sampling, ordering and host lifecycle behavior.\nHigh-frequency samples are transient; a preview is not a persisted graph mutation.\npointer: Pointer interaction source (N13)\npointer.move: P04; PointerSampleV1; Offer\npointer.up: P04; DragFinishedV1; Offer\ndrag: Drag preview state (N05)\ndrag.move: P04; PointerSampleV1; Require\ndrag.position: P01; DraggedPositionAtRevisionV1; Offer\ndrag.cancel: P14; CancelDragV1; Require\nproposal: Layout edit proposal (N39)\nproposal.finish: P04; DragFinishedV1; Require\nproposal.position: P01; DraggedPositionAtRevisionV1; Require\nproposal.save: P09; LayoutCompareRevisionReceiptV1; Require\nlayout: Layout authority (N21)\nlayout.save: P09; LayoutCompareRevisionReceiptV1; Offer\ncancel: Escape key interaction (N13)\ncancel.escape: P14; CancelDragV1; Offer\nmove (H04): publisher[0]=pointer.move; subscriber[0]=drag.move\ncommit (H04): publisher[0]=pointer.up; subscriber[0]=proposal.finish\npreview (H02): source[0]=drag.position; target[0]=proposal.position\nsave (H05): caller[0]=proposal.save; callee[0]=layout.save\ncancel (H03): source[0]=cancel.escape; target[0]=drag.cancel" }, { "id": "type-n14", "src": "/docs/img/theory/type-n14.svg", "alt": "N14 · Form / validation region — Validate a signup form before creating an account", "text": "Which errors belong beside a field and which come from the server?\nThe form combines field validators into an accepted input. Local errors feed the Surface immediately; valid input invokes account creation. A server conflict becomes a distinct field error without losing the entered values.\nmobile\nweb\neditors\nKeep draft/invalid state saveable; effects require separately accepted values.\nClient validation improves feedback; the server repeats validation and uniqueness checks at its authority boundary.\nform: Signup form region (N14)\nform.email: P01; EmailCandidateV1; Offer\nform.password: P01; PasswordCandidateV1; Offer\nform.validated: P01; SignupFieldValidationV1; Require\nform.submit: P02; CreateAccountRequestResponseV1; Require\nform.state: P08; SignupFormStateV1; Offer\nform.edit: P04; SignupFieldEditV1; Require\nemail: Email validator (N01)\nemail.input: P01; EmailCandidateV1; Require\nemail.validated: P01; SignupFieldValidationV1; Offer\npassword: Password validator (N01)\npassword.input: P01; PasswordCandidateV1; Require\npassword.validated: P01; SignupFieldValidationV1; Offer\ncreate: Account creation service (N19)\ncreate.create: P02; CreateAccountRequestResponseV1; Offer\nui: Signup Surface (N11)\nui.state: P08; SignupFormStateV1; Require\nui.edit: P04; SignupFieldEditV1; Offer\nemail (H02): source[0]=form.email; target[0]=email.input\npassword (H02): source[0]=form.password; target[0]=password.input\nvalid (H09): source[0]=email.validated; source[1]=password.validated; result[0]=form.validated\nsubmit (H05): caller[0]=form.submit; callee[0]=create.create\nerrors (H02): source[0]=form.state; target[0]=ui.state\nedit (H04): publisher[0]=ui.edit; subscriber[0]=form.edit" }, { "id": "type-n15", "src": "/docs/img/theory/type-n15.svg", "alt": "N15 · Device / platform adapter — Ask for camera permission and capture a photo", "text": "How does common logic handle denied or unavailable device access?\nA platform adapter exposes permission and capture contracts. The controller chooses capture, settings guidance, or a file-picker fallback. Android and Darwin adapters implement the same declared outcomes without hiding platform permission transitions.\nmobile\nrobotics\nIoT\nNative implementation is bounded by OS permissions, affinity and installed capabilities.\nThe adapter names unavailable, denied and interrupted outcomes; a common declaration does not establish target parity.\ncontroller: Photo capture controller (N05)\ncontroller.permission: P02; CameraPermissionOutcomeV1; Require\ncontroller.outcome: P01; CameraPermissionOutcomeV1; Offer\ncontroller.capture: P12; BeginCameraCaptureV1; Require\ncontroller.photo: P02; CapturePhotoOutcomeV1; Require\ncontroller.state: P08; CaptureStateV1; Offer\ncamera: Device camera adapter (N15)\ncamera.permission: P02; CameraPermissionOutcomeV1; Offer\ncamera.capture: P02; CapturePhotoOutcomeV1; Offer\npermission: Permission decision (N03)\npermission.outcome: P01; CameraPermissionOutcomeV1; Require\npermission.allowed: P12; BeginCameraCaptureV1; Offer\npermission.pick: P02; PickImageOutcomeV1; Require\npicker: File picker fallback (N15)\npicker.pick: P02; PickImageOutcomeV1; Offer\nui: Capture Surface (N11)\nui.state: P08; CaptureStateV1; Require\npermission (H05): caller[0]=controller.permission; callee[0]=camera.permission\ndecide (H02): source[0]=controller.outcome; target[0]=permission.outcome\ncapture (H03): source[0]=permission.allowed; target[0]=controller.capture\nphoto (H05): caller[0]=controller.photo; callee[0]=camera.capture\nfallback (H05): caller[0]=permission.pick; callee[0]=picker.pick\ndisplay (H02): source[0]=controller.state; target[0]=ui.state" }, { "id": "type-n16", "src": "/docs/img/theory/type-n16.svg", "alt": "N16 · Native resource / engine — Encode video across a native boundary", "text": "Who owns the codec handle and frames while encoding runs?\nA codec resource owns the native handle. A session transfers frames under an ownership contract, receives encoded chunks, and drains before releasing the handle. Kotlin/common orchestration can bind through FFI; ABI, codecs and lifetime support must be qualified for each target.\nmedia\ngames\nFFI\nResource owner and release callback survive async calls; opaque internals stay declared.\nPassing an ownership label through JSON does not transfer a native allocation; the FFI adapter must enforce it.\ncamera: Frame source (N15)\ncamera.frame: P16; OwnedVideoFrameV1; Offer\nsession: Encoding session (N05)\nsession.frame: P16; OwnedVideoFrameV1; Require\nsession.encode: P16; OwnedCodecFrameV1; Require\nsession.complete: P13; EncoderDrainedV1; Require\ncodec: Native codec resource (N16)\ncodec.encode: P16; OwnedCodecFrameV1; Offer\ncodec.chunks: P06; EncodedChunkCreditStreamV1; Offer\ncodec.lifecycle: P21; CodecHandleLifecycleV1; Require\ncodec.drained: P13; EncoderDrainedV1; Offer\nupload: Encoded chunk upload (N02)\nupload.chunks: P06; EncodedChunkCreditStreamV1; Require\nlifecycle: Session lifecycle (N27)\nlifecycle.codec: P21; CodecHandleLifecycleV1; Offer\nframes (H02): source[0]=camera.frame; target[0]=session.frame\nencode (H05): caller[0]=session.encode; callee[0]=codec.encode\nchunks (H04): publisher[0]=codec.chunks; subscriber[0]=upload.chunks\nscope (H19): owner[0]=lifecycle.codec; resource[0]=codec.lifecycle\ndrain (H03): source[0]=codec.drained; target[0]=session.complete" }, { "id": "type-n17", "src": "/docs/img/theory/type-n17.svg", "alt": "N17 · Media transform — Create thumbnail and preview variants", "text": "How does an uploaded image produce several assets safely?\nA media transform decodes one source and produces bounded thumbnail and preview variants. Upload operations persist the outputs, then a manifest names the accepted digests. A failed variant is recorded explicitly rather than publishing an incomplete manifest as complete.\nmedia\nmobile\nweb\nSpecify memory domain, mutability, format and synchronization; zero-copy is conditional.\nMedia transform is a domain role; pure/effectful, memory and streaming behavior belong in its contracts.\nsource: Uploaded original (N26)\nsource.read: P02; GetImageBytesV1; Offer\ntransform: Image variant transform (N17)\ntransform.original: P02; GetImageBytesV1; Require\ntransform.thumbnail: P16; OwnedThumbnailBytesV1; Offer\ntransform.preview: P16; OwnedPreviewBytesV1; Offer\nthumb: Thumbnail upload (N02)\nthumb.bytes: P16; OwnedThumbnailBytesV1; Require\nthumb.receipt: P13; PersistedImageVariantsV1; Offer\npreview: Preview upload (N02)\npreview.bytes: P16; OwnedPreviewBytesV1; Require\npreview.receipt: P13; PersistedImageVariantsV1; Offer\nmanifest: Asset manifest authority (N21)\nmanifest.variants: P13; PersistedImageVariantsV1; Require\noriginal (H05): caller[0]=transform.original; callee[0]=source.read\nthumbnail (H02): source[0]=transform.thumbnail; target[0]=thumb.bytes\npreview (H02): source[0]=transform.preview; target[0]=preview.bytes\nmanifest (H09): source[0]=thumb.receipt; source[1]=preview.receipt; result[0]=manifest.variants" }, { "id": "type-n18", "src": "/docs/img/theory/type-n18.svg", "alt": "N18 · Model inference — Generate a cited answer with a model", "text": "What separates retrieved evidence, model output, and a publishable answer?\nA model consumes an authorized evidence cut and prompt. Citation validation compares its draft with the retrieved section identities before presentation. Tool execution is a separate admitted path, so generated text cannot silently invoke system operations.\nAI\nmobile\nanalytics\nPin model artifact and preprocessing; quality requires task-specific evidence.\nInference is a domain role, not inherently pure or trustworthy; citations and authorized tool effects require separate checks.\nretrieve: Principal-scoped retrieval (N22)\nretrieve.cut: P01; AuthorizedEvidenceCutV1; Offer\nretrieve.sources: P01; AuthorizedEvidenceCutV1; Offer\nmodel: Answer model inference (N18)\nmodel.evidence: P01; AuthorizedEvidenceCutV1; Require\nmodel.draft: P01; AnswerDraftWithCitationsV1; Offer\nmodel.proposal: P01; ToolCallProposalV1; Offer\ncitations: Citation validator (N01)\ncitations.draft: P01; AnswerDraftWithCitationsV1; Require\ncitations.sources: P01; AuthorizedEvidenceCutV1; Require\ncitations.answer: P08; ValidatedAnswerStateV1; Offer\nanswer: Manna answer Surface (N11)\nanswer.state: P08; ValidatedAnswerStateV1; Require\ntools: Admitted tool execution (N19)\ntools.proposal: P01; ToolCallProposalV1; Require\nevidence (H02): source[0]=retrieve.cut; target[0]=model.evidence\ndraft (H02): source[0]=model.draft; target[0]=citations.draft\nsources (H02): source[0]=retrieve.sources; target[0]=citations.sources\nanswer (H02): source[0]=citations.answer; target[0]=answer.state\nproposal (H02): source[0]=model.proposal; target[0]=tools.proposal" }, { "id": "type-n19", "src": "/docs/img/theory/type-n19.svg", "alt": "N19 · Tool / external API adapter — Send a notification through an external provider", "text": "How does a provider outage affect a user notification?\nAn adapter maps a typed notification command to the provider API, records provider receipts, and classifies retryable failures. A retry schedule shares the original idempotency key. Permanent failures enter a review queue instead of looping indefinitely.\ncommerce\nagents\nintegrations\nTreat credentials and external outcomes separately from local graph transactions.\nA successful API receipt may mean accepted, not delivered; provider-specific delivery evidence stays explicit.\nevents: Committed product event (N24)\nevents.command: P04; NotificationCommandV1; Offer\nadapter: Notification provider adapter (N19)\nadapter.command: P04; NotificationCommandV1; Require\nadapter.send: P02; ProviderNotificationReceiptV1; Require\nadapter.retryAt: P01; NotificationRetryAtV1; Offer\nadapter.retry: P15; RetryNotificationV1; Require\nadapter.failed: P04; NotificationFailureV1; Offer\nprovider: External notification provider (N30)\nprovider.send: P02; ProviderNotificationReceiptV1; Offer\nretry: Bounded retry clock (N09)\nretry.schedule: P01; NotificationRetryAtV1; Require\nretry.tick: P15; RetryNotificationV1; Offer\nfailed: Permanent failure review (N20)\nfailed.review: P04; NotificationFailureV1; Require\nnotify (H04): publisher[0]=events.command; subscriber[0]=adapter.command\nsend (H05): caller[0]=adapter.send; callee[0]=provider.send\nretry (H02): source[0]=adapter.retryAt; target[0]=retry.schedule\nretry-tick (H04): publisher[0]=retry.tick; subscriber[0]=adapter.retry\nfailed (H04): publisher[0]=adapter.failed; subscriber[0]=failed.review" }, { "id": "type-n20", "src": "/docs/img/theory/type-n20.svg", "alt": "N20 · Human decision / approval — Approve a destructive deployment", "text": "Which exact plan did a human approve?\nThe human participant receives a fingerprinted deployment plan and its effects. Approval is bound to that fingerprint and principal. Execution checks both again; a changed plan returns for review, and the receipt records the admitted operation.\nworkflows\nreleases\nmoderation\nHuman identity, scope, policy version and expiry are part of the decision.\nA chat confirmation or old approval does not authorize a different plan or principal.\nplan: Deployment plan (N35)\nplan.review: P01; DeploymentPlanFingerprintV1; Offer\nplan.execute: P01; DeploymentPlanFingerprintV1; Offer\nhuman: Operator approval (N20)\nhuman.review: P01; DeploymentPlanFingerprintV1; Require\nhuman.approval: P20; PlanBoundApprovalV1; Offer\npolicy: Approval policy (N33)\npolicy.approval: P20; PlanBoundApprovalV1; Require\npolicy.grant: P20; AdmittedDeploymentGrantV1; Offer\nexecute: Deployment executor (N40)\nexecute.grant: P20; AdmittedDeploymentGrantV1; Require\nexecute.plan: P01; DeploymentPlanFingerprintV1; Require\nexecute.receipt: P24; DeploymentExecutionReceiptV1; Offer\nreceipt: Execution receipt (N37)\nreceipt.record: P24; DeploymentExecutionReceiptV1; Require\nreview (H02): source[0]=plan.review; target[0]=human.review\ndecision (H02): source[0]=human.approval; target[0]=policy.approval\nadmit (H23): principal[0]=policy.grant; resource[0]=execute.grant\nplan (H02): source[0]=plan.execute; target[0]=execute.plan\nreceipt (H27): source[0]=execute.receipt; target[0]=receipt.record" }, { "id": "type-n21", "src": "/docs/img/theory/type-n21.svg", "alt": "N21 · Database / state authority — Prevent selling the last item twice", "text": "Where does stock mutation linearize?\nAn inventory authority owns the stock version. Two checkout attempts compete through conditional reservation calls; the accepted receipt identifies the winning revision. A stock-change event is emitted after commit and cannot replace the authoritative comparison.\ndata\ncommerce\nmessaging\nActual store profile determines isolation and durability; rows are not architecture nodes.\nThe database or serialized authority supplies atomicity; two lines into a node do not prove concurrency safety.\na: Checkout A (N06)\na.reserve: P09; ReserveStockCompareVersionV1; Require\nb: Checkout B (N06)\nb.reserve: P09; ReserveStockCompareVersionV1; Require\nstock: Inventory authority (N21)\nstock.reserveA: P09; ReserveStockCompareVersionV1; Offer\nstock.reserveB: P09; ReserveStockCompareVersionV1; Offer\nstock.changed: P04; StockCommittedV1; Offer\nfeed: Stock change topic (N24)\nfeed.changed: P04; StockCommittedV1; Require\nfeed.events: P04; StockCommittedV1; Offer\nview: Product availability view (N22)\nview.update: P04; StockCommittedV1; Require\na (H05): caller[0]=a.reserve; callee[0]=stock.reserveA\nb (H05): caller[0]=b.reserve; callee[0]=stock.reserveB\nchanged (H04): publisher[0]=stock.changed; subscriber[0]=feed.changed\nprojection (H04): publisher[0]=feed.events; subscriber[0]=view.update" }, { "id": "type-n22", "src": "/docs/img/theory/type-n22.svg", "alt": "N22 · Query / materialized view — Search a materialized order history", "text": "How fresh is a query view after an order changes?\nAn order projection consumes committed events with sequence positions. Search reads its indexed state and returns the applied source cut. The UI can show that lag or wait for a required position rather than presenting an eventual view as the authority.\ndata\nanalytics\nsearch\nDeclare source cut, freshness and dependency coverage; no unsound negative inference.\nProjection sequence and source revision are freshness evidence; receiving an event is not proof that all earlier events were applied.\norders: Order authority (N21)\norders.events: P04; OrderEventAtSequenceV1; Offer\nevents: Order event topic (N24)\nevents.publish: P04; OrderEventAtSequenceV1; Require\nevents.consume: P04; OrderEventAtSequenceV1; Offer\nindex: Order search projection (N22)\nindex.apply: P04; OrderEventAtSequenceV1; Require\nindex.query: P02; SearchOrdersWithAppliedCutV1; Offer\nsearch: Order history request (N19)\nsearch.query: P02; SearchOrdersWithAppliedCutV1; Require\nsearch.result: P08; OrderHistoryWithFreshnessV1; Offer\nui: Order history Surface (N11)\nui.state: P08; OrderHistoryWithFreshnessV1; Require\npublish (H04): publisher[0]=orders.events; subscriber[0]=events.publish\napply (H04): publisher[0]=events.consume; subscriber[0]=index.apply\nquery (H05): caller[0]=search.query; callee[0]=index.query\ndisplay (H02): source[0]=search.result; target[0]=ui.state" }, { "id": "type-n23", "src": "/docs/img/theory/type-n23.svg", "alt": "N23 · Transaction / unit of work — Commit an order and its outbox event together", "text": "Which writes share one transaction authority?\nA unit of work commits the order row and outbox row within one Postgres authority. A separate dispatcher publishes committed outbox entries and records delivery progress. Pub/Sub and payment providers stay outside the atomic scope.\ncommerce\ndata\nmessaging\nAtomicity applies only to the named authority and enlisted qualified resources.\nA transaction profile must name one authority and isolation behavior; external publication remains retryable and separately acknowledged.\ncheckout: Checkout request (N19)\ncheckout.place: P02; PlaceOrderRequestReceiptV1; Require\ntx: Order unit of work (N23)\ntx.place: P02; PlaceOrderRequestReceiptV1; Offer\ntx.transaction: P10; PostgresOrderOutboxTransactionV1; Offer\norder: Order table (N21)\norder.transaction: P10; PostgresOrderOutboxTransactionV1; Neutral\noutbox: Outbox table (N21)\noutbox.transaction: P10; PostgresOrderOutboxTransactionV1; Neutral\noutbox.read: P05; CommittedOutboxCursorV1; Offer\ndispatch: Outbox dispatcher (N02)\ndispatch.read: P05; CommittedOutboxCursorV1; Require\ndispatch.publish: P04; OrderPlacedEventV1; Offer\ntopic: GCP Pub/Sub topic (N24)\ntopic.publish: P04; OrderPlacedEventV1; Require\nplace (H05): caller[0]=checkout.place; callee[0]=tx.place\natomic (H16): authority[0]=tx.transaction; participant[0]=order.transaction; participant[1]=outbox.transaction\nread (H05): caller[0]=dispatch.read; callee[0]=outbox.read\npublish (H04): publisher[0]=dispatch.publish; subscriber[0]=topic.publish" }, { "id": "type-n24", "src": "/docs/img/theory/type-n24.svg", "alt": "N24 · Queue / log / pubsub resource — Deliver an order event to billing and analytics", "text": "Why do consumers need separate subscriptions?\nThe topic resource retains the event under its broker profile. Billing and analytics have independent subscriptions and acknowledgement positions. One slow consumer does not borrow the other consumer's receipt or imply its work completed.\ndistributed systems\nIoT\nmessaging\nDelivery, retention, offset, deduplication and redelivery laws belong to the provider.\nTopic, subscription and consumer are distinct identities; exactly-once delivery configurations do not make external business effects atomic.\norders: Order publisher (N02)\norders.publish: P04; OrderPlacedEventV1; Offer\ntopic: Order Pub/Sub topic (N24)\ntopic.events: P04; OrderPlacedEventV1; Neutral\ntopic.billing: P04; OrderPlacedEventV1; Offer\ntopic.analytics: P04; OrderPlacedEventV1; Offer\nbilling: Billing subscription (N24)\nbilling.events: P04; OrderPlacedEventV1; Neutral\nbilling.ack: P03; BillingSubscriptionAckV1; Offer\nanalytics: Analytics subscription (N24)\nanalytics.events: P04; OrderPlacedEventV1; Neutral\nanalytics.ack: P03; AnalyticsSubscriptionAckV1; Offer\ninvoice: Invoice worker (N06)\ninvoice.events: P04; OrderPlacedEventV1; Require\ninvoice.ack: P03; BillingSubscriptionAckV1; Require\nmetrics: Analytics projection (N22)\nmetrics.events: P04; OrderPlacedEventV1; Require\nmetrics.ack: P03; AnalyticsSubscriptionAckV1; Require\npublish (H04): publisher[0]=orders.publish; broker[0]=topic.events\nbilling (H04): publisher[0]=topic.billing; subscription[0]=billing.events; subscriber[0]=invoice.events\nanalytics (H04): publisher[0]=topic.analytics; subscription[0]=analytics.events; subscriber[0]=metrics.events\nbill-ack (H05): caller[0]=invoice.ack; callee[0]=billing.ack\nanalytics-ack (H05): caller[0]=metrics.ack; callee[0]=analytics.ack" }, { "id": "type-n25", "src": "/docs/img/theory/type-n25.svg", "alt": "N25 · Cache / replica / sync agent — Sync offline profile edits without losing changes", "text": "What happens when two devices edit the same profile?\nA sync agent keeps a local versioned draft and pending operation IDs. The server compares the base revision; a conflict is merged or shown explicitly before a new attempt. Accepted state updates the cache and pending queue together under their local storage contract.\nmobile\nweb\ndistributed systems\nSpecify merge/conflict policy and deletion semantics; not every invariant permits CRDT merge.\nA sync role does not choose a conflict algorithm; deletion, retries and server authority need explicit contracts.\neditor: Profile editor (N11)\neditor.edit: P04; ProfileDraftEditV1; Offer\neditor.state: P08; ProfileSyncStateV1; Require\nsync: Offline profile sync (N25)\nsync.edit: P04; ProfileDraftEditV1; Require\nsync.persist: P09; LocalDraftPendingWriteV1; Require\nsync.push: P09; ProfileBaseRevisionWriteV1; Require\nsync.conflict: P01; ProfileThreeWayConflictV1; Offer\nsync.retry: P01; MergedProfileCandidateV1; Require\nsync.state: P08; ProfileSyncStateV1; Offer\nlocal: Local draft and pending writes (N21)\nlocal.write: P09; LocalDraftPendingWriteV1; Offer\nserver: Profile service authority (N21)\nserver.write: P09; ProfileBaseRevisionWriteV1; Offer\nmerge: Profile conflict decision (N03)\nmerge.conflict: P01; ProfileThreeWayConflictV1; Require\nmerge.candidate: P01; MergedProfileCandidateV1; Offer\nedit (H04): publisher[0]=editor.edit; subscriber[0]=sync.edit\npersist (H05): caller[0]=sync.persist; callee[0]=local.write\npush (H05): caller[0]=sync.push; callee[0]=server.write\nconflict (H02): source[0]=sync.conflict; target[0]=merge.conflict\nretry (H02): source[0]=merge.candidate; target[0]=sync.retry\nrender (H02): source[0]=sync.state; target[0]=editor.state" }, { "id": "type-n26", "src": "/docs/img/theory/type-n26.svg", "alt": "N26 · Blob / buffer / asset store — Download a large attachment in resumable chunks", "text": "How can a client resume without trusting partial bytes?\nThe object store supplies ranged bytes for an immutable digest and size. A downloader records verified chunks and only publishes the attachment when the whole digest matches. Local chunk storage and presentation are separate resources.\nmedia\nAI\nShadow\nGraph stores descriptors and controlled references; large payloads remain in their owner.\nA blob reference identifies bytes and access policy; it does not prove they are loaded, intact, or safe to decode.\nstore: Attachment object store (N26)\nstore.range: P02; DigestBoundByteRangeV1; Offer\ndownload: Resumable downloader (N04)\ndownload.range: P02; DigestBoundByteRangeV1; Require\ndownload.save: P09; VerifiedChunkWriteV1; Require\ndownload.state: P08; AttachmentDownloadStateV1; Offer\nchunks: Verified local chunks (N26)\nchunks.write: P09; VerifiedChunkWriteV1; Offer\nchunks.view: P17; AssembledAttachmentViewV1; Offer\ndigest: Attachment digest check (N01)\ndigest.bytes: P17; AssembledAttachmentViewV1; Require\ndigest.verified: P01; VerifiedAttachmentRefV1; Offer\nui: Attachment Surface (N11)\nui.attachment: P01; VerifiedAttachmentRefV1; Require\nui.progress: P08; AttachmentDownloadStateV1; Require\nrange (H05): caller[0]=download.range; callee[0]=store.range\nsave (H05): caller[0]=download.save; callee[0]=chunks.write\nassemble (H02): source[0]=chunks.view; target[0]=digest.bytes\nverified (H02): source[0]=digest.verified; target[0]=ui.attachment\nprogress (H02): source[0]=download.state; target[0]=ui.progress" }, { "id": "type-n27", "src": "/docs/img/theory/type-n27.svg", "alt": "N27 · Runtime host / executor — Run the same service locally and remotely", "text": "What changes when a service is hosted in another process?\nA runtime host binds the common service contract to a local implementation or a serialized remote endpoint. The request handler and owned resources share an activation lifecycle, while client deadlines and authority cross the adapter boundary explicitly.\nmobile\nweb\nFFI\nExpose an installed capability descriptor and lifetime; target name alone is insufficient.\nA host node describes execution placement and lifecycle; an inspected definition does not establish a live healthy activation.\nclient: Service caller (N02)\nclient.send: P02; SendMessageRequestResponseV1; Require\nhost: JVM service host (N27)\nhost.scope: P21; ServiceActivationScopeV1; Offer\nhandler: Messaging handler (N19)\nhandler.send: P02; SendMessageRequestResponseV1; Offer\nhandler.lifecycle: P21; ServiceActivationScopeV1; Require\nhandler.persist: P02; AppendMessageAtRevisionV1; Require\ndatabase: Message authority (N21)\ndatabase.lifecycle: P21; ServiceActivationScopeV1; Require\ndatabase.append: P02; AppendMessageAtRevisionV1; Offer\nadapter: HTTP serialization adapter (N15)\nadapter.send: P02; SendMessageRequestResponseV1; Offer\nadapter.handler: P02; SendMessageRequestResponseV1; Require\nrequest (H05): caller[0]=client.send; callee[0]=adapter.send\nhandler (H01): provider[0]=handler.send; consumer[0]=adapter.handler\nhost (H19): owner[0]=host.scope; resource[0]=handler.lifecycle; resource[1]=database.lifecycle\npersist (H05): caller[0]=handler.persist; callee[0]=database.append" }, { "id": "type-n28", "src": "/docs/img/theory/type-n28.svg", "alt": "N28 · Placement / resource pool — Place replicas across failure domains", "text": "Which replicas may run together?\nA resource pool offers candidate hosts with capacity and zone identities. A placement plan selects hosts for service replicas while separation constraints exclude correlated failure domains. Admission checks capacity and compatibility before activation.\ndistributed systems\ncloud\nrobotics\nHard constraints precede optimization; placement is not proof of current availability.\nPlacement and separation constraints neither start replicas nor establish replication consistency.\npool: Regional worker pool (N28)\npool.capacity: P19; HostCapacitySnapshotV1; Offer\npool.plan: P01; PlacementAdmissionPlanV1; Require\nzoneA: Zone A host (N27)\nzoneA.placement: P19; ReplicaHostPlacementV1; Neutral\nzoneB: Zone B host (N27)\nzoneB.placement: P19; ReplicaHostPlacementV1; Neutral\nreplicaA: Service replica A (N27)\nreplicaA.placement: P19; ReplicaHostPlacementV1; Neutral\nreplicaA.zone: P19; DistinctZoneConstraintV1; Neutral\nreplicaB: Service replica B (N27)\nreplicaB.placement: P19; ReplicaHostPlacementV1; Neutral\nreplicaB.zone: P19; DistinctZoneConstraintV1; Neutral\nplan: Placement decision (N03)\nplan.capacity: P19; HostCapacitySnapshotV1; Require\nplan.admitted: P01; PlacementAdmissionPlanV1; Offer\ncapacity (H02): source[0]=pool.capacity; target[0]=plan.capacity\nplace-a (H21): subject[0]=replicaA.placement; host[0]=zoneA.placement\nplace-b (H21): subject[0]=replicaB.placement; host[0]=zoneB.placement\nseparate (H22): member[0]=replicaA.zone; member[1]=replicaB.zone\nadmit (H02): source[0]=plan.admitted; target[0]=pool.plan" }, { "id": "type-n29", "src": "/docs/img/theory/type-n29.svg", "alt": "N29 · Factory / dynamic instance — Create one actor per active conversation", "text": "How are dynamic instances created and retired?\nA factory maps a conversation key to one admitted actor activation. Duplicate open requests resolve the same active lease; idle expiry drains the instance and releases its resources. Definition identity remains stable while activation identities change.\ngames\ntenancy\nactors\nSeparate reusable definition from dynamic instance identity and bounded registry visibility.\nA factory must fence competing activations; a key-to-definition mapping is not an exactly-one-live-instance proof.\nroute: Conversation routes (N12)\nroute.open: P02; OpenConversationActivationV1; Require\nfactory: Conversation actor factory (N29)\nfactory.open: P02; OpenConversationActivationV1; Offer\nfactory.lease: P09; ConversationActivationLeaseV1; Require\nfactory.create: P21; ConversationActorInstanceV1; Neutral\nfactory.expire: P15; ConversationIdleCandidateV1; Require\nfactory.drain: P21; DrainConversationActivationV1; Offer\nregistry: Activation lease registry (N21)\nregistry.lease: P09; ConversationActivationLeaseV1; Offer\nactor: Conversation actor instance (N05)\nactor.lifecycle: P21; ConversationActorInstanceV1; Neutral\nactor.drain: P21; DrainConversationActivationV1; Require\nidle: Idle deadline (N09)\nidle.tick: P15; ConversationIdleCandidateV1; Offer\nopen (H05): caller[0]=route.open; callee[0]=factory.open\nlease (H05): caller[0]=factory.lease; callee[0]=registry.lease\ninstantiate (H20): factory[0]=factory.create; instance[0]=actor.lifecycle\nidle (H04): publisher[0]=idle.tick; subscriber[0]=factory.expire\ndrain (H03): source[0]=factory.drain; target[0]=actor.drain" }, { "id": "type-n30", "src": "/docs/img/theory/type-n30.svg", "alt": "N30 · External system boundary — Handle a payment webhook", "text": "How does a foreign event become an internal command?\nThe external boundary identifies provider ownership, signature and API version. Verification rejects invalid webhooks before idempotent payment reconciliation. Accepted state emits an internal event; foreign payloads remain linked as evidence rather than becoming trusted application state.\nintegrations\nFFI\nIoT\nExpose integration coverage honestly; graph visibility does not sandbox external code.\nA boundary makes opaque implementation explicit; it does not make foreign behavior reconstructible or trustworthy.\nprovider: Payment provider boundary (N30)\nprovider.webhook: P04; SignedPaymentWebhookV2; Offer\nverify: Webhook signature verifier (N01)\nverify.webhook: P04; SignedPaymentWebhookV2; Require\nverify.accepted: P01; VerifiedPaymentEventV1; Offer\nreconcile: Payment reconciliation (N06)\nreconcile.event: P01; VerifiedPaymentEventV1; Require\nreconcile.apply: P09; IdempotentPaymentStateUpdateV1; Require\npayment: Payment authority (N21)\npayment.apply: P09; IdempotentPaymentStateUpdateV1; Offer\npayment.events: P04; PaymentCommittedV1; Offer\nevents: Payment event topic (N24)\nevents.publish: P04; PaymentCommittedV1; Require\nwebhook (H04): publisher[0]=provider.webhook; subscriber[0]=verify.webhook\naccepted (H02): source[0]=verify.accepted; target[0]=reconcile.event\napply (H05): caller[0]=reconcile.apply; callee[0]=payment.apply\ncommitted (H04): publisher[0]=payment.events; subscriber[0]=events.publish" }, { "id": "type-n31", "src": "/docs/img/theory/type-n31.svg", "alt": "N31 · Schema / contract definition — Evolve a service response without breaking old clients", "text": "Which clients accept a new field or changed representation?\nA contract definition binds schema revision, compatibility policy and codec artifacts. The compatibility check compares the proposed contract with supported client decoders before a release. Source linkage is distinct from operational health.\nservices\nFFI\ndata\nRepresent as a node when independently referenced; otherwise keep it a typed value/facet.\nContract equality by string is only an identifier check; semantic compatibility needs a versioned verifier and target evidence.\nschema: Messaging contract schema (N31)\nschema.old: P23; MessagingSchemaDigestV1; Offer\nschema.next: P23; MessagingSchemaDigestV2; Offer\nold: Supported mobile decoder (N34)\nold.schema: P23; MessagingSchemaDigestV1; Require\nold.evidence: P24; MessagingCodecCompatibilityEvidenceV1; Offer\nnext: Candidate server encoder (N34)\nnext.schema: P23; MessagingSchemaDigestV2; Require\nnext.evidence: P24; MessagingCodecCompatibilityEvidenceV1; Offer\ncheck: Compatibility check (N01)\ncheck.evidence: P24; MessagingCodecCompatibilityEvidenceV1; Require\ncheck.result: P24; SupportedClientCompatibilityClaimV1; Offer\nrelease: Service release manifest (N35)\nrelease.compatibility: P24; SupportedClientCompatibilityClaimV1; Require\nold (H26): artifact[0]=schema.old; consumer[0]=old.schema\nnext (H26): artifact[0]=schema.next; consumer[0]=next.schema\ncompatibility (H09): source[0]=old.evidence; source[1]=next.evidence; result[0]=check.evidence\nadmit (H28): evidence[0]=check.result; claim[0]=release.compatibility" }, { "id": "type-n32", "src": "/docs/img/theory/type-n32.svg", "alt": "N32 · Capability offer / requirement — Choose an available video encoder", "text": "What can this host actually encode?\nCapability offers list formats, dimensions and resource limits. A requirement selects an offer compatible with the task and host. The selected implementation is then bound to the encoding request; discovery does not grant camera or file access.\nmobile\nAI\nplatforms\nAvailability and suitability do not confer authority; selection is context-scoped.\nCapability, implementation choice and authority are separate; an advertised format still needs a qualified adapter.\nrequirement: Video encoding requirement (N32)\nrequirement.codec: P19; VideoCodecCapabilityV1; Require\nnative: Native hardware codec offer (N32)\nnative.codec: P19; VideoCodecCapabilityV1; Offer\nnative.preference: P19; CodecPreferenceWithFallbackV1; Offer\nsoftware: Software codec offer (N32)\nsoftware.codec: P19; VideoCodecCapabilityV1; Offer\nsoftware.preference: P19; CodecPreferenceWithFallbackV1; Offer\nresolve: Capability resolver (N03)\nresolve.codec: P19; VideoCodecCapabilityV1; Neutral\nresolve.selected: P01; SelectedCodecBindingV1; Offer\nresolve.preference: P19; CodecPreferenceWithFallbackV1; Require\nsession: Video session (N05)\nsession.codec: P01; SelectedCodecBindingV1; Require\nresolve (H24): requirement[0]=requirement.codec; offer[0]=native.codec; offer[1]=software.codec; resolver[0]=resolve.codec\nselected (H02): source[0]=resolve.selected; target[0]=session.codec\nfallback (H33): candidate[0]=native.preference; candidate[1]=software.preference; result[0]=resolve.preference" }, { "id": "type-n33", "src": "/docs/img/theory/type-n33.svg", "alt": "N33 · Policy / principal boundary — Authorize a private conversation read", "text": "Which conversation may this principal inspect?\nThe policy evaluates principal, workspace and conversation membership for the specific read. A grant names the allowed resource and revision scope; retrieval filters before returning evidence. A reduced graph view uses that result but cannot replace service-side enforcement.\nauth\nagents\ntenancy\nSecrets stay out of graph payloads; current effect-time authority is rechecked.\nPrincipal identity is data; the policy is a decision/authority role. Neither should become an ambient universal visibility flag.\nprincipal: Authenticated request context adapter (N15)\nprincipal.context: P01; PrincipalWorkspaceContextV1; Offer\npolicy: Conversation access policy (N33)\npolicy.context: P01; PrincipalWorkspaceContextV1; Require\npolicy.membership: P02; ConversationMembershipReadV1; Require\npolicy.grant: P20; ConversationReadScopeGrantV1; Offer\nmembership: Membership authority (N21)\nmembership.read: P02; ConversationMembershipReadV1; Offer\nretrieval: Conversation evidence query (N22)\nretrieval.grant: P20; ConversationReadScopeGrantV1; Require\nretrieval.cut: P01; AuthorizedConversationCutV1; Offer\nsurface: Authorized conversation view (N11)\nsurface.cut: P01; AuthorizedConversationCutV1; Require\nidentity (H02): source[0]=principal.context; target[0]=policy.context\nmembership (H05): caller[0]=policy.membership; callee[0]=membership.read\ngrant (H23): principal[0]=policy.grant; resource[0]=retrieval.grant\nread (H02): source[0]=retrieval.cut; target[0]=surface.cut" }, { "id": "type-n34", "src": "/docs/img/theory/type-n34.svg", "alt": "N34 · Build / compiler pass — Compile one common graph for two targets", "text": "Which generated bytes belong to which source revision?\nThe compiler pass consumes common Kotlin and contract references, then produces Kotlin/JS and native artifacts through target toolchains. Target checks attach evidence to each digest. Compilation and adapter qualification remain distinct claims.\nbuild\ncompilers\ncode push\nKey caches by semantic inputs and toolchain; preserve source maps and qualification profile.\nA common source path does not prove native and JS codec, FFI or runtime behavior is equivalent.\nsource: Common Kotlin graph source (N35)\nsource.digest: P23; CommonKotlinSourceDigestV1; Offer\ncompile: Graph compiler pass (N34)\ncompile.source: P23; CommonKotlinSourceDigestV1; Require\ncompile.outputs: P23; TargetArtifactProvenanceV1; Offer\njs: Kotlin JS artifact (N35)\njs.provenance: P23; TargetArtifactProvenanceV1; Require\njs.digest: P23; JsArtifactDigestV1; Offer\nnative: Native artifact (N35)\nnative.provenance: P23; TargetArtifactProvenanceV1; Require\nnative.digest: P23; NativeArtifactDigestV1; Offer\nchecks: Target qualification checks (N36)\nchecks.js: P23; JsArtifactDigestV1; Require\nchecks.native: P23; NativeArtifactDigestV1; Require\nsource (H26): artifact[0]=source.digest; consumer[0]=compile.source\noutputs (H27): source[0]=compile.outputs; target[0]=js.provenance; target[1]=native.provenance\njs-check (H26): artifact[0]=js.digest; consumer[0]=checks.js\nnative-check (H26): artifact[0]=native.digest; consumer[0]=checks.native" }, { "id": "type-n35", "src": "/docs/img/theory/type-n35.svg", "alt": "N35 · Artifact / release manifest — Publish a reproducible release manifest", "text": "How can a deployment identify the exact code and contracts?\nThe manifest binds artifact digests, definition revision, state schema and target evidence. Admission reads those identities and rejects missing required evidence. A release name alone cannot stand in for its bytes or activation receipt.\nreleases\ncode push\ncloud\nStable identity differs from content digest; exclude cosmetic layout from semantic identity.\nManifest completeness and signed provenance are separate from a successful runtime activation.\nartifact: Built service artifact (N35)\nartifact.ref: P23; ReleaseDependencyRefsV1; Offer\nschema: State schema (N31)\nschema.ref: P23; ReleaseDependencyRefsV1; Offer\ntests: Target test evidence (N37)\ntests.record: P24; ReleaseQualificationEvidenceV1; Offer\ntests.cut: P24; ReleaseEvidenceCutV1; Offer\nmanifest: Release manifest (N35)\nmanifest.dependencies: P23; ReleaseDependencyRefsV1; Require\nmanifest.qualification: P24; ReleaseQualificationEvidenceV1; Require\nmanifest.ref: P23; DigestBoundReleaseManifestV1; Offer\nadmission: Release admission (N03)\nadmission.candidate: P23; DigestBoundReleaseManifestV1; Require\nadmission.evidence: P24; ReleaseEvidenceCutV1; Require\ninputs (H26): artifact[0]=artifact.ref; artifact[1]=schema.ref; consumer[0]=manifest.dependencies\nevidence (H28): evidence[0]=tests.record; claim[0]=manifest.qualification\ncandidate (H02): source[0]=manifest.ref; target[0]=admission.candidate\nverified (H02): source[0]=tests.cut; target[0]=admission.evidence" }, { "id": "type-n36", "src": "/docs/img/theory/type-n36.svg", "alt": "N36 · Test / Shadow scenario — Reproduce a failed send with Shadow data", "text": "What can a debugger replay without contacting production?\nA Shadow scenario binds a captured request, its state cut and adapter responses to a selected flow. Replay uses isolated effect adapters and produces a comparison finding. The debugger can inspect source-mapped steps while any live effect needs new admission.\ntesting\ndebugging\nShadow\nRecord assumptions, capture gaps and runner; no generic green-check guarantee.\nA replay result is bounded by capture coverage and substituted adapters; it is not proof of all production behavior.\ncapture: Captured send evidence (N37)\ncapture.ref: P23; CapturedSendCapsuleRefV1; Offer\ncapture.observed: P24; CapturedSendObservationV1; Offer\nscenario: Shadow send scenario (N36)\nscenario.capture: P23; CapturedSendCapsuleRefV1; Require\nscenario.restore: P22; ShadowStateRestoreV1; Require\nscenario.start: P11; ShadowSendInvocationV1; Offer\nstate: Shadow message state (N21)\nstate.restore: P22; ShadowStateRestoreV1; Offer\nstate.send: P02; ShadowMessageAuthorityV1; Offer\nsend: Messaging flow under test (N06)\nsend.start: P11; ShadowSendInvocationV1; Require\nsend.store: P02; ShadowMessageAuthorityV1; Require\nsend.observed: P24; SendReplayComparisonV1; Offer\ncompare: Replay comparison (N38)\ncompare.observed: P24; SendReplayComparisonV1; Require\ncompare.expected: P24; CapturedSendObservationV1; Require\ncapture (H26): artifact[0]=capture.ref; consumer[0]=scenario.capture\nrestore (H05): caller[0]=scenario.restore; callee[0]=state.restore\nexecute (H03): source[0]=scenario.start; target[0]=send.start\nadapters (H01): provider[0]=state.send; consumer[0]=send.store\nfinding (H27): source[0]=send.observed; target[0]=compare.observed\nexpected (H02): source[0]=capture.observed; target[0]=compare.expected" }, { "id": "type-n37", "src": "/docs/img/theory/type-n37.svg", "alt": "N37 · Claim / evidence record — Explain why a release is considered qualified", "text": "Which observation supports the claim, at what scope?\nEvidence records target, revision, command, time and coverage. The qualification claim cites that evidence and its assumptions. A dashboard shows stale or partial records directly; it cannot turn a missing result into a green health indicator.\nverification\ntelemetry\nreleases\nEvidence is claim-indexed, not a universal ordered strength score.\nEvidence and claims are records with distinct meanings; support is not implication beyond recorded assumptions and coverage.\nrun: Target test run (N36)\nrun.receipt: P24; TargetRunReceiptV1; Offer\nrecord: Qualification evidence record (N37)\nrecord.receipt: P24; TargetRunReceiptV1; Require\nrecord.support: P24; RevisionTargetCoverageEvidenceV1; Offer\nclaim: Target qualification claim (N37)\nclaim.support: P24; RevisionTargetCoverageEvidenceV1; Require\nclaim.state: P08; QualificationTruthStateV1; Offer\ndashboard: Release evidence Surface (N11)\ndashboard.state: P08; QualificationTruthStateV1; Require\nrecord (H27): source[0]=run.receipt; target[0]=record.receipt\nsupports (H28): evidence[0]=record.support; claim[0]=claim.support\ndisplay (H02): source[0]=claim.state; target[0]=dashboard.state" }, { "id": "type-n38", "src": "/docs/img/theory/type-n38.svg", "alt": "N38 · Observer / query / visitor — Measure the latency of sending a message", "text": "Which spans belong to one product flow?\nA bounded visitor selects client invocation, service handling and storage receipt observations linked by context. It reports duration, missing segments and clock assumptions. The visitor reads a cut; enabling new instrumentation is a separate admitted change.\ninspection\ntelemetry\ndebugging\nInspection cannot mutate implicitly; coverage and authority limit conclusions.\nA graph dependency walk is not automatically a causal trace; missing context and clock uncertainty must remain visible.\nclient: Mobile send invocation (N02)\nclient.send: P02; SendMessageRequestResponseV1; Require\nclient.span: P24; SendFlowSpanCutV1; Offer\nservice: Messaging service (N19)\nservice.send: P02; SendMessageRequestResponseV1; Offer\nservice.store: P02; AppendMessageAtRevisionV1; Require\nservice.span: P24; SendFlowSpanCutV1; Offer\nstore: Message authority (N21)\nstore.append: P02; AppendMessageAtRevisionV1; Offer\nstore.span: P24; SendFlowSpanCutV1; Offer\nvisitor: End-to-end latency visitor (N38)\nvisitor.cut: P24; SendFlowSpanCutV1; Require\nvisitor.finding: P24; LatencyWithCoverageFindingV1; Offer\nreport: Latency report (N37)\nreport.finding: P24; LatencyWithCoverageFindingV1; Require\nsend (H05): caller[0]=client.send; callee[0]=service.send\nstore (H05): caller[0]=service.store; callee[0]=store.append\nobservations (H27): source[0]=client.span; source[1]=service.span; source[2]=store.span; target[0]=visitor.cut\nfinding (H02): source[0]=visitor.finding; target[0]=report.finding" }, { "id": "type-n39", "src": "/docs/img/theory/type-n39.svg", "alt": "N39 · Agent / change proposer — Propose a safe graph edit from an agent", "text": "How does a suggested change become a reviewable patch?\nAn agent consumes an authorized definition snapshot and produces a typed patch with a base revision. Normalization and validation build a fingerprinted plan. Approval and execution use the same path as human changes; model output alone carries no mutation authority.\nagents\ndevelopment\nreview\nDrafts are not deployment; effective tool/OS authority must be controlled or disclosed.\nAgent is a domain role composed from inference and proposal logic, not a privileged kernel node class.\nsnapshot: Authorized definition snapshot (N35)\nsnapshot.cut: P01; AuthorizedDefinitionCutV1; Offer\nagent: Agent change proposer (N39)\nagent.context: P01; AuthorizedDefinitionCutV1; Require\nagent.patch: P01; GraphPatchAtBaseRevisionV1; Offer\nvalidate: Patch validation (N01)\nvalidate.patch: P01; GraphPatchAtBaseRevisionV1; Require\nvalidate.plan: P01; FingerprintPlanV1; Offer\nvalidate.admittedPlan: P01; FingerprintPlanV1; Offer\nreview: Human plan approval (N20)\nreview.plan: P01; FingerprintPlanV1; Require\nreview.grant: P20; PlanBoundPatchGrantV1; Offer\nexecute: Admitted patch execution (N40)\nexecute.grant: P20; PlanBoundPatchGrantV1; Require\nexecute.plan: P01; FingerprintPlanV1; Require\ncontext (H02): source[0]=snapshot.cut; target[0]=agent.context\npatch (H02): source[0]=agent.patch; target[0]=validate.patch\nplan (H02): source[0]=validate.plan; target[0]=review.plan\napproval (H23): principal[0]=review.grant; resource[0]=execute.grant\nexecute (H02): source[0]=validate.admittedPlan; target[0]=execute.plan" }, { "id": "type-n40", "src": "/docs/img/theory/type-n40.svg", "alt": "N40 · Deployment / migration controller — Replace a service without losing in-flight work", "text": "When is a candidate activation safe to receive traffic?\nA deployment controller prepares the candidate, checks schema and target evidence, drains the old activation, and switches a fenced route. A failed migration leaves a recorded state and may require forward repair; old code availability alone is not rollback safety.\nreleases\ncode push\ndistributed systems\nDurable reconciliation; monotonic fencing epochs and explicit mixed-version policy.\nLifecycle, state migration and route fencing are separate contracts; a drawn controller does not implement universal code push.\ncontroller: Service migration controller (N40)\ncontroller.prepare: P21; PrepareServiceActivationV1; Offer\ncontroller.drain: P21; DrainServiceActivationV1; Offer\ncontroller.evidence: P24; CandidateAdmissionEvidenceV1; Require\ncontroller.switch: P09; CompareRouteEpochV1; Require\nold: Old service activation (N27)\nold.drain: P21; DrainServiceActivationV1; Require\nold.handoff: P22; ServiceEpochHandoffV1; Neutral\nnext: Candidate service activation (N27)\nnext.prepare: P21; PrepareServiceActivationV1; Require\nnext.restore: P22; ServiceStateMigrationV2; Require\nnext.handoff: P22; ServiceEpochHandoffV1; Neutral\nstate: Service state authority (N21)\nstate.migrate: P22; ServiceStateMigrationV2; Offer\nrouter: Epoch-fenced service router (N15)\nrouter.epoch: P22; ServiceEpochHandoffV1; Offer\nrouter.switch: P09; CompareRouteEpochV1; Offer\nevidence: Admission evidence (N37)\nevidence.cut: P24; CandidateAdmissionEvidenceV1; Offer\nprepare (H03): source[0]=controller.prepare; target[0]=next.prepare\ndrain (H03): source[0]=controller.drain; target[0]=old.drain\nrestore (H05): caller[0]=next.restore; callee[0]=state.migrate\ncheck (H02): source[0]=evidence.cut; target[0]=controller.evidence\nswitch (H35): old[0]=old.handoff; new[0]=next.handoff; authority[0]=router.epoch\nroute (H05): caller[0]=controller.switch; callee[0]=router.switch" } ], "title": "Nodes", "nav": "Nodes", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory", "revision": "20a95e71c410260917e08a64c4deae08d9da8f3551244d0c453e435710227934", "status": "design", "renderingRevision": "39d9192c12331af7af103896851a81d656ec68ee83d84823968a30c866286ba1", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "node-families-are-an-open-vocabulary", "port-algebra-independent-dimensions", "cardinality-and-lifetime", "current-source-boundary" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory", "polarity": "Neutral" }, { "id": "section-node-families-are-an-open-vocabulary", "anchor": "node-families-are-an-open-vocabulary", "label": "node-families-are-an-open-vocabulary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#node-families-are-an-open-vocabulary", "polarity": "Neutral" }, { "id": "section-port-algebra-independent-dimensions", "anchor": "port-algebra-independent-dimensions", "label": "port-algebra-independent-dimensions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#port-algebra-independent-dimensions", "polarity": "Neutral" }, { "id": "section-cardinality-and-lifetime", "anchor": "cardinality-and-lifetime", "label": "cardinality-and-lifetime", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#cardinality-and-lifetime", "polarity": "Neutral" }, { "id": "section-current-source-boundary", "anchor": "current-source-boundary", "label": "current-source-boundary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#current-source-boundary", "polarity": "Neutral" }, { "id": "type-n01", "anchor": "type-n01", "label": "N01 · Pure computation — Rank a feed without fetching data", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n01", "polarity": "Neutral" }, { "id": "type-n02", "anchor": "type-n02", "label": "N02 · Effectful operation — Upload a profile photo", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n02", "polarity": "Neutral" }, { "id": "type-n03", "anchor": "type-n03", "label": "N03 · Decision / pattern match — Choose the next onboarding screen", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n03", "polarity": "Neutral" }, { "id": "type-n04", "anchor": "type-n04", "label": "N04 · Loop / recursive region — Load more search results", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n04", "polarity": "Neutral" }, { "id": "type-n05", "anchor": "type-n05", "label": "N05 · Actor / statechart — Serialize messages in one conversation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n05", "polarity": "Neutral" }, { "id": "type-n06", "anchor": "type-n06", "label": "N06 · Workflow / saga — Recover a checkout after payment fails", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n06", "polarity": "Neutral" }, { "id": "type-n07", "anchor": "type-n07", "label": "N07 · Stream operator — Debounce search as someone types", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n07", "polarity": "Neutral" }, { "id": "type-n08", "anchor": "type-n08", "label": "N08 · Fork / join / scheduler — Build a dashboard from three services", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n08", "polarity": "Neutral" }, { "id": "type-n09", "anchor": "type-n09", "label": "N09 · Timer / clock source — Expire an unpaid reservation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n09", "polarity": "Neutral" }, { "id": "type-n10", "anchor": "type-n10", "label": "N10 · Function / blueprint region — Reuse a conversation feature in two apps", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n10", "polarity": "Neutral" }, { "id": "type-n11", "anchor": "type-n11", "label": "N11 · Surface / view component — Render loading, error and content states", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n11", "polarity": "Neutral" }, { "id": "type-n12", "anchor": "type-n12", "label": "N12 · Route / navigation — Open a chat link and return an attachment", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n12", "polarity": "Neutral" }, { "id": "type-n13", "anchor": "type-n13", "label": "N13 · Input / interaction source — Turn drag gestures into an edit", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n13", "polarity": "Neutral" }, { "id": "type-n14", "anchor": "type-n14", "label": "N14 · Form / validation region — Validate a signup form before creating an account", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n14", "polarity": "Neutral" }, { "id": "type-n15", "anchor": "type-n15", "label": "N15 · Device / platform adapter — Ask for camera permission and capture a photo", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n15", "polarity": "Neutral" }, { "id": "type-n16", "anchor": "type-n16", "label": "N16 · Native resource / engine — Encode video across a native boundary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n16", "polarity": "Neutral" }, { "id": "type-n17", "anchor": "type-n17", "label": "N17 · Media transform — Create thumbnail and preview variants", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n17", "polarity": "Neutral" }, { "id": "type-n18", "anchor": "type-n18", "label": "N18 · Model inference — Generate a cited answer with a model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n18", "polarity": "Neutral" }, { "id": "type-n19", "anchor": "type-n19", "label": "N19 · Tool / external API adapter — Send a notification through an external provider", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n19", "polarity": "Neutral" }, { "id": "type-n20", "anchor": "type-n20", "label": "N20 · Human decision / approval — Approve a destructive deployment", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n20", "polarity": "Neutral" }, { "id": "type-n21", "anchor": "type-n21", "label": "N21 · Database / state authority — Prevent selling the last item twice", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n21", "polarity": "Neutral" }, { "id": "type-n22", "anchor": "type-n22", "label": "N22 · Query / materialized view — Search a materialized order history", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n22", "polarity": "Neutral" }, { "id": "type-n23", "anchor": "type-n23", "label": "N23 · Transaction / unit of work — Commit an order and its outbox event together", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n23", "polarity": "Neutral" }, { "id": "type-n24", "anchor": "type-n24", "label": "N24 · Queue / log / pubsub resource — Deliver an order event to billing and analytics", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n24", "polarity": "Neutral" }, { "id": "type-n25", "anchor": "type-n25", "label": "N25 · Cache / replica / sync agent — Sync offline profile edits without losing changes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n25", "polarity": "Neutral" }, { "id": "type-n26", "anchor": "type-n26", "label": "N26 · Blob / buffer / asset store — Download a large attachment in resumable chunks", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n26", "polarity": "Neutral" }, { "id": "type-n27", "anchor": "type-n27", "label": "N27 · Runtime host / executor — Run the same service locally and remotely", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n27", "polarity": "Neutral" }, { "id": "type-n28", "anchor": "type-n28", "label": "N28 · Placement / resource pool — Place replicas across failure domains", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n28", "polarity": "Neutral" }, { "id": "type-n29", "anchor": "type-n29", "label": "N29 · Factory / dynamic instance — Create one actor per active conversation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n29", "polarity": "Neutral" }, { "id": "type-n30", "anchor": "type-n30", "label": "N30 · External system boundary — Handle a payment webhook", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n30", "polarity": "Neutral" }, { "id": "type-n31", "anchor": "type-n31", "label": "N31 · Schema / contract definition — Evolve a service response without breaking old clients", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n31", "polarity": "Neutral" }, { "id": "type-n32", "anchor": "type-n32", "label": "N32 · Capability offer / requirement — Choose an available video encoder", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n32", "polarity": "Neutral" }, { "id": "type-n33", "anchor": "type-n33", "label": "N33 · Policy / principal boundary — Authorize a private conversation read", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n33", "polarity": "Neutral" }, { "id": "type-n34", "anchor": "type-n34", "label": "N34 · Build / compiler pass — Compile one common graph for two targets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n34", "polarity": "Neutral" }, { "id": "type-n35", "anchor": "type-n35", "label": "N35 · Artifact / release manifest — Publish a reproducible release manifest", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n35", "polarity": "Neutral" }, { "id": "type-n36", "anchor": "type-n36", "label": "N36 · Test / Shadow scenario — Reproduce a failed send with Shadow data", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n36", "polarity": "Neutral" }, { "id": "type-n37", "anchor": "type-n37", "label": "N37 · Claim / evidence record — Explain why a release is considered qualified", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n37", "polarity": "Neutral" }, { "id": "type-n38", "anchor": "type-n38", "label": "N38 · Observer / query / visitor — Measure the latency of sending a message", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n38", "polarity": "Neutral" }, { "id": "type-n39", "anchor": "type-n39", "label": "N39 · Agent / change proposer — Propose a safe graph edit from an agent", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n39", "polarity": "Neutral" }, { "id": "type-n40", "anchor": "type-n40", "label": "N40 · Deployment / migration controller — Replace a service without losing in-flight work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#type-n40", "polarity": "Neutral" }, { "id": "node-classification", "anchor": "node-classification", "label": "Behavior, composition and domain roles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#node-classification", "polarity": "Neutral" }, { "id": "node-consolidation", "anchor": "node-consolidation", "label": "Consolidation decisions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#node-consolidation", "polarity": "Neutral" }, { "id": "node-source-mapping", "anchor": "node-source-mapping", "label": "Concrete Reaktor mapping", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-graph-vocabulary-theory#node-source-mapping", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-graph-vocabulary-theory:references-reaktor-graph-language-theory", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "section-current-source-boundary", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:references-reaktor-hyperedge-theory", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "section-current-source-boundary", "role": "source", "ordinal": 0 }, { "node": "reaktor-hyperedge-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "section-current-source-boundary", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:references-architecture-atlas-vocabulary", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "section-current-source-boundary", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:requires-reaktor-graph-theory", "kind": "requires", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:derived-from-architecture-atlas-vocabulary", "kind": "derived-from", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:explains-reaktor-system-atlas", "kind": "explains", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n01-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n01", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n02-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n02", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n03-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n03", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n04-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n04", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n05-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n05", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n06-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n06", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n07-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n07", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n08-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n08", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n09-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n09", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n10-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n10", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n11-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n11", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n12-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n12", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n13-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n13", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n14-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n14", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-application-patterns", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n15-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n15", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n16-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n16", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n17-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n17", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n18-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n18", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n19-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n19", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n20-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n20", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n21-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n21", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n22-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n22", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n23-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n23", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n24-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n24", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n25-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n25", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n26-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n26", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n27-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n27", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n28-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n28", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n29-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n29", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n30-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n30", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n31-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n31", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n32-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n32", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n33-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n33", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n34-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n34", "role": "source", "ordinal": 0 }, { "node": "reaktor-dependeasy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n35-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n35", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n36-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n36", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n37-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n37", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n38-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n38", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n39-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n39", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:type-n40-module", "kind": "references", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "type-n40", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:topic-reaktor-port-theory", "kind": "explains", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-port-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:topic-reaktor-nested-graphs-theory", "kind": "explains", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-graph-vocabulary-theory:topic-reaktor-graph-views-theory", "kind": "explains", "owner": "reaktor-graph-vocabulary-theory", "incidences": [ { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-views-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-graph-vocabulary-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Nodes", "level": 0 }, { "id": "node-classification", "anchor": "node-classification", "title": "Behavior, composition and domain roles", "level": 2 }, { "id": "node-consolidation", "anchor": "node-consolidation", "title": "Consolidation decisions", "level": 2 }, { "id": "node-source-mapping", "anchor": "node-source-mapping", "title": "Concrete Reaktor mapping", "level": 2 }, { "id": "type-n01", "anchor": "type-n01", "title": "N01 · Pure computation — Rank a feed without fetching data", "level": 2 }, { "id": "type-n02", "anchor": "type-n02", "title": "N02 · Effectful operation — Upload a profile photo", "level": 2 }, { "id": "type-n03", "anchor": "type-n03", "title": "N03 · Decision / pattern match — Choose the next onboarding screen", "level": 2 }, { "id": "type-n04", "anchor": "type-n04", "title": "N04 · Loop / recursive region — Load more search results", "level": 2 }, { "id": "type-n05", "anchor": "type-n05", "title": "N05 · Actor / statechart — Serialize messages in one conversation", "level": 2 }, { "id": "type-n06", "anchor": "type-n06", "title": "N06 · Workflow / saga — Recover a checkout after payment fails", "level": 2 }, { "id": "type-n07", "anchor": "type-n07", "title": "N07 · Stream operator — Debounce search as someone types", "level": 2 }, { "id": "type-n08", "anchor": "type-n08", "title": "N08 · Fork / join / scheduler — Build a dashboard from three services", "level": 2 }, { "id": "type-n09", "anchor": "type-n09", "title": "N09 · Timer / clock source — Expire an unpaid reservation", "level": 2 }, { "id": "type-n10", "anchor": "type-n10", "title": "N10 · Function / blueprint region — Reuse a conversation feature in two apps", "level": 2 }, { "id": "type-n11", "anchor": "type-n11", "title": "N11 · Surface / view component — Render loading, error and content states", "level": 2 }, { "id": "type-n12", "anchor": "type-n12", "title": "N12 · Route / navigation — Open a chat link and return an attachment", "level": 2 }, { "id": "type-n13", "anchor": "type-n13", "title": "N13 · Input / interaction source — Turn drag gestures into an edit", "level": 2 }, { "id": "type-n14", "anchor": "type-n14", "title": "N14 · Form / validation region — Validate a signup form before creating an account", "level": 2 }, { "id": "type-n15", "anchor": "type-n15", "title": "N15 · Device / platform adapter — Ask for camera permission and capture a photo", "level": 2 }, { "id": "type-n16", "anchor": "type-n16", "title": "N16 · Native resource / engine — Encode video across a native boundary", "level": 2 }, { "id": "type-n17", "anchor": "type-n17", "title": "N17 · Media transform — Create thumbnail and preview variants", "level": 2 }, { "id": "type-n18", "anchor": "type-n18", "title": "N18 · Model inference — Generate a cited answer with a model", "level": 2 }, { "id": "type-n19", "anchor": "type-n19", "title": "N19 · Tool / external API adapter — Send a notification through an external provider", "level": 2 }, { "id": "type-n20", "anchor": "type-n20", "title": "N20 · Human decision / approval — Approve a destructive deployment", "level": 2 }, { "id": "type-n21", "anchor": "type-n21", "title": "N21 · Database / state authority — Prevent selling the last item twice", "level": 2 }, { "id": "type-n22", "anchor": "type-n22", "title": "N22 · Query / materialized view — Search a materialized order history", "level": 2 }, { "id": "type-n23", "anchor": "type-n23", "title": "N23 · Transaction / unit of work — Commit an order and its outbox event together", "level": 2 }, { "id": "type-n24", "anchor": "type-n24", "title": "N24 · Queue / log / pubsub resource — Deliver an order event to billing and analytics", "level": 2 }, { "id": "type-n25", "anchor": "type-n25", "title": "N25 · Cache / replica / sync agent — Sync offline profile edits without losing changes", "level": 2 }, { "id": "type-n26", "anchor": "type-n26", "title": "N26 · Blob / buffer / asset store — Download a large attachment in resumable chunks", "level": 2 }, { "id": "type-n27", "anchor": "type-n27", "title": "N27 · Runtime host / executor — Run the same service locally and remotely", "level": 2 }, { "id": "type-n28", "anchor": "type-n28", "title": "N28 · Placement / resource pool — Place replicas across failure domains", "level": 2 }, { "id": "type-n29", "anchor": "type-n29", "title": "N29 · Factory / dynamic instance — Create one actor per active conversation", "level": 2 }, { "id": "type-n30", "anchor": "type-n30", "title": "N30 · External system boundary — Handle a payment webhook", "level": 2 }, { "id": "type-n31", "anchor": "type-n31", "title": "N31 · Schema / contract definition — Evolve a service response without breaking old clients", "level": 2 }, { "id": "type-n32", "anchor": "type-n32", "title": "N32 · Capability offer / requirement — Choose an available video encoder", "level": 2 }, { "id": "type-n33", "anchor": "type-n33", "title": "N33 · Policy / principal boundary — Authorize a private conversation read", "level": 2 }, { "id": "type-n34", "anchor": "type-n34", "title": "N34 · Build / compiler pass — Compile one common graph for two targets", "level": 2 }, { "id": "type-n35", "anchor": "type-n35", "title": "N35 · Artifact / release manifest — Publish a reproducible release manifest", "level": 2 }, { "id": "type-n36", "anchor": "type-n36", "title": "N36 · Test / Shadow scenario — Reproduce a failed send with Shadow data", "level": 2 }, { "id": "type-n37", "anchor": "type-n37", "title": "N37 · Claim / evidence record — Explain why a release is considered qualified", "level": 2 }, { "id": "type-n38", "anchor": "type-n38", "title": "N38 · Observer / query / visitor — Measure the latency of sending a message", "level": 2 }, { "id": "type-n39", "anchor": "type-n39", "title": "N39 · Agent / change proposer — Propose a safe graph edit from an agent", "level": 2 }, { "id": "type-n40", "anchor": "type-n40", "title": "N40 · Deployment / migration controller — Replace a service without losing in-flight work", "level": 2 } ], "links": [ { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n01", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n05", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n06", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n12", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n25", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n36", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n01", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n02", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n05", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n07", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n03", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n04", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n06", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n08", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n10", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n11", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n12", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n13", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n14", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n15", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n16", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n19", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n30", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n17", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n18", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n34", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n09", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n21", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n22", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n24", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n26", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n27", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n23", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n25", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n28", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n29", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n36", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n38", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n39", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n40", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n20", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n31", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n32", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n33", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n35", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-vocabulary-theory", "anchor": "type-n37", "relation": "references", "sourceAnchor": "node-classification" }, { "id": "reaktor-graph-theory", "anchor": "coverage-and-admission", "relation": "references", "sourceAnchor": "node-source-mapping" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "type-n01" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-n02" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "type-n03" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-n04" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "type-n05" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "type-n06" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "type-n07" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-n08" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "type-n09" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "type-n10" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "type-n11" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "type-n12" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "type-n13" }, { "id": "reaktor-surface-application-patterns", "anchor": "", "relation": "references", "sourceAnchor": "type-n14" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "type-n15" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "type-n16" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "type-n17" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "type-n18" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-n19" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "type-n20" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "type-n21" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "type-n22" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "type-n23" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "type-n24" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "type-n25" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "type-n26" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-n27" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "type-n28" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "type-n29" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "type-n30" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-n31" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "type-n32" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "type-n33" }, { "id": "reaktor-dependeasy", "anchor": "", "relation": "references", "sourceAnchor": "type-n34" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-n35" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "type-n36" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "type-n37" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "type-n38" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "type-n39" }, { "id": "reaktor-graph-distribution-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-n40" } ] }, { "id": "reaktor-hyperedge-theory", "summary": "Hyperedges: task designs, relation laws, constraints and compositions.", "kind": "design", "owner": "Reaktor", "use": "Read the theory and distinguish structural checks from runtime, target and deployment qualification.", "region": "theory-foundations", "order": 3, "diagrams": [ { "id": "type-h01", "src": "/docs/img/theory/type-h01.svg", "alt": "H01 · Exclusive binding — Bind a repository to a real service or a mock", "text": "Which implementation supplies this required endpoint?\nThe profile repository requires one compatible read endpoint per activation. The test scenario binds a mock while the mobile activation binds the real service. Candidate offers remain visible without becoming simultaneous providers of an exclusive binding.\ndependency wiring\nmobile\nservices\nReject a second provider where exclusivity is required; dispatch can compile to a direct call.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nExclusive binding selects a supplier; it neither invokes the operation nor provides a failover policy.\nrepo: Profile repository (N25)\nrepo.read: P02; ProfileReadRequestResponseV1; Require\nrepo.state: P08; ProfileViewStateV1; Offer\nreal: Profile service implementation (N19)\nreal.read: P02; ProfileReadRequestResponseV1; Offer\nreal.offer: P19; ProfileAdapterCapabilityV1; Offer\nmock: Shadow profile adapter (N36)\nmock.offer: P19; ProfileAdapterCapabilityV1; Offer\nresolve: Activation binding decision (N03)\nresolve.required: P19; ProfileAdapterCapabilityV1; Require\nresolve.realRequired: P19; ProfileAdapterCapabilityV1; Require\nui: Profile Surface (N11)\nui.state: P08; ProfileViewStateV1; Require\nbinding (H01): provider[0]=real.read; consumer[0]=repo.read\nmock-offer (H24): offer[0]=mock.offer; requirement[0]=resolve.required\nreal-offer (H24): offer[0]=real.offer; requirement[0]=resolve.realRequired\nrender (H02): source[0]=repo.state; target[0]=ui.state" }, { "id": "type-h02", "src": "/docs/img/theory/type-h02.svg", "alt": "H02 · Value flow — Calculate invoice totals from line items", "text": "Which data feeds which calculation?\nLine items and discount policy feed the subtotal calculation. Tax calculation consumes that result and its jurisdiction input; the invoice combines both. Data flow exposes inputs while effectful persistence remains a separate call.\ncomputation\nmedia\nanalytics\nCopy/fanout is legal only for the value ownership profile; units and schemas must match.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nA value-flow incidence identifies data dependencies, not transaction scope or an effect schedule.\nlines: Invoice line snapshot (N21)\nlines.snapshot: P01; InvoiceLineItemsV1; Offer\ndiscount: Discount policy (N31)\ndiscount.policy: P01; DiscountPolicyV1; Offer\nsubtotal: Subtotal calculation (N01)\nsubtotal.lines: P01; InvoiceLineItemsV1; Require\nsubtotal.policy: P01; DiscountPolicyV1; Require\nsubtotal.value: P01; InvoiceSubtotalV1; Offer\ntax: Tax calculation (N01)\ntax.subtotal: P01; InvoiceSubtotalV1; Require\ntax.value: P01; InvoiceTaxV1; Offer\ninvoice: Invoice assembly (N01)\ninvoice.subtotal: P01; InvoiceSubtotalV1; Require\ninvoice.tax: P01; InvoiceTaxV1; Require\ninvoice.save: P02; StoreInvoiceReceiptV1; Require\nstore: Invoice authority (N21)\nstore.save: P02; StoreInvoiceReceiptV1; Offer\nlines (H02): source[0]=lines.snapshot; target[0]=subtotal.lines\npolicy (H02): source[0]=discount.policy; target[0]=subtotal.policy\nsubtotal (H02): source[0]=subtotal.value; target[0]=tax.subtotal; target[1]=invoice.subtotal\ntax (H02): source[0]=tax.value; target[0]=invoice.tax\nsave (H05): caller[0]=invoice.save; callee[0]=store.save" }, { "id": "type-h03", "src": "/docs/img/theory/type-h03.svg", "alt": "H03 · Control precedence — Remove user data in a safe order", "text": "Which operations must complete before account closure?\nThe deletion workflow freezes new writes, removes scoped assets and records data removal before closing the account. It records receipts for each step and can resume after failure. The order is explicit control precedence rather than implied by card placement.\nworkflows\nbuild\nreleases\nDefines ordering under a named profile; does not serialize unrelated graph layers.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nThe product must separately define retention exceptions and scope; sequencing does not prove every data copy was deleted.\nfreeze: Freeze account writes (N02)\nfreeze.done: P11; AccountFrozenReceiptV1; Offer\nassets: Remove user assets (N02)\nassets.start: P11; AccountFrozenReceiptV1; Require\nassets.done: P13; UserRemovalStageReceiptV1; Offer\ndata: Remove scoped user records (N02)\ndata.start: P11; AccountFrozenReceiptV1; Require\ndata.done: P13; UserRemovalStageReceiptV1; Offer\nclose: Close account identity (N02)\nclose.ready: P13; UserRemovalStageReceiptV1; Require\nclose.record: P03; DeletionStageRecordV1; Require\njournal: Deletion step journal (N21)\njournal.record: P03; DeletionStageRecordV1; Offer\nfreeze-first (H03): predecessor[0]=freeze.done; successor[0]=assets.start; successor[1]=data.start\nremoved (H09): source[0]=assets.done; source[1]=data.done; result[0]=close.ready\nrecord (H05): caller[0]=close.record; callee[0]=journal.record" }, { "id": "type-h04", "src": "/docs/img/theory/type-h04.svg", "alt": "H04 · Event subscription — Process order events with dead-letter handling", "text": "Who owns acknowledgement and retry?\nA GCP Pub/Sub subscription delivers order events to a worker. Successful business commit precedes its acknowledgement; exhausted failures enter an explicit dead-letter path. Topic resource, subscription and worker have distinct identities and contracts.\nPubSub\nmessaging\nIoT\nSubscriptions name filters, replay and delivery rules; broker resources remain separate nodes.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nBroker delivery guarantees are scoped to the subscription configuration; external writes need their own idempotency.\npublisher: Order event publisher (N02)\npublisher.events: P04; OrderPlacedEventV1; Offer\ntopic: GCP order topic (N24)\ntopic.publish: P04; OrderPlacedEventV1; Neutral\ntopic.events: P04; OrderPlacedEventV1; Offer\nsubscription: Billing subscription (N24)\nsubscription.events: P04; OrderPlacedEventV1; Neutral\nsubscription.ack: P03; OrderSubscriptionAckV1; Offer\nsubscription.failed: P04; FailedOrderDeliveryV1; Offer\nworker: Invoice worker (N06)\nworker.events: P04; OrderPlacedEventV1; Require\nworker.commit: P09; IdempotentInvoiceWriteV1; Require\nworker.ack: P03; OrderSubscriptionAckV1; Require\ninvoice: Invoice authority (N21)\ninvoice.write: P09; IdempotentInvoiceWriteV1; Offer\ndead: Dead-letter review (N20)\ndead.review: P04; FailedOrderDeliveryV1; Require\npublish (H04): publisher[0]=publisher.events; broker[0]=topic.publish\nsubscription (H04): publisher[0]=topic.events; subscription[0]=subscription.events; subscriber[0]=worker.events\ncommit (H05): caller[0]=worker.commit; callee[0]=invoice.write\nack (H05): caller[0]=worker.ack; callee[0]=subscription.ack\ndead-letter (H04): publisher[0]=subscription.failed; subscriber[0]=dead.review" }, { "id": "type-h05", "src": "/docs/img/theory/type-h05.svg", "alt": "H05 · Request / reply binding — Load a profile with a deadline", "text": "Which caller is paired with which reply?\nA screen invokes a typed profile service through an RPC binding. The server reads the profile authority and returns a revisioned response. A deadline bounds the caller's wait; correlation keeps a late reply from replacing a newer screen request.\nRPC\nweb\ndistributed systems\nProtocol includes correlation, failure and unknown outcomes; transport is chosen independently.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nRPC binding names correlation and outcomes; it does not mean the network is reliable or the call is authorized.\nscreen: Profile request controller (N05)\nscreen.request: P02; GetProfileCorrelationResponseV1; Require\nscreen.cancel: P14; ProfileRequestDeadlineV1; Require\nscreen.state: P08; CurrentProfileRequestStateV1; Offer\nservice: Profile service handler (N19)\nservice.get: P02; GetProfileCorrelationResponseV1; Offer\nservice.read: P02; ProfileSnapshotReadV1; Require\nprofile: Profile authority (N21)\nprofile.read: P02; ProfileSnapshotReadV1; Offer\ndeadline: Request deadline (N09)\ndeadline.expired: P14; ProfileRequestDeadlineV1; Offer\nui: Profile Surface (N11)\nui.state: P08; CurrentProfileRequestStateV1; Require\nrpc (H05): caller[0]=screen.request; callee[0]=service.get\nread (H05): caller[0]=service.read; callee[0]=profile.read\ndeadline (H03): source[0]=deadline.expired; target[0]=screen.cancel\nrender (H02): source[0]=screen.state; target[0]=ui.state" }, { "id": "type-h06", "src": "/docs/img/theory/type-h06.svg", "alt": "H06 · Multiparty session — Coordinate a multiplayer match session", "text": "Which participants share one protocol?\nPlayers and the authoritative match host participate in a session protocol with join, ready, input and acknowledgement phases. The lobby admits identities; a disconnected participant has a declared timeout path. Session roles retain player positions rather than reducing to unrelated pairwise wires.\ngames\ncollaboration\nmessaging\nSingle relation identity with role/cardinality checks; delivery comes from an explicit protocol.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nMultiparty membership does not establish a session-type proof; protocol validation must include allowed phase transitions.\nalice: Player Alice (N11)\nalice.session: P07; MatchJoinReadyInputAckV1; Neutral\nbob: Player Bob (N11)\nbob.session: P07; MatchJoinReadyInputAckV1; Neutral\nmatch: Authoritative match host (N05)\nmatch.session: P07; MatchJoinReadyInputAckV1; Neutral\nmatch.admission: P20; MatchParticipantGrantV1; Require\nmatch.disconnect: P15; MatchDisconnectCandidateV1; Require\nlobby: Match admission (N33)\nlobby.grant: P20; MatchParticipantGrantV1; Offer\ntimeout: Disconnect clock (N09)\ntimeout.tick: P15; MatchDisconnectCandidateV1; Offer\nsession (H06): participant[0]=alice.session; participant[1]=bob.session; coordinator[0]=match.session\nadmit (H23): principal[0]=lobby.grant; resource[0]=match.admission\ndisconnect (H04): publisher[0]=timeout.tick; subscriber[0]=match.disconnect" }, { "id": "type-h07", "src": "/docs/img/theory/type-h07.svg", "alt": "H07 · Broadcast / fanout — Invalidate caches after a configuration change", "text": "Which recipients must see the same occurrence?\nA committed configuration event fans out to web, mobile and server caches. Each cache applies the version independently and can acknowledge or reread current configuration. A fanout relation does not mean all recipients advance atomically.\nPubSub\nnotifications\ntelemetry\nState whether delivery waits for all, any or no receivers; slow receivers need a policy.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nFanout preserves one occurrence with multiple recipients; acknowledgement and failure are per participant.\nconfig: Configuration authority (N21)\nconfig.changed: P04; ConfigCommittedVersionV1; Offer\nweb: Web config cache (N25)\nweb.changed: P04; ConfigCommittedVersionV1; Require\nweb.observed: P24; ConfigAppliedVersionEvidenceV1; Offer\nmobile: Mobile config cache (N25)\nmobile.changed: P04; ConfigCommittedVersionV1; Require\nmobile.observed: P24; ConfigAppliedVersionEvidenceV1; Offer\nserver: Server config cache (N25)\nserver.changed: P04; ConfigCommittedVersionV1; Require\nserver.observed: P24; ConfigAppliedVersionEvidenceV1; Offer\nmonitor: Propagation monitor (N38)\nmonitor.cut: P24; ConfigAppliedVersionEvidenceV1; Require\nfanout (H07): publisher[0]=config.changed; subscriber[0]=web.changed; subscriber[1]=mobile.changed; subscriber[2]=server.changed\nobserved (H27): source[0]=web.observed; source[1]=mobile.observed; source[2]=server.observed; target[0]=monitor.cut" }, { "id": "type-h08", "src": "/docs/img/theory/type-h08.svg", "alt": "H08 · Merge-any — Merge notification sources into one inbox", "text": "What happens when either source has a new item?\nPush delivery and local reminders both feed an inbox merge. The merger emits each admitted item without waiting for the other source and deduplicates by notification identity. Its output updates current inbox state.\ntelemetry\nIoT\nstreams\nSpecify interleaving, fairness and order; merging is not a join of corresponding values.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nMerge-any emits admitted arrivals; it is not first-winner cancellation or join-all readiness.\npush: Server push notifications (N15)\npush.item: P04; NotificationOccurrenceV1; Offer\nlocal: Local reminder source (N09)\nlocal.item: P04; NotificationOccurrenceV1; Offer\nmerge: Notification merge (N07)\nmerge.item: P04; NotificationOccurrenceV1; Require\nmerge.append: P09; AppendNotificationIfAbsentV1; Require\ninbox: Inbox state (N05)\ninbox.append: P09; AppendNotificationIfAbsentV1; Offer\ninbox.state: P08; InboxStateV1; Offer\nui: Inbox Surface (N11)\nui.state: P08; InboxStateV1; Require\nmerge (H08): source[0]=push.item; source[1]=local.item; result[0]=merge.item\nappend (H05): caller[0]=merge.append; callee[0]=inbox.append\nrender (H02): source[0]=inbox.state; target[0]=ui.state" }, { "id": "type-h09", "src": "/docs/img/theory/type-h09.svg", "alt": "H09 · Join-all — Assemble a profile from required reads", "text": "Which results must all be present?\nProfile and relationship reads are both required for the full header. A join combines their named results after checking revision context. Optional recommendations use a separate path and do not change the join's readiness law.\nmedia\nworkflows\nparallel work\nAlign values by invocation/key; define failure, timeout and missing-input treatment.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nJoin-all requires the declared participants and failure policy; it does not create cross-service snapshot consistency.\nprofile: Profile read (N19)\nprofile.part: P01; RequiredProfileHeaderPartsV1; Offer\nrelationship: Relationship read (N19)\nrelationship.part: P01; RequiredProfileHeaderPartsV1; Offer\nrecommend: Optional recommendations (N19)\nrecommend.state: P08; RecommendationPanelV1; Offer\njoin: Profile header assembly (N01)\njoin.parts: P01; RequiredProfileHeaderPartsV1; Require\njoin.state: P08; ProfileHeaderReadyV1; Offer\nui: Profile header Surface (N11)\nui.header: P08; ProfileHeaderReadyV1; Require\nui.recommendation: P08; RecommendationPanelV1; Require\njoin (H09): source[0]=profile.part; source[1]=relationship.part; result[0]=join.parts\nheader (H02): source[0]=join.state; target[0]=ui.header\noptional (H02): source[0]=recommend.state; target[0]=ui.recommendation" }, { "id": "type-h10", "src": "/docs/img/theory/type-h10.svg", "alt": "H10 · Race / select — Race mirrors for an asset", "text": "Which valid response wins and what happens to losers?\nTwo asset mirrors compete to supply bytes for the same digest. The race accepts the first verified result and cancels remaining reads; invalid bytes cannot win merely by arriving first. The selected asset is handed to rendering.\nservices\nlatency\ncapability selection\nDefine first-completion versus first-success and cleanup/reconciliation of losing effects.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nWinner eligibility, deadline and loser cancellation are race laws; arbitrary first arrival is not necessarily a valid result.\na: Primary asset mirror (N26)\na.bytes: P01; DigestBoundAssetCandidateV1; Offer\nb: Secondary asset mirror (N26)\nb.bytes: P01; DigestBoundAssetCandidateV1; Offer\nrace: Verified asset race (N07)\nrace.bytes: P01; DigestBoundAssetCandidateV1; Neutral\nrace.candidate: P17; AssetCandidateBytesV1; Offer\nrace.admission: P24; AssetDigestEvidenceV1; Require\nrace.verified: P01; VerifiedAssetRefV1; Offer\nverify: Digest verifier (N01)\nverify.bytes: P17; AssetCandidateBytesV1; Require\nverify.evidence: P24; AssetDigestEvidenceV1; Offer\nui: Asset Surface (N11)\nui.asset: P01; VerifiedAssetRefV1; Require\nrace (H10): candidate[0]=a.bytes; candidate[1]=b.bytes; winner[0]=race.bytes\nverify (H02): source[0]=race.candidate; target[0]=verify.bytes\nadmit (H02): source[0]=verify.evidence; target[0]=race.admission\ndisplay (H02): source[0]=race.verified; target[0]=ui.asset" }, { "id": "type-h11", "src": "/docs/img/theory/type-h11.svg", "alt": "H11 · Keyed temporal join — Match payments with orders by time and key", "text": "How are late or unmatched records handled?\nA reconciliation operator joins order and payment events by order ID within a declared time window. Watermark and late-event rules produce matched records or explicit exceptions. Matching timestamps alone cannot establish causality.\nanalytics\ntelemetry\nIoT\nState key, clock, lateness/watermark and window policy; topology alone cannot pair records.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nKey, window, watermark, duplicate and late-data policy are required parts of this profile.\norders: Order event stream (N24)\norders.events: P04; OrderPaymentKeyedEventV1; Neutral\npayments: Payment event stream (N24)\npayments.events: P04; OrderPaymentKeyedEventV1; Neutral\njoin: Order-payment reconciliation (N07)\njoin.matched: P04; OrderPaymentKeyedEventV1; Require\njoin.commit: P09; ReconciliationWriteV1; Require\njoin.exception: P04; UnmatchedOrLatePaymentV1; Offer\nmatched: Reconciled ledger (N21)\nmatched.write: P09; ReconciliationWriteV1; Offer\nexceptions: Unmatched payment review (N20)\nexceptions.review: P04; UnmatchedOrLatePaymentV1; Require\njoin (H11): left[0]=orders.events; right[0]=payments.events; result[0]=join.matched\ncommit (H05): caller[0]=join.commit; callee[0]=matched.write\nlate (H04): publisher[0]=join.exception; subscriber[0]=exceptions.review" }, { "id": "type-h12", "src": "/docs/img/theory/type-h12.svg", "alt": "H12 · Barrier / synchronization — Start a match after all players are ready", "text": "How does a phase advance without double-starting?\nA barrier accepts readiness from the admitted player set for one match epoch. It releases the start phase only when the set is complete, or aborts under the timeout policy. Readiness from a previous epoch does not count.\ngames\nreleases\ndistributed systems\nSpecify membership epoch, arrival condition and failure handling; no hidden global clock.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nBarrier synchronizes a named phase and membership epoch; unlike a value join it may repeat across phases.\na: Player A ready state (N05)\na.ready: P13; PlayerReadyAtMatchEpochV1; Neutral\nb: Player B ready state (N05)\nb.ready: P13; PlayerReadyAtMatchEpochV1; Neutral\nbarrier: Match ready barrier (N05)\nbarrier.ready: P13; PlayerReadyAtMatchEpochV1; Neutral\nbarrier.release: P11; AdmittedMatchStartV1; Offer\nbarrier.abort: P14; MatchReadinessDeadlineV1; Require\nmatch: Match simulation (N05)\nmatch.start: P11; AdmittedMatchStartV1; Require\ntimeout: Ready deadline (N09)\ntimeout.expired: P14; MatchReadinessDeadlineV1; Offer\nbarrier (H12): member[0]=a.ready; member[1]=b.ready; coordinator[0]=barrier.ready\nstart (H03): source[0]=barrier.release; target[0]=match.start\ntimeout (H03): source[0]=timeout.expired; target[0]=barrier.abort" }, { "id": "type-h13", "src": "/docs/img/theory/type-h13.svg", "alt": "H13 · Quorum requirement — Approve a replicated write with a quorum", "text": "Which votes count for this term?\nThree voters provide term-bound acknowledgements to a coordinator. A write becomes accepted only under the stated quorum and membership law. A receipt includes term and log position; it is not inferred from drawing a majority.\ndistributed systems\nreplication\ncoordination\nNames a qualified protocol and membership; counting votes alone does not implement consensus.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nThreshold, eligible membership and failure assumptions must be specified; quorum edges alone do not implement consensus.\na: Replica voter A (N21)\na.vote: P13; TermBoundWriteAcknowledgementV1; Offer\nb: Replica voter B (N21)\nb.vote: P13; TermBoundWriteAcknowledgementV1; Offer\nc: Replica voter C (N21)\nc.vote: P13; TermBoundWriteAcknowledgementV1; Offer\ncoordinator: Write quorum coordinator (N05)\ncoordinator.votes: P13; TermBoundWriteAcknowledgementV1; Neutral\ncoordinator.accepted: P24; QuorumWriteReceiptV1; Offer\nreceipt: Accepted write receipt (N37)\nreceipt.record: P24; QuorumWriteReceiptV1; Require\nquorum (H13): voter[0]=a.vote; voter[1]=b.vote; voter[2]=c.vote; coordinator[0]=coordinator.votes\nreceipt (H27): source[0]=coordinator.accepted; target[0]=receipt.record" }, { "id": "type-h14", "src": "/docs/img/theory/type-h14.svg", "alt": "H14 · Replica group — Read from a replica group with explicit consistency", "text": "Which replica may serve this read?\nReplica-group membership supplies candidates and their applied positions. A routing decision chooses an eligible replica for the requested read cut; the leader remains the write authority. Placement and quorum constraints are separate from group membership.\noffline mobile\ndata\ndistributed systems\nReplication/merge and fencing rules are explicit; schema does not create consistency.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nReplica group is a composition profile; it needs consistency and membership rules and is not interchangeable with quorum.\nleader: Write leader (N21)\nleader.member: P19; ReplicaMembershipEpochV1; Offer\nfollower: Read follower (N25)\nfollower.member: P19; ReplicaMembershipEpochV1; Neutral\nfollower.read: P02; ReadAtRequiredPositionV1; Offer\nfollower.placement: P19; ReplicaPlacementV1; Neutral\nrouter: Read consistency router (N03)\nrouter.membership: P19; ReplicaMembershipEpochV1; Neutral\nrouter.read: P02; ReadAtRequiredPositionV1; Offer\nrouter.follower: P02; ReadAtRequiredPositionV1; Require\nclient: Read caller (N19)\nclient.read: P02; ReadAtRequiredPositionV1; Require\npool: Replica placement pool (N28)\npool.placement: P19; ReplicaPlacementV1; Neutral\ngroup (H14): leader[0]=leader.member; follower[0]=follower.member; coordinator[0]=router.membership\nread (H05): caller[0]=client.read; callee[0]=router.read\nfollower (H05): caller[0]=router.follower; callee[0]=follower.read\nplace (H21): subject[0]=follower.placement; host[0]=pool.placement" }, { "id": "type-h15", "src": "/docs/img/theory/type-h15.svg", "alt": "H15 · Partition / route — Route conversations to partitions", "text": "Who owns a key during repartitioning?\nThe router maps a conversation key through a partition map revision to its owner. Epoch fencing rejects stale routes during handoff. The relation names assignment; hash or range logic stays in the router's Kotlin implementation.\ndistributed systems\ntenancy\nIoT\nSpecify key function, assignment epoch and resharding; preserve owner and replay semantics.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nPartition assignment does not migrate state; routing algorithm, map revision and fencing are explicit.\nclient: Conversation request (N19)\nclient.request: P02; ConversationKeyedRequestV1; Require\nrouter: Conversation partition router (N03)\nrouter.request: P02; ConversationKeyedRequestV1; Offer\nrouter.map: P01; ConversationPartitionMapV1; Require\nrouter.assignment: P19; ConversationPartitionAssignmentV1; Neutral\nmap: Partition map authority (N21)\nmap.revision: P01; ConversationPartitionMapV1; Offer\nmap.epoch: P22; PartitionEpochHandoffV1; Offer\na: Partition A actor host (N27)\na.assignment: P19; ConversationPartitionAssignmentV1; Neutral\na.handoff: P22; PartitionEpochHandoffV1; Neutral\nb: Partition B actor host (N27)\nb.assignment: P19; ConversationPartitionAssignmentV1; Neutral\nb.handoff: P22; PartitionEpochHandoffV1; Neutral\nrequest (H05): caller[0]=client.request; callee[0]=router.request\nmap (H02): source[0]=map.revision; target[0]=router.map\nassignment (H15): router[0]=router.assignment; partition[0]=a.assignment; partition[1]=b.assignment\nhandoff (H35): old[0]=a.handoff; new[0]=b.handoff; authority[0]=map.epoch" }, { "id": "type-h16", "src": "/docs/img/theory/type-h16.svg", "alt": "H16 · Atomic authority scope — Commit a membership and its audit row together", "text": "What lies inside the atomic authority scope?\nThe membership operation writes the membership row and audit row under one database transaction authority. Email dispatch follows the commit receipt outside the scope. A shared region frame cannot substitute for the transaction relation.\ntransactions\ncommerce\ndata\nACID applies only where that authority/profile implements it; not across arbitrary stores.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nAtomicity is supplied by a named authority and isolation contract; external services are excluded.\ninvite: Membership operation (N02)\ninvite.accept: P02; AcceptMembershipReceiptV1; Require\ntx: Membership transaction (N23)\ntx.accept: P02; AcceptMembershipReceiptV1; Offer\ntx.scope: P10; MembershipAuditTransactionV1; Offer\ntx.committed: P04; MembershipCommittedV1; Offer\nmember: Membership table (N21)\nmember.tx: P10; MembershipAuditTransactionV1; Neutral\naudit: Audit table (N21)\naudit.tx: P10; MembershipAuditTransactionV1; Neutral\nemail: Invitation email adapter (N19)\nemail.send: P04; MembershipCommittedV1; Require\nrequest (H05): caller[0]=invite.accept; callee[0]=tx.accept\natomic (H16): authority[0]=tx.scope; participant[0]=member.tx; participant[1]=audit.tx\nemail (H04): publisher[0]=tx.committed; subscriber[0]=email.send" }, { "id": "type-h17", "src": "/docs/img/theory/type-h17.svg", "alt": "H17 · Compensation relation — Refund after fulfilment cannot complete", "text": "How is a completed business effect compensated?\nThe order saga records a successful charge before attempting fulfilment. Failure proposes a refund linked to that charge receipt; reconciliation records refund completion or review-required state. Compensation does not erase the original payment history.\ncommerce\nworkflows\nexternal effects\nCompensation is a new effect with its own failure modes, not automatic historical erasure.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nCompensation is a later authorized effect with its own failure law, not transactional rollback.\nsaga: Order fulfilment saga (N06)\nsaga.charge: P03; PaymentChargeReceiptV1; Require\nsaga.fulfil: P03; FulfilmentReceiptV1; Require\nsaga.refund: P03; ChargeBoundRefundCommandV1; Neutral\nsaga.record: P09; OrderEffectJournalWriteV1; Require\ncharge: Payment charge adapter (N19)\ncharge.charge: P03; PaymentChargeReceiptV1; Offer\ncharge.receipt: P03; ChargeBoundRefundCommandV1; Neutral\nfulfil: Fulfilment adapter (N19)\nfulfil.fulfil: P03; FulfilmentReceiptV1; Offer\nrefund: Refund adapter (N19)\nrefund.refund: P03; ChargeBoundRefundCommandV1; Neutral\nledger: Order effect journal (N21)\nledger.write: P09; OrderEffectJournalWriteV1; Offer\ncharge (H05): caller[0]=saga.charge; callee[0]=charge.charge\nfulfil (H05): caller[0]=saga.fulfil; callee[0]=fulfil.fulfil\ncompensation (H17): forward[0]=charge.receipt; compensation[0]=refund.refund; coordinator[0]=saga.refund\nrecord (H05): caller[0]=saga.record; callee[0]=ledger.write" }, { "id": "type-h18", "src": "/docs/img/theory/type-h18.svg", "alt": "H18 · Supervision — Restart a failed worker without duplicating its work", "text": "Who decides restart and owns the child lifetime?\nA supervisor observes worker failure and selects restart, stop or escalation. The durable job authority retains command state across restart. Child ownership and restart policy remain separate contracts.\nactors\ngames\nservices\nSpecify restart budget, state/ownership effects and host-death behavior.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nSupervision is a lifecycle composition; restarting code does not repair corrupted state or roll back external effects.\nsupervisor: Export worker supervisor (N05)\nsupervisor.child: P21; ExportWorkerSupervisionV1; Offer\nsupervisor.restart: P11; AdmittedWorkerRestartV1; Require\nworker: Export worker activation (N06)\nworker.parent: P21; ExportWorkerSupervisionV1; Require\nworker.failure: P04; ExportWorkerFailureV1; Offer\nworker.resume: P02; ExportJobResumeAtCutV1; Require\njobs: Durable export authority (N21)\njobs.resume: P02; ExportJobResumeAtCutV1; Offer\npolicy: Restart budget decision (N03)\npolicy.failure: P04; ExportWorkerFailureV1; Require\npolicy.restart: P11; AdmittedWorkerRestartV1; Offer\npolicy.exhausted: P04; RestartBudgetExhaustedV1; Offer\nreview: Escalated failure review (N20)\nreview.failure: P04; RestartBudgetExhaustedV1; Require\nsupervision (H18): parent[0]=supervisor.child; child[0]=worker.parent\nfailure (H04): publisher[0]=worker.failure; subscriber[0]=policy.failure\nrestart (H03): source[0]=policy.restart; target[0]=supervisor.restart\nresume (H05): caller[0]=worker.resume; callee[0]=jobs.resume\nescalate (H04): publisher[0]=policy.exhausted; subscriber[0]=review.failure" }, { "id": "type-h19", "src": "/docs/img/theory/type-h19.svg", "alt": "H19 · Ownership / containment — Own resources inside a feature scope", "text": "Which parent releases a session and its buffers?\nA conversation scope owns its subscription, native decoder handle and attachment lease. Child lifetime cannot outlive the scope without an explicit transfer. Graph containment may organize the same objects but does not automatically define resource ownership.\nnested graphs\nresources\nFFI\nSelected ownership relation is acyclic; visual grouping is not ownership.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nOwnership is a lifetime law; neither layout grouping nor placement expresses it.\nscope: Conversation lifetime owner (N10)\nscope.resources: P21; ConversationResourceOwnershipV1; Offer\nscope.drain: P14; ConversationExitV1; Require\nsubscription: Message subscription (N15)\nsubscription.scope: P21; ConversationResourceOwnershipV1; Require\ndecoder: Native decoder handle (N16)\ndecoder.scope: P21; ConversationResourceOwnershipV1; Require\ndecoder.view: P17; BorrowedAttachmentViewV1; Require\nattachment: Attachment read lease (N26)\nattachment.scope: P21; ConversationResourceOwnershipV1; Require\nattachment.view: P17; BorrowedAttachmentViewV1; Offer\nroute: Conversation RouteNode (N12)\nroute.leave: P14; ConversationExitV1; Offer\nownership (H19): owner[0]=scope.resources; resource[0]=subscription.scope; resource[1]=decoder.scope; resource[2]=attachment.scope\nleave (H03): source[0]=route.leave; target[0]=scope.drain\nbytes (H02): source[0]=attachment.view; target[0]=decoder.view" }, { "id": "type-h20", "src": "/docs/img/theory/type-h20.svg", "alt": "H20 · Instantiation — Instantiate a reusable tenant service", "text": "Which definition creates which activation?\nA tenant factory creates service instances from one reusable definition. Each instance binds tenant-scoped state and its own activation ID. A registry prevents an accidental duplicate active lease for the same tenant.\ngames\nactors\ntenancy\nFresh activation identities and scopes; shared definitions are not shared mutable instance state.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nDefinition identity, tenant identity and activation identity are separate; instantiation is not ownership or placement.\ndefinition: Tenant service blueprint (N10)\ndefinition.ref: P23; TenantServiceDefinitionRefV1; Offer\nfactory: Tenant service factory (N29)\nfactory.definition: P23; TenantServiceDefinitionRefV1; Require\nfactory.create: P21; TenantServiceInstanceV1; Neutral\nfactory.lease: P09; TenantActivationLeaseV1; Require\ninstance: Tenant service activation (N27)\ninstance.lifecycle: P21; TenantServiceInstanceV1; Neutral\ninstance.state: P02; TenantScopedStateReadV1; Require\nstate: Tenant state authority (N21)\nstate.read: P02; TenantScopedStateReadV1; Offer\nregistry: Tenant activation registry (N21)\nregistry.lease: P09; TenantActivationLeaseV1; Offer\ndefinition (H26): artifact[0]=definition.ref; consumer[0]=factory.definition\ninstantiate (H20): factory[0]=factory.create; instance[0]=instance.lifecycle\nlease (H05): caller[0]=factory.lease; callee[0]=registry.lease\nbind (H01): provider[0]=state.read; consumer[0]=instance.state" }, { "id": "type-h21", "src": "/docs/img/theory/type-h21.svg", "alt": "H21 · Placement — Place an image worker near storage", "text": "Where may this execution run?\nA worker requires a target, capacity and data-locality profile. Placement assigns it to a compatible host; object-store access is a separate service binding. The assignment is desired state until an activation receipt confirms it.\ncloud\ndistributed systems\nFFI\nA plan expresses intended placement; observations separately establish what actually runs.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nPlacement neither grants data access nor proves locality, capacity or runtime health unless checked and observed.\nworker: Image variant worker (N27)\nworker.place: P19; ImageWorkerHostPlacementV1; Neutral\nworker.requirements: P19; ImageWorkerRequirementsV1; Offer\nworker.read: P02; ImageObjectReadV1; Require\nhost: Regional JVM host (N27)\nhost.place: P19; ImageWorkerHostPlacementV1; Neutral\nstore: Image object store (N26)\nstore.read: P02; ImageObjectReadV1; Offer\npool: Host capacity inventory (N28)\npool.capacity: P19; HostCapacityAtCutV1; Offer\nadmit: Placement admission (N03)\nadmit.capacity: P19; HostCapacityAtCutV1; Require\nadmit.requirements: P19; ImageWorkerRequirementsV1; Require\nplacement (H21): subject[0]=worker.place; host[0]=host.place\ncapacity (H02): source[0]=pool.capacity; target[0]=admit.capacity\nrequirement (H02): source[0]=worker.requirements; target[0]=admit.requirements\nread (H05): caller[0]=worker.read; callee[0]=store.read" }, { "id": "type-h22", "src": "/docs/img/theory/type-h22.svg", "alt": "H22 · Affinity / separation — Separate primary and backup across zones", "text": "Which shared failures must be excluded?\nPrimary and backup placements name their failure domains. A separation constraint rejects a plan that places both in one zone, even if capacity is available. Replication behavior remains a separate relation and implementation.\ncloud\nrobotics\nresource planning\nCo-location, anti-affinity or memory-domain rule is a constraint, not an executable wire.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nAffinity and separation are constraint profiles; zone labels need trusted host facts and a declared failure model.\nprimary: Primary service placement (N27)\nprimary.zone: P19; DistinctServiceZoneV1; Neutral\nprimary.host: P19; ServiceHostPlacementV1; Neutral\nbackup: Backup service placement (N27)\nbackup.zone: P19; DistinctServiceZoneV1; Neutral\nbackup.host: P19; ServiceHostPlacementV1; Neutral\nzoneA: Zone A host (N27)\nzoneA.host: P19; ServiceHostPlacementV1; Neutral\nzoneB: Zone B host (N27)\nzoneB.host: P19; ServiceHostPlacementV1; Neutral\nvalidate: Failure-domain validator (N01)\nvalidate.zone: P19; DistinctServiceZoneV1; Neutral\nseparation (H22): member[0]=primary.zone; member[1]=backup.zone; validator[0]=validate.zone\nprimary (H21): subject[0]=primary.host; host[0]=zoneA.host\nbackup (H21): subject[0]=backup.host; host[0]=zoneB.host" }, { "id": "type-h23", "src": "/docs/img/theory/type-h23.svg", "alt": "H23 · Scoped authorization — Restrict a docs graph to one principal", "text": "Which resources are admitted into the readable cut?\nAuthorization relates a principal-bound grant to collection, sections and allowed operation. Retrieval applies it before graph expansion, including indirect links. The visible subgraph records the resulting cut but is not an independent authorization engine.\nRBAC\nagents\ntenancy\nDecision is tied to action/context; visual reachability neither proves nor grants access.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nAuthorization is distinct from capability discovery and navigation visibility; every sensitive effect rechecks its scope.\npolicy: Principal read policy (N33)\npolicy.grant: P20; DocumentationReadScopeV1; Offer\npolicy.receipt: P24; DocsAccessDecisionReceiptV1; Offer\ncollection: Private documentation collection (N21)\ncollection.read: P20; DocumentationReadScopeV1; Require\nretrieve: Scoped graph retrieval (N22)\nretrieve.expand: P20; DocumentationReadScopeV1; Require\nretrieve.cut: P01; AuthorizedDocsGraphCutV1; Offer\nview: Principal-specific Atlas view (N11)\nview.cut: P01; AuthorizedDocsGraphCutV1; Require\naudit: Access evidence (N37)\naudit.record: P24; DocsAccessDecisionReceiptV1; Require\nscope (H23): principal[0]=policy.grant; resource[0]=collection.read; resource[1]=retrieve.expand\ncut (H02): source[0]=retrieve.cut; target[0]=view.cut\nreceipt (H27): source[0]=policy.receipt; target[0]=audit.record" }, { "id": "type-h24", "src": "/docs/img/theory/type-h24.svg", "alt": "H24 · Capability resolution — Select a map renderer without platform conditionals", "text": "Which offer satisfies the required interaction contract?\nA feature declares a map-rendering requirement. Resolution compares browser and desktop offers by target, formats and interaction contract, then supplies one selected binding. Authority to read graph data is evaluated separately.\ncapabilities\nAI\nmobile\nFilter hard constraints and grants before preferences; pin or safely migrate running sessions.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nResolution checks compatibility; it is not an authorization grant, placement plan or fallback execution engine.\nfeature: Atlas rendering requirement (N32)\nfeature.map: P19; AtlasRendererCapabilityV1; Require\nfeature.contract: P23; AtlasInteractionContractRefV1; Offer\nbrowser: Browser Atlas offer (N32)\nbrowser.map: P19; AtlasRendererCapabilityV1; Offer\ndesktop: Desktop Atlas offer (N32)\ndesktop.map: P19; AtlasRendererCapabilityV1; Offer\nresolver: Capability resolution (N03)\nresolver.map: P19; AtlasRendererCapabilityV1; Neutral\nresolver.binding: P01; SelectedAtlasRendererV1; Offer\nhost: Atlas host (N27)\nhost.binding: P01; SelectedAtlasRendererV1; Require\nhost.contract: P23; AtlasInteractionContractRefV1; Require\nresolution (H24): requirement[0]=feature.map; offer[0]=browser.map; offer[1]=desktop.map; resolver[0]=resolver.map\nbinding (H02): source[0]=resolver.binding; target[0]=host.binding\ncontract (H26): artifact[0]=feature.contract; consumer[0]=host.contract" }, { "id": "type-h25", "src": "/docs/img/theory/type-h25.svg", "alt": "H25 · Implements / source ownership — Link a graph service to its source implementation", "text": "Which code owns this declared operation?\nA source-ownership relation connects the messaging endpoint with its common Service contract and target handler. Source navigation uses that linkage at a revision. A runtime trace additionally needs source maps and activation evidence.\nRGL\nsource publication\nagents\nExactly one edit authority per region; generated projections are not independently editable truth.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nImplementation linkage is a revisioned descriptive relation, not proof of behavior or deployment.\nservice: Messaging graph endpoint (N19)\nservice.source: P23; MessagingSourceOwnershipV1; Neutral\nservice.links: P24; MessagingSourceLinkCutV1; Offer\ncontract: Common Service contract source (N31)\ncontract.source: P23; MessagingSourceOwnershipV1; Neutral\nhandler: Server handler source (N35)\nhandler.source: P23; MessagingSourceOwnershipV1; Neutral\nhandler.artifact: P23; ServerArtifactDerivationV1; Offer\nartifact: Built server artifact (N35)\nartifact.source: P23; ServerArtifactDerivationV1; Require\ndebug: Source navigation visitor (N38)\ndebug.cut: P24; MessagingSourceLinkCutV1; Require\nimplements (H25): subject[0]=service.source; implementation[0]=handler.source; contract[0]=contract.source\nartifact (H27): source[0]=handler.artifact; target[0]=artifact.source\ninspect (H02): source[0]=service.links; target[0]=debug.cut" }, { "id": "type-h26", "src": "/docs/img/theory/type-h26.svg", "alt": "H26 · Artifact dependency — Build only artifacts affected by a contract edit", "text": "Which dependencies invalidate this build?\nA contract change invalidates dependent client and server codecs and their release manifest. Dependency relations retain artifact identities; the build system determines the transitive affected cut. Source derivation and compatibility evidence are separately recorded.\nbuild\nreleases\ncode push\nPin semantic/artifact revisions; cosmetic layout changes need not invalidate code.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nDependency is not provenance, execution order or semantic compatibility; those require their own laws.\nschema: Changed messaging schema (N31)\nschema.ref: P23; MessagingSchemaDigestV1; Offer\nschema.change: P24; AffectedArtifactCutV1; Offer\nclient: Client codec build (N34)\nclient.schema: P23; MessagingSchemaDigestV1; Require\nclient.artifact: P23; MessagingCodecArtifactRefsV1; Offer\nserver: Server codec build (N34)\nserver.schema: P23; MessagingSchemaDigestV1; Require\nserver.artifact: P23; MessagingCodecArtifactRefsV1; Offer\nmanifest: Release manifest build (N35)\nmanifest.codecs: P23; MessagingCodecArtifactRefsV1; Require\nvisitor: Affected-build visitor (N38)\nvisitor.change: P24; AffectedArtifactCutV1; Require\ncodecs (H26): artifact[0]=schema.ref; consumer[0]=client.schema; consumer[1]=server.schema\nrelease (H26): artifact[0]=client.artifact; artifact[1]=server.artifact; consumer[0]=manifest.codecs\naffected (H02): source[0]=schema.change; target[0]=visitor.change" }, { "id": "type-h27", "src": "/docs/img/theory/type-h27.svg", "alt": "H27 · Derivation / provenance — Trace a PDF to the exact docs revision", "text": "Which sections and renderer produced these bytes?\nA PDF export derives from a section cut and render configuration. Its record names document revisions and the output digest. Later edits do not silently change the exported artifact's provenance; retrieval can cite both the live section and exported revision.\nvisitors\ncompilers\ntelemetry\nResults carry input cut and transform version; unknown dependencies widen invalidation.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nProvenance describes origin; it does not grant access or prove document correctness.\ndocs: Documentation section cut (N35)\ndocs.ref: P23; DocsPdfDerivationRefsV1; Offer\nconfig: PDF render configuration (N31)\nconfig.ref: P23; DocsPdfDerivationRefsV1; Offer\nrender: PDF export operation (N02)\nrender.inputs: P23; DocsPdfDerivationRefsV1; Require\nrender.output: P23; RenderedPdfDigestV1; Offer\nrender.receipt: P24; PdfExportReceiptV1; Offer\npdf: PDF artifact (N35)\npdf.ref: P23; RenderedPdfDigestV1; Require\nreceipt: Export evidence (N37)\nreceipt.record: P24; PdfExportReceiptV1; Require\nderive (H27): source[0]=docs.ref; source[1]=config.ref; target[0]=render.inputs\noutput (H27): source[0]=render.output; target[0]=pdf.ref\nrecord (H27): source[0]=render.receipt; target[0]=receipt.record" }, { "id": "type-h28", "src": "/docs/img/theory/type-h28.svg", "alt": "H28 · Evidence supports claim — Support an end-to-end latency claim", "text": "Which evidence justifies the stated budget?\nA performance claim cites a bounded run, target revision and sampled latency distribution. Missing segments and clock assumptions are part of that support. A claim without matching evidence remains unknown or unqualified.\nShadow\nverification\nreleases\nScope assumptions and coverage; evidence does not promote or authorize itself.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nSupports-claim is not logical implication outside its assumptions and coverage.\nrun: Latency test run (N36)\nrun.receipt: P24; RevisionTargetLatencyEvidenceV1; Offer\nspans: Captured flow spans (N37)\nspans.cut: P24; FlowSpanEvidenceCutV1; Offer\nanalysis: Latency distribution analysis (N01)\nanalysis.cut: P24; FlowSpanEvidenceCutV1; Require\nanalysis.result: P24; RevisionTargetLatencyEvidenceV1; Offer\nclaim: Latency budget claim (N37)\nclaim.support: P24; RevisionTargetLatencyEvidenceV1; Require\nclaim.state: P08; LatencyClaimTruthStateV1; Offer\nui: Performance evidence Surface (N11)\nui.state: P08; LatencyClaimTruthStateV1; Require\nanalyze (H02): source[0]=spans.cut; target[0]=analysis.cut\nsupports (H28): evidence[0]=run.receipt; evidence[1]=analysis.result; claim[0]=claim.support\nrender (H02): source[0]=claim.state; target[0]=ui.state" }, { "id": "type-h29", "src": "/docs/img/theory/type-h29.svg", "alt": "H29 · Activation cohort — Activate a compatible client/server cohort", "text": "Which revisions must be admitted together?\nA cohort names a client contract, server implementation and state schema that are checked together for a release. Admission verifies compatibility before traffic routing; mixed-version rollout has an explicit policy. Cohort membership alone does not activate anything.\nreleases\ncode push\ndistributed systems\nLocal root publication can be atomic; cross-host realization is recoverable coordination.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nCohort is a release composition with admission rules; it is not a synonym for transaction scope.\nclient: Candidate client revision (N35)\nclient.ref: P23; ReleaseCohortRefsV1; Neutral\nclient.evidence: P24; CohortCompatibilityEvidenceV1; Offer\nserver: Candidate server revision (N35)\nserver.ref: P23; ReleaseCohortRefsV1; Neutral\nserver.evidence: P24; CohortCompatibilityEvidenceV1; Offer\nschema: Candidate state schema (N31)\nschema.ref: P23; ReleaseCohortRefsV1; Neutral\nadmit: Cohort admission (N03)\nadmit.cohort: P23; ReleaseCohortRefsV1; Neutral\nadmit.compatibility: P24; CohortCompatibilityEvidenceV1; Require\nadmit.switch: P09; AdmittedCohortRouteEpochV1; Require\nroute: Traffic route authority (N21)\nroute.switch: P09; AdmittedCohortRouteEpochV1; Offer\ncohort (H29): member[0]=client.ref; member[1]=server.ref; member[2]=schema.ref; coordinator[0]=admit.cohort\nevidence (H28): evidence[0]=client.evidence; evidence[1]=server.evidence; claim[0]=admit.compatibility\nswitch (H05): caller[0]=admit.switch; callee[0]=route.switch" }, { "id": "type-h30", "src": "/docs/img/theory/type-h30.svg", "alt": "H30 · Boundary export / alias — Export a feature endpoint through a nested graph", "text": "Which internal endpoint does the boundary expose?\nA conversation graph exports message state and send through explicit aliases. The parent binds those exports to presentation. Crossing HTTP still uses a service adapter; an alias preserves endpoint identity but supplies no transport.\nnested graphs\nFFI\ncomposition\nPreserve role, ownership and protocol when hiding/expanding a reusable region.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nExport/alias requires compatibility and source ownership; it must not erase authority, memory or process boundaries.\nrepository: Internal message repository (N25)\nrepository.state: P08; ConversationMessageStateV1; Offer\nrepository.send: P02; SendMessageRequestResponseV1; Require\nfeature: Conversation boundary (N10)\nfeature.messages: P08; ConversationMessageStateV1; Require\nfeature.parentState: P08; ConversationMessageStateV1; Offer\nparent: App composition (N10)\nparent.messages: P08; ConversationMessageStateV1; Require\nparent.state: P08; ConversationMessageStateV1; Offer\nui: Chat Surface (N11)\nui.state: P08; ConversationMessageStateV1; Require\nhttp: Messaging HTTP adapter (N15)\nhttp.send: P02; SendMessageRequestResponseV1; Offer\nexport-state (H30): export[0]=repository.state; import[0]=feature.messages\nparent (H30): export[0]=feature.parentState; import[0]=parent.messages\nrender (H02): source[0]=parent.state; target[0]=ui.state\nsend (H01): provider[0]=http.send; consumer[0]=repository.send" }, { "id": "type-h31", "src": "/docs/img/theory/type-h31.svg", "alt": "H31 · Clock / time alignment — Align camera and IMU observations", "text": "What uncertainty remains when clocks differ?\nA time-mapping relation records the camera and IMU clock domains and calibration evidence. Sensor fusion consumes timestamped observations with uncertainty bounds. It rejects samples outside the accepted alignment budget instead of comparing raw timestamps as one clock.\ntelemetry\nrobotics\nShadow\nAlignment needs a defined transform/uncertainty; timestamps do not establish causal order.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nClock alignment is a constraint with uncertainty; it is not a delivery barrier or a shared physical clock.\ncamera: Robot camera clock (N09)\ncamera.clock: P15; SensorClockMappingWithUncertaintyV1; Neutral\ncamera.sample: P01; CameraObservationWithClockV1; Offer\nimu: Robot IMU clock (N09)\nimu.clock: P15; SensorClockMappingWithUncertaintyV1; Neutral\nimu.sample: P01; ImuObservationWithClockV1; Offer\ncalibrate: Clock calibration (N01)\ncalibrate.mapping: P15; SensorClockMappingWithUncertaintyV1; Neutral\ncalibrate.evidence: P24; ClockCalibrationEvidenceV1; Offer\nfusion: Localization fusion (N01)\nfusion.camera: P01; CameraObservationWithClockV1; Require\nfusion.imu: P01; ImuObservationWithClockV1; Require\nevidence: Calibration evidence (N37)\nevidence.record: P24; ClockCalibrationEvidenceV1; Require\nalignment (H31): clock[0]=camera.clock; clock[1]=imu.clock; calibration[0]=calibrate.mapping\ncamera (H02): source[0]=camera.sample; target[0]=fusion.camera\nimu (H02): source[0]=imu.sample; target[0]=fusion.imu\nevidence (H27): source[0]=calibrate.evidence; target[0]=evidence.record" }, { "id": "type-h32", "src": "/docs/img/theory/type-h32.svg", "alt": "H32 · Tensor / algebraic operation — Apply a transform to a batch of positions", "text": "Where does the algebra execute?\nThe operand relation names matrix, position batch and result roles around an explicit Kotlin transform node. The node implements shape, precision and memory behavior; the relation records those roles without becoming a hidden tensor runtime.\nAI\nmedia\nrobotics\nValidate axes, units and device layout; computation belongs to the qualified implementation.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nAlgebraic pattern is a domain profile; arbitrary algorithms stay in Kotlin/common or qualified foreign implementations.\nmatrix: World transform matrix (N31)\nmatrix.value: P01; BatchTransformOperandsV1; Offer\npositions: Position batch (N26)\npositions.value: P01; BatchTransformOperandsV1; Offer\ntransform: Kotlin batch transform (N01)\ntransform.operands: P01; BatchTransformOperandsV1; Neutral\noutput: Transformed position buffer (N26)\noutput.result: P01; BatchTransformOperandsV1; Require\noutput.view: P17; TransformedPositionViewV1; Offer\nrender: Scene renderer (N16)\nrender.positions: P17; TransformedPositionViewV1; Require\noperands (H32): operand[0]=matrix.value; operand[1]=positions.value; operator[0]=transform.operands; result[0]=output.result\nrender (H02): source[0]=output.view; target[0]=render.positions" }, { "id": "type-h33", "src": "/docs/img/theory/type-h33.svg", "alt": "H33 · Fallback / preference set — Prefer cached content and fall back to network", "text": "What makes a fallback eligible?\nThe choice operator tries a cache only when its freshness satisfies the request, then uses the network path. Failure and cancellation policy are explicit. The preference relation names candidates while Kotlin logic implements the choice.\noffline mobile\nservices\ncapabilities\nFallbacks must remain eligible and authorized; never silently relax mandatory privacy or safety.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nPreference/fallback is composition, not merge-any or a race; candidate eligibility and ordering are explicit.\ncache: Content cache (N25)\ncache.offer: P19; ContentProviderPreferenceV1; Offer\ncache.read: P02; GetContentWithFreshnessV1; Offer\nnetwork: Content service (N19)\nnetwork.offer: P19; ContentProviderPreferenceV1; Offer\nnetwork.read: P02; GetContentWithFreshnessV1; Offer\nchoose: Freshness-aware content choice (N03)\nchoose.providers: P19; ContentProviderPreferenceV1; Require\nchoose.requirement: P01; ContentFreshnessRequirementV1; Require\nchoose.cache: P02; GetContentWithFreshnessV1; Require\nchoose.network: P02; GetContentWithFreshnessV1; Require\nchoose.state: P08; ContentResultStateV1; Offer\nui: Article Surface (N11)\nui.state: P08; ContentResultStateV1; Require\npolicy: Freshness requirement (N31)\npolicy.requirement: P01; ContentFreshnessRequirementV1; Offer\npreferences (H33): candidate[0]=cache.offer; candidate[1]=network.offer; result[0]=choose.providers\nfreshness (H02): source[0]=policy.requirement; target[0]=choose.requirement\ncache (H05): caller[0]=choose.cache; callee[0]=cache.read\nnetwork (H05): caller[0]=choose.network; callee[0]=network.read\nrender (H02): source[0]=choose.state; target[0]=ui.state" }, { "id": "type-h34", "src": "/docs/img/theory/type-h34.svg", "alt": "H34 · Data access / lineage — Separate permission from data lineage", "text": "Why must an access grant and derivation be two relations?\nA report query receives an authorized read grant, then derives a report from a selected source cut. The legacy H34 annotation groups the topic for navigation only. Authorization uses H23 and lineage uses H27, because origin never grants access and access never proves origin.\ndata\nlineage\ntenancy\nRecords the modeled access scope; enforce at actual storage boundary and disclose opaque access.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nRetire H34 as an executable combined type; retain its reference ID and decompose declarations into access and provenance.\npolicy: Report access policy (N33)\npolicy.grant: P20; OrderReportReadGrantV1; Offer\npolicy.receipt: P24; ReportAccessDecisionV1; Offer\nsource: Order source authority (N21)\nsource.read: P20; OrderReportReadGrantV1; Require\nsource.cut: P23; SalesReportSourceCutV1; Offer\nquery: Authorized report query (N22)\nquery.read: P20; OrderReportReadGrantV1; Require\nquery.topic: P24; LegacyAccessLineageTopicV1; Neutral\nreport: Derived sales report (N35)\nreport.source: P23; SalesReportSourceCutV1; Require\naudit: Access and origin evidence (N37)\naudit.topic: P24; LegacyAccessLineageTopicV1; Neutral\naudit.access: P24; ReportAccessDecisionV1; Require\ngrant (H23): principal[0]=policy.grant; resource[0]=source.read; resource[1]=query.read\nlineage (H27): source[0]=source.cut; target[0]=report.source\nlegacy-topic (H34): subject[0]=query.topic; record[0]=audit.topic\nreceipt (H27): source[0]=policy.receipt; target[0]=audit.access" }, { "id": "type-h35", "src": "/docs/img/theory/type-h35.svg", "alt": "H35 · State migration — Hand off a partition with fenced writers", "text": "Who may write after state transfer?\nThe old owner drains at a cut, the candidate restores compatible state, and the authority advances the ownership epoch. Requests carrying an old epoch are rejected. Transfer evidence records both revisions and cut so an incomplete handoff is visible.\ncode push\ndata\nmigrations\nVersion checkpoints, fence writers and validate postconditions; inverse may not exist.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nState migration is an orchestrated profile with fencing and compatibility, not a guarantee supplied by an edge kind.\nold: Old partition owner (N05)\nold.checkpoint: P22; PartitionCheckpointAtCutV1; Offer\nold.handoff: P22; PartitionOwnershipEpochV1; Neutral\nnext: Candidate partition owner (N05)\nnext.restore: P22; PartitionCheckpointAtCutV1; Require\nnext.handoff: P22; PartitionOwnershipEpochV1; Neutral\nepoch: Partition epoch authority (N21)\nepoch.handoff: P22; PartitionOwnershipEpochV1; Offer\nepoch.receipt: P24; PartitionHandoffEvidenceV1; Offer\ncheckpoint: Partition checkpoint (N26)\ncheckpoint.write: P22; PartitionCheckpointAtCutV1; Require\ncheckpoint.read: P22; PartitionCheckpointAtCutV1; Offer\nevidence: Handoff receipt (N37)\nevidence.record: P24; PartitionHandoffEvidenceV1; Require\ncheckpoint (H02): source[0]=old.checkpoint; target[0]=checkpoint.write\nrestore (H05): caller[0]=next.restore; callee[0]=checkpoint.read\nhandoff (H35): old[0]=old.handoff; new[0]=next.handoff; authority[0]=epoch.handoff\nreceipt (H27): source[0]=epoch.receipt; target[0]=evidence.record" }, { "id": "type-h36", "src": "/docs/img/theory/type-h36.svg", "alt": "H36 · Navigation / interaction route — Navigate from a list to a detail screen and back", "text": "What carries route state and return data?\nA list interaction invokes RouteNode push with the selected item. routeBinding supplies detail presentation and navBinding supplies host navigation. Editing returns a versioned result through back(return), which refreshes list state; Compose binds those contracts without a parallel navigation store.\nnavigation\nCompose\ndeep links\nChoose destination with guards and grants; back-stack and cancellation semantics are explicit.\nThe junction is a rendering of this relation and its incidence slots; it is not a new executable broker or computation node.\nNavigation is a domain composition over state, control and lifecycle; entering a route does not grant backend authority.\nlist: Item list Surface (N11)\nlist.open: P11; ItemDetailRoutePayloadV1; Offer\nlist.state: P08; ItemListStateV1; Require\nroute: Item detail RouteNode (N12)\nroute.push: P11; ItemDetailRoutePayloadV1; Require\nroute.routeBinding: P08; ItemDetailRouteBindingV1; Offer\nroute.navBinding: P08; ItemNavigationBindingV1; Offer\nroute.return: P01; EditedItemReturnV1; Offer\ndetail: Compose detail Surface (N11)\ndetail.routeBinding: P08; ItemDetailRouteBindingV1; Require\nhost: Navigation container (N10)\nhost.navBinding: P08; ItemNavigationBindingV1; Require\nstate: Item list state (N05)\nstate.result: P01; EditedItemReturnV1; Require\nstate.state: P08; ItemListStateV1; Offer\npush (H36): source[0]=list.open; target[0]=route.push\nroute-binding (H30): export[0]=route.routeBinding; import[0]=detail.routeBinding\nnavigation (H30): export[0]=route.navBinding; import[0]=host.navBinding\nreturn (H36): source[0]=route.return; target[0]=state.result\nrender (H02): source[0]=state.state; target[0]=list.state" } ], "title": "Hyperedges", "nav": "Hyperedges", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-hyperedge-theory", "revision": "d1b9fb3b9d870d4607c0000b857b073dbf3c7099a05ee1de3f0374010a2ec0db", "status": "design", "renderingRevision": "c28674a14a3787937c22f7f6f053928adab54bcfcb2db1c4453566b01e1ba1eb", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "incidence-preserves-meaning", "relation-schemas-supply-operational-laws", "a-gcp-pubsub-realization", "frequently-confused-patterns", "composition-and-aliases", "reading-the-examples" ], "externalLinks": [ "https://www.w3.org/TR/prov-overview/", "https://docs.cloud.google.com/pubsub/docs/subscription-overview", "https://doc.akka.io/libraries/akka-core/current/typed/fault-tolerance.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory", "polarity": "Neutral" }, { "id": "section-incidence-preserves-meaning", "anchor": "relation-laws", "label": "Role positions and laws", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#relation-laws", "polarity": "Neutral" }, { "id": "section-relation-schemas-supply-operational-laws", "anchor": "relation-laws", "label": "Role positions and laws", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#relation-laws", "polarity": "Neutral" }, { "id": "section-frequently-confused-patterns", "anchor": "hyperedge-consolidation", "label": "Consolidation decisions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#hyperedge-consolidation", "polarity": "Neutral" }, { "id": "section-composition-and-aliases", "anchor": "hyperedge-consolidation", "label": "Consolidation decisions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#hyperedge-consolidation", "polarity": "Neutral" }, { "id": "section-reading-the-examples", "anchor": "hyperedge-classification", "label": "Laws, constraints and compositions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#hyperedge-classification", "polarity": "Neutral" }, { "id": "type-h01", "anchor": "type-h01", "label": "H01 · Exclusive binding — Bind a repository to a real service or a mock", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h01", "polarity": "Neutral" }, { "id": "type-h02", "anchor": "type-h02", "label": "H02 · Value flow — Calculate invoice totals from line items", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h02", "polarity": "Neutral" }, { "id": "type-h03", "anchor": "type-h03", "label": "H03 · Control precedence — Remove user data in a safe order", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h03", "polarity": "Neutral" }, { "id": "type-h04", "anchor": "type-h04", "label": "H04 · Event subscription — Process order events with dead-letter handling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h04", "polarity": "Neutral" }, { "id": "type-h05", "anchor": "type-h05", "label": "H05 · Request / reply binding — Load a profile with a deadline", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h05", "polarity": "Neutral" }, { "id": "type-h06", "anchor": "type-h06", "label": "H06 · Multiparty session — Coordinate a multiplayer match session", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h06", "polarity": "Neutral" }, { "id": "type-h07", "anchor": "type-h07", "label": "H07 · Broadcast / fanout — Invalidate caches after a configuration change", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h07", "polarity": "Neutral" }, { "id": "type-h08", "anchor": "type-h08", "label": "H08 · Merge-any — Merge notification sources into one inbox", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h08", "polarity": "Neutral" }, { "id": "type-h09", "anchor": "type-h09", "label": "H09 · Join-all — Assemble a profile from required reads", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h09", "polarity": "Neutral" }, { "id": "type-h10", "anchor": "type-h10", "label": "H10 · Race / select — Race mirrors for an asset", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h10", "polarity": "Neutral" }, { "id": "type-h11", "anchor": "type-h11", "label": "H11 · Keyed temporal join — Match payments with orders by time and key", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h11", "polarity": "Neutral" }, { "id": "type-h12", "anchor": "type-h12", "label": "H12 · Barrier / synchronization — Start a match after all players are ready", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h12", "polarity": "Neutral" }, { "id": "type-h13", "anchor": "type-h13", "label": "H13 · Quorum requirement — Approve a replicated write with a quorum", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h13", "polarity": "Neutral" }, { "id": "type-h14", "anchor": "type-h14", "label": "H14 · Replica group — Read from a replica group with explicit consistency", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h14", "polarity": "Neutral" }, { "id": "type-h15", "anchor": "type-h15", "label": "H15 · Partition / route — Route conversations to partitions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h15", "polarity": "Neutral" }, { "id": "type-h16", "anchor": "type-h16", "label": "H16 · Atomic authority scope — Commit a membership and its audit row together", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h16", "polarity": "Neutral" }, { "id": "type-h17", "anchor": "type-h17", "label": "H17 · Compensation relation — Refund after fulfilment cannot complete", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h17", "polarity": "Neutral" }, { "id": "type-h18", "anchor": "type-h18", "label": "H18 · Supervision — Restart a failed worker without duplicating its work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h18", "polarity": "Neutral" }, { "id": "type-h19", "anchor": "type-h19", "label": "H19 · Ownership / containment — Own resources inside a feature scope", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h19", "polarity": "Neutral" }, { "id": "type-h20", "anchor": "type-h20", "label": "H20 · Instantiation — Instantiate a reusable tenant service", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h20", "polarity": "Neutral" }, { "id": "type-h21", "anchor": "type-h21", "label": "H21 · Placement — Place an image worker near storage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h21", "polarity": "Neutral" }, { "id": "type-h22", "anchor": "type-h22", "label": "H22 · Affinity / separation — Separate primary and backup across zones", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h22", "polarity": "Neutral" }, { "id": "type-h23", "anchor": "type-h23", "label": "H23 · Scoped authorization — Restrict a docs graph to one principal", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h23", "polarity": "Neutral" }, { "id": "type-h24", "anchor": "type-h24", "label": "H24 · Capability resolution — Select a map renderer without platform conditionals", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h24", "polarity": "Neutral" }, { "id": "type-h25", "anchor": "type-h25", "label": "H25 · Implements / source ownership — Link a graph service to its source implementation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h25", "polarity": "Neutral" }, { "id": "type-h26", "anchor": "type-h26", "label": "H26 · Artifact dependency — Build only artifacts affected by a contract edit", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h26", "polarity": "Neutral" }, { "id": "type-h27", "anchor": "type-h27", "label": "H27 · Derivation / provenance — Trace a PDF to the exact docs revision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h27", "polarity": "Neutral" }, { "id": "type-h28", "anchor": "type-h28", "label": "H28 · Evidence supports claim — Support an end-to-end latency claim", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h28", "polarity": "Neutral" }, { "id": "type-h29", "anchor": "type-h29", "label": "H29 · Activation cohort — Activate a compatible client/server cohort", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h29", "polarity": "Neutral" }, { "id": "type-h30", "anchor": "type-h30", "label": "H30 · Boundary export / alias — Export a feature endpoint through a nested graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h30", "polarity": "Neutral" }, { "id": "type-h31", "anchor": "type-h31", "label": "H31 · Clock / time alignment — Align camera and IMU observations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h31", "polarity": "Neutral" }, { "id": "type-h32", "anchor": "type-h32", "label": "H32 · Tensor / algebraic operation — Apply a transform to a batch of positions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h32", "polarity": "Neutral" }, { "id": "type-h33", "anchor": "type-h33", "label": "H33 · Fallback / preference set — Prefer cached content and fall back to network", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h33", "polarity": "Neutral" }, { "id": "type-h34", "anchor": "type-h34", "label": "H34 · Data access / lineage — Separate permission from data lineage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h34", "polarity": "Neutral" }, { "id": "type-h35", "anchor": "type-h35", "label": "H35 · State migration — Hand off a partition with fenced writers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h35", "polarity": "Neutral" }, { "id": "type-h36", "anchor": "type-h36", "label": "H36 · Navigation / interaction route — Navigate from a list to a detail screen and back", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#type-h36", "polarity": "Neutral" }, { "id": "hyperedge-adapters", "anchor": "hyperedge-adapters", "label": "Concrete adapters and domain scope", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-hyperedge-theory#hyperedge-adapters", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-hyperedge-theory:references-reaktor-system-atlas", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "section-reading-the-examples", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:requires-reaktor-graph-theory", "kind": "requires", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:requires-reaktor-graph-vocabulary-theory", "kind": "requires", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:derived-from-architecture-atlas-vocabulary", "kind": "derived-from", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "architecture-atlas-vocabulary", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:explains-reaktor-system-atlas", "kind": "explains", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-system-atlas", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h01-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h01", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h02-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h02", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h03-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h03", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h04-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h04", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h05-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h05", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h06-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h06", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h07-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h07", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h08-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h08", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h09-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h09", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h10-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h10", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h11-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h11", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h12-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h12", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h13-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h13", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h14-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h14", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h15-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h15", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h16-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h16", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h17-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h17", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h18-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h18", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h19-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h19", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h20-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h20", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h21-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h21", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h22-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h22", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h23-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h23", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h24-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h24", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h25-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h25", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h26-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h26", "role": "source", "ordinal": 0 }, { "node": "reaktor-dependeasy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h27-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h27", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h28-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h28", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h29-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h29", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h30-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h30", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h31-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h31", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h32-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h32", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h33-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h33", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h34-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h34", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h35-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h35", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:type-h36-module", "kind": "references", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "type-h36", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:topic-reaktor-port-theory", "kind": "explains", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-port-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:topic-reaktor-nested-graphs-theory", "kind": "explains", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-hyperedge-theory:topic-reaktor-graph-views-theory", "kind": "explains", "owner": "reaktor-hyperedge-theory", "incidences": [ { "node": "reaktor-hyperedge-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-views-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-hyperedge-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Hyperedges", "level": 0 }, { "id": "relation-laws", "anchor": "relation-laws", "title": "Role positions and laws", "level": 2 }, { "id": "hyperedge-classification", "anchor": "hyperedge-classification", "title": "Laws, constraints and compositions", "level": 2 }, { "id": "hyperedge-consolidation", "anchor": "hyperedge-consolidation", "title": "Consolidation decisions", "level": 2 }, { "id": "hyperedge-adapters", "anchor": "hyperedge-adapters", "title": "Concrete adapters and domain scope", "level": 2 }, { "id": "type-h01", "anchor": "type-h01", "title": "H01 · Exclusive binding — Bind a repository to a real service or a mock", "level": 2 }, { "id": "type-h02", "anchor": "type-h02", "title": "H02 · Value flow — Calculate invoice totals from line items", "level": 2 }, { "id": "type-h03", "anchor": "type-h03", "title": "H03 · Control precedence — Remove user data in a safe order", "level": 2 }, { "id": "type-h04", "anchor": "type-h04", "title": "H04 · Event subscription — Process order events with dead-letter handling", "level": 2 }, { "id": "type-h05", "anchor": "type-h05", "title": "H05 · Request / reply binding — Load a profile with a deadline", "level": 2 }, { "id": "type-h06", "anchor": "type-h06", "title": "H06 · Multiparty session — Coordinate a multiplayer match session", "level": 2 }, { "id": "type-h07", "anchor": "type-h07", "title": "H07 · Broadcast / fanout — Invalidate caches after a configuration change", "level": 2 }, { "id": "type-h08", "anchor": "type-h08", "title": "H08 · Merge-any — Merge notification sources into one inbox", "level": 2 }, { "id": "type-h09", "anchor": "type-h09", "title": "H09 · Join-all — Assemble a profile from required reads", "level": 2 }, { "id": "type-h10", "anchor": "type-h10", "title": "H10 · Race / select — Race mirrors for an asset", "level": 2 }, { "id": "type-h11", "anchor": "type-h11", "title": "H11 · Keyed temporal join — Match payments with orders by time and key", "level": 2 }, { "id": "type-h12", "anchor": "type-h12", "title": "H12 · Barrier / synchronization — Start a match after all players are ready", "level": 2 }, { "id": "type-h13", "anchor": "type-h13", "title": "H13 · Quorum requirement — Approve a replicated write with a quorum", "level": 2 }, { "id": "type-h14", "anchor": "type-h14", "title": "H14 · Replica group — Read from a replica group with explicit consistency", "level": 2 }, { "id": "type-h15", "anchor": "type-h15", "title": "H15 · Partition / route — Route conversations to partitions", "level": 2 }, { "id": "type-h16", "anchor": "type-h16", "title": "H16 · Atomic authority scope — Commit a membership and its audit row together", "level": 2 }, { "id": "type-h17", "anchor": "type-h17", "title": "H17 · Compensation relation — Refund after fulfilment cannot complete", "level": 2 }, { "id": "type-h18", "anchor": "type-h18", "title": "H18 · Supervision — Restart a failed worker without duplicating its work", "level": 2 }, { "id": "type-h19", "anchor": "type-h19", "title": "H19 · Ownership / containment — Own resources inside a feature scope", "level": 2 }, { "id": "type-h20", "anchor": "type-h20", "title": "H20 · Instantiation — Instantiate a reusable tenant service", "level": 2 }, { "id": "type-h21", "anchor": "type-h21", "title": "H21 · Placement — Place an image worker near storage", "level": 2 }, { "id": "type-h22", "anchor": "type-h22", "title": "H22 · Affinity / separation — Separate primary and backup across zones", "level": 2 }, { "id": "type-h23", "anchor": "type-h23", "title": "H23 · Scoped authorization — Restrict a docs graph to one principal", "level": 2 }, { "id": "type-h24", "anchor": "type-h24", "title": "H24 · Capability resolution — Select a map renderer without platform conditionals", "level": 2 }, { "id": "type-h25", "anchor": "type-h25", "title": "H25 · Implements / source ownership — Link a graph service to its source implementation", "level": 2 }, { "id": "type-h26", "anchor": "type-h26", "title": "H26 · Artifact dependency — Build only artifacts affected by a contract edit", "level": 2 }, { "id": "type-h27", "anchor": "type-h27", "title": "H27 · Derivation / provenance — Trace a PDF to the exact docs revision", "level": 2 }, { "id": "type-h28", "anchor": "type-h28", "title": "H28 · Evidence supports claim — Support an end-to-end latency claim", "level": 2 }, { "id": "type-h29", "anchor": "type-h29", "title": "H29 · Activation cohort — Activate a compatible client/server cohort", "level": 2 }, { "id": "type-h30", "anchor": "type-h30", "title": "H30 · Boundary export / alias — Export a feature endpoint through a nested graph", "level": 2 }, { "id": "type-h31", "anchor": "type-h31", "title": "H31 · Clock / time alignment — Align camera and IMU observations", "level": 2 }, { "id": "type-h32", "anchor": "type-h32", "title": "H32 · Tensor / algebraic operation — Apply a transform to a batch of positions", "level": 2 }, { "id": "type-h33", "anchor": "type-h33", "title": "H33 · Fallback / preference set — Prefer cached content and fall back to network", "level": 2 }, { "id": "type-h34", "anchor": "type-h34", "title": "H34 · Data access / lineage — Separate permission from data lineage", "level": 2 }, { "id": "type-h35", "anchor": "type-h35", "title": "H35 · State migration — Hand off a partition with fenced writers", "level": 2 }, { "id": "type-h36", "anchor": "type-h36", "title": "H36 · Navigation / interaction route — Navigate from a list to a detail screen and back", "level": 2 } ], "links": [ { "id": "reaktor-hyperedge-theory", "anchor": "type-h04", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h08", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h09", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h10", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h15", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h23", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h34", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h01", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h02", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h03", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h04", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h05", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h06", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h07", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h08", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h09", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h10", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h11", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h12", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h13", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h14", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h15", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h17", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h18", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h20", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h29", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h35", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h36", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h16", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h19", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h23", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h24", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h30", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h21", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h22", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h31", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h25", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h26", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h27", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h28", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h32", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h33", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-hyperedge-theory", "anchor": "type-h34", "relation": "references", "sourceAnchor": "hyperedge-classification" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-h01" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "type-h02" }, { "id": "reaktor-graph-distribution-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-h03" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "type-h04" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-h05" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "type-h06" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "type-h07" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "type-h08" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-h09" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "type-h10" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "type-h11" }, { "id": "reaktor-graph-distribution-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-h12" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "type-h13" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "type-h14" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "type-h15" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "type-h16" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "type-h17" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "type-h18" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "type-h19" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "type-h20" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "type-h21" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "type-h22" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "type-h23" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "type-h24" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-h25" }, { "id": "reaktor-dependeasy", "anchor": "", "relation": "references", "sourceAnchor": "type-h26" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "type-h27" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "type-h28" }, { "id": "reaktor-graph-distribution-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-h29" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "type-h30" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "type-h31" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "type-h32" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "type-h33" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "type-h34" }, { "id": "reaktor-graph-distribution-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-h35" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "type-h36" } ] }, { "id": "reaktor-implementation-plan", "owner": "Claude", "kind": "plan", "summary": "Execution plan for moving from prototype to production workbench and Compose/web targets.", "use": "Historical delivery proposal. Use the Astra system plan and module execution plan for current direction and acceptance criteria.", "region": "background-roadmaps", "order": 2, "title": "Implementation Plan", "nav": "Implementation Plan", "group": "background", "subsection": "background-roadmaps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-implementation-plan", "revision": "1cf2e42b862f3325d4b30bde3740aceb319a64c168e433f23a998866ebfda4f0", "status": "superseded", "renderingRevision": "201d437066c7500c0701d12dfb12dabdccc8d4415db358a4b630a78294bdc411", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-implementation-plan", "polarity": "Neutral" }, { "id": "section-inventory", "anchor": "inventory", "label": "✓ 1. Inventory — What Already Exists", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-implementation-plan#inventory", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "◎ 2. Target Architecture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-implementation-plan#architecture", "polarity": "Neutral" }, { "id": "section-mapping", "anchor": "mapping", "label": "⇄ 14. Feature Mapping — Prototype → Compose", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-implementation-plan#mapping", "polarity": "Neutral" }, { "id": "section-schedule", "anchor": "schedule", "label": "⏱ 15. Implementation Schedule", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-implementation-plan#schedule", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-implementation-plan#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-implementation-plan:references-codex-roadmap", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "codex-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-implementation-plan:references-reaktor-workbench-roadmap", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-implementation-plan:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-implementation-plan:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-implementation-plan:references-reaktor-devops", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-implementation-plan:references-reaktor-framework-overview", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-implementation-plan:current-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-implementation-plan:current-reaktor-module-execution-plan", "kind": "references", "owner": "reaktor-implementation-plan", "incidences": [ { "node": "reaktor-implementation-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-implementation-plan.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Implementation Plan", "level": 0 }, { "id": "inventory", "anchor": "inventory", "title": "✓ 1. Inventory — What Already Exists", "level": 2 }, { "id": "reaktor-modules-production-quality", "anchor": "reaktor-modules-production-quality", "title": "Reaktor Modules (production-quality)", "level": 3 }, { "id": "engine-module-bestbudsmodulesengine", "anchor": "engine-module-bestbudsmodulesengine", "title": "Engine Module (bestbuds/modules/engine)", "level": 3 }, { "id": "what-the-web-prototype-has-that-the-engine-does-not", "anchor": "what-the-web-prototype-has-that-the-engine-does-not", "title": "What the web prototype has that the engine does NOT", "level": 3 }, { "id": "architecture", "anchor": "architecture", "title": "◎ 2. Target Architecture", "level": 2 }, { "id": "module-dependency-chain", "anchor": "module-dependency-chain", "title": "Module Dependency Chain", "level": 3 }, { "id": "new-module-reaktor-workbench", "anchor": "new-module-reaktor-workbench", "title": "New Module: reaktor-workbench", "level": 3 }, { "id": "directory-structure", "anchor": "directory-structure", "title": "Directory Structure", "level": 4 }, { "id": "data-flow", "anchor": "data-flow", "title": "Data Flow", "level": 3 }, { "id": "11-workbenchstate-viewmodel", "anchor": "11-workbenchstate-viewmodel", "title": "1.1 WorkbenchState ViewModel", "level": 3 }, { "id": "12-workbenchshell-composable", "anchor": "12-workbenchshell-composable", "title": "1.2 WorkbenchShell Composable", "level": 3 }, { "id": "13-cross-mode-navigation", "anchor": "13-cross-mode-navigation", "title": "1.3 Cross-Mode Navigation", "level": 3 }, { "id": "14-keyboard-shortcuts", "anchor": "14-keyboard-shortcuts", "title": "1.4 Keyboard Shortcuts", "level": 3 }, { "id": "15-porting-from-existing-engine-code", "anchor": "15-porting-from-existing-engine-code", "title": "1.5 Porting from Existing Engine Code", "level": 3 }, { "id": "existing-in-reaktor-flow", "anchor": "existing-in-reaktor-flow", "title": "Existing in reaktor-flow", "level": 3 }, { "id": "to-add", "anchor": "to-add", "title": "To add", "level": 3 }, { "id": "effort-estimate", "anchor": "effort-estimate", "title": "Effort estimate", "level": 3 }, { "id": "existing-in-engine", "anchor": "existing-in-engine", "title": "Existing in Engine", "level": 3 }, { "id": "to-build", "anchor": "to-build", "title": "To build", "level": 3 }, { "id": "deviceframe-composable", "anchor": "deviceframe-composable", "title": "DeviceFrame composable", "level": 4 }, { "id": "runmodecontrols", "anchor": "runmodecontrols", "title": "RunModeControls", "level": 4 }, { "id": "bidirectional-component-tree--entity-selection", "anchor": "bidirectional-component-tree--entity-selection", "title": "Bidirectional Component Tree ↔ Entity Selection", "level": 4 }, { "id": "floating-graph-link-card", "anchor": "floating-graph-link-card", "title": "Floating Graph Link Card", "level": 4 }, { "id": "platform-difference", "anchor": "platform-difference", "title": "Platform difference", "level": 3 }, { "id": "data-source", "anchor": "data-source", "title": "Data source", "level": 3 }, { "id": "components", "anchor": "components", "title": "Components", "level": 3 }, { "id": "tracerail", "anchor": "tracerail", "title": "TraceRail", "level": 4 }, { "id": "blastradiuspanel", "anchor": "blastradiuspanel", "title": "BlastRadiusPanel", "level": 4 }, { "id": "testimpactpanel", "anchor": "testimpactpanel", "title": "TestImpactPanel", "level": 4 }, { "id": "connection-to-graph-runtime", "anchor": "connection-to-graph-runtime", "title": "Connection to graph runtime", "level": 3 }, { "id": "components-1", "anchor": "components-1", "title": "Components", "level": 3 }, { "id": "deploytopology", "anchor": "deploytopology", "title": "DeployTopology", "level": 4 }, { "id": "cipipeline", "anchor": "cipipeline", "title": "CIPipeline", "level": 4 }, { "id": "deploymodecontrols", "anchor": "deploymodecontrols", "title": "DeployModeControls", "level": 4 }, { "id": "real-integration-path", "anchor": "real-integration-path", "title": "Real integration path", "level": 3 }, { "id": "components-2", "anchor": "components-2", "title": "Components", "level": 3 }, { "id": "insightstimeline", "anchor": "insightstimeline", "title": "InsightsTimeline", "level": 4 }, { "id": "insightsheatmap", "anchor": "insightsheatmap", "title": "InsightsHeatmap", "level": 4 }, { "id": "metric-cards", "anchor": "metric-cards", "title": "Metric Cards", "level": 4 }, { "id": "platform-data-sources", "anchor": "platform-data-sources", "title": "Platform data sources", "level": 3 }, { "id": "type-dispatch", "anchor": "type-dispatch", "title": "Type dispatch", "level": 3 }, { "id": "inspector-body-structure-each-type", "anchor": "inspector-body-structure-each-type", "title": "Inspector body structure (each type)", "level": 3 }, { "id": "mode-sensitive-sections", "anchor": "mode-sensitive-sections", "title": "Mode-sensitive sections", "level": 3 }, { "id": "sparkline-composable", "anchor": "sparkline-composable", "title": "Sparkline composable", "level": 3 }, { "id": "command-palette-cmdk", "anchor": "command-palette-cmdk", "title": "Command Palette (Cmd+K)", "level": 3 }, { "id": "agent-chat-interface", "anchor": "agent-chat-interface", "title": "Agent Chat Interface", "level": 3 }, { "id": "graphcommand-hierarchy", "anchor": "graphcommand-hierarchy", "title": "GraphCommand Hierarchy", "level": 3 }, { "id": "command-lifecycle", "anchor": "command-lifecycle", "title": "Command Lifecycle", "level": 3 }, { "id": "llm-integration", "anchor": "llm-integration", "title": "LLM Integration", "level": 3 }, { "id": "context-assembly", "anchor": "context-assembly", "title": "Context Assembly", "level": 4 }, { "id": "ide-bridge", "anchor": "ide-bridge", "title": "IDE Bridge", "level": 4 }, { "id": "persistence", "anchor": "persistence", "title": "Persistence", "level": 3 }, { "id": "strategy", "anchor": "strategy", "title": "Strategy", "level": 3 }, { "id": "reaktorweb-compose-target", "anchor": "reaktorweb-compose-target", "title": "reaktorWeb-compose target", "level": 4 }, { "id": "platform-specific-code-jsmain", "anchor": "platform-specific-code-jsmain", "title": "Platform-specific code (jsMain)", "level": 3 }, { "id": "transition-from-current-web-prototype", "anchor": "transition-from-current-web-prototype", "title": "Transition from current web prototype", "level": 3 }, { "id": "mapping", "anchor": "mapping", "title": "⇄ 14. Feature Mapping — Prototype → Compose", "level": 2 }, { "id": "schedule", "anchor": "schedule", "title": "⏱ 15. Implementation Schedule", "level": 2 }, { "id": "dependency-graph", "anchor": "dependency-graph", "title": "Dependency Graph", "level": 3 }, { "id": "estimated-effort", "anchor": "estimated-effort", "title": "Estimated Effort", "level": 3 }, { "id": "timeline", "anchor": "timeline", "title": "Timeline", "level": 3 }, { "id": "key-risk-composejs-maturity", "anchor": "key-risk-composejs-maturity", "title": "Key Risk: Compose/JS Maturity", "level": 3 }, { "id": "key-advantage-real-data", "anchor": "key-advantage-real-data", "title": "Key Advantage: Real Data", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "codex-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-workbench-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-instrumentation-plan", "owner": "Claude", "kind": "architecture", "summary": "October source reconciliation and current delivery gates, retaining the September numbered instrumentation register as dated design.", "use": "Select remaining work from current gates; qualify historical item notes against source.", "region": "operations-delivery", "order": 1, "title": "Reaktor Instrumentation Plan", "nav": "Instrumentation Plan", "group": "operations", "subsection": "operations-delivery", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-instrumentation-plan", "revision": "1c4a08446cf12ff08d71115add06ff639d3a797bc43b2b87e403994a62040597", "status": "unverified", "renderingRevision": "b4f3a2d0a1d1dede86b3ad5ac9359098dbff97c9a210df576c290018d0407b77", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan", "polarity": "Neutral" }, { "id": "section-phase-zero", "anchor": "phase-zero", "label": "0. Current gates — complete the existing substrate", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#phase-zero", "polarity": "Neutral" }, { "id": "section-september-design-register", "anchor": "september-design-register", "label": "September design register", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#september-design-register", "polarity": "Neutral" }, { "id": "section-layer-a", "anchor": "layer-a", "label": "1. Layer A — reaktor-tooling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#layer-a", "polarity": "Neutral" }, { "id": "section-layer-b", "anchor": "layer-b", "label": "2. Layer B — the rgp/1 spine", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#layer-b", "polarity": "Neutral" }, { "id": "section-layer-c", "anchor": "layer-c", "label": "3. Layer C — reaktor-performance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#layer-c", "polarity": "Neutral" }, { "id": "section-layer-k", "anchor": "layer-k", "label": "4. Layer K — two kernel primitives", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#layer-k", "polarity": "Neutral" }, { "id": "section-build-vs-adopt", "anchor": "build-vs-adopt", "label": "8. Build versus adopt", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#build-vs-adopt", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#related-docs", "polarity": "Neutral" }, { "id": "section-layer-d", "anchor": "layer-d", "label": "5. Layer D — reaktor-telemetry", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#layer-d", "polarity": "Neutral" }, { "id": "section-layer-e", "anchor": "layer-e", "label": "6. Layer E — DevTools and the workbench", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#layer-e", "polarity": "Neutral" }, { "id": "section-schedule", "anchor": "schedule", "label": "9. Historical sequencing register", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#schedule", "polarity": "Neutral" }, { "id": "section-review-sequencing", "anchor": "review-sequencing", "label": "Sequencing changes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-instrumentation-plan#review-sequencing", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-instrumentation-plan:references-operations", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-operations-delivery", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-phase-zero", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-operations-instance-diagnostics", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-phase-zero", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-operations-profiling", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-phase-zero", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-operations-load-resilience", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-phase-zero", "role": "source", "ordinal": 0 }, { "node": "operations-load-resilience", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-shadow-capture-fabric", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-phase-zero", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-devtools", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-september-design-register", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-tooling-layer", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-layer-a", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-graph-protocol-revision-digest", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-layer-b", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-revision-digest", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-performance-observability-verified", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-layer-c", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "section-verified", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-analytics-telemetry-graph-native", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-layer-d", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "section-graph-native", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-devtools-investigation", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-layer-e", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "section-investigation", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-tooling-layer-the-fidelity-ladder", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-schedule", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "section-the-fidelity-ladder", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-agent-workspace", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-review-sequencing", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-performance-observability", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-reaktor-ui-ux-audit-2026-09-08", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-instrumentation-plan:references-operations-crashlytics", "kind": "references", "owner": "reaktor-instrumentation-plan", "incidences": [ { "node": "reaktor-instrumentation-plan", "port": "section-phase-zero", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "section-acceptance", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-instrumentation-plan.json", "sections": [ { "id": "reaktor-instrumentation-plan", "anchor": "reaktor-instrumentation-plan", "title": "Reaktor Instrumentation Plan", "level": 1 }, { "id": "phase-zero", "anchor": "phase-zero", "title": "0. Current gates — complete the existing substrate", "level": 2 }, { "id": "september-design-register", "anchor": "september-design-register", "title": "September design register", "level": 2 }, { "id": "layer-a", "anchor": "layer-a", "title": "1. Layer A — reaktor-tooling", "level": 2 }, { "id": "layer-b", "anchor": "layer-b", "title": "2. Layer B — the rgp/1 spine", "level": 2 }, { "id": "layer-c", "anchor": "layer-c", "title": "3. Layer C — reaktor-performance", "level": 2 }, { "id": "layer-k", "anchor": "layer-k", "title": "4. Layer K — two kernel primitives", "level": 2 }, { "id": "k1", "anchor": "k1", "title": "K1 — implemented port interception", "level": 3 }, { "id": "k2", "anchor": "k2", "title": "K2 — implemented typed attachments", "level": 3 }, { "id": "k-removed", "anchor": "k-removed", "title": "What this removes", "level": 3 }, { "id": "k3", "anchor": "k3", "title": "K3 — ExecutionContext", "level": 3 }, { "id": "k-remaining", "anchor": "k-remaining", "title": "What still needs more than K1 and K2", "level": 3 }, { "id": "layer-d", "anchor": "layer-d", "title": "5. Layer D — reaktor-telemetry", "level": 2 }, { "id": "layer-e", "anchor": "layer-e", "title": "6. Layer E — DevTools and the workbench", "level": 2 }, { "id": "e-shell", "anchor": "e-shell", "title": "E0 — the shell", "level": 3 }, { "id": "e-surfaces", "anchor": "e-surfaces", "title": "E1–E6 — the surfaces", "level": 3 }, { "id": "e-cross", "anchor": "e-cross", "title": "E7 — cross-cutting", "level": 3 }, { "id": "parity", "anchor": "parity", "title": "7. Industry parity map", "level": 2 }, { "id": "declined", "anchor": "declined", "title": "Deliberately declined", "level": 3 }, { "id": "build-vs-adopt", "anchor": "build-vs-adopt", "title": "8. Build versus adopt", "level": 2 }, { "id": "schedule", "anchor": "schedule", "title": "9. Historical sequencing register", "level": 2 }, { "id": "review-corrections", "anchor": "review-corrections", "title": "10. Review corrections, 13 September 2026", "level": 2 }, { "id": "verified-defects", "anchor": "verified-defects", "title": "Verified by running the code", "level": 3 }, { "id": "contract-corrections", "anchor": "contract-corrections", "title": "Contract corrections", "level": 3 }, { "id": "review-sequencing", "anchor": "review-sequencing", "title": "Sequencing changes", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-crashlytics", "anchor": "acceptance", "relation": "references", "sourceAnchor": "phase-zero" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "phase-zero" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "phase-zero" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "phase-zero" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "phase-zero" }, { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "phase-zero" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "september-design-register" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "layer-a" }, { "id": "reaktor-graph-protocol", "anchor": "revision-digest", "relation": "references", "sourceAnchor": "layer-b" }, { "id": "performance-observability", "anchor": "verified", "relation": "references", "sourceAnchor": "layer-c" }, { "id": "reaktor-analytics-telemetry", "anchor": "graph-native", "relation": "references", "sourceAnchor": "layer-d" }, { "id": "reaktor-devtools", "anchor": "investigation", "relation": "references", "sourceAnchor": "layer-e" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "parity" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "schedule" }, { "id": "reaktor-tooling-layer", "anchor": "the-fidelity-ladder", "relation": "references", "sourceAnchor": "schedule" }, { "id": "reaktor-instrumentation-plan", "anchor": "phase-zero", "relation": "references", "sourceAnchor": "verified-defects" }, { "id": "reaktor-instrumentation-plan", "anchor": "phase-zero", "relation": "references", "sourceAnchor": "contract-corrections" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "review-sequencing" }, { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-koog-agents", "owner": "Codex", "kind": "module", "summary": "JVM Koog brain for bot and moderation, with Cloudflare edge pre-filtering.", "use": "Use before changing bot orchestration, moderation, or RAG over Memgraph.", "region": "agents-in-products", "order": 1, "title": "Koog for the BestBuds Bot", "nav": "Koog Bot", "group": "agents", "subsection": "agents-in-products", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-koog-agents", "revision": "6c02bbcce14c2c2688766dbad38563450a8a8ec6c1522e4b7d6de48488f5fe91", "status": "unverified", "renderingRevision": "fe012fbb1a247de083aa576c36e7a925ae0088d4d1a577509c8df5b8576f3b54", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://github.com/JetBrains/koog", "https://blog.jetbrains.com/ai/2026/05/koog-1-0-is-out-stable-core-better-interop-and-multiplatform-observability/", "https://docs.koog.ai/", "https://docs.koog.ai/content-moderation/", "https://docs.koog.ai/model-capabilities/", "https://docs.koog.ai/ktor-plugin/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-koog-agents", "polarity": "Neutral" }, { "id": "section-verdict", "anchor": "verdict", "label": "1. Verdict", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#verdict", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "2. Current bot", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#current", "polarity": "Neutral" }, { "id": "section-koog", "anchor": "koog", "label": "3. What Koog 1.0 is", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#koog", "polarity": "Neutral" }, { "id": "section-fit", "anchor": "fit", "label": "4. Fit assessment", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#fit", "polarity": "Neutral" }, { "id": "section-split", "anchor": "split", "label": "5. Architecture — edge pre-filter + JVM brain", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#split", "polarity": "Neutral" }, { "id": "section-moderation", "anchor": "moderation", "label": "6. Moderation upgrade (the direct ask)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#moderation", "polarity": "Neutral" }, { "id": "section-risks-3", "anchor": "risks-3", "label": "Open questions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#risks-3", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-agents#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-koog-agents:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-split", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-performance-observability", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-split", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-reaktor-notifications-design", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-risks-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-risks-3", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-reaktor-service", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-reaktor-db", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-reaktor-browser-local-ai", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-browser-local-ai", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-agents:references-reaktor-server", "kind": "references", "owner": "reaktor-koog-agents", "incidences": [ { "node": "reaktor-koog-agents", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-koog-agents.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Koog for the BestBuds Bot", "level": 0 }, { "id": "verdict", "anchor": "verdict", "title": "1. Verdict", "level": 2 }, { "id": "current", "anchor": "current", "title": "2. Current bot", "level": 2 }, { "id": "koog", "anchor": "koog", "title": "3. What Koog 1.0 is", "level": 2 }, { "id": "multiplatform", "anchor": "multiplatform", "title": "Multiplatform", "level": 4 }, { "id": "agent-patterns", "anchor": "agent-patterns", "title": "Agent patterns", "level": 4 }, { "id": "tools--function-calling", "anchor": "tools--function-calling", "title": "Tools / function calling", "level": 4 }, { "id": "structured-output", "anchor": "structured-output", "title": "Structured output", "level": 4 }, { "id": "memory--persistence", "anchor": "memory--persistence", "title": "Memory & persistence", "level": 4 }, { "id": "content-moderation", "anchor": "content-moderation", "title": "Content moderation", "level": 4 }, { "id": "providers", "anchor": "providers", "title": "Providers", "level": 4 }, { "id": "observability", "anchor": "observability", "title": "Observability", "level": 4 }, { "id": "framework-integration", "anchor": "framework-integration", "title": "Framework integration", "level": 4 }, { "id": "fit", "anchor": "fit", "title": "4. Fit assessment", "level": 2 }, { "id": "where-koog-wins-decisively", "anchor": "where-koog-wins-decisively", "title": "Where Koog wins decisively", "level": 4 }, { "id": "where-to-be-careful", "anchor": "where-to-be-careful", "title": "Where to be careful", "level": 4 }, { "id": "split", "anchor": "split", "title": "5. Architecture — edge pre-filter + JVM brain", "level": 2 }, { "id": "moderation", "anchor": "moderation", "title": "6. Moderation upgrade (the direct ask)", "level": 2 }, { "id": "synergy", "anchor": "synergy", "title": "7. Koog × Reaktor graph synergy", "level": 2 }, { "id": "koog-agent-inside-a-reaktor-node", "anchor": "koog-agent-inside-a-reaktor-node", "title": "Koog agent inside a Reaktor node", "level": 4 }, { "id": "reaktor-services-as-koog-tools", "anchor": "reaktor-services-as-koog-tools", "title": "Reaktor services as Koog tools", "level": 4 }, { "id": "actor", "anchor": "actor", "title": "8. Bot as a distributed actor", "level": 2 }, { "id": "future", "anchor": "future", "title": "9. Future features unlocked", "level": 2 }, { "id": "providers-2", "anchor": "providers-2", "title": "10. Provider & cost strategy", "level": 2 }, { "id": "migration", "anchor": "migration", "title": "11. Migration plan", "level": 2 }, { "id": "koog-moderation-on-the-jvm", "anchor": "koog-moderation-on-the-jvm", "title": "Koog moderation on the JVM", "level": 4 }, { "id": "koog-agent-behind-botservice", "anchor": "koog-agent-behind-botservice", "title": "Koog agent behind BotService", "level": 4 }, { "id": "tools--structured-output", "anchor": "tools--structured-output", "title": "Tools + structured output", "level": 4 }, { "id": "memory--rag-over-the-knowledge-graph", "anchor": "memory--rag-over-the-knowledge-graph", "title": "Memory + RAG over the knowledge graph", "level": 4 }, { "id": "bot-as-a-distributed-actor", "anchor": "bot-as-a-distributed-actor", "title": "Bot as a distributed actor", "level": 4 }, { "id": "planners-mcp-cost-routing", "anchor": "planners-mcp-cost-routing", "title": "Planners, MCP, cost routing", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "12. Risks & open questions", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Risks", "level": 4 }, { "id": "risks-3", "anchor": "risks-3", "title": "Open questions", "level": 4 }, { "id": "references", "anchor": "references", "title": "13. References", "level": 2 }, { "id": "references-2", "anchor": "references-2", "title": "Current code", "level": 4 }, { "id": "references-3", "anchor": "references-3", "title": "Peer designs", "level": 4 }, { "id": "references-4", "anchor": "references-4", "title": "Koog (external, verified May 2026)", "level": 4 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "split" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "split" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "actor" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "risks-3" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "risks-3" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-browser-local-ai", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-koog-workbench", "owner": "Codex", "kind": "control-plane", "summary": "Replace fixture agents with Koog-backed structured workbench commands and Critic review.", "use": "Use before wiring real agent behavior into reaktorDesktop.", "region": "agents-in-products", "order": 0, "title": "Koog in reaktorDesktop", "nav": "Koog Workbench", "group": "agents", "subsection": "agents-in-products", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-koog-workbench", "revision": "777efcf085e4b0c50b2c4620d470fe2b53af957407d8907ced2fba61a9f8e2ac", "status": "unverified", "renderingRevision": "258f3341366e9a40f15d0ee7855e66558c5ecf3febd103e33c647eb65e594030", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://github.com/JetBrains/koog", "https://blog.jetbrains.com/ai/2026/05/koog-1-0-is-out-stable-core-better-interop-and-multiplatform-observability/", "https://docs.koog.ai/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-koog-workbench", "polarity": "Neutral" }, { "id": "section-verdict", "anchor": "verdict", "label": "1. Verdict", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#verdict", "polarity": "Neutral" }, { "id": "section-what", "anchor": "what", "label": "2. What reaktorDesktop is", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#what", "polarity": "Neutral" }, { "id": "section-exists", "anchor": "exists", "label": "3. The agent system already exists (mocked)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#exists", "polarity": "Neutral" }, { "id": "section-gap", "anchor": "gap", "label": "4. The gap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#gap", "polarity": "Neutral" }, { "id": "section-fit", "anchor": "fit", "label": "5. Why Koog fits here", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#fit", "polarity": "Neutral" }, { "id": "section-arch", "anchor": "arch", "label": "6. Architecture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#arch", "polarity": "Neutral" }, { "id": "section-context", "anchor": "context", "label": "11. The graph as context", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#context", "polarity": "Neutral" }, { "id": "section-references-3", "anchor": "references-3", "label": "Peer designs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#references-3", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-koog-workbench#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-koog-workbench:references-reaktor-koog-agents", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-verdict", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-performance-observability", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-context", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-reaktor-gemini-devops-agent", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-gemini-devops-agent", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-reaktor-architecture-analysis", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-architecture-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-reaktor-desktop-v3", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-v3", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-koog-workbench:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-koog-workbench", "incidences": [ { "node": "reaktor-koog-workbench", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-koog-workbench.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Koog in reaktorDesktop", "level": 0 }, { "id": "verdict", "anchor": "verdict", "title": "1. Verdict", "level": 2 }, { "id": "what", "anchor": "what", "title": "2. What reaktorDesktop is", "level": 2 }, { "id": "exists", "anchor": "exists", "title": "3. The agent system already exists (mocked)", "level": 2 }, { "id": "exists-2", "anchor": "exists-2", "title": "3.1 Three role-based agents (fixtures)", "level": 3 }, { "id": "exists-3", "anchor": "exists-3", "title": "3.2 The real apply substrate", "level": 3 }, { "id": "gap", "anchor": "gap", "title": "4. The gap", "level": 2 }, { "id": "fit", "anchor": "fit", "title": "5. Why Koog fits here", "level": 2 }, { "id": "agents--koog-aiagent", "anchor": "agents--koog-aiagent", "title": "Agents ↔ Koog AIAgent", "level": 4 }, { "id": "commands--structured-output", "anchor": "commands--structured-output", "title": "Commands ↔ structured output", "level": 4 }, { "id": "critic-loop--subgraphs--multi-agent", "anchor": "critic-loop--subgraphs--multi-agent", "title": "Critic loop ↔ subgraphs / multi-agent", "level": 4 }, { "id": "permissions--tool-sets", "anchor": "permissions--tool-sets", "title": "Permissions ↔ tool sets", "level": 4 }, { "id": "tools--workbenchcommandapi", "anchor": "tools--workbenchcommandapi", "title": "Tools ↔ WorkbenchCommandApi", "level": 4 }, { "id": "mcp--the-intellij-fixture", "anchor": "mcp--the-intellij-fixture", "title": "MCP ↔ the IntelliJ fixture", "level": 4 }, { "id": "arch", "anchor": "arch", "title": "6. Architecture", "level": 2 }, { "id": "tools", "anchor": "tools", "title": "7. Tools = workbench capabilities", "level": 2 }, { "id": "commands", "anchor": "commands", "title": "8. Commands, not diffs", "level": 2 }, { "id": "multiagent", "anchor": "multiagent", "title": "9. Multi-agent & the Critic loop", "level": 2 }, { "id": "permissions", "anchor": "permissions", "title": "10. Permission-gated tools", "level": 2 }, { "id": "context", "anchor": "context", "title": "11. The graph as context", "level": 2 }, { "id": "mcp", "anchor": "mcp", "title": "12. MCP both ways", "level": 2 }, { "id": "models", "anchor": "models", "title": "13. Models, privacy, offline", "level": 2 }, { "id": "observability", "anchor": "observability", "title": "14. Observability", "level": 2 }, { "id": "migration", "anchor": "migration", "title": "15. Migration plan", "level": 2 }, { "id": "one-real-agent-read-only", "anchor": "one-real-agent-read-only", "title": "One real agent, read-only", "level": 4 }, { "id": "structured-commands--queue", "anchor": "structured-commands--queue", "title": "Structured commands → queue", "level": 4 }, { "id": "apply--test--rollback-as-tools", "anchor": "apply--test--rollback-as-tools", "title": "Apply / test / rollback as tools", "level": 4 }, { "id": "multi-agent--critic-loop", "anchor": "multi-agent--critic-loop", "title": "Multi-agent + Critic loop", "level": 4 }, { "id": "mcp--memory--otel", "anchor": "mcp--memory--otel", "title": "MCP + memory + OTel", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "16. Risks & open questions", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Risks", "level": 4 }, { "id": "risks-3", "anchor": "risks-3", "title": "Open questions", "level": 4 }, { "id": "references", "anchor": "references", "title": "17. References", "level": 2 }, { "id": "references-2", "anchor": "references-2", "title": "Workbench code investigated", "level": 4 }, { "id": "references-3", "anchor": "references-3", "title": "Peer designs", "level": 4 }, { "id": "references-4", "anchor": "references-4", "title": "Koog (external, verified May 2026)", "level": 4 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "verdict" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "context" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "observability" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "risks-3" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "references-4" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-gemini-devops-agent", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-agents", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-architecture-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-desktop-v3", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-megascale-strategy", "owner": "Claude", "kind": "strategy", "summary": "How Reaktor should scale into large engineering orgs: local-first runtime islands, graph-visible deployment cuts, typed service contracts, production backend discipline, and actors/Durable Objects as one stateful partitioning lane rather than the center of the story.", "use": "Use for enterprise-adoption strategy, the open-source vs commercial split, and sequencing the distributed-tier roadmap around runtime islands, deployment cuts, bus/data/tenancy/observability, and then stateful partitioning.", "region": "ship-cloud", "order": 1, "title": "Reaktor at Mega-Scale", "nav": "Mega-Scale Strategy", "group": "ship", "subsection": "ship-cloud", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-megascale-strategy", "revision": "7396e6feea2837ebe3075a5628c33576227803c669db82d03568231435596620", "status": "unverified", "renderingRevision": "4fd8df2e465a9034d3a2e5eb8baddac8474f017497b539d17b5e90556ce2cc96", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy", "polarity": "Neutral" }, { "id": "section-0-tldr", "anchor": "0-tldr", "label": "0. TL;DR", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy#0-tldr", "polarity": "Neutral" }, { "id": "section-1-the-corrected-mental-model", "anchor": "1-the-corrected-mental-model", "label": "1. The corrected mental model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy#1-the-corrected-mental-model", "polarity": "Neutral" }, { "id": "section-2-what-the-source-tree-actually-supports", "anchor": "2-what-the-source-tree-actually-supports", "label": "2. What the source tree actually supports", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy#2-what-the-source-tree-actually-supports", "polarity": "Neutral" }, { "id": "section-3-what-must-not-be-diluted", "anchor": "3-what-must-not-be-diluted", "label": "3. What must not be diluted", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy#3-what-must-not-be-diluted", "polarity": "Neutral" }, { "id": "section-4-where-reaktor-can-matter-to-very-large-teams", "anchor": "4-where-reaktor-can-matter-to-very-large-teams", "label": "4. Where Reaktor can matter to very large teams", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy#4-where-reaktor-can-matter-to-very-large-teams", "polarity": "Neutral" }, { "id": "section-5-the-target-architecture", "anchor": "5-the-target-architecture", "label": "5. The target architecture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy#5-the-target-architecture", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-megascale-strategy#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-megascale-strategy:references-reaktor-framework-overview", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-reaktor-service", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-reaktor-server", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-reaktor-db", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-megascale-strategy:references-reaktor-competitive-analysis", "kind": "references", "owner": "reaktor-megascale-strategy", "incidences": [ { "node": "reaktor-megascale-strategy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-megascale-strategy.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor at Mega-Scale", "level": 0 }, { "id": "0-tldr", "anchor": "0-tldr", "title": "0. TL;DR", "level": 2 }, { "id": "1-the-corrected-mental-model", "anchor": "1-the-corrected-mental-model", "title": "1. The corrected mental model", "level": 2 }, { "id": "runtime-islands", "anchor": "runtime-islands", "title": "Runtime islands", "level": 3 }, { "id": "system-graph", "anchor": "system-graph", "title": "System graph", "level": 3 }, { "id": "deployment-cuts", "anchor": "deployment-cuts", "title": "Deployment cuts", "level": 3 }, { "id": "2-what-the-source-tree-actually-supports", "anchor": "2-what-the-source-tree-actually-supports", "title": "2. What the source tree actually supports", "level": 2 }, { "id": "3-what-must-not-be-diluted", "anchor": "3-what-must-not-be-diluted", "title": "3. What must not be diluted", "level": 2 }, { "id": "4-where-reaktor-can-matter-to-very-large-teams", "anchor": "4-where-reaktor-can-matter-to-very-large-teams", "title": "4. Where Reaktor can matter to very large teams", "level": 2 }, { "id": "a-client--edge--bff-convergence", "anchor": "a-client--edge--bff-convergence", "title": "A. Client + edge + BFF convergence", "level": 3 }, { "id": "b-graph-visible-service-contracts-over-brownfield-systems", "anchor": "b-graph-visible-service-contracts-over-brownfield-systems", "title": "B. Graph-visible service contracts over brownfield systems", "level": 3 }, { "id": "c-production-backend-discipline", "anchor": "c-production-backend-discipline", "title": "C. Production backend discipline", "level": 3 }, { "id": "d-workbench-and-graph-control-plane", "anchor": "d-workbench-and-graph-control-plane", "title": "D. Workbench and graph control plane", "level": 3 }, { "id": "e-stateful-partitioning-with-actors-and-durable-objects", "anchor": "e-stateful-partitioning-with-actors-and-durable-objects", "title": "E. Stateful partitioning with actors and Durable Objects", "level": 3 }, { "id": "5-the-target-architecture", "anchor": "5-the-target-architecture", "title": "5. The target architecture", "level": 2 }, { "id": "6-roadmap-scale-the-graph-before-scaling-actors", "anchor": "6-roadmap-scale-the-graph-before-scaling-actors", "title": "6. Roadmap: scale the graph before scaling actors", "level": 2 }, { "id": "7-open-source-and-commercial-split", "anchor": "7-open-source-and-commercial-split", "title": "7. Open-source and commercial split", "level": 2 }, { "id": "8-anti-patterns", "anchor": "8-anti-patterns", "title": "8. Anti-patterns", "level": 2 }, { "id": "9-recommendation", "anchor": "9-recommendation", "title": "9. Recommendation", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-mesh", "owner": "Codex", "kind": "design", "summary": "Source of truth for Reaktor's live connectivity layer: peer sessions, WebRTC, Cloudflare TURN credential issuance, Cloudflare Realtime SFU sessions/tracks/DataChannels, graph projection, and the handoff to Bus for durable facts.", "use": "Use before designing realtime peer/session/media/data transport, TURN credential issuance, Cloudflare Realtime SFU integration, DataChannels, mesh graph projection, or mesh-to-bus handoff policy.", "region": "data-delivery", "order": 1, "title": "Reaktor Mesh", "nav": "Mesh", "group": "data", "subsection": "data-delivery", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-mesh", "revision": "2eb2ae4cbcaaf4c80ff51ea71ff432ac1c4f776a1ad84081bf980dbed495e124", "status": "unverified", "renderingRevision": "30815bbb08b2b377f85701d45689a0aab901fdc94a01812e812666bcef260373", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developers.cloudflare.com/realtime/turn/generate-credentials/", "https://developers.cloudflare.com/realtime/sfu/", "https://developers.cloudflare.com/realtime/sfu/sessions-tracks/", "https://developers.cloudflare.com/realtime/sfu/datachannels/", "https://developers.cloudflare.com/realtime/sfu/limits/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-mesh", "polarity": "Neutral" }, { "id": "section-why", "anchor": "why", "label": "1. Why Mesh Exists", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#why", "polarity": "Neutral" }, { "id": "section-boundaries", "anchor": "boundaries", "label": "2. Boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#boundaries", "polarity": "Neutral" }, { "id": "section-provider-roles", "anchor": "provider-roles", "label": "3. Provider Roles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#provider-roles", "polarity": "Neutral" }, { "id": "section-turn", "anchor": "turn", "label": "4. TURN Credential Model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#turn", "polarity": "Neutral" }, { "id": "section-sfu", "anchor": "sfu", "label": "5. Cloudflare Realtime SFU Model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#sfu", "polarity": "Neutral" }, { "id": "section-datachannels", "anchor": "datachannels", "label": "6. DataChannels", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#datachannels", "polarity": "Neutral" }, { "id": "section-related", "anchor": "related", "label": "Related Docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#related", "polarity": "Neutral" }, { "id": "section-graph", "anchor": "graph", "label": "10. Graph Projection", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-mesh#graph", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-mesh:references-reaktor-db-reading-map", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-reading-map", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-db-realtime", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-realtime", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-service", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "section-boundaries", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "section-graph", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-component-lifecycle", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-mesh:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-mesh", "incidences": [ { "node": "reaktor-mesh", "port": "section-related", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-mesh.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Mesh", "level": 0 }, { "id": "why", "anchor": "why", "title": "1. Why Mesh Exists", "level": 2 }, { "id": "boundaries", "anchor": "boundaries", "title": "2. Boundaries", "level": 2 }, { "id": "provider-roles", "anchor": "provider-roles", "title": "3. Provider Roles", "level": 2 }, { "id": "turn", "anchor": "turn", "title": "4. TURN Credential Model", "level": 2 }, { "id": "sfu", "anchor": "sfu", "title": "5. Cloudflare Realtime SFU Model", "level": 2 }, { "id": "datachannels", "anchor": "datachannels", "title": "6. DataChannels", "level": 2 }, { "id": "api", "anchor": "api", "title": "7. Core API", "level": 2 }, { "id": "session-lifecycle", "anchor": "session-lifecycle", "title": "8. Session Lifecycle", "level": 2 }, { "id": "signaling", "anchor": "signaling", "title": "9. Signaling And Directory", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "10. Graph Projection", "level": 2 }, { "id": "mesh-to-bus", "anchor": "mesh-to-bus", "title": "11. Mesh To Bus Handoff", "level": 2 }, { "id": "security", "anchor": "security", "title": "12. Security", "level": 2 }, { "id": "failure-semantics", "anchor": "failure-semantics", "title": "13. Failure Semantics", "level": 2 }, { "id": "implementation-plan", "anchor": "implementation-plan", "title": "14. Implementation Plan", "level": 2 }, { "id": "acceptance-tests", "anchor": "acceptance-tests", "title": "15. Acceptance Tests", "level": 2 }, { "id": "provider-references", "anchor": "provider-references", "title": "16. Provider References", "level": 2 }, { "id": "related", "anchor": "related", "title": "Related Docs", "level": 2 } ], "links": [ { "id": "reaktor-db", "anchor": "reading-map", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-db", "anchor": "realtime", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "boundaries" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "graph" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "related" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related" } ] }, { "id": "reaktor-module-execution-plan", "owner": "Astra / Codex", "kind": "strategy", "summary": "Five ranked tasks for each of 69 module/build/target units, plus 11 supporting systems: 400 task entries with Astra traceability, prerequisites, acceptance evidence and December, year-one or conditional horizons.", "use": "Use to select the next integrated creation, growth, recovery or release slice. The master plan owns the calendar; this complete task register is not a promise to build every module before launch.", "region": "framework-module-strategy", "order": 1, "title": "Reaktor Module Execution Plan — Delivering the Astra Vision", "nav": "Module Execution Plan", "group": "framework", "subsection": "framework-module-strategy", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-module-execution-plan", "revision": "5d02864adb18811b56d7811b56a8acfa1f526f590d2801ff32f1194adc5c9a6e", "status": "design", "renderingRevision": "1d83b0d7b814fce37d55e2efd3ff16bfea311ed70b2ee2886f00d33614ba8cdf", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan", "polarity": "Neutral" }, { "id": "section-how-to-use-the-plan", "anchor": "how-to-use-the-plan", "label": "How to use the plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#how-to-use-the-plan", "polarity": "Neutral" }, { "id": "section-astra-objectives", "anchor": "astra-objectives", "label": "Traceability to the Astra master plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#astra-objectives", "polarity": "Neutral" }, { "id": "section-critical-path", "anchor": "critical-path", "label": "The ten most important integrated work packages", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#critical-path", "polarity": "Neutral" }, { "id": "section-kernel-v0", "anchor": "kernel-v0", "label": "The compact semantic contract to implement first", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#kernel-v0", "polarity": "Neutral" }, { "id": "section-how-module-contributions-combine", "anchor": "how-module-contributions-combine", "label": "How module contributions combine", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#how-module-contributions-combine", "polarity": "Neutral" }, { "id": "section-open-framework-modules", "anchor": "open-framework-modules", "label": "Open framework modules", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#open-framework-modules", "polarity": "Neutral" }, { "id": "section-reaktor-core", "anchor": "reaktor-core", "label": "reaktor-core", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-core", "polarity": "Neutral" }, { "id": "section-reaktor-graph-port", "anchor": "reaktor-graph-port", "label": "reaktor-graph-port", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-graph-port", "polarity": "Neutral" }, { "id": "section-reaktor-graph-runtime", "anchor": "reaktor-graph-runtime", "label": "reaktor-graph-runtime", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-graph-runtime", "polarity": "Neutral" }, { "id": "section-reaktor-graph", "anchor": "reaktor-graph", "label": "reaktor-graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-graph", "polarity": "Neutral" }, { "id": "section-reaktor-io", "anchor": "reaktor-io", "label": "reaktor-io", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-io", "polarity": "Neutral" }, { "id": "section-reaktor-service", "anchor": "reaktor-service", "label": "reaktor-service", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-service", "polarity": "Neutral" }, { "id": "section-reaktor-db", "anchor": "reaktor-db", "label": "reaktor-db", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-db", "polarity": "Neutral" }, { "id": "section-reaktor-auth-core", "anchor": "reaktor-auth-core", "label": "reaktor-auth-core", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-auth-core", "polarity": "Neutral" }, { "id": "section-reaktor-auth", "anchor": "reaktor-auth", "label": "reaktor-auth", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-auth", "polarity": "Neutral" }, { "id": "section-reaktor-secrets", "anchor": "reaktor-secrets", "label": "reaktor-secrets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-secrets", "polarity": "Neutral" }, { "id": "section-reaktor-security", "anchor": "reaktor-security", "label": "reaktor-security", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-security", "polarity": "Neutral" }, { "id": "section-reaktor-cloudflare", "anchor": "reaktor-cloudflare", "label": "reaktor-cloudflare", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-cloudflare", "polarity": "Neutral" }, { "id": "section-reaktor-google", "anchor": "reaktor-google", "label": "reaktor-google", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-google", "polarity": "Neutral" }, { "id": "section-reaktor-work", "anchor": "reaktor-work", "label": "reaktor-work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-work", "polarity": "Neutral" }, { "id": "section-reaktor-notification", "anchor": "reaktor-notification", "label": "reaktor-notification", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-notification", "polarity": "Neutral" }, { "id": "section-reaktor-location", "anchor": "reaktor-location", "label": "reaktor-location", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-location", "polarity": "Neutral" }, { "id": "section-reaktor-sensors", "anchor": "reaktor-sensors", "label": "reaktor-sensors", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-sensors", "polarity": "Neutral" }, { "id": "section-reaktor-health", "anchor": "reaktor-health", "label": "reaktor-health", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-health", "polarity": "Neutral" }, { "id": "section-reaktor-media", "anchor": "reaktor-media", "label": "reaktor-media", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-media", "polarity": "Neutral" }, { "id": "section-reaktor-telemetry", "anchor": "reaktor-telemetry", "label": "reaktor-telemetry", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-telemetry", "polarity": "Neutral" }, { "id": "section-reaktor-performance", "anchor": "reaktor-performance", "label": "reaktor-performance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-performance", "polarity": "Neutral" }, { "id": "section-reaktor-flexbuffer", "anchor": "reaktor-flexbuffer", "label": "reaktor-flexbuffer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-flexbuffer", "polarity": "Neutral" }, { "id": "section-reaktor-ffi", "anchor": "reaktor-ffi", "label": "reaktor-ffi", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-ffi", "polarity": "Neutral" }, { "id": "section-reaktor-compiler", "anchor": "reaktor-compiler", "label": "reaktor-compiler", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-compiler", "polarity": "Neutral" }, { "id": "section-dependeasy", "anchor": "dependeasy", "label": "dependeasy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#dependeasy", "polarity": "Neutral" }, { "id": "section-reaktor-code", "anchor": "reaktor-code", "label": "reaktor-code", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-code", "polarity": "Neutral" }, { "id": "section-reaktor-ui", "anchor": "reaktor-ui", "label": "reaktor-ui", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-ui", "polarity": "Neutral" }, { "id": "section-compose-flow", "anchor": "compose-flow", "label": "compose-flow", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#compose-flow", "polarity": "Neutral" }, { "id": "section-reaktor-flow", "anchor": "reaktor-flow", "label": "reaktor-flow", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-flow", "polarity": "Neutral" }, { "id": "section-reaktor-tooling", "anchor": "reaktor-tooling", "label": "reaktor-tooling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-tooling", "polarity": "Neutral" }, { "id": "section-reaktor-mcp", "anchor": "reaktor-mcp", "label": "reaktor-mcp", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-mcp", "polarity": "Neutral" }, { "id": "section-reaktor-conductor", "anchor": "reaktor-conductor", "label": "reaktor-conductor", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-conductor", "polarity": "Neutral" }, { "id": "section-reaktor-cloud", "anchor": "reaktor-cloud", "label": "reaktor-cloud", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-cloud", "polarity": "Neutral" }, { "id": "section-reaktor-cli", "anchor": "reaktor-cli", "label": "reaktor-cli", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-cli", "polarity": "Neutral" }, { "id": "section-reaktor-web", "anchor": "reaktor-web", "label": "reaktor-web", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-web", "polarity": "Neutral" }, { "id": "section-reaktor-tactile", "anchor": "reaktor-tactile", "label": "reaktor-tactile", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-tactile", "polarity": "Neutral" }, { "id": "section-reaktor-react", "anchor": "reaktor-react", "label": "reaktor-react", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#reaktor-react", "polarity": "Neutral" }, { "id": "section-bestbuds-kernel", "anchor": "bestbuds-kernel", "label": "BestBuds modules/kernel", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#bestbuds-kernel", "polarity": "Neutral" }, { "id": "section-bestbuds-engine", "anchor": "bestbuds-engine", "label": "BestBuds modules/engine", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#bestbuds-engine", "polarity": "Neutral" }, { "id": "section-bestbuds-app", "anchor": "bestbuds-app", "label": "BestBuds modules/app", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#bestbuds-app", "polarity": "Neutral" }, { "id": "section-bestbuds-design", "anchor": "bestbuds-design", "label": "BestBuds modules/design", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#bestbuds-design", "polarity": "Neutral" }, { "id": "section-bestbuds-engineprototype", "anchor": "bestbuds-engineprototype", "label": "enginePrototype / modules/engine/prototype-browser", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#bestbuds-engineprototype", "polarity": "Neutral" }, { "id": "section-target-appandroid", "anchor": "target-appandroid", "label": "appAndroid", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-appandroid", "polarity": "Neutral" }, { "id": "section-target-appdarwin", "anchor": "target-appdarwin", "label": "appDarwin", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-appdarwin", "polarity": "Neutral" }, { "id": "section-target-appweb", "anchor": "target-appweb", "label": "appWeb", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-appweb", "polarity": "Neutral" }, { "id": "section-target-reaktordesktop", "anchor": "target-reaktordesktop", "label": "reaktorDesktop", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-reaktordesktop", "polarity": "Neutral" }, { "id": "section-target-reaktorcli", "anchor": "target-reaktorcli", "label": "reaktorCli", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-reaktorcli", "polarity": "Neutral" }, { "id": "section-target-reaktorserver", "anchor": "target-reaktorserver", "label": "reaktorServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-reaktorserver", "polarity": "Neutral" }, { "id": "section-target-reaktorweb", "anchor": "target-reaktorweb", "label": "reaktorWeb", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-reaktorweb", "polarity": "Neutral" }, { "id": "section-target-companyos", "anchor": "target-companyos", "label": "companyOS", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-companyos", "polarity": "Neutral" }, { "id": "section-target-designprototype", "anchor": "target-designprototype", "label": "designPrototype", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-designprototype", "polarity": "Neutral" }, { "id": "section-target-reaktorprototype", "anchor": "target-reaktorprototype", "label": "reaktorPrototype", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-reaktorprototype", "polarity": "Neutral" }, { "id": "section-target-prototypeworker", "anchor": "target-prototypeworker", "label": "prototypeWorker", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-prototypeworker", "polarity": "Neutral" }, { "id": "section-target-tracker", "anchor": "target-tracker", "label": "tracker", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-tracker", "polarity": "Neutral" }, { "id": "section-target-chatserver", "anchor": "target-chatserver", "label": "chatServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-chatserver", "polarity": "Neutral" }, { "id": "section-target-messagingserver", "anchor": "target-messagingserver", "label": "messagingServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-messagingserver", "polarity": "Neutral" }, { "id": "section-target-socialserver", "anchor": "target-socialserver", "label": "socialServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-socialserver", "polarity": "Neutral" }, { "id": "section-target-mediaserver", "anchor": "target-mediaserver", "label": "mediaServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-mediaserver", "polarity": "Neutral" }, { "id": "section-target-textmoderatorserver", "anchor": "target-textmoderatorserver", "label": "textModeratorServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-textmoderatorserver", "polarity": "Neutral" }, { "id": "section-target-imagemoderatorserver", "anchor": "target-imagemoderatorserver", "label": "imageModeratorServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-imagemoderatorserver", "polarity": "Neutral" }, { "id": "section-target-campaignengagementserver", "anchor": "target-campaignengagementserver", "label": "campaignEngagementServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-campaignengagementserver", "polarity": "Neutral" }, { "id": "section-target-botserver", "anchor": "target-botserver", "label": "botServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-botserver", "polarity": "Neutral" }, { "id": "section-target-analyticsserver", "anchor": "target-analyticsserver", "label": "analyticsServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-analyticsserver", "polarity": "Neutral" }, { "id": "section-target-configserver", "anchor": "target-configserver", "label": "configServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-configserver", "polarity": "Neutral" }, { "id": "section-target-stickerserver", "anchor": "target-stickerserver", "label": "stickerServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-stickerserver", "polarity": "Neutral" }, { "id": "section-target-notificationserver", "anchor": "target-notificationserver", "label": "notificationServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-notificationserver", "polarity": "Neutral" }, { "id": "section-target-bestbudsarchiver", "anchor": "target-bestbudsarchiver", "label": "bestbudsArchiver", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-bestbudsarchiver", "polarity": "Neutral" }, { "id": "section-target-accountpurgeserver", "anchor": "target-accountpurgeserver", "label": "accountPurgeServer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-accountpurgeserver", "polarity": "Neutral" }, { "id": "section-target-dataprobe", "anchor": "target-dataprobe", "label": "dataProbe", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-execution-plan#target-dataprobe", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-module-review", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-workbench-layers-one-command-line", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "section-one-command-line", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-service", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-db", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-3-greenfield-creation-is-a-first-class-product", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-3-greenfield-creation-is-a-first-class-product", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-18-the-release-must-prove-four-complete-journeys", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-18-the-release-must-prove-four-complete-journeys", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-6-the-core-a-live-model-with-a-small-semantic-kernel", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-6-the-core-a-live-model-with-a-small-semantic-kernel", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-7-kotlin-and-the-public-programming-model", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-7-kotlin-and-the-public-programming-model", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-8-a-generating-basis-modules-features-and-capabilities", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-8-a-generating-basis-modules-features-and-capabilities", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-9-runtime-actors-and-safe-live-evolution", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-9-runtime-actors-and-safe-live-evolution", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-12-flows-choreography-and-the-opinionated-datacloud-stack", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-12-flows-choreography-and-the-opinionated-datacloud-stack", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-10-formal-methods-and-simulation-as-everyday-development-tools", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-10-formal-methods-and-simulation-as-everyday-development-tools", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-11-claude-codex-and-an-agent-native-system-interface", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-11-claude-codex-and-an-agent-native-system-interface", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-14-studio-ides-and-tools-that-gain-power-from-the-graph", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-14-studio-ides-and-tools-that-gain-power-from-the-graph", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-15-build-deploy-and-operate-one-reproducible-system", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-15-build-deploy-and-operate-one-reproducible-system", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-13-polyglot-contracts-ffi-and-data-oriented-execution", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-13-polyglot-contracts-ffi-and-data-oriented-execution", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-17-what-public-v1-means", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-17-what-public-v1-means", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-20-non-negotiable-december-release-gates", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-20-non-negotiable-december-release-gates", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-19-roadmap-from-september-2026-to-september-2027", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-19-roadmap-from-september-2026-to-september-2027", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-21-measuring-whether-reaktor-is-winning", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-21-measuring-whether-reaktor-is-winning", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-astra-reaktor-plan-and-roadmap-22-adoption-distribution-and-the-ten-year-position", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-astra-objectives", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-22-adoption-distribution-and-the-ten-year-position", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-graph-substrate-redesign-23-independent-review-claude", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-kernel-v0", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "section-23-independent-review-claude", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-db-reading-map", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-reading-map", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-data-storage", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-data-implementation", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-reaktor-work", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-flexbuffer-performance-review", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-flexbuffer", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-flexbuffer", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "section-reaktor-flexbuffer", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:derived-from-astra-reaktor-plan-and-roadmap", "kind": "derived-from", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-execution-plan:requires-reaktor-module-review", "kind": "requires", "owner": "reaktor-module-execution-plan", "incidences": [ { "node": "reaktor-module-execution-plan", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-review", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-module-execution-plan.json", "sections": [ { "id": "reaktor-module-execution-plan--delivering-the-astra-vision", "anchor": "reaktor-module-execution-plan--delivering-the-astra-vision", "title": "Reaktor Module Execution Plan — Delivering the Astra Vision", "level": 1 }, { "id": "how-to-use-the-plan", "anchor": "how-to-use-the-plan", "title": "How to use the plan", "level": 2 }, { "id": "astra-objectives", "anchor": "astra-objectives", "title": "Traceability to the Astra master plan", "level": 2 }, { "id": "critical-path", "anchor": "critical-path", "title": "The ten most important integrated work packages", "level": 2 }, { "id": "kernel-v0", "anchor": "kernel-v0", "title": "The compact semantic contract to implement first", "level": 2 }, { "id": "how-module-contributions-combine", "anchor": "how-module-contributions-combine", "title": "How module contributions combine", "level": 2 }, { "id": "open-framework-modules", "anchor": "open-framework-modules", "title": "Open framework modules", "level": 2 }, { "id": "reaktor-core", "anchor": "reaktor-core", "title": "reaktor-core", "level": 3 }, { "id": "reaktor-graph-port", "anchor": "reaktor-graph-port", "title": "reaktor-graph-port", "level": 3 }, { "id": "reaktor-graph-runtime", "anchor": "reaktor-graph-runtime", "title": "reaktor-graph-runtime", "level": 3 }, { "id": "reaktor-graph", "anchor": "reaktor-graph", "title": "reaktor-graph", "level": 3 }, { "id": "reaktor-auth-core", "anchor": "reaktor-auth-core", "title": "reaktor-auth-core", "level": 3 }, { "id": "reaktor-auth", "anchor": "reaktor-auth", "title": "reaktor-auth", "level": 3 }, { "id": "reaktor-service", "anchor": "reaktor-service", "title": "reaktor-service", "level": 3 }, { "id": "reaktor-io", "anchor": "reaktor-io", "title": "reaktor-io", "level": 3 }, { "id": "reaktor-db", "anchor": "reaktor-db", "title": "reaktor-db", "level": 3 }, { "id": "reaktor-secrets", "anchor": "reaktor-secrets", "title": "reaktor-secrets", "level": 3 }, { "id": "reaktor-security", "anchor": "reaktor-security", "title": "reaktor-security", "level": 3 }, { "id": "reaktor-cloudflare", "anchor": "reaktor-cloudflare", "title": "reaktor-cloudflare", "level": 3 }, { "id": "reaktor-google", "anchor": "reaktor-google", "title": "reaktor-google", "level": 3 }, { "id": "reaktor-work", "anchor": "reaktor-work", "title": "reaktor-work", "level": 3 }, { "id": "reaktor-notification", "anchor": "reaktor-notification", "title": "reaktor-notification", "level": 3 }, { "id": "reaktor-location", "anchor": "reaktor-location", "title": "reaktor-location", "level": 3 }, { "id": "reaktor-sensors", "anchor": "reaktor-sensors", "title": "reaktor-sensors", "level": 3 }, { "id": "reaktor-health", "anchor": "reaktor-health", "title": "reaktor-health", "level": 3 }, { "id": "reaktor-media", "anchor": "reaktor-media", "title": "reaktor-media", "level": 3 }, { "id": "reaktor-telemetry", "anchor": "reaktor-telemetry", "title": "reaktor-telemetry", "level": 3 }, { "id": "reaktor-performance", "anchor": "reaktor-performance", "title": "reaktor-performance", "level": 3 }, { "id": "reaktor-flexbuffer", "anchor": "reaktor-flexbuffer", "title": "reaktor-flexbuffer", "level": 3 }, { "id": "reaktor-ffi", "anchor": "reaktor-ffi", "title": "reaktor-ffi", "level": 3 }, { "id": "reaktor-compiler", "anchor": "reaktor-compiler", "title": "reaktor-compiler", "level": 3 }, { "id": "dependeasy", "anchor": "dependeasy", "title": "dependeasy", "level": 3 }, { "id": "reaktor-code", "anchor": "reaktor-code", "title": "reaktor-code", "level": 3 }, { "id": "reaktor-ui", "anchor": "reaktor-ui", "title": "reaktor-ui", "level": 3 }, { "id": "compose-flow", "anchor": "compose-flow", "title": "compose-flow", "level": 3 }, { "id": "reaktor-flow", "anchor": "reaktor-flow", "title": "reaktor-flow", "level": 3 }, { "id": "reaktor-tooling", "anchor": "reaktor-tooling", "title": "reaktor-tooling", "level": 3 }, { "id": "reaktor-mcp", "anchor": "reaktor-mcp", "title": "reaktor-mcp", "level": 3 }, { "id": "reaktor-conductor", "anchor": "reaktor-conductor", "title": "reaktor-conductor", "level": 3 }, { "id": "reaktor-cloud", "anchor": "reaktor-cloud", "title": "reaktor-cloud", "level": 3 }, { "id": "reaktor-cli", "anchor": "reaktor-cli", "title": "reaktor-cli", "level": 3 }, { "id": "reaktor-web", "anchor": "reaktor-web", "title": "reaktor-web", "level": 3 }, { "id": "reaktor-tactile", "anchor": "reaktor-tactile", "title": "reaktor-tactile", "level": 3 }, { "id": "reaktor-react", "anchor": "reaktor-react", "title": "reaktor-react", "level": 3 }, { "id": "closed-reaktor-and-bestbuds-library-modules", "anchor": "closed-reaktor-and-bestbuds-library-modules", "title": "Closed Reaktor and BestBuds library modules", "level": 2 }, { "id": "bestbuds-kernel", "anchor": "bestbuds-kernel", "title": "BestBuds modules/kernel", "level": 3 }, { "id": "bestbuds-engine", "anchor": "bestbuds-engine", "title": "BestBuds modules/engine", "level": 3 }, { "id": "bestbuds-app", "anchor": "bestbuds-app", "title": "BestBuds modules/app", "level": 3 }, { "id": "bestbuds-design", "anchor": "bestbuds-design", "title": "BestBuds modules/design", "level": 3 }, { "id": "bestbuds-engineprototype", "anchor": "bestbuds-engineprototype", "title": "enginePrototype / modules/engine/prototype-browser", "level": 3 }, { "id": "bestbuds-and-reaktor-deployment-targets", "anchor": "bestbuds-and-reaktor-deployment-targets", "title": "BestBuds and Reaktor deployment targets", "level": 2 }, { "id": "target-appandroid", "anchor": "target-appandroid", "title": "appAndroid", "level": 3 }, { "id": "target-appdarwin", "anchor": "target-appdarwin", "title": "appDarwin", "level": 3 }, { "id": "target-appweb", "anchor": "target-appweb", "title": "appWeb", "level": 3 }, { "id": "target-reaktordesktop", "anchor": "target-reaktordesktop", "title": "reaktorDesktop", "level": 3 }, { "id": "target-reaktorcli", "anchor": "target-reaktorcli", "title": "reaktorCli", "level": 3 }, { "id": "target-reaktorserver", "anchor": "target-reaktorserver", "title": "reaktorServer", "level": 3 }, { "id": "target-reaktorweb", "anchor": "target-reaktorweb", "title": "reaktorWeb", "level": 3 }, { "id": "target-companyos", "anchor": "target-companyos", "title": "companyOS", "level": 3 }, { "id": "target-designprototype", "anchor": "target-designprototype", "title": "designPrototype", "level": 3 }, { "id": "target-reaktorprototype", "anchor": "target-reaktorprototype", "title": "reaktorPrototype", "level": 3 }, { "id": "target-prototypeworker", "anchor": "target-prototypeworker", "title": "prototypeWorker", "level": 3 }, { "id": "target-tracker", "anchor": "target-tracker", "title": "tracker", "level": 3 }, { "id": "target-chatserver", "anchor": "target-chatserver", "title": "chatServer", "level": 3 }, { "id": "target-messagingserver", "anchor": "target-messagingserver", "title": "messagingServer", "level": 3 }, { "id": "target-socialserver", "anchor": "target-socialserver", "title": "socialServer", "level": 3 }, { "id": "target-mediaserver", "anchor": "target-mediaserver", "title": "mediaServer", "level": 3 }, { "id": "target-textmoderatorserver", "anchor": "target-textmoderatorserver", "title": "textModeratorServer", "level": 3 }, { "id": "target-imagemoderatorserver", "anchor": "target-imagemoderatorserver", "title": "imageModeratorServer", "level": 3 }, { "id": "target-campaignengagementserver", "anchor": "target-campaignengagementserver", "title": "campaignEngagementServer", "level": 3 }, { "id": "target-botserver", "anchor": "target-botserver", "title": "botServer", "level": 3 }, { "id": "target-analyticsserver", "anchor": "target-analyticsserver", "title": "analyticsServer", "level": 3 }, { "id": "target-configserver", "anchor": "target-configserver", "title": "configServer", "level": 3 }, { "id": "target-stickerserver", "anchor": "target-stickerserver", "title": "stickerServer", "level": 3 }, { "id": "target-notificationserver", "anchor": "target-notificationserver", "title": "notificationServer", "level": 3 }, { "id": "target-bestbudsarchiver", "anchor": "target-bestbudsarchiver", "title": "bestbudsArchiver", "level": 3 }, { "id": "target-accountpurgeserver", "anchor": "target-accountpurgeserver", "title": "accountPurgeServer", "level": 3 }, { "id": "target-dataprobe", "anchor": "target-dataprobe", "title": "dataProbe", "level": 3 }, { "id": "matching-knowledge-and-delivery-subsystems", "anchor": "matching-knowledge-and-delivery-subsystems", "title": "Matching, knowledge and delivery subsystems", "level": 2 }, { "id": "support-airflow", "anchor": "support-airflow", "title": "neo4j-airflow-sync", "level": 3 }, { "id": "support-matcher", "anchor": "support-matcher", "title": "matcher-v2", "level": 3 }, { "id": "support-algorithm", "anchor": "support-algorithm", "title": "models/algorithm", "level": 3 }, { "id": "support-knowledge", "anchor": "support-knowledge", "title": "Knowledge import and graph gateway", "level": 3 }, { "id": "support-dagger", "anchor": "support-dagger", "title": "Dagger and CI", "level": 3 }, { "id": "support-fastlane", "anchor": "support-fastlane", "title": "Fastlane and mobile delivery", "level": 3 }, { "id": "support-k3s", "anchor": "support-k3s", "title": "Cloud/k3s operations", "level": 3 }, { "id": "support-tests", "anchor": "support-tests", "title": "Cross-platform test harnesses", "level": 3 }, { "id": "support-assets", "anchor": "support-assets", "title": "Design/source assets", "level": 3 }, { "id": "support-migrations", "anchor": "support-migrations", "title": "SQL migrations", "level": 3 }, { "id": "support-docs", "anchor": "support-docs", "title": "Documentation catalog", "level": 3 } ], "links": [ { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-module-review", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-workbench-layers", "anchor": "one-command-line", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "3-greenfield-creation-is-a-first-class-product", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "18-the-release-must-prove-four-complete-journeys", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "6-the-core-a-live-model-with-a-small-semantic-kernel", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "7-kotlin-and-the-public-programming-model", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "8-a-generating-basis-modules-features-and-capabilities", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "9-runtime-actors-and-safe-live-evolution", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "12-flows-choreography-and-the-opinionated-datacloud-stack", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "10-formal-methods-and-simulation-as-everyday-development-tools", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "11-claude-codex-and-an-agent-native-system-interface", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "14-studio-ides-and-tools-that-gain-power-from-the-graph", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "12-flows-choreography-and-the-opinionated-datacloud-stack", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "15-build-deploy-and-operate-one-reproducible-system", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "13-polyglot-contracts-ffi-and-data-oriented-execution", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "15-build-deploy-and-operate-one-reproducible-system", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "17-what-public-v1-means", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "20-non-negotiable-december-release-gates", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "19-roadmap-from-september-2026-to-september-2027", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "21-measuring-whether-reaktor-is-winning", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "22-adoption-distribution-and-the-ten-year-position", "relation": "references", "sourceAnchor": "astra-objectives" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "23-independent-review-claude", "relation": "references", "sourceAnchor": "kernel-v0" }, { "id": "reaktor-db", "anchor": "reading-map", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-work" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-flexbuffer" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-flexbuffer" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-flexbuffer" } ] }, { "id": "reaktor-module-review", "owner": "Astra / Codex", "kind": "analysis", "summary": "Source-grounded assessment of all 37 open Reaktor directories, five closed library slices, 27 targets and supporting systems: purpose, quality, stability, usage, vision, impact and typed multilayer graph integration.", "use": "Read to understand module readiness and high-value combinations. The companion execution plan translates the Astra master plan into five ranked tasks per module and target.", "region": "framework-module-strategy", "order": 0, "title": "Reaktor Module Review — Readiness, Graph Integration and Compounding Value", "nav": "Module Review", "group": "framework", "subsection": "framework-module-strategy", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-module-review", "revision": "e8a343220c0ad4a510c2575b17ec77080975f7526d23cbd21123b065823c814d", "status": "unverified", "renderingRevision": "a7077f8fd86ba473e97ddb598e9ec99de3c29001c40a5cc92f5b15754d2f6e9b", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://arxiv.org/abs/1309.7233", "https://www.w3.org/TR/shacl/", "https://opentelemetry.io/docs/specs/otel/trace/api/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-module-review", "polarity": "Neutral" }, { "id": "section-astra-alignment", "anchor": "astra-alignment", "label": "Relationship to the Astra master plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#astra-alignment", "polarity": "Neutral" }, { "id": "section-1-scope-evidence-and-rating-method", "anchor": "1-scope-evidence-and-rating-method", "label": "1. Scope, evidence, and rating method", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#1-scope-evidence-and-rating-method", "polarity": "Neutral" }, { "id": "section-2-what-the-graph-is-today-and-what-it-should-become", "anchor": "2-what-the-graph-is-today-and-what-it-should-become", "label": "2. What the graph is today, and what it should become", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#2-what-the-graph-is-today-and-what-it-should-become", "polarity": "Neutral" }, { "id": "section-3-open-reaktor-modules", "anchor": "3-open-reaktor-modules", "label": "3. Open Reaktor modules", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#3-open-reaktor-modules", "polarity": "Neutral" }, { "id": "section-4-closed-reaktor-and-bestbuds-modules", "anchor": "4-closed-reaktor-and-bestbuds-modules", "label": "4. Closed Reaktor and BestBuds modules", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#4-closed-reaktor-and-bestbuds-modules", "polarity": "Neutral" }, { "id": "section-5-bestbuds-functional-domains", "anchor": "5-bestbuds-functional-domains", "label": "5. BestBuds functional domains", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#5-bestbuds-functional-domains", "polarity": "Neutral" }, { "id": "section-reaktor-performance", "anchor": "reaktor-performance", "label": "reaktor-performance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-performance", "polarity": "Neutral" }, { "id": "section-decisions-refined-by-the-follow-up-source-and-document-review", "anchor": "decisions-refined-by-the-follow-up-source-and-document-review", "label": "Decisions refined by the follow-up source and document review", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#decisions-refined-by-the-follow-up-source-and-document-review", "polarity": "Neutral" }, { "id": "section-reaktor-core", "anchor": "reaktor-core", "label": "reaktor-core", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-core", "polarity": "Neutral" }, { "id": "section-reaktor-graph-port", "anchor": "reaktor-graph-port", "label": "reaktor-graph-port", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-graph-port", "polarity": "Neutral" }, { "id": "section-reaktor-graph-runtime", "anchor": "reaktor-graph-runtime", "label": "reaktor-graph-runtime", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-graph-runtime", "polarity": "Neutral" }, { "id": "section-reaktor-graph", "anchor": "reaktor-graph", "label": "reaktor-graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-graph", "polarity": "Neutral" }, { "id": "section-reaktor-io", "anchor": "reaktor-io", "label": "reaktor-io", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-io", "polarity": "Neutral" }, { "id": "section-reaktor-service", "anchor": "reaktor-service", "label": "reaktor-service", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-service", "polarity": "Neutral" }, { "id": "section-reaktor-db", "anchor": "reaktor-db", "label": "reaktor-db", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-db", "polarity": "Neutral" }, { "id": "section-reaktor-auth-core", "anchor": "reaktor-auth-core", "label": "reaktor-auth-core", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-auth-core", "polarity": "Neutral" }, { "id": "section-reaktor-auth", "anchor": "reaktor-auth", "label": "reaktor-auth", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-auth", "polarity": "Neutral" }, { "id": "section-reaktor-secrets", "anchor": "reaktor-secrets", "label": "reaktor-secrets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-secrets", "polarity": "Neutral" }, { "id": "section-reaktor-security", "anchor": "reaktor-security", "label": "reaktor-security", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-security", "polarity": "Neutral" }, { "id": "section-reaktor-cloudflare", "anchor": "reaktor-cloudflare", "label": "reaktor-cloudflare", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-cloudflare", "polarity": "Neutral" }, { "id": "section-reaktor-google", "anchor": "reaktor-google", "label": "reaktor-google", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-google", "polarity": "Neutral" }, { "id": "section-reaktor-work", "anchor": "reaktor-work", "label": "reaktor-work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-work", "polarity": "Neutral" }, { "id": "section-reaktor-notification", "anchor": "reaktor-notification", "label": "reaktor-notification", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-notification", "polarity": "Neutral" }, { "id": "section-reaktor-location", "anchor": "reaktor-location", "label": "reaktor-location", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-location", "polarity": "Neutral" }, { "id": "section-reaktor-sensors", "anchor": "reaktor-sensors", "label": "reaktor-sensors", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-sensors", "polarity": "Neutral" }, { "id": "section-reaktor-health", "anchor": "reaktor-health", "label": "reaktor-health", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-health", "polarity": "Neutral" }, { "id": "section-reaktor-media", "anchor": "reaktor-media", "label": "reaktor-media", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-media", "polarity": "Neutral" }, { "id": "section-reaktor-telemetry", "anchor": "reaktor-telemetry", "label": "reaktor-telemetry", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-telemetry", "polarity": "Neutral" }, { "id": "section-reaktor-flexbuffer", "anchor": "reaktor-flexbuffer", "label": "reaktor-flexbuffer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-flexbuffer", "polarity": "Neutral" }, { "id": "section-reaktor-ffi", "anchor": "reaktor-ffi", "label": "reaktor-ffi", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-ffi", "polarity": "Neutral" }, { "id": "section-reaktor-compiler", "anchor": "reaktor-compiler", "label": "reaktor-compiler", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-compiler", "polarity": "Neutral" }, { "id": "section-dependeasy", "anchor": "dependeasy", "label": "dependeasy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#dependeasy", "polarity": "Neutral" }, { "id": "section-reaktor-code", "anchor": "reaktor-code", "label": "reaktor-code", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-code", "polarity": "Neutral" }, { "id": "section-reaktor-ui", "anchor": "reaktor-ui", "label": "reaktor-ui", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-ui", "polarity": "Neutral" }, { "id": "section-compose-flow", "anchor": "compose-flow", "label": "compose-flow", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#compose-flow", "polarity": "Neutral" }, { "id": "section-reaktor-flow", "anchor": "reaktor-flow", "label": "reaktor-flow", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-flow", "polarity": "Neutral" }, { "id": "section-reaktor-tooling", "anchor": "reaktor-tooling", "label": "reaktor-tooling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-tooling", "polarity": "Neutral" }, { "id": "section-reaktor-mcp", "anchor": "reaktor-mcp", "label": "reaktor-mcp", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-mcp", "polarity": "Neutral" }, { "id": "section-reaktor-conductor", "anchor": "reaktor-conductor", "label": "reaktor-conductor", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-conductor", "polarity": "Neutral" }, { "id": "section-reaktor-cloud", "anchor": "reaktor-cloud", "label": "reaktor-cloud", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-cloud", "polarity": "Neutral" }, { "id": "section-reaktor-cli", "anchor": "reaktor-cli", "label": "reaktor-cli", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-cli", "polarity": "Neutral" }, { "id": "section-reaktor-web", "anchor": "reaktor-web", "label": "reaktor-web", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-web", "polarity": "Neutral" }, { "id": "section-reaktor-tactile", "anchor": "reaktor-tactile", "label": "reaktor-tactile", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-tactile", "polarity": "Neutral" }, { "id": "section-reaktor-react", "anchor": "reaktor-react", "label": "reaktor-react", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktor-react", "polarity": "Neutral" }, { "id": "section-bestbuds-moduleskernel--workspace-backend", "anchor": "bestbuds-moduleskernel--workspace-backend", "label": "BestBuds modules/kernel — workspace backend", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#bestbuds-moduleskernel--workspace-backend", "polarity": "Neutral" }, { "id": "section-bestbuds-modulesengine--workbench-and-presentation", "anchor": "bestbuds-modulesengine--workbench-and-presentation", "label": "BestBuds modules/engine — workbench and presentation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#bestbuds-modulesengine--workbench-and-presentation", "polarity": "Neutral" }, { "id": "section-bestbuds-modulesapp--shared-product-and-worker-implementations", "anchor": "bestbuds-modulesapp--shared-product-and-worker-implementations", "label": "BestBuds modules/app — shared product and Worker implementations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#bestbuds-modulesapp--shared-product-and-worker-implementations", "polarity": "Neutral" }, { "id": "section-bestbuds-modulesdesign--product-design-system", "anchor": "bestbuds-modulesdesign--product-design-system", "label": "BestBuds modules/design — product design system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#bestbuds-modulesdesign--product-design-system", "polarity": "Neutral" }, { "id": "section-modulesengineprototype-browser--engineprototype--browser-publication-slice", "anchor": "modulesengineprototype-browser--engineprototype--browser-publication-slice", "label": "modules/engine/prototype-browser / enginePrototype — browser publication slice", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#modulesengineprototype-browser--engineprototype--browser-publication-slice", "polarity": "Neutral" }, { "id": "section-reaktorproduct-hosts", "anchor": "reaktorproduct-hosts", "label": "Reaktor/product hosts", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#reaktorproduct-hosts", "polarity": "Neutral" }, { "id": "section-worker-fleet-and-operational-targets", "anchor": "worker-fleet-and-operational-targets", "label": "Worker fleet and operational targets", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#worker-fleet-and-operational-targets", "polarity": "Neutral" }, { "id": "section-8-execution-roadmap-and-framework-acceptance-bar", "anchor": "8-execution-roadmap-and-framework-acceptance-bar", "label": "8. Execution roadmap and framework acceptance bar", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#8-execution-roadmap-and-framework-acceptance-bar", "polarity": "Neutral" }, { "id": "section-primary-architecture-references", "anchor": "primary-architecture-references", "label": "Primary architecture references", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-module-review#primary-architecture-references", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-3-greenfield-creation-is-a-first-class-product", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-3-greenfield-creation-is-a-first-class-product", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-6-the-core-a-live-model-with-a-small-semantic-kernel", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-6-the-core-a-live-model-with-a-small-semantic-kernel", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-8-a-generating-basis-modules-features-and-capabilities", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-8-a-generating-basis-modules-features-and-capabilities", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-9-runtime-actors-and-safe-live-evolution", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-9-runtime-actors-and-safe-live-evolution", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-10-formal-methods-and-simulation-as-everyday-development-tools", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-10-formal-methods-and-simulation-as-everyday-development-tools", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-11-claude-codex-and-an-agent-native-system-interface", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-11-claude-codex-and-an-agent-native-system-interface", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-13-polyglot-contracts-ffi-and-data-oriented-execution", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-13-polyglot-contracts-ffi-and-data-oriented-execution", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-17-what-public-v1-means", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-17-what-public-v1-means", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-21-measuring-whether-reaktor-is-winning", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-astra-alignment", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-21-measuring-whether-reaktor-is-winning", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-workbench-layers-one-command-line", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-decisions-refined-by-the-follow-up-source-and-document-review", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "section-one-command-line", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-kernel-v0", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-decisions-refined-by-the-follow-up-source-and-document-review", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-kernel-v0", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-service", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-decisions-refined-by-the-follow-up-source-and-document-review", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-db", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-decisions-refined-by-the-follow-up-source-and-document-review", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-graph-substrate-redesign-23-independent-review-claude", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-decisions-refined-by-the-follow-up-source-and-document-review", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "section-23-independent-review-claude", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-core", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-core", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-core", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-graph-port", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-graph-port", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-graph-port", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-graph-runtime", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-graph-runtime", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-graph-runtime", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-graph", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-graph", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-graph", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-io", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-io", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-io", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-service", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-service", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-service", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-db-reading-map", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-reading-map", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-data-storage", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-data-implementation", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-db", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-db", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-db", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-auth-core", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-auth-core", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-auth-core", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-auth", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-auth", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-auth", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-secrets", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-secrets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-secrets", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-security", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-security", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-security", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-cloudflare", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-cloudflare", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-cloudflare", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-google", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-google", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-google", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-work", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-work", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-work", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-notification", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-notification", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-notification", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-location", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-location", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-location", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-sensors", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-sensors", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-sensors", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-health", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-health", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-health", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-media", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-media", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-media", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-telemetry", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-telemetry", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-telemetry", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-performance", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-performance", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-performance", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-flexbuffer", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-flexbuffer", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-flexbuffer", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-flexbuffer-performance-review", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-flexbuffer", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-flatbuffers-flexbuffers-mutable-memory", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-flexbuffer", "role": "source", "ordinal": 0 }, { "node": "flatbuffers-flexbuffers-mutable-memory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-ffi", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-ffi", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-ffi", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-ffi", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-ffi", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-compiler", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-compiler", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-compiler", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-dependeasy", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-dependeasy", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-dependeasy", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-code", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-code", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-code", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-ui", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-ui", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-ui", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-compose-flow", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-compose-flow", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-compose-flow", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-flow", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-flow", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-flow", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-tooling", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-tooling", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-tooling", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-mcp", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-mcp", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-mcp", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-conductor", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-conductor", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-conductor", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-cloud", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-cloud", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-cloud", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-cli", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-cli", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-cli", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-web", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-web", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-web", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-tactile", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-tactile", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-tactile", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-reaktor-react", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktor-react", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-react", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-bestbuds-kernel", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-bestbuds-moduleskernel--workspace-backend", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-bestbuds-kernel", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-bestbuds-engine", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-bestbuds-modulesengine--workbench-and-presentation", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-bestbuds-engine", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-bestbuds-app", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-bestbuds-modulesapp--shared-product-and-worker-implementations", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-bestbuds-app", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-bestbuds-design", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-bestbuds-modulesdesign--product-design-system", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-bestbuds-design", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-bestbuds-engineprototype", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-modulesengineprototype-browser--engineprototype--browser-publication-slice", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-bestbuds-engineprototype", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-appandroid", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-appandroid", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-appdarwin", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-appdarwin", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-appweb", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-appweb", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-reaktordesktop", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-reaktordesktop", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-reaktorcli", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-reaktorcli", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-reaktorserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-reaktorserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-reaktorweb", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-reaktorweb", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-companyos", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-companyos", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-designprototype", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-designprototype", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-reaktorprototype", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-reaktorprototype", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-prototypeworker", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-prototypeworker", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-tracker", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-reaktorproduct-hosts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-tracker", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-chatserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-chatserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-messagingserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-messagingserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-socialserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-socialserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-mediaserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-mediaserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-textmoderatorserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-textmoderatorserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-imagemoderatorserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-imagemoderatorserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-campaignengagementserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-campaignengagementserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-botserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-botserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-analyticsserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-analyticsserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-configserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-configserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-stickerserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-stickerserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-notificationserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-notificationserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-bestbudsarchiver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-bestbudsarchiver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-accountpurgeserver", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-accountpurgeserver", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-target-dataprobe", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-worker-fleet-and-operational-targets", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-target-dataprobe", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-module-execution-plan-critical-path", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-8-execution-roadmap-and-framework-acceptance-bar", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-critical-path", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-astra-reaktor-plan-and-roadmap-19-roadmap-from-september-2026-to-september-2027", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-8-execution-roadmap-and-framework-acceptance-bar", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-19-roadmap-from-september-2026-to-september-2027", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-workbench-layers", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-primary-architecture-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-primary-architecture-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-primary-architecture-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-data-graph", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-primary-architecture-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-module-review:references-reaktor-conductor", "kind": "references", "owner": "reaktor-module-review", "incidences": [ { "node": "reaktor-module-review", "port": "section-primary-architecture-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-module-review.json", "sections": [ { "id": "reaktor-module-review--readiness-graph-integration-and-compounding-value", "anchor": "reaktor-module-review--readiness-graph-integration-and-compounding-value", "title": "Reaktor Module Review — Readiness, Graph Integration and Compounding Value", "level": 1 }, { "id": "astra-alignment", "anchor": "astra-alignment", "title": "Relationship to the Astra master plan", "level": 2 }, { "id": "decisions-refined-by-the-follow-up-source-and-document-review", "anchor": "decisions-refined-by-the-follow-up-source-and-document-review", "title": "Decisions refined by the follow-up source and document review", "level": 3 }, { "id": "1-scope-evidence-and-rating-method", "anchor": "1-scope-evidence-and-rating-method", "title": "1. Scope, evidence, and rating method", "level": 2 }, { "id": "what-every-module-covers", "anchor": "what-every-module-covers", "title": "What “every module” covers", "level": 3 }, { "id": "how-to-read-the-ratings", "anchor": "how-to-read-the-ratings", "title": "How to read the ratings", "level": 3 }, { "id": "important-corrections-to-older-descriptions", "anchor": "important-corrections-to-older-descriptions", "title": "Important corrections to older descriptions", "level": 3 }, { "id": "2-what-the-graph-is-today-and-what-it-should-become", "anchor": "2-what-the-graph-is-today-and-what-it-should-become", "title": "2. What the graph is today, and what it should become", "level": 2 }, { "id": "existing-graph-surfaces", "anchor": "existing-graph-surfaces", "title": "Existing graph surfaces", "level": 3 }, { "id": "proposed-typed-multilayer-model", "anchor": "proposed-typed-multilayer-model", "title": "Proposed typed multilayer model", "level": 3 }, { "id": "identity-contracts-and-evidence-are-the-enabling-work", "anchor": "identity-contracts-and-evidence-are-the-enabling-work", "title": "Identity, contracts, and evidence are the enabling work", "level": 3 }, { "id": "integration-contract-for-every-module", "anchor": "integration-contract-for-every-module", "title": "Integration contract for every module", "level": 3 }, { "id": "execution-and-scale-rules", "anchor": "execution-and-scale-rules", "title": "Execution and scale rules", "level": 3 }, { "id": "3-open-reaktor-modules", "anchor": "3-open-reaktor-modules", "title": "3. Open Reaktor modules", "level": 2 }, { "id": "reaktor-core", "anchor": "reaktor-core", "title": "reaktor-core", "level": 3 }, { "id": "reaktor-graph-port", "anchor": "reaktor-graph-port", "title": "reaktor-graph-port", "level": 3 }, { "id": "reaktor-graph-runtime", "anchor": "reaktor-graph-runtime", "title": "reaktor-graph-runtime", "level": 3 }, { "id": "reaktor-graph", "anchor": "reaktor-graph", "title": "reaktor-graph", "level": 3 }, { "id": "reaktor-io", "anchor": "reaktor-io", "title": "reaktor-io", "level": 3 }, { "id": "reaktor-service", "anchor": "reaktor-service", "title": "reaktor-service", "level": 3 }, { "id": "reaktor-db", "anchor": "reaktor-db", "title": "reaktor-db", "level": 3 }, { "id": "reaktor-auth-core", "anchor": "reaktor-auth-core", "title": "reaktor-auth-core", "level": 3 }, { "id": "reaktor-auth", "anchor": "reaktor-auth", "title": "reaktor-auth", "level": 3 }, { "id": "reaktor-secrets", "anchor": "reaktor-secrets", "title": "reaktor-secrets", "level": 3 }, { "id": "reaktor-security", "anchor": "reaktor-security", "title": "reaktor-security", "level": 3 }, { "id": "reaktor-cloudflare", "anchor": "reaktor-cloudflare", "title": "reaktor-cloudflare", "level": 3 }, { "id": "reaktor-google", "anchor": "reaktor-google", "title": "reaktor-google", "level": 3 }, { "id": "reaktor-work", "anchor": "reaktor-work", "title": "reaktor-work", "level": 3 }, { "id": "reaktor-notification", "anchor": "reaktor-notification", "title": "reaktor-notification", "level": 3 }, { "id": "reaktor-location", "anchor": "reaktor-location", "title": "reaktor-location", "level": 3 }, { "id": "reaktor-sensors", "anchor": "reaktor-sensors", "title": "reaktor-sensors", "level": 3 }, { "id": "reaktor-health", "anchor": "reaktor-health", "title": "reaktor-health", "level": 3 }, { "id": "reaktor-media", "anchor": "reaktor-media", "title": "reaktor-media", "level": 3 }, { "id": "reaktor-telemetry", "anchor": "reaktor-telemetry", "title": "reaktor-telemetry", "level": 3 }, { "id": "reaktor-performance", "anchor": "reaktor-performance", "title": "reaktor-performance", "level": 3 }, { "id": "reaktor-flexbuffer", "anchor": "reaktor-flexbuffer", "title": "reaktor-flexbuffer", "level": 3 }, { "id": "reaktor-ffi", "anchor": "reaktor-ffi", "title": "reaktor-ffi", "level": 3 }, { "id": "reaktor-compiler", "anchor": "reaktor-compiler", "title": "reaktor-compiler", "level": 3 }, { "id": "dependeasy", "anchor": "dependeasy", "title": "dependeasy", "level": 3 }, { "id": "reaktor-code", "anchor": "reaktor-code", "title": "reaktor-code", "level": 3 }, { "id": "reaktor-ui", "anchor": "reaktor-ui", "title": "reaktor-ui", "level": 3 }, { "id": "compose-flow", "anchor": "compose-flow", "title": "compose-flow", "level": 3 }, { "id": "reaktor-flow", "anchor": "reaktor-flow", "title": "reaktor-flow", "level": 3 }, { "id": "reaktor-tooling", "anchor": "reaktor-tooling", "title": "reaktor-tooling", "level": 3 }, { "id": "reaktor-mcp", "anchor": "reaktor-mcp", "title": "reaktor-mcp", "level": 3 }, { "id": "reaktor-conductor", "anchor": "reaktor-conductor", "title": "reaktor-conductor", "level": 3 }, { "id": "reaktor-cloud", "anchor": "reaktor-cloud", "title": "reaktor-cloud", "level": 3 }, { "id": "reaktor-cli", "anchor": "reaktor-cli", "title": "reaktor-cli", "level": 3 }, { "id": "reaktor-web", "anchor": "reaktor-web", "title": "reaktor-web", "level": 3 }, { "id": "reaktor-tactile", "anchor": "reaktor-tactile", "title": "reaktor-tactile", "level": 3 }, { "id": "reaktor-react", "anchor": "reaktor-react", "title": "reaktor-react", "level": 3 }, { "id": "4-closed-reaktor-and-bestbuds-modules", "anchor": "4-closed-reaktor-and-bestbuds-modules", "title": "4. Closed Reaktor and BestBuds modules", "level": 2 }, { "id": "bestbuds-moduleskernel--workspace-backend", "anchor": "bestbuds-moduleskernel--workspace-backend", "title": "BestBuds modules/kernel — workspace backend", "level": 3 }, { "id": "bestbuds-modulesengine--workbench-and-presentation", "anchor": "bestbuds-modulesengine--workbench-and-presentation", "title": "BestBuds modules/engine — workbench and presentation", "level": 3 }, { "id": "bestbuds-modulesapp--shared-product-and-worker-implementations", "anchor": "bestbuds-modulesapp--shared-product-and-worker-implementations", "title": "BestBuds modules/app — shared product and Worker implementations", "level": 3 }, { "id": "bestbuds-modulesdesign--product-design-system", "anchor": "bestbuds-modulesdesign--product-design-system", "title": "BestBuds modules/design — product design system", "level": 3 }, { "id": "modulesengineprototype-browser--engineprototype--browser-publication-slice", "anchor": "modulesengineprototype-browser--engineprototype--browser-publication-slice", "title": "modules/engine/prototype-browser / enginePrototype — browser publication slice", "level": 3 }, { "id": "workbench-functional-modules-inside-engine", "anchor": "workbench-functional-modules-inside-engine", "title": "Workbench functional modules inside engine", "level": 3 }, { "id": "5-bestbuds-functional-domains", "anchor": "5-bestbuds-functional-domains", "title": "5. BestBuds functional domains", "level": 2 }, { "id": "matching-and-graph-data-subsystems-outside-gradle", "anchor": "matching-and-graph-data-subsystems-outside-gradle", "title": "Matching and graph-data subsystems outside Gradle", "level": 3 }, { "id": "6-every-bestbuds-target-and-supporting-delivery-module", "anchor": "6-every-bestbuds-target-and-supporting-delivery-module", "title": "6. Every BestBuds target and supporting delivery module", "level": 2 }, { "id": "reaktorproduct-hosts", "anchor": "reaktorproduct-hosts", "title": "Reaktor/product hosts", "level": 3 }, { "id": "worker-fleet-and-operational-targets", "anchor": "worker-fleet-and-operational-targets", "title": "Worker fleet and operational targets", "level": 3 }, { "id": "supporting-systems-that-should-contribute-to-the-graph", "anchor": "supporting-systems-that-should-contribute-to-the-graph", "title": "Supporting systems that should contribute to the graph", "level": 3 }, { "id": "named-visions-that-are-not-independent-implemented-modules", "anchor": "named-visions-that-are-not-independent-implemented-modules", "title": "Named visions that are not independent implemented modules", "level": 3 }, { "id": "7-combinations-with-the-highest-potential-return", "anchor": "7-combinations-with-the-highest-potential-return", "title": "7. Combinations with the highest potential return", "level": 2 }, { "id": "1-service-to-production-impact-analysis--first-priority", "anchor": "1-service-to-production-impact-analysis--first-priority", "title": "1. Service-to-production impact analysis — first priority", "level": 3 }, { "id": "2-reliable-messaging-and-notifications-under-failure--first-priority", "anchor": "2-reliable-messaging-and-notifications-under-failure--first-priority", "title": "2. Reliable messaging and notifications under failure — first priority", "level": 3 }, { "id": "3-authority-aware-operations-and-credential-rotation--first-priority", "anchor": "3-authority-aware-operations-and-credential-rotation--first-priority", "title": "3. Authority-aware operations and credential rotation — first priority", "level": 3 }, { "id": "4-evidence-backed-agent-work--second-priority", "anchor": "4-evidence-backed-agent-work--second-priority", "title": "4. Evidence-backed agent work — second priority", "level": 3 }, { "id": "5-matching-that-improves-real-relationships--second-priority", "anchor": "5-matching-that-improves-real-relationships--second-priority", "title": "5. Matching that improves real relationships — second priority", "level": 3 }, { "id": "6-measured-polyglot-acceleration--secondthird-priority", "anchor": "6-measured-polyglot-acceleration--secondthird-priority", "title": "6. Measured polyglot acceleration — second/third priority", "level": 3 }, { "id": "7-design-to-behavior-traceability--second-priority", "anchor": "7-design-to-behavior-traceability--second-priority", "title": "7. Design-to-behavior traceability — second priority", "level": 3 }, { "id": "8-data-lifecycle-and-deletion-completeness--second-priority", "anchor": "8-data-lifecycle-and-deletion-completeness--second-priority", "title": "8. Data lifecycle and deletion completeness — second priority", "level": 3 }, { "id": "9-device-context-features-with-truthful-observations--later-driven-by-gymbuddy", "anchor": "9-device-context-features-with-truthful-observations--later-driven-by-gymbuddy", "title": "9. Device-context features with truthful observations — later, driven by GymBuddy", "level": 3 }, { "id": "10-documentation-that-invalidates-with-code--low-cost-broad-value", "anchor": "10-documentation-that-invalidates-with-code--low-cost-broad-value", "title": "10. Documentation that invalidates with code — low-cost, broad value", "level": 3 }, { "id": "how-to-measure-combinatorial-improvement", "anchor": "how-to-measure-combinatorial-improvement", "title": "How to measure combinatorial improvement", "level": 3 }, { "id": "8-execution-roadmap-and-framework-acceptance-bar", "anchor": "8-execution-roadmap-and-framework-acceptance-bar", "title": "8. Execution roadmap and framework acceptance bar", "level": 2 }, { "id": "the-module-admission-bar", "anchor": "the-module-admission-bar", "title": "The module admission bar", "level": 3 }, { "id": "source-findings-that-drive-the-first-tasks", "anchor": "source-findings-that-drive-the-first-tasks", "title": "Source findings that drive the first tasks", "level": 3 }, { "id": "9-complete-reaktor-rating-index", "anchor": "9-complete-reaktor-rating-index", "title": "9. Complete Reaktor rating index", "level": 2 }, { "id": "10-evidence-and-coverage-appendix", "anchor": "10-evidence-and-coverage-appendix", "title": "10. Evidence and coverage appendix", "level": 2 }, { "id": "inventory-coverage", "anchor": "inventory-coverage", "title": "Inventory coverage", "level": 3 }, { "id": "follow-up-verification-and-scope", "anchor": "follow-up-verification-and-scope", "title": "Follow-up verification and scope", "level": 3 }, { "id": "verification-performed-for-this-review", "anchor": "verification-performed-for-this-review", "title": "Verification performed for this review", "level": 3 }, { "id": "reported-test-cases-and-execution-status", "anchor": "reported-test-cases-and-execution-status", "title": "Reported test cases and execution status", "level": 3 }, { "id": "scope-not-freshly-qualified", "anchor": "scope-not-freshly-qualified", "title": "Scope not freshly qualified", "level": 3 }, { "id": "source-drift-and-newly-appearing-infrastructure-adapters", "anchor": "source-drift-and-newly-appearing-infrastructure-adapters", "title": "Source drift and newly appearing infrastructure adapters", "level": 3 }, { "id": "primary-architecture-references", "anchor": "primary-architecture-references", "title": "Primary architecture references", "level": 3 }, { "id": "external-conceptual-references", "anchor": "external-conceptual-references", "title": "External conceptual references", "level": 3 } ], "links": [ { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "3-greenfield-creation-is-a-first-class-product", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "6-the-core-a-live-model-with-a-small-semantic-kernel", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "8-a-generating-basis-modules-features-and-capabilities", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "8-a-generating-basis-modules-features-and-capabilities", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "9-runtime-actors-and-safe-live-evolution", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "10-formal-methods-and-simulation-as-everyday-development-tools", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "11-claude-codex-and-an-agent-native-system-interface", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "13-polyglot-contracts-ffi-and-data-oriented-execution", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "17-what-public-v1-means", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "21-measuring-whether-reaktor-is-winning", "relation": "references", "sourceAnchor": "astra-alignment" }, { "id": "reaktor-workbench-layers", "anchor": "one-command-line", "relation": "references", "sourceAnchor": "decisions-refined-by-the-follow-up-source-and-document-review" }, { "id": "reaktor-module-execution-plan", "anchor": "kernel-v0", "relation": "references", "sourceAnchor": "decisions-refined-by-the-follow-up-source-and-document-review" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "decisions-refined-by-the-follow-up-source-and-document-review" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "decisions-refined-by-the-follow-up-source-and-document-review" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "23-independent-review-claude", "relation": "references", "sourceAnchor": "decisions-refined-by-the-follow-up-source-and-document-review" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-core", "relation": "references", "sourceAnchor": "reaktor-core" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-graph-port", "relation": "references", "sourceAnchor": "reaktor-graph-port" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-graph-runtime", "relation": "references", "sourceAnchor": "reaktor-graph-runtime" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-graph", "relation": "references", "sourceAnchor": "reaktor-graph" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-io", "relation": "references", "sourceAnchor": "reaktor-io" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-service", "relation": "references", "sourceAnchor": "reaktor-service" }, { "id": "reaktor-db", "anchor": "reading-map", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-data-storage", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-db", "relation": "references", "sourceAnchor": "reaktor-db" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-auth-core", "relation": "references", "sourceAnchor": "reaktor-auth-core" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-auth", "relation": "references", "sourceAnchor": "reaktor-auth" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-secrets", "relation": "references", "sourceAnchor": "reaktor-secrets" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-security", "relation": "references", "sourceAnchor": "reaktor-security" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-cloudflare", "relation": "references", "sourceAnchor": "reaktor-cloudflare" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-google", "relation": "references", "sourceAnchor": "reaktor-google" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-work", "relation": "references", "sourceAnchor": "reaktor-work" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-work" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-notification", "relation": "references", "sourceAnchor": "reaktor-notification" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-location", "relation": "references", "sourceAnchor": "reaktor-location" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-sensors", "relation": "references", "sourceAnchor": "reaktor-sensors" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-health", "relation": "references", "sourceAnchor": "reaktor-health" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-media", "relation": "references", "sourceAnchor": "reaktor-media" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-telemetry", "relation": "references", "sourceAnchor": "reaktor-telemetry" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-performance", "relation": "references", "sourceAnchor": "reaktor-performance" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-flexbuffer", "relation": "references", "sourceAnchor": "reaktor-flexbuffer" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-flexbuffer" }, { "id": "flatbuffers-flexbuffers-mutable-memory", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-flexbuffer" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-ffi", "relation": "references", "sourceAnchor": "reaktor-ffi" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-ffi" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "reaktor-ffi" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-compiler", "relation": "references", "sourceAnchor": "reaktor-compiler" }, { "id": "reaktor-module-execution-plan", "anchor": "dependeasy", "relation": "references", "sourceAnchor": "dependeasy" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-code", "relation": "references", "sourceAnchor": "reaktor-code" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-ui", "relation": "references", "sourceAnchor": "reaktor-ui" }, { "id": "reaktor-module-execution-plan", "anchor": "compose-flow", "relation": "references", "sourceAnchor": "compose-flow" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-flow", "relation": "references", "sourceAnchor": "reaktor-flow" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-tooling", "relation": "references", "sourceAnchor": "reaktor-tooling" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-mcp", "relation": "references", "sourceAnchor": "reaktor-mcp" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-conductor", "relation": "references", "sourceAnchor": "reaktor-conductor" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-cloud", "relation": "references", "sourceAnchor": "reaktor-cloud" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-cli", "relation": "references", "sourceAnchor": "reaktor-cli" }, { "id": "reaktor-workbench-layers", "anchor": "one-command-line", "relation": "references", "sourceAnchor": "reaktor-cli" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-web", "relation": "references", "sourceAnchor": "reaktor-web" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-tactile", "relation": "references", "sourceAnchor": "reaktor-tactile" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-react", "relation": "references", "sourceAnchor": "reaktor-react" }, { "id": "reaktor-module-execution-plan", "anchor": "bestbuds-kernel", "relation": "references", "sourceAnchor": "bestbuds-moduleskernel--workspace-backend" }, { "id": "reaktor-workbench-layers", "anchor": "one-command-line", "relation": "references", "sourceAnchor": "bestbuds-moduleskernel--workspace-backend" }, { "id": "reaktor-module-execution-plan", "anchor": "bestbuds-engine", "relation": "references", "sourceAnchor": "bestbuds-modulesengine--workbench-and-presentation" }, { "id": "reaktor-module-execution-plan", "anchor": "bestbuds-app", "relation": "references", "sourceAnchor": "bestbuds-modulesapp--shared-product-and-worker-implementations" }, { "id": "reaktor-module-execution-plan", "anchor": "bestbuds-design", "relation": "references", "sourceAnchor": "bestbuds-modulesdesign--product-design-system" }, { "id": "reaktor-module-execution-plan", "anchor": "bestbuds-engineprototype", "relation": "references", "sourceAnchor": "modulesengineprototype-browser--engineprototype--browser-publication-slice" }, { "id": "reaktor-module-execution-plan", "anchor": "target-appandroid", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-appdarwin", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-appweb", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-reaktordesktop", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-reaktorcli", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-reaktorserver", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-reaktorweb", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-companyos", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-designprototype", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-reaktorprototype", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-prototypeworker", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-tracker", "relation": "references", "sourceAnchor": "reaktorproduct-hosts" }, { "id": "reaktor-module-execution-plan", "anchor": "target-chatserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-messagingserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-socialserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-mediaserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-textmoderatorserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-imagemoderatorserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-campaignengagementserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-botserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-analyticsserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-configserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-stickerserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-notificationserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-bestbudsarchiver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-accountpurgeserver", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "target-dataprobe", "relation": "references", "sourceAnchor": "worker-fleet-and-operational-targets" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "8-execution-roadmap-and-framework-acceptance-bar" }, { "id": "reaktor-module-execution-plan", "anchor": "critical-path", "relation": "references", "sourceAnchor": "8-execution-roadmap-and-framework-acceptance-bar" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "19-roadmap-from-september-2026-to-september-2027", "relation": "references", "sourceAnchor": "8-execution-roadmap-and-framework-acceptance-bar" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "primary-architecture-references" }, { "id": "reaktor-module-execution-plan", "anchor": "", "relation": "references", "sourceAnchor": "primary-architecture-references" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "primary-architecture-references" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "primary-architecture-references" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "primary-architecture-references" }, { "id": "reaktor-data-graph", "anchor": "", "relation": "references", "sourceAnchor": "primary-architecture-references" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "primary-architecture-references" } ] }, { "id": "reaktor-multitenancy", "owner": "Claude", "kind": "design", "summary": "Tenancy as a cross-cutting concern done once, not per query: ambient AuthContext.tenantId, enforced store adapters, pool/bridge/silo policy, Reaktor-managed GCP cells, customer-owned GCP cells, per-tenant actors/DOs, cells + shuffle-sharding, residency, quotas, and lifecycle operations.", "use": "Use before designing tenant isolation, choosing pooled vs bridge vs Reaktor-managed dedicated capacity vs customer-owned GCP, adding a tenant-scoped store, wiring the tid claim, or building per-tenant quotas/residency/lifecycle.", "region": "data-integrity", "order": 0, "title": "Reaktor Multitenancy — one ambient scope, enforced everywhere", "nav": "Multitenancy", "group": "data", "subsection": "data-integrity", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-multitenancy", "revision": "e433577357dbeb7ae028baf69d02906faf376eca4c2959b4034684de53ee5cc6", "status": "unverified", "renderingRevision": "13dfeb686cc0c1e52e2f5ec66dcf9bfbc9fae6067950d0bfcd4a5b0897d78e58", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-multitenancy", "polarity": "Neutral" }, { "id": "section-requirements", "anchor": "requirements", "label": "1. What multitenancy actually demands", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#requirements", "polarity": "Neutral" }, { "id": "section-today", "anchor": "today", "label": "2. Current source and enforcement gaps", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#today", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "3. The model — tenant as an ambient, enforced scope", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#model", "polarity": "Neutral" }, { "id": "section-isolation", "anchor": "isolation", "label": "4. Isolation models — pool, bridge, silo", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#isolation", "polarity": "Neutral" }, { "id": "section-enforcement", "anchor": "enforcement", "label": "5. Enforcement per store — generalizing MandatoryTenantParameterization", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#enforcement", "polarity": "Neutral" }, { "id": "section-edge", "anchor": "edge", "label": "6. The edge carries the tenant", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#edge", "polarity": "Neutral" }, { "id": "section-coverage", "anchor": "coverage", "label": "12. The 80/20 — what reaktor encodes vs delegates", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#coverage", "polarity": "Neutral" }, { "id": "section-fairness", "anchor": "fairness", "label": "7. Fairness — quotas, noisy neighbors, cells", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#fairness", "polarity": "Neutral" }, { "id": "section-residency", "anchor": "residency", "label": "8. Residency & compliance", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#residency", "polarity": "Neutral" }, { "id": "section-lifecycle", "anchor": "lifecycle", "label": "9. The tenant lifecycle & control plane", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#lifecycle", "polarity": "Neutral" }, { "id": "section-law", "anchor": "law", "label": "3.3 The boundary binds the tenant — the Mandatory Parameterization Law", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#law", "polarity": "Neutral" }, { "id": "section-phases", "anchor": "phases", "label": "13. Build plan & status", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#phases", "polarity": "Neutral" }, { "id": "section-entry", "anchor": "entry", "label": "3.1 The tenant enters once, at the auth boundary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#entry", "polarity": "Neutral" }, { "id": "section-physical-cells", "anchor": "physical-cells", "label": "4.1 Physical Cells And Billing Ownership", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#physical-cells", "polarity": "Neutral" }, { "id": "section-references", "anchor": "references", "label": "15. References", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#references", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#related-docs", "polarity": "Neutral" }, { "id": "section-ambient", "anchor": "ambient", "label": "3.2 The tenant is ambient, never an argument", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#ambient", "polarity": "Neutral" }, { "id": "section-testing", "anchor": "testing", "label": "10. Proving isolation — testing", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#testing", "polarity": "Neutral" }, { "id": "section-prior-art", "anchor": "prior-art", "label": "11. What the industry has learned — and what we copy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#prior-art", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "See also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-multitenancy#see-also", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-multitenancy:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-server", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-server-resilience", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-requirements", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-resilience", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-data-storage-graph", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-today", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-storage", "port": "section-graph", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-data-inspection-authority", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-today", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "section-authority", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-auth-analysis-core-model", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-entry", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "section-core-model", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-core", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-ambient", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-server-multi-tenancy", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-isolation", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-multi-tenancy", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-physical-cells", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-db-sync", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-enforcement", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-sync", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-db-sinks", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-enforcement", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-sinks", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-notifications-design", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-enforcement", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-bus-mesh-contract", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-edge", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "section-contract", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-edge", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-distributed-actors-sharding", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-edge", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "section-sharding", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-server-rate-limiting", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-fairness", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-rate-limiting", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-server-connections", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-fairness", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-connections", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-performance-observability", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-fairness", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-server-overload", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-fairness", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-overload", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-server-idempotency", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-fairness", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "section-idempotency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-db-consistency", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-residency", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-consistency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-data-graph-nodes", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-residency", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-graph", "port": "section-nodes", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-auth-analysis-runtime-graph", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-lifecycle", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "section-runtime-graph", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-capability", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-lifecycle", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-devops", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-lifecycle", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-lifecycle", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-testing", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-auth-analysis-graph-port-auth", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-prior-art", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "section-graph-port-auth", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-db", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-auth-analysis", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-mesh", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-security-plan", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-multitenancy:references-reaktor-service", "kind": "references", "owner": "reaktor-multitenancy", "incidences": [ { "node": "reaktor-multitenancy", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-multitenancy.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Multitenancy — one ambient scope, enforced everywhere", "level": 0 }, { "id": "requirements", "anchor": "requirements", "title": "1. What multitenancy actually demands", "level": 2 }, { "id": "today", "anchor": "today", "title": "2. Current source and enforcement gaps", "level": 2 }, { "id": "model", "anchor": "model", "title": "3. The model — tenant as an ambient, enforced scope", "level": 2 }, { "id": "entry", "anchor": "entry", "title": "3.1 The tenant enters once, at the auth boundary", "level": 3 }, { "id": "ambient", "anchor": "ambient", "title": "3.2 The tenant is ambient, never an argument", "level": 3 }, { "id": "law", "anchor": "law", "title": "3.3 The boundary binds the tenant — the Mandatory Parameterization Law", "level": 3 }, { "id": "isolation", "anchor": "isolation", "title": "4. Isolation models — pool, bridge, silo", "level": 2 }, { "id": "physical-cells", "anchor": "physical-cells", "title": "4.1 Physical Cells And Billing Ownership", "level": 3 }, { "id": "enforcement", "anchor": "enforcement", "title": "5. Enforcement per store — generalizing MandatoryTenantParameterization", "level": 2 }, { "id": "edge", "anchor": "edge", "title": "6. The edge carries the tenant", "level": 2 }, { "id": "fairness", "anchor": "fairness", "title": "7. Fairness — quotas, noisy neighbors, cells", "level": 2 }, { "id": "residency", "anchor": "residency", "title": "8. Residency & compliance", "level": 2 }, { "id": "lifecycle", "anchor": "lifecycle", "title": "9. The tenant lifecycle & control plane", "level": 2 }, { "id": "testing", "anchor": "testing", "title": "10. Proving isolation — testing", "level": 2 }, { "id": "prior-art", "anchor": "prior-art", "title": "11. What the industry has learned — and what we copy", "level": 2 }, { "id": "coverage", "anchor": "coverage", "title": "12. The 80/20 — what reaktor encodes vs delegates", "level": 2 }, { "id": "phases", "anchor": "phases", "title": "13. Build plan & status", "level": 2 }, { "id": "open", "anchor": "open", "title": "14. Open decisions", "level": 2 }, { "id": "references", "anchor": "references", "title": "15. References", "level": 2 }, { "id": "see-also", "anchor": "see-also", "title": "See also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-multitenancy", "anchor": "coverage", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-multitenancy", "anchor": "enforcement", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-multitenancy", "anchor": "fairness", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-multitenancy", "anchor": "residency", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-multitenancy", "anchor": "lifecycle", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-multitenancy", "anchor": "law", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-multitenancy", "anchor": "enforcement", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-server", "anchor": "resilience", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-server", "anchor": "resilience", "relation": "references", "sourceAnchor": "requirements" }, { "id": "reaktor-data-storage", "anchor": "graph", "relation": "references", "sourceAnchor": "today" }, { "id": "reaktor-data-inspection", "anchor": "authority", "relation": "references", "sourceAnchor": "today" }, { "id": "auth-analysis", "anchor": "core-model", "relation": "references", "sourceAnchor": "entry" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "ambient" }, { "id": "reaktor-server", "anchor": "multi-tenancy", "relation": "references", "sourceAnchor": "isolation" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "physical-cells" }, { "id": "reaktor-multitenancy", "anchor": "law", "relation": "references", "sourceAnchor": "enforcement" }, { "id": "reaktor-db", "anchor": "sync", "relation": "references", "sourceAnchor": "enforcement" }, { "id": "reaktor-db", "anchor": "sinks", "relation": "references", "sourceAnchor": "enforcement" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "enforcement" }, { "id": "reaktor-bus-mesh", "anchor": "contract", "relation": "references", "sourceAnchor": "edge" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "edge" }, { "id": "reaktor-distributed-actors", "anchor": "sharding", "relation": "references", "sourceAnchor": "edge" }, { "id": "reaktor-multitenancy", "anchor": "fairness", "relation": "references", "sourceAnchor": "edge" }, { "id": "reaktor-multitenancy", "anchor": "residency", "relation": "references", "sourceAnchor": "edge" }, { "id": "reaktor-multitenancy", "anchor": "requirements", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-server", "anchor": "resilience", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-server", "anchor": "rate-limiting", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-server", "anchor": "connections", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-multitenancy", "anchor": "edge", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-server", "anchor": "multi-tenancy", "relation": "references", "sourceAnchor": "fairness" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-server", "anchor": "overload", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-server", "anchor": "idempotency", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-multitenancy", "anchor": "phases", "relation": "references", "sourceAnchor": "fairness" }, { "id": "reaktor-db", "anchor": "consistency", "relation": "references", "sourceAnchor": "residency" }, { "id": "reaktor-data-graph", "anchor": "nodes", "relation": "references", "sourceAnchor": "residency" }, { "id": "auth-analysis", "anchor": "runtime-graph", "relation": "references", "sourceAnchor": "lifecycle" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "lifecycle" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "lifecycle" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "lifecycle" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "testing" }, { "id": "reaktor-multitenancy", "anchor": "isolation", "relation": "references", "sourceAnchor": "prior-art" }, { "id": "reaktor-multitenancy", "anchor": "enforcement", "relation": "references", "sourceAnchor": "prior-art" }, { "id": "reaktor-multitenancy", "anchor": "entry", "relation": "references", "sourceAnchor": "prior-art" }, { "id": "auth-analysis", "anchor": "graph-port-auth", "relation": "references", "sourceAnchor": "prior-art" }, { "id": "reaktor-multitenancy", "anchor": "enforcement", "relation": "references", "sourceAnchor": "prior-art" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "coverage" }, { "id": "reaktor-server", "anchor": "resilience", "relation": "references", "sourceAnchor": "coverage" }, { "id": "reaktor-multitenancy", "anchor": "fairness", "relation": "references", "sourceAnchor": "coverage" }, { "id": "reaktor-server", "anchor": "resilience", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-multitenancy", "anchor": "fairness", "relation": "references", "sourceAnchor": "phases" }, { "id": "reaktor-multitenancy", "anchor": "physical-cells", "relation": "references", "sourceAnchor": "open" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-server", "anchor": "multi-tenancy", "relation": "references", "sourceAnchor": "references" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-server", "anchor": "multi-tenancy", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-server", "anchor": "resilience", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-multitenancy", "anchor": "fairness", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-nested-graphs-theory", "kind": "design", "owner": "Reaktor", "region": "theory-foundations", "use": "Read the semantic theory, diagrams and concrete source mappings; distinguish declared profiles from qualified runtime behavior.", "order": 4, "summary": "Nested graphs: 5 diagrammed designs, with legends, domains, Reaktor examples and explicit laws.", "diagrams": [ { "id": "nested-feature", "src": "/docs/img/theory/nested-feature.svg", "alt": "A feature graph inside an app", "text": "How does ChatGraph expose a route while retaining its internal service and Surface identities?\nThe runtime Graph has parentGraph, lifecycle, DI and coroutine scopes. A definition region records a semantic boundary; ChatGraph activation realizes it. Exports preserve contracts and original port identities. The parent does not inherit arbitrary visibility into private data.\nmobile\nweb\nnavigation\nThis is a schematic mapping of existing nested graph/runtime concepts; named region exports need the qualified host adapter.\nA visual frame does not alone establish lifetime ownership, scheduling, authority or physical co-location.\nentry: App navigation (N12)\nentry.route: P11; ConversationRouteV1; Offer\nboundary: ChatGraph exported contract (N10)\nboundary.entry: P11; ConversationRouteV1; Require\nboundary.surface: P11; ConversationRouteV1; Offer\nboundary.service: P02; MessagingApiV1; Require\nscreen: Conversation ComposeNode (N11)\nscreen.route: P11; ConversationRouteV1; Require\nscreen.detail: P11; DetailsRouteV1; Offer\nservice: MessagingService inside ChatGraph (N02)\nservice.rpc: P02; MessagingApiV1; Offer\ndetail: Details ComposeNode (N11)\ndetail.route: P11; DetailsRouteV1; Require\nentry (H01): provider[0]=entry.route; consumer[0]=boundary.entry\nroute-alias (H30): external[0]=boundary.surface; internal[0]=screen.route\nservice-export (H30): internal[0]=service.rpc; external[0]=boundary.service\ndetails-binding (H01): provider[0]=screen.detail; consumer[0]=detail.route" }, { "id": "nested-partition", "src": "/docs/img/theory/nested-partition.svg", "alt": "A legal boundary across systems", "text": "What changes when the service moves to a remote host?\nKeep the ConversationRoute local to Compose. Rebind only the MessagingApi exported port through a ServiceEndpoint HTTP adapter; preserve service identity, auth scope, schema, timeout and error outcomes. The target FFI adapter similarly crosses a language boundary only after ABI and ownership qualification.\ndistributed systems\nRPC\nFFI\nDo not export a local borrowed buffer or Compose object across a network boundary.\nPlacement is a plan; an observation with activation/revision/host is needed to establish what actually runs.\nscreen: Chat ComposeNode (N11)\nscreen.send: P02; MessagingApiV1; Require\nadapter: ServiceEndpoint HTTP (N19)\nadapter.client: P02; MessagingApiV1; Offer\nadapter.remote: P02; MessagingApiV1; Require\nserver: MessagingService authority (N02)\nserver.api: P02; MessagingApiV1; Offer\nclient-binding (H05): caller[0]=screen.send; callee[0]=adapter.client\nsystem-hop (H05): caller[0]=adapter.remote; callee[0]=server.api" }, { "id": "nested-instances", "src": "/docs/img/theory/nested-instances.svg", "alt": "Shared definition, separate activations", "text": "Can two conversation sessions share a blueprint without sharing mutable actor state?\nA session factory references one Chat feature definition and creates two activation identities, each owning its own state and lifetime. The definition is reusable; runtime mailbox, grants and resources remain scoped to the activation.\nactors\ngames\ntenancy\nRegion nesting is not a durability or tenant-isolation mechanism by itself.\nUse stable definition IDs with separate activation IDs and epochs, rather than copying live object identities.\nfactory: Chat session factory (N29)\nfactory.definition: P23; ChatDefinitionV1; Offer\na: Conversation actor A (N05)\na.activation: P21; ChatDefinitionV1; Require\nb: Conversation actor B (N05)\nb.activation: P21; ChatDefinitionV1; Require\ninstantiate (H20): definition[0]=factory.definition; instance[0]=a.activation; instance[1]=b.activation" }, { "id": "nested-code-push", "src": "/docs/img/theory/nested-code-push.svg", "alt": "A replaceable RGL feature region", "text": "What makes one feature region independently replaceable?\nRGL combines its GraphDefinition with ordinary common Kotlin implementation, a Kotlin/JS artifact and qualified FFI host bindings. A release boundary exports stable contracts, pins dependencies, drains old calls and accepts only supported checkpoint schemas.\nRGL\ncode push\nmobile\nThe graph model can describe this release protocol; current prototype FFI does not make every region universally deployable.\nHard constraints such as active borrows, native ABI mismatch or unqualified state migration make a cut ineligible.\nhost: Qualified JS + FFI host (N27)\nhost.feature: P23; RegionBundleV1; Require\nhost.epoch: P21; RegionActivationV1; Offer\nbundle: Common Kotlin JS bundle (N35)\nbundle.artifact: P23; RegionBundleV1; Offer\nregion: Feature boundary (N10)\nregion.lifecycle: P21; RegionActivationV1; Require\nregion.checkpoint: P22; FeatureStateV1; Offer\nmigrate: State migration controller (N40)\nmigrate.state: P22; FeatureStateV1; Require\nartifact (H26): consumer[0]=host.feature; dependency[0]=bundle.artifact\nactivate (H29): release[0]=bundle.artifact; image[0]=host.epoch; localRoot[0]=region.lifecycle\ncheckpoint-binding (H01): provider[0]=region.checkpoint; consumer[0]=migrate.state" }, { "id": "nested-language-boundary", "src": "/docs/img/theory/nested-language-boundary.svg", "alt": "A graph across Kotlin JS and C++", "text": "Which graph identities survive a language boundary, and who owns the returned bytes?\nThe target RGL implementation is ordinary Kotlin/common compiled to Kotlin/JS. A qualified host exposes a typed FFI adapter to a C++ codec. The graph retains caller, host and codec identities; contracts separately describe invocation outcomes and owned frame transfer. Normal KMP code implements the host integration without changing the graph into a second language. Current native hello paths are evidence of integration scaffolding, not this complete production transport.\nFFI\nKotlin common\nKotlin JS\nnative media\nKotlin JS/JVM bridge actuals and the versioned typed frame/stream transport are not generally implemented. Treat this as the target design, not a deployed capability.\nPin ABI, target/module epoch, schema, ownership, release, cancellation and thread affinity; an asynchronous borrow cannot escape without a qualified lease or copy.\nlogic: RGL common Kotlin logic (N01)\nlogic.invoke: P02; CodecCallV1; Require\nlogic.frame: P16; OwnedCodecFrameV1; Require\nhost: Qualified Reaktor FFI host (N27)\nhost.call: P02; CodecCallV1; Offer\nhost.native: P02; CodecCallV1; Require\ncodec: C++ codec / native resource (N16)\ncodec.invoke: P02; CodecCallV1; Offer\ncodec.frame: P16; OwnedCodecFrameV1; Offer\nhost-call (H05): caller[0]=logic.invoke; callee[0]=host.call\nnative-call (H05): caller[0]=host.native; callee[0]=codec.invoke\nowned-frame (H02): source[0]=codec.frame; sink[0]=logic.frame" } ], "title": "Nested graphs", "nav": "Nested graphs", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-nested-graphs-theory", "revision": "31480e10cd47a0caa7eafc543be3209ddad3dcc6767443ae749f1b3d8e20cac2", "status": "design", "renderingRevision": "aa903569c9b135c34d8405af5fe1bb849a1af2860791e89a4bd97720e4507037", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-nested-graphs-theory", "polarity": "Neutral" }, { "id": "nested-feature", "anchor": "nested-feature", "label": "A feature graph inside an app", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-nested-graphs-theory#nested-feature", "polarity": "Neutral" }, { "id": "nested-partition", "anchor": "nested-partition", "label": "A legal boundary across systems", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-nested-graphs-theory#nested-partition", "polarity": "Neutral" }, { "id": "nested-instances", "anchor": "nested-instances", "label": "Shared definition, separate activations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-nested-graphs-theory#nested-instances", "polarity": "Neutral" }, { "id": "nested-code-push", "anchor": "nested-code-push", "label": "A replaceable RGL feature region", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-nested-graphs-theory#nested-code-push", "polarity": "Neutral" }, { "id": "nested-language-boundary", "anchor": "nested-language-boundary", "label": "A graph across Kotlin JS and C++", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-nested-graphs-theory#nested-language-boundary", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-nested-graphs-theory:nested-feature-module", "kind": "references", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "nested-feature", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:nested-partition-module", "kind": "references", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "nested-partition", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:nested-instances-module", "kind": "references", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "nested-instances", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:nested-code-push-module", "kind": "references", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "nested-code-push", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:topic-reaktor-graph-vocabulary-theory", "kind": "explains", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:topic-reaktor-port-theory", "kind": "explains", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-port-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:topic-reaktor-hyperedge-theory", "kind": "explains", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-hyperedge-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:topic-reaktor-graph-views-theory", "kind": "explains", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-views-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-nested-graphs-theory:ffi-language-design", "kind": "references", "owner": "reaktor-nested-graphs-theory", "incidences": [ { "node": "reaktor-nested-graphs-theory", "port": "nested-language-boundary", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-nested-graphs-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Nested graphs", "level": 0 }, { "id": "definition-ownership-and-activation", "anchor": "definition-ownership-and-activation", "title": "Definition, ownership and activation", "level": 2 }, { "id": "composition-law", "anchor": "composition-law", "title": "Composition law", "level": 2 }, { "id": "choosing-a-deployment-cut", "anchor": "choosing-a-deployment-cut", "title": "Choosing a deployment cut", "level": 2 }, { "id": "nested-feature", "anchor": "nested-feature", "title": "A feature graph inside an app", "level": 2 }, { "id": "nested-partition", "anchor": "nested-partition", "title": "A legal boundary across systems", "level": 2 }, { "id": "nested-instances", "anchor": "nested-instances", "title": "Shared definition, separate activations", "level": 2 }, { "id": "nested-code-push", "anchor": "nested-code-push", "title": "A replaceable RGL feature region", "level": 2 }, { "id": "nested-language-boundary", "anchor": "nested-language-boundary", "title": "A graph across Kotlin JS and C++", "level": 2 } ], "links": [ { "id": "reaktor-graph-views-theory", "anchor": "", "relation": "references", "sourceAnchor": "choosing-a-deployment-cut" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "nested-feature" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "nested-partition" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "nested-instances" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "nested-code-push" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "nested-language-boundary" } ] }, { "id": "reaktor-notifications-design", "owner": "Codex", "kind": "module", "summary": "Cloudflare-native notification runtime with D1 operational state, Workers/Durable Objects/Queues, FCM delivery from Cloudflare, reaktorServer-issued access tokens, client adapters, graph routing, telemetry, and workbench operations.", "use": "Use before changing notification endpoint registration, D1 schemas, Workers/DO/Queue delivery flows, FCM token brokering, client notification adapters, graph routes, notification telemetry, or Reaktor Desktop notification operations.", "region": "framework-backend", "order": 2, "title": "Reaktor Notifications", "nav": "Notifications", "group": "framework", "subsection": "framework-backend", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-notifications-design", "revision": "7057ec5972cb8c06a461b05b48bd3ac5c3f92a78885ede30f215b0a37a1ae727", "status": "unverified", "renderingRevision": "58fc8bec8b17bd36c425750a773b677e3f42b18afde9d585721911b67d93edb2", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developer.android.com/develop/ui/views/notifications", "https://developer.android.com/develop/ui/compose/notifications/create-notification", "https://developer.android.com/develop/ui/compose/notifications/notification-permission", "https://developer.android.com/develop/ui/views/notifications/channels", "https://developer.android.com/develop/ui/views/notifications/conversations", "https://firebase.google.com/docs/cloud-messaging/customize-messages/set-message-type", "https://firebase.google.com/docs/cloud-messaging/android/receive-messages", "https://developer.apple.com/notifications/", "https://developer.apple.com/design/human-interface-guidelines/notifications", "https://developer.apple.com/documentation/UserNotifications/UNUserNotificationCenter/requestAuthorization%28options%3AcompletionHandler%3A%29", "https://developer.apple.com/documentation/usernotifications/declaring-your-actionable-notification-types", "https://developer.apple.com/documentation/usernotifications/modifying-content-in-newly-delivered-notifications", "https://developer.apple.com/documentation/usernotifications/setting-up-a-remote-notification-server", "https://docs.maestro.dev/", "https://docs.maestro.dev/reference/commands-available/assertvisible", "https://docs.maestro.dev/reference/commands-available/tapon", "https://firebase.google.com/docs/cloud-messaging/send/v1-api", "https://firebase.google.com/docs/cloud-messaging/error-codes", "https://developers.cloudflare.com/d1/", "https://developers.cloudflare.com/durable-objects/", "https://developers.cloudflare.com/queues/", "https://developers.cloudflare.com/queues/configuration/dead-letter-queues/", "https://developers.cloudflare.com/workers/runtime-apis/bindings/service-bindings/", "https://developers.cloudflare.com/workers/configuration/secrets/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-notifications-design", "polarity": "Neutral" }, { "id": "section-call", "anchor": "call", "label": "1. Architecture call", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#call", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "2. Current state", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#current", "polarity": "Neutral" }, { "id": "section-domain-overview", "anchor": "domain-overview", "label": "3. Notification domain overview", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#domain-overview", "polarity": "Neutral" }, { "id": "section-non-negotiables", "anchor": "non-negotiables", "label": "4. Non-negotiables", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#non-negotiables", "polarity": "Neutral" }, { "id": "section-decomposition", "anchor": "decomposition", "label": "5. System decomposition", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#decomposition", "polarity": "Neutral" }, { "id": "section-data", "anchor": "data", "label": "6. Data authority and D1 schema", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#data", "polarity": "Neutral" }, { "id": "section-references", "anchor": "references", "label": "24. References", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#references", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-notifications-design#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-notifications-design:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-reaktor-server", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-server", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-reaktor-work", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-deep-link-integration", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-reaktor-capability", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-reaktor-service", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-auth-analysis", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-notifications-design:references-performance-observability", "kind": "references", "owner": "reaktor-notifications-design", "incidences": [ { "node": "reaktor-notifications-design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-notifications-design.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Notifications", "level": 0 }, { "id": "call", "anchor": "call", "title": "1. Architecture call", "level": 2 }, { "id": "current", "anchor": "current", "title": "2. Current state", "level": 2 }, { "id": "domain-overview", "anchor": "domain-overview", "title": "3. Notification domain overview", "level": 2 }, { "id": "mental-model", "anchor": "mental-model", "title": "Mental model", "level": 3 }, { "id": "how-android-notifications-work", "anchor": "how-android-notifications-work", "title": "How Android notifications work", "level": 3 }, { "id": "how-ios-notifications-work", "anchor": "how-ios-notifications-work", "title": "How iOS notifications work", "level": 3 }, { "id": "how-notification-services-are-designed", "anchor": "how-notification-services-are-designed", "title": "How notification services are designed", "level": 3 }, { "id": "user-requirements", "anchor": "user-requirements", "title": "User requirements", "level": 3 }, { "id": "product-manager-requirements", "anchor": "product-manager-requirements", "title": "Product manager requirements", "level": 3 }, { "id": "design-implications-for-reaktor", "anchor": "design-implications-for-reaktor", "title": "Design implications for Reaktor", "level": 3 }, { "id": "non-negotiables", "anchor": "non-negotiables", "title": "4. Non-negotiables", "level": 2 }, { "id": "cloudflare-owns-notification-state", "anchor": "cloudflare-owns-notification-state", "title": "Cloudflare owns notification state", "level": 3 }, { "id": "workers-send-to-fcm", "anchor": "workers-send-to-fcm", "title": "Workers send to FCM", "level": 3 }, { "id": "reaktorserver-is-a-token-broker-only", "anchor": "reaktorserver-is-a-token-broker-only", "title": "reaktorServer is a token broker only", "level": 3 }, { "id": "no-long-lived-google-key-in-workers", "anchor": "no-long-lived-google-key-in-workers", "title": "No long-lived Google key in Workers", "level": 3 }, { "id": "typed-routes-not-strings", "anchor": "typed-routes-not-strings", "title": "Typed routes, not strings", "level": 3 }, { "id": "platform-depth-is-explicit", "anchor": "platform-depth-is-explicit", "title": "Platform depth is explicit", "level": 3 }, { "id": "reaktor-desktop-can-operate-it", "anchor": "reaktor-desktop-can-operate-it", "title": "Reaktor Desktop can operate it", "level": 3 }, { "id": "decomposition", "anchor": "decomposition", "title": "5. System decomposition", "level": 2 }, { "id": "end-to-end-flow", "anchor": "end-to-end-flow", "title": "End-to-end flow", "level": 3 }, { "id": "data", "anchor": "data", "title": "6. Data authority and D1 schema", "level": 2 }, { "id": "initial-cloud-tables", "anchor": "initial-cloud-tables", "title": "Initial cloud tables", "level": 3 }, { "id": "initial-d1-schema-sketch", "anchor": "initial-d1-schema-sketch", "title": "Initial D1 schema sketch", "level": 3 }, { "id": "durable-objects", "anchor": "durable-objects", "title": "7. Durable Objects", "level": 2 }, { "id": "queues", "anchor": "queues", "title": "8. Queues and retry model", "level": 2 }, { "id": "token-broker", "anchor": "token-broker", "title": "9. FCM access-token broker", "level": 2 }, { "id": "broker-responsibilities", "anchor": "broker-responsibilities", "title": "Broker responsibilities", "level": 3 }, { "id": "internal-api-contract", "anchor": "internal-api-contract", "title": "Internal API contract", "level": 3 }, { "id": "providers", "anchor": "providers", "title": "10. Provider strategy", "level": 2 }, { "id": "first-provider-fcm-only", "anchor": "first-provider-fcm-only", "title": "First provider: FCM only", "level": 3 }, { "id": "later-providers", "anchor": "later-providers", "title": "Later providers", "level": 3 }, { "id": "fcm-message-policy", "anchor": "fcm-message-policy", "title": "FCM message policy", "level": 3 }, { "id": "contracts", "anchor": "contracts", "title": "11. Common model and contracts", "level": 2 }, { "id": "client-contract", "anchor": "client-contract", "title": "Client contract", "level": 3 }, { "id": "platform-capability-model", "anchor": "platform-capability-model", "title": "Platform capability model", "level": 3 }, { "id": "cloud-service-contract", "anchor": "cloud-service-contract", "title": "Cloud service contract", "level": 3 }, { "id": "android", "anchor": "android", "title": "12. Android integration", "level": 2 }, { "id": "implemented-mobile-sdk-slice", "anchor": "implemented-mobile-sdk-slice", "title": "Implemented mobile SDK slice", "level": 3 }, { "id": "ios", "anchor": "ios", "title": "13. iOS integration", "level": 2 }, { "id": "implemented-mobile-sdk-slice-1", "anchor": "implemented-mobile-sdk-slice-1", "title": "Implemented mobile SDK slice", "level": 3 }, { "id": "policy", "anchor": "policy", "title": "14. Policy engine", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "15. Graph integration", "level": 2 }, { "id": "facets", "anchor": "facets", "title": "Facets", "level": 3 }, { "id": "visitors-and-passes", "anchor": "visitors-and-passes", "title": "Visitors and passes", "level": 3 }, { "id": "dispatcher", "anchor": "dispatcher", "title": "Dispatcher", "level": 3 }, { "id": "workbench", "anchor": "workbench", "title": "16. Reaktor Desktop and MCP operations", "level": 2 }, { "id": "graph-nodes", "anchor": "graph-nodes", "title": "Graph nodes", "level": 3 }, { "id": "commands", "anchor": "commands", "title": "Commands", "level": 3 }, { "id": "mcp-tools", "anchor": "mcp-tools", "title": "MCP tools", "level": 3 }, { "id": "telemetry", "anchor": "telemetry", "title": "17. Telemetry and analytics", "level": 2 }, { "id": "spans", "anchor": "spans", "title": "Spans", "level": 3 }, { "id": "metrics", "anchor": "metrics", "title": "Metrics", "level": 3 }, { "id": "product-analytics", "anchor": "product-analytics", "title": "Product analytics", "level": 3 }, { "id": "security", "anchor": "security", "title": "18. Security and privacy", "level": 2 }, { "id": "work", "anchor": "work", "title": "19. Relationship to reaktor-work", "level": 2 }, { "id": "layout", "anchor": "layout", "title": "20. Module layout", "level": 2 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "21. BestBuds first slice", "level": 2 }, { "id": "notification-types", "anchor": "notification-types", "title": "Notification types", "level": 3 }, { "id": "migration-steps", "anchor": "migration-steps", "title": "Migration steps", "level": 3 }, { "id": "native-package-verification-before-real-send", "anchor": "native-package-verification-before-real-send", "title": "Native package verification before real send", "level": 3 }, { "id": "send-path-for-first-real-cloud-test", "anchor": "send-path-for-first-real-cloud-test", "title": "Send path for first real cloud test", "level": 3 }, { "id": "plan", "anchor": "plan", "title": "22. Implementation plan", "level": 2 }, { "id": "phase-0---design-alignment-complete", "anchor": "phase-0---design-alignment-complete", "title": "Phase 0 - design alignment (complete)", "level": 3 }, { "id": "phase-1---native-notification-packages-and-bestbuds-dev-verification-complete", "anchor": "phase-1---native-notification-packages-and-bestbuds-dev-verification-complete", "title": "Phase 1 - native notification packages and BestBuds dev verification (complete)", "level": 3 }, { "id": "phase-2---cloud-contracts-d1-storage-and-service-token-broker-auth-mostly-complete", "anchor": "phase-2---cloud-contracts-d1-storage-and-service-token-broker-auth-mostly-complete", "title": "Phase 2 - cloud contracts, D1 storage, and service-token broker auth (mostly complete)", "level": 3 }, { "id": "phase-3---endpoint-registration-complete", "anchor": "phase-3---endpoint-registration-complete", "title": "Phase 3 - endpoint registration (complete)", "level": 3 }, { "id": "phase-4---fcm-delivery-from-cloudflare-partial", "anchor": "phase-4---fcm-delivery-from-cloudflare-partial", "title": "Phase 4 - FCM delivery from Cloudflare (partial)", "level": 3 }, { "id": "phase-5---graph-routing-operations-and-telemetry", "anchor": "phase-5---graph-routing-operations-and-telemetry", "title": "Phase 5 - graph routing, operations, and telemetry", "level": 3 }, { "id": "phase-6---platform-depth-and-os-expansion", "anchor": "phase-6---platform-depth-and-os-expansion", "title": "Phase 6 - platform depth and OS expansion", "level": 3 }, { "id": "phase-7---broader-providers-and-engagement", "anchor": "phase-7---broader-providers-and-engagement", "title": "Phase 7 - broader providers and engagement", "level": 3 }, { "id": "risks", "anchor": "risks", "title": "23. Risks and open questions", "level": 2 }, { "id": "references", "anchor": "references", "title": "24. References", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-server", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-port-theory", "kind": "design", "owner": "Reaktor", "region": "theory-foundations", "use": "Read the semantic theory, diagrams and concrete source mappings; distinguish declared profiles from qualified runtime behavior.", "order": 2, "summary": "Ports: task designs, protocol modes, ownership dimensions and contract profiles.", "diagrams": [ { "id": "type-p01", "src": "/docs/img/theory/type-p01.svg", "alt": "P01 · Value / immutable snapshot — Calculate a checkout total", "text": "Which immutable inputs determine the price?\nCart, prices and tax policy supply versioned snapshots to a pure quote calculation. The result feeds preview and submission; server revalidation precedes any purchase. Value flow carries data without scheduling effects.\nall domains\ndata\ncomputation\nSchema, nullability, units and representation matter; value flow alone imposes no effect order.\nAn immutable quote can become stale; value transport neither reserves stock nor authorizes payment.\ncart: Cart snapshot (N21)\ncart.input: P01; QuoteInputSnapshotV1; Offer\nprice: Price snapshot (N22)\nprice.input: P01; QuoteInputSnapshotV1; Offer\ntax: Tax policy (N31)\ntax.input: P01; QuoteInputSnapshotV1; Offer\nquote: Quote calculation (N01)\nquote.input: P01; QuoteInputSnapshotV1; Require\nquote.preview: P01; RevisionBoundQuoteV1; Offer\nquote.submitted: P01; RevisionBoundQuoteV1; Offer\nui: Checkout preview (N11)\nui.quote: P01; RevisionBoundQuoteV1; Require\nui.submit: P02; SubmitQuoteReceiptV1; Require\nservice: Checkout service (N19)\nservice.quote: P01; RevisionBoundQuoteV1; Require\nservice.submit: P02; SubmitQuoteReceiptV1; Offer\ninputs (H09): source[0]=cart.input; source[1]=price.input; source[2]=tax.input; result[0]=quote.input\npreview (H02): source[0]=quote.preview; target[0]=ui.quote\nquote (H02): source[0]=quote.submitted; target[0]=service.quote\nsubmit (H05): caller[0]=ui.submit; callee[0]=service.submit" }, { "id": "type-p02", "src": "/docs/img/theory/type-p02.svg", "alt": "P02 · Request / response — Send a message across client and server", "text": "Where are reply, timeout and rejection handled?\nMessagingService binds a typed request/response through an HTTP adapter to a server handler. Server authorization precedes persistence. The caller distinguishes committed, rejected and unknown outcomes; timeout cannot prove no write occurred.\nRPC\nweb\ndistributed systems\nDirection is a role; sync/async, error and timeout outcomes are part of compatibility.\nLOCAL and HTTP share a service contract but differ in serialization, failures and cancellation.\nui: Chat send Surface (N11)\nui.send: P02; SendMessageRequestResponseV1; Require\nui.state: P08; SendCommittedRejectedUnknownV1; Require\nclient: MessagingService client (N19)\nclient.send: P02; SendMessageRequestResponseV1; Offer\nclient.http: P02; SendMessageRequestResponseV1; Require\nclient.state: P08; SendCommittedRejectedUnknownV1; Offer\nhttp: HTTP adapter (N15)\nhttp.request: P02; SendMessageRequestResponseV1; Offer\nhttp.handler: P02; SendMessageRequestResponseV1; Require\nserver: Messaging handler (N19)\nserver.send: P02; SendMessageRequestResponseV1; Offer\nserver.grant: P20; ConversationSendGrantV1; Require\nserver.persist: P02; AppendMessageReceiptV1; Require\nauth: Conversation policy (N33)\nauth.grant: P20; ConversationSendGrantV1; Offer\nstore: Message authority (N21)\nstore.append: P02; AppendMessageReceiptV1; Offer\nsend (H05): caller[0]=ui.send; callee[0]=client.send\ntransport (H05): caller[0]=client.http; callee[0]=http.request\nhandler (H01): provider[0]=server.send; consumer[0]=http.handler\ngrant (H23): principal[0]=auth.grant; resource[0]=server.grant\npersist (H05): caller[0]=server.persist; callee[0]=store.append\nstate (H02): source[0]=client.state; target[0]=ui.state" }, { "id": "type-p03", "src": "/docs/img/theory/type-p03.svg", "alt": "P03 · Durable command / receipt — Submit a background export", "text": "When is an export accepted, committed and finished?\nThe job authority records a command ID durably and returns a stage receipt. A worker produces an artifact and updates job state. Status reads distinguish admission from completion; retrying submission resolves the same command.\nworkflows\nmessaging\ncommerce\nReceipt names the qualified completion stage, not simply receipt of bytes.\nDurable command is a reliability profile over calls/events and receipts, not a magic delivery primitive.\nui: Export Surface (N11)\nui.submit: P03; ExportCommandStageReceiptV1; Require\nui.status: P02; ExportStatusReadV1; Require\njobs: Export job authority (N21)\njobs.submit: P03; ExportCommandStageReceiptV1; Offer\njobs.ready: P04; ExportJobReadyV1; Offer\njobs.complete: P09; CompleteExportAtVersionV1; Offer\njobs.status: P02; ExportStatusReadV1; Offer\nqueue: Export dispatch queue (N24)\nqueue.ready: P04; ExportJobReadyV1; Require\nqueue.work: P04; ExportJobReadyV1; Offer\nworker: Export worker (N06)\nworker.start: P04; ExportJobReadyV1; Require\nworker.write: P02; PutExportDigestReceiptV1; Require\nworker.complete: P09; CompleteExportAtVersionV1; Require\nobjects: Export object store (N26)\nobjects.put: P02; PutExportDigestReceiptV1; Offer\nsubmit (H05): caller[0]=ui.submit; callee[0]=jobs.submit\ndispatch (H04): publisher[0]=jobs.ready; subscriber[0]=queue.ready\nwork (H04): publisher[0]=queue.work; subscriber[0]=worker.start\nwrite (H05): caller[0]=worker.write; callee[0]=objects.put\ncomplete (H05): caller[0]=worker.complete; callee[0]=jobs.complete\nstatus (H05): caller[0]=ui.status; callee[0]=jobs.status" }, { "id": "type-p04", "src": "/docs/img/theory/type-p04.svg", "alt": "P04 · Push event — Notify views of a profile change", "text": "How do independent observers learn about a commit?\nA revisioned event updates a local header and a server activity projection independently. A missed revision can trigger an authoritative reread. Neither consumer borrows the other consumer's delivery receipt.\nPubSub\nIoT\ntelemetry\nDeclare ordering, overflow, replay and delivery guarantee; not implicitly durable.\nEvery-occurrence delivery, overflow, replay and durability are independent contract choices.\nedit: Profile save (N02)\nedit.save: P09; SaveProfileAtRevisionV1; Require\nprofile: Profile authority (N21)\nprofile.save: P09; SaveProfileAtRevisionV1; Offer\nprofile.changed: P04; ProfileChangedAtRevisionV1; Offer\nprofile.read: P02; GetProfileAtLeastRevisionV1; Offer\nheader: Header state (N05)\nheader.changed: P04; ProfileChangedAtRevisionV1; Require\nheader.refresh: P02; GetProfileAtLeastRevisionV1; Require\nheader.state: P08; ProfileHeaderStateV1; Offer\nactivity: Activity projection (N22)\nactivity.changed: P04; ProfileChangedAtRevisionV1; Require\nui: Header Surface (N11)\nui.state: P08; ProfileHeaderStateV1; Require\nsave (H05): caller[0]=edit.save; callee[0]=profile.save\nchanged (H07): publisher[0]=profile.changed; subscriber[0]=header.changed; subscriber[1]=activity.changed\nrefresh (H05): caller[0]=header.refresh; callee[0]=profile.read\nrender (H02): source[0]=header.state; target[0]=ui.state" }, { "id": "type-p05", "src": "/docs/img/theory/type-p05.svg", "alt": "P05 · Pull iterator / cursor — Page through a large audit log", "text": "Who decides when the next batch is read?\nThe reader pulls the next cursor page after rendering or exporting the previous batch. The log supplies a stable cut and expiration; cancellation closes the cursor lease. Demand remains at the consumer.\ndata\nsearch\nanalytics\nCursor lifetime, backpressure, consistency cut and resume behavior are explicit.\nA cursor needs snapshot and expiration laws; it is not an infinitely reusable array index.\nreader: Audit cursor reader (N04)\nreader.next: P05; AuditPageCursorAtCutV1; Require\nreader.page: P01; AuditPageV1; Offer\nreader.export: P01; AuditPageV1; Offer\nreader.more: P04; ReadNextAuditPageV1; Require\nlog: Audit log authority (N21)\nlog.next: P05; AuditPageCursorAtCutV1; Offer\nlog.cursor: P21; AuditCursorLeaseV1; Require\nui: Audit table (N11)\nui.page: P01; AuditPageV1; Require\nui.more: P04; ReadNextAuditPageV1; Offer\nexport: Audit exporter (N02)\nexport.batch: P01; AuditPageV1; Require\nlease: Cursor lease owner (N27)\nlease.cursor: P21; AuditCursorLeaseV1; Offer\nnext (H05): caller[0]=reader.next; callee[0]=log.next\npage (H02): source[0]=reader.page; target[0]=ui.page\nexport (H02): source[0]=reader.export; target[0]=export.batch\nmore (H04): publisher[0]=ui.more; subscriber[0]=reader.more\nlease (H19): owner[0]=lease.cursor; resource[0]=log.cursor" }, { "id": "type-p06", "src": "/docs/img/theory/type-p06.svg", "alt": "P06 · Credit-controlled stream — Download without exhausting memory", "text": "How much data may the producer send ahead?\nA verifier forwards checked chunks to a bounded writer. Finished writes return capacity through a credit controller to the source. Cancellation stops new work and records the partial file explicitly.\nmedia\ntelemetry\nFFI\nDemand, buffer bounds, terminal events and cancellation must agree across the boundary.\nCredits, byte budgets and overflow must agree; a stream label does not enforce backpressure.\nsource: Attachment chunk source (N26)\nsource.chunks: P06; CreditBoundAttachmentChunksV1; Offer\nsource.credits: P06; AttachmentStreamCreditsV1; Require\nverify: Chunk verifier (N01)\nverify.chunks: P06; CreditBoundAttachmentChunksV1; Require\nverify.verified: P06; VerifiedAttachmentChunksV1; Offer\nwriter: Bounded file writer (N02)\nwriter.chunks: P06; VerifiedAttachmentChunksV1; Require\nwriter.capacity: P06; AttachmentStreamCreditsV1; Offer\ncontrol: Download credit controller (N05)\ncontrol.capacity: P06; AttachmentStreamCreditsV1; Require\ncontrol.credits: P06; AttachmentStreamCreditsV1; Offer\ncontrol.progress: P08; DownloadProgressV1; Offer\ncontrol.cancel: P14; CancelDownloadV1; Require\nui: Progress Surface (N11)\nui.progress: P08; DownloadProgressV1; Require\nui.cancel: P14; CancelDownloadV1; Offer\nchunks (H02): source[0]=source.chunks; target[0]=verify.chunks\nverified (H02): source[0]=verify.verified; target[0]=writer.chunks\ncapacity (H02): source[0]=writer.capacity; target[0]=control.capacity\ngrant (H02): source[0]=control.credits; target[0]=source.credits\nprogress (H02): source[0]=control.progress; target[0]=ui.progress\ncancel (H03): source[0]=ui.cancel; target[0]=control.cancel" }, { "id": "type-p07", "src": "/docs/img/theory/type-p07.svg", "alt": "P07 · Duplex session — Collaborate on a live document", "text": "How do edits, acknowledgements and reconnects share a session?\nA duplex session carries edits and receipts with sequence and resume rules. The document authority linearizes edits, while presence is ephemeral. Reconnect resolves the last accepted cut before replaying pending operation IDs.\ngames\nmessaging\ncollaboration\nBoth endpoints follow the protocol; pin session version and handoff semantics.\nDuplex transport does not choose conflict resolution, consistency or user authority.\neditor: Document editor (N11)\neditor.session: P07; DocumentEditAckResumeSessionV1; Neutral\neditor.pending: P09; PendingEditLogV1; Require\nsession: Duplex edit session (N15)\nsession.client: P07; DocumentEditAckResumeSessionV1; Neutral\nsession.presence: P04; EphemeralPresenceV1; Offer\nsession.resume: P02; DocumentResumeCutV1; Require\ndocument: Document authority (N05)\ndocument.session: P07; DocumentEditAckResumeSessionV1; Neutral\ndocument.resume: P02; DocumentResumeCutV1; Offer\npresence: Presence state (N25)\npresence.update: P04; EphemeralPresenceV1; Require\npending: Pending edit log (N21)\npending.write: P09; PendingEditLogV1; Offer\nsession (H06): participant[0]=editor.session; participant[1]=session.client; participant[2]=document.session\npending (H05): caller[0]=editor.pending; callee[0]=pending.write\npresence (H04): publisher[0]=session.presence; subscriber[0]=presence.update\nresume (H05): caller[0]=session.resume; callee[0]=document.resume" }, { "id": "type-p08", "src": "/docs/img/theory/type-p08.svg", "alt": "P08 · Signal / reactive state — Keep a cart badge current", "text": "Why is state different from event history?\nHeader and checkout render the current cart state; analytics receives the separate event sequence. A late state subscriber receives the latest snapshot without replaying every historical mutation.\nCompose\nmobile\nweb\nDistinguish latest-value conflation from delivery of every historical change.\nState conflation may discard intermediate values; every-occurrence consumers need an event/log profile.\ncart: Cart state authority (N05)\ncart.state: P08; CartCountTotalStateV1; Offer\ncart.events: P04; CartChangedEventV1; Offer\ncart.edit: P09; CartMutationAtRevisionV1; Offer\nheader: Cart badge (N11)\nheader.state: P08; CartCountTotalStateV1; Require\ncheckout: Checkout Surface (N11)\ncheckout.state: P08; CartCountTotalStateV1; Require\ncheckout.edit: P09; CartMutationAtRevisionV1; Require\nanalytics: Cart event recorder (N02)\nanalytics.events: P04; CartChangedEventV1; Require\nstate (H07): publisher[0]=cart.state; subscriber[0]=header.state; subscriber[1]=checkout.state\nevents (H04): publisher[0]=cart.events; subscriber[0]=analytics.events\nedit (H05): caller[0]=checkout.edit; callee[0]=cart.edit" }, { "id": "type-p09", "src": "/docs/img/theory/type-p09.svg", "alt": "P09 · Mutation / conditional update — Detect a stale document save", "text": "How is a conflicting edit rejected?\nA save names its base revision. The authority atomically compares before writing; conflict supplies a three-way merge input for review. Only a new accepted candidate becomes a successful save.\ndata\ncommerce\nagents\nThe authority checks predicates and authorization; local write locks are not distributed CAS.\nConditional mutation is a call profile with a linearization law; a version field alone is insufficient.\neditor: Document editor (N11)\neditor.save: P09; SaveDocumentIfRevisionV1; Require\neditor.candidate: P01; MergedDocumentAtBaseV1; Require\nsave: Save operation (N02)\nsave.save: P09; SaveDocumentIfRevisionV1; Offer\nsave.write: P09; SaveDocumentIfRevisionV1; Require\nsave.conflict: P01; DocumentConflictTripleV1; Offer\nauthority: Document authority (N21)\nauthority.write: P09; SaveDocumentIfRevisionV1; Offer\nmerge: Three-way merge (N03)\nmerge.conflict: P01; DocumentConflictTripleV1; Require\nmerge.review: P08; DocumentMergeReviewV1; Offer\nreview: Conflict review (N11)\nreview.state: P08; DocumentMergeReviewV1; Require\nreview.accepted: P01; MergedDocumentAtBaseV1; Offer\nsubmit (H05): caller[0]=editor.save; callee[0]=save.save\ncommit (H05): caller[0]=save.write; callee[0]=authority.write\nconflict (H02): source[0]=save.conflict; target[0]=merge.conflict\nreview (H02): source[0]=merge.review; target[0]=review.state\nretry (H02): source[0]=review.accepted; target[0]=editor.candidate" }, { "id": "type-p10", "src": "/docs/img/theory/type-p10.svg", "alt": "P10 · Transaction participant — Commit a balanced ledger transfer", "text": "Which participants share one authority?\nThe ledger transaction coordinates debit and credit under one database authority and invariant check. A notification follows commit but stays outside its atomic scope.\ndata\ntransactions\nledgers\nOnly qualified participants enlist; a transaction token is not universal ACID.\nTransaction profile names isolation, authority and failure law; external services do not join by diagram membership.\ntransfer: Transfer request (N02)\ntransfer.execute: P02; LedgerTransferReceiptV1; Require\ntx: Ledger transaction authority (N23)\ntx.execute: P02; LedgerTransferReceiptV1; Offer\ntx.scope: P10; BalancedLedgerTransactionV1; Offer\ntx.committed: P04; LedgerTransferCommittedV1; Offer\ndebit: Debit account (N21)\ndebit.tx: P10; BalancedLedgerTransactionV1; Neutral\ncredit: Credit account (N21)\ncredit.tx: P10; BalancedLedgerTransactionV1; Neutral\nnotify: Transfer notification (N19)\nnotify.notify: P04; LedgerTransferCommittedV1; Require\nrequest (H05): caller[0]=transfer.execute; callee[0]=tx.execute\nscope (H16): authority[0]=tx.scope; participant[0]=debit.tx; participant[1]=credit.tx\nnotify (H04): publisher[0]=tx.committed; subscriber[0]=notify.notify" }, { "id": "type-p11", "src": "/docs/img/theory/type-p11.svg", "alt": "P11 · Execution / continuation — Back up before migrating", "text": "What establishes operation precedence?\nA verified backup receipt enables the migration continuation. Migration readiness then enables the route switch. Artifact data and control completion remain separate contracts.\nnavigation\nworkflows\ncomposition\nDefines effect order within one execution profile; not a generic network message.\nControl precedence does not itself authorize either operation.\nbackup: Backup operation (N02)\nbackup.artifact: P23; BackupArtifactRefV1; Offer\nbackup.receipt: P24; MigrationBackupEvidenceV1; Offer\nverify: Backup verification (N01)\nverify.artifact: P23; BackupArtifactRefV1; Require\nverify.complete: P11; VerifiedBackupContinuationV1; Offer\nmigrate: Schema migration (N40)\nmigrate.start: P11; VerifiedBackupContinuationV1; Require\nmigrate.complete: P11; MigrationReadyContinuationV1; Offer\nmigrate.evidence: P24; MigrationBackupEvidenceV1; Require\nswitch: Traffic switch (N02)\nswitch.start: P11; MigrationReadyContinuationV1; Require\nbytes (H02): source[0]=backup.artifact; target[0]=verify.artifact\nverified (H03): source[0]=verify.complete; target[0]=migrate.start\nready (H03): source[0]=migrate.complete; target[0]=switch.start\nprovenance (H27): source[0]=backup.receipt; target[0]=migrate.evidence" }, { "id": "type-p12", "src": "/docs/img/theory/type-p12.svg", "alt": "P12 · Branch / guarded transition — Require step-up authentication", "text": "Which branch may release a sensitive command?\nPolicy chooses allow, step-up or deny from principal and action context. Successful step-up returns evidence for policy reevaluation. Only the allowed branch reaches execution.\nnavigation\nauth\nworkflows\nExhaustiveness and guard purity are checked; branch choice is separate from data encoding.\nPredicates and precedence must be explicit; authentication evidence is not an authorization grant.\nrequest: Sensitive action (N19)\nrequest.context: P01; SensitiveActionContextV1; Offer\nrisk: Risk decision (N03)\nrisk.context: P01; SensitiveActionContextV1; Require\nrisk.allow: P12; AllowedActionV1; Offer\nrisk.stepUp: P12; StepUpRequiredV1; Offer\nrisk.deny: P12; DeniedActionV1; Offer\nrisk.stepUpEvidence: P01; StepUpEvidenceV1; Require\nstepup: Step-up authenticator (N15)\nstepup.challenge: P12; StepUpRequiredV1; Require\nstepup.evidence: P01; StepUpEvidenceV1; Offer\ndeny: Denied-action response (N11)\ndeny.reason: P12; DeniedActionV1; Require\nexecute: Action executor (N02)\nexecute.command: P12; AllowedActionV1; Require\ncontext (H02): source[0]=request.context; target[0]=risk.context\nallow (H03): source[0]=risk.allow; target[0]=execute.command\nchallenge (H03): source[0]=risk.stepUp; target[0]=stepup.challenge\ndeny (H03): source[0]=risk.deny; target[0]=deny.reason\nevidence (H02): source[0]=stepup.evidence; target[0]=risk.stepUpEvidence" }, { "id": "type-p13", "src": "/docs/img/theory/type-p13.svg", "alt": "P13 · Completion / join token — Finalize a chunked upload", "text": "What does a completion token certify?\nThe finalizer joins receipts for the expected chunk identities, sizes and digests. It then commits a complete manifest. Progress may be partial while the finalization claim requires the entire accepted set.\nparallel work\nmedia\nworkflows\nJoin rule defines required contributors and treatment of failure/cancellation.\nCompletion certifies a named stage; three arbitrary tokens do not prove all expected chunks exist.\na: Chunk A write (N02)\na.done: P13; CommittedChunkReceiptV1; Offer\nb: Chunk B write (N02)\nb.done: P13; CommittedChunkReceiptV1; Offer\nc: Chunk C write (N02)\nc.done: P13; CommittedChunkReceiptV1; Offer\nfinalize: Upload finalizer (N01)\nfinalize.receipts: P13; CommittedChunkReceiptV1; Require\nfinalize.commit: P09; FinalizeUploadManifestV1; Require\nfinalize.evidence: P24; UploadCompletionEvidenceV1; Offer\nmanifest: Upload manifest (N21)\nmanifest.commit: P09; FinalizeUploadManifestV1; Offer\nmanifest.evidence: P24; UploadCompletionEvidenceV1; Require\njoin (H09): source[0]=a.done; source[1]=b.done; source[2]=c.done; result[0]=finalize.receipts\ncommit (H05): caller[0]=finalize.commit; callee[0]=manifest.commit\nproof (H27): source[0]=finalize.evidence; target[0]=manifest.evidence" }, { "id": "type-p14", "src": "/docs/img/theory/type-p14.svg", "alt": "P14 · Cancellation / deadline — Cancel obsolete search work", "text": "What does leaving a screen stop?\nRoute lifetime and deadline cancel local search work and suppress stale rendering. A remote request may already be accepted; its identity and any effect receipt remain inspectable.\nRPC\nmedia\nworkflows\nCancellation is cooperative unless stated otherwise; reconcile already-committed effects.\nCancellation is cooperative and target-dependent; it is not distributed rollback.\nroute: Search route lifetime (N12)\nroute.leave: P14; SearchCancellationV1; Offer\nroute.scope: P21; SearchOperationScopeV1; Offer\nsearch: Search controller (N05)\nsearch.cancel: P14; SearchCancellationV1; Require\nsearch.deadline: P14; SearchDeadlineV1; Require\nsearch.fetch: P02; SearchAtGenerationV1; Require\nsearch.state: P08; CurrentSearchStateV1; Offer\nsearch.scope: P21; SearchOperationScopeV1; Require\ndeadline: Search deadline (N09)\ndeadline.expired: P14; SearchDeadlineV1; Offer\napi: Search service (N19)\napi.search: P02; SearchAtGenerationV1; Offer\nui: Search Surface (N11)\nui.state: P08; CurrentSearchStateV1; Require\ncancel (H03): source[0]=route.leave; target[0]=search.cancel\ndeadline (H03): source[0]=deadline.expired; target[0]=search.deadline\nfetch (H05): caller[0]=search.fetch; callee[0]=api.search\nrender (H02): source[0]=search.state; target[0]=ui.state\nscope (H19): owner[0]=route.scope; resource[0]=search.scope" }, { "id": "type-p15", "src": "/docs/img/theory/type-p15.svg", "alt": "P15 · Clock / tick / timer — Retry delivery with bounded backoff", "text": "What prevents an endless retry loop?\nRetry state records next-at time and attempt budget for one command ID. A clock candidate triggers revalidation before sending. Exhaustion produces a failure record instead of unlimited retries.\ngames\nIoT\nShadow\nSpecify event-time versus processing-time semantics; clocks are dependencies for replay.\nTimer delivery does not prove the command is still pending or the authority deadline is due.\nschedule: Delivery retry state (N05)\nschedule.next: P01; RetryDeadlineBudgetV1; Offer\nschedule.tick: P15; RetryDeadlineCandidateV1; Require\nschedule.send: P02; IdempotentDeliveryAttemptV1; Require\nschedule.failed: P24; RetryExhaustedV1; Offer\nclock: Retry timer (N09)\nclock.schedule: P01; RetryDeadlineBudgetV1; Require\nclock.tick: P15; RetryDeadlineCandidateV1; Offer\nsend: Delivery adapter (N19)\nsend.send: P02; IdempotentDeliveryAttemptV1; Offer\nfailed: Exhausted retry evidence (N37)\nfailed.record: P24; RetryExhaustedV1; Require\nschedule (H02): source[0]=schedule.next; target[0]=clock.schedule\ntick (H04): publisher[0]=clock.tick; subscriber[0]=schedule.tick\ninvoke (H05): caller[0]=schedule.send; callee[0]=send.send\nfailure (H27): source[0]=schedule.failed; target[0]=failed.record" }, { "id": "type-p16", "src": "/docs/img/theory/type-p16.svg", "alt": "P16 · Owned resource transfer — Transfer a camera frame to a native encoder", "text": "When may the producer reuse memory?\nThe encoder owns a transferred frame until it releases that allocation or transfers ownership onward. The pool makes it available again only after the declared lifetime ends. Ownership composes with call or stream protocols.\nFFI\nmedia\nrobotics\nExactly one accepted owner after transfer; reject duplication and invalid module epoch.\nAllocator, deallocator and alias rules must be concrete; JSON ownership labels do not transfer native allocations.\ncamera: Camera producer (N15)\ncamera.frame: P16; OwnedCameraFrameV1; Offer\ncamera.available: P01; ReusableFrameAllocationV1; Require\nencoder: Native encoder (N16)\nencoder.frame: P16; OwnedCameraFrameV1; Require\nencoder.released: P04; FrameAllocationReleasedV1; Offer\nencoder.output: P16; OwnedEncodedFrameV1; Offer\npool: Frame allocation pool (N26)\npool.release: P04; FrameAllocationReleasedV1; Require\npool.available: P01; ReusableFrameAllocationV1; Offer\nupload: Encoded frame upload (N02)\nupload.bytes: P16; OwnedEncodedFrameV1; Require\nframe (H02): source[0]=camera.frame; target[0]=encoder.frame\nreleased (H04): publisher[0]=encoder.released; subscriber[0]=pool.release\nencoded (H02): source[0]=encoder.output; target[0]=upload.bytes\nreuse (H02): source[0]=pool.available; target[0]=camera.available" }, { "id": "type-p17", "src": "/docs/img/theory/type-p17.svg", "alt": "P17 · Borrowed buffer / view — Decode a borrowed message buffer", "text": "How can a parser avoid retaining invalid memory?\nDecoder and validator borrow bounded views during an explicit lease. Their copied results outlive the buffer, but retained views require an extended lease. Failure paths release the borrow too.\nFFI\ncodecs\nlocal compute\nCannot escape its declared scope; async and cross-address-space use require a qualified lease/copy.\nBorrowed access retains bounds, alignment and lifetime requirements even when no copy occurs.\nowner: Message buffer owner (N26)\nowner.view: P17; BoundedBorrowedMessageViewV1; Offer\nowner.validationView: P17; BoundedBorrowedMessageViewV1; Offer\nowner.release: P13; AllBorrowersReleasedV1; Require\ndecode: FlexBuffer decoder (N01)\ndecode.view: P17; BoundedBorrowedMessageViewV1; Require\ndecode.value: P01; CopiedDecodedMessageV1; Offer\ndecode.scope: P21; MessageBorrowScopeV1; Require\nvalidate: Bounds validator (N01)\nvalidate.view: P17; BoundedBorrowedMessageViewV1; Require\nvalidate.scope: P21; MessageBorrowScopeV1; Require\nresult: Decoded state (N05)\nresult.value: P01; CopiedDecodedMessageV1; Require\nlease: Borrow lease tracker (N05)\nlease.scope: P21; MessageBorrowScopeV1; Offer\nlease.released: P13; AllBorrowersReleasedV1; Offer\nborrow (H02): source[0]=owner.view; target[0]=decode.view\nvalidate (H02): source[0]=owner.validationView; target[0]=validate.view\ndecoded (H02): source[0]=decode.value; target[0]=result.value\nscope (H19): owner[0]=lease.scope; resource[0]=decode.scope; resource[1]=validate.scope\nrelease (H03): source[0]=lease.released; target[0]=owner.release" }, { "id": "type-p18", "src": "/docs/img/theory/type-p18.svg", "alt": "P18 · Shared read lease — Share an immutable model between workers", "text": "When can the mapped model be unloaded?\nWorkers acquire read leases for one immutable model revision. The lifecycle owner waits for them to drain before unmapping. A replacement revision receives a separate identity instead of mutating active readers' bytes.\nmedia\nFFI\nanalytics\nReference counting alone does not make concurrent mutation safe; memory rules stay explicit.\nShared read does not permit mutation and must cover asynchronous/native use.\nmodel: Mapped model resource (N26)\nmodel.lease: P18; ImmutableModelReadLeaseV1; Offer\nmodel.unmap: P13; ModelReadersDrainedV1; Require\nmodel.candidate: P23; CandidateModelDigestV1; Require\na: Inference worker A (N18)\na.model: P18; ImmutableModelReadLeaseV1; Require\na.lease: P21; ModelReaderLeaseScopeV1; Require\nb: Inference worker B (N18)\nb.model: P18; ImmutableModelReadLeaseV1; Require\nb.lease: P21; ModelReaderLeaseScopeV1; Require\nlifecycle: Model lease lifecycle (N05)\nlifecycle.scope: P21; ModelReaderLeaseScopeV1; Offer\nlifecycle.drained: P13; ModelReadersDrainedV1; Offer\ncandidate: Candidate model (N35)\ncandidate.ref: P23; CandidateModelDigestV1; Offer\nreaders (H07): publisher[0]=model.lease; subscriber[0]=a.model; subscriber[1]=b.model\nscope (H19): owner[0]=lifecycle.scope; resource[0]=a.lease; resource[1]=b.lease\nreplace (H03): source[0]=lifecycle.drained; target[0]=model.unmap\ncandidate (H26): artifact[0]=candidate.ref; consumer[0]=model.candidate" }, { "id": "type-p19", "src": "/docs/img/theory/type-p19.svg", "alt": "P19 · Capability descriptor — Resolve a rendering backend", "text": "Does this target meet the feature requirement?\nThe resolver compares native and browser offers with the required formats and interactions. It returns an explicit selected binding or unavailable outcome. Adapter qualification and activation remain separate.\nplatforms\nAI\ncomposition\nMetadata for selection, not an authorization bearer; no implied access to the capability.\nCapability descriptor is a payload role; discovery grants neither authority nor operational health.\nfeature: Canvas requirement (N32)\nfeature.renderer: P19; RendererCapabilityDescriptorV1; Require\nfeature.requirements: P01; CanvasRequirementsV1; Offer\nnative: Native renderer offer (N32)\nnative.renderer: P19; RendererCapabilityDescriptorV1; Offer\nbrowser: Browser renderer offer (N32)\nbrowser.renderer: P19; RendererCapabilityDescriptorV1; Offer\nresolve: Renderer resolver (N03)\nresolve.renderer: P19; RendererCapabilityDescriptorV1; Neutral\nresolve.binding: P01; SelectedRendererBindingV1; Offer\nhost: Feature host (N27)\nhost.binding: P01; SelectedRendererBindingV1; Require\nhost.requirements: P01; CanvasRequirementsV1; Require\nresolve (H24): requirement[0]=feature.renderer; offer[0]=native.renderer; offer[1]=browser.renderer; resolver[0]=resolve.renderer\nselected (H02): source[0]=resolve.binding; target[0]=host.binding\nrequirement (H02): source[0]=feature.requirements; target[0]=host.requirements" }, { "id": "type-p20", "src": "/docs/img/theory/type-p20.svg", "alt": "P20 · Authorization request / grant — Grant access to one documentation cut", "text": "What may this agent read?\nPolicy evaluates principal, workspace, collection and operation. Retrieval enforces the bounded grant before returning sections. Answer generation receives only that cut; unrestricted backlink expansion would bypass authorization.\nRBAC\nagents\ntenancy\nBind principal, scope, expiry and issuer; recheck at use and never serialize raw credentials.\nGrant scope and validity carry authority; a selected subgraph is a projection of that decision.\nagent: Agent read request (N39)\nagent.request: P20; DocumentationGrantRequestV1; Require\npolicy: Documentation policy (N33)\npolicy.request: P20; DocumentationGrantRequestV1; Offer\npolicy.grant: P20; PrincipalWorkspaceReadGrantV1; Offer\npolicy.receipt: P24; ReadDecisionReceiptV1; Offer\nretrieve: Authorized retrieval (N22)\nretrieve.grant: P20; PrincipalWorkspaceReadGrantV1; Require\nretrieve.cut: P01; AuthorizedSectionCutV1; Offer\nmodel: Cited answer model (N18)\nmodel.context: P01; AuthorizedSectionCutV1; Require\nevidence: Access evidence (N37)\nevidence.receipt: P24; ReadDecisionReceiptV1; Require\nrequest (H05): caller[0]=agent.request; callee[0]=policy.request\ngrant (H23): principal[0]=policy.grant; resource[0]=retrieve.grant\ncut (H02): source[0]=retrieve.cut; target[0]=model.context\ndecision (H27): source[0]=policy.receipt; target[0]=evidence.receipt" }, { "id": "type-p21", "src": "/docs/img/theory/type-p21.svg", "alt": "P21 · Lifecycle management — Close a session when its route leaves", "text": "Which resources share the feature lifetime?\nThe route scope owns a realtime subscription, decoder and file handle. Drain stops new work before release. Host death may skip callbacks, so server leases and durable safety cannot rely only on local cleanup.\nactors\nFFI\ncode push\nCalls may fail or be skipped on host death; required persistence cannot rely on cleanup.\nLifecycle is a control profile; it does not prove cleanup occurs after process death.\nroute: Conversation route scope (N12)\nroute.scope: P21; ConversationLifecycleV1; Offer\nroute.leave: P14; ConversationDrainV1; Offer\nsubscription: Realtime subscription (N15)\nsubscription.scope: P21; ConversationLifecycleV1; Require\nsubscription.renew: P02; SubscriptionLeaseRenewalV1; Require\nsubscription.messages: P06; BoundedConversationMessagesV1; Offer\nsubscription.drain: P14; ConversationDrainV1; Require\ndecoder: Message decoder (N01)\ndecoder.scope: P21; ConversationLifecycleV1; Require\ndecoder.messages: P06; BoundedConversationMessagesV1; Require\nfile: Attachment file handle (N16)\nfile.scope: P21; ConversationLifecycleV1; Require\nserver: Lease authority (N21)\nserver.renew: P02; SubscriptionLeaseRenewalV1; Offer\nscope (H19): owner[0]=route.scope; resource[0]=subscription.scope; resource[1]=decoder.scope; resource[2]=file.scope\nlease (H05): caller[0]=subscription.renew; callee[0]=server.renew\nmessages (H02): source[0]=subscription.messages; target[0]=decoder.messages\ndrain (H03): source[0]=route.leave; target[0]=subscription.drain" }, { "id": "type-p22", "src": "/docs/img/theory/type-p22.svg", "alt": "P22 · Checkpoint / migration — Restore state into a candidate actor", "text": "How does new code accept old state?\nA fenced checkpoint identifies its schema and cut. A migration transform validates and converts it before candidate restoration. Route admission names the old/new activation epochs; reverse state compatibility remains a separate question.\ncode push\ndata\nShadow\nMigration is versioned and staged; rollback depends on state compatibility, not old code availability.\nCheckpoint is a state-transfer profile; old code availability does not prove safe rollback.\nold: Old actor activation (N05)\nold.checkpoint: P22; ActorCheckpointAtCutV1; Offer\nold.handoff: P22; ActorEpochHandoffV1; Neutral\ncheckpoint: Checkpoint object (N26)\ncheckpoint.write: P22; ActorCheckpointAtCutV1; Require\ncheckpoint.read: P22; ActorCheckpointAtCutV1; Offer\ntransform: State migration transform (N01)\ntransform.read: P22; ActorCheckpointAtCutV1; Require\ntransform.state: P22; MigratedActorStateV2; Offer\nnext: Candidate actor activation (N05)\nnext.restore: P22; MigratedActorStateV2; Require\nnext.handoff: P22; ActorEpochHandoffV1; Neutral\nroute: Epoch route authority (N21)\nroute.epoch: P22; ActorEpochHandoffV1; Offer\ncapture (H02): source[0]=old.checkpoint; target[0]=checkpoint.write\nread (H05): caller[0]=transform.read; callee[0]=checkpoint.read\nrestore (H02): source[0]=transform.state; target[0]=next.restore\nhandoff (H35): old[0]=old.handoff; new[0]=next.handoff; authority[0]=route.epoch" }, { "id": "type-p23", "src": "/docs/img/theory/type-p23.svg", "alt": "P23 · Artifact / schema reference — Load a trusted plugin by digest", "text": "How does a reference become executable bytes?\nThe plugin reference binds digest, ABI and access policy. Fetch verifies bytes and compatibility evidence before host admission. A filename or URL alone cannot identify or qualify a plugin.\nbuild\nFFI\nreleases\nA reference is not a raw pointer; loading verifies integrity, provenance and access.\nReferences are typed payloads; loading, verification and activation are distinct admitted operations.\nmanifest: Plugin reference (N35)\nmanifest.ref: P23; PluginDigestAbiRefV1; Offer\nmanifest.expected: P23; PluginDigestAbiRefV1; Offer\nfetch: Artifact fetch adapter (N19)\nfetch.ref: P23; PluginDigestAbiRefV1; Require\nfetch.load: P02; FetchArtifactBytesV1; Require\nfetch.bytes: P17; DownloadedArtifactViewV1; Offer\nstore: Plugin object store (N26)\nstore.load: P02; FetchArtifactBytesV1; Offer\nverify: Digest and ABI verifier (N01)\nverify.bytes: P17; DownloadedArtifactViewV1; Require\nverify.expected: P23; PluginDigestAbiRefV1; Require\nverify.evidence: P24; PluginCompatibilityEvidenceV1; Offer\nhost: Plugin host (N27)\nhost.evidence: P24; PluginCompatibilityEvidenceV1; Require\nref (H26): artifact[0]=manifest.ref; consumer[0]=fetch.ref\nload (H05): caller[0]=fetch.load; callee[0]=store.load\nverify (H02): source[0]=fetch.bytes; target[0]=verify.bytes\nexpected (H02): source[0]=manifest.expected; target[0]=verify.expected\nadmit (H02): source[0]=verify.evidence; target[0]=host.evidence" }, { "id": "type-p24", "src": "/docs/img/theory/type-p24.svg", "alt": "P24 · Inspection / evidence — Explain a slow product flow", "text": "Which latency segments were observed?\nA bounded visitor reads client, RPC-boundary and server evidence. Its finding records missing segments and source links. A captured capsule can seed Shadow replay through separate authority.\nvisitors\ntelemetry\ndebugging\nCarries coverage and provenance; observational access does not confer mutation authority.\nInspection is a payload/access profile over a query protocol; observation grants no mutation authority.\nclient: Client spans (N37)\nclient.cut: P24; ProductFlowEvidenceCutV1; Offer\nboundary: RPC observations (N37)\nboundary.cut: P24; ProductFlowEvidenceCutV1; Offer\nserver: Server spans (N37)\nserver.cut: P24; ProductFlowEvidenceCutV1; Offer\nvisitor: Flow evidence visitor (N38)\nvisitor.cut: P24; ProductFlowEvidenceCutV1; Require\nvisitor.finding: P24; LatencyCoverageFindingV1; Offer\nvisitor.capsule: P23; CapturedFlowCapsuleRefV1; Offer\nreport: Latency finding (N11)\nreport.finding: P24; LatencyCoverageFindingV1; Require\nshadow: Shadow scenario (N36)\nshadow.capsule: P23; CapturedFlowCapsuleRefV1; Require\ncut (H27): source[0]=client.cut; source[1]=boundary.cut; source[2]=server.cut; target[0]=visitor.cut\nfinding (H02): source[0]=visitor.finding; target[0]=report.finding\nreplay (H26): artifact[0]=visitor.capsule; consumer[0]=shadow.capsule" } ], "title": "Ports", "nav": "Ports", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-port-theory", "revision": "2599cbb1a312c95aa08ae7e75003dbce84bd8aa06731394ff5e083788252caf7", "status": "design", "renderingRevision": "61b2e538eda7213a111a3ec48facec6ec3ab42065a9cdbbe9ab8a6dfd992f590", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "compatibility-is-more-than-a-type-name", "rpc-across-systems", "compose-state-and-navigation", "cross-language-resources", "source-boundary" ], "externalLinks": [ "https://kotlinlang.org/docs/coroutines-basics.html#structured-concurrency", "https://kotlinlang.org/docs/cancellation-and-timeouts.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-port-theory", "polarity": "Neutral" }, { "id": "type-p01", "anchor": "type-p01", "label": "P01 · Value / immutable snapshot — Calculate a checkout total", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p01", "polarity": "Neutral" }, { "id": "type-p02", "anchor": "type-p02", "label": "P02 · Request / response — Send a message across client and server", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p02", "polarity": "Neutral" }, { "id": "type-p03", "anchor": "type-p03", "label": "P03 · Durable command / receipt — Submit a background export", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p03", "polarity": "Neutral" }, { "id": "type-p04", "anchor": "type-p04", "label": "P04 · Push event — Notify views of a profile change", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p04", "polarity": "Neutral" }, { "id": "type-p05", "anchor": "type-p05", "label": "P05 · Pull iterator / cursor — Page through a large audit log", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p05", "polarity": "Neutral" }, { "id": "type-p06", "anchor": "type-p06", "label": "P06 · Credit-controlled stream — Download without exhausting memory", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p06", "polarity": "Neutral" }, { "id": "type-p07", "anchor": "type-p07", "label": "P07 · Duplex session — Collaborate on a live document", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p07", "polarity": "Neutral" }, { "id": "type-p08", "anchor": "type-p08", "label": "P08 · Signal / reactive state — Keep a cart badge current", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p08", "polarity": "Neutral" }, { "id": "type-p09", "anchor": "type-p09", "label": "P09 · Mutation / conditional update — Detect a stale document save", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p09", "polarity": "Neutral" }, { "id": "type-p10", "anchor": "type-p10", "label": "P10 · Transaction participant — Commit a balanced ledger transfer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p10", "polarity": "Neutral" }, { "id": "type-p11", "anchor": "type-p11", "label": "P11 · Execution / continuation — Back up before migrating", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p11", "polarity": "Neutral" }, { "id": "type-p12", "anchor": "type-p12", "label": "P12 · Branch / guarded transition — Require step-up authentication", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p12", "polarity": "Neutral" }, { "id": "type-p13", "anchor": "type-p13", "label": "P13 · Completion / join token — Finalize a chunked upload", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p13", "polarity": "Neutral" }, { "id": "type-p14", "anchor": "type-p14", "label": "P14 · Cancellation / deadline — Cancel obsolete search work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p14", "polarity": "Neutral" }, { "id": "type-p15", "anchor": "type-p15", "label": "P15 · Clock / tick / timer — Retry delivery with bounded backoff", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p15", "polarity": "Neutral" }, { "id": "type-p16", "anchor": "type-p16", "label": "P16 · Owned resource transfer — Transfer a camera frame to a native encoder", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p16", "polarity": "Neutral" }, { "id": "type-p17", "anchor": "type-p17", "label": "P17 · Borrowed buffer / view — Decode a borrowed message buffer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p17", "polarity": "Neutral" }, { "id": "type-p18", "anchor": "type-p18", "label": "P18 · Shared read lease — Share an immutable model between workers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p18", "polarity": "Neutral" }, { "id": "type-p19", "anchor": "type-p19", "label": "P19 · Capability descriptor — Resolve a rendering backend", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p19", "polarity": "Neutral" }, { "id": "type-p20", "anchor": "type-p20", "label": "P20 · Authorization request / grant — Grant access to one documentation cut", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p20", "polarity": "Neutral" }, { "id": "type-p21", "anchor": "type-p21", "label": "P21 · Lifecycle management — Close a session when its route leaves", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p21", "polarity": "Neutral" }, { "id": "type-p22", "anchor": "type-p22", "label": "P22 · Checkpoint / migration — Restore state into a candidate actor", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p22", "polarity": "Neutral" }, { "id": "type-p23", "anchor": "type-p23", "label": "P23 · Artifact / schema reference — Load a trusted plugin by digest", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p23", "polarity": "Neutral" }, { "id": "type-p24", "anchor": "type-p24", "label": "P24 · Inspection / evidence — Explain a slow product flow", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#type-p24", "polarity": "Neutral" }, { "id": "port-classification", "anchor": "port-classification", "label": "Protocols and independent dimensions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#port-classification", "polarity": "Neutral" }, { "id": "port-contract", "anchor": "port-contract", "label": "A complete port contract", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#port-contract", "polarity": "Neutral" }, { "id": "port-consolidation", "anchor": "port-consolidation", "label": "Consolidation without losing guarantees", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-port-theory#port-consolidation", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-port-theory:type-p01-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p01", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p02-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p02", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p03-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p03", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p04-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p04", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p05-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p05", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p06-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p06", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p07-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p07", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p08-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p08", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p09-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p09", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p10-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p10", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p11-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p11", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p12-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p12", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p13-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p13", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p14-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p14", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p15-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p15", "role": "source", "ordinal": 0 }, { "node": "shadow-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p16-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p16", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p17-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p17", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-performance-review", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p18-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p18", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p19-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p19", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p20-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p20", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p21-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p21", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p22-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p22", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-distribution-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p23-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p23", "role": "source", "ordinal": 0 }, { "node": "reaktor-dependeasy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:type-p24-module", "kind": "references", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "type-p24", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:topic-reaktor-graph-vocabulary-theory", "kind": "explains", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-port-theory:topic-reaktor-hyperedge-theory", "kind": "explains", "owner": "reaktor-port-theory", "incidences": [ { "node": "reaktor-port-theory", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-hyperedge-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-port-theory.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Ports", "level": 0 }, { "id": "port-classification", "anchor": "port-classification", "title": "Protocols and independent dimensions", "level": 2 }, { "id": "port-contract", "anchor": "port-contract", "title": "A complete port contract", "level": 2 }, { "id": "port-consolidation", "anchor": "port-consolidation", "title": "Consolidation without losing guarantees", "level": 2 }, { "id": "type-p01", "anchor": "type-p01", "title": "P01 · Value / immutable snapshot — Calculate a checkout total", "level": 2 }, { "id": "type-p02", "anchor": "type-p02", "title": "P02 · Request / response — Send a message across client and server", "level": 2 }, { "id": "type-p03", "anchor": "type-p03", "title": "P03 · Durable command / receipt — Submit a background export", "level": 2 }, { "id": "type-p04", "anchor": "type-p04", "title": "P04 · Push event — Notify views of a profile change", "level": 2 }, { "id": "type-p05", "anchor": "type-p05", "title": "P05 · Pull iterator / cursor — Page through a large audit log", "level": 2 }, { "id": "type-p06", "anchor": "type-p06", "title": "P06 · Credit-controlled stream — Download without exhausting memory", "level": 2 }, { "id": "type-p07", "anchor": "type-p07", "title": "P07 · Duplex session — Collaborate on a live document", "level": 2 }, { "id": "type-p08", "anchor": "type-p08", "title": "P08 · Signal / reactive state — Keep a cart badge current", "level": 2 }, { "id": "type-p09", "anchor": "type-p09", "title": "P09 · Mutation / conditional update — Detect a stale document save", "level": 2 }, { "id": "type-p10", "anchor": "type-p10", "title": "P10 · Transaction participant — Commit a balanced ledger transfer", "level": 2 }, { "id": "type-p11", "anchor": "type-p11", "title": "P11 · Execution / continuation — Back up before migrating", "level": 2 }, { "id": "type-p12", "anchor": "type-p12", "title": "P12 · Branch / guarded transition — Require step-up authentication", "level": 2 }, { "id": "type-p13", "anchor": "type-p13", "title": "P13 · Completion / join token — Finalize a chunked upload", "level": 2 }, { "id": "type-p14", "anchor": "type-p14", "title": "P14 · Cancellation / deadline — Cancel obsolete search work", "level": 2 }, { "id": "type-p15", "anchor": "type-p15", "title": "P15 · Clock / tick / timer — Retry delivery with bounded backoff", "level": 2 }, { "id": "type-p16", "anchor": "type-p16", "title": "P16 · Owned resource transfer — Transfer a camera frame to a native encoder", "level": 2 }, { "id": "type-p17", "anchor": "type-p17", "title": "P17 · Borrowed buffer / view — Decode a borrowed message buffer", "level": 2 }, { "id": "type-p18", "anchor": "type-p18", "title": "P18 · Shared read lease — Share an immutable model between workers", "level": 2 }, { "id": "type-p19", "anchor": "type-p19", "title": "P19 · Capability descriptor — Resolve a rendering backend", "level": 2 }, { "id": "type-p20", "anchor": "type-p20", "title": "P20 · Authorization request / grant — Grant access to one documentation cut", "level": 2 }, { "id": "type-p21", "anchor": "type-p21", "title": "P21 · Lifecycle management — Close a session when its route leaves", "level": 2 }, { "id": "type-p22", "anchor": "type-p22", "title": "P22 · Checkpoint / migration — Restore state into a candidate actor", "level": 2 }, { "id": "type-p23", "anchor": "type-p23", "title": "P23 · Artifact / schema reference — Load a trusted plugin by digest", "level": 2 }, { "id": "type-p24", "anchor": "type-p24", "title": "P24 · Inspection / evidence — Explain a slow product flow", "level": 2 } ], "links": [ { "id": "reaktor-port-theory", "anchor": "type-p02", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-port-theory", "anchor": "type-p03", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-port-theory", "anchor": "type-p06", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-port-theory", "anchor": "type-p07", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-port-theory", "anchor": "type-p09", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-port-theory", "anchor": "type-p16", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-port-theory", "anchor": "type-p01", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p02", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p04", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p05", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p06", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p07", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p08", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p03", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p09", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p10", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p11", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p12", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p13", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p14", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p15", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p21", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p16", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p17", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p18", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p19", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p20", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p22", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p23", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-port-theory", "anchor": "type-p24", "relation": "references", "sourceAnchor": "port-classification" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "type-p01" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-p02" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "type-p03" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "type-p04" }, { "id": "reaktor-data-inspection", "anchor": "", "relation": "references", "sourceAnchor": "type-p05" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "type-p06" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "type-p07" }, { "id": "reaktor-surface", "anchor": "", "relation": "references", "sourceAnchor": "type-p08" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "type-p09" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "type-p10" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "type-p11" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "type-p12" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "type-p13" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "type-p14" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "type-p15" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "type-p16" }, { "id": "flexbuffer-performance-review", "anchor": "", "relation": "references", "sourceAnchor": "type-p17" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "type-p18" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "type-p19" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "type-p20" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "type-p21" }, { "id": "reaktor-graph-distribution-theory", "anchor": "", "relation": "references", "sourceAnchor": "type-p22" }, { "id": "reaktor-dependeasy", "anchor": "", "relation": "references", "sourceAnchor": "type-p23" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "type-p24" } ] }, { "id": "reaktor-server", "owner": "Claude", "kind": "design", "summary": "The production discipline layer for command-shaped APIs, invariants, state machines, ledgers, reconciliation, idempotency, retries, circuit breakers, queues, outbox, CQRS, saga, and event sourcing — mapped onto reaktor-graph (interceptors/facets/actors/bus) and run on Spring Boot (JVM/k3s) and Cloudflare Workers (edge).", "use": "Use before adding any production backend primitive, modelling scarce/value-bearing resources, designing reconciliation or repair flows, or shaping the Spring/Workers server runtime.", "region": "framework-backend", "order": 1, "title": "Reaktor Server — production backend primitives", "nav": "Server", "group": "framework", "subsection": "framework-backend", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-server", "revision": "ffcde5848015e3a366d6a5c978f85fad7dadbfeb8aefa20823e558d09b6cd292", "status": "unverified", "renderingRevision": "a5613081f26dea6b6d7afd9a71a6592e86f1871eef269b6b0aae9c37a4a3573e", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "scan" ], "externalLinks": [ "https://www.oreilly.com/library/view/designing-data-intensive-applications/9781098119058/", "https://dataintensive.net/", "https://www.oreilly.com/library/view/building-microservices-2nd/9781492034018/", "https://www.enterpriseintegrationpatterns.com/", "https://pragprog.com/titles/mnee2/release-it-second-edition/", "https://microservices.io/patterns/data/saga.html", "https://microservices.io/patterns/data/cqrs.html", "https://microservices.io/patterns/data/transactional-outbox.html", "https://microservices.io/patterns/communication-style/idempotent-consumer.html", "https://microservices.io/patterns/data/transaction-log-tailing.html", "https://microservices.io/patterns/reliability/circuit-breaker.html", "https://arrow-kt.io/learn/resilience/retry-and-repeat/", "https://arrow-kt.io/learn/resilience/circuitbreaker/", "https://arrow-kt.io/learn/resilience/saga/", "https://arrow-kt.io/learn/resilience/", "https://resilience4j.readme.io/docs/getting-started", "https://bucket4j.com/", "https://developers.cloudflare.com/queues/", "https://developers.cloudflare.com/durable-objects/", "https://developers.cloudflare.com/d1/", "https://developers.cloudflare.com/kv/", "https://developers.cloudflare.com/workflows/", "https://docs.cloud.google.com/pubsub/docs/subscriber", "https://docs.cloud.google.com/pubsub/docs/ordering", "https://docs.cloud.google.com/pubsub/docs/exactly-once-delivery", "https://bravenewgeek.com/you-cannot-have-exactly-once-delivery/", "https://sre.google/books/", "https://sre.google/sre-book/handling-overload/", "https://sre.google/sre-book/addressing-cascading-failures/", "https://docs.aws.amazon.com/wellarchitected/latest/reliability-pillar/welcome.html", "https://docs.aws.amazon.com/wellarchitected/latest/reducing-scope-of-impact-with-cell-based-architecture/", "https://aws.amazon.com/builders-library/workload-isolation-using-shuffle-sharding/", "https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/", "https://martinfowler.com/bliki/ParallelChange.html", "https://martinfowler.com/bliki/BlueGreenDeployment.html", "https://martinfowler.com/bliki/CanaryRelease.html", "https://martinfowler.com/articles/feature-toggles.html", "https://martin.kleppmann.com/2016/02/08/how-to-do-distributed-locking.html", "https://netflixtechblog.medium.com/performance-under-load-3e6fa9a60581", "https://github.com/Netflix/concurrency-limits", "https://www.rfc-editor.org/rfc/rfc9457.html", "https://datatracker.ietf.org/doc/html/rfc7807", "https://spiffe.io/", "https://keda.sh/", "https://cloud.google.com/blog/products/containers-kubernetes/scale-to-zero-on-gke-with-keda", "https://github.com/brettwooldridge/HikariCP/wiki/About-Pool-Sizing", "https://developers.cloudflare.com/hyperdrive/", "https://developers.cloudflare.com/workers/configuration/smart-placement/", "https://developers.cloudflare.com/waf/rate-limiting-rules/", "https://developers.cloudflare.com/workers/configuration/versions-and-deployments/", "https://developers.cloudflare.com/flagship/", "https://developers.cloudflare.com/d1/reference/time-travel/", "https://openfeature.dev/", "https://grafana.com/docs/k6/latest/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-server", "polarity": "Neutral" }, { "id": "section-vision", "anchor": "vision", "label": "1. Vision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#vision", "polarity": "Neutral" }, { "id": "section-scan", "anchor": "implementation-state", "label": "2. Implementation state", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#implementation-state", "polarity": "Neutral" }, { "id": "section-constraints", "anchor": "constraints", "label": "3. Constraints the design must respect", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#constraints", "polarity": "Neutral" }, { "id": "section-shape", "anchor": "shape", "label": "4. The shape — one service, two runtimes, cross-cuts as middleware", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#shape", "polarity": "Neutral" }, { "id": "section-resilience", "anchor": "resilience", "label": "5. Resilience middleware", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#resilience", "polarity": "Neutral" }, { "id": "section-messaging", "anchor": "messaging", "label": "6. Messaging & async — reaktor-bus", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#messaging", "polarity": "Neutral" }, { "id": "section-api-evolution", "anchor": "api-evolution", "label": "9.8 API contract & evolution", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#api-evolution", "polarity": "Neutral" }, { "id": "section-high-scale", "anchor": "high-scale", "label": "9. Engineering for high scale", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#high-scale", "polarity": "Neutral" }, { "id": "section-multi-tenancy", "anchor": "multi-tenancy", "label": "9.9 Multi-tenancy, quotas & cells", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#multi-tenancy", "polarity": "Neutral" }, { "id": "section-rate-limiting", "anchor": "rate-limiting", "label": "5.4 Rate limiting", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#rate-limiting", "polarity": "Neutral" }, { "id": "section-connections", "anchor": "connections", "label": "9.6 Connection management", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#connections", "polarity": "Neutral" }, { "id": "section-overload", "anchor": "overload", "label": "9.1 Overload protection — load shedding, admission control, adaptive concurrency", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#overload", "polarity": "Neutral" }, { "id": "section-idempotency", "anchor": "idempotency", "label": "5.6 Idempotency", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#idempotency", "polarity": "Neutral" }, { "id": "section-progressive-delivery", "anchor": "progressive-delivery", "label": "9.10 Progressive delivery & feature flags", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#progressive-delivery", "polarity": "Neutral" }, { "id": "section-retries", "anchor": "retries", "label": "5.2 Retries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#retries", "polarity": "Neutral" }, { "id": "section-envelope", "anchor": "envelope", "label": "6.1 The envelope and the two transports", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#envelope", "polarity": "Neutral" }, { "id": "section-outbox", "anchor": "outbox", "label": "6.2 Transactional outbox — the dual-write fix", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#outbox", "polarity": "Neutral" }, { "id": "section-data", "anchor": "data", "label": "7. Data & state patterns", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#data", "polarity": "Neutral" }, { "id": "section-caching", "anchor": "caching", "label": "7.1 Caching", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#caching", "polarity": "Neutral" }, { "id": "section-batching", "anchor": "batching", "label": "7.2 Batching", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#batching", "polarity": "Neutral" }, { "id": "section-topology", "anchor": "topology", "label": "7.3 The authority/cache topology", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#topology", "polarity": "Neutral" }, { "id": "section-ledger-invariants", "anchor": "ledger-invariants", "label": "7.4 Ledger-style invariants for scarce or conserved things", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#ledger-invariants", "polarity": "Neutral" }, { "id": "section-reconciliation-repair", "anchor": "reconciliation-repair", "label": "7.5 Reconciliation, repair, and derived state", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#reconciliation-repair", "polarity": "Neutral" }, { "id": "section-transactions", "anchor": "transactions", "label": "8. Transactional patterns", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#transactions", "polarity": "Neutral" }, { "id": "section-state-machines", "anchor": "state-machines", "label": "8.1 Command-shaped APIs, state machines, and temporal truth", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#state-machines", "polarity": "Neutral" }, { "id": "section-saga", "anchor": "saga", "label": "8.2 Saga", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#saga", "polarity": "Neutral" }, { "id": "section-cqrs", "anchor": "cqrs", "label": "8.4 CQRS", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#cqrs", "polarity": "Neutral" }, { "id": "section-event-sourcing", "anchor": "event-sourcing", "label": "8.5 Event sourcing", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#event-sourcing", "polarity": "Neutral" }, { "id": "section-elasticity", "anchor": "elasticity", "label": "9.2 Elasticity & autoscaling", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#elasticity", "polarity": "Neutral" }, { "id": "section-multi-region", "anchor": "multi-region", "label": "9.5 Multi-region & data residency", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#multi-region", "polarity": "Neutral" }, { "id": "section-disaster-recovery", "anchor": "disaster-recovery", "label": "9.12 Disaster recovery & data lifecycle", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#disaster-recovery", "polarity": "Neutral" }, { "id": "section-capacity", "anchor": "capacity", "label": "9.14 Capacity, cost & chaos", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#capacity", "polarity": "Neutral" }, { "id": "section-spring", "anchor": "spring", "label": "10. Running on Spring Boot (JVM / k3s)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#spring", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "See also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#see-also", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-server#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-server:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-constraints", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-constraints", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-notifications-design", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-constraints", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-db", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-constraints", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-work-durability", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-retries", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-durability", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-idempotency", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-idempotency", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-idempotency", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-messaging", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-messaging", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-bus-mesh-contract", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-envelope", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "section-contract", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-outbox", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-outbox", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-outbox", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-data", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-data", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-data", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-caching", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-caching", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-caching", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-batching", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-batching", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-batching", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-topology", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-topology", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-topology", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-ledger-invariants", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-ledger-invariants", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-ledger-invariants", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-reconciliation-repair", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-reconciliation-repair", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-reconciliation-repair", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-transactions", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-transactions", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-transactions", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-state-machines", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-state-machines", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-state-machines", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-saga", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-saga", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-saga", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-cqrs", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-cqrs", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-cqrs", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-data-transactions-event-sourcing", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-event-sourcing", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "section-event-sourcing", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-elasticity", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-multi-region", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-db-economics", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-multi-region", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-economics", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-capability", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-progressive-delivery", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-auth-analysis", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-disaster-recovery", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-shadow-dev-environment", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-capacity", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-db-sinks", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-capacity", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-sinks", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-work", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-spring", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-work-spring", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-spring", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-spring", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-work-cloudflare", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-spring", "role": "source", "ordinal": 0 }, { "node": "reaktor-work", "port": "section-cloudflare", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-performance-observability", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-secrets-management", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-service", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-multitenancy", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-multitenancy", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-server:references-reaktor-core", "kind": "references", "owner": "reaktor-server", "incidences": [ { "node": "reaktor-server", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-core", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-server.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Server — production backend primitives", "level": 0 }, { "id": "vision", "anchor": "vision", "title": "1. Vision", "level": 2 }, { "id": "production-model", "anchor": "production-model", "title": "1.1 The production model: commands, facts, invariants, controlled effects", "level": 3 }, { "id": "implementation-state", "anchor": "implementation-state", "title": "2. Implementation state", "level": 2 }, { "id": "constraints", "anchor": "constraints", "title": "3. Constraints the design must respect", "level": 2 }, { "id": "shape", "anchor": "shape", "title": "4. The shape — one service, two runtimes, cross-cuts as middleware", "level": 2 }, { "id": "resilience", "anchor": "resilience", "title": "5. Resilience middleware", "level": 2 }, { "id": "timeouts", "anchor": "timeouts", "title": "5.1 Timeouts", "level": 3 }, { "id": "retries", "anchor": "retries", "title": "5.2 Retries", "level": 3 }, { "id": "circuit-breakers", "anchor": "circuit-breakers", "title": "5.3 Circuit breakers", "level": 3 }, { "id": "rate-limiting", "anchor": "rate-limiting", "title": "5.4 Rate limiting", "level": 3 }, { "id": "bulkheads", "anchor": "bulkheads", "title": "5.5 Bulkheads", "level": 3 }, { "id": "idempotency", "anchor": "idempotency", "title": "5.6 Idempotency", "level": 3 }, { "id": "messaging", "anchor": "messaging", "title": "6. Messaging & async — reaktor-bus", "level": 2 }, { "id": "envelope", "anchor": "envelope", "title": "6.1 The envelope and the two transports", "level": 3 }, { "id": "outbox", "anchor": "outbox", "title": "6.2 Transactional outbox — the dual-write fix", "level": 3 }, { "id": "consumers", "anchor": "consumers", "title": "6.3 Idempotent consumers, DLQ, backpressure, claim-check", "level": 3 }, { "id": "bus-resilience", "anchor": "bus-resilience", "title": "6.4 Resilience composition on the bus", "level": 3 }, { "id": "exactly-once", "anchor": "exactly-once", "title": "6.5 Effectively-once, not exactly-once", "level": 3 }, { "id": "data", "anchor": "data", "title": "7. Data & state patterns", "level": 2 }, { "id": "caching", "anchor": "caching", "title": "7.1 Caching", "level": 3 }, { "id": "batching", "anchor": "batching", "title": "7.2 Batching", "level": 3 }, { "id": "topology", "anchor": "topology", "title": "7.3 The authority/cache topology", "level": 3 }, { "id": "ledger-invariants", "anchor": "ledger-invariants", "title": "7.4 Ledger-style invariants for scarce or conserved things", "level": 3 }, { "id": "reconciliation-repair", "anchor": "reconciliation-repair", "title": "7.5 Reconciliation, repair, and derived state", "level": 3 }, { "id": "transactions", "anchor": "transactions", "title": "8. Transactional patterns", "level": 2 }, { "id": "state-machines", "anchor": "state-machines", "title": "8.1 Command-shaped APIs, state machines, and temporal truth", "level": 3 }, { "id": "saga", "anchor": "saga", "title": "8.2 Saga", "level": 3 }, { "id": "outbox-pattern", "anchor": "outbox-pattern", "title": "8.3 Transactional outbox", "level": 3 }, { "id": "cqrs", "anchor": "cqrs", "title": "8.4 CQRS", "level": 3 }, { "id": "event-sourcing", "anchor": "event-sourcing", "title": "8.5 Event sourcing", "level": 3 }, { "id": "high-scale", "anchor": "high-scale", "title": "9. Engineering for high scale", "level": 2 }, { "id": "overload", "anchor": "overload", "title": "9.1 Overload protection — load shedding, admission control, adaptive concurrency", "level": 3 }, { "id": "elasticity", "anchor": "elasticity", "title": "9.2 Elasticity & autoscaling", "level": 3 }, { "id": "partitioning", "anchor": "partitioning", "title": "9.3 Partitioning, sharding & hot keys", "level": 3 }, { "id": "replication", "anchor": "replication", "title": "9.4 Replication & read scaling", "level": 3 }, { "id": "multi-region", "anchor": "multi-region", "title": "9.5 Multi-region & data residency", "level": 3 }, { "id": "connections", "anchor": "connections", "title": "9.6 Connection management", "level": 3 }, { "id": "zero-downtime", "anchor": "zero-downtime", "title": "9.7 Health, lifecycle & zero-downtime deploys", "level": 3 }, { "id": "api-evolution", "anchor": "api-evolution", "title": "9.8 API contract & evolution", "level": 3 }, { "id": "multi-tenancy", "anchor": "multi-tenancy", "title": "9.9 Multi-tenancy, quotas & cells", "level": 3 }, { "id": "progressive-delivery", "anchor": "progressive-delivery", "title": "9.10 Progressive delivery & feature flags", "level": 3 }, { "id": "coordination", "anchor": "coordination", "title": "9.11 Distributed coordination", "level": 3 }, { "id": "disaster-recovery", "anchor": "disaster-recovery", "title": "9.12 Disaster recovery & data lifecycle", "level": 3 }, { "id": "security-scale", "anchor": "security-scale", "title": "9.13 Security at scale", "level": 3 }, { "id": "capacity", "anchor": "capacity", "title": "9.14 Capacity, cost & chaos", "level": 3 }, { "id": "spring", "anchor": "spring", "title": "10. Running on Spring Boot (JVM / k3s)", "level": 2 }, { "id": "edge", "anchor": "edge", "title": "11. Running on Cloudflare Workers (edge)", "level": 2 }, { "id": "cross-cutting", "anchor": "cross-cutting", "title": "12. Observability, auth, and secrets", "level": 2 }, { "id": "module", "anchor": "module", "title": "13. The reaktor-server module", "level": 2 }, { "id": "phases", "anchor": "phases", "title": "14. Phased plan", "level": 2 }, { "id": "open", "anchor": "open", "title": "15. Open decisions", "level": 2 }, { "id": "references", "anchor": "references", "title": "16. References", "level": 2 }, { "id": "books", "anchor": "books", "title": "Books", "level": 3 }, { "id": "pattern-catalogs--docs", "anchor": "pattern-catalogs--docs", "title": "Pattern catalogs & docs", "level": 3 }, { "id": "high-scale--operations-9", "anchor": "high-scale--operations-9", "title": "High scale & operations (§9)", "level": 3 }, { "id": "see-also", "anchor": "see-also", "title": "See also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-server", "anchor": "high-scale", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-server", "anchor": "high-scale", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-server", "anchor": "high-scale", "relation": "references", "sourceAnchor": "implementation-state" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "constraints" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "constraints" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "constraints" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "constraints" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "constraints" }, { "id": "reaktor-work", "anchor": "durability", "relation": "references", "sourceAnchor": "retries" }, { "id": "reaktor-data-transactions", "anchor": "idempotency", "relation": "references", "sourceAnchor": "idempotency" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "messaging" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "messaging" }, { "id": "reaktor-bus-mesh", "anchor": "contract", "relation": "references", "sourceAnchor": "envelope" }, { "id": "reaktor-data-transactions", "anchor": "outbox", "relation": "references", "sourceAnchor": "outbox" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "consumers" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "bus-resilience" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "exactly-once" }, { "id": "reaktor-data-transactions", "anchor": "data", "relation": "references", "sourceAnchor": "data" }, { "id": "reaktor-data-transactions", "anchor": "caching", "relation": "references", "sourceAnchor": "caching" }, { "id": "reaktor-data-transactions", "anchor": "batching", "relation": "references", "sourceAnchor": "batching" }, { "id": "reaktor-data-transactions", "anchor": "topology", "relation": "references", "sourceAnchor": "topology" }, { "id": "reaktor-data-transactions", "anchor": "ledger-invariants", "relation": "references", "sourceAnchor": "ledger-invariants" }, { "id": "reaktor-data-transactions", "anchor": "reconciliation-repair", "relation": "references", "sourceAnchor": "reconciliation-repair" }, { "id": "reaktor-data-transactions", "anchor": "transactions", "relation": "references", "sourceAnchor": "transactions" }, { "id": "reaktor-data-transactions", "anchor": "state-machines", "relation": "references", "sourceAnchor": "state-machines" }, { "id": "reaktor-data-transactions", "anchor": "saga", "relation": "references", "sourceAnchor": "saga" }, { "id": "reaktor-data-transactions", "anchor": "outbox", "relation": "references", "sourceAnchor": "outbox-pattern" }, { "id": "reaktor-data-transactions", "anchor": "cqrs", "relation": "references", "sourceAnchor": "cqrs" }, { "id": "reaktor-data-transactions", "anchor": "event-sourcing", "relation": "references", "sourceAnchor": "event-sourcing" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "elasticity" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "partitioning" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "multi-region" }, { "id": "reaktor-db", "anchor": "economics", "relation": "references", "sourceAnchor": "multi-region" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "zero-downtime" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "zero-downtime" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "multi-tenancy" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "progressive-delivery" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "coordination" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "disaster-recovery" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "security-scale" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "capacity" }, { "id": "reaktor-db", "anchor": "sinks", "relation": "references", "sourceAnchor": "capacity" }, { "id": "reaktor-work", "anchor": "", "relation": "references", "sourceAnchor": "spring" }, { "id": "reaktor-work", "anchor": "spring", "relation": "references", "sourceAnchor": "spring" }, { "id": "reaktor-work", "anchor": "cloudflare", "relation": "references", "sourceAnchor": "spring" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "spring" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-multitenancy", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-core", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-service", "owner": "Codex", "kind": "module", "summary": "Current typed HTTP handlers and the proposed unified Service contracts: sync, async, streams, duplex, publication/subscription and durable jobs, with qualified FFI and runtime bindings.", "use": "Use for operation contracts, interaction protocols, context/errors, Service and FFI integration, graph/data effects, and migration from the current unary handlers.", "region": "framework-foundations", "order": 2, "title": "Reaktor Service", "nav": "Service Layer", "group": "framework", "subsection": "framework-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-service", "revision": "85f71e62bb430a85d0f5dd2caa64be14c15f0457c138c6620694ea383f9710be", "status": "unverified", "renderingRevision": "0bda48b2ca3d0f3ced62c2a1174182f5d7ac46e91aac4c32fb84962c4422f46d", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-service", "polarity": "Neutral" }, { "id": "section-job", "anchor": "job", "label": "1. Responsibility and boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-service#job", "polarity": "Neutral" }, { "id": "section-source", "anchor": "source", "label": "2. What exists in source today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-service#source", "polarity": "Neutral" }, { "id": "section-identity", "anchor": "identity", "label": "3. Contract, implementation, binding", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-service#identity", "polarity": "Neutral" }, { "id": "section-request-response", "anchor": "request-response", "label": "4. Callable protocols", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-service#request-response", "polarity": "Neutral" }, { "id": "section-context", "anchor": "context", "label": "5. Context and outcomes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-service#context", "polarity": "Neutral" }, { "id": "section-interceptors", "anchor": "interceptors", "label": "6. Interceptors and execution policies", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-service#interceptors", "polarity": "Neutral" }, { "id": "section-adapters", "anchor": "adapters", "label": "7. Binding families, including FFI", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-service#adapters", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-service:references-reaktor-db", "kind": "references", "owner": "reaktor-service", "incidences": [ { "node": "reaktor-service", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-service:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-service", "incidences": [ { "node": "reaktor-service", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-service:references-reaktor-graph-pane-whole-system", "kind": "references", "owner": "reaktor-service", "incidences": [ { "node": "reaktor-service", "port": "section-source", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "section-whole-system", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-service:references-reaktor-ffi-current-map", "kind": "references", "owner": "reaktor-service", "incidences": [ { "node": "reaktor-service", "port": "section-source", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "section-current-map", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-service:references-reaktor-ffi", "kind": "references", "owner": "reaktor-service", "incidences": [ { "node": "reaktor-service", "port": "section-adapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-service.json", "sections": [ { "id": "reaktor-service", "anchor": "reaktor-service", "title": "Reaktor Service", "level": 1 }, { "id": "job", "anchor": "job", "title": "1. Responsibility and boundaries", "level": 2 }, { "id": "source", "anchor": "source", "title": "2. What exists in source today", "level": 2 }, { "id": "identity", "anchor": "identity", "title": "3. Contract, implementation, binding", "level": 2 }, { "id": "request-response", "anchor": "request-response", "title": "4. Callable protocols", "level": 2 }, { "id": "streams-upload-duplex-and-subscriptions", "anchor": "streams-upload-duplex-and-subscriptions", "title": "Streams, upload, duplex and subscriptions", "level": 3 }, { "id": "durable-jobs", "anchor": "durable-jobs", "title": "Durable jobs", "level": 3 }, { "id": "context", "anchor": "context", "title": "5. Context and outcomes", "level": 2 }, { "id": "interceptors", "anchor": "interceptors", "title": "6. Interceptors and execution policies", "level": 2 }, { "id": "adapters", "anchor": "adapters", "title": "7. Binding families, including FFI", "level": 2 }, { "id": "graph", "anchor": "graph", "title": "8. Graph and data integration", "level": 2 }, { "id": "migration", "anchor": "migration", "title": "9. Migration and acceptance", "level": 2 } ], "links": [ { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-pane", "anchor": "whole-system", "relation": "references", "sourceAnchor": "source" }, { "id": "reaktor-ffi", "anchor": "current-map", "relation": "references", "sourceAnchor": "source" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "adapters" } ] }, { "id": "reaktor-stable-foundations-5.6-ultra", "owner": "Codex", "kind": "architecture", "summary": "Code-grounded stable-kernel architecture for canonical graph semantics, transactional mutation, owned runtimes, authority, persistence, actors, protocols, FFI, and honest formal-verification claims.", "use": "Use as the implementation and acceptance contract when hardening Reaktor's base layers or proving them through the BestBuds reference slice.", "region": "graph-correctness", "order": 0, "title": "Reaktor Stable Foundations — 5.6 Ultra", "nav": "Stable Foundations 5.6 Ultra", "group": "graph", "subsection": "graph-correctness", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra", "revision": "47b6ae38c2b0c73749d032384d8fd6e69492ac4cad50b758a7418ee2d0ff4e52", "status": "unverified", "renderingRevision": "df0ddb8503e5eca715e550ac13eee00199dff4e0d82ec8e06718770eb00c07f2", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://docs.lean-lang.org/theorem_proving_in_lean4/", "https://lamport.azurewebsites.net/tla/high-level-view.html", "https://apalache-mc.org/docs/apalache/index.html", "https://alloytools.org/", "https://kotlinlang.org/docs/lincheck-guide.html", "https://www.rfc-editor.org/rfc/rfc9420.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra", "polarity": "Neutral" }, { "id": "section-executive-decision", "anchor": "executive-decision", "label": "Executive decision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra#executive-decision", "polarity": "Neutral" }, { "id": "section-strategic-thesis-why-reaktor-why-kotlin-and-where-the-power-comes-from", "anchor": "strategic-thesis-why-reaktor-why-kotlin-and-where-the-power-comes-from", "label": "Strategic thesis: why Reaktor, why Kotlin, and where the power comes from", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra#strategic-thesis-why-reaktor-why-kotlin-and-where-the-power-comes-from", "polarity": "Neutral" }, { "id": "section-1-what-stable-means", "anchor": "1-what-stable-means", "label": "1. What “stable” means", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra#1-what-stable-means", "polarity": "Neutral" }, { "id": "section-2-audit-basis-and-current-evidence", "anchor": "2-audit-basis-and-current-evidence", "label": "2. Audit basis and current evidence", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra#2-audit-basis-and-current-evidence", "polarity": "Neutral" }, { "id": "section-3-the-stable-foundation-four-layers", "anchor": "3-the-stable-foundation-four-layers", "label": "3. The stable foundation: four layers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra#3-the-stable-foundation-four-layers", "polarity": "Neutral" }, { "id": "section-4-canonical-graph-intermediate-representation", "anchor": "4-canonical-graph-intermediate-representation", "label": "4. Canonical graph intermediate representation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra#4-canonical-graph-intermediate-representation", "polarity": "Neutral" }, { "id": "section-32-related-reaktor-documents", "anchor": "32-related-reaktor-documents", "label": "32. Related Reaktor documents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-stable-foundations-5.6-ultra#32-related-reaktor-documents", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-stable-foundations-5.6-ultra:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-reaktor-component-lifecycle", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-auth-analysis", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-reaktor-ffi", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-bestbuds-schema-hardening", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "bestbuds-schema-hardening", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-stable-foundations-5.6-ultra:references-security-plan", "kind": "references", "owner": "reaktor-stable-foundations-5.6-ultra", "incidences": [ { "node": "reaktor-stable-foundations-5.6-ultra", "port": "section-32-related-reaktor-documents", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-stable-foundations-5.6-ultra.json", "sections": [ { "id": "reaktor-stable-foundations--56-ultra", "anchor": "reaktor-stable-foundations--56-ultra", "title": "Reaktor Stable Foundations — 5.6 Ultra", "level": 1 }, { "id": "executive-decision", "anchor": "executive-decision", "title": "Executive decision", "level": 2 }, { "id": "strategic-thesis-why-reaktor-why-kotlin-and-where-the-power-comes-from", "anchor": "strategic-thesis-why-reaktor-why-kotlin-and-where-the-power-comes-from", "title": "Strategic thesis: why Reaktor, why Kotlin, and where the power comes from", "level": 2 }, { "id": "why-a-blueprint-style-graph", "anchor": "why-a-blueprint-style-graph", "title": "Why a Blueprint-style graph", "level": 3 }, { "id": "why-keep-a-runtime-graph", "anchor": "why-keep-a-runtime-graph", "title": "Why keep a runtime graph", "level": 3 }, { "id": "why-visitors", "anchor": "why-visitors", "title": "Why visitors", "level": 3 }, { "id": "why-kotlin", "anchor": "why-kotlin", "title": "Why Kotlin", "level": 3 }, { "id": "why-a-deliberately-polyglot-core", "anchor": "why-a-deliberately-polyglot-core", "title": "Why a deliberately polyglot core", "level": 3 }, { "id": "why-opinionated-infrastructure", "anchor": "why-opinionated-infrastructure", "title": "Why opinionated infrastructure", "level": 3 }, { "id": "the-highest-leverage-power-expansions", "anchor": "the-highest-leverage-power-expansions", "title": "The highest-leverage power expansions", "level": 3 }, { "id": "1-what-stable-means", "anchor": "1-what-stable-means", "title": "1. What “stable” means", "level": 2 }, { "id": "2-audit-basis-and-current-evidence", "anchor": "2-audit-basis-and-current-evidence", "title": "2. Audit basis and current evidence", "level": 2 }, { "id": "21-what-is-already-strong", "anchor": "21-what-is-already-strong", "title": "2.1 What is already strong", "level": 3 }, { "id": "22-what-currently-blocks-a-stable-foundation-claim", "anchor": "22-what-currently-blocks-a-stable-foundation-claim", "title": "2.2 What currently blocks a “stable foundation” claim", "level": 3 }, { "id": "3-the-stable-foundation-four-layers", "anchor": "3-the-stable-foundation-four-layers", "title": "3. The stable foundation: four layers", "level": 2 }, { "id": "31-kernel-dependency-rule", "anchor": "31-kernel-dependency-rule", "title": "3.1 Kernel dependency rule", "level": 3 }, { "id": "32-runtime-dependency-rule", "anchor": "32-runtime-dependency-rule", "title": "3.2 Runtime dependency rule", "level": 3 }, { "id": "33-product-dependency-rule", "anchor": "33-product-dependency-rule", "title": "3.3 Product dependency rule", "level": 3 }, { "id": "4-canonical-graph-intermediate-representation", "anchor": "4-canonical-graph-intermediate-representation", "title": "4. Canonical graph intermediate representation", "level": 2 }, { "id": "41-definition-identity-is-not-activation-identity", "anchor": "41-definition-identity-is-not-activation-identity", "title": "4.1 Definition identity is not activation identity", "level": 3 }, { "id": "42-stable-identifiers", "anchor": "42-stable-identifiers", "title": "4.2 Stable identifiers", "level": 3 }, { "id": "43-port-contracts", "anchor": "43-port-contracts", "title": "4.3 Port contracts", "level": 3 }, { "id": "44-edges-and-gateways", "anchor": "44-edges-and-gateways", "title": "4.4 Edges and gateways", "level": 3 }, { "id": "5-certification-predicates-and-invariants", "anchor": "5-certification-predicates-and-invariants", "title": "5. Certification predicates and invariants", "level": 2 }, { "id": "51-static-graph-laws", "anchor": "51-static-graph-laws", "title": "5.1 Static graph laws", "level": 3 }, { "id": "6-hierarchy-and-open-composition", "anchor": "6-hierarchy-and-open-composition", "title": "6. Hierarchy and open composition", "level": 2 }, { "id": "61-eigen-primitives", "anchor": "61-eigen-primitives", "title": "6.1 “Eigen” primitives", "level": 3 }, { "id": "7-graph-compiler-and-deterministic-wiring", "anchor": "7-graph-compiler-and-deterministic-wiring", "title": "7. Graph compiler and deterministic wiring", "level": 2 }, { "id": "71-compiler-pipeline", "anchor": "71-compiler-pipeline", "title": "7.1 Compiler pipeline", "level": 3 }, { "id": "72-wiring-as-constrained-matching", "anchor": "72-wiring-as-constrained-matching", "title": "7.2 Wiring as constrained matching", "level": 3 }, { "id": "73-generated-registries-not-reflection-names", "anchor": "73-generated-registries-not-reflection-names", "title": "7.3 Generated registries, not reflection names", "level": 3 }, { "id": "8-transactional-mutation-and-graphauthority", "anchor": "8-transactional-mutation-and-graphauthority", "title": "8. Transactional mutation and GraphAuthority", "level": 2 }, { "id": "81-runtime-reconciliation-is-separate-from-topology-commit", "anchor": "81-runtime-reconciliation-is-separate-from-topology-commit", "title": "8.1 Runtime reconciliation is separate from topology commit", "level": 3 }, { "id": "9-lifecycle-and-owned-runtime-scopes", "anchor": "9-lifecycle-and-owned-runtime-scopes", "title": "9. Lifecycle and owned runtime scopes", "level": 2 }, { "id": "91-lifecycle-state-machine", "anchor": "91-lifecycle-state-machine", "title": "9.1 Lifecycle state machine", "level": 3 }, { "id": "92-remove-global-correctness-dependencies", "anchor": "92-remove-global-correctness-dependencies", "title": "9.2 Remove global correctness dependencies", "level": 3 }, { "id": "10-authority-as-a-graph-wide-reference-monitor", "anchor": "10-authority-as-a-graph-wide-reference-monitor", "title": "10. Authority as a graph-wide reference monitor", "level": 2 }, { "id": "101-enforcement-points", "anchor": "101-enforcement-points", "title": "10.1 Enforcement points", "level": 3 }, { "id": "102-non-amplification-law", "anchor": "102-non-amplification-law", "title": "10.2 Non-amplification law", "level": 3 }, { "id": "103-bestbuds-security-gates", "anchor": "103-bestbuds-security-gates", "title": "10.3 BestBuds security gates", "level": 3 }, { "id": "11-persistence-and-effect-protocol", "anchor": "11-persistence-and-effect-protocol", "title": "11. Persistence and effect protocol", "level": 2 }, { "id": "111-minimum-storage-contract", "anchor": "111-minimum-storage-contract", "title": "11.1 Minimum storage contract", "level": 3 }, { "id": "112-inbox-outbox-and-sagas", "anchor": "112-inbox-outbox-and-sagas", "title": "11.2 Inbox, outbox, and sagas", "level": 3 }, { "id": "113-desired-state-versus-observed-state", "anchor": "113-desired-state-versus-observed-state", "title": "11.3 Desired state versus observed state", "level": 3 }, { "id": "12-actor-semantics", "anchor": "12-actor-semantics", "title": "12. Actor semantics", "level": 2 }, { "id": "121-honest-current-guarantee", "anchor": "121-honest-current-guarantee", "title": "12.1 Honest current guarantee", "level": 3 }, { "id": "122-target-local-actor-contract", "anchor": "122-target-local-actor-contract", "title": "12.2 Target local actor contract", "level": 3 }, { "id": "123-distributed-actors-come-later", "anchor": "123-distributed-actors-come-later", "title": "12.3 Distributed actors come later", "level": 3 }, { "id": "13-choreography-and-session-protocols", "anchor": "13-choreography-and-session-protocols", "title": "13. Choreography and session protocols", "level": 2 }, { "id": "14-ffi-flexbuffers-and-code-replacement", "anchor": "14-ffi-flexbuffers-and-code-replacement", "title": "14. FFI, FlexBuffers, and code replacement", "level": 2 }, { "id": "141-validated-payloads", "anchor": "141-validated-payloads", "title": "14.1 Validated payloads", "level": 3 }, { "id": "142-canonical-call-envelope", "anchor": "142-canonical-call-envelope", "title": "14.2 Canonical call envelope", "level": 3 }, { "id": "143-signed-bundle-manifest", "anchor": "143-signed-bundle-manifest", "title": "14.3 Signed bundle manifest", "level": 3 }, { "id": "144-replacement-protocol", "anchor": "144-replacement-protocol", "title": "14.4 Replacement protocol", "level": 3 }, { "id": "15-capabilities-and-graceful-degradation", "anchor": "15-capabilities-and-graceful-degradation", "title": "15. Capabilities and graceful degradation", "level": 2 }, { "id": "16-provenance-and-truth-dimensions", "anchor": "16-provenance-and-truth-dimensions", "title": "16. Provenance and truth dimensions", "level": 2 }, { "id": "17-visitors-queries-rewrites-and-analyses", "anchor": "17-visitors-queries-rewrites-and-analyses", "title": "17. Visitors, queries, rewrites, and analyses", "level": 2 }, { "id": "18-tooling-agents-and-the-control-plane", "anchor": "18-tooling-agents-and-the-control-plane", "title": "18. Tooling, agents, and the control plane", "level": 2 }, { "id": "19-theory-inventory-what-the-architecture-actually-uses", "anchor": "19-theory-inventory-what-the-architecture-actually-uses", "title": "19. Theory inventory: what the architecture actually uses", "level": 2 }, { "id": "20-verification-architecture", "anchor": "20-verification-architecture", "title": "20. Verification architecture", "level": 2 }, { "id": "201-lean-4-pure-kernel-theorems", "anchor": "201-lean-4-pure-kernel-theorems", "title": "20.1 Lean 4: pure kernel theorems", "level": 3 }, { "id": "202-tlapluscal-and-tlc-temporal-protocols", "anchor": "202-tlapluscal-and-tlc-temporal-protocols", "title": "20.2 TLA+/PlusCal and TLC: temporal protocols", "level": 3 }, { "id": "203-apalache-bounded-symbolic-checking", "anchor": "203-apalache-bounded-symbolic-checking", "title": "20.3 Apalache: bounded symbolic checking", "level": 3 }, { "id": "204-alloy-structural-counterexamples", "anchor": "204-alloy-structural-counterexamples", "title": "20.4 Alloy: structural counterexamples", "level": 3 }, { "id": "205-lincheck-and-platform-concurrency-tests", "anchor": "205-lincheck-and-platform-concurrency-tests", "title": "20.5 Lincheck and platform concurrency tests", "level": 3 }, { "id": "206-property-model-differential-fuzz-and-fault-testing", "anchor": "206-property-model-differential-fuzz-and-fault-testing", "title": "20.6 Property, model, differential, fuzz, and fault testing", "level": 3 }, { "id": "207-differential-conformance-and-translation-validation", "anchor": "207-differential-conformance-and-translation-validation", "title": "20.7 Differential conformance and translation validation", "level": 3 }, { "id": "208-non-vacuity-and-coverage-controls", "anchor": "208-non-vacuity-and-coverage-controls", "title": "20.8 Non-vacuity and coverage controls", "level": 3 }, { "id": "209-trusted-computing-base", "anchor": "209-trusted-computing-base", "title": "20.9 Trusted computing base", "level": 3 }, { "id": "21-verification-obligations-by-subsystem", "anchor": "21-verification-obligations-by-subsystem", "title": "21. Verification obligations by subsystem", "level": 2 }, { "id": "211-graph-kernel", "anchor": "211-graph-kernel", "title": "21.1 Graph kernel", "level": 3 }, { "id": "212-graph-authority-and-runtime-reconciliation", "anchor": "212-graph-authority-and-runtime-reconciliation", "title": "21.2 Graph authority and runtime reconciliation", "level": 3 }, { "id": "213-lifecycle", "anchor": "213-lifecycle", "title": "21.3 Lifecycle", "level": 3 }, { "id": "214-actors", "anchor": "214-actors", "title": "21.4 Actors", "level": 3 }, { "id": "215-choreography", "anchor": "215-choreography", "title": "21.5 Choreography", "level": 3 }, { "id": "216-persistence", "anchor": "216-persistence", "title": "21.6 Persistence", "level": 3 }, { "id": "217-authority", "anchor": "217-authority", "title": "21.7 Authority", "level": 3 }, { "id": "218-ffi-and-bundles", "anchor": "218-ffi-and-bundles", "title": "21.8 FFI and bundles", "level": 3 }, { "id": "22-verification-claim-policy", "anchor": "22-verification-claim-policy", "title": "22. Verification claim policy", "level": 2 }, { "id": "23-migration-without-a-big-bang", "anchor": "23-migration-without-a-big-bang", "title": "23. Migration without a big bang", "level": 2 }, { "id": "231-strangler-sequence", "anchor": "231-strangler-sequence", "title": "23.1 Strangler sequence", "level": 3 }, { "id": "232-compatibility-policy", "anchor": "232-compatibility-policy", "title": "23.2 Compatibility policy", "level": 3 }, { "id": "233-executable-module-and-data-migration-matrix", "anchor": "233-executable-module-and-data-migration-matrix", "title": "23.3 Executable module and data migration matrix", "level": 3 }, { "id": "24-ninety-day-execution-program", "anchor": "24-ninety-day-execution-program", "title": "24. Ninety-day execution program", "level": 2 }, { "id": "days-120-freeze-characterize-and-fix-immediate-contradictions", "anchor": "days-120-freeze-characterize-and-fix-immediate-contradictions", "title": "Days 1–20: freeze, characterize, and fix immediate contradictions", "level": 3 }, { "id": "days-2145-static-kernel-v0-and-lossless-shadow-adapters", "anchor": "days-2145-static-kernel-v0-and-lossless-shadow-adapters", "title": "Days 21–45: static kernel v0 and lossless shadow adapters", "level": 3 }, { "id": "days-4670-single-process-authority-prototype-and-owned-lifecycle", "anchor": "days-4670-single-process-authority-prototype-and-owned-lifecycle", "title": "Days 46–70: single-process authority prototype and owned lifecycle", "level": 3 }, { "id": "days-7190-one-bestbuds-vertical-proof-and-p0-decision", "anchor": "days-7190-one-bestbuds-vertical-proof-and-p0-decision", "title": "Days 71–90: one BestBuds vertical proof and P0 decision", "level": 3 }, { "id": "25-longer-roadmap-after-the-foundation", "anchor": "25-longer-roadmap-after-the-foundation", "title": "25. Longer roadmap after the foundation", "level": 2 }, { "id": "26-acceptance-gates", "anchor": "26-acceptance-gates", "title": "26. Acceptance gates", "level": 2 }, { "id": "261-a-module-may-be-labeled-stable-only-when", "anchor": "261-a-module-may-be-labeled-stable-only-when", "title": "26.1 A module may be labeled “stable” only when", "level": 3 }, { "id": "262-p0-foundation-release-gate", "anchor": "262-p0-foundation-release-gate", "title": "26.2 P0 foundation release gate", "level": 3 }, { "id": "263-production-code-replacement-gate", "anchor": "263-production-code-replacement-gate", "title": "26.3 Production code-replacement gate", "level": 3 }, { "id": "27-risks-and-non-goals", "anchor": "27-risks-and-non-goals", "title": "27. Risks and non-goals", "level": 2 }, { "id": "risks", "anchor": "risks", "title": "Risks", "level": 3 }, { "id": "non-goals", "anchor": "non-goals", "title": "Non-goals", "level": 3 }, { "id": "28-value-created-by-this-foundation", "anchor": "28-value-created-by-this-foundation", "title": "28. Value created by this foundation", "level": 2 }, { "id": "for-developers", "anchor": "for-developers", "title": "For developers", "level": 3 }, { "id": "for-bestbuds-users", "anchor": "for-bestbuds-users", "title": "For BestBuds users", "level": 3 }, { "id": "for-operators-and-investors", "anchor": "for-operators-and-investors", "title": "For operators and investors", "level": 3 }, { "id": "technical-essay-an-executable-architecture-for-heterogeneous-systems", "anchor": "technical-essay-an-executable-architecture-for-heterogeneous-systems", "title": "Technical essay: an executable architecture for heterogeneous systems", "level": 2 }, { "id": "29-decision-log", "anchor": "29-decision-log", "title": "29. Decision log", "level": 2 }, { "id": "30-immediate-repository-actions", "anchor": "30-immediate-repository-actions", "title": "30. Immediate repository actions", "level": 2 }, { "id": "31-source-map", "anchor": "31-source-map", "title": "31. Source map", "level": 2 }, { "id": "reaktor", "anchor": "reaktor", "title": "Reaktor", "level": 3 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "BestBuds", "level": 3 }, { "id": "32-related-reaktor-documents", "anchor": "32-related-reaktor-documents", "title": "32. Related Reaktor documents", "level": 2 }, { "id": "33-glossary", "anchor": "33-glossary", "title": "33. Glossary", "level": 2 }, { "id": "closing-position", "anchor": "closing-position", "title": "Closing position", "level": 2 } ], "links": [ { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "bestbuds-schema-hardening", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "32-related-reaktor-documents" } ] }, { "id": "reaktor-surface-application-extensions", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 31–33: commerce, creative software, and accessibility.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 9, "title": "Application extensions", "nav": "Application extensions", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-application-extensions", "revision": "00c5b5b732cb2085f64673bf3938425945a0b4ae5586667d03e0251eff5fe057", "status": "unverified", "renderingRevision": "d60f8b0ce7b6ab412560bd53d72634198d3de4cbc21a76de8ddd91d9870330dc", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-application-extensions", "polarity": "Neutral" }, { "id": "section-31-commerce-and-content-stable-presentation-around-authoritative-transactions", "anchor": "31-commerce-and-content-stable-presentation-around-authoritative-transactions", "label": "31. Commerce and content: stable presentation around authoritative transactions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-application-extensions#31-commerce-and-content-stable-presentation-around-authoritative-transactions", "polarity": "Neutral" }, { "id": "section-32-creative-software-a-specialized-scene-within-a-coherent-shell", "anchor": "32-creative-software-a-specialized-scene-within-a-coherent-shell", "label": "32. Creative software: a specialized scene within a coherent shell", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-application-extensions#32-creative-software-a-specialized-scene-within-a-coherent-shell", "polarity": "Neutral" }, { "id": "section-33-constrained-hosts-share-capabilities-rather-than-an-unsuitable-page", "anchor": "33-constrained-hosts-share-capabilities-rather-than-an-unsuitable-page", "label": "33. Constrained hosts: share capabilities rather than an unsuitable page", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-application-extensions#33-constrained-hosts-share-capabilities-rather-than-an-unsuitable-page", "polarity": "Neutral" } ], "relations": [] }, "content": "reaktor-surface-application-extensions.json", "sections": [ { "id": "application-extensions", "anchor": "application-extensions", "title": "Application extensions", "level": 1 }, { "id": "31-commerce-and-content-stable-presentation-around-authoritative-transactions", "anchor": "31-commerce-and-content-stable-presentation-around-authoritative-transactions", "title": "31. Commerce and content: stable presentation around authoritative transactions", "level": 2 }, { "id": "311-use-the-webs-strengths-when-the-task-is-document-oriented", "anchor": "311-use-the-webs-strengths-when-the-task-is-document-oriented", "title": "31.1 Use the web's strengths when the task is document-oriented", "level": 3 }, { "id": "312-loading-policy-is-part-of-the-design", "anchor": "312-loading-policy-is-part-of-the-design", "title": "31.2 Loading policy is part of the design", "level": 3 }, { "id": "313-feedback-must-not-overstate-transaction-success", "anchor": "313-feedback-must-not-overstate-transaction-success", "title": "31.3 Feedback must not overstate transaction success", "level": 3 }, { "id": "314-agent-assistance-remains-bounded", "anchor": "314-agent-assistance-remains-bounded", "title": "31.4 Agent assistance remains bounded", "level": 3 }, { "id": "315-qualification-combines-metrics-and-outcomes", "anchor": "315-qualification-combines-metrics-and-outcomes", "title": "31.5 Qualification combines metrics and outcomes", "level": 3 }, { "id": "32-creative-software-a-specialized-scene-within-a-coherent-shell", "anchor": "32-creative-software-a-specialized-scene-within-a-coherent-shell", "title": "32. Creative software: a specialized scene within a coherent shell", "level": 2 }, { "id": "321-keep-the-engine-expert-at-its-own-work", "anchor": "321-keep-the-engine-expert-at-its-own-work", "title": "32.1 Keep the engine expert at its own work", "level": 3 }, { "id": "322-preview-and-commit-have-different-semantics", "anchor": "322-preview-and-commit-have-different-semantics", "title": "32.2 Preview and commit have different semantics", "level": 3 }, { "id": "323-multiple-coordinate-systems-remain-aligned", "anchor": "323-multiple-coordinate-systems-remain-aligned", "title": "32.3 Multiple coordinate systems remain aligned", "level": 3 }, { "id": "324-resource-pressure-is-a-normal-operating-condition", "anchor": "324-resource-pressure-is-a-normal-operating-condition", "title": "32.4 Resource pressure is a normal operating condition", "level": 3 }, { "id": "33-constrained-hosts-share-capabilities-rather-than-an-unsuitable-page", "anchor": "33-constrained-hosts-share-capabilities-rather-than-an-unsuitable-page", "title": "33. Constrained hosts: share capabilities rather than an unsuitable page", "level": 2 }, { "id": "a-common-acceptance-model-across-application-families", "anchor": "a-common-acceptance-model-across-application-families", "title": "A common acceptance model across application families", "level": 3 } ], "links": [] }, { "id": "reaktor-surface-application-patterns", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 27–30: BestBuds, workbenches, media, and communication.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 8, "title": "Application patterns", "nav": "Application patterns", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-application-patterns", "revision": "d7f33992df1fd72ae582d4892daa27c7d49fcebb85819cd3e35a943920bc27a6", "status": "unverified", "renderingRevision": "9e509d7400d6d260dfee8b2cdc324e9befeaa0cc5a6562918970874a52f7e2ba", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-application-patterns", "polarity": "Neutral" }, { "id": "section-27-bestbuds-one-conversation-across-several-presentations", "anchor": "27-bestbuds-one-conversation-across-several-presentations", "label": "27. BestBuds: one conversation across several presentations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-application-patterns#27-bestbuds-one-conversation-across-several-presentations", "polarity": "Neutral" }, { "id": "section-28-blueprint-a-dense-workbench-around-a-specialized-canvas", "anchor": "28-blueprint-a-dense-workbench-around-a-specialized-canvas", "label": "28. Blueprint: a dense workbench around a specialized canvas", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-application-patterns#28-blueprint-a-dense-workbench-around-a-specialized-canvas", "polarity": "Neutral" }, { "id": "section-29-operational-software-an-overview-and-an-offline-field-task", "anchor": "29-operational-software-an-overview-and-an-offline-field-task", "label": "29. Operational software: an overview and an offline field task", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-application-patterns#29-operational-software-an-overview-and-an-offline-field-task", "polarity": "Neutral" }, { "id": "section-30-learning-software-explanation-beside-an-interactive-model", "anchor": "30-learning-software-explanation-beside-an-interactive-model", "label": "30. Learning software: explanation beside an interactive model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-application-patterns#30-learning-software-explanation-beside-an-interactive-model", "polarity": "Neutral" } ], "relations": [] }, "content": "reaktor-surface-application-patterns.json", "sections": [ { "id": "application-patterns", "anchor": "application-patterns", "title": "Application patterns", "level": 1 }, { "id": "27-bestbuds-one-conversation-across-several-presentations", "anchor": "27-bestbuds-one-conversation-across-several-presentations", "title": "27. BestBuds: one conversation across several presentations", "level": 2 }, { "id": "271-start-with-the-products-state-not-its-screen-size", "anchor": "271-start-with-the-products-state-not-its-screen-size", "title": "27.1 Start with the product's state, not its screen size", "level": 3 }, { "id": "272-follow-one-message-from-contact-to-outcome", "anchor": "272-follow-one-message-from-contact-to-outcome", "title": "27.2 Follow one message from contact to outcome", "level": 3 }, { "id": "273-adaptation-preserves-the-reading-task", "anchor": "273-adaptation-preserves-the-reading-task", "title": "27.3 Adaptation preserves the reading task", "level": 3 }, { "id": "274-generation-adds-a-region-not-a-competing-workflow", "anchor": "274-generation-adds-a-region-not-a-competing-workflow", "title": "27.4 Generation adds a region, not a competing workflow", "level": 3 }, { "id": "275-a-concrete-qualification-session", "anchor": "275-a-concrete-qualification-session", "title": "27.5 A concrete qualification session", "level": 3 }, { "id": "28-blueprint-a-dense-workbench-around-a-specialized-canvas", "anchor": "28-blueprint-a-dense-workbench-around-a-specialized-canvas", "title": "28. Blueprint: a dense workbench around a specialized canvas", "level": 2 }, { "id": "281-the-graph-is-the-subject-the-canvas-is-its-presentation", "anchor": "281-the-graph-is-the-subject-the-canvas-is-its-presentation", "title": "28.1 The graph is the subject; the canvas is its presentation", "level": 3 }, { "id": "282-a-drag-has-two-different-results", "anchor": "282-a-drag-has-two-different-results", "title": "28.2 A drag has two different results", "level": 3 }, { "id": "283-different-panes-have-different-resource-costs", "anchor": "283-different-panes-have-different-resource-costs", "title": "28.3 Different panes have different resource costs", "level": 3 }, { "id": "284-zoom-has-two-meanings", "anchor": "284-zoom-has-two-meanings", "title": "28.4 Zoom has two meanings", "level": 3 }, { "id": "285-human-and-agent-operations-share-the-same-authority", "anchor": "285-human-and-agent-operations-share-the-same-authority", "title": "28.5 Human and agent operations share the same authority", "level": 3 }, { "id": "29-operational-software-an-overview-and-an-offline-field-task", "anchor": "29-operational-software-an-overview-and-an-offline-field-task", "title": "29. Operational software: an overview and an offline field task", "level": 2 }, { "id": "291-one-domain-can-require-very-different-pages", "anchor": "291-one-domain-can-require-very-different-pages", "title": "29.1 One domain can require very different pages", "level": 3 }, { "id": "292-offline-recording-is-not-remote-acceptance", "anchor": "292-offline-recording-is-not-remote-acceptance", "title": "29.2 Offline recording is not remote acceptance", "level": 3 }, { "id": "293-state-conflicts-deserve-a-designed-interface", "anchor": "293-state-conflicts-deserve-a-designed-interface", "title": "29.3 State conflicts deserve a designed interface", "level": 3 }, { "id": "294-media-and-account-changes-constrain-caching", "anchor": "294-media-and-account-changes-constrain-caching", "title": "29.4 Media and account changes constrain caching", "level": 3 }, { "id": "295-deployment-profiles-and-acceptance", "anchor": "295-deployment-profiles-and-acceptance", "title": "29.5 Deployment profiles and acceptance", "level": 3 }, { "id": "30-learning-software-explanation-beside-an-interactive-model", "anchor": "30-learning-software-explanation-beside-an-interactive-model", "title": "30. Learning software: explanation beside an interactive model", "level": 2 }, { "id": "301-the-arrangement-follows-the-learning-task", "anchor": "301-the-arrangement-follows-the-learning-task", "title": "30.1 The arrangement follows the learning task", "level": 3 }, { "id": "302-distinguish-educational-physics-from-ui-physics", "anchor": "302-distinguish-educational-physics-from-ui-physics", "title": "30.2 Distinguish educational physics from UI physics", "level": 3 }, { "id": "303-accessibility-can-expose-the-models-structure", "anchor": "303-accessibility-can-expose-the-models-structure", "title": "30.3 Accessibility can expose the model's structure", "level": 3 }, { "id": "304-generated-explanation-is-content-with-an-owner", "anchor": "304-generated-explanation-is-content-with-an-owner", "title": "30.4 Generated explanation is content with an owner", "level": 3 }, { "id": "305-resource-priorities-reflect-the-task", "anchor": "305-resource-priorities-reflect-the-task", "title": "30.5 Resource priorities reflect the task", "level": 3 } ], "links": [] }, { "id": "reaktor-surface-contracts-and-interaction", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 7–10: contracts, behavior, events, interaction, and input.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 2, "title": "Contracts and interaction", "nav": "Contracts and interaction", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction", "revision": "fc1e2cd0bf0994d446332a6b9b84b8b89b533c705546ac2ecd5111789d4ad162", "status": "unverified", "renderingRevision": "dffb873ca8ebfdb0bb98c4afcb8fcff106265abad39344e34f6fd88402d96af8", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction", "polarity": "Neutral" }, { "id": "section-7-the-small-set-of-interfaces-that-holds-the-system-together", "anchor": "7-the-small-set-of-interfaces-that-holds-the-system-together", "label": "7. The small set of interfaces that holds the system together", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction#7-the-small-set-of-interfaces-that-holds-the-system-together", "polarity": "Neutral" }, { "id": "section-8-component-definitions-and-the-catalogue", "anchor": "8-component-definitions-and-the-catalogue", "label": "8. Component definitions and the catalogue", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction#8-component-definitions-and-the-catalogue", "polarity": "Neutral" }, { "id": "section-9-interaction-machines-that-do-not-depend-on-compose-or-react", "anchor": "9-interaction-machines-that-do-not-depend-on-compose-or-react", "label": "9. Interaction machines that do not depend on Compose or React", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction#9-interaction-machines-that-do-not-depend-on-compose-or-react", "polarity": "Neutral" }, { "id": "section-10-input-semantics-editing-and-accessible-operation", "anchor": "10-input-semantics-editing-and-accessible-operation", "label": "10. Input semantics, editing and accessible operation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction#10-input-semantics-editing-and-accessible-operation", "polarity": "Neutral" }, { "id": "section-95-shared-behavior-does-not-require-identical-internal-machinery", "anchor": "95-shared-behavior-does-not-require-identical-internal-machinery", "label": "9.5 Shared behavior does not require identical internal machinery", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction#95-shared-behavior-does-not-require-identical-internal-machinery", "polarity": "Neutral" }, { "id": "section-106-accessibility-policy-is-independent-of-agent-access", "anchor": "106-accessibility-policy-is-independent-of-agent-access", "label": "10.6 Accessibility policy is independent of agent access", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-contracts-and-interaction#106-accessibility-policy-is-independent-of-agent-access", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-contracts-and-interaction:references-reaktor-surface-references-ref-9", "kind": "references", "owner": "reaktor-surface-contracts-and-interaction", "incidences": [ { "node": "reaktor-surface-contracts-and-interaction", "port": "section-95-shared-behavior-does-not-require-identical-internal-machinery", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-9", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-contracts-and-interaction:references-reaktor-surface-references-ref-10", "kind": "references", "owner": "reaktor-surface-contracts-and-interaction", "incidences": [ { "node": "reaktor-surface-contracts-and-interaction", "port": "section-106-accessibility-policy-is-independent-of-agent-access", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-10", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-contracts-and-interaction.json", "sections": [ { "id": "contracts-and-interaction", "anchor": "contracts-and-interaction", "title": "Contracts and interaction", "level": 1 }, { "id": "7-the-small-set-of-interfaces-that-holds-the-system-together", "anchor": "7-the-small-set-of-interfaces-that-holds-the-system-together", "title": "7. The small set of interfaces that holds the system together", "level": 2 }, { "id": "71-an-interface-is-useful-when-it-marks-a-real-boundary", "anchor": "71-an-interface-is-useful-when-it-marks-a-real-boundary", "title": "7.1 An interface is useful when it marks a real boundary", "level": 3 }, { "id": "72-component-meaning-componentcontract", "anchor": "72-component-meaning-componentcontract", "title": "7.2 Component meaning: ComponentContract", "level": 3 }, { "id": "73-toolkit-independent-behavior-behaviorkernel", "anchor": "73-toolkit-independent-behavior-behaviorkernel", "title": "7.3 Toolkit-independent behavior: BehaviorKernel", "level": 3 }, { "id": "74-application-integration-graphbinding", "anchor": "74-application-integration-graphbinding", "title": "7.4 Application integration: GraphBinding", "level": 3 }, { "id": "75-appearance-and-arrangement", "anchor": "75-appearance-and-arrangement", "title": "7.5 Appearance and arrangement", "level": 3 }, { "id": "76-execution-and-resource-boundaries", "anchor": "76-execution-and-resource-boundaries", "title": "7.6 Execution and resource boundaries", "level": 3 }, { "id": "77-renderer-capability-and-the-portable-realization-seam", "anchor": "77-renderer-capability-and-the-portable-realization-seam", "title": "7.7 Renderer capability and the portable realization seam", "level": 3 }, { "id": "8-component-definitions-and-the-catalogue", "anchor": "8-component-definitions-and-the-catalogue", "title": "8. Component definitions and the catalogue", "level": 2 }, { "id": "81-three-different-things-are-often-called-a-schema", "anchor": "81-three-different-things-are-often-called-a-schema", "title": "8.1 Three different things are often called a schema", "level": 3 }, { "id": "82-properties-should-describe-meaning-before-presentation-mechanics", "anchor": "82-properties-should-describe-meaning-before-presentation-mechanics", "title": "8.2 Properties should describe meaning before presentation mechanics", "level": 3 }, { "id": "83-portable-values-require-explicit-representation", "anchor": "83-portable-values-require-explicit-representation", "title": "8.3 Portable values require explicit representation", "level": 3 }, { "id": "84-the-catalogue-connects-definitions-to-implementations", "anchor": "84-the-catalogue-connects-definitions-to-implementations", "title": "8.4 The catalogue connects definitions to implementations", "level": 3 }, { "id": "85-compatibility-is-behavioral", "anchor": "85-compatibility-is-behavioral", "title": "8.5 Compatibility is behavioral", "level": 3 }, { "id": "9-interaction-machines-that-do-not-depend-on-compose-or-react", "anchor": "9-interaction-machines-that-do-not-depend-on-compose-or-react", "title": "9. Interaction machines that do not depend on Compose or React", "level": 2 }, { "id": "91-why-behavior-belongs-below-the-toolkit-adapter", "anchor": "91-why-behavior-belongs-below-the-toolkit-adapter", "title": "9.1 Why behavior belongs below the toolkit adapter", "level": 3 }, { "id": "92-focus-hover-and-press-are-concurrent-axes", "anchor": "92-focus-hover-and-press-are-concurrent-axes", "title": "9.2 Focus, hover and press are concurrent axes", "level": 3 }, { "id": "93-separate-contact-tracking-from-activation", "anchor": "93-separate-contact-tracking-from-activation", "title": "9.3 Separate contact tracking from activation", "level": 3 }, { "id": "94-the-output-separates-state-events-and-cues", "anchor": "94-the-output-separates-state-events-and-cues", "title": "9.4 The output separates state, events and cues", "level": 3 }, { "id": "95-shared-behavior-does-not-require-identical-internal-machinery", "anchor": "95-shared-behavior-does-not-require-identical-internal-machinery", "title": "9.5 Shared behavior does not require identical internal machinery", "level": 3 }, { "id": "96-a-concrete-trace", "anchor": "96-a-concrete-trace", "title": "9.6 A concrete trace", "level": 3 }, { "id": "10-input-semantics-editing-and-accessible-operation", "anchor": "10-input-semantics-editing-and-accessible-operation", "title": "10. Input semantics, editing and accessible operation", "level": 2 }, { "id": "101-a-semantic-control-is-not-a-visual-layer", "anchor": "101-a-semantic-control-is-not-a-visual-layer", "title": "10.1 A semantic control is not a visual layer", "level": 3 }, { "id": "102-focus-is-a-resource-with-rules", "anchor": "102-focus-is-a-resource-with-rules", "title": "10.2 Focus is a resource with rules", "level": 3 }, { "id": "103-text-editing-needs-a-fast-local-owner", "anchor": "103-text-editing-needs-a-fast-local-owner", "title": "10.3 Text editing needs a fast local owner", "level": 3 }, { "id": "104-form-behavior-should-preserve-work-through-failure", "anchor": "104-form-behavior-should-preserve-work-through-failure", "title": "10.4 Form behavior should preserve work through failure", "level": 3 }, { "id": "105-internationalization-changes-geometry-and-semantics", "anchor": "105-internationalization-changes-geometry-and-semantics", "title": "10.5 Internationalization changes geometry and semantics", "level": 3 }, { "id": "106-accessibility-policy-is-independent-of-agent-access", "anchor": "106-accessibility-policy-is-independent-of-agent-access", "title": "10.6 Accessibility policy is independent of agent access", "level": 3 } ], "links": [ { "id": "reaktor-surface-references", "anchor": "ref-9", "relation": "references", "sourceAnchor": "95-shared-behavior-does-not-require-identical-internal-machinery" }, { "id": "reaktor-surface-references", "anchor": "ref-10", "relation": "references", "sourceAnchor": "106-accessibility-policy-is-independent-of-agent-access" } ] }, { "id": "reaktor-surface-design-and-ownership", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 11–14: atomic design, state ownership, themes, and adaptive layout.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 3, "title": "Design and ownership", "nav": "Design and ownership", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-design-and-ownership", "revision": "9e559c574392f1ef19388192c851a32c21f5e83326ea68d8e91a0bd06352417e", "status": "unverified", "renderingRevision": "8408b51864dc309e4673a29d95330cb245297de13098d3149e6ca2ca8418b0bd", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership", "polarity": "Neutral" }, { "id": "section-11-atomic-design-as-a-practical-composition-model", "anchor": "11-atomic-design-as-a-practical-composition-model", "label": "11. Atomic design as a practical composition model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#11-atomic-design-as-a-practical-composition-model", "polarity": "Neutral" }, { "id": "section-12-themes-tokens-and-interchangeable-visual-languages", "anchor": "12-themes-tokens-and-interchangeable-visual-languages", "label": "12. Themes, tokens and interchangeable visual languages", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#12-themes-tokens-and-interchangeable-visual-languages", "polarity": "Neutral" }, { "id": "section-13-graph-bindings-identity-and-lifecycle-ownership", "anchor": "13-graph-bindings-identity-and-lifecycle-ownership", "label": "13. Graph bindings, identity and lifecycle ownership", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#13-graph-bindings-identity-and-lifecycle-ownership", "polarity": "Neutral" }, { "id": "section-14-adaptive-layouts-navigation-and-coordinate-systems", "anchor": "14-adaptive-layouts-navigation-and-coordinate-systems", "label": "14. Adaptive layouts, navigation and coordinate systems", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#14-adaptive-layouts-navigation-and-coordinate-systems", "polarity": "Neutral" }, { "id": "section-111-reuse-begins-with-recognizable-responsibilities", "anchor": "111-reuse-begins-with-recognizable-responsibilities", "label": "11.1 Reuse begins with recognizable responsibilities", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#111-reuse-begins-with-recognizable-responsibilities", "polarity": "Neutral" }, { "id": "section-122-reference-tokens-semantic-roles-and-recipes", "anchor": "122-reference-tokens-semantic-roles-and-recipes", "label": "12.2 Reference tokens, semantic roles and recipes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#122-reference-tokens-semantic-roles-and-recipes", "polarity": "Neutral" }, { "id": "section-124-material-is-an-adapter-not-the-universal-model", "anchor": "124-material-is-an-adapter-not-the-universal-model", "label": "12.4 Material is an adapter, not the universal model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#124-material-is-an-adapter-not-the-universal-model", "polarity": "Neutral" }, { "id": "section-127-theme-scopes-follow-presentation-ownership", "anchor": "127-theme-scopes-follow-presentation-ownership", "label": "12.7 Theme scopes follow presentation ownership", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#127-theme-scopes-follow-presentation-ownership", "polarity": "Neutral" }, { "id": "section-128-lowering-recipes-into-each-renderer", "anchor": "128-lowering-recipes-into-each-renderer", "label": "12.8 Lowering recipes into each renderer", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#128-lowering-recipes-into-each-renderer", "polarity": "Neutral" }, { "id": "section-131-the-graph-describes-application-dependencies", "anchor": "131-the-graph-describes-application-dependencies", "label": "13.1 The graph describes application dependencies", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#131-the-graph-describes-application-dependencies", "polarity": "Neutral" }, { "id": "section-132-identity-has-several-independent-meanings", "anchor": "132-identity-has-several-independent-meanings", "label": "13.2 Identity has several independent meanings", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#132-identity-has-several-independent-meanings", "polarity": "Neutral" }, { "id": "section-133-the-same-business-object-can-be-presented-more-than-once", "anchor": "133-the-same-business-object-can-be-presented-more-than-once", "label": "13.3 The same business object can be presented more than once", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#133-the-same-business-object-can-be-presented-more-than-once", "polarity": "Neutral" }, { "id": "section-135-composition-lifetime-is-not-application-lifetime", "anchor": "135-composition-lifetime-is-not-application-lifetime", "label": "13.5 Composition lifetime is not application lifetime", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#135-composition-lifetime-is-not-application-lifetime", "polarity": "Neutral" }, { "id": "section-136-platform-lifecycle-cannot-be-flattened-completely", "anchor": "136-platform-lifecycle-cannot-be-flattened-completely", "label": "13.6 Platform lifecycle cannot be flattened completely", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#136-platform-lifecycle-cannot-be-flattened-completely", "polarity": "Neutral" }, { "id": "section-141-adaptation-begins-with-a-question-about-the-task", "anchor": "141-adaptation-begins-with-a-question-about-the-task", "label": "14.1 Adaptation begins with a question about the task", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#141-adaptation-begins-with-a-question-about-the-task", "polarity": "Neutral" }, { "id": "section-142-window-environment-and-container-constraints", "anchor": "142-window-environment-and-container-constraints", "label": "14.2 Window environment and container constraints", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#142-window-environment-and-container-constraints", "polarity": "Neutral" }, { "id": "section-144-content-determines-whether-an-arrangement-is-usable", "anchor": "144-content-determines-whether-an-arrangement-is-usable", "label": "14.4 Content determines whether an arrangement is usable", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-design-and-ownership#144-content-determines-whether-an-arrangement-is-usable", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-11", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-111-reuse-begins-with-recognizable-responsibilities", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-11", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-12", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-122-reference-tokens-semantic-roles-and-recipes", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-12", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-13", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-124-material-is-an-adapter-not-the-universal-model", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-13", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-14", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-127-theme-scopes-follow-presentation-ownership", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-14", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-15", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-128-lowering-recipes-into-each-renderer", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-15", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-6", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-131-the-graph-describes-application-dependencies", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-6", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-16", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-131-the-graph-describes-application-dependencies", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-16", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-17", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-132-identity-has-several-independent-meanings", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-17", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-18", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-132-identity-has-several-independent-meanings", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-18", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-19", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-133-the-same-business-object-can-be-presented-more-than-once", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-19", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-20", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-133-the-same-business-object-can-be-presented-more-than-once", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-20", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-21", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-135-composition-lifetime-is-not-application-lifetime", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-21", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-22", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-135-composition-lifetime-is-not-application-lifetime", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-22", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-23", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-135-composition-lifetime-is-not-application-lifetime", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-23", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-24", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-136-platform-lifecycle-cannot-be-flattened-completely", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-24", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-25", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-136-platform-lifecycle-cannot-be-flattened-completely", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-25", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-2", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-141-adaptation-begins-with-a-question-about-the-task", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-2", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-26", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-142-window-environment-and-container-constraints", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-26", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-design-and-ownership:references-reaktor-surface-references-ref-27", "kind": "references", "owner": "reaktor-surface-design-and-ownership", "incidences": [ { "node": "reaktor-surface-design-and-ownership", "port": "section-144-content-determines-whether-an-arrangement-is-usable", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-27", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-design-and-ownership.json", "sections": [ { "id": "design-and-ownership", "anchor": "design-and-ownership", "title": "Design and ownership", "level": 1 }, { "id": "11-atomic-design-as-a-practical-composition-model", "anchor": "11-atomic-design-as-a-practical-composition-model", "title": "11. Atomic design as a practical composition model", "level": 2 }, { "id": "111-reuse-begins-with-recognizable-responsibilities", "anchor": "111-reuse-begins-with-recognizable-responsibilities", "title": "11.1 Reuse begins with recognizable responsibilities", "level": 3 }, { "id": "112-product-meaning-belongs-at-the-appropriate-level", "anchor": "112-product-meaning-belongs-at-the-appropriate-level", "title": "11.2 Product meaning belongs at the appropriate level", "level": 3 }, { "id": "113-slots-express-composition-intent", "anchor": "113-slots-express-composition-intent", "title": "11.3 Slots express composition intent", "level": 3 }, { "id": "114-compound-controls-need-explicit-shared-state", "anchor": "114-compound-controls-need-explicit-shared-state", "title": "11.4 Compound controls need explicit shared state", "level": 3 }, { "id": "115-avoid-abstractions-that-hide-the-page", "anchor": "115-avoid-abstractions-that-hide-the-page", "title": "11.5 Avoid abstractions that hide the page", "level": 3 }, { "id": "116-the-catalogue-becomes-more-useful-to-agents-at-higher-levels", "anchor": "116-the-catalogue-becomes-more-useful-to-agents-at-higher-levels", "title": "11.6 The catalogue becomes more useful to agents at higher levels", "level": 3 }, { "id": "12-themes-tokens-and-interchangeable-visual-languages", "anchor": "12-themes-tokens-and-interchangeable-visual-languages", "title": "12. Themes, tokens and interchangeable visual languages", "level": 2 }, { "id": "121-a-palette-is-only-one-part-of-a-theme", "anchor": "121-a-palette-is-only-one-part-of-a-theme", "title": "12.1 A palette is only one part of a theme", "level": 3 }, { "id": "122-reference-tokens-semantic-roles-and-recipes", "anchor": "122-reference-tokens-semantic-roles-and-recipes", "title": "12.2 Reference tokens, semantic roles and recipes", "level": 3 }, { "id": "123-a-resolved-theme-is-a-coherent-snapshot", "anchor": "123-a-resolved-theme-is-a-coherent-snapshot", "title": "12.3 A resolved theme is a coherent snapshot", "level": 3 }, { "id": "124-material-is-an-adapter-not-the-universal-model", "anchor": "124-material-is-an-adapter-not-the-universal-model", "title": "12.4 Material is an adapter, not the universal model", "level": 3 }, { "id": "125-six-languages-one-semantic-action", "anchor": "125-six-languages-one-semantic-action", "title": "12.5 Six languages, one semantic action", "level": 3 }, { "id": "126-data-only-theme-switching-versus-structural-replacement", "anchor": "126-data-only-theme-switching-versus-structural-replacement", "title": "12.6 Data-only theme switching versus structural replacement", "level": 3 }, { "id": "127-theme-scopes-follow-presentation-ownership", "anchor": "127-theme-scopes-follow-presentation-ownership", "title": "12.7 Theme scopes follow presentation ownership", "level": 3 }, { "id": "128-lowering-recipes-into-each-renderer", "anchor": "128-lowering-recipes-into-each-renderer", "title": "12.8 Lowering recipes into each renderer", "level": 3 }, { "id": "13-graph-bindings-identity-and-lifecycle-ownership", "anchor": "13-graph-bindings-identity-and-lifecycle-ownership", "title": "13. Graph bindings, identity and lifecycle ownership", "level": 2 }, { "id": "131-the-graph-describes-application-dependencies", "anchor": "131-the-graph-describes-application-dependencies", "title": "13.1 The graph describes application dependencies", "level": 3 }, { "id": "132-identity-has-several-independent-meanings", "anchor": "132-identity-has-several-independent-meanings", "title": "13.2 Identity has several independent meanings", "level": 3 }, { "id": "133-the-same-business-object-can-be-presented-more-than-once", "anchor": "133-the-same-business-object-can-be-presented-more-than-once", "title": "13.3 The same business object can be presented more than once", "level": 3 }, { "id": "134-existence-visibility-focus-and-interactivity-are-distinct", "anchor": "134-existence-visibility-focus-and-interactivity-are-distinct", "title": "13.4 Existence, visibility, focus and interactivity are distinct", "level": 3 }, { "id": "135-composition-lifetime-is-not-application-lifetime", "anchor": "135-composition-lifetime-is-not-application-lifetime", "title": "13.5 Composition lifetime is not application lifetime", "level": 3 }, { "id": "136-platform-lifecycle-cannot-be-flattened-completely", "anchor": "136-platform-lifecycle-cannot-be-flattened-completely", "title": "13.6 Platform lifecycle cannot be flattened completely", "level": 3 }, { "id": "137-resource-leases-make-cleanup-explicit", "anchor": "137-resource-leases-make-cleanup-explicit", "title": "13.7 Resource leases make cleanup explicit", "level": 3 }, { "id": "14-adaptive-layouts-navigation-and-coordinate-systems", "anchor": "14-adaptive-layouts-navigation-and-coordinate-systems", "title": "14. Adaptive layouts, navigation and coordinate systems", "level": 2 }, { "id": "141-adaptation-begins-with-a-question-about-the-task", "anchor": "141-adaptation-begins-with-a-question-about-the-task", "title": "14.1 Adaptation begins with a question about the task", "level": 3 }, { "id": "142-window-environment-and-container-constraints", "anchor": "142-window-environment-and-container-constraints", "title": "14.2 Window environment and container constraints", "level": 3 }, { "id": "143-a-pure-policy-chooses-a-presentation-plan", "anchor": "143-a-pure-policy-chooses-a-presentation-plan", "title": "14.3 A pure policy chooses a presentation plan", "level": 3 }, { "id": "144-content-determines-whether-an-arrangement-is-usable", "anchor": "144-content-determines-whether-an-arrangement-is-usable", "title": "14.4 Content determines whether an arrangement is usable", "level": 3 }, { "id": "145-back-navigation-and-dismissal-need-explicit-priority", "anchor": "145-back-navigation-and-dismissal-need-explicit-priority", "title": "14.5 Back navigation and dismissal need explicit priority", "level": 3 }, { "id": "146-ui-scale-text-scale-density-and-canvas-zoom", "anchor": "146-ui-scale-text-scale-density-and-canvas-zoom", "title": "14.6 UI scale, text scale, density and canvas zoom", "level": 3 }, { "id": "147-layout-stability-is-a-contract-for-asynchronous-content", "anchor": "147-layout-stability-is-a-contract-for-asynchronous-content", "title": "14.7 Layout stability is a contract for asynchronous content", "level": 3 } ], "links": [ { "id": "reaktor-surface-references", "anchor": "ref-11", "relation": "references", "sourceAnchor": "111-reuse-begins-with-recognizable-responsibilities" }, { "id": "reaktor-surface-references", "anchor": "ref-12", "relation": "references", "sourceAnchor": "122-reference-tokens-semantic-roles-and-recipes" }, { "id": "reaktor-surface-references", "anchor": "ref-13", "relation": "references", "sourceAnchor": "124-material-is-an-adapter-not-the-universal-model" }, { "id": "reaktor-surface-references", "anchor": "ref-14", "relation": "references", "sourceAnchor": "127-theme-scopes-follow-presentation-ownership" }, { "id": "reaktor-surface-references", "anchor": "ref-15", "relation": "references", "sourceAnchor": "128-lowering-recipes-into-each-renderer" }, { "id": "reaktor-surface-references", "anchor": "ref-6", "relation": "references", "sourceAnchor": "131-the-graph-describes-application-dependencies" }, { "id": "reaktor-surface-references", "anchor": "ref-16", "relation": "references", "sourceAnchor": "131-the-graph-describes-application-dependencies" }, { "id": "reaktor-surface-references", "anchor": "ref-17", "relation": "references", "sourceAnchor": "132-identity-has-several-independent-meanings" }, { "id": "reaktor-surface-references", "anchor": "ref-18", "relation": "references", "sourceAnchor": "132-identity-has-several-independent-meanings" }, { "id": "reaktor-surface-references", "anchor": "ref-19", "relation": "references", "sourceAnchor": "133-the-same-business-object-can-be-presented-more-than-once" }, { "id": "reaktor-surface-references", "anchor": "ref-20", "relation": "references", "sourceAnchor": "133-the-same-business-object-can-be-presented-more-than-once" }, { "id": "reaktor-surface-references", "anchor": "ref-21", "relation": "references", "sourceAnchor": "135-composition-lifetime-is-not-application-lifetime" }, { "id": "reaktor-surface-references", "anchor": "ref-22", "relation": "references", "sourceAnchor": "135-composition-lifetime-is-not-application-lifetime" }, { "id": "reaktor-surface-references", "anchor": "ref-23", "relation": "references", "sourceAnchor": "135-composition-lifetime-is-not-application-lifetime" }, { "id": "reaktor-surface-references", "anchor": "ref-24", "relation": "references", "sourceAnchor": "136-platform-lifecycle-cannot-be-flattened-completely" }, { "id": "reaktor-surface-references", "anchor": "ref-25", "relation": "references", "sourceAnchor": "136-platform-lifecycle-cannot-be-flattened-completely" }, { "id": "reaktor-surface-references", "anchor": "ref-2", "relation": "references", "sourceAnchor": "141-adaptation-begins-with-a-question-about-the-task" }, { "id": "reaktor-surface-references", "anchor": "ref-26", "relation": "references", "sourceAnchor": "142-window-environment-and-container-constraints" }, { "id": "reaktor-surface-references", "anchor": "ref-27", "relation": "references", "sourceAnchor": "144-content-determines-whether-an-arrangement-is-usable" } ] }, { "id": "reaktor-surface-desktop", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 35–37: focus, keys, overlays, menus, commands, density and cost, then collections, panes, tab sets, notices and islands on the desktop.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 11, "title": "Desktop", "nav": "Desktop", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-desktop", "revision": "4dd2ce5a4fb75654342cb4371096e9fecbb5762b527f2a2c3a31efb5596ef3ff", "status": "unverified", "renderingRevision": "ae90c4e5ff5274bd01aaf4842e729dbbfc89a13c7ca7babc8bb8bf7055e81f8a", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-desktop", "polarity": "Neutral" }, { "id": "section-35-the-desktop-window-focus-keys-and-overlays", "anchor": "35-the-desktop-window-focus-keys-and-overlays", "label": "35. The desktop window: focus, keys and overlays", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-desktop#35-the-desktop-window-focus-keys-and-overlays", "polarity": "Neutral" }, { "id": "section-36-commands-density-and-cost-on-the-desktop", "anchor": "36-commands-density-and-cost-on-the-desktop", "label": "36. Commands, density and cost on the desktop", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-desktop#36-commands-density-and-cost-on-the-desktop", "polarity": "Neutral" }, { "id": "section-37-collections-panes-and-engines", "anchor": "37-collections-panes-and-engines", "label": "37. Collections, panes and engines", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-desktop#37-collections-panes-and-engines", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-desktop:references-hangar", "kind": "references", "owner": "reaktor-surface-desktop", "incidences": [ { "node": "reaktor-surface-desktop", "port": "section-35-the-desktop-window-focus-keys-and-overlays", "role": "source", "ordinal": 0 }, { "node": "hangar", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-desktop.json", "sections": [ { "id": "desktop", "anchor": "desktop", "title": "Desktop", "level": 1 }, { "id": "35-the-desktop-window-focus-keys-and-overlays", "anchor": "35-the-desktop-window-focus-keys-and-overlays", "title": "35. The desktop window: focus, keys and overlays", "level": 2 }, { "id": "351-a-window-has-one-focus-owner-and-one-cursor", "anchor": "351-a-window-has-one-focus-owner-and-one-cursor", "title": "35.1 A window has one focus owner and one cursor", "level": 3 }, { "id": "352-keys-are-portable-values", "anchor": "352-keys-are-portable-values", "title": "35.2 Keys are portable values", "level": 3 }, { "id": "353-a-group-is-one-tab-stop", "anchor": "353-a-group-is-one-tab-stop", "title": "35.3 A group is one Tab stop", "level": 3 }, { "id": "354-a-modal-holds-focus-and-every-overlay-gives-it-back", "anchor": "354-a-modal-holds-focus-and-every-overlay-gives-it-back", "title": "35.4 A modal holds focus, and every overlay gives it back", "level": 3 }, { "id": "355-escape-follows-focus", "anchor": "355-escape-follows-focus", "title": "35.5 Escape follows focus", "level": 3 }, { "id": "356-menus-are-built-from-the-same-kernels", "anchor": "356-menus-are-built-from-the-same-kernels", "title": "35.6 Menus are built from the same kernels", "level": 3 }, { "id": "357-placement-is-a-pure-function", "anchor": "357-placement-is-a-pure-function", "title": "35.7 Placement is a pure function", "level": 3 }, { "id": "358-tooltips-and-popovers", "anchor": "358-tooltips-and-popovers", "title": "35.8 Tooltips and popovers", "level": 3 }, { "id": "36-commands-density-and-cost-on-the-desktop", "anchor": "36-commands-density-and-cost-on-the-desktop", "title": "36. Commands, density and cost on the desktop", "level": 2 }, { "id": "361-a-command-is-data", "anchor": "361-a-command-is-data", "title": "36.1 A command is data", "level": 3 }, { "id": "362-commands-follow-focus", "anchor": "362-commands-follow-focus", "title": "36.2 Commands follow focus", "level": 3 }, { "id": "363-menus-and-menu-bars-draw-from-the-same-data", "anchor": "363-menus-and-menu-bars-draw-from-the-same-data", "title": "36.3 Menus and menu bars draw from the same data", "level": 3 }, { "id": "364-density-is-a-theme-dimension", "anchor": "364-density-is-a-theme-dimension", "title": "36.4 Density is a theme dimension", "level": 3 }, { "id": "365-what-a-control-costs-at-rest", "anchor": "365-what-a-control-costs-at-rest", "title": "36.5 What a control costs at rest", "level": 3 }, { "id": "366-the-hangar-shell", "anchor": "366-the-hangar-shell", "title": "36.6 The Hangar shell", "level": 3 }, { "id": "37-collections-panes-and-engines", "anchor": "37-collections-panes-and-engines", "title": "37. Collections, panes and engines", "level": 2 }, { "id": "371-a-collection-runs-one-machine-not-one-per-row", "anchor": "371-a-collection-runs-one-machine-not-one-per-row", "title": "37.1 A collection runs one machine, not one per row", "level": 3 }, { "id": "372-a-table-adds-a-header-and-columns", "anchor": "372-a-table-adds-a-header-and-columns", "title": "37.2 A table adds a header and columns", "level": 3 }, { "id": "373-one-menu-per-collection", "anchor": "373-one-menu-per-collection", "title": "37.3 One menu per collection", "level": 3 }, { "id": "374-a-pane-plans-from-its-own-space", "anchor": "374-a-pane-plans-from-its-own-space", "title": "37.4 A pane plans from its own space", "level": 3 }, { "id": "375-a-tab-set-manages-documents", "anchor": "375-a-tab-set-manages-documents", "title": "37.5 A tab set manages documents", "level": 3 }, { "id": "376-notices-state-views-busy-regions-and-toasts", "anchor": "376-notices-state-views-busy-regions-and-toasts", "title": "37.6 Notices: state views, busy regions and toasts", "level": 3 }, { "id": "377-an-island-is-the-boundary-around-an-engine", "anchor": "377-an-island-is-the-boundary-around-an-engine", "title": "37.7 An island is the boundary around an engine", "level": 3 }, { "id": "378-every-part-has-an-id-and-every-story-qualifies", "anchor": "378-every-part-has-an-id-and-every-story-qualifies", "title": "37.8 Every part has an id, and every story qualifies", "level": 3 }, { "id": "379-container-sizes", "anchor": "379-container-sizes", "title": "37.9 Container sizes", "level": 3 }, { "id": "379-hangars-shared-pane-compositions", "anchor": "379-hangars-shared-pane-compositions", "title": "37.9 Hangar's shared pane compositions", "level": 3 } ], "links": [ { "id": "hangar", "anchor": "", "relation": "references", "sourceAnchor": "35-the-desktop-window-focus-keys-and-overlays" } ] }, { "id": "reaktor-surface-dynamic-ui-and-verification", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 24–26: graph updates, specialized interfaces, and verification.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 7, "title": "Dynamic UI and verification", "nav": "Dynamic UI and verification", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-dynamic-ui-and-verification", "revision": "d06b9adcaa40c835e0c0501b2fed674d1b632b4d860bf2f15569596ae73d4d3e", "status": "unverified", "renderingRevision": "8361ac876b4917297c1d16d3c0de98eba0d6ce09cb4a4459f093f32fcadabacc", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-dynamic-ui-and-verification", "polarity": "Neutral" }, { "id": "section-24-dynamic-ui-through-graph-updates", "anchor": "24-dynamic-ui-through-graph-updates", "label": "24. Dynamic UI through graph updates", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-dynamic-ui-and-verification#24-dynamic-ui-through-graph-updates", "polarity": "Neutral" }, { "id": "section-25-custom-interfaces-and-specialized-engines", "anchor": "25-custom-interfaces-and-specialized-engines", "label": "25. Custom interfaces and specialized engines", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-dynamic-ui-and-verification#25-custom-interfaces-and-specialized-engines", "polarity": "Neutral" }, { "id": "section-26-verification-and-implementation-boundaries", "anchor": "26-verification-and-implementation-boundaries", "label": "26. Verification and implementation boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-dynamic-ui-and-verification#26-verification-and-implementation-boundaries", "polarity": "Neutral" }, { "id": "section-264-keep-dependency-direction-acyclic", "anchor": "264-keep-dependency-direction-acyclic", "label": "26.4 Keep dependency direction acyclic", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-dynamic-ui-and-verification#264-keep-dependency-direction-acyclic", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-dynamic-ui-and-verification:references-reaktor-surface-references-ref-51", "kind": "references", "owner": "reaktor-surface-dynamic-ui-and-verification", "incidences": [ { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "section-264-keep-dependency-direction-acyclic", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-51", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-dynamic-ui-and-verification:references-reaktor-surface-references-ref-52", "kind": "references", "owner": "reaktor-surface-dynamic-ui-and-verification", "incidences": [ { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "section-264-keep-dependency-direction-acyclic", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-52", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-dynamic-ui-and-verification.json", "sections": [ { "id": "dynamic-ui-and-verification", "anchor": "dynamic-ui-and-verification", "title": "Dynamic UI and verification", "level": 1 }, { "id": "24-dynamic-ui-through-graph-updates", "anchor": "24-dynamic-ui-through-graph-updates", "title": "24. Dynamic UI through graph updates", "level": 2 }, { "id": "241-the-update-mechanism-is-outside-surface", "anchor": "241-the-update-mechanism-is-outside-surface", "title": "24.1 The update mechanism is outside Surface", "level": 3 }, { "id": "242-three-kinds-of-change-remain-different", "anchor": "242-three-kinds-of-change-remain-different", "title": "24.2 Three kinds of change remain different", "level": 3 }, { "id": "243-a-generated-region-is-still-graph-owned", "anchor": "243-a-generated-region-is-still-graph-owned", "title": "24.3 A generated region is still graph-owned", "level": 3 }, { "id": "244-protect-the-interaction-already-in-progress", "anchor": "244-protect-the-interaction-already-in-progress", "title": "24.4 Protect the interaction already in progress", "level": 3 }, { "id": "245-authorization-remains-at-the-application-operation", "anchor": "245-authorization-remains-at-the-application-operation", "title": "24.5 Authorization remains at the application operation", "level": 3 }, { "id": "25-custom-interfaces-and-specialized-engines", "anchor": "25-custom-interfaces-and-specialized-engines", "title": "25. Custom interfaces and specialized engines", "level": 2 }, { "id": "251-not-every-interface-should-be-built-from-ordinary-boxes", "anchor": "251-not-every-interface-should-be-built-from-ordinary-boxes", "title": "25.1 Not every interface should be built from ordinary boxes", "level": 3 }, { "id": "252-the-extension-contract-describes-the-boundary", "anchor": "252-the-extension-contract-describes-the-boundary", "title": "25.2 The extension contract describes the boundary", "level": 3 }, { "id": "253-distinguish-document-change-from-presentation-change", "anchor": "253-distinguish-document-change-from-presentation-change", "title": "25.3 Distinguish document change from presentation change", "level": 3 }, { "id": "254-semantic-operation-enables-more-than-agents", "anchor": "254-semantic-operation-enables-more-than-agents", "title": "25.4 Semantic operation enables more than agents", "level": 3 }, { "id": "26-verification-and-implementation-boundaries", "anchor": "26-verification-and-implementation-boundaries", "title": "26. Verification and implementation boundaries", "level": 2 }, { "id": "261-test-the-contract-at-several-levels", "anchor": "261-test-the-contract-at-several-levels", "title": "26.1 Test the contract at several levels", "level": 3 }, { "id": "262-preserve-reference-paths-for-optimizations", "anchor": "262-preserve-reference-paths-for-optimizations", "title": "26.2 Preserve reference paths for optimizations", "level": 3 }, { "id": "263-use-real-failure-scenarios", "anchor": "263-use-real-failure-scenarios", "title": "26.3 Use real failure scenarios", "level": 3 }, { "id": "264-keep-dependency-direction-acyclic", "anchor": "264-keep-dependency-direction-acyclic", "title": "26.4 Keep dependency direction acyclic", "level": 3 }, { "id": "265-the-release-criterion-is-a-supported-combination", "anchor": "265-the-release-criterion-is-a-supported-combination", "title": "26.5 The release criterion is a supported combination", "level": 3 } ], "links": [ { "id": "reaktor-surface-references", "anchor": "ref-51", "relation": "references", "sourceAnchor": "264-keep-dependency-direction-acyclic" }, { "id": "reaktor-surface-references", "anchor": "ref-52", "relation": "references", "sourceAnchor": "264-keep-dependency-direction-acyclic" } ] }, { "id": "reaktor-surface-foundations", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 1–6: interface challenges, concepts, architecture, platforms, and a Send action.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 1, "title": "Foundations", "nav": "Foundations", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-foundations", "revision": "4c21d487cea7f9c78d48fb5415e8704ba34e427095652fd0ffeafd72f5b46314", "status": "unverified", "renderingRevision": "ad31122eccef46260ae54bc367f11980e634595e045a70de430925ea75441948", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-foundations", "polarity": "Neutral" }, { "id": "section-1-why-contemporary-interfaces-become-difficult-to-maintain", "anchor": "1-why-contemporary-interfaces-become-difficult-to-maintain", "label": "1. Why contemporary interfaces become difficult to maintain", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#1-why-contemporary-interfaces-become-difficult-to-maintain", "polarity": "Neutral" }, { "id": "section-2-the-concepts-that-connect-application-meaning-to-pixels", "anchor": "2-the-concepts-that-connect-application-meaning-to-pixels", "label": "2. The concepts that connect application meaning to pixels", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#2-the-concepts-that-connect-application-meaning-to-pixels", "polarity": "Neutral" }, { "id": "section-3-the-load-bearing-ideas", "anchor": "3-the-load-bearing-ideas", "label": "3. The load-bearing ideas", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#3-the-load-bearing-ideas", "polarity": "Neutral" }, { "id": "section-4-high-level-architecture", "anchor": "4-high-level-architecture", "label": "4. High-level architecture", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#4-high-level-architecture", "polarity": "Neutral" }, { "id": "section-5-platforms-composition-languages-and-rendering-families", "anchor": "5-platforms-composition-languages-and-rendering-families", "label": "5. Platforms, composition languages and rendering families", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#5-platforms-composition-languages-and-rendering-families", "polarity": "Neutral" }, { "id": "section-6-a-worked-example-one-send-action-through-the-whole-system", "anchor": "6-a-worked-example-one-send-action-through-the-whole-system", "label": "6. A worked example: one Send action through the whole system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#6-a-worked-example-one-send-action-through-the-whole-system", "polarity": "Neutral" }, { "id": "section-12-a-visual-component-is-often-less-complete-than-it-appears", "anchor": "12-a-visual-component-is-often-less-complete-than-it-appears", "label": "1.2 A visual component is often less complete than it appears", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#12-a-visual-component-is-often-less-complete-than-it-appears", "polarity": "Neutral" }, { "id": "section-14-adaptation-has-become-more-than-a-few-screen-width-breakpoints", "anchor": "14-adaptation-has-become-more-than-a-few-screen-width-breakpoints", "label": "1.4 Adaptation has become more than a few screen-width breakpoints", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#14-adaptation-has-become-more-than-a-few-screen-width-breakpoints", "polarity": "Neutral" }, { "id": "section-22-composition-chooses-the-interfaces-structure", "anchor": "22-composition-chooses-the-interfaces-structure", "label": "2.2 Composition chooses the interface's structure", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#22-composition-chooses-the-interfaces-structure", "polarity": "Neutral" }, { "id": "section-26-a-graph-makes-relationships-explicit", "anchor": "26-a-graph-makes-relationships-explicit", "label": "2.6 A graph makes relationships explicit", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#26-a-graph-makes-relationships-explicit", "polarity": "Neutral" }, { "id": "section-43-the-renderer-owns-platform-realization", "anchor": "43-the-renderer-owns-platform-realization", "label": "4.3 The renderer owns platform realization", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#43-the-renderer-owns-platform-realization", "polarity": "Neutral" }, { "id": "section-51-two-terminal-families", "anchor": "51-two-terminal-families", "label": "5.1 Two terminal families", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-foundations#51-two-terminal-families", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-1", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-12-a-visual-component-is-often-less-complete-than-it-appears", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-1", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-2", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-14-adaptation-has-become-more-than-a-few-screen-width-breakpoints", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-2", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-3", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-14-adaptation-has-become-more-than-a-few-screen-width-breakpoints", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-3", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-4", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-22-composition-chooses-the-interfaces-structure", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-4", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-5", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-22-composition-chooses-the-interfaces-structure", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-5", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-6", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-26-a-graph-makes-relationships-explicit", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-6", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-7", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-43-the-renderer-owns-platform-realization", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-7", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-foundations:references-reaktor-surface-references-ref-8", "kind": "references", "owner": "reaktor-surface-foundations", "incidences": [ { "node": "reaktor-surface-foundations", "port": "section-51-two-terminal-families", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-8", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-foundations.json", "sections": [ { "id": "foundations", "anchor": "foundations", "title": "Foundations", "level": 1 }, { "id": "1-why-contemporary-interfaces-become-difficult-to-maintain", "anchor": "1-why-contemporary-interfaces-become-difficult-to-maintain", "title": "1. Why contemporary interfaces become difficult to maintain", "level": 2 }, { "id": "11-a-small-visual-change-can-expose-a-large-architectural-problem", "anchor": "11-a-small-visual-change-can-expose-a-large-architectural-problem", "title": "1.1 A small visual change can expose a large architectural problem", "level": 3 }, { "id": "12-a-visual-component-is-often-less-complete-than-it-appears", "anchor": "12-a-visual-component-is-often-less-complete-than-it-appears", "title": "1.2 A visual component is often less complete than it appears", "level": 3 }, { "id": "13-cross-platform-reuse-is-not-the-same-as-identical-rendering", "anchor": "13-cross-platform-reuse-is-not-the-same-as-identical-rendering", "title": "1.3 Cross-platform reuse is not the same as identical rendering", "level": 3 }, { "id": "14-adaptation-has-become-more-than-a-few-screen-width-breakpoints", "anchor": "14-adaptation-has-become-more-than-a-few-screen-width-breakpoints", "title": "1.4 Adaptation has become more than a few screen-width breakpoints", "level": 3 }, { "id": "15-responsiveness-involves-time-as-well-as-geometry", "anchor": "15-responsiveness-involves-time-as-well-as-geometry", "title": "1.5 Responsiveness involves time as well as geometry", "level": 3 }, { "id": "16-generative-interfaces-increase-the-cost-of-unclear-boundaries", "anchor": "16-generative-interfaces-increase-the-cost-of-unclear-boundaries", "title": "1.6 Generative interfaces increase the cost of unclear boundaries", "level": 3 }, { "id": "17-recognize-the-kind-of-failure-before-choosing-the-remedy", "anchor": "17-recognize-the-kind-of-failure-before-choosing-the-remedy", "title": "1.7 Recognize the kind of failure before choosing the remedy", "level": 3 }, { "id": "2-the-concepts-that-connect-application-meaning-to-pixels", "anchor": "2-the-concepts-that-connect-application-meaning-to-pixels", "title": "2. The concepts that connect application meaning to pixels", "level": 2 }, { "id": "21-state-events-and-the-difference-between-them", "anchor": "21-state-events-and-the-difference-between-them", "title": "2.1 State, events and the difference between them", "level": 3 }, { "id": "22-composition-chooses-the-interfaces-structure", "anchor": "22-composition-chooses-the-interfaces-structure", "title": "2.2 Composition chooses the interface's structure", "level": 3 }, { "id": "23-layout-assigns-space-drawing-realizes-appearance", "anchor": "23-layout-assigns-space-drawing-realizes-appearance", "title": "2.3 Layout assigns space; drawing realizes appearance", "level": 3 }, { "id": "24-a-design-system-supplies-decisions-not-only-components", "anchor": "24-a-design-system-supplies-decisions-not-only-components", "title": "2.4 A design system supplies decisions, not only components", "level": 3 }, { "id": "25-a-lifecycle-describes-an-owners-existence", "anchor": "25-a-lifecycle-describes-an-owners-existence", "title": "2.5 A lifecycle describes an owner's existence", "level": 3 }, { "id": "26-a-graph-makes-relationships-explicit", "anchor": "26-a-graph-makes-relationships-explicit", "title": "2.6 A graph makes relationships explicit", "level": 3 }, { "id": "27-contracts-are-promises-implementations-are-mechanisms", "anchor": "27-contracts-are-promises-implementations-are-mechanisms", "title": "2.7 Contracts are promises; implementations are mechanisms", "level": 3 }, { "id": "3-the-load-bearing-ideas", "anchor": "3-the-load-bearing-ideas", "title": "3. The load-bearing ideas", "level": 2 }, { "id": "31-share-meaning-adapt-realization", "anchor": "31-share-meaning-adapt-realization", "title": "3.1 Share meaning; adapt realization", "level": 3 }, { "id": "32-give-each-structure-and-state-an-owner", "anchor": "32-give-each-structure-and-state-an-owner", "title": "3.2 Give each structure and state an owner", "level": 3 }, { "id": "33-keep-the-fast-feedback-loop-local", "anchor": "33-keep-the-fast-feedback-loop-local", "title": "3.3 Keep the fast feedback loop local", "level": 3 }, { "id": "34-treat-adaptation-as-a-projection-of-existing-state", "anchor": "34-treat-adaptation-as-a-projection-of-existing-state", "title": "3.4 Treat adaptation as a projection of existing state", "level": 3 }, { "id": "35-make-tactility-causal-and-bounded", "anchor": "35-make-tactility-causal-and-bounded", "title": "3.5 Make tactility causal and bounded", "level": 3 }, { "id": "36-define-dynamic-ui-as-graph-owned-change", "anchor": "36-define-dynamic-ui-as-graph-owned-change", "title": "3.6 Define dynamic UI as graph-owned change", "level": 3 }, { "id": "4-high-level-architecture", "anchor": "4-high-level-architecture", "title": "4. High-level architecture", "level": 2 }, { "id": "41-the-graph-is-the-application-foundation", "anchor": "41-the-graph-is-the-application-foundation", "title": "4.1 The graph is the application foundation", "level": 3 }, { "id": "42-surface-owns-presentation-contracts", "anchor": "42-surface-owns-presentation-contracts", "title": "4.2 Surface owns presentation contracts", "level": 3 }, { "id": "43-the-renderer-owns-platform-realization", "anchor": "43-the-renderer-owns-platform-realization", "title": "4.3 The renderer owns platform realization", "level": 3 }, { "id": "44-different-representations-answer-different-questions", "anchor": "44-different-representations-answer-different-questions", "title": "4.4 Different representations answer different questions", "level": 3 }, { "id": "45-compile-decisions-that-do-not-need-to-remain-dynamic", "anchor": "45-compile-decisions-that-do-not-need-to-remain-dynamic", "title": "4.5 Compile decisions that do not need to remain dynamic", "level": 3 }, { "id": "46-read-the-architecture-through-one-change", "anchor": "46-read-the-architecture-through-one-change", "title": "4.6 Read the architecture through one change", "level": 3 }, { "id": "5-platforms-composition-languages-and-rendering-families", "anchor": "5-platforms-composition-languages-and-rendering-families", "title": "5. Platforms, composition languages and rendering families", "level": 2 }, { "id": "51-two-terminal-families", "anchor": "51-two-terminal-families", "title": "5.1 Two terminal families", "level": 3 }, { "id": "52-authoring-and-realization-are-separate-choices", "anchor": "52-authoring-and-realization-are-separate-choices", "title": "5.2 Authoring and realization are separate choices", "level": 3 }, { "id": "53-portable-composition-is-an-explicit-vocabulary", "anchor": "53-portable-composition-is-an-explicit-vocabulary", "title": "5.3 Portable composition is an explicit vocabulary", "level": 3 }, { "id": "54-platform-differences-should-be-explained-at-the-boundary", "anchor": "54-platform-differences-should-be-explained-at-the-boundary", "title": "5.4 Platform differences should be explained at the boundary", "level": 3 }, { "id": "55-portability-has-a-useful-floor-and-explicit-extensions", "anchor": "55-portability-has-a-useful-floor-and-explicit-extensions", "title": "5.5 Portability has a useful floor and explicit extensions", "level": 3 }, { "id": "6-a-worked-example-one-send-action-through-the-whole-system", "anchor": "6-a-worked-example-one-send-action-through-the-whole-system", "title": "6. A worked example: one Send action through the whole system", "level": 2 }, { "id": "61-before-interaction", "anchor": "61-before-interaction", "title": "6.1 Before interaction", "level": 3 }, { "id": "62-contact-begins", "anchor": "62-contact-begins", "title": "6.2 Contact begins", "level": 3 }, { "id": "63-activation-is-admitted", "anchor": "63-activation-is-admitted", "title": "6.3 Activation is admitted", "level": 3 }, { "id": "64-the-layout-changes-during-the-operation", "anchor": "64-the-layout-changes-during-the-operation", "title": "6.4 The layout changes during the operation", "level": 3 }, { "id": "65-why-this-example-is-the-architectural-test", "anchor": "65-why-this-example-is-the-architectural-test", "title": "6.5 Why this example is the architectural test", "level": 3 } ], "links": [ { "id": "reaktor-surface-references", "anchor": "ref-1", "relation": "references", "sourceAnchor": "12-a-visual-component-is-often-less-complete-than-it-appears" }, { "id": "reaktor-surface-references", "anchor": "ref-2", "relation": "references", "sourceAnchor": "14-adaptation-has-become-more-than-a-few-screen-width-breakpoints" }, { "id": "reaktor-surface-references", "anchor": "ref-3", "relation": "references", "sourceAnchor": "14-adaptation-has-become-more-than-a-few-screen-width-breakpoints" }, { "id": "reaktor-surface-references", "anchor": "ref-4", "relation": "references", "sourceAnchor": "22-composition-chooses-the-interfaces-structure" }, { "id": "reaktor-surface-references", "anchor": "ref-5", "relation": "references", "sourceAnchor": "22-composition-chooses-the-interfaces-structure" }, { "id": "reaktor-surface-references", "anchor": "ref-6", "relation": "references", "sourceAnchor": "26-a-graph-makes-relationships-explicit" }, { "id": "reaktor-surface-references", "anchor": "ref-7", "relation": "references", "sourceAnchor": "43-the-renderer-owns-platform-realization" }, { "id": "reaktor-surface-references", "anchor": "ref-8", "relation": "references", "sourceAnchor": "51-two-terminal-families" } ] }, { "id": "reaktor-surface-implementation-plan", "owner": "Reaktor", "kind": "architecture", "summary": "Chapter 34: a staged Compose-first implementation plan.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 10, "title": "Implementation plan", "nav": "Implementation plan", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-implementation-plan", "revision": "5cac3347fc339521cec8afa7ee9c749f4d32c27151940754a28544e4afc81026", "status": "unverified", "renderingRevision": "51b5cce1a87f7bcc2fd71550edda9a9882b9eec61cac4617445d141de72e972c", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-implementation-plan", "polarity": "Neutral" }, { "id": "section-34-a-compose-first-implementation-plan", "anchor": "34-a-compose-first-implementation-plan", "label": "34. A Compose-first implementation plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-implementation-plan#34-a-compose-first-implementation-plan", "polarity": "Neutral" } ], "relations": [] }, "content": "reaktor-surface-implementation-plan.json", "sections": [ { "id": "implementation-plan", "anchor": "implementation-plan", "title": "Implementation plan", "level": 1 }, { "id": "34-a-compose-first-implementation-plan", "anchor": "34-a-compose-first-implementation-plan", "title": "34. A Compose-first implementation plan", "level": 2 }, { "id": "341-sequence-by-risk-not-by-the-number-of-component-names", "anchor": "341-sequence-by-risk-not-by-the-number-of-component-names", "title": "34.1 Sequence by risk, not by the number of component names", "level": 3 }, { "id": "342-foundation-neutral-meaning-and-testable-behavior", "anchor": "342-foundation-neutral-meaning-and-testable-behavior", "title": "34.2 Foundation: neutral meaning and testable behavior", "level": 3 }, { "id": "343-first-cmp-slice-controls-themes-and-graph-ownership", "anchor": "343-first-cmp-slice-controls-themes-and-graph-ownership", "title": "34.3 First CMP slice: controls, themes and graph ownership", "level": 3 }, { "id": "344-adaptive-presentation-and-the-tactile-differentiator", "anchor": "344-adaptive-presentation-and-the-tactile-differentiator", "title": "34.4 Adaptive presentation and the tactile differentiator", "level": 3 }, { "id": "345-delivery-observation-and-a-release-quality-cmp-application", "anchor": "345-delivery-observation-and-a-release-quality-cmp-application", "title": "34.5 Delivery, observation and a release-quality CMP application", "level": 3 }, { "id": "346-integrate-graph-updates-without-building-another-updater", "anchor": "346-integrate-graph-updates-without-building-another-updater", "title": "34.6 Integrate graph updates without building another updater", "level": 3 }, { "id": "347-react-webjs-and-the-portable-kotlin-screen-gate", "anchor": "347-react-webjs-and-the-portable-kotlin-screen-gate", "title": "34.7 React web/JS and the portable Kotlin screen gate", "level": 3 }, { "id": "348-the-minimum-complete-vertical-slice", "anchor": "348-the-minimum-complete-vertical-slice", "title": "34.8 The minimum complete vertical slice", "level": 3 } ], "links": [ { "id": "manna-kotlin-surface-migration-plan", "anchor": "feasibility", "relation": "references", "sourceAnchor": "347-react-webjs-and-the-portable-kotlin-screen-gate" } ] }, { "id": "reaktor-surface-motion-and-materials", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 18–20: animation, tactile response, and material effects.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 5, "title": "Motion and materials", "nav": "Motion and materials", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-motion-and-materials", "revision": "9330d9356b9c97f4fa28ce18e500e8e775e5c36d15e6469dd7c9dc92384055c8", "status": "unverified", "renderingRevision": "a80da092c40dc4615429d225355e465672f15af73ec7fc853ba4cab7a6120ad9", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials", "polarity": "Neutral" }, { "id": "section-18-animation-transitions-and-temporal-behavior", "anchor": "18-animation-transitions-and-temporal-behavior", "label": "18. Animation, transitions and temporal behavior", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#18-animation-transitions-and-temporal-behavior", "polarity": "Neutral" }, { "id": "section-19-tactile-interaction-as-a-system-of-material-relationships", "anchor": "19-tactile-interaction-as-a-system-of-material-relationships", "label": "19. Tactile interaction as a system of material relationships", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#19-tactile-interaction-as-a-system-of-material-relationships", "polarity": "Neutral" }, { "id": "section-20-procedural-materials-shader-backends-and-sensory-output", "anchor": "20-procedural-materials-shader-backends-and-sensory-output", "label": "20. Procedural materials, shader backends and sensory output", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#20-procedural-materials-shader-backends-and-sensory-output", "polarity": "Neutral" }, { "id": "section-182-duration-based-motion-and-spring-based-motion-answer-different-questions", "anchor": "182-duration-based-motion-and-spring-based-motion-answer-different-questions", "label": "18.2 Duration-based motion and spring-based motion answer different questions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#182-duration-based-motion-and-spring-based-motion-answer-different-questions", "polarity": "Neutral" }, { "id": "section-185-visibility-during-a-transition-is-not-permission-to-act", "anchor": "185-visibility-during-a-transition-is-not-permission-to-act", "label": "18.5 Visibility during a transition is not permission to act", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#185-visibility-during-a-transition-is-not-permission-to-act", "polarity": "Neutral" }, { "id": "section-198-material-response-must-preserve-usability", "anchor": "198-material-response-must-preserve-usability", "label": "19.8 Material response must preserve usability", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#198-material-response-must-preserve-usability", "polarity": "Neutral" }, { "id": "section-201-appearance-and-interaction-are-different-inputs", "anchor": "201-appearance-and-interaction-are-different-inputs", "label": "20.1 Appearance and interaction are different inputs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#201-appearance-and-interaction-are-different-inputs", "polarity": "Neutral" }, { "id": "section-202-shader-support-is-qualified-per-backend", "anchor": "202-shader-support-is-qualified-per-backend", "label": "20.2 Shader support is qualified per backend", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#202-shader-support-is-qualified-per-backend", "polarity": "Neutral" }, { "id": "section-204-sensory-feedback-is-event-driven", "anchor": "204-sensory-feedback-is-event-driven", "label": "20.4 Sensory feedback is event-driven", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-motion-and-materials#204-sensory-feedback-is-event-driven", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-motion-and-materials:references-reaktor-surface-references-ref-31", "kind": "references", "owner": "reaktor-surface-motion-and-materials", "incidences": [ { "node": "reaktor-surface-motion-and-materials", "port": "section-182-duration-based-motion-and-spring-based-motion-answer-different-questions", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-31", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-motion-and-materials:references-reaktor-surface-references-ref-32", "kind": "references", "owner": "reaktor-surface-motion-and-materials", "incidences": [ { "node": "reaktor-surface-motion-and-materials", "port": "section-185-visibility-during-a-transition-is-not-permission-to-act", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-32", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-motion-and-materials:references-reaktor-surface-references-ref-33", "kind": "references", "owner": "reaktor-surface-motion-and-materials", "incidences": [ { "node": "reaktor-surface-motion-and-materials", "port": "section-198-material-response-must-preserve-usability", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-33", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-motion-and-materials:references-reaktor-surface-references-ref-34", "kind": "references", "owner": "reaktor-surface-motion-and-materials", "incidences": [ { "node": "reaktor-surface-motion-and-materials", "port": "section-201-appearance-and-interaction-are-different-inputs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-34", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-motion-and-materials:references-reaktor-surface-references-ref-35", "kind": "references", "owner": "reaktor-surface-motion-and-materials", "incidences": [ { "node": "reaktor-surface-motion-and-materials", "port": "section-202-shader-support-is-qualified-per-backend", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-35", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-motion-and-materials:references-reaktor-surface-references-ref-36", "kind": "references", "owner": "reaktor-surface-motion-and-materials", "incidences": [ { "node": "reaktor-surface-motion-and-materials", "port": "section-202-shader-support-is-qualified-per-backend", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-36", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-motion-and-materials:references-reaktor-surface-references-ref-37", "kind": "references", "owner": "reaktor-surface-motion-and-materials", "incidences": [ { "node": "reaktor-surface-motion-and-materials", "port": "section-204-sensory-feedback-is-event-driven", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-37", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-motion-and-materials.json", "sections": [ { "id": "motion-and-materials", "anchor": "motion-and-materials", "title": "Motion and materials", "level": 1 }, { "id": "18-animation-transitions-and-temporal-behavior", "anchor": "18-animation-transitions-and-temporal-behavior", "title": "18. Animation, transitions and temporal behavior", "level": 2 }, { "id": "181-animation-describes-change-over-time", "anchor": "181-animation-describes-change-over-time", "title": "18.1 Animation describes change over time", "level": 3 }, { "id": "182-duration-based-motion-and-spring-based-motion-answer-different-questions", "anchor": "182-duration-based-motion-and-spring-based-motion-answer-different-questions", "title": "18.2 Duration-based motion and spring-based motion answer different questions", "level": 3 }, { "id": "183-a-motion-channel-has-one-owner", "anchor": "183-a-motion-channel-has-one-owner", "title": "18.3 A motion channel has one owner", "level": 3 }, { "id": "184-interruptions-are-normal-input", "anchor": "184-interruptions-are-normal-input", "title": "18.4 Interruptions are normal input", "level": 3 }, { "id": "185-visibility-during-a-transition-is-not-permission-to-act", "anchor": "185-visibility-during-a-transition-is-not-permission-to-act", "title": "18.5 Visibility during a transition is not permission to act", "level": 3 }, { "id": "186-reduced-motion-is-an-alternate-presentation-not-a-broken-state", "anchor": "186-reduced-motion-is-an-alternate-presentation-not-a-broken-state", "title": "18.6 Reduced motion is an alternate presentation, not a broken state", "level": 3 }, { "id": "19-tactile-interaction-as-a-system-of-material-relationships", "anchor": "19-tactile-interaction-as-a-system-of-material-relationships", "title": "19. Tactile interaction as a system of material relationships", "level": 2 }, { "id": "191-a-material-response-starts-with-a-believable-relationship", "anchor": "191-a-material-response-starts-with-a-believable-relationship", "title": "19.1 A material response starts with a believable relationship", "level": 3 }, { "id": "192-a-spring-is-a-model-of-response-not-just-a-curve-name", "anchor": "192-a-spring-is-a-model-of-response-not-just-a-curve-name", "title": "19.2 A spring is a model of response, not just a curve name", "level": 3 }, { "id": "193-ordinary-controls-use-bounded-response-profiles", "anchor": "193-ordinary-controls-use-bounded-response-profiles", "title": "19.3 Ordinary controls use bounded response profiles", "level": 3 }, { "id": "194-explicit-coupling-and-spatial-coupling", "anchor": "194-explicit-coupling-and-spatial-coupling", "title": "19.4 Explicit coupling and spatial coupling", "level": 3 }, { "id": "195-the-field-is-the-decoupling-point", "anchor": "195-the-field-is-the-decoupling-point", "title": "19.5 The field is the decoupling point", "level": 3 }, { "id": "196-a-useful-field-does-not-require-a-fluid-solver", "anchor": "196-a-useful-field-does-not-require-a-fluid-solver", "title": "19.6 A useful field does not require a fluid solver", "level": 3 }, { "id": "197-prevent-accidental-feedback-loops", "anchor": "197-prevent-accidental-feedback-loops", "title": "19.7 Prevent accidental feedback loops", "level": 3 }, { "id": "198-material-response-must-preserve-usability", "anchor": "198-material-response-must-preserve-usability", "title": "19.8 Material response must preserve usability", "level": 3 }, { "id": "20-procedural-materials-shader-backends-and-sensory-output", "anchor": "20-procedural-materials-shader-backends-and-sensory-output", "title": "20. Procedural materials, shader backends and sensory output", "level": 2 }, { "id": "201-appearance-and-interaction-are-different-inputs", "anchor": "201-appearance-and-interaction-are-different-inputs", "title": "20.1 Appearance and interaction are different inputs", "level": 3 }, { "id": "202-shader-support-is-qualified-per-backend", "anchor": "202-shader-support-is-qualified-per-backend", "title": "20.2 Shader support is qualified per backend", "level": 3 }, { "id": "203-cache-programs-update-uniforms", "anchor": "203-cache-programs-update-uniforms", "title": "20.3 Cache programs, update uniforms", "level": 3 }, { "id": "204-sensory-feedback-is-event-driven", "anchor": "204-sensory-feedback-is-event-driven", "title": "20.4 Sensory feedback is event-driven", "level": 3 }, { "id": "205-coordinate-the-channels-without-conflating-their-purpose", "anchor": "205-coordinate-the-channels-without-conflating-their-purpose", "title": "20.5 Coordinate the channels without conflating their purpose", "level": 3 } ], "links": [ { "id": "reaktor-surface-references", "anchor": "ref-31", "relation": "references", "sourceAnchor": "182-duration-based-motion-and-spring-based-motion-answer-different-questions" }, { "id": "reaktor-surface-references", "anchor": "ref-32", "relation": "references", "sourceAnchor": "185-visibility-during-a-transition-is-not-permission-to-act" }, { "id": "reaktor-surface-references", "anchor": "ref-33", "relation": "references", "sourceAnchor": "198-material-response-must-preserve-usability" }, { "id": "reaktor-surface-references", "anchor": "ref-34", "relation": "references", "sourceAnchor": "201-appearance-and-interaction-are-different-inputs" }, { "id": "reaktor-surface-references", "anchor": "ref-35", "relation": "references", "sourceAnchor": "202-shader-support-is-qualified-per-backend" }, { "id": "reaktor-surface-references", "anchor": "ref-36", "relation": "references", "sourceAnchor": "202-shader-support-is-qualified-per-backend" }, { "id": "reaktor-surface-references", "anchor": "ref-37", "relation": "references", "sourceAnchor": "204-sensory-feedback-is-event-driven" } ] }, { "id": "reaktor-surface-performance-and-assets", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 21–23: scheduling, memory, images, and delivery.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 6, "title": "Performance and assets", "nav": "Performance and assets", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-performance-and-assets", "revision": "220eebd279a8e7343ba36f51572ed3fb49fff3465b72c83d1354256571a8f56a", "status": "unverified", "renderingRevision": "e7d3c4f67cf6bd83b4580df8ce75ce168370dd366aedb3505a39a5390a0a1469", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets", "polarity": "Neutral" }, { "id": "section-21-rendering-efficiency-scheduling-and-memory", "anchor": "21-rendering-efficiency-scheduling-and-memory", "label": "21. Rendering efficiency, scheduling and memory", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#21-rendering-efficiency-scheduling-and-memory", "polarity": "Neutral" }, { "id": "section-22-assets-lazy-loading-and-resource-delivery", "anchor": "22-assets-lazy-loading-and-resource-delivery", "label": "22. Assets, lazy loading and resource delivery", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#22-assets-lazy-loading-and-resource-delivery", "polarity": "Neutral" }, { "id": "section-23-measuring-web-native-and-custom-interfaces", "anchor": "23-measuring-web-native-and-custom-interfaces", "label": "23. Measuring web, native and custom interfaces", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#23-measuring-web-native-and-custom-interfaces", "polarity": "Neutral" }, { "id": "section-212-recomposition-and-rerendering-are-normal-mechanisms", "anchor": "212-recomposition-and-rerendering-are-normal-mechanisms", "label": "21.2 Recomposition and rerendering are normal mechanisms", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#212-recomposition-and-rerendering-are-normal-mechanisms", "polarity": "Neutral" }, { "id": "section-214-schedule-immediate-and-speculative-work-differently", "anchor": "214-schedule-immediate-and-speculative-work-differently", "label": "21.4 Schedule immediate and speculative work differently", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#214-schedule-immediate-and-speculative-work-differently", "polarity": "Neutral" }, { "id": "section-216-memoization-caching-and-pooling-are-different-techniques", "anchor": "216-memoization-caching-and-pooling-are-different-techniques", "label": "21.6 Memoization, caching and pooling are different techniques", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#216-memoization-caching-and-pooling-are-different-techniques", "polarity": "Neutral" }, { "id": "section-223-choose-formats-for-the-assets-job", "anchor": "223-choose-formats-for-the-assets-job", "label": "22.3 Choose formats for the asset's job", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#223-choose-formats-for-the-assets-job", "polarity": "Neutral" }, { "id": "section-224-reuse-capable-loaders-with-the-right-requests", "anchor": "224-reuse-capable-loaders-with-the-right-requests", "label": "22.4 Reuse capable loaders, with the right requests", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#224-reuse-capable-loaders-with-the-right-requests", "polarity": "Neutral" }, { "id": "section-225-lazy-loading-is-not-one-switch", "anchor": "225-lazy-loading-is-not-one-switch", "label": "22.5 Lazy loading is not one switch", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#225-lazy-loading-is-not-one-switch", "polarity": "Neutral" }, { "id": "section-226-preserve-geometry-while-resources-arrive", "anchor": "226-preserve-geometry-while-resources-arrive", "label": "22.6 Preserve geometry while resources arrive", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#226-preserve-geometry-while-resources-arrive", "polarity": "Neutral" }, { "id": "section-232-preserve-standardized-metric-definitions", "anchor": "232-preserve-standardized-metric-definitions", "label": "23.2 Preserve standardized metric definitions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#232-preserve-standardized-metric-definitions", "polarity": "Neutral" }, { "id": "section-233-native-collectors-have-different-coverage", "anchor": "233-native-collectors-have-different-coverage", "label": "23.3 Native collectors have different coverage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#233-native-collectors-have-different-coverage", "polarity": "Neutral" }, { "id": "section-235-explain-the-cause-not-just-the-number", "anchor": "235-explain-the-cause-not-just-the-number", "label": "23.5 Explain the cause, not just the number", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-performance-and-assets#235-explain-the-cause-not-just-the-number", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-38", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-212-recomposition-and-rerendering-are-normal-mechanisms", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-38", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-39", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-214-schedule-immediate-and-speculative-work-differently", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-39", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-40", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-216-memoization-caching-and-pooling-are-different-techniques", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-40", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-41", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-223-choose-formats-for-the-assets-job", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-41", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-42", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-224-reuse-capable-loaders-with-the-right-requests", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-42", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-43", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-225-lazy-loading-is-not-one-switch", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-43", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-44", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-226-preserve-geometry-while-resources-arrive", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-44", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-45", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-232-preserve-standardized-metric-definitions", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-45", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-46", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-232-preserve-standardized-metric-definitions", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-46", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-47", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-233-native-collectors-have-different-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-47", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-48", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-233-native-collectors-have-different-coverage", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-48", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-49", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-235-explain-the-cause-not-just-the-number", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-49", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-performance-and-assets:references-reaktor-surface-references-ref-50", "kind": "references", "owner": "reaktor-surface-performance-and-assets", "incidences": [ { "node": "reaktor-surface-performance-and-assets", "port": "section-235-explain-the-cause-not-just-the-number", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-50", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-performance-and-assets.json", "sections": [ { "id": "performance-and-assets", "anchor": "performance-and-assets", "title": "Performance and assets", "level": 1 }, { "id": "21-rendering-efficiency-scheduling-and-memory", "anchor": "21-rendering-efficiency-scheduling-and-memory", "title": "21. Rendering efficiency, scheduling and memory", "level": 2 }, { "id": "211-performance-begins-with-the-dependency-that-changed", "anchor": "211-performance-begins-with-the-dependency-that-changed", "title": "21.1 Performance begins with the dependency that changed", "level": 3 }, { "id": "212-recomposition-and-rerendering-are-normal-mechanisms", "anchor": "212-recomposition-and-rerendering-are-normal-mechanisms", "title": "21.2 Recomposition and rerendering are normal mechanisms", "level": 3 }, { "id": "213-cache-according-to-actual-dependencies", "anchor": "213-cache-according-to-actual-dependencies", "title": "21.3 Cache according to actual dependencies", "level": 3 }, { "id": "214-schedule-immediate-and-speculative-work-differently", "anchor": "214-schedule-immediate-and-speculative-work-differently", "title": "21.4 Schedule immediate and speculative work differently", "level": 3 }, { "id": "215-frames-are-deadlines-shared-with-the-rest-of-the-system", "anchor": "215-frames-are-deadlines-shared-with-the-rest-of-the-system", "title": "21.5 Frames are deadlines shared with the rest of the system", "level": 3 }, { "id": "216-memoization-caching-and-pooling-are-different-techniques", "anchor": "216-memoization-caching-and-pooling-are-different-techniques", "title": "21.6 Memoization, caching and pooling are different techniques", "level": 3 }, { "id": "22-assets-lazy-loading-and-resource-delivery", "anchor": "22-assets-lazy-loading-and-resource-delivery", "title": "22. Assets, lazy loading and resource delivery", "level": 2 }, { "id": "221-an-image-has-several-sizes-and-several-lifetimes", "anchor": "221-an-image-has-several-sizes-and-several-lifetimes", "title": "22.1 An image has several sizes and several lifetimes", "level": 3 }, { "id": "222-the-manifest-makes-asset-requirements-explicit", "anchor": "222-the-manifest-makes-asset-requirements-explicit", "title": "22.2 The manifest makes asset requirements explicit", "level": 3 }, { "id": "223-choose-formats-for-the-assets-job", "anchor": "223-choose-formats-for-the-assets-job", "title": "22.3 Choose formats for the asset's job", "level": 3 }, { "id": "224-reuse-capable-loaders-with-the-right-requests", "anchor": "224-reuse-capable-loaders-with-the-right-requests", "title": "22.4 Reuse capable loaders, with the right requests", "level": 3 }, { "id": "225-lazy-loading-is-not-one-switch", "anchor": "225-lazy-loading-is-not-one-switch", "title": "22.5 Lazy loading is not one switch", "level": 3 }, { "id": "226-preserve-geometry-while-resources-arrive", "anchor": "226-preserve-geometry-while-resources-arrive", "title": "22.6 Preserve geometry while resources arrive", "level": 3 }, { "id": "23-measuring-web-native-and-custom-interfaces", "anchor": "23-measuring-web-native-and-custom-interfaces", "title": "23. Measuring web, native and custom interfaces", "level": 2 }, { "id": "231-start-with-the-user-visible-question", "anchor": "231-start-with-the-user-visible-question", "title": "23.1 Start with the user-visible question", "level": 3 }, { "id": "232-preserve-standardized-metric-definitions", "anchor": "232-preserve-standardized-metric-definitions", "title": "23.2 Preserve standardized metric definitions", "level": 3 }, { "id": "233-native-collectors-have-different-coverage", "anchor": "233-native-collectors-have-different-coverage", "title": "23.3 Native collectors have different coverage", "level": 3 }, { "id": "234-correlate-measurements-without-overwhelming-the-graph", "anchor": "234-correlate-measurements-without-overwhelming-the-graph", "title": "23.4 Correlate measurements without overwhelming the graph", "level": 3 }, { "id": "235-explain-the-cause-not-just-the-number", "anchor": "235-explain-the-cause-not-just-the-number", "title": "23.5 Explain the cause, not just the number", "level": 3 } ], "links": [ { "id": "reaktor-surface-references", "anchor": "ref-38", "relation": "references", "sourceAnchor": "212-recomposition-and-rerendering-are-normal-mechanisms" }, { "id": "reaktor-surface-references", "anchor": "ref-39", "relation": "references", "sourceAnchor": "214-schedule-immediate-and-speculative-work-differently" }, { "id": "reaktor-surface-references", "anchor": "ref-40", "relation": "references", "sourceAnchor": "216-memoization-caching-and-pooling-are-different-techniques" }, { "id": "reaktor-surface-references", "anchor": "ref-41", "relation": "references", "sourceAnchor": "223-choose-formats-for-the-assets-job" }, { "id": "reaktor-surface-references", "anchor": "ref-42", "relation": "references", "sourceAnchor": "224-reuse-capable-loaders-with-the-right-requests" }, { "id": "reaktor-surface-references", "anchor": "ref-43", "relation": "references", "sourceAnchor": "225-lazy-loading-is-not-one-switch" }, { "id": "reaktor-surface-references", "anchor": "ref-44", "relation": "references", "sourceAnchor": "226-preserve-geometry-while-resources-arrive" }, { "id": "reaktor-surface-references", "anchor": "ref-45", "relation": "references", "sourceAnchor": "232-preserve-standardized-metric-definitions" }, { "id": "reaktor-surface-references", "anchor": "ref-46", "relation": "references", "sourceAnchor": "232-preserve-standardized-metric-definitions" }, { "id": "reaktor-surface-references", "anchor": "ref-47", "relation": "references", "sourceAnchor": "233-native-collectors-have-different-coverage" }, { "id": "reaktor-surface-references", "anchor": "ref-48", "relation": "references", "sourceAnchor": "233-native-collectors-have-different-coverage" }, { "id": "reaktor-surface-references", "anchor": "ref-49", "relation": "references", "sourceAnchor": "235-explain-the-cause-not-just-the-number" }, { "id": "reaktor-surface-references", "anchor": "ref-50", "relation": "references", "sourceAnchor": "235-explain-the-cause-not-just-the-number" } ] }, { "id": "reaktor-surface-references", "owner": "Reaktor", "kind": "reference", "summary": "Sources and further reading for the Surface textbook.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 13, "title": "References", "nav": "References", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-references", "revision": "ed8c61e513f1bfc33a7c0a0d371229262f263ca1ac974982454c16ae53bd5192", "status": "unverified", "renderingRevision": "620fcfefc35d4a2a6713e287f59445c6e340ad5de3d1accd7937a3bb0d8ad95f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.w3.org/WAI/ARIA/apg/practices/read-me-first/", "https://developer.android.com/develop/ui/compose/layouts/adaptive/canonical-layouts", "https://www.w3.org/TR/css-contain-3/", "https://react.dev/learn/render-and-commit", "https://developer.android.com/develop/ui/compose/phases", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-graph/src/commonMain/kotlin/dev/shibasis/reaktor/graph/core/Graph.kt", "https://github.com/react/react-strict-dom", "https://kotlinlang.org/docs/multiplatform/compose-multiplatform-and-jetpack-compose.html", "https://developer.android.com/develop/ui/compose/touch-input/user-interactions/handling-interactions", "https://www.w3.org/TR/WCAG22/", "https://atomicdesign.bradfrost.com/chapter-2/", "https://www.designtokens.org/tr/2025.10/format/", "https://developer.android.com/develop/ui/compose/designsystems/custom", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-ui/ts/src/theme/ReaktorThemeProvider.tsx", "https://stylexjs.com/docs/learn/", "https://github.com/shibasis0801/bestbuds/blob/dcc5df82e7cd6e8e6b7cd6ebd7f2bc37ef9ea43d/modules/app/src/commonMain/kotlin/ai/bestbuds/app/BestBuds.kt", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-graph/src/commonMain/kotlin/dev/shibasis/reaktor/graph/navigation/Payload.kt", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-graph-port/src/commonMain/kotlin/dev/shibasis/reaktor/portgraph/graph/PortGraph.kt", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-graph/src/commonMain/kotlin/dev/shibasis/reaktor/graph/core/node/RouteNode.kt", "https://github.com/shibasis0801/bestbuds/blob/dcc5df82e7cd6e8e6b7cd6ebd7f2bc37ef9ea43d/modules/app/src/commonMain/kotlin/ai/bestbuds/app/data/interactors/ChatSessionInteractor.kt", "https://developer.android.com/develop/ui/compose/state-hoisting", "https://react.dev/learn/preserving-and-resetting-state", "https://developer.android.com/develop/ui/compose/side-effects", "https://developer.android.com/guide/components/activities/activity-lifecycle", "https://developer.chrome.com/docs/web-platform/page-lifecycle-api", "https://developer.android.com/develop/ui/compose/layouts/adaptive/use-window-size-classes", "https://developer.android.com/develop/ui/compose/layouts/custom", "https://github.com/androidx/androidx/blob/androidx-main/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Applier.kt", "https://react.dev/reference/react/useSyncExternalStore", "https://github.com/react/react/blob/main/packages/react-reconciler/README.md", "https://developer.android.com/develop/ui/compose/animation/customize", "https://developer.android.com/develop/ui/compose/animation/shared-elements", "https://github.com/shibasis0801/bestbuds/blob/dcc5df82e7cd6e8e6b7cd6ebd7f2bc37ef9ea43d/modules/design/src/commonMain/kotlin/ai/bestbuds/design/prototype/foundation/TactileSurface.kt", "https://thebookofshaders.com/13/", "https://developer.android.com/develop/ui/views/graphics/agsl", "https://skia.org/docs/user/sksl/", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-tactile/src/commonMain/kotlin/dev/shibasis/reaktor/tactile/Haptics.kt", "https://developer.android.com/develop/ui/compose/performance/stability/strongskipping", "https://react.dev/reference/react/startTransition", "https://developer.android.com/topic/performance/memory/manage-app-memory", "https://web.dev/learn/performance/image-performance", "https://coil-kt.github.io/coil/compose/", "https://web.dev/articles/optimize-lcp", "https://web.dev/learn/performance/optimize-web-fonts", "https://web.dev/articles/vitals", "https://web.dev/articles/optimize-cls", "https://developer.android.com/topic/performance/vitals", "https://developer.apple.com/documentation/metrickit", "https://react.dev/reference/react/Profiler", "https://developer.android.com/topic/performance/benchmarking/macrobenchmark-overview", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-graph/build.gradle.kts", "https://github.com/shibasis0801/reaktor/blob/42ccdc96e772a10ce9a6580274f73f3fa02e0acc/reaktor-ui/build.gradle.kts" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-references", "polarity": "Neutral" }, { "id": "section-ref-1", "anchor": "ref-1", "label": "1", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-1", "polarity": "Neutral" }, { "id": "section-ref-2", "anchor": "ref-2", "label": "2", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-2", "polarity": "Neutral" }, { "id": "section-ref-3", "anchor": "ref-3", "label": "3", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-3", "polarity": "Neutral" }, { "id": "section-ref-4", "anchor": "ref-4", "label": "4", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-4", "polarity": "Neutral" }, { "id": "section-ref-5", "anchor": "ref-5", "label": "5", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-5", "polarity": "Neutral" }, { "id": "section-ref-6", "anchor": "ref-6", "label": "6", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-6", "polarity": "Neutral" }, { "id": "section-ref-7", "anchor": "ref-7", "label": "7", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-7", "polarity": "Neutral" }, { "id": "section-ref-8", "anchor": "ref-8", "label": "8", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-8", "polarity": "Neutral" }, { "id": "section-ref-9", "anchor": "ref-9", "label": "9", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-9", "polarity": "Neutral" }, { "id": "section-ref-10", "anchor": "ref-10", "label": "10", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-10", "polarity": "Neutral" }, { "id": "section-ref-11", "anchor": "ref-11", "label": "11", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-11", "polarity": "Neutral" }, { "id": "section-ref-12", "anchor": "ref-12", "label": "12", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-12", "polarity": "Neutral" }, { "id": "section-ref-13", "anchor": "ref-13", "label": "13", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-13", "polarity": "Neutral" }, { "id": "section-ref-14", "anchor": "ref-14", "label": "14", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-14", "polarity": "Neutral" }, { "id": "section-ref-15", "anchor": "ref-15", "label": "15", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-15", "polarity": "Neutral" }, { "id": "section-ref-16", "anchor": "ref-16", "label": "16", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-16", "polarity": "Neutral" }, { "id": "section-ref-17", "anchor": "ref-17", "label": "17", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-17", "polarity": "Neutral" }, { "id": "section-ref-18", "anchor": "ref-18", "label": "18", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-18", "polarity": "Neutral" }, { "id": "section-ref-19", "anchor": "ref-19", "label": "19", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-19", "polarity": "Neutral" }, { "id": "section-ref-20", "anchor": "ref-20", "label": "20", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-20", "polarity": "Neutral" }, { "id": "section-ref-21", "anchor": "ref-21", "label": "21", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-21", "polarity": "Neutral" }, { "id": "section-ref-22", "anchor": "ref-22", "label": "22", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-22", "polarity": "Neutral" }, { "id": "section-ref-23", "anchor": "ref-23", "label": "23", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-23", "polarity": "Neutral" }, { "id": "section-ref-24", "anchor": "ref-24", "label": "24", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-24", "polarity": "Neutral" }, { "id": "section-ref-25", "anchor": "ref-25", "label": "25", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-25", "polarity": "Neutral" }, { "id": "section-ref-26", "anchor": "ref-26", "label": "26", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-26", "polarity": "Neutral" }, { "id": "section-ref-27", "anchor": "ref-27", "label": "27", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-27", "polarity": "Neutral" }, { "id": "section-ref-28", "anchor": "ref-28", "label": "28", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-28", "polarity": "Neutral" }, { "id": "section-ref-29", "anchor": "ref-29", "label": "29", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-29", "polarity": "Neutral" }, { "id": "section-ref-30", "anchor": "ref-30", "label": "30", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-30", "polarity": "Neutral" }, { "id": "section-ref-31", "anchor": "ref-31", "label": "31", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-31", "polarity": "Neutral" }, { "id": "section-ref-32", "anchor": "ref-32", "label": "32", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-32", "polarity": "Neutral" }, { "id": "section-ref-33", "anchor": "ref-33", "label": "33", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-33", "polarity": "Neutral" }, { "id": "section-ref-34", "anchor": "ref-34", "label": "34", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-34", "polarity": "Neutral" }, { "id": "section-ref-35", "anchor": "ref-35", "label": "35", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-35", "polarity": "Neutral" }, { "id": "section-ref-36", "anchor": "ref-36", "label": "36", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-36", "polarity": "Neutral" }, { "id": "section-ref-37", "anchor": "ref-37", "label": "37", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-37", "polarity": "Neutral" }, { "id": "section-ref-38", "anchor": "ref-38", "label": "38", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-38", "polarity": "Neutral" }, { "id": "section-ref-39", "anchor": "ref-39", "label": "39", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-39", "polarity": "Neutral" }, { "id": "section-ref-40", "anchor": "ref-40", "label": "40", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-40", "polarity": "Neutral" }, { "id": "section-ref-41", "anchor": "ref-41", "label": "41", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-41", "polarity": "Neutral" }, { "id": "section-ref-42", "anchor": "ref-42", "label": "42", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-42", "polarity": "Neutral" }, { "id": "section-ref-43", "anchor": "ref-43", "label": "43", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-43", "polarity": "Neutral" }, { "id": "section-ref-44", "anchor": "ref-44", "label": "44", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-44", "polarity": "Neutral" }, { "id": "section-ref-45", "anchor": "ref-45", "label": "45", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-45", "polarity": "Neutral" }, { "id": "section-ref-46", "anchor": "ref-46", "label": "46", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-46", "polarity": "Neutral" }, { "id": "section-ref-47", "anchor": "ref-47", "label": "47", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-47", "polarity": "Neutral" }, { "id": "section-ref-48", "anchor": "ref-48", "label": "48", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-48", "polarity": "Neutral" }, { "id": "section-ref-49", "anchor": "ref-49", "label": "49", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-49", "polarity": "Neutral" }, { "id": "section-ref-50", "anchor": "ref-50", "label": "50", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-50", "polarity": "Neutral" }, { "id": "section-ref-51", "anchor": "ref-51", "label": "51", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-51", "polarity": "Neutral" }, { "id": "section-ref-52", "anchor": "ref-52", "label": "52", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-references#ref-52", "polarity": "Neutral" } ], "relations": [] }, "content": "reaktor-surface-references.json", "sections": [ { "id": "references", "anchor": "references", "title": "References", "level": 1 }, { "id": "ref-1", "anchor": "ref-1", "title": "1", "level": 3 }, { "id": "ref-2", "anchor": "ref-2", "title": "2", "level": 3 }, { "id": "ref-3", "anchor": "ref-3", "title": "3", "level": 3 }, { "id": "ref-4", "anchor": "ref-4", "title": "4", "level": 3 }, { "id": "ref-5", "anchor": "ref-5", "title": "5", "level": 3 }, { "id": "ref-6", "anchor": "ref-6", "title": "6", "level": 3 }, { "id": "ref-7", "anchor": "ref-7", "title": "7", "level": 3 }, { "id": "ref-8", "anchor": "ref-8", "title": "8", "level": 3 }, { "id": "ref-9", "anchor": "ref-9", "title": "9", "level": 3 }, { "id": "ref-10", "anchor": "ref-10", "title": "10", "level": 3 }, { "id": "ref-11", "anchor": "ref-11", "title": "11", "level": 3 }, { "id": "ref-12", "anchor": "ref-12", "title": "12", "level": 3 }, { "id": "ref-13", "anchor": "ref-13", "title": "13", "level": 3 }, { "id": "ref-14", "anchor": "ref-14", "title": "14", "level": 3 }, { "id": "ref-15", "anchor": "ref-15", "title": "15", "level": 3 }, { "id": "ref-16", "anchor": "ref-16", "title": "16", "level": 3 }, { "id": "ref-17", "anchor": "ref-17", "title": "17", "level": 3 }, { "id": "ref-18", "anchor": "ref-18", "title": "18", "level": 3 }, { "id": "ref-19", "anchor": "ref-19", "title": "19", "level": 3 }, { "id": "ref-20", "anchor": "ref-20", "title": "20", "level": 3 }, { "id": "ref-21", "anchor": "ref-21", "title": "21", "level": 3 }, { "id": "ref-22", "anchor": "ref-22", "title": "22", "level": 3 }, { "id": "ref-23", "anchor": "ref-23", "title": "23", "level": 3 }, { "id": "ref-24", "anchor": "ref-24", "title": "24", "level": 3 }, { "id": "ref-25", "anchor": "ref-25", "title": "25", "level": 3 }, { "id": "ref-26", "anchor": "ref-26", "title": "26", "level": 3 }, { "id": "ref-27", "anchor": "ref-27", "title": "27", "level": 3 }, { "id": "ref-28", "anchor": "ref-28", "title": "28", "level": 3 }, { "id": "ref-29", "anchor": "ref-29", "title": "29", "level": 3 }, { "id": "ref-30", "anchor": "ref-30", "title": "30", "level": 3 }, { "id": "ref-31", "anchor": "ref-31", "title": "31", "level": 3 }, { "id": "ref-32", "anchor": "ref-32", "title": "32", "level": 3 }, { "id": "ref-33", "anchor": "ref-33", "title": "33", "level": 3 }, { "id": "ref-34", "anchor": "ref-34", "title": "34", "level": 3 }, { "id": "ref-35", "anchor": "ref-35", "title": "35", "level": 3 }, { "id": "ref-36", "anchor": "ref-36", "title": "36", "level": 3 }, { "id": "ref-37", "anchor": "ref-37", "title": "37", "level": 3 }, { "id": "ref-38", "anchor": "ref-38", "title": "38", "level": 3 }, { "id": "ref-39", "anchor": "ref-39", "title": "39", "level": 3 }, { "id": "ref-40", "anchor": "ref-40", "title": "40", "level": 3 }, { "id": "ref-41", "anchor": "ref-41", "title": "41", "level": 3 }, { "id": "ref-42", "anchor": "ref-42", "title": "42", "level": 3 }, { "id": "ref-43", "anchor": "ref-43", "title": "43", "level": 3 }, { "id": "ref-44", "anchor": "ref-44", "title": "44", "level": 3 }, { "id": "ref-45", "anchor": "ref-45", "title": "45", "level": 3 }, { "id": "ref-46", "anchor": "ref-46", "title": "46", "level": 3 }, { "id": "ref-47", "anchor": "ref-47", "title": "47", "level": 3 }, { "id": "ref-48", "anchor": "ref-48", "title": "48", "level": 3 }, { "id": "ref-49", "anchor": "ref-49", "title": "49", "level": 3 }, { "id": "ref-50", "anchor": "ref-50", "title": "50", "level": 3 }, { "id": "ref-51", "anchor": "ref-51", "title": "51", "level": 3 }, { "id": "ref-52", "anchor": "ref-52", "title": "52", "level": 3 } ], "links": [ { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "ref-7" } ] }, { "id": "reaktor-surface-renderers", "owner": "Reaktor", "kind": "architecture", "summary": "Chapters 15–17: Compose, React, and renderer boundaries.", "use": "Read as part of the Reaktor Surface textbook; the overview links the complete reading order.", "region": "framework-ui", "order": 4, "title": "Renderers and interop", "nav": "Renderers and interop", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface-renderers", "revision": "cf1e2dceaebe9a9627d684bf40559ee2121b613cb6f359827cdcb3658f93e97b", "status": "unverified", "renderingRevision": "8190e67e917c2665989753930879c4f5b864b71ba17723d3d5632cf50fdebbde", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "17-react-reconciliation-and-the-later-rsd-realization", "172-the-direct-rsd-path", "174-react-to-compose-is-an-optional-host-adapter" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface-renderers", "polarity": "Neutral" }, { "id": "section-15-the-compose-first-implementation", "anchor": "15-the-compose-first-implementation", "label": "15. The Compose-first implementation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#15-the-compose-first-implementation", "polarity": "Neutral" }, { "id": "section-16-hostapplier-and-the-portable-composition-boundary", "anchor": "16-hostapplier-and-the-portable-composition-boundary", "label": "16. HostApplier and the portable composition boundary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#16-hostapplier-and-the-portable-composition-boundary", "polarity": "Neutral" }, { "id": "section-17-react-reconciliation-and-the-later-rsd-realization", "anchor": "17-react-reconciliation-and-the-later-rsd-realization", "label": "17-react-reconciliation-and-the-later-rsd-realization", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#17-react-reconciliation-and-the-later-rsd-realization", "polarity": "Neutral" }, { "id": "section-153-remember-identity-not-every-changing-input", "anchor": "153-remember-identity-not-every-changing-input", "label": "15.3 Remember identity, not every changing input", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#153-remember-identity-not-every-changing-input", "polarity": "Neutral" }, { "id": "section-154-observe-work-at-the-right-phase", "anchor": "154-observe-work-at-the-right-phase", "label": "15.4 Observe work at the right phase", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#154-observe-work-at-the-right-phase", "polarity": "Neutral" }, { "id": "section-161-why-an-applier-exists", "anchor": "161-why-an-applier-exists", "label": "16.1 Why an Applier exists", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#161-why-an-applier-exists", "polarity": "Neutral" }, { "id": "section-171-what-reconciliation-contributes", "anchor": "171-what-reconciliation-contributes", "label": "17.1 What reconciliation contributes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#171-what-reconciliation-contributes", "polarity": "Neutral" }, { "id": "section-172-the-direct-rsd-path", "anchor": "172-the-direct-rsd-path", "label": "172-the-direct-rsd-path", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#172-the-direct-rsd-path", "polarity": "Neutral" }, { "id": "section-174-react-to-compose-is-an-optional-host-adapter", "anchor": "174-react-to-compose-is-an-optional-host-adapter", "label": "174-react-to-compose-is-an-optional-host-adapter", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface-renderers#174-react-to-compose-is-an-optional-host-adapter", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface-renderers:references-reaktor-surface-references-ref-23", "kind": "references", "owner": "reaktor-surface-renderers", "incidences": [ { "node": "reaktor-surface-renderers", "port": "section-153-remember-identity-not-every-changing-input", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-23", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-renderers:references-reaktor-surface-references-ref-5", "kind": "references", "owner": "reaktor-surface-renderers", "incidences": [ { "node": "reaktor-surface-renderers", "port": "section-154-observe-work-at-the-right-phase", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-5", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-renderers:references-reaktor-surface-references-ref-28", "kind": "references", "owner": "reaktor-surface-renderers", "incidences": [ { "node": "reaktor-surface-renderers", "port": "section-161-why-an-applier-exists", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-28", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-renderers:references-reaktor-surface-references-ref-4", "kind": "references", "owner": "reaktor-surface-renderers", "incidences": [ { "node": "reaktor-surface-renderers", "port": "section-171-what-reconciliation-contributes", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-4", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-renderers:references-reaktor-surface-references-ref-29", "kind": "references", "owner": "reaktor-surface-renderers", "incidences": [ { "node": "reaktor-surface-renderers", "port": "section-172-the-direct-rsd-path", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-29", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface-renderers:references-reaktor-surface-references-ref-30", "kind": "references", "owner": "reaktor-surface-renderers", "incidences": [ { "node": "reaktor-surface-renderers", "port": "section-174-react-to-compose-is-an-optional-host-adapter", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "section-ref-30", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface-renderers.json", "sections": [ { "id": "renderers-and-interop", "anchor": "renderers-and-interop", "title": "Renderers and interop", "level": 1 }, { "id": "15-the-compose-first-implementation", "anchor": "15-the-compose-first-implementation", "title": "15. The Compose-first implementation", "level": 2 }, { "id": "151-keep-the-first-production-path-direct", "anchor": "151-keep-the-first-production-path-direct", "title": "15.1 Keep the first production path direct", "level": 3 }, { "id": "152-the-adapter-translates-rather-than-owns-application-behavior", "anchor": "152-the-adapter-translates-rather-than-owns-application-behavior", "title": "15.2 The adapter translates, rather than owns, application behavior", "level": 3 }, { "id": "153-remember-identity-not-every-changing-input", "anchor": "153-remember-identity-not-every-changing-input", "title": "15.3 Remember identity, not every changing input", "level": 3 }, { "id": "154-observe-work-at-the-right-phase", "anchor": "154-observe-work-at-the-right-phase", "title": "15.4 Observe work at the right phase", "level": 3 }, { "id": "155-toolkit-behavior-remains-valuable", "anchor": "155-toolkit-behavior-remains-valuable", "title": "15.5 Toolkit behavior remains valuable", "level": 3 }, { "id": "156-compose-first-must-not-mean-compose-shaped-contracts", "anchor": "156-compose-first-must-not-mean-compose-shaped-contracts", "title": "15.6 Compose-first must not mean Compose-shaped contracts", "level": 3 }, { "id": "16-hostapplier-and-the-portable-composition-boundary", "anchor": "16-hostapplier-and-the-portable-composition-boundary", "title": "16. HostApplier and the portable composition boundary", "level": 2 }, { "id": "161-why-an-applier-exists", "anchor": "161-why-an-applier-exists", "title": "16.1 Why an Applier exists", "level": 3 }, { "id": "162-a-tiny-tree-makes-the-idea-concrete", "anchor": "162-a-tiny-tree-makes-the-idea-concrete", "title": "16.2 A tiny tree makes the idea concrete", "level": 3 }, { "id": "163-insert-move-and-remove-are-distinct-operations", "anchor": "163-insert-move-and-remove-are-distinct-operations", "title": "16.3 Insert, move and remove are distinct operations", "level": 3 }, { "id": "164-publication-belongs-at-a-coherent-boundary", "anchor": "164-publication-belongs-at-a-coherent-boundary", "title": "16.4 Publication belongs at a coherent boundary", "level": 3 }, { "id": "165-the-committed-host-tree-is-not-the-source-program", "anchor": "165-the-committed-host-tree-is-not-the-source-program", "title": "16.5 The committed host tree is not the source program", "level": 3 }, { "id": "166-derived-renderer-data-remains-derived", "anchor": "166-derived-renderer-data-remains-derived", "title": "16.6 Derived renderer data remains derived", "level": 3 }, { "id": "17-react-webjs-realization", "anchor": "17-react-webjs-realization", "title": "17. React web/JS realization", "level": 2 }, { "id": "171-what-reconciliation-contributes", "anchor": "171-what-reconciliation-contributes", "title": "17.1 What reconciliation contributes", "level": 3 }, { "id": "react-web", "anchor": "react-web", "title": "17.2 The React web / JS realization", "level": 3 }, { "id": "173-sharing-behavior-across-languages", "anchor": "173-sharing-behavior-across-languages", "title": "17.3 Sharing behavior across languages", "level": 3 }, { "id": "174-one-kotlin-composition-with-two-realizations", "anchor": "174-one-kotlin-composition-with-two-realizations", "title": "17.4 One Kotlin composition with two realizations", "level": 3 }, { "id": "175-bounded-commits-and-event-delivery", "anchor": "175-bounded-commits-and-event-delivery", "title": "17.5 Bounded commits and event delivery", "level": 3 }, { "id": "176-what-minimal-change-react-support-really-means", "anchor": "176-what-minimal-change-react-support-really-means", "title": "17.6 What minimal-change React support really means", "level": 3 } ], "links": [ { "id": "reaktor-surface-references", "anchor": "ref-23", "relation": "references", "sourceAnchor": "153-remember-identity-not-every-changing-input" }, { "id": "reaktor-surface-references", "anchor": "ref-5", "relation": "references", "sourceAnchor": "154-observe-work-at-the-right-phase" }, { "id": "reaktor-surface-references", "anchor": "ref-28", "relation": "references", "sourceAnchor": "161-why-an-applier-exists" }, { "id": "reaktor-surface-references", "anchor": "ref-28", "relation": "references", "sourceAnchor": "163-insert-move-and-remove-are-distinct-operations" }, { "id": "reaktor-surface-references", "anchor": "ref-4", "relation": "references", "sourceAnchor": "171-what-reconciliation-contributes" }, { "id": "reaktor-surface-references", "anchor": "ref-29", "relation": "references", "sourceAnchor": "react-web" }, { "id": "manna-kotlin-surface-migration-plan", "anchor": "feasibility", "relation": "references", "sourceAnchor": "176-what-minimal-change-react-support-really-means" } ] }, { "id": "reaktor-surface", "owner": "Reaktor", "kind": "architecture", "summary": "The Surface textbook: component meaning and behavior, Graph ownership, Compose Multiplatform and React web and Compose renderers, adaptive layout, motion, performance, dynamic UI, and application patterns.", "use": "Start here for the new Surface documentation and the illustrated PDF; read the eleven chapter groups for the full architecture and implementation plan.", "region": "framework-ui", "order": 0, "title": "Reaktor Surface", "nav": "Surface overview", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-surface", "revision": "9d105e65e8d59ad6273633b90232c426d451efadbfc91d9c623f42bd2f97d703", "status": "unverified", "renderingRevision": "f6fdbb4c164a4010f9033050d179843e2dd0c779d7da51844ab5b54d0132245d", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-surface", "polarity": "Neutral" }, { "id": "section-an-illustrated-architecture-for-adaptive-tactile-graph-native-interfaces", "anchor": "an-illustrated-architecture-for-adaptive-tactile-graph-native-interfaces", "label": "An illustrated architecture for adaptive, tactile, graph-native interfaces", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface#an-illustrated-architecture-for-adaptive-tactile-graph-native-interfaces", "polarity": "Neutral" }, { "id": "section-read-the-chapters", "anchor": "read-the-chapters", "label": "Read the chapters", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-surface#read-the-chapters", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-surface:references-reaktor-surface-foundations", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-contracts-and-interaction", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-contracts-and-interaction", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-renderers", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-motion-and-materials", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-motion-and-materials", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-performance-and-assets", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-performance-and-assets", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-dynamic-ui-and-verification", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-application-patterns", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-application-patterns", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-application-extensions", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-application-extensions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-implementation-plan", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-implementation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-desktop", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-desktop", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-surface:references-reaktor-surface-references", "kind": "references", "owner": "reaktor-surface", "incidences": [ { "node": "reaktor-surface", "port": "section-read-the-chapters", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-references", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-surface.json", "sections": [ { "id": "reaktor-surface", "anchor": "reaktor-surface", "title": "Reaktor Surface", "level": 1 }, { "id": "an-illustrated-architecture-for-adaptive-tactile-graph-native-interfaces", "anchor": "an-illustrated-architecture-for-adaptive-tactile-graph-native-interfaces", "title": "An illustrated architecture for adaptive, tactile, graph-native interfaces", "level": 2 }, { "id": "implementation-status-and-the-manna-design-benchmark", "anchor": "implementation-status-and-the-manna-design-benchmark", "title": "Implementation status and the Manna design benchmark", "level": 2 }, { "id": "read-the-chapters", "anchor": "read-the-chapters", "title": "Read the chapters", "level": 2 } ], "links": [ { "id": "manna-kotlin-surface-migration-plan", "anchor": "feasibility", "relation": "references", "sourceAnchor": "implementation-status-and-the-manna-design-benchmark" }, { "id": "reaktor-surface-foundations", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-contracts-and-interaction", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-motion-and-materials", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-performance-and-assets", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-application-patterns", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-application-extensions", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-implementation-plan", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-desktop", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" }, { "id": "reaktor-surface-references", "anchor": "", "relation": "references", "sourceAnchor": "read-the-chapters" } ] }, { "id": "reaktor-system-atlas", "summary": "Thirty interactive representative designs using the same Blueprint renderer and shared theme as Manna Atlas.", "kind": "design", "owner": "Reaktor", "use": "Read the theory and distinguish structural checks from runtime, target and deployment qualification.", "region": "theory-foundations", "order": 9, "title": "Reaktor system atlas", "nav": "Interactive system atlas", "group": "theory", "subsection": "theory-foundations", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-system-atlas", "revision": "c929a8b00d3db7062ccffe00f4dd859fe142654bf6d614ccd3b206985869ceba", "status": "design", "renderingRevision": "a01f621fe105b73eb66a0500e97ee60fe72320406102cd5da085a218cf6ce486", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "rk-system-atlas" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-system-atlas", "polarity": "Neutral" }, { "id": "section-worked-designs", "anchor": "worked-designs", "label": "Worked designs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-system-atlas#worked-designs", "polarity": "Neutral" }, { "id": "section-machine-and-reading-editions", "anchor": "machine-and-reading-editions", "label": "Machine and reading editions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-system-atlas#machine-and-reading-editions", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-system-atlas:references-reaktor-graph-theory", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-graph-language-theory", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-home", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "page", "role": "source", "ordinal": 0 }, { "node": "home", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-mobile", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-mobile", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-web", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-web", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-distributed", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-distributed", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-capabilities", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-capabilities", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-workflows", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-games", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-games", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-robotics", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-robotics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:references-reaktor-examples-iot", "kind": "references", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "section-worked-designs", "role": "source", "ordinal": 0 }, { "node": "reaktor-examples-iot", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:requires-reaktor-graph-theory", "kind": "requires", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:requires-reaktor-graph-vocabulary-theory", "kind": "requires", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-vocabulary-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:requires-reaktor-hyperedge-theory", "kind": "requires", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-hyperedge-theory", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-system-atlas:requires-reaktor-graph-language-theory", "kind": "requires", "owner": "reaktor-system-atlas", "incidences": [ { "node": "reaktor-system-atlas", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-language-theory", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-system-atlas.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor system atlas", "level": 0 }, { "id": "worked-designs", "anchor": "worked-designs", "title": "Worked designs", "level": 2 }, { "id": "machine-and-reading-editions", "anchor": "machine-and-reading-editions", "title": "Machine and reading editions", "level": 2 } ], "links": [ { "id": "reaktor-graph-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-language-theory", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "home", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-examples-mobile", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" }, { "id": "reaktor-examples-web", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" }, { "id": "reaktor-examples-distributed", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" }, { "id": "reaktor-examples-capabilities", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" }, { "id": "reaktor-examples-workflows", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" }, { "id": "reaktor-examples-games", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" }, { "id": "reaktor-examples-robotics", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" }, { "id": "reaktor-examples-iot", "anchor": "", "relation": "references", "sourceAnchor": "worked-designs" } ] }, { "id": "reaktor-tooling-layer", "owner": "Claude", "kind": "architecture", "summary": "How reaktor-tooling connects adb, simctl, idb, HTTP proxies and debuggers to the graph protocol without becoming a plugin set: three nouns (probe, adapter, attachment), an attachment that is literally an rgp target so a device-hosted app is addressed exactly as a Worker is, and a six-rung fidelity ladder (discovered, enumerated, sampled, streamed, attributed, interactive) whose rung is a property of a fact rather than of a target — so one device can serve a live graph read, a log stream and a one-shot view dump at once without any of them borrowing the others' credibility. Specifies per-platform transports, the correlation header that joins proxy-observed bytes to graph ports, the constraints on CA install and debugger attach, and the collapse of device commands and graph patches onto one prepare/execute path with one ledger.", "use": "Read before adding any device, capture or debugger capability, or when deciding whether a fact may be presented as live. Section 5 is the fidelity ladder, section 11 records the three decisions taken, section 14 is the build order. This is a design proposal, not shipped behaviour.", "region": "operations-diagnostics", "order": 4, "title": "Reaktor Tooling Layer", "nav": "Tooling Layer", "group": "operations", "subsection": "operations-diagnostics", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-tooling-layer", "revision": "7257191a99bf71dda9845c44623a34dbe3589d4cb902f8ce59ca477693c68cb2", "status": "unverified", "renderingRevision": "3c0ebe7d4d410c326d1459d702a9f82227363365ccda393bdc3a2e251ae2c1d7", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-tooling-layer", "polarity": "Neutral" }, { "id": "section-1-what-exists-today", "anchor": "1-what-exists-today", "label": "1. What exists today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#1-what-exists-today", "polarity": "Neutral" }, { "id": "section-2-why-this-is-not-a-plugin-set", "anchor": "2-why-this-is-not-a-plugin-set", "label": "2. Why this is not a plugin set", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#2-why-this-is-not-a-plugin-set", "polarity": "Neutral" }, { "id": "section-three-nouns", "anchor": "three-nouns", "label": "3. Three nouns", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#three-nouns", "polarity": "Neutral" }, { "id": "section-an-attachment-is-an-rgp-target", "anchor": "an-attachment-is-an-rgp-target", "label": "4. An attachment is an rgp target", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#an-attachment-is-an-rgp-target", "polarity": "Neutral" }, { "id": "section-the-fidelity-ladder", "anchor": "the-fidelity-ladder", "label": "5. The fidelity ladder", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#the-fidelity-ladder", "polarity": "Neutral" }, { "id": "section-6-reach-and-fidelity-are-independent", "anchor": "6-reach-and-fidelity-are-independent", "label": "6. Reach and fidelity are independent", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#6-reach-and-fidelity-are-independent", "polarity": "Neutral" }, { "id": "section-carrier", "anchor": "carrier", "label": "13. The carrier", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#carrier", "polarity": "Neutral" }, { "id": "section-debuggers", "anchor": "debuggers", "label": "10. Debuggers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#debuggers", "polarity": "Neutral" }, { "id": "section-decisions", "anchor": "decisions", "label": "12. Decisions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#decisions", "polarity": "Neutral" }, { "id": "section-review-corrections", "anchor": "review-corrections", "label": "18. Review corrections and adopted libraries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#review-corrections", "polarity": "Neutral" }, { "id": "section-writes", "anchor": "writes", "label": "14. Writes: one plan, one ledger", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#writes", "polarity": "Neutral" }, { "id": "section-order", "anchor": "order", "label": "15. Build order", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#order", "polarity": "Neutral" }, { "id": "section-the-network-proxy", "anchor": "the-network-proxy", "label": "9. The network proxy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#the-network-proxy", "polarity": "Neutral" }, { "id": "section-profilers", "anchor": "profilers", "label": "11. Profilers are probes", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#profilers", "polarity": "Neutral" }, { "id": "section-correlation", "anchor": "correlation", "label": "The correlation header is the join", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#correlation", "polarity": "Neutral" }, { "id": "section-per-fact", "anchor": "per-fact", "label": "The ladder summarises; the contract is a set of independent dimensions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#per-fact", "polarity": "Neutral" }, { "id": "section-trace-format", "anchor": "trace-format", "label": "Trace format", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#trace-format", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#related-docs", "polarity": "Neutral" }, { "id": "section-16-what-this-does-not-give-you", "anchor": "16-what-this-does-not-give-you", "label": "16. What this does not give you", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#16-what-this-does-not-give-you", "polarity": "Neutral" }, { "id": "section-tl-adopt", "anchor": "tl-adopt", "label": "Adopted rather than built", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-tooling-layer#tl-adopt", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-tooling-layer:references-operations", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-operations-graph-evidence", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-operations-profiling", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-devtools", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-trace-format", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-graph-protocol-identity", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-an-attachment-is-an-rgp-target", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-identity", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-graph-protocol-value-domain", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-the-network-proxy", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-value-domain", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-graph-protocol-cost", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-debuggers", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-cost", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-performance-observability-verified", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-profilers", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "section-verified", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-graph-protocol-framing", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-carrier", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-framing", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-graph-protocol-open-decisions", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-16-what-this-does-not-give-you", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "section-open-decisions", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-instrumentation-plan-build-vs-adopt", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-tl-adopt", "role": "source", "ordinal": 0 }, { "node": "reaktor-instrumentation-plan", "port": "section-build-vs-adopt", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-ffi", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-ui-ux-audit-2026-09-08", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-performance-observability", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-tooling-layer:references-reaktor-workbench-layers", "kind": "references", "owner": "reaktor-tooling-layer", "incidences": [ { "node": "reaktor-tooling-layer", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-workbench-layers", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-tooling-layer.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Tooling Layer", "level": 0 }, { "id": "reaktor-tooling-layer", "anchor": "reaktor-tooling-layer", "title": "Reaktor Tooling Layer", "level": 1 }, { "id": "1-what-exists-today", "anchor": "1-what-exists-today", "title": "1. What exists today", "level": 2 }, { "id": "2-why-this-is-not-a-plugin-set", "anchor": "2-why-this-is-not-a-plugin-set", "title": "2. Why this is not a plugin set", "level": 2 }, { "id": "three-nouns", "anchor": "three-nouns", "title": "3. Three nouns", "level": 2 }, { "id": "an-attachment-is-an-rgp-target", "anchor": "an-attachment-is-an-rgp-target", "title": "4. An attachment is an rgp target", "level": 2 }, { "id": "the-fidelity-ladder", "anchor": "the-fidelity-ladder", "title": "5. The fidelity ladder", "level": 2 }, { "id": "per-fact", "anchor": "per-fact", "title": "The ladder summarises; the contract is a set of independent dimensions", "level": 3 }, { "id": "6-reach-and-fidelity-are-independent", "anchor": "6-reach-and-fidelity-are-independent", "title": "6. Reach and fidelity are independent", "level": 2 }, { "id": "7-transports-per-platform", "anchor": "7-transports-per-platform", "title": "7. Transports per platform", "level": 2 }, { "id": "8-interceptors", "anchor": "8-interceptors", "title": "8. Interceptors", "level": 2 }, { "id": "correlation", "anchor": "correlation", "title": "The correlation header is the join", "level": 3 }, { "id": "the-network-proxy", "anchor": "the-network-proxy", "title": "9. The network proxy", "level": 2 }, { "id": "debuggers", "anchor": "debuggers", "title": "10. Debuggers", "level": 2 }, { "id": "profilers", "anchor": "profilers", "title": "11. Profilers are probes", "level": 2 }, { "id": "trace-format", "anchor": "trace-format", "title": "Trace format", "level": 3 }, { "id": "decisions", "anchor": "decisions", "title": "12. Decisions", "level": 2 }, { "id": "carrier", "anchor": "carrier", "title": "13. The carrier", "level": 2 }, { "id": "writes", "anchor": "writes", "title": "14. Writes: one plan, one ledger", "level": 2 }, { "id": "order", "anchor": "order", "title": "15. Build order", "level": 2 }, { "id": "16-what-this-does-not-give-you", "anchor": "16-what-this-does-not-give-you", "title": "16. What this does not give you", "level": 2 }, { "id": "17-acceptance-gates", "anchor": "17-acceptance-gates", "title": "17. Acceptance gates", "level": 2 }, { "id": "review-corrections", "anchor": "review-corrections", "title": "18. Review corrections and adopted libraries", "level": 2 }, { "id": "tl-corrections", "anchor": "tl-corrections", "title": "What changed after the 13 September review", "level": 3 }, { "id": "tl-adopt", "anchor": "tl-adopt", "title": "Adopted rather than built", "level": 3 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-tooling-layer", "anchor": "carrier", "relation": "references", "sourceAnchor": "1-what-exists-today" }, { "id": "reaktor-graph-protocol", "anchor": "identity", "relation": "references", "sourceAnchor": "an-attachment-is-an-rgp-target" }, { "id": "reaktor-tooling-layer", "anchor": "debuggers", "relation": "references", "sourceAnchor": "per-fact" }, { "id": "reaktor-tooling-layer", "anchor": "decisions", "relation": "references", "sourceAnchor": "7-transports-per-platform" }, { "id": "reaktor-tooling-layer", "anchor": "review-corrections", "relation": "references", "sourceAnchor": "8-interceptors" }, { "id": "reaktor-tooling-layer", "anchor": "decisions", "relation": "references", "sourceAnchor": "the-network-proxy" }, { "id": "reaktor-tooling-layer", "anchor": "writes", "relation": "references", "sourceAnchor": "the-network-proxy" }, { "id": "reaktor-graph-protocol", "anchor": "value-domain", "relation": "references", "sourceAnchor": "the-network-proxy" }, { "id": "reaktor-graph-protocol", "anchor": "cost", "relation": "references", "sourceAnchor": "debuggers" }, { "id": "reaktor-tooling-layer", "anchor": "three-nouns", "relation": "references", "sourceAnchor": "profilers" }, { "id": "reaktor-tooling-layer", "anchor": "an-attachment-is-an-rgp-target", "relation": "references", "sourceAnchor": "profilers" }, { "id": "reaktor-tooling-layer", "anchor": "debuggers", "relation": "references", "sourceAnchor": "profilers" }, { "id": "reaktor-tooling-layer", "anchor": "debuggers", "relation": "references", "sourceAnchor": "profilers" }, { "id": "performance-observability", "anchor": "verified", "relation": "references", "sourceAnchor": "profilers" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "trace-format" }, { "id": "reaktor-tooling-layer", "anchor": "carrier", "relation": "references", "sourceAnchor": "decisions" }, { "id": "reaktor-tooling-layer", "anchor": "order", "relation": "references", "sourceAnchor": "decisions" }, { "id": "reaktor-tooling-layer", "anchor": "the-network-proxy", "relation": "references", "sourceAnchor": "decisions" }, { "id": "reaktor-tooling-layer", "anchor": "debuggers", "relation": "references", "sourceAnchor": "decisions" }, { "id": "reaktor-graph-protocol", "anchor": "framing", "relation": "references", "sourceAnchor": "carrier" }, { "id": "reaktor-tooling-layer", "anchor": "profilers", "relation": "references", "sourceAnchor": "order" }, { "id": "reaktor-tooling-layer", "anchor": "correlation", "relation": "references", "sourceAnchor": "order" }, { "id": "reaktor-tooling-layer", "anchor": "debuggers", "relation": "references", "sourceAnchor": "16-what-this-does-not-give-you" }, { "id": "reaktor-graph-protocol", "anchor": "open-decisions", "relation": "references", "sourceAnchor": "16-what-this-does-not-give-you" }, { "id": "reaktor-tooling-layer", "anchor": "per-fact", "relation": "references", "sourceAnchor": "tl-corrections" }, { "id": "reaktor-tooling-layer", "anchor": "correlation", "relation": "references", "sourceAnchor": "tl-corrections" }, { "id": "reaktor-tooling-layer", "anchor": "the-network-proxy", "relation": "references", "sourceAnchor": "tl-corrections" }, { "id": "reaktor-instrumentation-plan", "anchor": "build-vs-adopt", "relation": "references", "sourceAnchor": "tl-adopt" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-tooling-layer", "anchor": "carrier", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-workbench-layers", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08", "owner": "Astra / Codex", "kind": "analysis", "summary": "Living 122-board audit with native narrow/ultrawide evidence: repairs as they land, remaining visual and interaction issues, domain integration gaps and measurable acceptance journeys.", "use": "Use to prioritize and verify UI/UX work while retaining the native Pencil implementation and real graph.", "region": "workbench-surfaces", "order": 0, "title": "Reaktor UI/UX Audit — 8 September 2026", "nav": "UI/UX Audit", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08", "revision": "7e05f07cabc9e7d2d72e80e74890421218f38b1662bb41472049605a21d21812", "status": "unverified", "renderingRevision": "67e3853d2523d0cf0bca72107bd5f74134556f9849e1e2039576dfb6960b5a23", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "repairs-completed-in-this-pass" ], "externalLinks": [ "https://developers.cloudflare.com/workers/wrangler/configuration/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08", "polarity": "Neutral" }, { "id": "section-distance-from-the-full-design-and-vision", "anchor": "distance-from-the-full-design-and-vision", "label": "Distance from the full design and vision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#distance-from-the-full-design-and-vision", "polarity": "Neutral" }, { "id": "section-scope-and-evidence", "anchor": "scope-and-evidence", "label": "Scope and evidence", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#scope-and-evidence", "polarity": "Neutral" }, { "id": "section-decision-order", "anchor": "decision-order", "label": "Decision order", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#decision-order", "polarity": "Neutral" }, { "id": "section-does-this-help-a-bestbuds-developer-ship", "anchor": "does-this-help-a-bestbuds-developer-ship", "label": "Does this help a BestBuds developer ship?", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#does-this-help-a-bestbuds-developer-ship", "polarity": "Neutral" }, { "id": "section-the-capability-inventory", "anchor": "the-capability-inventory", "label": "The capability inventory", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#the-capability-inventory", "polarity": "Neutral" }, { "id": "section-the-four-pillars-at-the-initial-audit", "anchor": "the-four-pillars-at-the-initial-audit", "label": "The four pillars at the initial audit", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#the-four-pillars-at-the-initial-audit", "polarity": "Neutral" }, { "id": "section-developer-workflow-pass--8-september", "anchor": "developer-workflow-pass--8-september", "label": "Developer workflow pass · 8 September", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#developer-workflow-pass--8-september", "polarity": "Neutral" }, { "id": "section-order-of-work", "anchor": "order-of-work", "label": "Order of work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#order-of-work", "polarity": "Neutral" }, { "id": "section-co13--seven-scale-ladders-and-a-self-contradicting-keymap--p1--design-gap", "anchor": "co13--seven-scale-ladders-and-a-self-contradicting-keymap--p1--design-gap", "label": "CO13 — Seven scale ladders and a self-contradicting keymap · P1 · Design gap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#co13--seven-scale-ladders-and-a-self-contradicting-keymap--p1--design-gap", "polarity": "Neutral" }, { "id": "section-g07--graph-authoring-needs-complete-pointer-and-keyboard-workflows--p1--integration-gap", "anchor": "g07--graph-authoring-needs-complete-pointer-and-keyboard-workflows--p1--integration-gap", "label": "G07 — Graph authoring needs complete pointer and keyboard workflows · P1 · Integration gap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#g07--graph-authoring-needs-complete-pointer-and-keyboard-workflows--p1--integration-gap", "polarity": "Neutral" }, { "id": "section-co23--standard-ide-and-editor-affordances-are-absent-everywhere--p1--design-gap", "anchor": "co23--standard-ide-and-editor-affordances-are-absent-everywhere--p1--design-gap", "label": "CO23 — Standard IDE and editor affordances are absent everywhere · P1 · Design gap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#co23--standard-ide-and-editor-affordances-are-absent-everywhere--p1--design-gap", "polarity": "Neutral" }, { "id": "section-n03--pictured-tabs-do-not-yet-behave-as-documents--p1--integration-gap", "anchor": "n03--pictured-tabs-do-not-yet-behave-as-documents--p1--integration-gap", "label": "N03 — Pictured tabs do not yet behave as documents · P1 · Integration gap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#n03--pictured-tabs-do-not-yet-behave-as-documents--p1--integration-gap", "polarity": "Neutral" }, { "id": "section-co18--two-relation-taxonomies-and-eight-layer-stacks-for-one-graph--p2--design-gap", "anchor": "co18--two-relation-taxonomies-and-eight-layer-stacks-for-one-graph--p2--design-gap", "label": "CO18 — Two relation taxonomies and eight layer stacks for one graph · P2 · Design gap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#co18--two-relation-taxonomies-and-eight-layer-stacks-for-one-graph--p2--design-gap", "polarity": "Neutral" }, { "id": "section-n02--visible-local-controls-still-have-no-behavior-or-unavailable-state--p1--observed", "anchor": "n02--visible-local-controls-still-have-no-behavior-or-unavailable-state--p1--observed", "label": "N02 — Visible local controls still have no behavior or unavailable state · P1 · Observed", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#n02--visible-local-controls-still-have-no-behavior-or-unavailable-state--p1--observed", "polarity": "Neutral" }, { "id": "section-v05--there-is-no-product-wide-compact-layout-contract--p1--observed", "anchor": "v05--there-is-no-product-wide-compact-layout-contract--p1--observed", "label": "V05 — There is no product-wide compact-layout contract · P1 · Observed", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#v05--there-is-no-product-wide-compact-layout-contract--p1--observed", "polarity": "Neutral" }, { "id": "section-design-coherence-why-the-atlas-still-reads-as-separate-tools", "anchor": "design-coherence-why-the-atlas-still-reads-as-separate-tools", "label": "Design coherence: why the atlas still reads as separate tools", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#design-coherence-why-the-atlas-still-reads-as-separate-tools", "polarity": "Neutral" }, { "id": "section-data-auth-and-the-software-value-chain", "anchor": "data-auth-and-the-software-value-chain", "label": "Data, auth and the software value chain", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#data-auth-and-the-software-value-chain", "polarity": "Neutral" }, { "id": "section-co08--port-identifiers-are-not-stable-inside-the-new-map-family--p1--observed-introduced-7-september", "anchor": "co08--port-identifiers-are-not-stable-inside-the-new-map-family--p1--observed-introduced-7-september", "label": "CO08 — Port identifiers are not stable inside the new map family · P1 · Observed (introduced 7 September)", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-ui-ux-audit-2026-09-08#co08--port-identifiers-are-not-stable-inside-the-new-map-family--p1--observed-introduced-7-september", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-distance-from-the-full-design-and-vision", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-graph-substrate-redesign-ecosystem-integration", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-distance-from-the-full-design-and-vision", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "section-ecosystem-integration", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-data-auth-and-the-software-value-chain", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-data-auth-and-the-software-value-chain", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-data-auth-and-the-software-value-chain", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-cloud-pane", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-data-auth-and-the-software-value-chain", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-desktop-master-plan", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-data-auth-and-the-software-value-chain", "role": "source", "ordinal": 0 }, { "node": "reaktor-desktop-master-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-ui-ux-audit-2026-09-08:references-reaktor-graph-hierarchical-ui-fixture-ledger", "kind": "references", "owner": "reaktor-ui-ux-audit-2026-09-08", "incidences": [ { "node": "reaktor-ui-ux-audit-2026-09-08", "port": "section-co08--port-identifiers-are-not-stable-inside-the-new-map-family--p1--observed-introduced-7-september", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-fixture-ledger", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-ui-ux-audit-2026-09-08.json", "sections": [ { "id": "reaktor-uiux-audit--8-september-2026", "anchor": "reaktor-uiux-audit--8-september-2026", "title": "Reaktor UI/UX Audit — 8 September 2026", "level": 1 }, { "id": "distance-from-the-full-design-and-vision", "anchor": "distance-from-the-full-design-and-vision", "title": "Distance from the full design and vision", "level": 2 }, { "id": "scope-and-evidence", "anchor": "scope-and-evidence", "title": "Scope and evidence", "level": 2 }, { "id": "status", "anchor": "status", "title": "Status", "level": 3 }, { "id": "priority", "anchor": "priority", "title": "Priority", "level": 3 }, { "id": "decision-order", "anchor": "decision-order", "title": "Decision order", "level": 2 }, { "id": "developer-workflow-pass--8-september", "anchor": "developer-workflow-pass--8-september", "title": "Developer workflow pass · 8 September", "level": 3 }, { "id": "operational-and-adaptive-follow-through--8-september", "anchor": "operational-and-adaptive-follow-through--8-september", "title": "Operational and adaptive follow-through — 8 September", "level": 4 }, { "id": "current-p0-workflow-queue", "anchor": "current-p0-workflow-queue", "title": "Current P0 workflow queue", "level": 4 }, { "id": "viewport-orientation-correction--8-september", "anchor": "viewport-orientation-correction--8-september", "title": "Viewport-orientation correction · 8 September", "level": 3 }, { "id": "schema-and-layout-pass--8-september", "anchor": "schema-and-layout-pass--8-september", "title": "Schema and layout pass · 8 September", "level": 3 }, { "id": "compute-topology-pass--8-september", "anchor": "compute-topology-pass--8-september", "title": "Compute topology pass · 8 September", "level": 3 }, { "id": "pane-anatomy-pass--8-september", "anchor": "pane-anatomy-pass--8-september", "title": "Pane anatomy pass · 8 September", "level": 3 }, { "id": "pane-routing-pass--8-september", "anchor": "pane-routing-pass--8-september", "title": "Pane routing pass · 8 September", "level": 3 }, { "id": "does-this-help-a-bestbuds-developer-ship", "anchor": "does-this-help-a-bestbuds-developer-ship", "title": "Does this help a BestBuds developer ship?", "level": 2 }, { "id": "what-bestbuds-actually-is", "anchor": "what-bestbuds-actually-is", "title": "What BestBuds actually is", "level": 3 }, { "id": "what-a-developer-does-in-a-day", "anchor": "what-a-developer-does-in-a-day", "title": "What a developer does in a day", "level": 3 }, { "id": "what-the-desktop-does-with-them", "anchor": "what-the-desktop-does-with-them", "title": "What the desktop does with them", "level": 3 }, { "id": "three-structural-reasons-not-twelve-small-ones", "anchor": "three-structural-reasons-not-twelve-small-ones", "title": "Three structural reasons, not twelve small ones", "level": 3 }, { "id": "the-honest-verdict", "anchor": "the-honest-verdict", "title": "The honest verdict", "level": 3 }, { "id": "what-would-change-the-answer", "anchor": "what-would-change-the-answer", "title": "What would change the answer", "level": 3 }, { "id": "the-capability-inventory", "anchor": "the-capability-inventory", "title": "The capability inventory", "level": 2 }, { "id": "compute", "anchor": "compute", "title": "Compute", "level": 3 }, { "id": "data", "anchor": "data", "title": "Data", "level": 3 }, { "id": "auth", "anchor": "auth", "title": "Auth", "level": 3 }, { "id": "device-tools", "anchor": "device-tools", "title": "Device tools", "level": 3 }, { "id": "c04--the-documented-deploy-order-contradicts-the-service-bindings--s0--observed", "anchor": "c04--the-documented-deploy-order-contradicts-the-service-bindings--s0--observed", "title": "C04 — The documented deploy order contradicts the service bindings · S0 · Observed", "level": 3 }, { "id": "the-four-pillars-at-the-initial-audit", "anchor": "the-four-pillars-at-the-initial-audit", "title": "The four pillars at the initial audit", "level": 2 }, { "id": "the-window--band-0", "anchor": "the-window--band-0", "title": "The window · Band 0", "level": 3 }, { "id": "w01--only-graph-opened-a-tool-twelve-modes-opened-a-picture--s0--fixed--verified-f24", "anchor": "w01--only-graph-opened-a-tool-twelve-modes-opened-a-picture--s0--fixed--verified-f24", "title": "W01 — Only Graph opened a tool; twelve modes opened a picture · S0 · Fixed / verified (F24)", "level": 4 }, { "id": "w02--the-domain-panes-were-implemented-tested-and-unreachable--s0--fixed--verified-f25", "anchor": "w02--the-domain-panes-were-implemented-tested-and-unreachable--s0--fixed--verified-f25", "title": "W02 — The domain panes were implemented, tested, and unreachable · S0 · Fixed / verified (F25)", "level": 4 }, { "id": "w03--the-window-disagreed-about-which-application-is-open--s0--fixed--verified-f26", "anchor": "w03--the-window-disagreed-about-which-application-is-open--s0--fixed--verified-f26", "title": "W03 — The window disagreed about which application is open · S0 · Fixed / verified (F26)", "level": 4 }, { "id": "w04--two-tool-strips-and-two-counts-that-count-something-else--s1--partly-repaired-f24--open", "anchor": "w04--two-tool-strips-and-two-counts-that-count-something-else--s1--partly-repaired-f24--open", "title": "W04 — Two tool strips, and two counts that count something else · S1 · Partly repaired (F24) · Open", "level": 4 }, { "id": "w05--the-left-panel-is-named-four-ways--s1--observed", "anchor": "w05--the-left-panel-is-named-four-ways--s1--observed", "title": "W05 — The left panel is named four ways · S1 · Observed", "level": 4 }, { "id": "w06--the-design-file-and-the-app-disagree-about-what-the-modes-are--s1--observed", "anchor": "w06--the-design-file-and-the-app-disagree-about-what-the-modes-are--s1--observed", "title": "W06 — The design file and the app disagree about what the modes are · S1 · Observed", "level": 4 }, { "id": "w07--the-live-shell-has-no-compact-layout-contract--s1--observed", "anchor": "w07--the-live-shell-has-no-compact-layout-contract--s1--observed", "title": "W07 — The live shell has no compact-layout contract · S1 · Observed", "level": 4 }, { "id": "w08--one-gesture-two-meanings--s2--fixed--verified-f27", "anchor": "w08--one-gesture-two-meanings--s2--fixed--verified-f27", "title": "W08 — One gesture, two meanings · S2 · Fixed / verified (F27)", "level": 4 }, { "id": "x01--the-subpanes-are-skeletons-measured--s1--measured", "anchor": "x01--the-subpanes-are-skeletons-measured--s1--measured", "title": "X01 — The subpanes are skeletons, measured · S1 · Measured", "level": 4 }, { "id": "graph--band-1", "anchor": "graph--band-1", "title": "Graph · Band 1", "level": 3 }, { "id": "gr01--no-semantic-zoom-so-the-map-is-unreadable-at-every-useful-scale--s0--observed", "anchor": "gr01--no-semantic-zoom-so-the-map-is-unreadable-at-every-useful-scale--s0--observed", "title": "GR01 — No semantic zoom, so the map is unreadable at every useful scale · S0 · Observed", "level": 4 }, { "id": "gr02--the-layout-is-a-fixed-grid-and-it-is-not-saved--s0--observed", "anchor": "gr02--the-layout-is-a-fixed-grid-and-it-is-not-saved--s0--observed", "title": "GR02 — The layout is a fixed grid, and it is not saved · S0 · Observed", "level": 4 }, { "id": "gr03--one-window-five-disagreeing-counts--s1--observed", "anchor": "gr03--one-window-five-disagreeing-counts--s1--observed", "title": "GR03 — One window, five disagreeing counts · S1 · Observed", "level": 4 }, { "id": "gr04--the-inspector-tab-row-is-clipped-at-every-window-size--s1--observed", "anchor": "gr04--the-inspector-tab-row-is-clipped-at-every-window-size--s1--observed", "title": "GR04 — The inspector tab row is clipped at every window size · S1 · Observed", "level": 4 }, { "id": "gr05--no-selection-or-authoring-gestures--s1--observed", "anchor": "gr05--no-selection-or-authoring-gestures--s1--observed", "title": "GR05 — No selection or authoring gestures · S1 · Observed", "level": 4 }, { "id": "gr06--the-graph-toolbar-mixes-four-kinds-of-control-in-one-row--s2--observed", "anchor": "gr06--the-graph-toolbar-mixes-four-kinds-of-control-in-one-row--s2--observed", "title": "GR06 — The graph toolbar mixes four kinds of control in one row · S2 · Observed", "level": 4 }, { "id": "gr07--the-graph-is-not-a-document-like-everything-else--s2--observed", "anchor": "gr07--the-graph-is-not-a-document-like-everything-else--s2--observed", "title": "GR07 — The graph is not a document like everything else · S2 · Observed", "level": 4 }, { "id": "gr08--the-design-file-has-no-graph-pane-contract-at-all--s1--observed", "anchor": "gr08--the-design-file-has-no-graph-pane-contract-at-all--s1--observed", "title": "GR08 — The design file has no graph pane contract at all · S1 · Observed", "level": 4 }, { "id": "gr10--relations-are-drawn-but-not-readable--s1--observed", "anchor": "gr10--relations-are-drawn-but-not-readable--s1--observed", "title": "GR10 — Relations are drawn but not readable · S1 · Observed", "level": 4 }, { "id": "gr11--expand-and-collapse-do-not-behave-as-one-gesture--s1--observed", "anchor": "gr11--expand-and-collapse-do-not-behave-as-one-gesture--s1--observed", "title": "GR11 — Expand and collapse do not behave as one gesture · S1 · Observed", "level": 4 }, { "id": "gr12--the-navigator-is-a-list-of-sections-not-an-instrument--s1--design-gap", "anchor": "gr12--the-navigator-is-a-list-of-sections-not-an-instrument--s1--design-gap", "title": "GR12 — The navigator is a list of sections, not an instrument · S1 · Design gap", "level": 4 }, { "id": "gr09--the-minimap-is-an-unlabelled-blob--s2--observed", "anchor": "gr09--the-minimap-is-an-unlabelled-blob--s2--observed", "title": "GR09 — The minimap is an unlabelled blob · S2 · Observed", "level": 4 }, { "id": "database--band-2", "anchor": "database--band-2", "title": "Database · Band 2", "level": 3 }, { "id": "db01--there-is-no-connection--s0--observed", "anchor": "db01--there-is-no-connection--s0--observed", "title": "DB01 — There is no connection · S0 · Observed", "level": 4 }, { "id": "db02--there-is-no-query-editor--s0--observed", "anchor": "db02--there-is-no-query-editor--s0--observed", "title": "DB02 — There is no query editor · S0 · Observed", "level": 4 }, { "id": "db03--the-implemented-query-subpane-is-an-empty-frame--s0--observed", "anchor": "db03--the-implemented-query-subpane-is-an-empty-frame--s0--observed", "title": "DB03 — The implemented Query subpane is an empty frame · S0 · Observed", "level": 4 }, { "id": "db04--schema-migrations-and-history-are-pictures--s1--observed", "anchor": "db04--schema-migrations-and-history-are-pictures--s1--observed", "title": "DB04 — Schema, Migrations and History are pictures · S1 · Observed", "level": 4 }, { "id": "db05--the-result-grid-is-not-a-grid--s1--observed", "anchor": "db05--the-result-grid-is-not-a-grid--s1--observed", "title": "DB05 — The result grid is not a grid · S1 · Observed", "level": 4 }, { "id": "db06--the-design-file-draws-one-screen-for-seven-tabs--s1--observed", "anchor": "db06--the-design-file-draws-one-screen-for-seven-tabs--s1--observed", "title": "DB06 — The design file draws one screen for seven tabs · S1 · Observed", "level": 4 }, { "id": "db07--the-pane-defers-to-a-database-tool-that-is-elsewhere--s2--observed", "anchor": "db07--the-pane-defers-to-a-database-tool-that-is-elsewhere--s2--observed", "title": "DB07 — The pane defers to a database tool that is elsewhere · S2 · Observed", "level": 4 }, { "id": "db08--the-chrome-contradicts-the-document--s1--observed", "anchor": "db08--the-chrome-contradicts-the-document--s1--observed", "title": "DB08 — The chrome contradicts the document · S1 · Observed", "level": 4 }, { "id": "auth--band-3", "anchor": "auth--band-3", "title": "Auth · Band 3", "level": 3 }, { "id": "au01--the-mode-promises-six-surfaces-and-shows-one-paragraph--s0--observed", "anchor": "au01--the-mode-promises-six-surfaces-and-shows-one-paragraph--s0--observed", "title": "AU01 — The mode promises six surfaces and shows one paragraph · S0 · Observed", "level": 4 }, { "id": "au02--the-implemented-providers-subpane-is-an-empty-list--s0--observed", "anchor": "au02--the-implemented-providers-subpane-is-an-empty-list--s0--observed", "title": "AU02 — The implemented Providers subpane is an empty list · S0 · Observed", "level": 4 }, { "id": "au03--the-simulation-boundary-is-a-paragraph-not-a-control--s1--observed", "anchor": "au03--the-simulation-boundary-is-a-paragraph-not-a-control--s1--observed", "title": "AU03 — The simulation boundary is a paragraph, not a control · S1 · Observed", "level": 4 }, { "id": "au04--auth-has-no-navigation--s1--observed", "anchor": "au04--auth-has-no-navigation--s1--observed", "title": "AU04 — Auth has no navigation · S1 · Observed", "level": 4 }, { "id": "au05--three-of-six-auth-subpanes-are-never-drawn-as-active--s1--observed", "anchor": "au05--three-of-six-auth-subpanes-are-never-drawn-as-active--s1--observed", "title": "AU05 — Three of six auth subpanes are never drawn as active · S1 · Observed", "level": 4 }, { "id": "device-tools--band-4", "anchor": "device-tools--band-4", "title": "Device tools · Band 4", "level": 3 }, { "id": "dt01--reaktor-has-no-developer-tools--s0--observed", "anchor": "dt01--reaktor-has-no-developer-tools--s0--observed", "title": "DT01 — Reaktor has no developer tools · S0 · Observed", "level": 4 }, { "id": "dt02--the-property-inspector-looks-editable-and-is-not--s1--observed", "anchor": "dt02--the-property-inspector-looks-editable-and-is-not--s1--observed", "title": "DT02 — The property inspector looks editable and is not · S1 · Observed", "level": 4 }, { "id": "dt03--every-result-says-fixture--s1--observed", "anchor": "dt03--every-result-says-fixture--s1--observed", "title": "DT03 — Every result says fixture · S1 · Observed", "level": 4 }, { "id": "dt04--two-different-jobs-share-one-mode--s1--design-gap", "anchor": "dt04--two-different-jobs-share-one-mode--s1--design-gap", "title": "DT04 — Two different jobs share one mode · S1 · Design gap", "level": 4 }, { "id": "dt05--logs-and-source-are-never-drawn-as-active--s2--observed", "anchor": "dt05--logs-and-source-are-never-drawn-as-active--s2--observed", "title": "DT05 — Logs and Source are never drawn as active · S2 · Observed", "level": 4 }, { "id": "recorded-repairs", "anchor": "recorded-repairs", "title": "Recorded repairs", "level": 2 }, { "id": "compact-layout-pass--8-september", "anchor": "compact-layout-pass--8-september", "title": "Compact-layout pass · 8 September", "level": 3 }, { "id": "remaining-visual-and-layout-issues", "anchor": "remaining-visual-and-layout-issues", "title": "Remaining visual and layout issues", "level": 2 }, { "id": "v01--exact-pencil-raster-parity-remains-unqualified--p0--open", "anchor": "v01--exact-pencil-raster-parity-remains-unqualified--p0--open", "title": "V01 — Exact Pencil raster parity remains unqualified · P0 · Open", "level": 3 }, { "id": "v02--narrow-layouts-truncate-primary-identities--p1--fixed--verified-f22", "anchor": "v02--narrow-layouts-truncate-primary-identities--p1--fixed--verified-f22", "title": "V02 — Narrow layouts truncate primary identities · P1 · Fixed / verified (F22)", "level": 3 }, { "id": "v03--narrow-decision-flows-lose-their-outcome-offscreen--p1--partly-repaired-f23--open", "anchor": "v03--narrow-decision-flows-lose-their-outcome-offscreen--p1--partly-repaired-f23--open", "title": "V03 — Narrow decision flows lose their outcome offscreen · P1 · Partly repaired (F23) · Open", "level": 3 }, { "id": "v04--ultrawide-layouts-stretch-relationships-too-far-apart--p2--observed", "anchor": "v04--ultrawide-layouts-stretch-relationships-too-far-apart--p2--observed", "title": "V04 — Ultrawide layouts stretch relationships too far apart · P2 · Observed", "level": 3 }, { "id": "v05--there-is-no-product-wide-compact-layout-contract--p1--observed", "anchor": "v05--there-is-no-product-wide-compact-layout-contract--p1--observed", "title": "V05 — There is no product-wide compact-layout contract · P1 · Observed", "level": 3 }, { "id": "v06--graph-wires-and-annotations-still-compete-with-text--p1--observed", "anchor": "v06--graph-wires-and-annotations-still-compete-with-text--p1--observed", "title": "V06 — Graph wires and annotations still compete with text · P1 · Observed", "level": 3 }, { "id": "v07--toolbars-can-overflow-without-a-clear-overflow-menu--p2--partly-repaired-f23--open", "anchor": "v07--toolbars-can-overflow-without-a-clear-overflow-menu--p2--partly-repaired-f23--open", "title": "V07 — Toolbars can overflow without a clear overflow menu · P2 · Partly repaired (F23) · Open", "level": 3 }, { "id": "v08--tiny-metadata-and-map-labels-need-readability-qualification--p2--measured", "anchor": "v08--tiny-metadata-and-map-labels-need-readability-qualification--p2--measured", "title": "V08 — Tiny metadata and map labels need readability qualification · P2 · Measured", "level": 3 }, { "id": "v09--fit-ui-presentation-scale-and-graph-camera-zoom-can-be-confused--p2--observed", "anchor": "v09--fit-ui-presentation-scale-and-graph-camera-zoom-can-be-confused--p2--observed", "title": "V09 — Fit, UI presentation scale and graph camera zoom can be confused · P2 · Observed", "level": 3 }, { "id": "v10--no-overlap-currently-has-incomplete-test-coverage--p1--qualification-gap", "anchor": "v10--no-overlap-currently-has-incomplete-test-coverage--p1--qualification-gap", "title": "V10 — “No overlap” currently has incomplete test coverage · P1 · Qualification gap", "level": 3 }, { "id": "shell-navigation-and-everyday-editing", "anchor": "shell-navigation-and-everyday-editing", "title": "Shell, navigation and everyday editing", "level": 2 }, { "id": "n01--the-workbench-still-switches-complete-boards-instead-of-sharing-one-document-workspace--p1--integration-gap", "anchor": "n01--the-workbench-still-switches-complete-boards-instead-of-sharing-one-document-workspace--p1--integration-gap", "title": "N01 — The workbench still switches complete boards instead of sharing one document workspace · P1 · Integration gap", "level": 3 }, { "id": "n02--visible-local-controls-still-have-no-behavior-or-unavailable-state--p1--observed", "anchor": "n02--visible-local-controls-still-have-no-behavior-or-unavailable-state--p1--observed", "title": "N02 — Visible local controls still have no behavior or unavailable state · P1 · Observed", "level": 3 }, { "id": "n03--pictured-tabs-do-not-yet-behave-as-documents--p1--integration-gap", "anchor": "n03--pictured-tabs-do-not-yet-behave-as-documents--p1--integration-gap", "title": "N03 — Pictured tabs do not yet behave as documents · P1 · Integration gap", "level": 3 }, { "id": "n04--displayed-source-queries-and-identifiers-are-not-full-editingcopy-surfaces--p1--observed", "anchor": "n04--displayed-source-queries-and-identifiers-are-not-full-editingcopy-surfaces--p1--observed", "title": "N04 — Displayed source, queries and identifiers are not full editing/copy surfaces · P1 · Observed", "level": 3 }, { "id": "n05--authored-context-does-not-follow-active-application-context--p1--observed", "anchor": "n05--authored-context-does-not-follow-active-application-context--p1--observed", "title": "N05 — Authored context does not follow active application context · P1 · Observed", "level": 3 }, { "id": "n06--search-has-inconsistent-scope-between-live-and-authored-workspaces--p2--observed", "anchor": "n06--search-has-inconsistent-scope-between-live-and-authored-workspaces--p2--observed", "title": "N06 — Search has inconsistent scope between live and authored workspaces · P2 · Observed", "level": 3 }, { "id": "n07--the-surface-chooser-mixes-product-navigation-and-design-review--p2--observed", "anchor": "n07--the-surface-chooser-mixes-product-navigation-and-design-review--p2--observed", "title": "N07 — The surface chooser mixes product navigation and design review · P2 · Observed", "level": 3 }, { "id": "n08--layout-control-is-incomplete--p2--integration-gap", "anchor": "n08--layout-control-is-incomplete--p2--integration-gap", "title": "N08 — Layout control is incomplete · P2 · Integration gap", "level": 3 }, { "id": "n09--statuscontext-vocabulary-is-too-compressed-in-some-instruments--p2--observed", "anchor": "n09--statuscontext-vocabulary-is-too-compressed-in-some-instruments--p2--observed", "title": "N09 — Status/context vocabulary is too compressed in some instruments · P2 · Observed", "level": 3 }, { "id": "living-graph-interaction-gaps", "anchor": "living-graph-interaction-gaps", "title": "Living Graph interaction gaps", "level": 2 }, { "id": "g01--the-continuous-system-map-is-still-a-set-of-authored-states--p1--integration-gap", "anchor": "g01--the-continuous-system-map-is-still-a-set-of-authored-states--p1--integration-gap", "title": "G01 — The continuous system map is still a set of authored states · P1 · Integration gap", "level": 3 }, { "id": "g02--layer-controls-need-executable-inspectable-query-semantics--p1--integration-gap", "anchor": "g02--layer-controls-need-executable-inspectable-query-semantics--p1--integration-gap", "title": "G02 — Layer controls need executable, inspectable query semantics · P1 · Integration gap", "level": 3 }, { "id": "g03--graph-wide-selection-linkage-remains-incomplete--p1--integration-gap", "anchor": "g03--graph-wide-selection-linkage-remains-incomplete--p1--integration-gap", "title": "G03 — Graph-wide selection linkage remains incomplete · P1 · Integration gap", "level": 3 }, { "id": "g04--route-navigation-needs-a-complete-interaction-contract--p1--integration-gap", "anchor": "g04--route-navigation-needs-a-complete-interaction-contract--p1--integration-gap", "title": "G04 — Route navigation needs a complete interaction contract · P1 · Integration gap", "level": 3 }, { "id": "g05--maps-need-scalable-density-and-label-management--p1--observed-design-gap", "anchor": "g05--maps-need-scalable-density-and-label-management--p1--observed-design-gap", "title": "G05 — Maps need scalable density and label management · P1 · Observed design gap", "level": 3 }, { "id": "g06--camera-selection-and-execution-history-need-separate-visible-controls--p2--integration-gap", "anchor": "g06--camera-selection-and-execution-history-need-separate-visible-controls--p2--integration-gap", "title": "G06 — Camera, selection and execution history need separate visible controls · P2 · Integration gap", "level": 3 }, { "id": "g07--graph-authoring-needs-complete-pointer-and-keyboard-workflows--p1--integration-gap", "anchor": "g07--graph-authoring-needs-complete-pointer-and-keyboard-workflows--p1--integration-gap", "title": "G07 — Graph authoring needs complete pointer and keyboard workflows · P1 · Integration gap", "level": 3 }, { "id": "g08--compare-and-graph-commits-need-legible-change-semantics--p1--integration-gap", "anchor": "g08--compare-and-graph-commits-need-legible-change-semantics--p1--integration-gap", "title": "G08 — Compare and graph commits need legible change semantics · P1 · Integration gap", "level": 3 }, { "id": "g09--discovery-and-partial-topology-need-actionable-empty-states--p2--design-gap", "anchor": "g09--discovery-and-partial-topology-need-actionable-empty-states--p2--design-gap", "title": "G09 — Discovery and partial topology need actionable empty states · P2 · Design gap", "level": 3 }, { "id": "data-auth-and-the-software-value-chain", "anchor": "data-auth-and-the-software-value-chain", "title": "Data, auth and the software value chain", "level": 2 }, { "id": "accessibility-discoverability-and-failure-qualification", "anchor": "accessibility-discoverability-and-failure-qualification", "title": "Accessibility, discoverability and failure qualification", "level": 2 }, { "id": "design-coherence-why-the-atlas-still-reads-as-separate-tools", "anchor": "design-coherence-why-the-atlas-still-reads-as-separate-tools", "title": "Design coherence: why the atlas still reads as separate tools", "level": 2 }, { "id": "co01--five-information-architectures-compete--p1--design-gap", "anchor": "co01--five-information-architectures-compete--p1--design-gap", "title": "CO01 — Five information architectures compete · P1 · Design gap", "level": 3 }, { "id": "co02--three-shell-generations-and-the-proofs-belong-to-the-wrong-one--p1--design-gap", "anchor": "co02--three-shell-generations-and-the-proofs-belong-to-the-wrong-one--p1--design-gap", "title": "CO02 — Three shell generations, and the proofs belong to the wrong one · P1 · Design gap", "level": 3 }, { "id": "co03--shell-c-never-reflects-the-document-it-shows--p1--observed", "anchor": "co03--shell-c-never-reflects-the-document-it-shows--p1--observed", "title": "CO03 — Shell C never reflects the document it shows · P1 · Observed", "level": 3 }, { "id": "co04--slides-wearing-the-shell-instead-of-states-of-an-instrument--p1--design-gap", "anchor": "co04--slides-wearing-the-shell-instead-of-states-of-an-instrument--p1--design-gap", "title": "CO04 — Slides wearing the shell instead of states of an instrument · P1 · Design gap", "level": 3 }, { "id": "co05--failure-and-progress-are-invisible-states-exist-only-as-breadcrumb-text--p1--observed", "anchor": "co05--failure-and-progress-are-invisible-states-exist-only-as-breadcrumb-text--p1--observed", "title": "CO05 — Failure and progress are invisible; states exist only as breadcrumb text · P1 · Observed", "level": 3 }, { "id": "co06--two-revision-universes-r19-means-three-things--p1--observed", "anchor": "co06--two-revision-universes-r19-means-three-things--p1--observed", "title": "CO06 — Two revision universes; r19 means three things · P1 · Observed", "level": 3 }, { "id": "co07--identifier-collisions-across-boards--p1--observed", "anchor": "co07--identifier-collisions-across-boards--p1--observed", "title": "CO07 — Identifier collisions across boards · P1 · Observed", "level": 3 }, { "id": "co08--port-identifiers-are-not-stable-inside-the-new-map-family--p1--observed-introduced-7-september", "anchor": "co08--port-identifiers-are-not-stable-inside-the-new-map-family--p1--observed-introduced-7-september", "title": "CO08 — Port identifiers are not stable inside the new map family · P1 · Observed (introduced 7 September)", "level": 3 }, { "id": "co09--turn-12-of-local7-is-recorded-twice-incompatibly--p1--observed", "anchor": "co09--turn-12-of-local7-is-recorded-twice-incompatibly--p1--observed", "title": "CO09 — Turn 12 of local/7 is recorded twice, incompatibly · P1 · Observed", "level": 3 }, { "id": "co10--δ43-δ44-and-δ45-each-mean-several-changes-the-compare-row-is-boilerplate--p1--observed", "anchor": "co10--δ43-δ44-and-δ45-each-mean-several-changes-the-compare-row-is-boilerplate--p1--observed", "title": "CO10 — Δ43, Δ44 and Δ45 each mean several changes; the compare row is boilerplate · P1 · Observed", "level": 3 }, { "id": "co11--one-role-many-names--p1--observed", "anchor": "co11--one-role-many-names--p1--observed", "title": "CO11 — One role, many names · P1 · Observed", "level": 3 }, { "id": "co12--counts-disagree-for-one-scope--p1--observed", "anchor": "co12--counts-disagree-for-one-scope--p1--observed", "title": "CO12 — Counts disagree for one scope · P1 · Observed", "level": 3 }, { "id": "co13--seven-scale-ladders-and-a-self-contradicting-keymap--p1--design-gap", "anchor": "co13--seven-scale-ladders-and-a-self-contradicting-keymap--p1--design-gap", "title": "CO13 — Seven scale ladders and a self-contradicting keymap · P1 · Design gap", "level": 3 }, { "id": "co14--panel-names-are-invented-per-board--p2--observed", "anchor": "co14--panel-names-are-invented-per-board--p2--observed", "title": "CO14 — Panel names are invented per board · P2 · Observed", "level": 3 }, { "id": "co15--verbs-and-progress-models-drift--p2--observed", "anchor": "co15--verbs-and-progress-models-drift--p2--observed", "title": "CO15 — Verbs and progress models drift · P2 · Observed", "level": 3 }, { "id": "co16--provenance-is-written-in-many-registers-and-leaks-into-data--p1--observed", "anchor": "co16--provenance-is-written-in-many-registers-and-leaks-into-data--p1--observed", "title": "CO16 — Provenance is written in many registers and leaks into data · P1 · Observed", "level": 3 }, { "id": "co17--colours-carry-three-to-five-meanings-each--p1--design-gap", "anchor": "co17--colours-carry-three-to-five-meanings-each--p1--design-gap", "title": "CO17 — Colours carry three to five meanings each · P1 · Design gap", "level": 3 }, { "id": "co18--two-relation-taxonomies-and-eight-layer-stacks-for-one-graph--p2--design-gap", "anchor": "co18--two-relation-taxonomies-and-eight-layer-stacks-for-one-graph--p2--design-gap", "title": "CO18 — Two relation taxonomies and eight layer stacks for one graph · P2 · Design gap", "level": 3 }, { "id": "co19--type-ramp-regression-and-density--p1--measured-partly-introduced-7-september", "anchor": "co19--type-ramp-regression-and-density--p1--measured-partly-introduced-7-september", "title": "CO19 — Type-ramp regression and density · P1 · Measured (partly introduced 7 September)", "level": 3 }, { "id": "co20--fake-precision-and-constant-evidence-blocks--p1--observed", "anchor": "co20--fake-precision-and-constant-evidence-blocks--p1--observed", "title": "CO20 — Fake precision and constant evidence blocks · P1 · Observed", "level": 3 }, { "id": "co21--fixture-universes-and-the-example-switch--p2--observed", "anchor": "co21--fixture-universes-and-the-example-switch--p2--observed", "title": "CO21 — Fixture universes and the example switch · P2 · Observed", "level": 3 }, { "id": "co22--redundant-boards-and-template-clones--p2--observed", "anchor": "co22--redundant-boards-and-template-clones--p2--observed", "title": "CO22 — Redundant boards and template clones · P2 · Observed", "level": 3 }, { "id": "co23--standard-ide-and-editor-affordances-are-absent-everywhere--p1--design-gap", "anchor": "co23--standard-ide-and-editor-affordances-are-absent-everywhere--p1--design-gap", "title": "CO23 — Standard IDE and editor affordances are absent everywhere · P1 · Design gap", "level": 3 }, { "id": "co24--atlas-registry-and-document-noise--p2--observed", "anchor": "co24--atlas-registry-and-document-noise--p2--observed", "title": "CO24 — Atlas, registry and document noise · P2 · Observed", "level": 3 }, { "id": "co25--the-rendered-subpane-set-is-not-the-authored-subpane-set-and-no-gate-compares-them--p1--observed", "anchor": "co25--the-rendered-subpane-set-is-not-the-authored-subpane-set-and-no-gate-compares-them--p1--observed", "title": "CO25 — The rendered subpane set is not the authored subpane set, and no gate compares them · P1 · Observed", "level": 3 }, { "id": "co26--one-shell-renders-under-six-headings-twice-under-a-heading-that-promises-something-else--p1--observed", "anchor": "co26--one-shell-renders-under-six-headings-twice-under-a-heading-that-promises-something-else--p1--observed", "title": "CO26 — One shell renders under six headings, twice under a heading that promises something else · P1 · Observed", "level": 3 }, { "id": "co27--panes-are-authored-to-fill-a-quarter-of-their-height--p1--measured", "anchor": "co27--panes-are-authored-to-fill-a-quarter-of-their-height--p1--measured", "title": "CO27 — Panes are authored to fill a quarter of their height · P1 · Measured", "level": 3 }, { "id": "co28--the-coverage-metric-measures-wiring-not-what-the-pane-shows--p2--observed", "anchor": "co28--the-coverage-metric-measures-wiring-not-what-the-pane-shows--p2--observed", "title": "CO28 — The coverage metric measures wiring, not what the pane shows · P2 · Observed", "level": 3 }, { "id": "competing-vocabularies-at-a-glance", "anchor": "competing-vocabularies-at-a-glance", "title": "Competing vocabularies at a glance", "level": 3 }, { "id": "what-resolves-the-co-family", "anchor": "what-resolves-the-co-family", "title": "What resolves the CO family", "level": 3 }, { "id": "order-of-work", "anchor": "order-of-work", "title": "Order of work", "level": 2 }, { "id": "band-0--the-window--do-these-first", "anchor": "band-0--the-window--do-these-first", "title": "Band 0 · The window — do these first", "level": 3 }, { "id": "band-05--the-three-planes", "anchor": "band-05--the-three-planes", "title": "Band 0.5 · The three planes", "level": 3 }, { "id": "band-1--graph", "anchor": "band-1--graph", "title": "Band 1 · Graph", "level": 3 }, { "id": "band-2--database", "anchor": "band-2--database", "title": "Band 2 · Database", "level": 3 }, { "id": "band-3--auth", "anchor": "band-3--auth", "title": "Band 3 · Auth", "level": 3 }, { "id": "band-4--device-tools", "anchor": "band-4--device-tools", "title": "Band 4 · Device tools", "level": 3 }, { "id": "band-5--one-vocabulary-the-four-pillars-inherit", "anchor": "band-5--one-vocabulary-the-four-pillars-inherit", "title": "Band 5 · One vocabulary the four pillars inherit", "level": 3 }, { "id": "band-6--supporting-surfaces", "anchor": "band-6--supporting-surfaces", "title": "Band 6 · Supporting surfaces", "level": 3 }, { "id": "band-7--qualification-accessibility-and-polish", "anchor": "band-7--qualification-accessibility-and-polish", "title": "Band 7 · Qualification, accessibility and polish", "level": 3 }, { "id": "architecture-changes-that-resolve-several-issues-together", "anchor": "architecture-changes-that-resolve-several-issues-together", "title": "Architecture changes that resolve several issues together", "level": 2 }, { "id": "one-persistent-workbench-context", "anchor": "one-persistent-workbench-context", "title": "One persistent workbench context", "level": 3 }, { "id": "one-command-registry-with-visible-availability", "anchor": "one-command-registry-with-visible-availability", "title": "One command registry with visible availability", "level": 3 }, { "id": "one-document-and-docking-model", "anchor": "one-document-and-docking-model", "title": "One document and docking model", "level": 3 }, { "id": "responsive-policies-above-the-layout-kernel", "anchor": "responsive-policies-above-the-layout-kernel", "title": "Responsive policies above the layout kernel", "level": 3 }, { "id": "graph-interaction-as-the-common-foundation", "anchor": "graph-interaction-as-the-common-foundation", "title": "Graph interaction as the common foundation", "level": 3 }, { "id": "the-source-plane-is-a-projection-not-an-embedded-editor", "anchor": "the-source-plane-is-a-projection-not-an-embedded-editor", "title": "The source plane is a projection, not an embedded editor", "level": 3 }, { "id": "acceptance-journeys", "anchor": "acceptance-journeys", "title": "Acceptance journeys", "level": 2 }, { "id": "implementation-ownership-and-order", "anchor": "implementation-ownership-and-order", "title": "Implementation ownership and order", "level": 2 }, { "id": "verification-record", "anchor": "verification-record", "title": "Verification record", "level": 2 }, { "id": "full-pane-sweep--8-september", "anchor": "full-pane-sweep--8-september", "title": "Full pane sweep · 8 September", "level": 3 }, { "id": "perspectives-pass--8-september", "anchor": "perspectives-pass--8-september", "title": "Perspectives pass · 8 September", "level": 3 }, { "id": "pane-inventory-pass--8-september", "anchor": "pane-inventory-pass--8-september", "title": "Pane inventory pass · 8 September", "level": 3 }, { "id": "pane-anatomy-pass--8-september-1", "anchor": "pane-anatomy-pass--8-september-1", "title": "Pane anatomy pass · 8 September", "level": 3 }, { "id": "pane-routing-pass--8-september-1", "anchor": "pane-routing-pass--8-september-1", "title": "Pane routing pass · 8 September", "level": 3 }, { "id": "discovery-pass--8-september", "anchor": "discovery-pass--8-september", "title": "Discovery pass · 8 September", "level": 3 }, { "id": "compact-layout-pass--8-september-1", "anchor": "compact-layout-pass--8-september-1", "title": "Compact-layout pass · 8 September", "level": 3 }, { "id": "previous-pass", "anchor": "previous-pass", "title": "Previous pass", "level": 3 }, { "id": "what-this-audit-does-not-claim", "anchor": "what-this-audit-does-not-claim", "title": "What this audit does not claim", "level": 3 }, { "id": "full-board-coverage-ledger", "anchor": "full-board-coverage-ledger", "title": "Full board coverage ledger", "level": 2 } ], "links": [ { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "developer-workflow-pass--8-september", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "distance-from-the-full-design-and-vision" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "ecosystem-integration", "relation": "references", "sourceAnchor": "distance-from-the-full-design-and-vision" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "order-of-work", "relation": "references", "sourceAnchor": "priority" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "co13--seven-scale-ladders-and-a-self-contradicting-keymap--p1--design-gap", "relation": "references", "sourceAnchor": "gr01--no-semantic-zoom-so-the-map-is-unreadable-at-every-useful-scale--s0--observed" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "g07--graph-authoring-needs-complete-pointer-and-keyboard-workflows--p1--integration-gap", "relation": "references", "sourceAnchor": "gr05--no-selection-or-authoring-gestures--s1--observed" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "co23--standard-ide-and-editor-affordances-are-absent-everywhere--p1--design-gap", "relation": "references", "sourceAnchor": "gr05--no-selection-or-authoring-gestures--s1--observed" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "n03--pictured-tabs-do-not-yet-behave-as-documents--p1--integration-gap", "relation": "references", "sourceAnchor": "gr07--the-graph-is-not-a-document-like-everything-else--s2--observed" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "co18--two-relation-taxonomies-and-eight-layer-stacks-for-one-graph--p2--design-gap", "relation": "references", "sourceAnchor": "gr10--relations-are-drawn-but-not-readable--s1--observed" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "n02--visible-local-controls-still-have-no-behavior-or-unavailable-state--p1--observed", "relation": "references", "sourceAnchor": "db04--schema-migrations-and-history-are-pictures--s1--observed" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "v05--there-is-no-product-wide-compact-layout-contract--p1--observed", "relation": "references", "sourceAnchor": "v02--narrow-layouts-truncate-primary-identities--p1--fixed--verified-f22" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "data-auth-and-the-software-value-chain" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "data-auth-and-the-software-value-chain" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "data-auth-and-the-software-value-chain" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "data-auth-and-the-software-value-chain" }, { "id": "reaktor-desktop-master-plan", "anchor": "", "relation": "references", "sourceAnchor": "data-auth-and-the-software-value-chain" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "fixture-ledger", "relation": "references", "sourceAnchor": "co08--port-identifiers-are-not-stable-inside-the-new-map-family--p1--observed-introduced-7-september" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "does-this-help-a-bestbuds-developer-ship", "relation": "references", "sourceAnchor": "band-05--the-three-planes" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "design-coherence-why-the-atlas-still-reads-as-separate-tools", "relation": "references", "sourceAnchor": "band-7--qualification-accessibility-and-polish" }, { "id": "reaktor-ui-ux-audit-2026-09-08", "anchor": "order-of-work", "relation": "references", "sourceAnchor": "implementation-ownership-and-order" } ] }, { "id": "reaktor-unified-system-graph", "owner": "Codex", "kind": "control-plane", "summary": "One heterogeneous, nested, multilayer port graph across source, build and runtime: contracts, visitors, computation profiles, graph changes, cloud, evidence and AI.", "use": "Use before building Reaktor Engine graph importers, cloud/resource nodes, operation providers, or MCP graph tools.", "region": "graph-model", "order": 6, "title": "Reaktor Living Graph — System Architecture", "nav": "Living Graph", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-unified-system-graph", "revision": "ebe483730ae89d8add48dee6c620b74ad4bac7c550c1afe9da3e4adb9a596673", "status": "unverified", "renderingRevision": "41c044e36d045e8411afe6ff003bc2d5d5f9a673a1680c69cd69373f2f70af00", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://arxiv.org/html/1802.06492v1", "https://lmcs.episciences.org/14420/pdf", "https://arxiv.org/abs/1407.7929", "https://ptolemy.berkeley.edu/publications/papers/87/staticscheduling/", "https://www.microsoft.com/en-us/research/wp-content/uploads/2013/01/differentialdataflow.pdf", "https://www.cis.upenn.edu/~bcpierce/papers/lenses-toplas-final.pdf", "https://www.w3.org/TR/prov-o/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph", "polarity": "Neutral" }, { "id": "section-verdict", "anchor": "verdict", "label": "1. One graph, many useful interpretations", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#verdict", "polarity": "Neutral" }, { "id": "section-requirements", "anchor": "requirements", "label": "2. Structural and semantic laws", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#requirements", "polarity": "Neutral" }, { "id": "section-existing", "anchor": "existing", "label": "3. Implementation baseline", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#existing", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "4. Logical model and distributed ownership", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#architecture", "polarity": "Neutral" }, { "id": "section-ontology", "anchor": "ontology", "label": "5. Nodes, ports, relations and semantic layers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#ontology", "polarity": "Neutral" }, { "id": "section-canonical", "anchor": "canonical", "label": "6. Kotlin, source and build-time participation", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#canonical", "polarity": "Neutral" }, { "id": "section-continuous-zoom", "anchor": "continuous-zoom", "label": "Continuous semantic zoom: the whole system remains one place", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#continuous-zoom", "polarity": "Neutral" }, { "id": "section-flow-entrypoints", "anchor": "flow-entrypoints", "label": "Entry and admission contracts", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#flow-entrypoints", "polarity": "Neutral" }, { "id": "section-ui-to-system", "anchor": "ui-to-system", "label": "Inspect a UI element into the full system", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#ui-to-system", "polarity": "Neutral" }, { "id": "section-route-orchestration", "anchor": "route-orchestration", "label": "Orchestrating a selected end-to-end flow", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#route-orchestration", "polarity": "Neutral" }, { "id": "section-operations", "anchor": "operations", "label": "12. Commands, commits and runtime change", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#operations", "polarity": "Neutral" }, { "id": "section-cloud-imports", "anchor": "cloud-imports", "label": "9. Service, provider and FFI boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#cloud-imports", "polarity": "Neutral" }, { "id": "section-coverage-matrix", "anchor": "coverage-matrix", "label": "Coverage matrix — what the map may claim today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#coverage-matrix", "polarity": "Neutral" }, { "id": "section-runtime-nodes", "anchor": "runtime-nodes", "label": "11. Scope, layers, detail, time and editing mode", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#runtime-nodes", "polarity": "Neutral" }, { "id": "section-sourcevisual-round-trip", "anchor": "sourcevisual-round-trip", "label": "Source/visual round-trip", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#sourcevisual-round-trip", "polarity": "Neutral" }, { "id": "section-breadth-without-a-different-kernel-for-every-application", "anchor": "breadth-without-a-different-kernel-for-every-application", "label": "Breadth without a different kernel for every application", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#breadth-without-a-different-kernel-for-every-application", "polarity": "Neutral" }, { "id": "section-incremental-results-need-a-contract", "anchor": "incremental-results-need-a-contract", "label": "Incremental results need a contract", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#incremental-results-need-a-contract", "polarity": "Neutral" }, { "id": "section-map-continuity", "anchor": "map-continuity", "label": "Districts, corridors and bundles keep one graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#map-continuity", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-unified-system-graph#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-unified-system-graph:references-operations", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-operations-graph-evidence", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-runtime-nodes", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-graph-substrate-redesign-ecosystem-integration", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "section-ecosystem-integration", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-astra-reaktor-plan-and-roadmap-16-current-system-map-and-intended-progression", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-existing", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-16-current-system-map-and-intended-progression", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-visual-language", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-sourcevisual-round-trip", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-sourcevisual-round-trip", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-service", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-coverage-matrix", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-ffi", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-coverage-matrix", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-astra-reaktor-plan-and-roadmap-12-flows-choreography-and-the-opinionated-datacloud-stack", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-coverage-matrix", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-12-flows-choreography-and-the-opinionated-datacloud-stack", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-astra-reaktor-plan-and-roadmap-9-runtime-actors-and-safe-live-evolution", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-coverage-matrix", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "section-9-runtime-actors-and-safe-live-evolution", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-breadth-without-a-different-kernel-for-every-application", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-incremental-results-need-a-contract", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-formal-methods", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-incremental-results-need-a-contract", "role": "source", "ordinal": 0 }, { "node": "reaktor-formal-methods", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-runtime-nodes", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-visual-language-road-grammar", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-map-continuity", "role": "source", "ordinal": 0 }, { "node": "reaktor-visual-language", "port": "section-road-grammar", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-graph-hierarchical-ui-system-map", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-map-continuity", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-system-map", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-atlas-revamp-5.6-ultra-board-ZCxzu", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-map-continuity", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-ZCxzu", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-component-lifecycle", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-unified-system-graph:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-unified-system-graph", "incidences": [ { "node": "reaktor-unified-system-graph", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-unified-system-graph.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Living Graph — System Architecture", "level": 0 }, { "id": "reaktor-living-graph", "anchor": "reaktor-living-graph", "title": "Reaktor Living Graph", "level": 1 }, { "id": "verdict", "anchor": "verdict", "title": "1. One graph, many useful interpretations", "level": 2 }, { "id": "requirements", "anchor": "requirements", "title": "2. Structural and semantic laws", "level": 2 }, { "id": "existing", "anchor": "existing", "title": "3. Implementation baseline", "level": 2 }, { "id": "architecture", "anchor": "architecture", "title": "4. Logical model and distributed ownership", "level": 2 }, { "id": "identity-and-consistency-domains", "anchor": "identity-and-consistency-domains", "title": "Identity and consistency domains", "level": 3 }, { "id": "ontology", "anchor": "ontology", "title": "5. Nodes, ports, relations and semantic layers", "level": 2 }, { "id": "layers-are-composable-semantics", "anchor": "layers-are-composable-semantics", "title": "Layers are composable semantics", "level": 3 }, { "id": "canonical", "anchor": "canonical", "title": "6. Kotlin, source and build-time participation", "level": 2 }, { "id": "supported-authoring-forms", "anchor": "supported-authoring-forms", "title": "Supported authoring forms", "level": 3 }, { "id": "sourcevisual-round-trip", "anchor": "sourcevisual-round-trip", "title": "Source/visual round-trip", "level": 3 }, { "id": "freshness", "anchor": "freshness", "title": "7. Live facts, snapshots and freshness", "level": 2 }, { "id": "target-imports", "anchor": "target-imports", "title": "8. Runtime islands and computation profiles", "level": 2 }, { "id": "cloud-imports", "anchor": "cloud-imports", "title": "9. Service, provider and FFI boundaries", "level": 2 }, { "id": "coverage-matrix", "anchor": "coverage-matrix", "title": "Coverage matrix — what the map may claim today", "level": 3 }, { "id": "build-imports", "anchor": "build-imports", "title": "10. Visitors, passes and useful graph power", "level": 2 }, { "id": "a-complete-feature-is-the-unit-of-composition", "anchor": "a-complete-feature-is-the-unit-of-composition", "title": "A complete feature is the unit of composition", "level": 3 }, { "id": "breadth-without-a-different-kernel-for-every-application", "anchor": "breadth-without-a-different-kernel-for-every-application", "title": "Breadth without a different kernel for every application", "level": 3 }, { "id": "incremental-results-need-a-contract", "anchor": "incremental-results-need-a-contract", "title": "Incremental results need a contract", "level": 3 }, { "id": "runtime-nodes", "anchor": "runtime-nodes", "title": "11. Scope, layers, detail, time and editing mode", "level": 2 }, { "id": "continuous-zoom", "anchor": "continuous-zoom", "title": "Continuous semantic zoom: the whole system remains one place", "level": 3 }, { "id": "map-continuity", "anchor": "map-continuity", "title": "Districts, corridors and bundles keep one graph", "level": 3 }, { "id": "graph-routes", "anchor": "graph-routes", "title": "Named routes and end-to-end flow selection", "level": 3 }, { "id": "ui-to-system", "anchor": "ui-to-system", "title": "Inspect a UI element into the full system", "level": 3 }, { "id": "operations", "anchor": "operations", "title": "12. Commands, commits and runtime change", "level": 2 }, { "id": "route-orchestration", "anchor": "route-orchestration", "title": "Orchestrating a selected end-to-end flow", "level": 3 }, { "id": "flow-entrypoints", "anchor": "flow-entrypoints", "title": "Entry and admission contracts", "level": 3 }, { "id": "route-use-cases", "anchor": "route-use-cases", "title": "What this makes possible", "level": 3 }, { "id": "mcp", "anchor": "mcp", "title": "13. Humans, agents and programmable tools", "level": 2 }, { "id": "security", "anchor": "security", "title": "14. Authority, provenance and evidence", "level": 2 }, { "id": "rollout", "anchor": "rollout", "title": "15. Foundation delivery and the full-power horizon", "level": 2 }, { "id": "risks", "anchor": "risks", "title": "16. Scale, usability and failure tests", "level": 2 }, { "id": "repo", "anchor": "repo", "title": "17. Module and repository responsibilities", "level": 2 }, { "id": "final", "anchor": "final", "title": "18. The graph should make the next change easier", "level": 2 }, { "id": "research", "anchor": "research", "title": "Research basis and limits", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "ecosystem-integration", "relation": "references", "sourceAnchor": "" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "16-current-system-map-and-intended-progression", "relation": "references", "sourceAnchor": "existing" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "sourcevisual-round-trip" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "sourcevisual-round-trip" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "coverage-matrix" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "coverage-matrix" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "12-flows-choreography-and-the-opinionated-datacloud-stack", "relation": "references", "sourceAnchor": "coverage-matrix" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "9-runtime-actors-and-safe-live-evolution", "relation": "references", "sourceAnchor": "coverage-matrix" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "breadth-without-a-different-kernel-for-every-application" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "incremental-results-need-a-contract" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "incremental-results-need-a-contract" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "runtime-nodes" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "runtime-nodes" }, { "id": "reaktor-visual-language", "anchor": "road-grammar", "relation": "references", "sourceAnchor": "map-continuity" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "system-map", "relation": "references", "sourceAnchor": "map-continuity" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-ZCxzu", "relation": "references", "sourceAnchor": "map-continuity" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "research" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "research" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-visual-language", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-formal-methods", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-verified-foundations-fable-5", "owner": "Claude", "kind": "architecture", "summary": "Claude's independent code-grounded foundation audit: numbered defects, invariant catalogue, verification ladder, distributed-plane security gates, and the primitive gaps that most increase Reaktor's power.", "use": "Read beside Stable Foundations 5.6 Ultra for an independent audit, traceable defect register, and alternate formal-verification program.", "region": "graph-correctness", "order": 1, "title": "Reaktor Verified Foundations — Fable 5", "nav": "Verified Foundations Fable 5", "group": "graph", "subsection": "graph-correctness", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5", "revision": "e5ba0a3c953d753caeaa8a99dcbdae149fde37d8780ac2a868ffef2bc65d71d0", "status": "unverified", "renderingRevision": "146761a323c21e195a1c38a5b8ada1f0f07ae95fd3e0d171987f5fa8ae209dbe", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5", "polarity": "Neutral" }, { "id": "section-0-how-to-read-this", "anchor": "0-how-to-read-this", "label": "0. How to read this", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5#0-how-to-read-this", "polarity": "Neutral" }, { "id": "section-1-the-verdict", "anchor": "1-the-verdict", "label": "1. The verdict", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5#1-the-verdict", "polarity": "Neutral" }, { "id": "section-2-method-and-evidence", "anchor": "2-method-and-evidence", "label": "2. Method and evidence", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5#2-method-and-evidence", "polarity": "Neutral" }, { "id": "section-3-the-base-layer-census", "anchor": "3-the-base-layer-census", "label": "3. The base-layer census", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5#3-the-base-layer-census", "polarity": "Neutral" }, { "id": "section-4-the-defect-register", "anchor": "4-the-defect-register", "label": "4. The defect register", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5#4-the-defect-register", "polarity": "Neutral" }, { "id": "section-5-the-invariant-catalogue", "anchor": "5-the-invariant-catalogue", "label": "5. The invariant catalogue", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-verified-foundations-fable-5#5-the-invariant-catalogue", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-verified-foundations-fable-5:references-reaktor-stable-foundations-5.6-ultra", "kind": "references", "owner": "reaktor-verified-foundations-fable-5", "incidences": [ { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-stable-foundations-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-verified-foundations-fable-5:references-reaktor-essays", "kind": "references", "owner": "reaktor-verified-foundations-fable-5", "incidences": [ { "node": "reaktor-verified-foundations-fable-5", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-essays", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-verified-foundations-fable-5.json", "sections": [ { "id": "reaktor-verified-foundations--fable-5", "anchor": "reaktor-verified-foundations--fable-5", "title": "Reaktor Verified Foundations — Fable 5", "level": 1 }, { "id": "0-how-to-read-this", "anchor": "0-how-to-read-this", "title": "0. How to read this", "level": 2 }, { "id": "1-the-verdict", "anchor": "1-the-verdict", "title": "1. The verdict", "level": 2 }, { "id": "2-method-and-evidence", "anchor": "2-method-and-evidence", "title": "2. Method and evidence", "level": 2 }, { "id": "3-the-base-layer-census", "anchor": "3-the-base-layer-census", "title": "3. The base-layer census", "level": 2 }, { "id": "31-repository-and-process-state", "anchor": "31-repository-and-process-state", "title": "3.1 Repository and process state", "level": 3 }, { "id": "32-reaktor-core", "anchor": "32-reaktor-core", "title": "3.2 reaktor-core", "level": 3 }, { "id": "33-reaktor-graph-port", "anchor": "33-reaktor-graph-port", "title": "3.3 reaktor-graph-port", "level": 3 }, { "id": "34-reaktor-graph", "anchor": "34-reaktor-graph", "title": "3.4 reaktor-graph", "level": 3 }, { "id": "35-reaktor-flexbuffer", "anchor": "35-reaktor-flexbuffer", "title": "3.5 reaktor-flexbuffer", "level": 3 }, { "id": "36-reaktor-ffi", "anchor": "36-reaktor-ffi", "title": "3.6 reaktor-ffi", "level": 3 }, { "id": "37-reaktor-service-and-reaktor-compiler", "anchor": "37-reaktor-service-and-reaktor-compiler", "title": "3.7 reaktor-service and reaktor-compiler", "level": 3 }, { "id": "38-how-consumers-are-coupled", "anchor": "38-how-consumers-are-coupled", "title": "3.8 How consumers are coupled", "level": 3 }, { "id": "39-what-a-green-build-proves-today", "anchor": "39-what-a-green-build-proves-today", "title": "3.9 What a green build proves today", "level": 3 }, { "id": "4-the-defect-register", "anchor": "4-the-defect-register", "title": "4. The defect register", "level": 2 }, { "id": "41-the-critical-set-in-detail", "anchor": "41-the-critical-set-in-detail", "title": "4.1 The critical set in detail", "level": 3 }, { "id": "5-the-invariant-catalogue", "anchor": "5-the-invariant-catalogue", "title": "5. The invariant catalogue", "level": 2 }, { "id": "51-concurrent-map--inv-chm", "anchor": "51-concurrent-map--inv-chm", "title": "5.1 Concurrent map — INV-CHM", "level": 3 }, { "id": "52-port-graph--inv-port", "anchor": "52-port-graph--inv-port", "title": "5.2 Port graph — INV-PORT", "level": 3 }, { "id": "53-graph-runtime--inv-graph", "anchor": "53-graph-runtime--inv-graph", "title": "5.3 Graph runtime — INV-GRAPH", "level": 3 }, { "id": "54-flexbuffers--inv-flex", "anchor": "54-flexbuffers--inv-flex", "title": "5.4 FlexBuffers — INV-FLEX", "level": 3 }, { "id": "55-ffi-wire--inv-ffi", "anchor": "55-ffi-wire--inv-ffi", "title": "5.5 FFI wire — INV-FFI", "level": 3 }, { "id": "6-the-distributed-plane", "anchor": "6-the-distributed-plane", "title": "6. The distributed plane", "level": 2 }, { "id": "61-protocol-register", "anchor": "61-protocol-register", "title": "6.1 Protocol register", "level": 3 }, { "id": "62-authority-map", "anchor": "62-authority-map", "title": "6.2 Authority map", "level": 3 }, { "id": "63-ad-hoc-protocol-reimplementations", "anchor": "63-ad-hoc-protocol-reimplementations", "title": "6.3 Ad-hoc protocol reimplementations", "level": 3 }, { "id": "7-the-security-stop-ship-set", "anchor": "7-the-security-stop-ship-set", "title": "7. The security stop-ship set", "level": 2 }, { "id": "8-the-verification-ladder", "anchor": "8-the-verification-ladder", "title": "8. The verification ladder", "level": 2 }, { "id": "l0--hygiene", "anchor": "l0--hygiene", "title": "L0 — Hygiene", "level": 3 }, { "id": "l1--written-invariants-and-defect-burn-down", "anchor": "l1--written-invariants-and-defect-burn-down", "title": "L1 — Written invariants and defect burn-down", "level": 3 }, { "id": "l2--mechanized-testing", "anchor": "l2--mechanized-testing", "title": "L2 — Mechanized testing", "level": 3 }, { "id": "l3--model-checked-protocols", "anchor": "l3--model-checked-protocols", "title": "L3 — Model-checked protocols", "level": 3 }, { "id": "l4--lean-4-proofs", "anchor": "l4--lean-4-proofs", "title": "L4 — Lean 4 proofs", "level": 3 }, { "id": "l5--deterministic-simulation", "anchor": "l5--deterministic-simulation", "title": "L5 — Deterministic simulation", "level": 3 }, { "id": "9-what-to-prove-and-in-what", "anchor": "9-what-to-prove-and-in-what", "title": "9. What to prove, and in what", "level": 2 }, { "id": "91-flexbuffers--the-first-target", "anchor": "91-flexbuffers--the-first-target", "title": "9.1 FlexBuffers — the first target", "level": 3 }, { "id": "92-the-visual-language-semantics--the-cheapest-target", "anchor": "92-the-visual-language-semantics--the-cheapest-target", "title": "9.2 The visual language semantics — the cheapest target", "level": 3 }, { "id": "93-the-port-graph-kernel", "anchor": "93-the-port-graph-kernel", "title": "9.3 The port-graph kernel", "level": 3 }, { "id": "94-kahn-network-determinism", "anchor": "94-kahn-network-determinism", "title": "9.4 Kahn-network determinism", "level": 3 }, { "id": "95-choreography--research-grade-later", "anchor": "95-choreography--research-grade-later", "title": "9.5 Choreography — research-grade, later", "level": 3 }, { "id": "96-smaller-targets-worth-doing-opportunistically", "anchor": "96-smaller-targets-worth-doing-opportunistically", "title": "9.6 Smaller targets worth doing opportunistically", "level": 3 }, { "id": "10-theoretical-models-what-exists-and-where-it-can-go", "anchor": "10-theoretical-models-what-exists-and-where-it-can-go", "title": "10. Theoretical models: what exists and where it can go", "level": 2 }, { "id": "11-increasing-reaktors-power", "anchor": "11-increasing-reaktors-power", "title": "11. Increasing Reaktor's power", "level": 2 }, { "id": "12-the-keystone-one-fingerprint-system", "anchor": "12-the-keystone-one-fingerprint-system", "title": "12. The keystone: one fingerprint system", "level": 2 }, { "id": "13-sequencing", "anchor": "13-sequencing", "title": "13. Sequencing", "level": 2 }, { "id": "14-what-each-phase-retires", "anchor": "14-what-each-phase-retires", "title": "14. What each phase retires", "level": 2 }, { "id": "appendix-a--traceability", "anchor": "appendix-a--traceability", "title": "Appendix A — Traceability", "level": 2 }, { "id": "appendix-b--why-these-tools", "anchor": "appendix-b--why-these-tools", "title": "Appendix B — Why these tools", "level": 2 }, { "id": "appendix-c--open-questions", "anchor": "appendix-c--open-questions", "title": "Appendix C — Open questions", "level": 2 } ], "links": [ { "id": "reaktor-stable-foundations-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-essays", "anchor": "", "relation": "references", "sourceAnchor": "" } ] }, { "id": "reaktor-visual-language", "owner": "Claude", "kind": "design", "summary": "A Blueprints-style visual language on reaktor-graph: author app behavior, workflows, and whole-system orchestration, with agents as first-class co-authors.", "use": "Use when designing the node-based authoring/orchestration language and its editor, compiler, and agentic surface.", "region": "workbench-surfaces", "order": 6, "title": "Reaktor Visual Language (Blueprints)", "nav": "Visual Language", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-visual-language", "revision": "b8eb3fa623a41295eda92d584b4fb2b960cf34c633ecd27e4d1cdabc85a804d7", "status": "unverified", "renderingRevision": "6a821939d0d4e183c749b973d3b7baec9f580fcdf206e70dfdaa16052d14f160", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://dev.epicgames.com/documentation/en-us/unreal-engine/blueprints-visual-scripting-in-unreal-engine?application_version=5.7", "https://dev.epicgames.com/documentation/en-us/unreal-engine/introduction-to-blueprints-visual-scripting-in-unreal-engine", "https://dev.epicgames.com/documentation/unreal-engine/blueprint-basic-user-guide-in-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/unreal-engine/basic-scripting-with-blueprints-in-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/en-us/unreal-engine/exposing-cplusplus-to-blueprints-visual-scripting-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/exposing-gameplay-elements-to-blueprints-visual-scripting-in-unreal-engine?application_version=5.6", "https://dev.epicgames.com/documentation/unreal-engine/blueprint-function-libraries-in-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/unreal-engine/technical-guide-for-blueprints-visual-scripting-in-unreal-engine", "https://dev.epicgames.com/documentation/unreal-engine/API/Runtime/Engine/UBlueprint?lang=en-US", "https://dev.epicgames.com/documentation/unreal-engine/API/Editor/Kismet?lang=en-US", "https://dev.epicgames.com/documentation/unreal-engine/my-blueprint-panel-in-the-blueprints-visual-scripting-editor-for-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/unreal-engine/details-panel-in-the-blueprints-visual-scriting-editor-for-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/en-us/unreal-engine/compiler-results-in-the-blueprints-visual-scripting-editor-for-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/searching-in-blueprints-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/blueprint-debugger-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/debug-panel-in-the-blueprints-visual-scripting-editor-for-unreal-engine", "https://dev.epicgames.com/documentation/unreal-engine/level-blueprint-in-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/unreal-engine/animation-blueprints-in-unreal-engine?lang=en-US", "https://dev.epicgames.com/documentation/en-us/unreal-engine/animation-blueprint-editor-in-unreal-engine", "https://dev.epicgames.com/documentation/en-us/unreal-engine/blueprint-best-practices-in-unreal-engine", "https://dev.epicgames.com/community/learning/tutorials/DJkL/unreal-engine-exposing-c-to-blueprints-for-collaboration", "https://craftinginterpreters.com/", "https://craftinginterpreters.com/contents.html", "https://www.educate.elsevier.com/book/details/9780128154120", "https://gameprogrammingpatterns.com/contents.html", "https://www.routledge.com/Game-Engine-Architecture-Third-Edition/Gregory/p/book/9781138035454", "https://martinfowler.com/books/dsl.html", "https://sarabander.github.io/sicp/html/", "https://mitpress.mit.edu/9780262046305/introduction-to-algorithms/", "https://www.routledge.com/AI-for-Games-Third-Edition/Millington/p/book/9780367670566", "https://arxiv.org/abs/1709.00084", "https://www2.eecs.berkeley.edu/Pubs/TechRpts/2004/6201.html", "https://www2.eecs.berkeley.edu/Pubs/TechRpts/2004/CSD-04-1368.pdf", "https://web.engr.oregonstate.edu/~burnett/Reprints/whatIsVP.pdf", "https://pure.ulster.ac.uk/en/publications/advances-in-dataflow-programming-languages-3/", "https://www.cs.tufts.edu/comp/150CMP/papers/dataflow-johnston-acm04.pdf", "http://www.jpaulmorrison.com/fbp/", "https://www.ijcai.org/Proceedings/73/Papers/027B.pdf", "http://conal.net/papers/icfp97/", "https://dl.acm.org/doi/10.1145/358746.358755", "https://www.cs.cmu.edu/~comar/hazelnut-popl17/", "https://arxiv.org/abs/1607.04180", "https://worrydream.com/LearnableProgramming/", "https://curtclifton.net/papers/MoseleyMarks06a.pdf", "https://developers.google.com/static/blockly/publications/papers/TipsForCreatingABlockLanguage.pdf", "https://arxiv.org/abs/1710.01547", "https://hazel.org/papers/grove-popl25.pdf", "https://arxiv.org/abs/1912.05036", "https://github.com/retejs/rete", "https://retejs.org/docs/guides/processing/control-flow/", "https://github.com/leon-thomm/Ryven", "https://github.com/jagenjo/litegraph.js", "https://github.com/comfyanonymous/ComfyUI", "https://docs.comfy.org/interface/settings/lite-graph", "https://nodered.org/docs/", "https://nodered.org/docs/user-guide/concepts", "https://nodered.org/docs/user-guide/editor/workspace/wires", "https://nifi.apache.org/documentation/nifi-latest/html/user-guide.html", "https://docs.blender.org/manual/en/4.2/modeling/geometry_nodes/index.html", "https://docs.blender.org/manual/en/latest/interface/controls/nodes/groups.html", "https://developer.blender.org/docs/handbook/design/examples/geometry_nodes/", "https://www.sidefx.com/docs/houdini/nodes/vop/index.html", "https://www.sidefx.com/docs/houdini/vex/index.html", "https://docs.blockly.com/", "https://docs.blockly.com/guides/create-custom-blocks/procedures/overview/", "https://github.com/scratchfoundation/scratch-vm", "https://www.jetbrains.com/mps/", "https://github.com/JetBrains/MPS", "https://github.com/xyflow/xyflow", "https://github.com/xyflow/awesome-node-based-uis", "https://godotengine.org/article/godot-4-will-discontinue-visual-scripting/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-visual-language", "polarity": "Neutral" }, { "id": "section-vision", "anchor": "vision", "label": "1. Vision", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#vision", "polarity": "Neutral" }, { "id": "section-scan", "anchor": "scan", "label": "2. What exists and what needs integration", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#scan", "polarity": "Neutral" }, { "id": "section-constraints", "anchor": "constraints", "label": "3. Design constraints", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#constraints", "polarity": "Neutral" }, { "id": "section-visual-grammar", "anchor": "visual-grammar", "label": "4. Visual grammar: what the canvas means", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#visual-grammar", "polarity": "Neutral" }, { "id": "section-gap", "anchor": "gap", "label": "5. The execution gap", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#gap", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "6. Blueprint regions and reusable definitions", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#model", "polarity": "Neutral" }, { "id": "section-road-grammar", "anchor": "road-grammar", "label": "Road grammar and family grammar", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#road-grammar", "polarity": "Neutral" }, { "id": "section-language", "anchor": "language", "label": "7. The language and its semantic contracts", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#language", "polarity": "Neutral" }, { "id": "section-agentic", "anchor": "agentic", "label": "11. Agentic access", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#agentic", "polarity": "Neutral" }, { "id": "section-see-also", "anchor": "see-also", "label": "See also", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#see-also", "polarity": "Neutral" }, { "id": "section-41-composable-layers-over-one-graph", "anchor": "41-composable-layers-over-one-graph", "label": "4.1 Composable layers over one graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#41-composable-layers-over-one-graph", "polarity": "Neutral" }, { "id": "section-44-a-connected-bestbuds-example", "anchor": "44-a-connected-bestbuds-example", "label": "4.4 A connected BestBuds example", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#44-a-connected-bestbuds-example", "polarity": "Neutral" }, { "id": "section-77-concurrency-streams-and-durability", "anchor": "77-concurrency-streams-and-durability", "label": "7.7 Concurrency, streams and durability", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#77-concurrency-streams-and-durability", "polarity": "Neutral" }, { "id": "section-ui-inspection", "anchor": "ui-inspection", "label": "From visible product to the full graph", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#ui-inspection", "polarity": "Neutral" }, { "id": "section-orchestrate", "anchor": "orchestrate", "label": "10. Composing the complete ecosystem", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#orchestrate", "polarity": "Neutral" }, { "id": "section-end-to-end-flows", "anchor": "end-to-end-flows", "label": "Compose and execute end-to-end flows", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#end-to-end-flows", "polarity": "Neutral" }, { "id": "section-phases", "anchor": "phases", "label": "13. Delivery plan", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#phases", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-visual-language#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-visual-language:references-reaktor-atlas-revamp-5.6-ultra", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-scan", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor_graph_visitors_design", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-scan", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-graph-hierarchical-ui", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-41-composable-layers-over-one-graph", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-atlas-revamp-5.6-ultra-board-IRQ5A", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-44-a-connected-bestbuds-example", "role": "source", "ordinal": 0 }, { "node": "reaktor-atlas-revamp-5.6-ultra", "port": "section-board-IRQ5A", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-actor-model", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-77-concurrency-streams-and-durability", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-distributed-actors", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-77-concurrency-streams-and-durability", "role": "source", "ordinal": 0 }, { "node": "reaktor-distributed-actors", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-unified-system-graph-cloud-imports", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-77-concurrency-streams-and-durability", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-cloud-imports", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-graph-hierarchical-ui-continuous-zoom", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-ui-inspection", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-hierarchical-ui", "port": "section-continuous-zoom", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-surface-renderers", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-orchestrate", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-renderers", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-unified-system-graph-route-orchestration", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-end-to-end-flows", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-route-orchestration", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-phases", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-flow-analysis", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-see-also", "role": "source", "ordinal": 0 }, { "node": "flow-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-surface-design-and-ownership", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-design-and-ownership", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-visual-language:references-reaktor-arena", "kind": "references", "owner": "reaktor-visual-language", "incidences": [ { "node": "reaktor-visual-language", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-arena", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-visual-language.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Visual Language (Blueprints)", "level": 0 }, { "id": "vision", "anchor": "vision", "title": "1. Vision", "level": 2 }, { "id": "scan", "anchor": "scan", "title": "2. What exists and what needs integration", "level": 2 }, { "id": "constraints", "anchor": "constraints", "title": "3. Design constraints", "level": 2 }, { "id": "visual-grammar", "anchor": "visual-grammar", "title": "4. Visual grammar: what the canvas means", "level": 2 }, { "id": "41-composable-layers-over-one-graph", "anchor": "41-composable-layers-over-one-graph", "title": "4.1 Composable layers over one graph", "level": 3 }, { "id": "42-cards-pins-and-wires", "anchor": "42-cards-pins-and-wires", "title": "4.2 Cards, pins and wires", "level": 3 }, { "id": "road-grammar", "anchor": "road-grammar", "title": "Road grammar and family grammar", "level": 3 }, { "id": "43-gestures-are-commands", "anchor": "43-gestures-are-commands", "title": "4.3 Gestures are commands", "level": 3 }, { "id": "44-a-connected-bestbuds-example", "anchor": "44-a-connected-bestbuds-example", "title": "4.4 A connected BestBuds example", "level": 3 }, { "id": "gap", "anchor": "gap", "title": "5. The execution gap", "level": 2 }, { "id": "model", "anchor": "model", "title": "6. Blueprint regions and reusable definitions", "level": 2 }, { "id": "language", "anchor": "language", "title": "7. The language and its semantic contracts", "level": 2 }, { "id": "71-two-authoring-paths-one-identity-fabric", "anchor": "71-two-authoring-paths-one-identity-fabric", "title": "7.1 Two authoring paths, one identity fabric", "level": 3 }, { "id": "72-relations-and-well-formedness", "anchor": "72-relations-and-well-formedness", "title": "7.2 Relations and well-formedness", "level": 3 }, { "id": "73-typed-kotlin-sketch", "anchor": "73-typed-kotlin-sketch", "title": "7.3 Typed Kotlin sketch", "level": 3 }, { "id": "74-types-effects-and-holes", "anchor": "74-types-effects-and-holes", "title": "7.4 Types, effects and holes", "level": 3 }, { "id": "75-evaluation-state-versions-and-invocation-frames", "anchor": "75-evaluation-state-versions-and-invocation-frames", "title": "7.5 Evaluation, state versions and invocation frames", "level": 3 }, { "id": "76-turing-completeness-and-decidable-profiles", "anchor": "76-turing-completeness-and-decidable-profiles", "title": "7.6 Turing completeness and decidable profiles", "level": 3 }, { "id": "77-concurrency-streams-and-durability", "anchor": "77-concurrency-streams-and-durability", "title": "7.7 Concurrency, streams and durability", "level": 3 }, { "id": "78-reference-semantics-and-backend-conformance", "anchor": "78-reference-semantics-and-backend-conformance", "title": "7.8 Reference semantics and backend conformance", "level": 3 }, { "id": "editor", "anchor": "editor", "title": "8. The editor: coordinated source, graph and execution", "level": 2 }, { "id": "ui-inspection", "anchor": "ui-inspection", "title": "From visible product to the full graph", "level": 3 }, { "id": "compiler", "anchor": "compiler", "title": "9. Compilation, interpretation and change plans", "level": 2 }, { "id": "orchestrate", "anchor": "orchestrate", "title": "10. Composing the complete ecosystem", "level": 2 }, { "id": "end-to-end-flows", "anchor": "end-to-end-flows", "title": "Compose and execute end-to-end flows", "level": 3 }, { "id": "agentic", "anchor": "agentic", "title": "11. Agentic access", "level": 2 }, { "id": "module", "anchor": "module", "title": "12. Module ownership", "level": 2 }, { "id": "phases", "anchor": "phases", "title": "13. Delivery plan", "level": 2 }, { "id": "open", "anchor": "open", "title": "14. Decisions and counterexamples to resolve", "level": 2 }, { "id": "references", "anchor": "references", "title": "15. Study guide and references", "level": 2 }, { "id": "151-unreal-engine-blueprints-primary-analogy", "anchor": "151-unreal-engine-blueprints-primary-analogy", "title": "15.1 Unreal Engine Blueprints: primary analogy", "level": 3 }, { "id": "152-books-and-chapters", "anchor": "152-books-and-chapters", "title": "15.2 Books and chapters", "level": 3 }, { "id": "153-papers-essays-and-core-concepts", "anchor": "153-papers-essays-and-core-concepts", "title": "15.3 Papers, essays, and core concepts", "level": 3 }, { "id": "154-systems-and-open-source-projects-to-study", "anchor": "154-systems-and-open-source-projects-to-study", "title": "15.4 Systems and open-source projects to study", "level": 3 }, { "id": "155-concrete-unreal-to-reaktor-mappings", "anchor": "155-concrete-unreal-to-reaktor-mappings", "title": "15.5 Concrete Unreal-to-Reaktor mappings", "level": 3 }, { "id": "156-concepts-to-define-before-implementation-starts", "anchor": "156-concepts-to-define-before-implementation-starts", "title": "15.6 Concepts to define before implementation starts", "level": 3 }, { "id": "see-also", "anchor": "see-also", "title": "See also", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "", "relation": "references", "sourceAnchor": "scan" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "scan" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "41-composable-layers-over-one-graph" }, { "id": "reaktor-atlas-revamp-5.6-ultra", "anchor": "board-IRQ5A", "relation": "references", "sourceAnchor": "44-a-connected-bestbuds-example" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "77-concurrency-streams-and-durability" }, { "id": "reaktor-distributed-actors", "anchor": "", "relation": "references", "sourceAnchor": "77-concurrency-streams-and-durability" }, { "id": "reaktor-unified-system-graph", "anchor": "cloud-imports", "relation": "references", "sourceAnchor": "77-concurrency-streams-and-durability" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "", "relation": "references", "sourceAnchor": "editor" }, { "id": "reaktor-graph-hierarchical-ui", "anchor": "continuous-zoom", "relation": "references", "sourceAnchor": "ui-inspection" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "compiler" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "orchestrate" }, { "id": "reaktor-unified-system-graph", "anchor": "route-orchestration", "relation": "references", "sourceAnchor": "end-to-end-flows" }, { "id": "astra-reaktor-plan-and-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "phases" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "flow-analysis", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "reaktor-surface-renderers", "anchor": "", "relation": "references", "sourceAnchor": "see-also" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "flow-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-surface-design-and-ownership", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-arena", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor-webview", "owner": "Reaktor / Codex", "kind": "plan", "summary": "System WebViews across Android, iOS, desktop and browser targets, packaged web tools, graph bridge security and Hangar migration from JCEF.", "use": "Use to implement the shared web runtime and verify native embedding, asset origins, authority boundaries and platform support before replacing Hangar's browser engine.", "region": "framework-ui", "order": 12, "title": "Reaktor WebView runtime plan", "nav": "WebView runtime", "group": "framework", "subsection": "framework-ui", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-webview", "revision": "0162cc9a6214ac6667cb15a6f8be1d5917e28377adf7c850cb7472bdd198659f", "status": "unverified", "renderingRevision": "8120e9cd8ab2bf9b2f6c0da48e7842601b40e65ccce1453fca2a8ac5eb872bfa", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://github.com/webview/webview", "https://github.com/webview/webview/blob/cbbdee44afff22867de9fd88a9fc8350d9bdd399/core/include/webview/detail/backends/cocoa_webkit.hh", "https://w3c.github.io/ServiceWorker/v1/#service-worker-client-concept" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-webview", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "Implementation status", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-webview#current", "polarity": "Neutral" }, { "id": "section-contract", "anchor": "contract", "label": "Runtime ownership", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-webview#contract", "polarity": "Neutral" }, { "id": "section-matrix", "anchor": "matrix", "label": "Platform hosts", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-webview#matrix", "polarity": "Neutral" }, { "id": "section-dependencies", "anchor": "dependencies", "label": "Desktop C++ boundary", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-webview#dependencies", "polarity": "Neutral" }, { "id": "section-content", "anchor": "content", "label": "Bundle loading", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-webview#content", "polarity": "Neutral" }, { "id": "section-bridge", "anchor": "bridge", "label": "Bridge authority and protocol", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-webview#bridge", "polarity": "Neutral" } ], "relations": [] }, "content": "reaktor-webview.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor WebView runtime plan", "level": 0 }, { "id": "current", "anchor": "current", "title": "Implementation status", "level": 2 }, { "id": "contract", "anchor": "contract", "title": "Runtime ownership", "level": 2 }, { "id": "matrix", "anchor": "matrix", "title": "Platform hosts", "level": 2 }, { "id": "dependencies", "anchor": "dependencies", "title": "Desktop C++ boundary", "level": 2 }, { "id": "content", "anchor": "content", "title": "Bundle loading", "level": 2 }, { "id": "browser-deployment", "anchor": "browser-deployment", "title": "Browser deployment", "level": 3 }, { "id": "bridge", "anchor": "bridge", "title": "Bridge authority and protocol", "level": 2 }, { "id": "hangar", "anchor": "hangar", "title": "Hangar integration", "level": 2 }, { "id": "sequence", "anchor": "sequence", "title": "Validation and rollout", "level": 2 } ], "links": [] }, { "id": "reaktor-work", "owner": "Codex", "kind": "module", "summary": "Meeseeks replacement design, diagrams and Reaktor reuse audit: graph-owned WorkStore, WorkRuntime and WorkScheduler, native durable coordination, typed DAGs, retained journals and reference-engine feature comparison. Implementation remains experimental.", "use": "Start here for the planned design diagrams, graph integration requirements, reference feature coverage/gaps, native/cloud profiles and measurement; the authenticated roadmap owns migration and delivery gates.", "region": "data-delivery", "order": 3, "title": "Reaktor Work", "nav": "Work", "group": "data", "subsection": "data-delivery", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-work", "revision": "cb45e5b831bd238572f1b07b6e86ff50f3416433a34c4a7b224e90e58de1ae58", "status": "unverified", "renderingRevision": "5a7702686d0ab577573acaf7b99aac47d99ff9f966027d8b4921410239adada6", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "cloud" ], "externalLinks": [ "https://kotlinlang.org/docs/coroutines-basics.html", "https://developers.cloudflare.com/workflows/build/rules-of-workflows/", "https://github.com/twitter/nodes", "https://docs.temporal.io/encyclopedia/event-history", "https://docs.temporal.io/workflow-execution", "https://docs.restate.dev/foundations/actions", "https://docs.restate.dev/develop/java/services", "https://conductor-oss.github.io/conductor/documentation/configuration/workflowdef/operators/index.html", "https://docs.ray.io/en/latest/ray-core/ray-dag.html", "https://docs.temporal.io/workflow-execution/timers-delays", "https://docs.temporal.io/encyclopedia/workflow-message-passing", "https://docs.temporal.io/activities", "https://conductor-oss.github.io/conductor/architecture/json-native.html", "https://conductor-oss.github.io/conductor/documentation/configuration/workflowdef/systemtasks/wait-task.html", "https://conductor-oss.github.io/conductor/devguide/architecture/tasklifecycle.html", "https://docs.ray.io/en/latest/ray-core/scheduling/resources.html", "https://martin.kleppmann.com/2015/04/24/logs-for-data-infrastructure-at-craft.html", "https://martin.kleppmann.com/2015/05/27/logs-for-data-infrastructure.html", "https://developer.android.com/develop/background-work/background-tasks/persistent/configuration/custom-configuration", "https://developer.android.com/develop/background-work/background-tasks/data-transfer-options", "https://developer.android.com/develop/background-work/background-tasks/persistent/how-to/long-running", "https://developer.apple.com/documentation/backgroundtasks/bgtaskscheduler", "https://developer.apple.com/documentation/uikit/using-background-tasks-to-update-your-app", "https://developer.apple.com/documentation/foundation/downloading-files-in-the-background", "https://developer.apple.com/documentation/backgroundtasks/performing-long-running-tasks-on-ios-and-ipados", "https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/-dispatchers/-main.html", "https://developer.mozilla.org/en-US/docs/Web/API/Background_Synchronization_API", "https://developer.mozilla.org/en-US/docs/Web/API/Web_Periodic_Background_Synchronization_API", "https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/promise.html", "https://developer.mozilla.org/en-US/docs/Web/API/ExtendableEvent/waitUntil", "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Offline_and_background_operation", "https://developer.mozilla.org/en-US/docs/Web/API/Web_Locks_API", "https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createSyncAccessHandle", "https://developer.mozilla.org/en-US/docs/Web/API/WorkerGlobalScope/indexedDB", "https://developer.mozilla.org/en-US/docs/Web/API/IDBTransaction", "https://developers.cloudflare.com/queues/reference/delivery-guarantees/", "https://docs.cloud.google.com/pubsub/docs/subscriber", "https://docs.cloud.google.com/pubsub/docs/authenticate-push-subscriptions", "https://docs.spring.io/spring-boot/reference/io/quartz.html", "https://www.quartz-scheduler.org/documentation/quartz-2.3.0/configuration/ConfigJDBCJobStoreClustering.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-work", "polarity": "Neutral" }, { "id": "section-source", "anchor": "source", "label": "Current source status", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#source", "polarity": "Neutral" }, { "id": "section-progress", "anchor": "progress", "label": "Implementation progress", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#progress", "polarity": "Neutral" }, { "id": "section-benchmark", "anchor": "benchmark", "label": "Capability benchmark and selected execution profiles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#benchmark", "polarity": "Neutral" }, { "id": "section-feature-comparison", "anchor": "feature-comparison", "label": "Design and feature set compared with the reference systems", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#feature-comparison", "polarity": "Neutral" }, { "id": "section-design-diagrams", "anchor": "design-diagrams", "label": "Planned design diagrams", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#design-diagrams", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "Durable state, execution and wakeups", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#architecture", "polarity": "Neutral" }, { "id": "section-dag", "anchor": "dag", "label": "Typed DAGs and workflow execution", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#dag", "polarity": "Neutral" }, { "id": "section-measurements", "anchor": "measurements", "label": "Reproducible measurement protocol", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#measurements", "polarity": "Neutral" }, { "id": "section-logs", "anchor": "logs", "label": "Retained journals and replayable projections", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#logs", "polarity": "Neutral" }, { "id": "section-spring", "anchor": "spring", "label": "Spring Quartz, queues and Pub/Sub", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#spring", "polarity": "Neutral" }, { "id": "section-spring-orchestration", "anchor": "spring-orchestration", "label": "Reaktor's own durable graph coordinator", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#spring-orchestration", "polarity": "Neutral" }, { "id": "section-contract", "anchor": "contract", "label": "Graph ownership and the small contract", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#contract", "polarity": "Neutral" }, { "id": "section-tests", "anchor": "tests", "label": "Qualification and inspection", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#tests", "polarity": "Neutral" }, { "id": "section-inspection", "anchor": "inspection", "label": "Hangar inspection and control", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#inspection", "polarity": "Neutral" }, { "id": "section-advantages", "anchor": "advantages", "label": "Advantages to earn through Reaktor integration", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#advantages", "polarity": "Neutral" }, { "id": "section-design-architecture", "anchor": "design-architecture", "label": "Graph-owned work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#design-architecture", "polarity": "Neutral" }, { "id": "section-design-platforms", "anchor": "design-platforms", "label": "One contract, qualified platform profiles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#design-platforms", "polarity": "Neutral" }, { "id": "section-parity-gates", "anchor": "parity-gates", "label": "Feature parity requirements and deliberate differences", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#parity-gates", "polarity": "Neutral" }, { "id": "section-durability", "anchor": "durability", "label": "Persistence and effect guarantees", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#durability", "polarity": "Neutral" }, { "id": "section-cloudflare", "anchor": "cloudflare", "label": "Cloudflare Workflows, Queues and Pub/Sub", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#cloudflare", "polarity": "Neutral" }, { "id": "section-android", "anchor": "android", "label": "Android WorkManager", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#android", "polarity": "Neutral" }, { "id": "section-ios", "anchor": "ios", "label": "iOS BGTaskScheduler and transfers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#ios", "polarity": "Neutral" }, { "id": "section-browser", "anchor": "browser", "label": "Browser windows, workers and service workers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#browser", "polarity": "Neutral" }, { "id": "section-browser-storage", "anchor": "browser-storage", "label": "Current browser storage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#browser-storage", "polarity": "Neutral" }, { "id": "section-reuse-audit", "anchor": "reuse-audit", "label": "Are we exploiting Reaktor properly?", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#reuse-audit", "polarity": "Neutral" }, { "id": "section-graph-integration", "anchor": "graph-integration", "label": "Required graph integration", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#graph-integration", "polarity": "Neutral" }, { "id": "section-related-contracts", "anchor": "related-contracts", "label": "Related contracts", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-work#related-contracts", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-work:inspection-cloud-pane", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-inspection", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:inspection-devtools", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-inspection", "role": "source", "ordinal": 0 }, { "node": "reaktor-devtools", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-graph-substrate-redesign", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-dag", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-substrate-redesign", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-dag", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-db", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-durability", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-data-transactions", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-logs", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-transactions", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-bus-mesh", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-logs", "role": "source", "ordinal": 0 }, { "node": "reaktor-bus-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-db-erasure", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-logs", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-erasure", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-capability", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-capability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-service", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-service", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-auth-analysis", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-framework-overview-media", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "section-media", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-framework-overview-io", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "section-io", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-component-lifecycle", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-tooling-layer", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-tooling-layer", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-operations-graph-evidence", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-module-review-reaktor-performance", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-review", "port": "section-reaktor-performance", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-ffi", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-ffi", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-flexbuffer-implementation", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "flexbuffer-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-mesh", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-reuse-audit", "role": "source", "ordinal": 0 }, { "node": "reaktor-mesh", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-data-workflows", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-cloudflare", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-workflows", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-data-implementation", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-related-contracts", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-implementation", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-work:references-reaktor-module-execution-plan-reaktor-work", "kind": "references", "owner": "reaktor-work", "incidences": [ { "node": "reaktor-work", "port": "section-related-contracts", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "section-reaktor-work", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-work.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Work", "level": 0 }, { "id": "source", "anchor": "source", "title": "Current source status", "level": 2 }, { "id": "progress", "anchor": "progress", "title": "Implementation progress", "level": 2 }, { "id": "progress-2026-10-09-inspection", "anchor": "progress-2026-10-09-inspection", "title": "9 October 2026 — Hangar Cloud / Work inspection", "level": 3 }, { "id": "progress-2026-10-06-hosts", "anchor": "progress-2026-10-06-hosts", "title": "6 October 2026 — Worker boundary and caller qualification", "level": 3 }, { "id": "progress-2026-10-06", "anchor": "progress-2026-10-06", "title": "6 October 2026 — retained delivery and platform evidence", "level": 3 }, { "id": "progress-2026-10-05-cutover", "anchor": "progress-2026-10-05-cutover", "title": "5 October 2026 — vendor cutover and durable graph recovery", "level": 3 }, { "id": "progress-2026-10-05-foundation", "anchor": "progress-2026-10-05-foundation", "title": "5 October 2026 — first conformance gate passed", "level": 3 }, { "id": "progress-2026-10-05-start", "anchor": "progress-2026-10-05-start", "title": "5 October 2026 — implementation begins", "level": 3 }, { "id": "benchmark", "anchor": "benchmark", "title": "Capability benchmark and selected execution profiles", "level": 2 }, { "id": "feature-comparison", "anchor": "feature-comparison", "title": "Design and feature set compared with the reference systems", "level": 2 }, { "id": "durable-comparison", "anchor": "durable-comparison", "title": "Durable orchestration and service composition", "level": 3 }, { "id": "dag-comparison", "anchor": "dag-comparison", "title": "Request DAGs, distributed computation and platform reach", "level": 3 }, { "id": "parity-gates", "anchor": "parity-gates", "title": "Feature parity requirements and deliberate differences", "level": 3 }, { "id": "design-diagrams", "anchor": "design-diagrams", "title": "Planned design diagrams", "level": 2 }, { "id": "design-architecture", "anchor": "design-architecture", "title": "Graph-owned work", "level": 3 }, { "id": "design-platforms", "anchor": "design-platforms", "title": "One contract, qualified platform profiles", "level": 3 }, { "id": "architecture", "anchor": "architecture", "title": "Durable state, execution and wakeups", "level": 2 }, { "id": "contract", "anchor": "contract", "title": "Graph ownership and the small contract", "level": 2 }, { "id": "dag", "anchor": "dag", "title": "Typed DAGs and workflow execution", "level": 2 }, { "id": "durability", "anchor": "durability", "title": "Persistence and effect guarantees", "level": 2 }, { "id": "logs", "anchor": "logs", "title": "Retained journals and replayable projections", "level": 2 }, { "id": "advantages", "anchor": "advantages", "title": "Advantages to earn through Reaktor integration", "level": 2 }, { "id": "reuse-audit", "anchor": "reuse-audit", "title": "Are we exploiting Reaktor properly?", "level": 3 }, { "id": "graph-integration", "anchor": "graph-integration", "title": "Required graph integration", "level": 3 }, { "id": "android", "anchor": "android", "title": "Android WorkManager", "level": 2 }, { "id": "ios", "anchor": "ios", "title": "iOS BGTaskScheduler and transfers", "level": 2 }, { "id": "browser", "anchor": "browser", "title": "Browser windows, workers and service workers", "level": 2 }, { "id": "browser-storage", "anchor": "browser-storage", "title": "Current browser storage", "level": 3 }, { "id": "cloudflare", "anchor": "cloudflare", "title": "Cloudflare Workflows, Queues and Pub/Sub", "level": 2 }, { "id": "spring", "anchor": "spring", "title": "Spring Quartz, queues and Pub/Sub", "level": 2 }, { "id": "spring-orchestration", "anchor": "spring-orchestration", "title": "Reaktor's own durable graph coordinator", "level": 3 }, { "id": "recipes", "anchor": "recipes", "title": "Media, archival and placement", "level": 2 }, { "id": "inspection", "anchor": "inspection", "title": "Hangar inspection and control", "level": 2 }, { "id": "tests", "anchor": "tests", "title": "Qualification and inspection", "level": 2 }, { "id": "measurements", "anchor": "measurements", "title": "Reproducible measurement protocol", "level": 3 }, { "id": "related-contracts", "anchor": "related-contracts", "title": "Related contracts", "level": 2 } ], "links": [ { "id": "private/reaktor-work-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "source" }, { "id": "private/reaktor-work-roadmap", "anchor": "progress", "relation": "references", "sourceAnchor": "progress" }, { "id": "private/reaktor-work-roadmap", "anchor": "progress", "relation": "references", "sourceAnchor": "progress-2026-10-09-inspection" }, { "id": "reaktor-work", "anchor": "measurements", "relation": "references", "sourceAnchor": "benchmark" }, { "id": "reaktor-work", "anchor": "progress", "relation": "references", "sourceAnchor": "feature-comparison" }, { "id": "reaktor-work", "anchor": "advantages", "relation": "references", "sourceAnchor": "parity-gates" }, { "id": "reaktor-work", "anchor": "measurements", "relation": "references", "sourceAnchor": "parity-gates" }, { "id": "reaktor-work", "anchor": "progress", "relation": "references", "sourceAnchor": "design-diagrams" }, { "id": "reaktor-work", "anchor": "design-architecture", "relation": "references", "sourceAnchor": "design-diagrams" }, { "id": "reaktor-work", "anchor": "design-platforms", "relation": "references", "sourceAnchor": "design-diagrams" }, { "id": "reaktor-work", "anchor": "dag", "relation": "references", "sourceAnchor": "design-diagrams" }, { "id": "reaktor-work", "anchor": "logs", "relation": "references", "sourceAnchor": "design-diagrams" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "dag" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "dag" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "durability" }, { "id": "reaktor-data-transactions", "anchor": "", "relation": "references", "sourceAnchor": "logs" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "logs" }, { "id": "reaktor-db", "anchor": "erasure", "relation": "references", "sourceAnchor": "logs" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-graph-substrate-redesign", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-framework-overview", "anchor": "media", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-framework-overview", "anchor": "io", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-tooling-layer", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-module-review", "anchor": "reaktor-performance", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-ffi", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "flexbuffer-implementation", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-mesh", "anchor": "", "relation": "references", "sourceAnchor": "reuse-audit" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "cloudflare" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "cloudflare" }, { "id": "reaktor-work", "anchor": "parity-gates", "relation": "references", "sourceAnchor": "spring-orchestration" }, { "id": "reaktor-db", "anchor": "erasure", "relation": "references", "sourceAnchor": "recipes" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "inspection" }, { "id": "reaktor-devtools", "anchor": "", "relation": "references", "sourceAnchor": "inspection" }, { "id": "reaktor-module-review", "anchor": "reaktor-performance", "relation": "references", "sourceAnchor": "measurements" }, { "id": "private/reaktor-work-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-db", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-data-implementation", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-service", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-bus-mesh", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-data-workflows", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-capability", "anchor": "", "relation": "references", "sourceAnchor": "related-contracts" }, { "id": "reaktor-module-execution-plan", "anchor": "reaktor-work", "relation": "references", "sourceAnchor": "related-contracts" } ] }, { "id": "reaktor-workbench-layers", "owner": "Codex", "kind": "architecture", "summary": "The implemented boundaries between reusable tooling, headless graph runtime, the workspace kernel, CLI, desktop and MCP; service ownership, operation receipts, connection evidence and credentials.", "use": "Start here when changing the kernel/UI split or deciding where a workbench capability belongs. Separates the local implementation from the proposed distributed control plane.", "region": "workbench-surfaces", "order": 7, "title": "Reaktor Workbench Layers — Tooling, Kernel and Hosts", "nav": "Workbench Layers", "group": "workbench", "subsection": "workbench-surfaces", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-workbench-layers", "revision": "df16c739a7992bdce6d28cf7ff5c48bf9fd5a1c37ce8aa5f4f9c0e2b9cf0da21", "status": "unverified", "renderingRevision": "33aaf5405193bcba790a447b9698abfa7476167d38f0246fa42df6c7663358d1", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developers.cloudflare.com/d1/reference/migrations/", "https://documentation.red-gate.com/fd/flyway-schema-history-table-273973417.html", "https://docs.liquibase.com/concepts/basic/databasechangelog-table.html", "https://atlasgo.io/versioned/apply" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-workbench-layers", "polarity": "Neutral" }, { "id": "section-the-layer-map", "anchor": "the-layer-map", "label": "The layer map", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#the-layer-map", "polarity": "Neutral" }, { "id": "section-what-kernel-means-here", "anchor": "what-kernel-means-here", "label": "What “kernel” means here", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#what-kernel-means-here", "polarity": "Neutral" }, { "id": "section-lifetime-and-host-boundaries", "anchor": "lifetime-and-host-boundaries", "label": "Lifetime and host boundaries", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#lifetime-and-host-boundaries", "polarity": "Neutral" }, { "id": "section-one-operation-path", "anchor": "one-operation-path", "label": "One operation path", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#one-operation-path", "polarity": "Neutral" }, { "id": "section-mcp-is-an-adapter-over-the-kernel", "anchor": "mcp-is-an-adapter-over-the-kernel", "label": "MCP is an adapter over the kernel", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#mcp-is-an-adapter-over-the-kernel", "polarity": "Neutral" }, { "id": "section-external-connections-and-credentials", "anchor": "external-connections-and-credentials", "label": "External connections and credentials", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#external-connections-and-credentials", "polarity": "Neutral" }, { "id": "section-one-command-line", "anchor": "one-command-line", "label": "One command line", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#one-command-line", "polarity": "Neutral" }, { "id": "section-auth-workspace-projections", "anchor": "auth-workspace-projections", "label": "Auth workspace projections", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#auth-workspace-projections", "polarity": "Neutral" }, { "id": "section-authority-and-strict-sql--implementation-and-remaining-work", "anchor": "authority-and-strict-sql--implementation-and-remaining-work", "label": "Authority and strict SQL — implementation and remaining work", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#authority-and-strict-sql--implementation-and-remaining-work", "polarity": "Neutral" }, { "id": "section-data-workspace-projections", "anchor": "data-workspace-projections", "label": "Data workspace projections", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-layers#data-workspace-projections", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-workbench-layers:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor-workbench-layers", "incidences": [ { "node": "reaktor-workbench-layers", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-layers:references-reaktor-graph-protocol", "kind": "references", "owner": "reaktor-workbench-layers", "incidences": [ { "node": "reaktor-workbench-layers", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-protocol", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-layers:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor-workbench-layers", "incidences": [ { "node": "reaktor-workbench-layers", "port": "page", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-layers:references-reaktor-data-inspection-authority", "kind": "references", "owner": "reaktor-workbench-layers", "incidences": [ { "node": "reaktor-workbench-layers", "port": "section-authority-and-strict-sql--implementation-and-remaining-work", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "section-authority", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-layers:references-reaktor-data-inspection-providers", "kind": "references", "owner": "reaktor-workbench-layers", "incidences": [ { "node": "reaktor-workbench-layers", "port": "section-data-workspace-projections", "role": "source", "ordinal": 0 }, { "node": "reaktor-data-inspection", "port": "section-providers", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-layers:references-reaktor-db-reading-map", "kind": "references", "owner": "reaktor-workbench-layers", "incidences": [ { "node": "reaktor-workbench-layers", "port": "section-data-workspace-projections", "role": "source", "ordinal": 0 }, { "node": "reaktor-db", "port": "section-reading-map", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-workbench-layers.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Workbench Layers — Tooling, Kernel and Hosts", "level": 0 }, { "id": "the-layer-map", "anchor": "the-layer-map", "title": "The layer map", "level": 2 }, { "id": "what-kernel-means-here", "anchor": "what-kernel-means-here", "title": "What “kernel” means here", "level": 2 }, { "id": "lifetime-and-host-boundaries", "anchor": "lifetime-and-host-boundaries", "title": "Lifetime and host boundaries", "level": 2 }, { "id": "one-operation-path", "anchor": "one-operation-path", "title": "One operation path", "level": 2 }, { "id": "mcp-is-an-adapter-over-the-kernel", "anchor": "mcp-is-an-adapter-over-the-kernel", "title": "MCP is an adapter over the kernel", "level": 2 }, { "id": "external-connections-and-credentials", "anchor": "external-connections-and-credentials", "title": "External connections and credentials", "level": 2 }, { "id": "infrastructure-execution-on-the-jvm", "anchor": "infrastructure-execution-on-the-jvm", "title": "Infrastructure execution on the JVM", "level": 2 }, { "id": "worker-as-an-execution-host", "anchor": "worker-as-an-execution-host", "title": "Worker as an execution host", "level": 2 }, { "id": "authority-and-strict-sql--implementation-and-remaining-work", "anchor": "authority-and-strict-sql--implementation-and-remaining-work", "title": "Authority and strict SQL — implementation and remaining work", "level": 2 }, { "id": "data-workspace-projections", "anchor": "data-workspace-projections", "title": "Data workspace projections", "level": 2 }, { "id": "auth-workspace-projections", "anchor": "auth-workspace-projections", "title": "Auth workspace projections", "level": 2 }, { "id": "verification-evidence", "anchor": "verification-evidence", "title": "Verification evidence", "level": 2 }, { "id": "using-the-implemented-layer", "anchor": "using-the-implemented-layer", "title": "Using the implemented layer", "level": 2 }, { "id": "where-a-new-capability-belongs", "anchor": "where-a-new-capability-belongs", "title": "Where a new capability belongs", "level": 2 }, { "id": "one-command-line", "anchor": "one-command-line", "title": "One command line", "level": 2 }, { "id": "move-the-generic-half-of-the-kernel", "anchor": "move-the-generic-half-of-the-kernel", "title": "Move the generic half of the kernel", "level": 3 }, { "id": "what-the-cli-owns", "anchor": "what-the-cli-owns", "title": "What the CLI owns", "level": 3 }, { "id": "command-surface", "anchor": "command-surface", "title": "Command surface", "level": 3 }, { "id": "contracts", "anchor": "contracts", "title": "Contracts", "level": 3 }, { "id": "sequencing", "anchor": "sequencing", "title": "Sequencing", "level": 3 }, { "id": "evidence-required", "anchor": "evidence-required", "title": "Evidence required", "level": 3 }, { "id": "open-decisions", "anchor": "open-decisions", "title": "Open decisions", "level": 3 } ], "links": [ { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-graph-protocol", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-workbench-layers", "anchor": "one-command-line", "relation": "references", "sourceAnchor": "the-layer-map" }, { "id": "reaktor-data-inspection", "anchor": "authority", "relation": "references", "sourceAnchor": "authority-and-strict-sql--implementation-and-remaining-work" }, { "id": "reaktor-data-inspection", "anchor": "providers", "relation": "references", "sourceAnchor": "data-workspace-projections" }, { "id": "reaktor-db", "anchor": "reading-map", "relation": "references", "sourceAnchor": "data-workspace-projections" } ] }, { "id": "reaktor-workbench-links", "owner": "Claude", "kind": "architecture", "summary": "How Reaktor Desktop's panes connect: a screen in the running app to its service, the Cloudflare worker that serves it through the gateway, the databases it touches and the Data targets for them, and back from any store to the workers, services and screens that depend on it. What Graph, Cloud, Data, DevTools, Deploy and Analytics each show from the others, live product analytics from ClickHouse, the system_trace MCP read, and the limits of the link rules.", "use": "Read before changing how panes navigate to each other, the SystemLinks model in the engine's links package, the Deploy Live tab or the Analytics reads. Section 1 is the resolution chain, section 2 what each pane shows, section 5 the limits.", "region": "operations-delivery", "order": 2, "title": "Reaktor Workbench Links", "nav": "Connected panes", "group": "operations", "subsection": "operations-delivery", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-workbench-links", "revision": "17bed1499d908c395fd053cfc9d94fcb31dc3ff1e7e15d67514f1ab73ba3ab0c", "status": "unverified", "renderingRevision": "31e6bb9a46162630ab2ab447e72d6bec999ec4963c1d34bce117fd4e6bb47f35", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-workbench-links", "polarity": "Neutral" }, { "id": "section-operational-evidence-beyond-structural-links", "anchor": "operational-evidence-beyond-structural-links", "label": "Operational evidence beyond structural links", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-links#operational-evidence-beyond-structural-links", "polarity": "Neutral" }, { "id": "section-chain", "anchor": "chain", "label": "The chain", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-links#chain", "polarity": "Neutral" }, { "id": "section-where", "anchor": "where", "label": "Where you see it", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-links#where", "polarity": "Neutral" }, { "id": "section-analytics", "anchor": "analytics", "label": "Product analytics", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-links#analytics", "polarity": "Neutral" }, { "id": "section-agents", "anchor": "agents", "label": "For coding agents", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-links#agents", "polarity": "Neutral" }, { "id": "section-limits", "anchor": "limits", "label": "Limits", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-links#limits", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-workbench-links:references-operations", "kind": "references", "owner": "reaktor-workbench-links", "incidences": [ { "node": "reaktor-workbench-links", "port": "section-operational-evidence-beyond-structural-links", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-links:references-operations-graph-evidence", "kind": "references", "owner": "reaktor-workbench-links", "incidences": [ { "node": "reaktor-workbench-links", "port": "section-operational-evidence-beyond-structural-links", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-links:references-operations-instance-diagnostics", "kind": "references", "owner": "reaktor-workbench-links", "incidences": [ { "node": "reaktor-workbench-links", "port": "section-operational-evidence-beyond-structural-links", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-links:references-operations-observability", "kind": "references", "owner": "reaktor-workbench-links", "incidences": [ { "node": "reaktor-workbench-links", "port": "section-operational-evidence-beyond-structural-links", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-links:references-reaktor-graph-pane", "kind": "references", "owner": "reaktor-workbench-links", "incidences": [ { "node": "reaktor-workbench-links", "port": "section-chain", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-links:references-reaktor-cloud", "kind": "references", "owner": "reaktor-workbench-links", "incidences": [ { "node": "reaktor-workbench-links", "port": "section-chain", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-workbench-links.json", "sections": [ { "id": "operational-evidence-beyond-structural-links", "anchor": "operational-evidence-beyond-structural-links", "title": "Operational evidence beyond structural links", "level": 2 }, { "id": "reaktor-workbench-links", "anchor": "reaktor-workbench-links", "title": "Reaktor Workbench Links", "level": 1 }, { "id": "chain", "anchor": "chain", "title": "The chain", "level": 2 }, { "id": "where", "anchor": "where", "title": "Where you see it", "level": 2 }, { "id": "analytics", "anchor": "analytics", "title": "Product analytics", "level": 2 }, { "id": "agents", "anchor": "agents", "title": "For coding agents", "level": 2 }, { "id": "limits", "anchor": "limits", "title": "Limits", "level": 2 }, { "id": "next", "anchor": "next", "title": "Next", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "operational-evidence-beyond-structural-links" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "operational-evidence-beyond-structural-links" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "operational-evidence-beyond-structural-links" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "operational-evidence-beyond-structural-links" }, { "id": "reaktor-graph-pane", "anchor": "", "relation": "references", "sourceAnchor": "chain" }, { "id": "reaktor-cloud", "anchor": "", "relation": "references", "sourceAnchor": "chain" } ] }, { "id": "reaktor-workbench-roadmap", "owner": "Claude", "kind": "strategy", "summary": "Product and platform roadmap: phases, modules, moats, risks, and success metrics.", "use": "Historical delivery proposal. Use the Astra system plan and module execution plan for current direction and acceptance criteria.", "region": "background-roadmaps", "order": 1, "title": "Strategic Roadmap", "nav": "Strategic Roadmap", "group": "background", "subsection": "background-roadmaps", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor-workbench-roadmap", "revision": "42c5ade4f318676287637f0159e8995941c68babc714bc8fc138667687cc626e", "status": "superseded", "renderingRevision": "6e32f955d3a6499d4d6175263c16dc1b75084130b677c1eb4d807726182ac745", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "✓ 1. Current State — What Exists Today", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap#current", "polarity": "Neutral" }, { "id": "section-pillars", "anchor": "pillars", "label": "▲ 2. Three Strategic Pillars", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap#pillars", "polarity": "Neutral" }, { "id": "section-modules", "anchor": "modules", "label": "▦ 9. Module Roadmap — All 27+ Modules", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap#modules", "polarity": "Neutral" }, { "id": "section-personas", "anchor": "personas", "label": "☺ 10. Persona Journeys", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap#personas", "polarity": "Neutral" }, { "id": "section-competitive", "anchor": "competitive", "label": "⚔ 11. Competitive Moats Over Time", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap#competitive", "polarity": "Neutral" }, { "id": "section-gtm", "anchor": "gtm", "label": "🚀 12. Go-to-Market Strategy", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap#gtm", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor-workbench-roadmap#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor-workbench-roadmap:references-codex-roadmap", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "codex-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-roadmap:references-reaktor-implementation-plan", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-implementation-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-roadmap:references-reaktor-architecture-analysis", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-architecture-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-roadmap:references-reaktor-koog-workbench", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-koog-workbench", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-roadmap:references-reaktor-competitive-analysis", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-competitive-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-roadmap:references-reaktor-framework-overview", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-framework-overview", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-roadmap:current-astra-reaktor-plan-and-roadmap", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "page", "role": "source", "ordinal": 0 }, { "node": "astra-reaktor-plan-and-roadmap", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor-workbench-roadmap:current-reaktor-module-execution-plan", "kind": "references", "owner": "reaktor-workbench-roadmap", "incidences": [ { "node": "reaktor-workbench-roadmap", "port": "page", "role": "source", "ordinal": 0 }, { "node": "reaktor-module-execution-plan", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor-workbench-roadmap.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Strategic Roadmap", "level": 0 }, { "id": "current", "anchor": "current", "title": "✓ 1. Current State — What Exists Today", "level": 2 }, { "id": "framework-production-ready", "anchor": "framework-production-ready", "title": "Framework (Production-Ready)", "level": 4 }, { "id": "workbench-partial", "anchor": "workbench-partial", "title": "Workbench (Partial)", "level": 4 }, { "id": "the-web-prototype-reaktorbuild", "anchor": "the-web-prototype-reaktorbuild", "title": "The Web Prototype (reaktor.build)", "level": 4 }, { "id": "pillars", "anchor": "pillars", "title": "▲ 2. Three Strategic Pillars", "level": 2 }, { "id": "the-graph-is-everything", "anchor": "the-graph-is-everything", "title": "The Graph Is Everything", "level": 4 }, { "id": "commands-not-code", "anchor": "commands-not-code", "title": "Commands, Not Code", "level": 4 }, { "id": "every-persona-one-graph", "anchor": "every-persona-one-graph", "title": "Every Persona, One Graph", "level": 4 }, { "id": "11-graphmanifest-generation", "anchor": "11-graphmanifest-generation", "title": "1.1 GraphManifest Generation", "level": 3 }, { "id": "12-reaktor-flow-stabilization", "anchor": "12-reaktor-flow-stabilization", "title": "1.2 reaktor-flow Stabilization", "level": 3 }, { "id": "13-workbench-shell-5-mode", "anchor": "13-workbench-shell-5-mode", "title": "1.3 Workbench Shell (5-mode)", "level": 3 }, { "id": "14-ide-bridge-v1", "anchor": "14-ide-bridge-v1", "title": "1.4 IDE Bridge v1", "level": 3 }, { "id": "p1-exit-criteria", "anchor": "p1-exit-criteria", "title": "P1 Exit Criteria", "level": 3 }, { "id": "21-type-aware-inspector-system", "anchor": "21-type-aware-inspector-system", "title": "2.1 Type-Aware Inspector System", "level": 3 }, { "id": "22-run-screen", "anchor": "22-run-screen", "title": "2.2 Run Screen", "level": 3 }, { "id": "23-devtools-screen", "anchor": "23-devtools-screen", "title": "2.3 DevTools Screen", "level": 3 }, { "id": "24-deploy-screen", "anchor": "24-deploy-screen", "title": "2.4 Deploy Screen", "level": 3 }, { "id": "25-insights-screen", "anchor": "25-insights-screen", "title": "2.5 Insights Screen", "level": 3 }, { "id": "26-command-palette-cmdk", "anchor": "26-command-palette-cmdk", "title": "2.6 Command Palette (Cmd+K)", "level": 3 }, { "id": "27-drawer-system", "anchor": "27-drawer-system", "title": "2.7 Drawer System", "level": 3 }, { "id": "p2-exit-criteria", "anchor": "p2-exit-criteria", "title": "P2 Exit Criteria", "level": 3 }, { "id": "31-graphcommand-schema", "anchor": "31-graphcommand-schema", "title": "3.1 GraphCommand Schema", "level": 3 }, { "id": "32-command-queue--preview", "anchor": "32-command-queue--preview", "title": "3.2 Command Queue + Preview", "level": 3 }, { "id": "33-llm-code-generation-pipeline", "anchor": "33-llm-code-generation-pipeline", "title": "3.3 LLM Code Generation Pipeline", "level": 3 }, { "id": "34-agent-chat-interface", "anchor": "34-agent-chat-interface", "title": "3.4 Agent Chat Interface", "level": 3 }, { "id": "35-mcp-server", "anchor": "35-mcp-server", "title": "3.5 MCP Server", "level": 3 }, { "id": "p3-exit-criteria", "anchor": "p3-exit-criteria", "title": "P3 Exit Criteria", "level": 3 }, { "id": "41-cicd-integration", "anchor": "41-cicd-integration", "title": "4.1 CI/CD Integration", "level": 3 }, { "id": "42-telemetry-integration", "anchor": "42-telemetry-integration", "title": "4.2 Telemetry Integration", "level": 3 }, { "id": "43-proactive-agent-monitoring", "anchor": "43-proactive-agent-monitoring", "title": "4.3 Proactive Agent Monitoring", "level": 3 }, { "id": "p4-exit-criteria", "anchor": "p4-exit-criteria", "title": "P4 Exit Criteria", "level": 3 }, { "id": "51-compose-multiplatform-web-target", "anchor": "51-compose-multiplatform-web-target", "title": "5.1 Compose Multiplatform Web Target", "level": 3 }, { "id": "52-scaffold-from-prompt", "anchor": "52-scaffold-from-prompt", "title": "5.2 Scaffold from Prompt", "level": 3 }, { "id": "53-role-based-views", "anchor": "53-role-based-views", "title": "5.3 Role-Based Views", "level": 3 }, { "id": "54-team-collaboration", "anchor": "54-team-collaboration", "title": "5.4 Team Collaboration", "level": 3 }, { "id": "p5-exit-criteria", "anchor": "p5-exit-criteria", "title": "P5 Exit Criteria", "level": 3 }, { "id": "61-plugin-architecture", "anchor": "61-plugin-architecture", "title": "6.1 Plugin Architecture", "level": 3 }, { "id": "62-template-marketplace", "anchor": "62-template-marketplace", "title": "6.2 Template Marketplace", "level": 3 }, { "id": "63-enterprise-features", "anchor": "63-enterprise-features", "title": "6.3 Enterprise Features", "level": 3 }, { "id": "64-the-flywheel", "anchor": "64-the-flywheel", "title": "6.4 The Flywheel", "level": 3 }, { "id": "modules", "anchor": "modules", "title": "▦ 9. Module Roadmap — All 27+ Modules", "level": 2 }, { "id": "personas", "anchor": "personas", "title": "☺ 10. Persona Journeys", "level": 2 }, { "id": "kmp-developer--i-need-to-add-apple-pay-to-the-checkout-flow", "anchor": "kmp-developer--i-need-to-add-apple-pay-to-the-checkout-flow", "title": "KMP Developer — \"I need to add Apple Pay to the checkout flow\"", "level": 4 }, { "id": "product-manager--why-is-onboarding-conversion-dropping", "anchor": "product-manager--why-is-onboarding-conversion-dropping", "title": "Product Manager — \"Why is onboarding conversion dropping?\"", "level": 4 }, { "id": "devops--is-it-safe-to-promote-v813-to-production", "anchor": "devops--is-it-safe-to-promote-v813-to-production", "title": "DevOps — \"Is it safe to promote v813 to production?\"", "level": 4 }, { "id": "competitive", "anchor": "competitive", "title": "⚔ 11. Competitive Moats Over Time", "level": 2 }, { "id": "gtm", "anchor": "gtm", "title": "🚀 12. Go-to-Market Strategy", "level": 2 }, { "id": "phase-1-2-developer-first-weeks-0-16", "anchor": "phase-1-2-developer-first-weeks-0-16", "title": "Phase 1-2: Developer-First (Weeks 0-16)", "level": 4 }, { "id": "phase-3-4-ai-powered-development-weeks-16-32", "anchor": "phase-3-4-ai-powered-development-weeks-16-32", "title": "Phase 3-4: AI-Powered Development (Weeks 16-32)", "level": 4 }, { "id": "phase-5-6-platform-for-teams-weeks-32-60", "anchor": "phase-5-6-platform-for-teams-weeks-32-60", "title": "Phase 5-6: Platform for Teams (Weeks 32-60)", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "⚠ 13. Risks & Mitigations", "level": 2 }, { "id": "success", "anchor": "success", "title": "★ 14. Success Metrics", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "codex-roadmap", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-implementation-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-architecture-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-koog-workbench", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-competitive-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-framework-overview", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "reaktor_graph_visitors_design", "owner": "Design", "kind": "architecture", "summary": "Routing, wiring, deep links, auth, analytics, workflow compilation, export, validation, and debugging as graph passes.", "use": "Use before designing a new graph pass or selector.", "region": "graph-model", "order": 3, "title": "Reaktor Graph Visitors", "nav": "Graph Visitors", "group": "graph", "subsection": "graph-model", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/reaktor_graph_visitors_design", "revision": "d377a124e7a7ff967ba96af6726fdf4aa8db58d830a4cec33a9e11c237cc9f17", "status": "unverified", "renderingRevision": "d8a0a732c112fe41fd17a30abe6d6c86dda467ea0ae8ee2530aa71977455db8f", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design", "polarity": "Neutral" }, { "id": "section-context", "anchor": "context", "label": "What it is", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#context", "polarity": "Neutral" }, { "id": "section-powers", "anchor": "powers", "label": "What it powers", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#powers", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "Principles", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#principles", "polarity": "Neutral" }, { "id": "section-model", "anchor": "model", "label": "The model", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#model", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "Current state & direction", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#current", "polarity": "Neutral" }, { "id": "section-selectors", "anchor": "selectors", "label": "Selectors", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#selectors", "polarity": "Neutral" }, { "id": "section-mutations", "anchor": "mutations", "label": "Mutations are patches", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#mutations", "polarity": "Neutral" }, { "id": "section-snapshot-consistency", "anchor": "snapshot-consistency", "label": "Snapshot consistency and coverage", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#snapshot-consistency", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#related-docs", "polarity": "Neutral" }, { "id": "section-usecases", "anchor": "usecases", "label": "The use cases, concretely", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#usecases", "polarity": "Neutral" }, { "id": "section-references", "anchor": "references", "label": "References", "profile": "section", "contract": "https://reaktor.build/docs/reaktor_graph_visitors_design#references", "polarity": "Neutral" } ], "relations": [ { "id": "reaktor_graph_visitors_design:references-operations-graph-evidence", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-shadow-capture-replay", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-unified-system-graph", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-unified-system-graph-architecture", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-model", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-architecture", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-unified-system-graph-operations", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-mutations", "role": "source", "ordinal": 0 }, { "node": "reaktor-unified-system-graph", "port": "section-operations", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-graph-refinement-plan", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-mutations", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-refinement-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-deep-link-integration", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-usecases", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-agentic-tooling", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-usecases", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-performance-observability", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-usecases", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-graph-kernel-analysis", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-graph-sources", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-sources", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-analytics-telemetry", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-analytics-telemetry", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-graph-migration-plan", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-graph-migration-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "reaktor_graph_visitors_design:references-reaktor-actor-model", "kind": "references", "owner": "reaktor_graph_visitors_design", "incidences": [ { "node": "reaktor_graph_visitors_design", "port": "section-references", "role": "source", "ordinal": 0 }, { "node": "reaktor-actor-model", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "reaktor_graph_visitors_design.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Graph Visitors", "level": 0 }, { "id": "context", "anchor": "context", "title": "What it is", "level": 2 }, { "id": "powers", "anchor": "powers", "title": "What it powers", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "Principles", "level": 2 }, { "id": "model", "anchor": "model", "title": "The model", "level": 2 }, { "id": "current", "anchor": "current", "title": "Current state & direction", "level": 2 }, { "id": "from", "anchor": "from", "title": "From", "level": 3 }, { "id": "to", "anchor": "to", "title": "To", "level": 3 }, { "id": "selectors", "anchor": "selectors", "title": "Selectors", "level": 2 }, { "id": "combinators--a-view-of-a-view-is-a-view", "anchor": "combinators--a-view-of-a-view-is-a-view", "title": "Combinators — a view of a view is a view", "level": 3 }, { "id": "reactive-selectors", "anchor": "reactive-selectors", "title": "Reactive selectors", "level": 3 }, { "id": "traversals", "anchor": "traversals", "title": "Traversals", "level": 2 }, { "id": "snapshot-consistency", "anchor": "snapshot-consistency", "title": "Snapshot consistency and coverage", "level": 3 }, { "id": "visitors", "anchor": "visitors", "title": "Visitors", "level": 2 }, { "id": "mutations", "anchor": "mutations", "title": "Mutations are patches", "level": 2 }, { "id": "passes", "anchor": "passes", "title": "Passes & diagnostics", "level": 2 }, { "id": "standard", "anchor": "standard", "title": "Standard passes", "level": 2 }, { "id": "crosscutting", "anchor": "crosscutting", "title": "Cross-cutting concerns", "level": 2 }, { "id": "polyglot-wiring--portmatcher", "anchor": "polyglot-wiring--portmatcher", "title": "Polyglot wiring — PortMatcher", "level": 3 }, { "id": "attributes--inheritance", "anchor": "attributes--inheritance", "title": "Attributes & inheritance", "level": 3 }, { "id": "introspection--cycles", "anchor": "introspection--cycles", "title": "Introspection & cycles", "level": 3 }, { "id": "lifecycle-integration", "anchor": "lifecycle-integration", "title": "Lifecycle integration", "level": 3 }, { "id": "usecases", "anchor": "usecases", "title": "The use cases, concretely", "level": 2 }, { "id": "testing", "anchor": "testing", "title": "Testing", "level": 2 }, { "id": "build", "anchor": "build", "title": "Where it lives & build order", "level": 2 }, { "id": "open", "anchor": "open", "title": "Open questions", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 }, { "id": "references", "anchor": "references", "title": "References", "level": 2 } ], "links": [ { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor_graph_visitors_design", "anchor": "current", "relation": "references", "sourceAnchor": "" }, { "id": "reaktor-unified-system-graph", "anchor": "architecture", "relation": "references", "sourceAnchor": "model" }, { "id": "reaktor-unified-system-graph", "anchor": "operations", "relation": "references", "sourceAnchor": "mutations" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "mutations" }, { "id": "reaktor_graph_visitors_design", "anchor": "powers", "relation": "references", "sourceAnchor": "standard" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "usecases" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "usecases" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "usecases" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-sources", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-analytics-telemetry", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-unified-system-graph", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-graph-migration-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-graph-refinement-plan", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "references" }, { "id": "reaktor-actor-model", "anchor": "", "relation": "references", "sourceAnchor": "references" } ] }, { "id": "secrets-management", "owner": "Claude", "kind": "ops", "summary": "Implemented reaktor-secrets seed for GCP Secret Manager, Cloudflare bindings, and BestBuds JVM credentials, plus the cache-first materialization plan.", "use": "Use before moving, rotating, distributing, caching, or materializing secrets.", "region": "ship-production", "order": 0, "title": "Reaktor Secrets", "nav": "Reaktor Secrets", "group": "ship", "subsection": "ship-production", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/secrets-management", "revision": "671612265f4e1a19e856253641535f8385db9ae51cdca43805d3f86ef7e54ca5", "status": "unverified", "renderingRevision": "fd356a69500dbf6ba562c064e11bc11d7d6cf7faae5847c01995831dcdde48e0", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/secrets-management", "polarity": "Neutral" }, { "id": "section-context", "anchor": "context", "label": "Context — why this exists", "profile": "section", "contract": "https://reaktor.build/docs/secrets-management#context", "polarity": "Neutral" }, { "id": "section-goals", "anchor": "goals", "label": "Goals & principles", "profile": "section", "contract": "https://reaktor.build/docs/secrets-management#goals", "polarity": "Neutral" }, { "id": "section-reaktor-secrets", "anchor": "reaktor-secrets", "label": "Reaktor Secrets module", "profile": "section", "contract": "https://reaktor.build/docs/secrets-management#reaktor-secrets", "polarity": "Neutral" }, { "id": "section-architecture", "anchor": "architecture", "label": "Architecture", "profile": "section", "contract": "https://reaktor.build/docs/secrets-management#architecture", "polarity": "Neutral" }, { "id": "section-cache-first", "anchor": "cache-first", "label": "Cache-first delivery model", "profile": "section", "contract": "https://reaktor.build/docs/secrets-management#cache-first", "polarity": "Neutral" }, { "id": "section-dagger", "anchor": "dagger", "label": "Secrets as a Dagger workflow", "profile": "section", "contract": "https://reaktor.build/docs/secrets-management#dagger", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/secrets-management#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "secrets-management:references-security-plan", "kind": "references", "owner": "secrets-management", "incidences": [ { "node": "secrets-management", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "secrets-management:references-auth-analysis", "kind": "references", "owner": "secrets-management", "incidences": [ { "node": "secrets-management", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "secrets-management:references-reaktor-devops", "kind": "references", "owner": "secrets-management", "incidences": [ { "node": "secrets-management", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "secrets-management:references-reaktor-cloud-pane", "kind": "references", "owner": "secrets-management", "incidences": [ { "node": "secrets-management", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-cloud-pane", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "secrets-management:references-shadow-dev-environment", "kind": "references", "owner": "secrets-management", "incidences": [ { "node": "secrets-management", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "secrets-management:references-reaktor-gemini-devops-agent", "kind": "references", "owner": "secrets-management", "incidences": [ { "node": "secrets-management", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-gemini-devops-agent", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "secrets-management.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Reaktor Secrets", "level": 0 }, { "id": "context", "anchor": "context", "title": "Context — why this exists", "level": 2 }, { "id": "goals", "anchor": "goals", "title": "Goals & principles", "level": 2 }, { "id": "reaktor-secrets", "anchor": "reaktor-secrets", "title": "Reaktor Secrets module", "level": 2 }, { "id": "architecture", "anchor": "architecture", "title": "Architecture", "level": 2 }, { "id": "cache-first", "anchor": "cache-first", "title": "Cache-first delivery model", "level": 2 }, { "id": "cache-ledger", "anchor": "cache-ledger", "title": "Cache ledger", "level": 3 }, { "id": "refresh-algorithm", "anchor": "refresh-algorithm", "title": "Refresh algorithm", "level": 3 }, { "id": "rotation-signal", "anchor": "rotation-signal", "title": "Rotation signal", "level": 3 }, { "id": "dagger", "anchor": "dagger", "title": "Secrets as a Dagger workflow", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "private/secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-cloud-pane", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-gemini-devops-agent", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "security-plan", "owner": "Claude", "kind": "security", "summary": "Threat model and hardening plan for services, workbench operations, and mutating commands.", "use": "Use before enabling deploy actions, remote agents, or privileged commands.", "region": "ship-production", "order": 1, "title": "Security Implementation Plan", "nav": "Security Plan", "group": "ship", "subsection": "ship-production", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/security-plan", "revision": "d1993e2548593f39bcad2ffec628f81abf16ba9f592014ea0f2c04f6e9b77139", "status": "unverified", "renderingRevision": "35b5faa492085e8cf07ef70a634a64e76ee15ff6c68f5a3079f0fb1ab7e64d7e", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://github.com/cisco/mlspp", "https://datatracker.ietf.org/doc/html/rfc9420", "https://emscripten.org/", "https://developer.android.com/privacy-and-security/keystore", "https://developer.apple.com/documentation/security/keychain-services", "https://learn.microsoft.com/en-us/windows/win32/api/dpapi/nf-dpapi-cryptprotectdata", "https://specifications.freedesktop.org/secret-service/latest-single/", "https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API", "https://developers.cloudflare.com/d1/", "https://developers.cloudflare.com/durable-objects/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/security-plan", "polarity": "Neutral" }, { "id": "section-direction", "anchor": "direction", "label": "Direction", "profile": "section", "contract": "https://reaktor.build/docs/security-plan#direction", "polarity": "Neutral" }, { "id": "section-current-repository-shape", "anchor": "current-repository-shape", "label": "Current Repository Shape", "profile": "section", "contract": "https://reaktor.build/docs/security-plan#current-repository-shape", "polarity": "Neutral" }, { "id": "section-hard-blocker", "anchor": "hard-blocker", "label": "Hard Blocker", "profile": "section", "contract": "https://reaktor.build/docs/security-plan#hard-blocker", "polarity": "Neutral" }, { "id": "section-execution-phases", "anchor": "execution-phases", "label": "Execution Phases", "profile": "section", "contract": "https://reaktor.build/docs/security-plan#execution-phases", "polarity": "Neutral" }, { "id": "section-task-backlog", "anchor": "task-backlog", "label": "Task Backlog", "profile": "section", "contract": "https://reaktor.build/docs/security-plan#task-backlog", "polarity": "Neutral" }, { "id": "section-server-protocol-surface", "anchor": "server-protocol-surface", "label": "Server Protocol Surface", "profile": "section", "contract": "https://reaktor.build/docs/security-plan#server-protocol-surface", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/security-plan#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "security-plan:references-auth-analysis", "kind": "references", "owner": "security-plan", "incidences": [ { "node": "security-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "security-plan:references-secrets-management", "kind": "references", "owner": "security-plan", "incidences": [ { "node": "security-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "security-plan:references-reaktor-devops", "kind": "references", "owner": "security-plan", "incidences": [ { "node": "security-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "security-plan:references-reaktor-agentic-tooling", "kind": "references", "owner": "security-plan", "incidences": [ { "node": "security-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "security-plan:references-shadow-dev-environment", "kind": "references", "owner": "security-plan", "incidences": [ { "node": "security-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "security-plan:references-reaktor-gemini-devops-agent", "kind": "references", "owner": "security-plan", "incidences": [ { "node": "security-plan", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-gemini-devops-agent", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "security-plan.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Security Implementation Plan", "level": 0 }, { "id": "direction", "anchor": "direction", "title": "Direction", "level": 2 }, { "id": "expose", "anchor": "expose", "title": "Expose", "level": 3 }, { "id": "do-not-expose", "anchor": "do-not-expose", "title": "Do Not Expose", "level": 3 }, { "id": "current-repository-shape", "anchor": "current-repository-shape", "title": "Current Repository Shape", "level": 2 }, { "id": "hard-blocker", "anchor": "hard-blocker", "title": "Hard Blocker", "level": 2 }, { "id": "execution-phases", "anchor": "execution-phases", "title": "Execution Phases", "level": 2 }, { "id": "p0---native-core-and-build-hygiene", "anchor": "p0---native-core-and-build-hygiene", "title": "P0 - Native Core and Build Hygiene", "level": 3 }, { "id": "p1---durable-state-and-credentials", "anchor": "p1---durable-state-and-credentials", "title": "P1 - Durable State and Credentials", "level": 3 }, { "id": "p2---conversation-operations", "anchor": "p2---conversation-operations", "title": "P2 - Conversation Operations", "level": 3 }, { "id": "p3---platform-secret-boxes", "anchor": "p3---platform-secret-boxes", "title": "P3 - Platform Secret Boxes", "level": 3 }, { "id": "p4---server-backends", "anchor": "p4---server-backends", "title": "P4 - Server Backends", "level": 3 }, { "id": "p5---web-wasm-and-react-native", "anchor": "p5---web-wasm-and-react-native", "title": "P5 - Web, WASM, and React Native", "level": 3 }, { "id": "p6---hardening-and-release", "anchor": "p6---hardening-and-release", "title": "P6 - Hardening and Release", "level": 3 }, { "id": "task-backlog", "anchor": "task-backlog", "title": "Task Backlog", "level": 2 }, { "id": "server-protocol-surface", "anchor": "server-protocol-surface", "title": "Server Protocol Surface", "level": 2 }, { "id": "p0-completion-bar", "anchor": "p0-completion-bar", "title": "P0 Completion Bar", "level": 2 }, { "id": "do-not-implement", "anchor": "do-not-implement", "title": "Do Not Implement", "level": 2 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 }, { "id": "references", "anchor": "references", "title": "References", "level": 2 } ], "links": [ { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-gemini-devops-agent", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "shadow-backends", "owner": "Reaktor / Codex", "kind": "testing", "summary": "Textbook chapters 10–11: current Keploy adapter limits and version-qualified local, preview and deployed backend choices.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-shadow", "order": 5, "title": "Shadow Backends and Keploy Qualification", "nav": "Backends & Keploy", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-backends", "revision": "118801f816496b3c881a7226f37458f367408cbb59042e5b10a85bee04047f31", "status": "unverified", "renderingRevision": "d4b819b8c7b9f14a9f9a5a294a33d853d886072d2387f84204a665801f9c4cdb", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://keploy.io/docs/running-keploy/mock-your-tests/", "https://keploy.io/docs/server/install/", "https://keploy.io/docs/quickstart/k8s-proxy/", "https://keploy.io/docs/keploy-explained/introduction/", "https://developers.cloudflare.com/workers/previews/", "https://developers.cloudflare.com/workers/testing/vitest-integration/", "https://developers.cloudflare.com/workers/testing/vitest-integration/migration-guides/migrate-to-vitest-plugin/", "https://developers.cloudflare.com/workers/testing/vitest-integration/mock-outbound-requests/", "https://supabase.com/docs/guides/deployment/branching/dashboard", "https://developers.cloudflare.com/dynamic-workers/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-backends", "polarity": "Neutral" }, { "id": "section-current-keploy-adapter", "anchor": "current-keploy-adapter", "label": "Current Keploy adapter", "profile": "section", "contract": "https://reaktor.build/docs/shadow-backends#current-keploy-adapter", "polarity": "Neutral" }, { "id": "section-keploys-role", "anchor": "keploys-role", "label": "Keploy's role", "profile": "section", "contract": "https://reaktor.build/docs/shadow-backends#keploys-role", "polarity": "Neutral" }, { "id": "section-jvm-process-recording", "anchor": "jvm-process-recording", "label": "JVM process recording and dependency replay", "profile": "section", "contract": "https://reaktor.build/docs/shadow-backends#jvm-process-recording", "polarity": "Neutral" }, { "id": "section-backend-choice", "anchor": "backend-choice", "label": "Backend choice", "profile": "section", "contract": "https://reaktor.build/docs/shadow-backends#backend-choice", "polarity": "Neutral" }, { "id": "section-conformance-receipt", "anchor": "conformance-receipt", "label": "Conformance receipt", "profile": "section", "contract": "https://reaktor.build/docs/shadow-backends#conformance-receipt", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-backends:references-operations-references-implementation-evidence", "kind": "references", "owner": "shadow-backends", "incidences": [ { "node": "shadow-backends", "port": "section-current-keploy-adapter", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "section-implementation-evidence", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-backends:references-shadow-capture-fabric-jvm-process-recording", "kind": "references", "owner": "shadow-backends", "incidences": [ { "node": "shadow-backends", "port": "section-jvm-process-recording", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "section-jvm-process-recording", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-backends.json", "sections": [ { "id": "shadow-backends-and-keploy-qualification", "anchor": "shadow-backends-and-keploy-qualification", "title": "Shadow Backends and Keploy Qualification", "level": 1 }, { "id": "current-keploy-adapter", "anchor": "current-keploy-adapter", "title": "Current Keploy adapter", "level": 2 }, { "id": "keploys-role", "anchor": "keploys-role", "title": "Keploy's role", "level": 2 }, { "id": "jvm-process-recording", "anchor": "jvm-process-recording", "title": "JVM process recording and dependency replay", "level": 2 }, { "id": "backend-choice", "anchor": "backend-choice", "title": "Backend choice", "level": 2 }, { "id": "conformance-receipt", "anchor": "conformance-receipt", "title": "Conformance receipt", "level": 2 } ], "links": [ { "id": "operations-references", "anchor": "implementation-evidence", "relation": "references", "sourceAnchor": "current-keploy-adapter" }, { "id": "shadow-capture-fabric", "anchor": "jvm-process-recording", "relation": "references", "sourceAnchor": "jvm-process-recording" } ] }, { "id": "shadow-capture-fabric", "owner": "Reaktor / Codex", "kind": "architecture", "summary": "Capture all supported graph, JVM, eBPF/kernel, JavaScript, Worker, Kubernetes, state and client evidence with explicit coverage and replay capability.", "use": "Use to implement layered Shadow capture through existing graph plans, journals and receipts; distinguish current foundations from proposed deep collectors.", "region": "operations-shadow", "order": 3, "title": "Shadow Capture Fabric", "nav": "Capture fabric", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-capture-fabric", "revision": "381d57be8fd179edf68d61cd7d9598cc11ba0f8532b12efbc5d35a85f68ee088", "status": "unverified", "renderingRevision": "1ce934d9cc3266754cca1fa8aeee39c7517cae603d014b514f77cd2d70dd38a1", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://docs.oracle.com/en/java/javase/25/docs/api/java.instrument/java/lang/instrument/package-summary.html", "https://docs.oracle.com/en/java/javase/25/docs/specs/jvmti.html", "https://docs.oracle.com/en/java/javase/25/docs/api/jdk.jfr/jdk/jfr/package-summary.html", "https://keploy.io/docs/keploy-explained/introduction/", "https://docs.oracle.com/en/java/javase/25/docs/specs/jvmti.html#MethodEntry", "https://docs.kernel.org/bpf/ringbuf.html", "https://developers.cloudflare.com/workers/observability/logs/tail-workers/", "https://developers.cloudflare.com/workers/reference/how-workers-works/", "https://kubernetes.io/docs/tasks/debug/debug-cluster/audit/", "https://kubernetes.io/docs/reference/using-api/api-concepts/#efficient-detection-of-changes" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-capture-fabric", "polarity": "Neutral" }, { "id": "section-capture-across-every-available-layer", "anchor": "capture-across-every-available-layer", "label": "Capture across every available layer", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#capture-across-every-available-layer", "polarity": "Neutral" }, { "id": "section-jvm-process-recording", "anchor": "jvm-process-recording", "label": "JVM process recording", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#jvm-process-recording", "polarity": "Neutral" }, { "id": "section-kernel-capture-and-application-joins", "anchor": "kernel-capture-and-application-joins", "label": "Kernel capture and application joins", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#kernel-capture-and-application-joins", "polarity": "Neutral" }, { "id": "section-javascript-recording-stronger-than-proxies", "anchor": "javascript-recording-stronger-than-proxies", "label": "JavaScript recording stronger than proxies", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#javascript-recording-stronger-than-proxies", "polarity": "Neutral" }, { "id": "section-workers-and-kubernetes-capture", "anchor": "workers-and-kubernetes-capture", "label": "Workers and Kubernetes capture", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#workers-and-kubernetes-capture", "polarity": "Neutral" }, { "id": "section-one-execution-with-several-observations", "anchor": "one-execution-with-several-observations", "label": "One execution with several observations", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#one-execution-with-several-observations", "polarity": "Neutral" }, { "id": "section-depth-and-completeness", "anchor": "depth-and-completeness", "label": "Depth and completeness", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#depth-and-completeness", "polarity": "Neutral" }, { "id": "section-replay-capability-and-delivery", "anchor": "replay-capability-and-delivery", "label": "Replay capability and delivery", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-fabric#replay-capability-and-delivery", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-capture-fabric:references-operations-graph-evidence", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-capture-across-every-available-layer", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-fabric:references-operations-instance-diagnostics", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-capture-across-every-available-layer", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-fabric:references-operations-profiling", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-jvm-process-recording", "role": "source", "ordinal": 0 }, { "node": "operations-profiling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-fabric:references-shadow-backends-jvm-process-recording", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-jvm-process-recording", "role": "source", "ordinal": 0 }, { "node": "shadow-backends", "port": "section-jvm-process-recording", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-fabric:references-shadow-capture-replay-es6-facade-sketch", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-javascript-recording-stronger-than-proxies", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "section-es6-facade-sketch", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-fabric:references-shadow-verification", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-depth-and-completeness", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-fabric:references-operations-delivery-capture-fabric-gate", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-replay-capability-and-delivery", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "section-capture-fabric-gate", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-fabric:references-operations-references-implementation-evidence", "kind": "references", "owner": "shadow-capture-fabric", "incidences": [ { "node": "shadow-capture-fabric", "port": "section-replay-capability-and-delivery", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "section-implementation-evidence", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-capture-fabric.json", "sections": [ { "id": "shadow-capture-fabric", "anchor": "shadow-capture-fabric", "title": "Shadow Capture Fabric", "level": 1 }, { "id": "capture-across-every-available-layer", "anchor": "capture-across-every-available-layer", "title": "Capture across every available layer", "level": 2 }, { "id": "jvm-process-recording", "anchor": "jvm-process-recording", "title": "JVM process recording", "level": 2 }, { "id": "kernel-capture-and-application-joins", "anchor": "kernel-capture-and-application-joins", "title": "Kernel capture and application joins", "level": 2 }, { "id": "javascript-recording-stronger-than-proxies", "anchor": "javascript-recording-stronger-than-proxies", "title": "JavaScript recording stronger than proxies", "level": 2 }, { "id": "workers-and-kubernetes-capture", "anchor": "workers-and-kubernetes-capture", "title": "Workers and Kubernetes capture", "level": 2 }, { "id": "one-execution-with-several-observations", "anchor": "one-execution-with-several-observations", "title": "One execution with several observations", "level": 2 }, { "id": "depth-and-completeness", "anchor": "depth-and-completeness", "title": "Depth and completeness", "level": 2 }, { "id": "replay-capability-and-delivery", "anchor": "replay-capability-and-delivery", "title": "Replay capability and delivery", "level": 2 } ], "links": [ { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "capture-across-every-available-layer" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "capture-across-every-available-layer" }, { "id": "operations-profiling", "anchor": "", "relation": "references", "sourceAnchor": "jvm-process-recording" }, { "id": "shadow-backends", "anchor": "jvm-process-recording", "relation": "references", "sourceAnchor": "jvm-process-recording" }, { "id": "shadow-capture-replay", "anchor": "es6-facade-sketch", "relation": "references", "sourceAnchor": "javascript-recording-stronger-than-proxies" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "depth-and-completeness" }, { "id": "operations-delivery", "anchor": "capture-fabric-gate", "relation": "references", "sourceAnchor": "replay-capability-and-delivery" }, { "id": "operations-references", "anchor": "implementation-evidence", "relation": "references", "sourceAnchor": "replay-capability-and-delivery" } ] }, { "id": "shadow-capture-replay", "owner": "Reaktor / Codex", "kind": "architecture", "summary": "Textbook chapters 7–9: graph-selected operation journals, ES6 facade sketch, async ordering, matching and fidelity coverage.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-shadow", "order": 4, "title": "Shadow Capture, Replay and Fidelity", "nav": "Capture & replay", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-capture-replay", "revision": "1e0f219dab724432b6a96e047234aecc6d3486c35a0bdc7dc8c91b1b40457219", "status": "unverified", "renderingRevision": "bb2f42a6e8a55198dc121b877515ae013252fecf9ac23ae979242cb6d8fd2cd3", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://tc39.es/ecma262/multipage/ordinary-and-exotic-objects-behaviours.html#sec-proxy-object-internal-methods-and-internal-slots", "https://developers.cloudflare.com/workers/runtime-apis/bindings/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-capture-replay", "polarity": "Neutral" }, { "id": "section-capture-meaningful-boundaries", "anchor": "capture-meaningful-boundaries", "label": "Capture meaningful boundaries", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-replay#capture-meaningful-boundaries", "polarity": "Neutral" }, { "id": "section-es6-facade-sketch", "anchor": "es6-facade-sketch", "label": "ES6 facade sketch", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-replay#es6-facade-sketch", "polarity": "Neutral" }, { "id": "section-async-order-and-nondeterminism", "anchor": "async-order-and-nondeterminism", "label": "Async order and nondeterminism", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-replay#async-order-and-nondeterminism", "polarity": "Neutral" }, { "id": "section-matching-and-fidelity", "anchor": "matching-and-fidelity", "label": "Matching and fidelity", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-replay#matching-and-fidelity", "polarity": "Neutral" }, { "id": "section-qualification-cases", "anchor": "qualification-cases", "label": "Qualification cases", "profile": "section", "contract": "https://reaktor.build/docs/shadow-capture-replay#qualification-cases", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-capture-replay:references-shadow-capture-fabric", "kind": "references", "owner": "shadow-capture-replay", "incidences": [ { "node": "shadow-capture-replay", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-replay:references-shadow-capture-fabric-javascript-recording-stronger-than-proxies", "kind": "references", "owner": "shadow-capture-replay", "incidences": [ { "node": "shadow-capture-replay", "port": "section-es6-facade-sketch", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "section-javascript-recording-stronger-than-proxies", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-replay:references-shadow-backends", "kind": "references", "owner": "shadow-capture-replay", "incidences": [ { "node": "shadow-capture-replay", "port": "section-qualification-cases", "role": "source", "ordinal": 0 }, { "node": "shadow-backends", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-capture-replay:references-shadow-verification", "kind": "references", "owner": "shadow-capture-replay", "incidences": [ { "node": "shadow-capture-replay", "port": "section-qualification-cases", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-capture-replay.json", "sections": [ { "id": "shadow-capture-replay-and-fidelity", "anchor": "shadow-capture-replay-and-fidelity", "title": "Shadow Capture, Replay and Fidelity", "level": 1 }, { "id": "capture-meaningful-boundaries", "anchor": "capture-meaningful-boundaries", "title": "Capture meaningful boundaries", "level": 2 }, { "id": "es6-facade-sketch", "anchor": "es6-facade-sketch", "title": "ES6 facade sketch", "level": 2 }, { "id": "async-order-and-nondeterminism", "anchor": "async-order-and-nondeterminism", "title": "Async order and nondeterminism", "level": 2 }, { "id": "matching-and-fidelity", "anchor": "matching-and-fidelity", "title": "Matching and fidelity", "level": 2 }, { "id": "qualification-cases", "anchor": "qualification-cases", "title": "Qualification cases", "level": 2 } ], "links": [ { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-capture-fabric", "anchor": "javascript-recording-stronger-than-proxies", "relation": "references", "sourceAnchor": "es6-facade-sketch" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "qualification-cases" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "qualification-cases" } ] }, { "id": "shadow-clients-agents", "owner": "Reaktor / Codex", "kind": "testing", "summary": "Textbook chapter 15: complete client journeys, Surface ownership, mixed revisions, live updates and fixed agent acceptance.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-shadow", "order": 7, "title": "Shadow Clients, Live Updates and Agent Verification", "nav": "Clients & agents", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-clients-agents", "revision": "62257556a4a0e1a996a640071df9d58fc68b0fae139ccd943b606be87d6f3bd3", "status": "unverified", "renderingRevision": "039f4c80555feda2d7b9144ac0cc5c3f7cef107ae21c511f8419e3a50c09af87", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-clients-agents", "polarity": "Neutral" }, { "id": "section-complete-client-journeys", "anchor": "complete-client-journeys", "label": "Complete client journeys", "profile": "section", "contract": "https://reaktor.build/docs/shadow-clients-agents#complete-client-journeys", "polarity": "Neutral" }, { "id": "section-live-update-verification", "anchor": "live-update-verification", "label": "Live-update verification", "profile": "section", "contract": "https://reaktor.build/docs/shadow-clients-agents#live-update-verification", "polarity": "Neutral" }, { "id": "section-agent-scope-and-acceptance", "anchor": "agent-scope-and-acceptance", "label": "Agent scope and acceptance", "profile": "section", "contract": "https://reaktor.build/docs/shadow-clients-agents#agent-scope-and-acceptance", "polarity": "Neutral" }, { "id": "section-handoff-contract", "anchor": "handoff-contract", "label": "Handoff contract", "profile": "section", "contract": "https://reaktor.build/docs/shadow-clients-agents#handoff-contract", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-clients-agents:references-reaktor-surface-dynamic-ui-and-verification", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-complete-client-journeys", "role": "source", "ordinal": 0 }, { "node": "reaktor-surface-dynamic-ui-and-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-clients-agents:references-reaktor-component-lifecycle", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-complete-client-journeys", "role": "source", "ordinal": 0 }, { "node": "reaktor-component-lifecycle", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-clients-agents:references-operations-instance-diagnostics", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-complete-client-journeys", "role": "source", "ordinal": 0 }, { "node": "operations-instance-diagnostics", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-clients-agents:references-reaktor-agent-workspace", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-agent-scope-and-acceptance", "role": "source", "ordinal": 0 }, { "node": "reaktor-agent-workspace", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-clients-agents:references-reaktor-agentic-tooling", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-agent-scope-and-acceptance", "role": "source", "ordinal": 0 }, { "node": "reaktor-agentic-tooling", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-clients-agents:references-reaktor-conductor", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-agent-scope-and-acceptance", "role": "source", "ordinal": 0 }, { "node": "reaktor-conductor", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-clients-agents:references-operations-delivery", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-handoff-contract", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-clients-agents:references-operations-crashlytics", "kind": "references", "owner": "shadow-clients-agents", "incidences": [ { "node": "shadow-clients-agents", "port": "section-complete-client-journeys", "role": "source", "ordinal": 0 }, { "node": "operations-crashlytics", "port": "section-shadow-investigation", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-clients-agents.json", "sections": [ { "id": "shadow-clients-live-updates-and-agents", "anchor": "shadow-clients-live-updates-and-agents", "title": "Shadow Clients, Live Updates and Agents", "level": 1 }, { "id": "complete-client-journeys", "anchor": "complete-client-journeys", "title": "Complete client journeys", "level": 2 }, { "id": "live-update-verification", "anchor": "live-update-verification", "title": "Live-update verification", "level": 2 }, { "id": "agent-scope-and-acceptance", "anchor": "agent-scope-and-acceptance", "title": "Agent scope and acceptance", "level": 2 }, { "id": "handoff-contract", "anchor": "handoff-contract", "title": "Handoff contract", "level": 2 } ], "links": [ { "id": "reaktor-surface-dynamic-ui-and-verification", "anchor": "", "relation": "references", "sourceAnchor": "complete-client-journeys" }, { "id": "reaktor-component-lifecycle", "anchor": "", "relation": "references", "sourceAnchor": "complete-client-journeys" }, { "id": "operations-crashlytics", "anchor": "shadow-investigation", "relation": "references", "sourceAnchor": "complete-client-journeys" }, { "id": "operations-instance-diagnostics", "anchor": "", "relation": "references", "sourceAnchor": "complete-client-journeys" }, { "id": "reaktor-agent-workspace", "anchor": "", "relation": "references", "sourceAnchor": "agent-scope-and-acceptance" }, { "id": "reaktor-agentic-tooling", "anchor": "", "relation": "references", "sourceAnchor": "agent-scope-and-acceptance" }, { "id": "reaktor-conductor", "anchor": "", "relation": "references", "sourceAnchor": "agent-scope-and-acceptance" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "handoff-contract" } ] }, { "id": "shadow-design-history", "owner": "Reaktor / Codex", "kind": "prior", "summary": "Superseded merged Shadow design preserved for lineage; current semantics are defined by the textbook pages.", "use": "Read as dated historical source, not current behavior.", "region": "background-research", "order": 3, "title": "Shadow design history", "nav": "Shadow history", "group": "background", "subsection": "background-research", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-design-history", "revision": "79de5274ed6f123696838217ad05447c224ea2c437a7553e8633d755505d96bb", "status": "historical", "renderingRevision": "250acdeb296868e6c3724971304351452e976d4876e2cf2cbe1dc68fec1b8355", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://developers.cloudflare.com/workers/runtime-apis/performance/", "https://developers.cloudflare.com/logs/reference/log-fields/account/workers_trace_events/", "https://github.com/cloudflare/workerd/issues/2065", "https://developers.cloudflare.com/durable-objects/best-practices/rules-of-durable-objects/", "https://keploy.io/docs/concepts/what-is-keploy/", "https://keploy.io/docs/running-keploy/k8s-proxy-api/", "https://keploy.io/docs/keploy-cloud/kubernetes/", "https://developers.cloudflare.com/r2/get-started/s3/", "https://github.com/buger/goreplay", "https://mirrord.dev/docs/overview/introduction/", "https://www.replay.io/", "https://supabase.com/docs/guides/platform/branching", "https://neon.tech/docs/introduction/branching", "https://memgraph.com/docs/data-migration/dump-load", "https://supabase.com/docs/guides/database/replication", "https://developers.cloudflare.com/r2/buckets/event-notifications/", "https://k6.io/docs/", "https://developers.cloudflare.com/workers/observability/logs/tail-workers/", "https://github.com/cloudflare/workerd", "https://developers.cloudflare.com/workers/testing/miniflare/", "https://developers.cloudflare.com/workers/runtime-apis/nodejs/asynclocalstorage/", "https://developers.cloudflare.com/durable-objects/api/sqlite-storage-api/", "https://developers.cloudflare.com/workers/observability/dev-tools/", "https://blog.cloudflare.com/profiling-your-workers-with-wrangler/", "https://developers.cloudflare.com/workers/configuration/versions-and-deployments/version-overrides/", "https://github.com/karatelabs/karate", "https://github.com/karatelabs/karate/tree/master/karate-gatling", "https://playwright.dev/", "https://maestro.mobile.dev/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-design-history", "polarity": "Neutral" }, { "id": "section-mvp", "anchor": "mvp", "label": "0. MVP Dev Environment — build this first", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp", "polarity": "Neutral" }, { "id": "section-summary", "anchor": "summary", "label": "1. Executive summary", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#summary", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "2. Current state", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#current", "polarity": "Neutral" }, { "id": "section-why", "anchor": "why", "label": "3. Why a moving shadow", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#why", "polarity": "Neutral" }, { "id": "section-spec", "anchor": "spec", "label": "4. Spec alignment", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#spec", "polarity": "Neutral" }, { "id": "section-inspiration", "anchor": "inspiration", "label": "5. Prior art", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#inspiration", "polarity": "Neutral" }, { "id": "section-mvp-current", "anchor": "mvp-current", "label": "0.1 Production-backed development", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp-current", "polarity": "Neutral" }, { "id": "section-mvp-phase0", "anchor": "mvp-phase0", "label": "0.2 Phase 0 — three quick wins (independent; do immediately)", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp-phase0", "polarity": "Neutral" }, { "id": "section-mvp-spine", "anchor": "mvp-spine", "label": "0.3 The spine — one Environment, resolved at each composition root", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp-spine", "polarity": "Neutral" }, { "id": "section-mvp-build", "anchor": "mvp-build", "label": "0.4 Build it — four moves", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp-build", "polarity": "Neutral" }, { "id": "section-mvp-deploy", "anchor": "mvp-deploy", "label": "0.5 Deploy — dev vs prod", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp-deploy", "polarity": "Neutral" }, { "id": "section-mvp-checklist", "anchor": "mvp-checklist", "label": "0.6 MVP checklist (ordered)", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp-checklist", "polarity": "Neutral" }, { "id": "section-mvp-to-shadow", "anchor": "mvp-to-shadow", "label": "0.7 How the MVP grows into the shadow (§1+)", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#mvp-to-shadow", "polarity": "Neutral" }, { "id": "section-current-keploy", "anchor": "current-keploy", "label": "2.3 First implemented slice: Keploy + R2 for reaktorServer", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#current-keploy", "polarity": "Neutral" }, { "id": "section-current-edge", "anchor": "current-edge", "label": "2.4 Second slice: the edge gap (this design)", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#current-edge", "polarity": "Neutral" }, { "id": "section-surfaces", "anchor": "surfaces", "label": "7. Stateful surfaces to shadow", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#surfaces", "polarity": "Neutral" }, { "id": "section-environments", "anchor": "environments", "label": "8. Environment classes", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#environments", "polarity": "Neutral" }, { "id": "section-sideeffects", "anchor": "sideeffects", "label": "9. Side-effect classification", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#sideeffects", "polarity": "Neutral" }, { "id": "section-arch", "anchor": "arch", "label": "10. Stack diagram", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#arch", "polarity": "Neutral" }, { "id": "section-capture", "anchor": "capture", "label": "11. Capture plane", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture", "polarity": "Neutral" }, { "id": "section-capture-edge", "anchor": "capture-edge", "label": "11.4 Edge capture: the Cloudflare Workers proxy (Keploy-equivalent)", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture-edge", "polarity": "Neutral" }, { "id": "section-capture-edge-middleware", "anchor": "capture-edge-middleware", "label": "11.5 In-isolate middleware = the recorder", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture-edge-middleware", "polarity": "Neutral" }, { "id": "section-capture-edge-deep", "anchor": "capture-edge-deep", "label": "11.6 Going lower: the complete edge capture surface", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture-edge-deep", "polarity": "Neutral" }, { "id": "section-capture-edge-boundary", "anchor": "capture-edge-boundary", "label": "The determinism boundary — why \"everything\" is finite", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture-edge-boundary", "polarity": "Neutral" }, { "id": "section-capture-edge-layers", "anchor": "capture-edge-layers", "label": "The five capture layers", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture-edge-layers", "polarity": "Neutral" }, { "id": "section-capture-edge-ceiling", "anchor": "capture-edge-ceiling", "label": "The honest ceiling — and why it costs profiling, never replay", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture-edge-ceiling", "polarity": "Neutral" }, { "id": "section-capture-edge-cost", "anchor": "capture-edge-cost", "label": "Cost tiers — full capture isn't free", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capture-edge-cost", "polarity": "Neutral" }, { "id": "section-envelope", "anchor": "envelope", "label": "12. Shadow envelope", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#envelope", "polarity": "Neutral" }, { "id": "section-data", "anchor": "data", "label": "13. Data plane & materializers", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#data", "polarity": "Neutral" }, { "id": "section-capsules", "anchor": "capsules", "label": "14. Shadow capsules", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#capsules", "polarity": "Neutral" }, { "id": "section-window", "anchor": "window", "label": "15. The 7-day window + pinned fixtures", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#window", "polarity": "Neutral" }, { "id": "section-materialization", "anchor": "materialization", "label": "16. Materialization workflow", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#materialization", "polarity": "Neutral" }, { "id": "section-replay", "anchor": "replay", "label": "17. Replay engine", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#replay", "polarity": "Neutral" }, { "id": "section-replay-keploy-r2", "anchor": "replay-keploy-r2", "label": "17.3 Current Keploy/R2 adapter", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#replay-keploy-r2", "polarity": "Neutral" }, { "id": "section-replay-edge", "anchor": "replay-edge", "label": "17.4 Edge replay in workerd (the Keploy-equivalent run)", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#replay-edge", "polarity": "Neutral" }, { "id": "section-stack", "anchor": "stack", "label": "17.5 The complete testing stack", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#stack", "polarity": "Neutral" }, { "id": "section-replay-frontier", "anchor": "replay-frontier", "label": "17.6 The replay frontier — how far this goes", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#replay-frontier", "polarity": "Neutral" }, { "id": "section-frontier-omniscient", "anchor": "frontier-omniscient", "label": "1 · Omniscient replay — debug below the I/O floor", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-omniscient", "polarity": "Neutral" }, { "id": "section-frontier-differential", "anchor": "frontier-differential", "label": "2 · Differential replay — version × version, local × edge, runtime × runtime", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-differential", "polarity": "Neutral" }, { "id": "section-frontier-shadow", "anchor": "frontier-shadow", "label": "3 · Live shadow execution — diff before you promote", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-shadow", "polarity": "Neutral" }, { "id": "section-frontier-fuzz", "anchor": "frontier-fuzz", "label": "4 · Beyond regression — fuzzing & fault injection from real captures", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-fuzz", "polarity": "Neutral" }, { "id": "section-frontier-distributed", "anchor": "frontier-distributed", "label": "5 · Distributed super-capture — replay the transaction, not one hop", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-distributed", "polarity": "Neutral" }, { "id": "section-frontier-do", "anchor": "frontier-do", "label": "6 · Stateful replay — Durable Objects to the bit", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-do", "polarity": "Neutral" }, { "id": "section-frontier-corpus", "anchor": "frontier-corpus", "label": "7 · The self-curating corpus — production is the test suite", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-corpus", "polarity": "Neutral" }, { "id": "section-frontier-privacy", "anchor": "frontier-privacy", "label": "8 · Capture without seeing — the privacy frontier", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#frontier-privacy", "polarity": "Neutral" }, { "id": "section-comparison", "anchor": "comparison", "label": "18. Response comparison policy", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#comparison", "polarity": "Neutral" }, { "id": "section-stubs", "anchor": "stubs", "label": "19. Stubbing dangerous side effects", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#stubs", "polarity": "Neutral" }, { "id": "section-anomaly", "anchor": "anomaly", "label": "20. Anomaly detection & auto-pinning", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#anomaly", "polarity": "Neutral" }, { "id": "section-privacy", "anchor": "privacy", "label": "21. Privacy & redaction contract", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#privacy", "polarity": "Neutral" }, { "id": "section-access", "anchor": "access", "label": "22. Access model", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#access", "polarity": "Neutral" }, { "id": "section-tenant", "anchor": "tenant", "label": "23. Tenant isolation", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#tenant", "polarity": "Neutral" }, { "id": "section-timetravel", "anchor": "timetravel", "label": "24. Time travel", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#timetravel", "polarity": "Neutral" }, { "id": "section-load", "anchor": "load", "label": "25. Load testing from real patterns", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#load", "polarity": "Neutral" }, { "id": "section-observability", "anchor": "observability", "label": "26. Observability", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#observability", "polarity": "Neutral" }, { "id": "section-cli", "anchor": "cli", "label": "27. CLI verbs", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#cli", "polarity": "Neutral" }, { "id": "section-workbench", "anchor": "workbench", "label": "28. Workbench integration", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#workbench", "polarity": "Neutral" }, { "id": "section-ci", "anchor": "ci", "label": "29. CI integration", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#ci", "polarity": "Neutral" }, { "id": "section-bestbuds", "anchor": "bestbuds", "label": "30. BestBuds wiring", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#bestbuds", "polarity": "Neutral" }, { "id": "section-risks", "anchor": "risks", "label": "32. Risks & open questions", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#risks", "polarity": "Neutral" }, { "id": "section-references", "anchor": "references", "label": "33. References", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#references", "polarity": "Neutral" }, { "id": "section-references-3", "anchor": "references-3", "label": "Peer designs in this repo", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#references-3", "polarity": "Neutral" }, { "id": "section-related-docs", "anchor": "related-docs", "label": "Related docs", "profile": "section", "contract": "https://reaktor.build/docs/shadow-design-history#related-docs", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-design-history:references-operations", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "page", "role": "source", "ordinal": 0 }, { "node": "operations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-shadow-dev-environment", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-performance-observability", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-observability", "role": "source", "ordinal": 0 }, { "node": "performance-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-reaktor-notifications-design", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "reaktor-notifications-design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-deep-link-integration", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "deep-link-integration", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-auth-analysis", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "auth-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-security-plan", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "security-plan", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-graph-kernel-analysis", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "graph-kernel-analysis", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-reaktor_graph_visitors_design", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "reaktor_graph_visitors_design", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-claude-dev-environment", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "claude-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-codex-dev-environment", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-references-3", "role": "source", "ordinal": 0 }, { "node": "codex-dev-environment", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-reaktor-devops", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "reaktor-devops", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-design-history:references-secrets-management", "kind": "references", "owner": "shadow-design-history", "incidences": [ { "node": "shadow-design-history", "port": "section-related-docs", "role": "source", "ordinal": 0 }, { "node": "secrets-management", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-design-history.json", "sections": [ { "id": "preamble", "anchor": "", "title": "Shadow design history", "level": 0 }, { "id": "mvp", "anchor": "mvp", "title": "0. MVP Dev Environment — build this first", "level": 2 }, { "id": "mvp-current", "anchor": "mvp-current", "title": "0.1 Production-backed development", "level": 3 }, { "id": "mvp-phase0", "anchor": "mvp-phase0", "title": "0.2 Phase 0 — three quick wins (independent; do immediately)", "level": 3 }, { "id": "mvp-spine", "anchor": "mvp-spine", "title": "0.3 The spine — one Environment, resolved at each composition root", "level": 3 }, { "id": "mvp-build", "anchor": "mvp-build", "title": "0.4 Build it — four moves", "level": 3 }, { "id": "mvp-deploy", "anchor": "mvp-deploy", "title": "0.5 Deploy — dev vs prod", "level": 3 }, { "id": "mvp-checklist", "anchor": "mvp-checklist", "title": "0.6 MVP checklist (ordered)", "level": 3 }, { "id": "mvp-to-shadow", "anchor": "mvp-to-shadow", "title": "0.7 How the MVP grows into the shadow (§1+)", "level": 3 }, { "id": "summary", "anchor": "summary", "title": "1. Executive summary", "level": 2 }, { "id": "current", "anchor": "current", "title": "2. Current state", "level": 2 }, { "id": "current-2", "anchor": "current-2", "title": "2.1 What dev/test infrastructure exists today", "level": 3 }, { "id": "current-3", "anchor": "current-3", "title": "2.2 The honest gap", "level": 3 }, { "id": "current-keploy", "anchor": "current-keploy", "title": "2.3 First implemented slice: Keploy + R2 for reaktorServer", "level": 3 }, { "id": "current-edge", "anchor": "current-edge", "title": "2.4 Second slice: the edge gap (this design)", "level": 3 }, { "id": "why", "anchor": "why", "title": "3. Why a moving shadow", "level": 2 }, { "id": "bugs-live-in-production-shapes", "anchor": "bugs-live-in-production-shapes", "title": "Bugs live in production shapes", "level": 4 }, { "id": "load-tests-need-realistic-mix", "anchor": "load-tests-need-realistic-mix", "title": "Load tests need realistic mix", "level": 4 }, { "id": "edge-cases-need-permanence", "anchor": "edge-cases-need-permanence", "title": "Edge cases need permanence", "level": 4 }, { "id": "side-effects-need-a-sandbox", "anchor": "side-effects-need-a-sandbox", "title": "Side effects need a sandbox", "level": 4 }, { "id": "privacy-by-construction", "anchor": "privacy-by-construction", "title": "Privacy by construction", "level": 4 }, { "id": "replay-closes-the-regression-loop", "anchor": "replay-closes-the-regression-loop", "title": "Replay closes the regression loop", "level": 4 }, { "id": "spec", "anchor": "spec", "title": "4. Spec alignment", "level": 2 }, { "id": "inspiration", "anchor": "inspiration", "title": "5. Prior art", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "6. Principles", "level": 2 }, { "id": "1--capture-is-a-visitor-not-a-proxy", "anchor": "1--capture-is-a-visitor-not-a-proxy", "title": "1 · Capture is a visitor, not a proxy", "level": 4 }, { "id": "2--the-shadow-is-dev", "anchor": "2--the-shadow-is-dev", "title": "2 · The shadow IS dev", "level": 4 }, { "id": "3--moving-by-default-pinned-by-exception", "anchor": "3--moving-by-default-pinned-by-exception", "title": "3 · Moving by default, pinned by exception", "level": 4 }, { "id": "4--base--overlay-everywhere", "anchor": "4--base--overlay-everywhere", "title": "4 · Base + overlay everywhere", "level": 4 }, { "id": "5--side-effects-fail-loudly-in-shadow", "anchor": "5--side-effects-fail-loudly-in-shadow", "title": "5 · Side effects fail loudly in shadow", "level": 4 }, { "id": "6--redaction-is-fail-closed-at-capture", "anchor": "6--redaction-is-fail-closed-at-capture", "title": "6 · Redaction is fail-closed at capture", "level": 4 }, { "id": "7--replay-must-be-deterministic", "anchor": "7--replay-must-be-deterministic", "title": "7 · Replay must be deterministic", "level": 4 }, { "id": "8--production-shaped-not-production-identical", "anchor": "8--production-shaped-not-production-identical", "title": "8 · Production-shaped, not production-identical", "level": 4 }, { "id": "surfaces", "anchor": "surfaces", "title": "7. Stateful surfaces to shadow", "level": 2 }, { "id": "environments", "anchor": "environments", "title": "8. Environment classes", "level": 2 }, { "id": "environments-2", "anchor": "environments-2", "title": "8.1 Base + overlay layout per resource", "level": 3 }, { "id": "sideeffects", "anchor": "sideeffects", "title": "9. Side-effect classification", "level": 2 }, { "id": "arch", "anchor": "arch", "title": "10. Stack diagram", "level": 2 }, { "id": "capture", "anchor": "capture", "title": "11. Capture plane", "level": 2 }, { "id": "capture-2", "anchor": "capture-2", "title": "11.1 The visitor", "level": 3 }, { "id": "capture-3", "anchor": "capture-3", "title": "11.2 Capture adapters per surface", "level": 3 }, { "id": "capture-4", "anchor": "capture-4", "title": "11.3 Sampling", "level": 3 }, { "id": "capture-edge", "anchor": "capture-edge", "title": "11.4 Edge capture: the Cloudflare Workers proxy (Keploy-equivalent)", "level": 3 }, { "id": "capture-edge-middleware", "anchor": "capture-edge-middleware", "title": "11.5 In-isolate middleware = the recorder", "level": 3 }, { "id": "capture-edge-deep", "anchor": "capture-edge-deep", "title": "11.6 Going lower: the complete edge capture surface", "level": 3 }, { "id": "capture-edge-boundary", "anchor": "capture-edge-boundary", "title": "The determinism boundary — why \"everything\" is finite", "level": 4 }, { "id": "capture-edge-layers", "anchor": "capture-edge-layers", "title": "The five capture layers", "level": 4 }, { "id": "capture-edge-ceiling", "anchor": "capture-edge-ceiling", "title": "The honest ceiling — and why it costs profiling, never replay", "level": 4 }, { "id": "capture-edge-cost", "anchor": "capture-edge-cost", "title": "Cost tiers — full capture isn't free", "level": 4 }, { "id": "envelope", "anchor": "envelope", "title": "12. Shadow envelope", "level": 2 }, { "id": "data", "anchor": "data", "title": "13. Data plane & materializers", "level": 2 }, { "id": "data-2", "anchor": "data-2", "title": "13.1 Read-through R2 binding (illustrative)", "level": 3 }, { "id": "capsules", "anchor": "capsules", "title": "14. Shadow capsules", "level": 2 }, { "id": "capsules-2", "anchor": "capsules-2", "title": "14.1 Capsule classes", "level": 3 }, { "id": "capsules-3", "anchor": "capsules-3", "title": "14.2 Pinning rules", "level": 3 }, { "id": "capsules-4", "anchor": "capsules-4", "title": "14.3 Pin budget", "level": 3 }, { "id": "window", "anchor": "window", "title": "15. The 7-day window + pinned fixtures", "level": 2 }, { "id": "window-2", "anchor": "window-2", "title": "15.1 Storage maths", "level": 3 }, { "id": "materialization", "anchor": "materialization", "title": "16. Materialization workflow", "level": 2 }, { "id": "replay", "anchor": "replay", "title": "17. Replay engine", "level": 2 }, { "id": "replay-2", "anchor": "replay-2", "title": "17.1 Runners", "level": 3 }, { "id": "replay-3", "anchor": "replay-3", "title": "17.2 What gets replayed", "level": 3 }, { "id": "replay-keploy-r2", "anchor": "replay-keploy-r2", "title": "17.3 Current Keploy/R2 adapter", "level": 3 }, { "id": "replay-edge", "anchor": "replay-edge", "title": "17.4 Edge replay in workerd (the Keploy-equivalent run)", "level": 3 }, { "id": "stack", "anchor": "stack", "title": "17.5 The complete testing stack", "level": 3 }, { "id": "replay-frontier", "anchor": "replay-frontier", "title": "17.6 The replay frontier — how far this goes", "level": 3 }, { "id": "frontier-omniscient", "anchor": "frontier-omniscient", "title": "1 · Omniscient replay — debug below the I/O floor", "level": 4 }, { "id": "frontier-differential", "anchor": "frontier-differential", "title": "2 · Differential replay — version × version, local × edge, runtime × runtime", "level": 4 }, { "id": "frontier-shadow", "anchor": "frontier-shadow", "title": "3 · Live shadow execution — diff before you promote", "level": 4 }, { "id": "frontier-fuzz", "anchor": "frontier-fuzz", "title": "4 · Beyond regression — fuzzing & fault injection from real captures", "level": 4 }, { "id": "frontier-distributed", "anchor": "frontier-distributed", "title": "5 · Distributed super-capture — replay the transaction, not one hop", "level": 4 }, { "id": "frontier-do", "anchor": "frontier-do", "title": "6 · Stateful replay — Durable Objects to the bit", "level": 4 }, { "id": "frontier-corpus", "anchor": "frontier-corpus", "title": "7 · The self-curating corpus — production is the test suite", "level": 4 }, { "id": "frontier-privacy", "anchor": "frontier-privacy", "title": "8 · Capture without seeing — the privacy frontier", "level": 4 }, { "id": "comparison", "anchor": "comparison", "title": "18. Response comparison policy", "level": 2 }, { "id": "stubs", "anchor": "stubs", "title": "19. Stubbing dangerous side effects", "level": 2 }, { "id": "anomaly", "anchor": "anomaly", "title": "20. Anomaly detection & auto-pinning", "level": 2 }, { "id": "privacy", "anchor": "privacy", "title": "21. Privacy & redaction contract", "level": 2 }, { "id": "privacy-2", "anchor": "privacy-2", "title": "21.1 Per-data-class handling", "level": 3 }, { "id": "privacy-3", "anchor": "privacy-3", "title": "21.2 Deterministic faker key", "level": 3 }, { "id": "privacy-4", "anchor": "privacy-4", "title": "21.3 Auditing", "level": 3 }, { "id": "access", "anchor": "access", "title": "22. Access model", "level": 2 }, { "id": "tenant", "anchor": "tenant", "title": "23. Tenant isolation", "level": 2 }, { "id": "timetravel", "anchor": "timetravel", "title": "24. Time travel", "level": 2 }, { "id": "load", "anchor": "load", "title": "25. Load testing from real patterns", "level": 2 }, { "id": "observability", "anchor": "observability", "title": "26. Observability", "level": 2 }, { "id": "cli", "anchor": "cli", "title": "27. CLI verbs", "level": 2 }, { "id": "workbench", "anchor": "workbench", "title": "28. Workbench integration", "level": 2 }, { "id": "ci", "anchor": "ci", "title": "29. CI integration", "level": 2 }, { "id": "replay-pinned-regression-suite", "anchor": "replay-pinned-regression-suite", "title": "Replay pinned regression suite", "level": 4 }, { "id": "replay-yesterdays-traffic-sample", "anchor": "replay-yesterdays-traffic-sample", "title": "Replay yesterday's traffic sample", "level": 4 }, { "id": "load-test-from-last-weeks-patterns", "anchor": "load-test-from-last-weeks-patterns", "title": "Load test from last week's patterns", "level": 4 }, { "id": "bestbuds", "anchor": "bestbuds", "title": "30. BestBuds wiring", "level": 2 }, { "id": "bestbuds-2", "anchor": "bestbuds-2", "title": "30.1 First slice: chatServer", "level": 3 }, { "id": "plan", "anchor": "plan", "title": "31. Phased plan", "level": 2 }, { "id": "keploy--r2-http-adapter", "anchor": "keploy--r2-http-adapter", "title": "Keploy + R2 HTTP adapter", "level": 4 }, { "id": "policy--schemas", "anchor": "policy--schemas", "title": "Policy & schemas", "level": 4 }, { "id": "service-capture", "anchor": "service-capture", "title": "Service capture", "level": 4 }, { "id": "shadow-lake--catalog", "anchor": "shadow-lake--catalog", "title": "Shadow lake + catalog", "level": 4 }, { "id": "data-materializers", "anchor": "data-materializers", "title": "Data materializers", "level": 4 }, { "id": "replay-runners", "anchor": "replay-runners", "title": "Replay runners", "level": 4 }, { "id": "anomaly-detector--pin-queue", "anchor": "anomaly-detector--pin-queue", "title": "Anomaly detector + pin queue", "level": 4 }, { "id": "roll-capture-to-all-10-workers", "anchor": "roll-capture-to-all-10-workers", "title": "Roll capture to all 10 workers", "level": 4 }, { "id": "dev--ci-integration", "anchor": "dev--ci-integration", "title": "Dev + CI integration", "level": 4 }, { "id": "load-test--time-travel--per-branch-forks", "anchor": "load-test--time-travel--per-branch-forks", "title": "Load test + time travel + per-branch forks", "level": 4 }, { "id": "risks", "anchor": "risks", "title": "32. Risks & open questions", "level": 2 }, { "id": "risks-2", "anchor": "risks-2", "title": "Risks", "level": 4 }, { "id": "risks-3", "anchor": "risks-3", "title": "Open decisions", "level": 4 }, { "id": "references", "anchor": "references", "title": "33. References", "level": 2 }, { "id": "references-2", "anchor": "references-2", "title": "Spec sections this design extends", "level": 4 }, { "id": "references-3", "anchor": "references-3", "title": "Peer designs in this repo", "level": 4 }, { "id": "references-4", "anchor": "references-4", "title": "Files inventoried during the design", "level": 4 }, { "id": "references-5", "anchor": "references-5", "title": "External tools cited", "level": 4 }, { "id": "related-docs", "anchor": "related-docs", "title": "Related docs", "level": 2 } ], "links": [ { "id": "operations", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-design-history", "anchor": "mvp", "relation": "references", "sourceAnchor": "" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "observability" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor-notifications-design", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "deep-link-integration", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "auth-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "graph-kernel-analysis", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "reaktor_graph_visitors_design", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "claude-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "codex-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "references-3" }, { "id": "performance-observability", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "reaktor-devops", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "secrets-management", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "security-plan", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "claude-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" }, { "id": "codex-dev-environment", "anchor": "", "relation": "references", "sourceAnchor": "related-docs" } ] }, { "id": "shadow-dev-environment", "owner": "Merged", "kind": "testing", "summary": "The Shadow textbook entry point: moving sanitized bases, isolated pinned experiments, graph capture and paired verification.", "use": "Read the chapter map, current adapter limits and safe first vertical slice.", "region": "operations-shadow", "order": 0, "title": "Reaktor Shadow — Moving Development and Verification", "nav": "Reaktor Shadow", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-dev-environment", "revision": "c7df71bc5ba215c32873d15a8207274aac0c7121f2add14dd3c66cca24564862", "status": "unverified", "renderingRevision": "aea3a5e2ba69bd689bbf8a4604eee55a30703518f6e5696ff520405aafa55455", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [ "mvp-current", "mvp-phase0", "mvp-spine", "mvp-build", "mvp-deploy", "mvp-checklist", "mvp-to-shadow", "summary", "current-keploy", "current-edge", "why", "inspiration", "surfaces", "environments", "sideeffects", "arch", "capture", "capture-edge", "capture-edge-middleware", "capture-edge-deep", "capture-edge-boundary", "capture-edge-layers", "capture-edge-ceiling", "capture-edge-cost", "envelope", "data", "capsules", "window", "materialization", "replay", "replay-keploy-r2", "replay-edge", "stack", "replay-frontier", "frontier-omniscient", "frontier-differential", "frontier-shadow", "frontier-fuzz", "frontier-distributed", "frontier-do", "frontier-corpus", "frontier-privacy", "comparison", "stubs", "anomaly", "privacy", "access", "tenant", "timetravel", "load", "observability", "cli", "workbench", "ci", "bestbuds", "risks", "references" ], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-dev-environment", "polarity": "Neutral" }, { "id": "section-current", "anchor": "current", "label": "Current state", "profile": "section", "contract": "https://reaktor.build/docs/shadow-dev-environment#current", "polarity": "Neutral" }, { "id": "section-read-the-textbook-as-pages", "anchor": "read-the-textbook-as-pages", "label": "Read the textbook as pages", "profile": "section", "contract": "https://reaktor.build/docs/shadow-dev-environment#read-the-textbook-as-pages", "polarity": "Neutral" }, { "id": "section-mvp", "anchor": "mvp", "label": "Minimum safe development substrate", "profile": "section", "contract": "https://reaktor.build/docs/shadow-dev-environment#mvp", "polarity": "Neutral" }, { "id": "section-principles", "anchor": "principles", "label": "Corrections to the earlier direction", "profile": "section", "contract": "https://reaktor.build/docs/shadow-dev-environment#principles", "polarity": "Neutral" }, { "id": "section-plan", "anchor": "plan", "label": "First end-to-end gate", "profile": "section", "contract": "https://reaktor.build/docs/shadow-dev-environment#plan", "polarity": "Neutral" }, { "id": "section-spec", "anchor": "spec", "label": "Observability and graph integration", "profile": "section", "contract": "https://reaktor.build/docs/shadow-dev-environment#spec", "polarity": "Neutral" }, { "id": "section-earlier-section-links", "anchor": "earlier-section-links", "label": "Earlier section links", "profile": "section", "contract": "https://reaktor.build/docs/shadow-dev-environment#earlier-section-links", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-dev-environment:references-shadow-capture-fabric", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "page", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-fabric", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-backends", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-current", "role": "source", "ordinal": 0 }, { "node": "shadow-backends", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-operations-observability", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-current", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-foundations", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "shadow-foundations", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-workspaces", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-capture-replay", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-verification", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "shadow-verification", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-operations-load-resilience", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "operations-load-resilience", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-clients-agents", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-operations-delivery", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-operations-references", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-read-the-textbook-as-pages", "role": "source", "ordinal": 0 }, { "node": "operations-references", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-operations-graph-evidence", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-spec", "role": "source", "ordinal": 0 }, { "node": "operations-graph-evidence", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-spec", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-mvp-current", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-mvp-current", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-mvp-phase0", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-mvp-phase0", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-mvp-spine", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-mvp-spine", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-mvp-build", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-mvp-build", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-mvp-deploy", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-mvp-deploy", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-mvp-checklist", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-mvp-checklist", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-mvp-to-shadow", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-mvp-to-shadow", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-summary", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-summary", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-current-keploy", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-current-keploy", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-current-edge", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-current-edge", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-why", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-why", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-inspiration", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-inspiration", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-surfaces", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-surfaces", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-environments", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-environments", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-sideeffects", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-sideeffects", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-arch", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-arch", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture-edge", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture-edge", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture-edge-middleware", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture-edge-middleware", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture-edge-deep", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture-edge-deep", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture-edge-boundary", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture-edge-boundary", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture-edge-layers", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture-edge-layers", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture-edge-ceiling", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture-edge-ceiling", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capture-edge-cost", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capture-edge-cost", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-envelope", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-envelope", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-data", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-data", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-capsules", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-capsules", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-window", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-window", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-materialization", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-materialization", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-replay", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-replay", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-replay-keploy-r2", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-replay-keploy-r2", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-replay-edge", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-replay-edge", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-stack", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-stack", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-replay-frontier", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-replay-frontier", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-omniscient", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-omniscient", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-differential", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-differential", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-shadow", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-shadow", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-fuzz", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-fuzz", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-distributed", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-distributed", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-do", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-do", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-corpus", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-corpus", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-frontier-privacy", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-frontier-privacy", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-comparison", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-comparison", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-stubs", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-stubs", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-anomaly", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-anomaly", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-privacy", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-privacy", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-access", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-access", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-tenant", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-tenant", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-timetravel", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-timetravel", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-load", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-load", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-observability", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-observability", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-cli", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-cli", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-workbench", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-workbench", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-ci", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-ci", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-bestbuds", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-bestbuds", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-risks", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-risks", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-dev-environment:references-shadow-design-history-references", "kind": "references", "owner": "shadow-dev-environment", "incidences": [ { "node": "shadow-dev-environment", "port": "section-earlier-section-links", "role": "source", "ordinal": 0 }, { "node": "shadow-design-history", "port": "section-references", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-dev-environment.json", "sections": [ { "id": "reaktor-shadow", "anchor": "reaktor-shadow", "title": "Reaktor Shadow", "level": 1 }, { "id": "current", "anchor": "current", "title": "Current state", "level": 2 }, { "id": "read-the-textbook-as-pages", "anchor": "read-the-textbook-as-pages", "title": "Read the textbook as pages", "level": 2 }, { "id": "mvp", "anchor": "mvp", "title": "Minimum safe development substrate", "level": 2 }, { "id": "principles", "anchor": "principles", "title": "Corrections to the earlier direction", "level": 2 }, { "id": "plan", "anchor": "plan", "title": "First end-to-end gate", "level": 2 }, { "id": "spec", "anchor": "spec", "title": "Observability and graph integration", "level": 2 }, { "id": "earlier-section-links", "anchor": "earlier-section-links", "title": "Earlier section links", "level": 2 } ], "links": [ { "id": "shadow-capture-fabric", "anchor": "", "relation": "references", "sourceAnchor": "" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "current" }, { "id": "operations-observability", "anchor": "", "relation": "references", "sourceAnchor": "current" }, { "id": "shadow-foundations", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "shadow-backends", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "shadow-verification", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "operations-load-resilience", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "operations-references", "anchor": "", "relation": "references", "sourceAnchor": "read-the-textbook-as-pages" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "plan" }, { "id": "operations-graph-evidence", "anchor": "", "relation": "references", "sourceAnchor": "spec" }, { "id": "shadow-design-history", "anchor": "", "relation": "references", "sourceAnchor": "spec" }, { "id": "shadow-design-history", "anchor": "mvp-current", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "mvp-phase0", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "mvp-spine", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "mvp-build", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "mvp-deploy", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "mvp-checklist", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "mvp-to-shadow", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "summary", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "current-keploy", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "current-edge", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "why", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "inspiration", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "surfaces", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "environments", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "sideeffects", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "arch", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture-edge", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture-edge-middleware", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture-edge-deep", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture-edge-boundary", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture-edge-layers", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture-edge-ceiling", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capture-edge-cost", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "envelope", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "data", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "capsules", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "window", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "materialization", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "replay", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "replay-keploy-r2", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "replay-edge", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "stack", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "replay-frontier", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-omniscient", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-differential", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-shadow", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-fuzz", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-distributed", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-do", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-corpus", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "frontier-privacy", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "comparison", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "stubs", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "anomaly", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "privacy", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "access", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "tenant", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "timetravel", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "load", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "observability", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "cli", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "workbench", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "ci", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "bestbuds", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "risks", "relation": "references", "sourceAnchor": "earlier-section-links" }, { "id": "shadow-design-history", "anchor": "references", "relation": "references", "sourceAnchor": "earlier-section-links" } ] }, { "id": "shadow-foundations", "owner": "Reaktor / Codex", "kind": "architecture", "summary": "Textbook chapters 1–3: moving production counterpart, equivalent pre-state, admitted workloads and explicit effect cuts.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-shadow", "order": 1, "title": "Shadow Foundations — Moving State and Controlled Experiments", "nav": "Shadow foundations", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-foundations", "revision": "0beb1ca8597ac685c003f577b232b6f352e99b8a1fafbee08967b9098e1cbf99", "status": "unverified", "renderingRevision": "090a3fec0122b3d2862801cd1a82b066d51ee60693a2e8c308655bc626b0edb9", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-foundations", "polarity": "Neutral" }, { "id": "section-a-moving-production-counterpart", "anchor": "a-moving-production-counterpart", "label": "A moving production counterpart", "profile": "section", "contract": "https://reaktor.build/docs/shadow-foundations#a-moving-production-counterpart", "polarity": "Neutral" }, { "id": "section-what-an-experiment-fixes", "anchor": "what-an-experiment-fixes", "label": "What an experiment fixes", "profile": "section", "contract": "https://reaktor.build/docs/shadow-foundations#what-an-experiment-fixes", "polarity": "Neutral" }, { "id": "section-three-execution-profiles", "anchor": "three-execution-profiles", "label": "Three execution profiles", "profile": "section", "contract": "https://reaktor.build/docs/shadow-foundations#three-execution-profiles", "polarity": "Neutral" }, { "id": "section-the-execution-cut", "anchor": "the-execution-cut", "label": "The execution cut", "profile": "section", "contract": "https://reaktor.build/docs/shadow-foundations#the-execution-cut", "polarity": "Neutral" }, { "id": "section-reader-check", "anchor": "reader-check", "label": "Reader check", "profile": "section", "contract": "https://reaktor.build/docs/shadow-foundations#reader-check", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-foundations:references-shadow-workspaces", "kind": "references", "owner": "shadow-foundations", "incidences": [ { "node": "shadow-foundations", "port": "section-the-execution-cut", "role": "source", "ordinal": 0 }, { "node": "shadow-workspaces", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-foundations:references-shadow-capture-replay", "kind": "references", "owner": "shadow-foundations", "incidences": [ { "node": "shadow-foundations", "port": "section-the-execution-cut", "role": "source", "ordinal": 0 }, { "node": "shadow-capture-replay", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-foundations.json", "sections": [ { "id": "shadow-foundations", "anchor": "shadow-foundations", "title": "Shadow Foundations", "level": 1 }, { "id": "a-moving-production-counterpart", "anchor": "a-moving-production-counterpart", "title": "A moving production counterpart", "level": 2 }, { "id": "what-an-experiment-fixes", "anchor": "what-an-experiment-fixes", "title": "What an experiment fixes", "level": 2 }, { "id": "three-execution-profiles", "anchor": "three-execution-profiles", "title": "Three execution profiles", "level": 2 }, { "id": "the-execution-cut", "anchor": "the-execution-cut", "title": "The execution cut", "level": 2 }, { "id": "reader-check", "anchor": "reader-check", "title": "Reader check", "level": 2 } ], "links": [ { "id": "shadow-workspaces", "anchor": "", "relation": "references", "sourceAnchor": "the-execution-cut" }, { "id": "shadow-capture-replay", "anchor": "", "relation": "references", "sourceAnchor": "the-execution-cut" } ] }, { "id": "shadow-verification", "owner": "Reaktor / Codex", "kind": "testing", "summary": "Textbook chapters 12 and 14: fixed assertions, privacy, send/retry/reconnect, anomaly minimization and reproducible capsules.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-shadow", "order": 6, "title": "Shadow Assertions, Privacy and Failure Capsules", "nav": "Verification & capsules", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-verification", "revision": "35174f8a41a04c9c5ca00ca3ed5e5910128721f8f1803e4b69350fae6c6e2f45", "status": "unverified", "renderingRevision": "1361dfa8c4a21d7466e15b6879673018229d52972d9086969e6b72f304e26c46", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://schemathesis.readthedocs.io/en/stable/", "https://www.zaproxy.org/docs/automate/automation-framework/" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-verification", "polarity": "Neutral" }, { "id": "section-three-checks", "anchor": "three-checks", "label": "Three checks", "profile": "section", "contract": "https://reaktor.build/docs/shadow-verification#three-checks", "polarity": "Neutral" }, { "id": "section-privacy-and-effect-safety", "anchor": "privacy-and-effect-safety", "label": "Privacy and effect safety", "profile": "section", "contract": "https://reaktor.build/docs/shadow-verification#privacy-and-effect-safety", "polarity": "Neutral" }, { "id": "section-send-retry-reconnect", "anchor": "send-retry-reconnect", "label": "Send, retry and reconnect", "profile": "section", "contract": "https://reaktor.build/docs/shadow-verification#send-retry-reconnect", "polarity": "Neutral" }, { "id": "section-from-anomaly-to-regression-case", "anchor": "from-anomaly-to-regression-case", "label": "From anomaly to regression case", "profile": "section", "contract": "https://reaktor.build/docs/shadow-verification#from-anomaly-to-regression-case", "polarity": "Neutral" }, { "id": "section-results-and-evidence", "anchor": "results-and-evidence", "label": "Results and evidence", "profile": "section", "contract": "https://reaktor.build/docs/shadow-verification#results-and-evidence", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-verification:references-operations-observability-the-paired-observation", "kind": "references", "owner": "shadow-verification", "incidences": [ { "node": "shadow-verification", "port": "section-send-retry-reconnect", "role": "source", "ordinal": 0 }, { "node": "operations-observability", "port": "section-the-paired-observation", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-verification:references-operations-delivery", "kind": "references", "owner": "shadow-verification", "incidences": [ { "node": "shadow-verification", "port": "section-results-and-evidence", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] }, { "id": "shadow-verification:references-shadow-clients-agents", "kind": "references", "owner": "shadow-verification", "incidences": [ { "node": "shadow-verification", "port": "section-results-and-evidence", "role": "source", "ordinal": 0 }, { "node": "shadow-clients-agents", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-verification.json", "sections": [ { "id": "shadow-verification-and-failure-capsules", "anchor": "shadow-verification-and-failure-capsules", "title": "Shadow Verification and Failure Capsules", "level": 1 }, { "id": "three-checks", "anchor": "three-checks", "title": "Three checks", "level": 2 }, { "id": "privacy-and-effect-safety", "anchor": "privacy-and-effect-safety", "title": "Privacy and effect safety", "level": 2 }, { "id": "send-retry-reconnect", "anchor": "send-retry-reconnect", "title": "Send, retry and reconnect", "level": 2 }, { "id": "from-anomaly-to-regression-case", "anchor": "from-anomaly-to-regression-case", "title": "From anomaly to regression case", "level": 2 }, { "id": "results-and-evidence", "anchor": "results-and-evidence", "title": "Results and evidence", "level": 2 } ], "links": [ { "id": "operations-observability", "anchor": "the-paired-observation", "relation": "references", "sourceAnchor": "send-retry-reconnect" }, { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "results-and-evidence" }, { "id": "shadow-clients-agents", "anchor": "", "relation": "references", "sourceAnchor": "results-and-evidence" } ] }, { "id": "shadow-workspaces", "owner": "Reaktor / Codex", "kind": "architecture", "summary": "Textbook chapters 4–6: plans/manifests, snapshot/CDC publication, leases and truthful isolation per resource.", "use": "Use through the Operations & Reliability reading map; distinguish implementation, design and qualification.", "region": "operations-shadow", "order": 2, "title": "Shadow Workspaces, Base Publication and Resource Isolation", "nav": "Shadow workspaces", "group": "operations", "subsection": "operations-shadow", "visibility": "public", "schemaVersion": 1, "url": "https://reaktor.build/docs/shadow-workspaces", "revision": "f77e97bdda470793362758f4ad7faa974b9c11c790b96ca45e044263afbd8d37", "status": "unverified", "renderingRevision": "5cd5596d802fd0ac253ca95550a12b71543f98ab592c3934f43a016a8e32c191", "verification": { "at": null, "revision": null, "evidence": [] }, "sources": [], "anchors": [], "externalLinks": [ "https://www.postgresql.org/docs/18/logical-replication-restrictions.html", "https://www.postgresql.org/docs/18/logicaldecoding-explanation.html" ], "graph": { "ports": [ { "id": "page", "anchor": "", "label": "Document", "profile": "document", "contract": "https://reaktor.build/docs/shadow-workspaces", "polarity": "Neutral" }, { "id": "section-proposed-contracts", "anchor": "proposed-contracts", "label": "Proposed contracts", "profile": "section", "contract": "https://reaktor.build/docs/shadow-workspaces#proposed-contracts", "polarity": "Neutral" }, { "id": "section-workspace-lifecycle", "anchor": "workspace-lifecycle", "label": "Workspace lifecycle", "profile": "section", "contract": "https://reaktor.build/docs/shadow-workspaces#workspace-lifecycle", "polarity": "Neutral" }, { "id": "section-publish-a-base-safely", "anchor": "publish-a-base-safely", "label": "Publish a base safely", "profile": "section", "contract": "https://reaktor.build/docs/shadow-workspaces#publish-a-base-safely", "polarity": "Neutral" }, { "id": "section-per-resource-isolation", "anchor": "per-resource-isolation", "label": "Per-resource isolation", "profile": "section", "contract": "https://reaktor.build/docs/shadow-workspaces#per-resource-isolation", "polarity": "Neutral" }, { "id": "section-operating-acceptance", "anchor": "operating-acceptance", "label": "Operating acceptance", "profile": "section", "contract": "https://reaktor.build/docs/shadow-workspaces#operating-acceptance", "polarity": "Neutral" } ], "relations": [ { "id": "shadow-workspaces:references-operations-delivery", "kind": "references", "owner": "shadow-workspaces", "incidences": [ { "node": "shadow-workspaces", "port": "section-operating-acceptance", "role": "source", "ordinal": 0 }, { "node": "operations-delivery", "port": "page", "role": "target", "ordinal": 0 } ] } ] }, "content": "shadow-workspaces.json", "sections": [ { "id": "shadow-workspaces-and-materialization", "anchor": "shadow-workspaces-and-materialization", "title": "Shadow Workspaces and Materialization", "level": 1 }, { "id": "proposed-contracts", "anchor": "proposed-contracts", "title": "Proposed contracts", "level": 2 }, { "id": "workspace-lifecycle", "anchor": "workspace-lifecycle", "title": "Workspace lifecycle", "level": 2 }, { "id": "publish-a-base-safely", "anchor": "publish-a-base-safely", "title": "Publish a base safely", "level": 2 }, { "id": "per-resource-isolation", "anchor": "per-resource-isolation", "title": "Per-resource isolation", "level": 2 }, { "id": "operating-acceptance", "anchor": "operating-acceptance", "title": "Operating acceptance", "level": 2 } ], "links": [ { "id": "operations-delivery", "anchor": "", "relation": "references", "sourceAnchor": "operating-acceptance" } ] } ] }