Expand description
The persistent procedural document field (Phase 11).
A Field is the queryable, content-addressed procedural substrate behind a
document. It is opened from a FieldStore by a FieldId and can:
- materialize the exact original source bytes (
Field::materialize_exact), exactly as the standalone.voldocform does, and - serve derived/structured observations from the persisted seed DAG without reconstructing the whole document.
The exact archival authority is the serialized .voldoc descriptor, stored as
one blob; the seed DAG and the hierarchical index are additional persisted
state. A field never weakens materialize(root) == original_bytes (ADR-0024).
Re-exports§
Modules§
- cache
- Disposable, closure-keyed derived observation cache (Phase 11.8).
- capabilities
- Machine-readable capability discovery for the common observation layer (Phase 12.7, ADR-0031, plan §DEC-5).
- dag
- The procedural seed DAG: bounded closure traversal and materialization.
- derive
- Deterministic derived projections (Phase 11,
Q_gen). - document_
format - Byte-based document-format detection for the universal observation API (Phase 12.7, ADR-0031, plan §DEC-5).
- edit
- Immutable node-level edit of a procedural field (Phase 11.12).
- explain
- EXPLAIN and EXPLAIN ANALYZE for field observations (Phase 11.5, ADR-0026).
- index
- Bounded hierarchical observation index (Phase 11.3).
- ingest
- Progressive early inverse-proceduralization of a PDF field (Phase 11.4).
- manifest
- The field manifest: a small, canonical, content-addressed root (Phase 11).
- node
- Canonical procedural seed nodes (Phase 11, ADR-0025).
- observe
- The observation query engine (Phase 11.5–11.7).
- partial
- Seek-based partial descriptor loading (Phase 11.12, review priority #2).
- plan
- The deterministic observation planner (Phase 11.5–11.6, ADR-0026, DEC-9).
- provenance
- Provenance and typed answers for field observations (Phase 11.5, ADR-0026).
- resource
- Cross-document content-addressed resource sharing (Phase 12.8, ADR-0034).
- share
- Finer-than-object shareable units (Phase 11.14).
Structs§
- Field
- An opened field: the manifest plus its parsed exact descriptor.
- Field
Store
Constants§
- FIELD_
UNIVERSE - The canonical universe string for a Phase-11 field.