"""``arborist.world`` — v7-W spatial-temporal substrate (#000013).

Reserved namespace. The substrate paper at
``docs/_source/merkle-agi-v7w-spatial-temporal.rst`` specifies the
contract; this package will host the implementation when fox
prioritizes a v7-W deployment target.

Status: namespace stub only. No kernels, no sources, no API surface
yet. Importing this package succeeds (the module loads and reports
its draft version) but nothing else is exported.

Future shape (per substrate paper Part 4 — verifier kernels):

::

    arborist/world/
    ├── __init__.py                # this stub; metadata + reservation
    ├── pi_star/                   # canonical projections π*_w
    │   ├── object.py              # π*_w_object
    │   ├── relation.py            # π*_w_relation
    │   ├── event.py               # π*_w_event
    │   ├── place.py               # π*_w_place
    │   └── agent_trace.py         # π*_w_agent_trace
    ├── frontier/                  # ε-frontier kernels
    │   ├── pose_integration.py
    │   ├── observation_update.py
    │   ├── object_logits.py       # bridges to v7
    │   └── relation_logits.py
    ├── frame.py                   # frame definitions + transforms
    ├── clock.py                   # wall-clock + Lamport
    ├── manifest.py                # v7-W substrate manifest schema
    └── adapters/                  # sensor adapters land here as
                                   # separate tickets

The substrate paper's hard constraint applies here too: every kernel
operates on quantized integer state, never on continuous tensors.

Implementation tickets that cite the substrate paper land kernels
one at a time; this stub exists so cross-referencing imports
(downstream consumers, sibling repos) can pin the namespace before
any kernel ships.
"""

from __future__ import annotations


__all__ = ["V7W_VERSION", "STATUS"]


V7W_VERSION = "v0-draft"
"""Draft substrate version. Bumps on every spec change before v1
freeze. Once a kernel ships, V7W_VERSION pins the manifest version
the kernel emits."""


STATUS = "namespace_reserved"
"""Reservation status. Becomes ``kernel_in_progress`` when the first
verifier kernel lands; ``v1`` once Part 4 of the substrate paper has
all four ε-frontier kernels with passing tests + bench fixtures."""
