Developer reference
Technical details
Resource interface over governed state
A workspace maps to one pod. Its default target branch supplies the current resource view. An RDF resource's URL identifies its named graph; file resources reference content-bearing values. Reserved internal graphs stay outside the pod surface.
LWS supplies HTTP resource operations, linked containers, metadata and authorization semantics. Stable resource IRIs and conditional requests bind client edits to the version being changed. Resource permissions remain distinct from full workspace membership.
More than resource CRUD
Legra adds commit-addressed snapshots, branch/merge workflows, SHACL validation, SPARQL queries, derivation provenance and executable Stories. These are Legra capabilities layered behind the pod interface, not features attributed to the LWS specification.
Protocol conformance and cryptographic custody are independent contracts. A pod request executes through authorized serving infrastructure; custodians retain encrypted blocks without acquiring workspace decryption authority.