core.lattice127 module

The load-bearing 127 Loopback Lattice.

The lattice is the seven-dimensional Boolean lattice B7. The dormant bottom element 0000000 is retained for algebraic closure but never executes. The remaining masks 0000001 through 1111111 are the 127 active cells.

A mask is both an algebraic coordinate and a scope declaration. Join is bitwise OR, meet is bitwise AND, and rank is population count. The local address 127.0.0.<mask> is a deterministic loopback namespace, not a demand that every cell run as a separate socket or process.

class core.lattice127.Organ(*values)

Bases: IntFlag

The seven primitive organs of the Stargazer runtime.

VOID = 0
ORIGIN = 1
MEMORY = 2
PERCEPTION = 4
REASONING = 8
ACTION = 16
SWARM = 32
THETA = 64
SELF = 1
HOMEOSTASIS = 64
BOUNDARY = 64
exception core.lattice127.LatticeViolation

Bases: ValueError

Raised when a transition crosses the typed 127-lattice boundary.

core.lattice127.required_mask_for_fields(fields)

Return the minimum certified lattice scope for runtime-field changes.

Return type:

int

Parameters:

fields (Iterable[str])

class core.lattice127.LatticeCell(mask)

Bases: object

One element of B7, including the dormant bottom element.

Parameters:

mask (int)

mask: int
property active: bool
property binary: str
property rank: int
property organs: tuple[Organ, ...]
property name: str
property local_ip: IPv4Address
property complement: LatticeCell
contains(required)
Return type:

bool

Parameters:

required (int | Organ)

excludes(forbidden)
Return type:

bool

Parameters:

forbidden (int | Organ)

class core.lattice127.LatticeValidation(active_cells, total_cells, hasse_edges_with_void, active_hasse_edges, rank_distribution, unique_loopback_addresses, all_addresses_loopback, closed_under_join_and_meet)

Bases: object

Parameters:

  • active_cells (int)

  • total_cells (int)

  • hasse_edges_with_void (int)

  • active_hasse_edges (int)

  • rank_distribution (Mapping[int, int])

  • unique_loopback_addresses (bool)

  • all_addresses_loopback (bool)

  • closed_under_join_and_meet (bool)

active_cells: int
total_cells: int
hasse_edges_with_void: int
active_hasse_edges: int
rank_distribution: Mapping[int, int]
unique_loopback_addresses: bool
all_addresses_loopback: bool
closed_under_join_and_meet: bool
class core.lattice127.LoopbackLattice127

Bases: object

Algebra, addressing, and typed fields for the 127 active cells.

property cells: tuple[LatticeCell, ...]
property active_cells: tuple[LatticeCell, ...]
property void: LatticeCell
property crown: LatticeCell
cell(value)
Return type:

LatticeCell

Parameters:

value (int | Organ | LatticeCell)

join(*values)
Return type:

LatticeCell

Parameters:

values (int | Organ | LatticeCell)

meet(*values)
Return type:

LatticeCell

Parameters:

values (int | Organ | LatticeCell)

upper_covers(value)
Return type:

tuple[LatticeCell, ...]

Parameters:

value (int | Organ | LatticeCell)

lower_covers(value, *, include_void=True)
Return type:

tuple[LatticeCell, ...]

Parameters:
shadow_halo(value, *, include_void=False)

First-order Hasse neighbors for controlled one-organ perturbations.

Return type:

tuple[LatticeCell, ...]

Parameters:
hasse_edges(*, include_void=True)
Return type:

tuple[tuple[int, int], ...]

Parameters:

include_void (bool)

rank_distribution(*, include_void=False)
Return type:

dict[int, int]

Parameters:

include_void (bool)

field(*, required=<Organ.VOID: 0>, forbidden=<Organ.VOID: 0>, include_void=False)
Return type:

tuple[LatticeCell, ...]

Parameters:
property sword_field: tuple[LatticeCell, ...]

Constitution-bearing cells, excluding the immutable germline alone.

property sword_commit_field: tuple[LatticeCell, ...]
property morphogenesis_field: tuple[LatticeCell, ...]
property external_effect_field: tuple[LatticeCell, ...]
property fusion_field: tuple[LatticeCell, ...]

Cells in which S.W.O.R.D. claims meet Morphogenesis certification.

canonical_spine()

The 1→3→7→15→31→63→127 inclusion chain.

Return type:

tuple[LatticeCell, ...]

validate()
Return type:

LatticeValidation

class core.lattice127.RecursiveLatticeAddress(path=(127,))

Bases: object

A lazily materialized lattice-of-lattices address.

Every path segment is one active B7 cell. Potential depth is unbounded; live materialization is finite and controlled by RecursiveLoopbackLattice.

Parameters:

path (tuple[int, ...])

path: tuple[int, ...]
classmethod root()
Return type:

RecursiveLatticeAddress

classmethod repeated_crown(depth, *, leaf=<Organ.ORIGIN: 1>)

Build one finite 127/.../127.0.0.<leaf> address path.

This allocates the explicit path but does not materialize its intermediate cells into a RecursiveLoopbackLattice.

Return type:

RecursiveLatticeAddress

Parameters:
property depth: int
property leaf: LatticeCell
property local_ip: IPv4Address
property uri: str
property binary_uri: str
property recursive_notation: str
property parent: RecursiveLatticeAddress | None
descend(cell)
Return type:

RecursiveLatticeAddress

Parameters:

cell (int | Organ | LatticeCell)

is_ancestor_of(other)
Return type:

bool

Parameters:

other (RecursiveLatticeAddress)

class core.lattice127.RecursiveLoopbackLattice(*, maximum_materialized_cells=4096)

Bases: object

Finite live materialization over an unbounded recursive address space.

Parameters:

maximum_materialized_cells (int)

property maximum_materialized_cells: int
property materialized: tuple[RecursiveLatticeAddress, ...]
is_materialized(address)
Return type:

bool

Parameters:

address (RecursiveLatticeAddress)

materialize(address)
Return type:

None

Parameters:

address (RecursiveLatticeAddress)

unfold(parent, cells)
Return type:

tuple[RecursiveLatticeAddress, ...]

Parameters:
collapse(address)

Remove descendants while preserving the addressed scar/cell itself.

Return type:

int

Parameters:

address (RecursiveLatticeAddress)

class core.lattice127.LatticePolicy

Bases: object

Typed mutation and effect laws shared by gates and adapters.

static validate_morphogenesis_target(target, *, required=<Organ.THETA: 64>)
Return type:

int

Parameters:
static validate_sword_candidate(target)
Return type:

int

Parameters:

target (int | Organ | LatticeCell)

static validate_sword_commit(target)
Return type:

int

Parameters:

target (int | Organ | LatticeCell)

static validate_external_effect(target)
Return type:

int

Parameters:

target (int | Organ | LatticeCell)