@noopolis/stele

Reconciliation compatibility notes

streamKey(runId, system, streamId) is an opaque JSON tuple encoding. Do not parse it by delimiters; callers that persist or compare keys must treat the complete returned string as the identity.

checkSeqContiguity().gaps[*].missing contains sorted inclusive { from, to } ranges rather than one entry per missing sequence number. This keeps sparse streams (including Number.MAX_SAFE_INTEGER) bounded in memory.

The shared causal-event schema and reconciler for the Noopolis ecosystem.

Stele defines the canonical shape of a causal event, the rules for parsing and hashing it, and a deterministic reconciler that turns a stream of events into causal chains. It is runtime-neutral (no browser or Node globals), depends only on zod, and is consumed by tools like Simfile to observe and replay runs.

npm install @noopolis/stele

What it gives you

• Envelope — the CausalEvent schema (causalEventSchema), plus parseCausalEvent / validateCausalEvent, canonical JSON (canonicalJsonStringify), stable hashing (hashCausalEvent), JSONL parsing (parseCausalJsonl), the principal grammar, and CAUSAL_EVENT_VERSION.
• Reconcile — reconcileEvents returns a ReconcileResult with byEventId records and occurrencesByEventId; each ReconciledRecord carries localState, reasonCodes, reasons, and transitive state. It never invents a missing link; use traceCausesBackward to walk an event's causes.
• Seq — checkSeqContiguity and streamKey detect gaps in a per-stream sequence, surfacing SeqGaps instead of silently stitching over them.
• Sealed bundles — reconcileCausalBundle(input) parses mixed raw JSONL text or bytes, uses only noopolis.causal-stream-final.v1 records as final authority, and returns invalid, incomplete, or valid with deterministic parser, stream, and graph diagnostics. declaredFinalSeq remains a compatibility-only reconcileEvents option and never seals a bundle.
• Digest comparison — compareCausalDigest(domain, subject, expectedHash) is a pure fail-closed SHA-256 comparison for a recognized domain. Exact UTF-8 and byte subjects are hashed exactly as supplied; digest declarations do not assign product-specific subjects or producers.

Example

import { parseCausalJsonl, reconcileEvents, traceCausesBackward } from "@noopolis/stele";

const { events, errors } = parseCausalJsonl(await readFile("ledger.jsonl", "utf8"));
const reconciliation = reconcileEvents(events);
const record = reconciliation.byEventId.get("moltnet:m2");
const edges = traceCausesBackward(reconciliation, "moltnet:m2");

// record?.state includes transitive cause state; record?.reasonCodes explain it.
// edges lists { from, to } cause links; missing causes are reported, never stitched.

Design

• Deterministic. The same events reconcile to the same records and hashes, every time.
• Honest. A missing causal link is reported as incomplete, not papered over.
• Neutral. Pure data + math; no I/O, no environment assumptions.

github.com/noopolis/stele · part of the Noopolis ecosystem