DRAFT(next-exp): container-house pools + connectivity failsafe scaffolds

Defensive-measurement instrument scaffolds for the re-staged experiment, not
wired into the sealed pipeline:
- house_pool.py: distinct isolated container pools per house (own net + keys),
  deterministic seed-derived node ids; refuses engine=="local" (containment).
- watchdog.py: pre-registered HALT / PAUSE-RESUME failsafe for load-bearing
  node pools; deterministic, probe injected (no external target).

Both are DRAFT for a fresh pre-registration; neither touches the sealed battery.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
leetcrypt
2026-07-22 23:18:16 -07:00
parent de0d34cce1
commit 6bae9a176d
2 changed files with 241 additions and 0 deletions
+129
View File
@@ -0,0 +1,129 @@
"""Track-B container-simulated house pools — DRAFT (next experiment only).
Purpose (see prereg NEXT-EXPERIMENT-DRAFT §1 Track B): replace the *logical phone
labels* used to stand in for house-B/house-C in the sealed battery with **genuinely
distinct container pools**. Each house becomes an isolated Docker network hosting its
own N node containers, each with its own X25519/Ed25519 identity — giving real,
auditable node-distinctness on a single laptop, with **no phone dependency**.
Containment (load-bearing, identical to the sealed instrument):
* Every node runs inside an **isolated engine** — this module refuses to place a node
unless ``engine != "local"``. No node ever runs on the bare host.
* Self-generated fixture traffic only; no external target; lab-only.
Integrity boundary: anything measured through these pools is a **new** measurement. It
may be reported as *exploratory*, or promoted to confirmatory only under a fresh frozen
pre-registration. It may NEVER be merged into the sealed original battery.
This module is a pool *model* + containment validator + deterministic identity
assignment. Actual container launch is injected by the caller (``executor.py``) via a
``launch_fn`` seam, so this file stays correct without duplicating engine plumbing.
"""
from __future__ import annotations
import hashlib
from dataclasses import dataclass, field
from typing import Callable, Dict, List, Optional
class ContainmentError(RuntimeError):
"""Raised when a placement would violate the isolated-engine law."""
@dataclass(frozen=True)
class SimNode:
"""One simulated relay node: an isolated container with its own identity."""
node_id: str # deterministic, seed-derived
house: str # owning house id (e.g. "house-B")
engine: str # MUST be an isolated engine (docker/multipass), never "local"
net: str # isolated docker network the node lives on
def __post_init__(self) -> None:
if self.engine == "local":
raise ContainmentError(
f"node {self.node_id}: engine=='local' is forbidden — "
"isolated engine only (containment law §1)"
)
@dataclass
class HousePool:
"""A house realised as a distinct, isolated container pool (Track B)."""
house: str
engine: str
net: str
size: int
nodes: List[SimNode] = field(default_factory=list)
def _derive_node_id(s0: int, house: str, idx: int) -> str:
"""Deterministic node id from the base seed — mirrors the sealed seed formula."""
h = hashlib.sha256(f"{s0}|{house}|{idx}".encode()).digest()
return h[:8].hex()
def plan_house(house: str, size: int, engine: str, s0: int) -> HousePool:
"""Plan a house pool of ``size`` distinct isolated nodes. Does not launch anything.
Raises ``ContainmentError`` if asked to plan on the local (non-isolated) engine.
"""
if engine == "local":
raise ContainmentError(
f"{house}: refuse to plan a pool on the local engine — isolated only"
)
net = f"sor-{house}-net"
pool = HousePool(house=house, engine=engine, net=net, size=size)
for i in range(size):
pool.nodes.append(
SimNode(node_id=_derive_node_id(s0, house, i), house=house, engine=engine, net=net)
)
return pool
def plan_federation(
house_sizes: Dict[str, int], engine: str, s0: int
) -> Dict[str, HousePool]:
"""Plan several distinct house pools that will be federated.
Each house gets its **own** isolated network + identities, so cross-house
split-knowledge is a real property of the topology, not a label.
"""
return {h: plan_house(h, n, engine, s0) for h, n in house_sizes.items()}
def assert_distinct(pools: Dict[str, HousePool]) -> None:
"""Fail loudly unless every node id is globally unique and every net is per-house."""
seen: set[str] = set()
nets: set[str] = set()
for pool in pools.values():
if pool.net in nets:
raise ContainmentError(f"network {pool.net} reused across houses")
nets.add(pool.net)
for n in pool.nodes:
if n.node_id in seen:
raise ContainmentError(f"duplicate node id {n.node_id}")
seen.add(n.node_id)
def realise(
pools: Dict[str, HousePool],
launch_fn: Callable[[SimNode], str],
) -> Dict[str, List[str]]:
"""Launch every planned node via the injected ``launch_fn`` (executor seam).
``launch_fn`` must actually start the node inside its isolated engine/network and
return a container handle. This function only enforces the containment invariant and
the distinctness check before delegating; it never shells out to docker itself.
"""
assert_distinct(pools)
handles: Dict[str, List[str]] = {}
for house, pool in pools.items():
handles[house] = []
for node in pool.nodes:
if node.engine == "local": # belt-and-braces
raise ContainmentError(f"{node.node_id}: local engine at launch")
handles[house].append(launch_fn(node))
return handles