BOOK v0.2 CONTRACTS v0.1.0 PROFILE-JWM v0.8 SNAPSHOT 2026-08-01 Decision records

AI-Driven. Physics-Based. Trusted.
A living reference architecture.

When AI and physics simulation carry real consequences, capability is not enough; trust is the missing architecture. jBOK is the organization-neutral blueprint for earning, establishing, and keeping it through contracts, evidence, and accountable evolution — built on one conviction: make trust verifiable.

§1

Why it exists

High-consequence decisions increasingly run through AI models and physics simulation. What's missing isn't capability — it's an architecture of trust: shared contracts that let independent organizations build interoperable capabilities, prove claims with evidence, and replace any component without unwinding the whole. Trust here has a lifecycle: earned through evidence, established by accountable accreditation, kept through monitoring and re-review — and revocable. jBOK is that architecture, kept deliberately free of every vendor, product, and use case so it can serve all of them.

§2

The structure

Trusted Decision EcosystemsTHE PUBLIC NARRATIVE
AI-DrivenAgents and learned models as first-class, contract-bounded participants
Physics-BasedGoverning equations and simulation as the grounding of claims about the world
TrustedVerification, validation, and uncertainty quantification (VVUQ), accreditation by identified authority, evidence packages, human authority boundaries
Computational & Mathematical FoundationsApplied math · numerical methods · optimization · UQ · control · information theory · scientific ML · formal verification — the bedrock beneath all three pillars, never a fourth pillar
FIG. 1 — THREE PILLARS ON BEDROCK (ADR-0001)
§3

What it protects against

Vendor lock-in

Every capability sits behind the six versioned interface-contract families defined by ADR-0005. Five seed contract specifications are currently schema-backed with executed conformance tests; the security-contracts family remains reserved. Adaptable by Design: replaceability behind stable interfaces is the testable floor; governed adaptation within validity envelopes is the goal.

Silent assumptions

Model contracts classify every parameter's origin — down to hand tuning without an external anchor and undischarged assumption. Disclosure is legitimate; disguise is a contract violation. Absence of a declaration never reads as confidence (ADR-0006).

Unaccountable automation

Accreditation is a use-specific decision by an identified authority, with recorded basis, conditions, and revocation triggers. Runtime assurance means monitoring plus an assured intervention path. Human authority boundaries stay explicit.

Decay and drift

An RFC-style living document: versioned chapters, appendices, and specs; twelve architecture decision records (ADRs) guarding narrative and taxonomy, including ADR-0008 on watcher/recognizer placement; five review gates; 36 executed conformance tests in CI. External research is incorporated fully attributed and severable — replaceable as the field moves.

§4

The one-way rule

use case ─→ jBOK   jBOK ─→ use case

Use cases, products, and organizations reference the architecture. The architecture references none of them back. One implementation profile — JWM — is documented as evidence, and the book can never depend on it.

§5

The living loop

jBOK doesn't just describe architecture — it metabolizes implementation experience.

BuildAn implementation realizes the architecture in the world
ProfileFindings land in a versioned implementation profile — evidence, deviations, gaps
ClassifyEach lesson is profile evidence — or a candidate pattern that genuinely generalizes
GeneralizePatterns that survive review enter the contracts through an ADR, implementation-neutral
└─ stronger contracts flow back to every future implementation ─┘
LOOP CLOSED: ONCE

ADR-0006 (parameter provenance & completeness) was generalized from JWM's PROV-0 register — the profile is the origin of, and first conformance data point for, that contract language.

§6

The book, by the numbers

§7

Design philosophy

Principle evolution is governed by ADR-0007. Terminal values are durable, not frozen — mechanisms adapt continuously under evidence; the values themselves are revised only by human insight, deliberately, through an ADR.

§8

Implementation profile: JWM (evidence)

Profile evidence flowing into the architecture

JWM is a working single-developer implementation of this reference architecture: a trusted world-model harness with a DLMA structure (Distributed/Decoupled, Layered, Modular, Adaptive), four physics domains composing through one registry seam, evidence packets as end-user artifacts, validity envelopes, human authority boundaries, and PROV-0 parameter provenance. The evidence language in ADR-0006 was generalized from this profile.

OpenUSD evidence

The 2026-07-07 profile session documents a committed USD interop stage carrying physics schemas: five rigid bodies with PhysicsRigidBodyAPI and PhysicsMassAPI, colliders, a revolute joint, a gravity scene, and Z-up at 1 m/unit.

Reference parser

The stage opens cleanly through the Pixar reference implementation (usd-core), including a custom jwm:hash (fnv1a64) integrity attribute read back through that parser.

Independent render path

The same content renders as USDZ in Apple Quick Look at geometry level, by design.

Runtime validation

A full headless Isaac Sim 6.0.1 session ran the stage: opened, physics-stepped, free bodies falling under gravity, provenance attributes read inside the running runtime. The stage NVIDIA's writer saved back was re-ingested at home and its jwm:hash integrity pin verified.

Status

OpenUSD interoperability is verified end to end: the reference implementation, an independent render path, an Isaac Sim 6.0.1 runtime session, and the round trip through NVIDIA's writer with hash re-verification. One open item — revolute-joint rest-pose semantics under runtime solve — is recorded in the JWM implementation profile.