NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #5681 most downloaded on pub.dev
Nomos 2 Dart client — generated domain values, intent payloads and application lifecycle types over the typed Nomos kernel protocol and USDA custody model.
Latest stable
0.72.21
Last release 6 days ago
11 Nov 2026
Ships fairly regularly
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 months old
134 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
LAW-MINTED IDS RETURN TO THE CALLER: NomosBridge.offerCreates(...) → NomosOfferOutcome{head, created} — a .creates plan mints its aggregate id inside
NomosBridge.offerCreates(...) → NomosOfferOutcome{head, created} — a .creates plan mints its aggregate id inside the sealed intent (payloads never carry one); the offer now hands the minted ids back, so generated create methods return the typed id with no query-after round-trip. New types NomosOfferOutcome / NomosCreated.NomosBridge.mintId(typeTag) — reserve a kernel-minted typed id (<TypeTag>_<uuidv7>) via the holon's front-door mint, for app-side references. (.creates payloads still carry NO id — the law mints those.)nomos-compile ≥0.38 tooling): .creates(...) directive methods now return Future<NomosOfferOutcome> instead of Future<String> — outcome.created.single.id is the new aggregate's typed id.NomosTestHarness (nomos_headless.dart): ephemeral real-law fixtures — one call births a throwaway cloud workspace, deploys compiled *.deploy.json law,
NomosTestHarness (nomos_headless.dart): ephemeral real-law fixtures — one call births a throwaway cloud workspace, deploys compiled *.deploy.json law, and hands out independent client replicas (connect(clientId:)) over the node runner. Identity defaults to the githolon login --agent session (~/.holon/credentials.json). Live-proven: birth → deploy → write on one replica → converge + typed read on another, 14s end-to-end.package:nomos_client/nomos_headless.dart): NodeRunnerTransport — a BridgeTransport over the @githolon/client node runner (runner/node-entry.mjs) as a plain child process (NDJSON stdio). flutter test / dart test / CI drive the REAL githolon (byte-identical wasm, real ledger, real gate) through NomosBridge + the generated typed clients — no Flutter plugins, no WebView, no assets. Requires node on PATH + a resolvable @githolon/client (auto-resolved from the app's node_modules, or pass entry:). Proven end-to-end: connect → offerDirective → sync(admit) → typed query, and the same test green under both dart test and flutter test.Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
TYPED SNAPSHOT RECOVERY (corrupt local custody): NomosBridge.connect(recover: true) recovers IN-PLACE from a corrupt restoreFrom snapshot — salvages l
NomosBridge.connect(recover: true) recovers IN-PLACE from a corrupt restoreFrom snapshot — salvages local-only authored writes (via the fallible intents_above, which stops at a missing-ancestor gap) + the DLQ, refolds FRESH from cloud, re-offers the salvaged work (deduped), re-queues the DLQ. The report rides bridge.lastRecovery = {salvagedWrites, requeuedDeadLetters, unsalvageable} — a write the current law refuses lands in unsalvageable + the DLQ (surfaced, never dropped). Also holon.salvage() / holon.absorbSalvage(). Closes the restoreFrom-leaves-read-model-empty case.TIER-2 SYNC SIZE: NomosBridge.syncSize() → {bytes, kind} — how many bytes this workspace would transfer to catch up, WITHOUT downloading (a HEAD on th
NomosBridge.syncSize() → {bytes, kind} — how many bytes this workspace would transfer to catch up, WITHOUT downloading (a HEAD on the serving pack; the host answers Content-Length, cached ~15s). Sum across open workspaces for an aggregate "X MB to sync" total before any download.SYNC STATE + REAL LOADING BARS: NomosBridge gains syncStatus (Stream — phase/ahead/behind/saved/onMain/deadLetters/transfer/lastSyncedAt, derived from
NomosBridge gains syncStatus (Stream<SyncStatus> — phase/ahead/behind/saved/onMain/deadLetters/transfer/lastSyncedAt, derived from sync rounds + doorbell + transfer + a 4s metrics poll), transferProgress (Stream<TransferProgress> — live pack byte-progress; total is the host Content-Length so the bar is truthful, never estimated), and currentStatus. New types: SyncStatus, SyncPhase, TransferProgress.createWorkspace / shareWith no longer require authorSecret — it defaults to the connection's signing key (the home device key NomosScope.home loaded).
createWorkspace / shareWith no longer require authorSecret — it defaults to the connection's signing key (the home device key NomosScope.home loaded). A frontend dev never threads a key through make-workspace or share.NomosBridge.shareWith — one-call cross-custody share (sign quote + deliver recordShare to the subjects home). Closes the shared-with-me loop.
NomosBridge.shareWith — one-call cross-custody share (sign quote + deliver recordShare to the subjects home). Closes the shared-with-me loop.NomosBridge.offerIntent (canonical write verb; offerDirective kept as alias) + one-call NomosBridge.createWorkspace (sign + relay a control-plane offe
NomosBridge.offerIntent (canonical write verb; offerDirective kept as alias) + one-call NomosBridge.createWorkspace (sign + relay a control-plane offer).NomosBridge.noteLocalSpan(...) — inject a locally-measured span (e.g. the Dart-side durable save, the "saved to disk" number) into the span stream so
NomosBridge.noteLocalSpan(...) — inject a locally-measured span (e.g. the Dart-side durable save, the
"saved to disk" number) into the span stream so it appears on the flame chart AND the per-phase stats
exactly like a kernel span. Additive; used by nomos_flutter's durable-save-on-write.NomosBridge.connect accepts the internal allowUnborn opt-in used by NomosScope.home, so the home-birth ceremony can boot a local bridge before the hom
NomosBridge.connect accepts the internal allowUnborn opt-in used by NomosScope.home, so the
home-birth ceremony can boot a local bridge before the home workspace has a remote main. The default
remains strict for ordinary workspaces.NomosBridgeError now carries structured NomosErrorInfo alongside the existing human-readable message. The envelope includes stable code/component/oper
NomosBridgeError now carries structured NomosErrorInfo alongside the existing human-readable
message. The envelope includes stable code/component/operation fields, workspace/domain/directive
context, trace/span ids, arbitrary attributes, and toTelemetryAttributes() for future OpenTelemetry
export without taking an SDK dependency.Authority-aware: NomosBridge.offerDirective(domain, directiveId, payload, {actor, domainHash}) — generated clients route every offer through THE ONE e
NomosBridge.offerDirective(domain, directiveId, payload, {actor, domainHash}) — generated
clients route every offer through THE ONE encoder (encodeIntentOfferBytes in @githolon/client); no
per-client envelope encoding. New typed MissingOfferAuthority — a .requires(...) directive authored
with no actor throws BEFORE submit (an actorless gated offer cannot be generated). Lockstep jump to 0.20.0.Lockstep bump with the birth-primitive release (see @githolon/dsl 0.17.0): birth is one law primitive (birthChild), the platform-creator tier collapse
@githolon/dsl 0.17.0): birth is one law primitive
(birthChild), the platform-creator tier collapsed onto #creator, grantCreation takes a user or key
subject. The Dart wire types track the current /v2 governance surface.First pub.dev release: kernel wire types, NomosBridge protocol, typed offer/query/watch surface.
NomosBridge protocol, typed offer/query/watch surface.