OpenSentience.orgUnboxed PatternsThe catalog · 32 chapters

A catalog, and a book in progress

Unboxed Patterns

Elements of Composable Locus-Oriented Software. What recurring structures appear when computation is organized around persistent identity, locality, composition, authority, progress and observable semantic state — rather than around the class, the thread or the service?

Every pattern here is a named problem, the forces that make it costly, one invariant, and — where the tree has one — a check you can run on this page. Labels are derived, never typed: WITNESSED means a recorded run of a check exists for the exact bytes on disk at rung in_tree or above; STATED means the tree says it and no run proves it; PROPOSED means the book names it and the tree does not. 13 witnessed · 14 stated · 3 proposed · 12 anti-patterns. Plan and open rulings: ProjectAmp2/UNBOXED_PATTERNS.md.

The two numbers this catalog is least comfortable with, up here rather than at the back. 0 of 32 patterns have been reproduced outside this tree — every check on this site is ours, run against our own code. And of the 8 counterexamples that point at a file, 1 resolves a law id against the suite's own index, 1 is scoped to its law's declaration, and 6 check only that a string is present — which proves a file mentions something, not that it refuses anything. Both numbers are derived on every build, and the conclusion carries the rest.

The Locus

Composition

compute surfacejoinjoinAfeeds_into=[T1]Caccepts_from=[T1]Bfeeds_into = (undeclared)

Refusing Join WITNESSED

A join that cannot be made is refused, and the refusal names the field.

compute surfaceFilm v0.7 — the observable bytesstatestatefuture Afuture Afuture Bfuture BS₁rotor=0 · receipt=∅

Shared Observable WITNESSED

Every state variable that can determine the future must be in the observable bytes.

compute surfacethe membrane: exposed statesubsystemsubsystemfuture Afuture Afuture Bfuture Byy determines the future

Semantic Membrane PROPOSED

A composed subsystem exposes exactly the state that affects externally observable future behaviour — and no more.

compute surfacefeasible ▸ permitted ▸ bestfeasible ▸ permitted ▸ bestafeasible

Capability-Bounded Composition WITNESSED

Feasible, then permitted, then best — over a floor that composition cannot weaken.

compute surfacestart_carrierstart_carrierreqinherits every descriptor · whole filesystem

Carrier Confinement STATED

A Carrier starts with exactly the filesystem and descriptor authority its Worker's grant names.

compute surfaceprojection · derived, recomputableartifactartifactview Aview Aview Bview BPderived from the artifact

Projection, Not Duplication WITNESSED

Every view of an artifact is derived from it by a declared, recomputable function.

compute surfacethe wire: claims onlyproducerproducerverifier · JSverifier · JSverifier · Pythonverifier · PythonRsem-8ae91fe9…

Refusable Divergence WITNESSED

A divergence between two implementations is refused by name, not passed in silence.

Progress

Persistence and World

compute surfacecacheRAMSSDremote nodeLsame code path

Orthogonal Persistence STATED

Whether a locus's state is in cache, RAM, disk or a remote node is an implementation choice below its semantic level.

compute surfaceWORLD · the machine · 10 GB – 10 TBWORLD VERSION · a manifest root · KBWRL GRAPH · the semantic layer · KB – MBheadwrl_head — always qualified

Three Sizes of World STATED

WORLD, WORLD VERSION and WRL GRAPH are three sizes with three names; a head is always qualified.

compute surfaceoutsideworld boundary — undefined (GAP)authority · state · observationLan active locus inside

World Boundary PROPOSED

A world is a coherent domain of authority, state and observation — and the tree has not yet defined its boundary.

compute surfacecanonical formWRL sourceWRL sourcehost Ahost Ahost Bhost BW4 objects · 3 routes

Meaning Is a Hash WITNESSED

The meaning of a WRL world is its SemanticArtifactID.

compute surfacethe filmsealed worldsealed worldplayer Aplayer Aplayer Bplayer BFfilm of one run

Exact Replay STATED

A run of a sealed world is a film that replays byte-identically; a divergence on replay is the world's, not the player's.

compute surfacemachine Amachine BTInteractionTrace

Cross-Machine Skill Replay STATED

A skill taught on machine A replays on machine B with the declared fidelity; the InteractionTrace is the unit of transfer.

compute surfacekey = hash(content)contentcontentreader who knows itreader who knows itreader who does notreader who does notcsecret content

Confidentiality Under Content Addressing STATED

If the key is the hash of the content, knowing the content is knowing the key — and where confidentiality comes from is unruled.

Agency

compute surfacestale? forged? partial?observationobservation'known' — taken as read'known' — taken as readestablished — checkedestablished — checkedoreading: door is locked

Established, Not Known definition

Establish, never know or detect: an observation can be stale, forged or partial, and establishing is what survives that.

compute surfaceadmissible?admissible?sestablished: is-admin = true

State Does Not Grant Authority WITNESSED

A fact about a locus never constitutes a power.

compute surfaceledger gateledger gatecclaim · witness: (none)

Evidence Before Claim WITNESSED

A proposition is admitted only with a named witness that exists.

compute surfacesufficiency gatesufficiency gateppage · material: thin

Refusal Gate STATED

Below material sufficiency the page is not written, and the reason is published.

compute surfaceinterveneinterveneaaction · no worker · no generation

Intervention Provenance STATED

Every intervention carries the Worker and generation that made it and the evidence it acted on; an unattributable intervention is inadmissible.

compute surfacesupport?support?Bdescended from A · lineage edge

Descent Is Not Dependence WITNESSED

A lineage edge generates a candidate support set and establishes none.

compute surfacewhat existswhat it can observewhat it believeswhat it understandswhat it intendswhat it may alterca claim

Understanding Boundary STATED

A locus keeps apart what exists, what it can observe, what it believes, what it understands, what it intends and what it may alter.

Patterns that should disappear

  1. Carrier IdentityTreating a thing as the process, thread or container currently executing it.
  2. Location LeakEncoding physical placement into identity when placement is not semantic.
  3. False QuiescenceDeclaring completion because no currently observed worker has work. · paid for at REVISION_REGISTER.md:99 (CompletedScan renamed CompletedSweep; doesNotAssert added)
  4. Invisible StateAllowing state that affects future behaviour to remain outside the shared observable. · paid for at TRVM/LAWS.md:80 (Law 6 witnesses: rotor, receipt, once-latch)
  5. Ambient AuthorityGranting access to an environment because some part of it needs one capability. · paid for at AGENCY.md §4 (the phrasing that walks into it); Miller 2003 is the term's source
  6. Replica TheaterCalling independent mutable copies 'the same thing'. · paid for at CLAUDE.md: the served box-and-box copy is a MANUAL COPY and nothing syncs it
  7. Busywork SchedulingMaximizing resource utilization while semantic progress stalls. · paid for at computedriven/receipts/R7-EXECUTED.md title: the busiest Carrier makes the least progress
  8. Agent OmniscienceLetting an agent's claims exceed its evidence boundary. · paid for at AGENCY.md §6 (what is established vs a reading)
  9. A Number in Two PlacesA count or definition typed where it is displayed instead of derived from its source; the two drift. · paid for at STACK_COMPLETION.md corrections §1 (law counts 129→116→118); UNBOXED_PATTERNS.md v0.1 (32 labels over 30 rows; 890 vs 924)
  10. Record Is LocusInferring that X is a locus because X carries the locus fields. · paid for at AGENCY.md §1 corollary; caught on review of the factory page
  11. Provenance as SupportTreating a lineage edge as causal support for a capability. · paid for at mosaic/embodiment.json; scripts/emb-support.mjs refuses it
  12. The Quiet CorrectionFixing a published error without retracting it by name where it was published. · paid for at DOCTRINE.md rule 5

Findings from this build