reroot

Module nuspace.shapes.reroot.

Reroot: land a program's state refs under the plane and cell running it.

A program names CellState and PlaneState slots bare. At load the kernel splices every such chain under its owner's state:

======================== ========================================== chain rooted at lands at ======================== ========================================== a CellState subclass States.cells[cell] a PlaneState subclass States.planes[plane].state anything else left alone: another store, Space, ui refs ======================== ==========================================

Explicit bases rather than "anything not rooted at Space", because a movies db ref a program brings along must not move. The splice itself is nu.shape.reroot: the chain resolves one level deeper and picks up States' tag, so it routes to the state store's navigator, never Space's.

reroot

term with its cell state under cell and its plane state under plane.

shapes.reroot(term, plane, cell)

Path nuspace.shapes.reroot. Defined on nuspace.shapes.reroot, bound as a function. Builds nu.Nu.

Both ids, since the two land apart: a cell's state is keyed by the cell alone, the state it shares by its plane.

Arguments

Undocumented: example.

reroot_base

term with the chains rooted at a base subclass spliced under at.

shapes.reroot_base(term, base, at)

Path nuspace.shapes.reroot_base. Defined on nuspace.shapes.reroot, bound as a function. Builds nu.Nu.

The one splice both bases go through, exposed so an op can land a program's state somewhere other than its own cell (eg a sibling's).

Arguments

Undocumented: example.