DEVELOPERS · VALIDATION

TOOLCHAIN 0.1.1 · WORKING ALPHA

Verify the source tree before trusting derived context.

OpenRGD separates content identity, static profile validation and grounding-context generation into explicit commands with different guarantees.

IMPLEMENTATION BOUNDARY

Validation proves source/profile properties within the declared checks. It does not assess hardware compatibility, operational safety, embodied-runtime readiness or permission to actuate.

HASH

Commit the selected modular source tree.

verify source rootshell
rgd hash
rgd hash --output json

A mismatch exits non-zero. Use rgd hash --write only for an intentional source change. The integrity profile is OPENRGD_SOURCE_TREE_SHA256_V1.

CHECK

Validate canonical structure and selected modules.

profile validationshell
rgd check
rgd check --output json
rgd check spec/00_core/kernel.jsonc --output json
01

Kernel path

Requires the canonical spec/00_core/kernel.jsonc path.

02

Source root

Requires the declared canonical source-tree root to match.

03

Identity

Requires a non-empty kernel identity.

04

References

Module references must be safe, unique and relative.

05

Presence

Every selected module must exist.

06

Parsing

Each selected module must parse as a JSON object without non-finite values.

BOOT

Build deterministic context without crossing into execution.

grounding contextshell
rgd boot
rgd boot --output json
physical execution stateshell
physical_execution.assessed = false
physical_execution.authorized = false
physical_execution.status = NOT_AUTHORIZED_BY_BOOT

rgd boot is not a hardware bootloader, runtime startup command, safety authorization or claim that the robot is ready.

RELATED GUIDES

Continue through the verified toolchain.

CANONICAL SOURCE