NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
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 11 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
5 months old
134 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Preserve the kernel's read position with a generated rows result so a composed read can distinguish a pending replica from a proven empty answer.
Rebuild for the pending npm changeset flutter-release-metadata, which changes the embedded runtime.
Rebuild for the pending npm changeset browser-custody-handover-under-load, which change the embedded runtime.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Rebuild for the pending npm changesets cap-1111-reception-coordinator-keeps-complete-source and opening-is-retryable, which change the embedded runtim
Rebuild for the pending npm changeset hosted-reception-coordinator-alarm-never-wedges, which change the embedded runtime.
Restage the bundled runtime with hosted REST parity fixes: foreign references serialise as plain references (CAP-1107), and payload shape errors name
Restage the bundled runtime with the projection fix that keeps a founding record's owner contract, so reading it on an upgraded Home no longer reports
evolutionRequired (CAP-1012).Restage the bundled runtime with the coordinated compiler release that keeps each founded domain's FoundingPrincipal aggregate in place, so laws using
FoundingPrincipal aggregate in place, so laws using the CAP-1011 founding read upgrade existing workspaces instead of being refused for removing it.Restage the bundled runtime with the coordinated compiler release that selects founded business births from the durable founding record, so console de
Restage the bundled runtime with the coordinated compiler release that selects founded business births from the durable founding record, so console device re-enrolment keeps a founded workspace able to birth children (CAP-1011).
Release the generated runner restaged with the CAP-892 compiler (wire-type evolution gate) package versions.
The bundled Node runner carries the @githolon/runtime release that refuses an oversized live offer frame before encoding it and never records a refused frame as sent (CAP-1008).
The bundled Node runner carries the @githolon/runtime release whose post-rebase offer check asks the kernel for one change above the custodian's head instead of every unsent change (CAP-1007).
The bundled Node runner names the @githolon/runtime release it was built from; it now carries the runtime that accompanies native hosts 0.69.5.
The bundled Node runner names the @githolon/runtime release it was built from; it now carries the runtime that accompanies native hosts 0.69.4.
The bundled Node runner names the @githolon/runtime release it was built from; it now carries the runtime that accompanies native hosts 0.69.3.
The bundled Node runner names the @githolon/runtime release it was built from; it now carries the runtime that accompanies native hosts 0.69.2.
Reconcile a completed round's outstanding work and copy repairs before folding application sync status, so a successful reconnect clears the aggregate
Run event-triggered application projection refreshes in the shared background scheduling context. Preserve cross-workspace updates and initial visible-read priority without repeatedly delaying native sync.
A pack tidy that fails after a sync no longer shows the application as still preparing: the read index a sync owes is reported under its own read caus
Deliver the shared runtime's owned, bounded pack import continuations and cancellation with the matching kernel protocol, preventing concurrent worksp
Deliver the shared runtime's owned, bounded pack import continuations and cancellation with the matching kernel protocol, preventing concurrent workspace acquisition from dropping an active import.
Release with the runtime whose held reads repay their own workspace's index first (CAP-890).
Release with the runtime whose local reads answer from the last-ready read index and type a successor-law refresh as a retryable unavailable (CAP-891).
Release with the runtime whose cold read-index rebuild keeps the last-ready frontier serving reads until the rebuilt index switches in (CAP-900).
A one-shot read whose workspace's read index is being rebuilt under the law its head just adopted waits for the rebuilt index (re-asking near the runtime's retryAfter) instead of throwing NomosUnavailable(unknown, ...). On Jack's phone (1.66.17) upsertUserEstateAccess failed this way right after the Home pulled the 2026.10.2 law (CAP-900).
Release with the runtime whose checkpoint transfers are pipelined and run two at a time, with the checkpoint wait limit for remounts (CAP-901).
Reads never wait on the network (CAP-908). A one-shot application data read (rows, a page, by-id, by-type or spatial rows, a count, a sum, and their historic forms) of a workspace this device does not hold yet, is still opening, or is re-indexing under a law this app cannot decode, now answers at once: an empty result, with the session's SyncStatus.localCopy and ApplicationStatus.localCopy set to LocalCopyReadiness.arriving or .updating (ApplicationStatus.localCopyArriving, localCopyUpdating, localCopyPending). A read that answers sets it back to ready. A framework read with no empty form (child workspaces) reports the typed NomosUnavailable at once. nmsUntilReplicaReady, which re-asked such reads for up to 10 minutes, is gone. On Jack's iPhone (TestFlight 1334, 11 Oct 2026) a never-fetched data profile's read was held 11 s behind a full-panel spinner.
A watch on such a workspace emits the empty result and the status at once, then registers in the background (woken by the workspace's sync) and emits the rows; it stops re-asking as soon as the peer delivers its first result.
LocalCopyReadiness.firstDownload and ApplicationStatus.localCopyFirstDownload (CAP-913). A read of a workspace that has never been on this device answers empty at once, and says so: firstDownload, not merely arriving. Once the copy lands, the status is arriving while its indexes are prepared, then ready when a read answers from it. Admission's raw frontier index is built before the read model, so ready also means a write will not wait on an index. localCopyArriving stays true for both firstDownload and arriving. A write to such a workspace throws NomosUnavailable(firstDownload) at once, asked once.
LocalCopyReadiness.repairing (CAP-920): a workspace's copy on this device is damaged and being repaired (its local Git history is incomplete, it cannot be read, or it is being refetched). Derived from a read answering localReplicaNotReady with such a reason and from a sync round failing because a commit of the copy is unreadable; held per workspace until a read answers from the copy again or a refetch replaces it. SyncStatus.repairingCopies / ApplicationStatus.repairingCopies list every such workspace with when it was first seen, ApplicationStatus.localCopyRepairing says it of a session, and ApplicationStatus.workspace names a session's workspace. A completed sync round no longer resets a session's localCopy. Status only.
Refresh the bundled Node runner alongside the fixed npm-group release for deterministic compiler Reception encoding. Give the changed runner a new imm
Refresh the packaged Peer Office runner from the shared client source used by the hosted headless application client. The existing text-decoder BOM be
Refresh the packaged Peer Office runner from the shared client source used by the hosted headless application client. The existing text-decoder BOM behavior is explicit; the kernel and Peer Office protocols are unchanged.
Keep the runtime event subscription alive while realm closure waits for preparation source release and acknowledged custody retention, within the existing ten-second disposal deadline.
Refresh outdated Git custody advertisements before rejecting an acknowledged frontier, while preserving ancestry and compare-and-swap safety checks.
Carries the restaged peer runner for the native host 0.68.1 selection (CAP-874); its runtime identity moves with the runtime's patch release.
Carries the 2026.10.2 runtime in the bundled Node peer (CAP-870, CAP-799, CAP-689): a copy whose saved bookmark is stale first asks its workspace's st
off_main at once for a head it does not hold, so a device with local work offers within seconds instead of a minute; kernel selection streams the download and times fetch, verify and store separately.The test cloud's partition proxy (NomosTestCloud) carries live sockets: each workspace's catch-up stream and live offers pass through it while ONLINE,
NomosTestCloud) carries live sockets: each workspace's catch-up
stream and live offers pass through it while ONLINE, and going OFFLINE severs them too (CAP-826).Uses nomos_types 0.14.0; regenerate generated clients with this compiler.
domainRequirements (CAP-666): for each application domain, the law unit and
the generated requirement identity this client was compiled against. NomosApprovedModel carries them to the
model-adoption desk, and the client inventory records them as the build's contract, so an application pinned
to one domain no longer goes stale when a rollout moves a domain it never touches.[birth-child-already-parented], a business birth whose
child already records a different parent. Names are fixed at birth (CAP-803): keyedBirthWorkspace and the
generated open / fetch / watchOpenProgress(key) address a business child by
workspaceNameForKey(namespace, key), exactly as 0.68.0 did, and send no parent. The parent-scoped naming
proposed with CAP-788 is withdrawn before release.key names its child by an id Nomos
mints inside the birth; generated applications open it with openReference / fetchReference / mine()
instead of open(key). An encrypted .owned() birth reserves its minted key first (session.mintId). An
explicit key, key: "<field>", must name a typed-id field and names children exactly as before. When a duplicate birth is refused on the losing peer
([birth-child-already-parented]), the child's creation receipt completes with a NomosOperationRefused
error (new export; NomosOperationStatus.refusal / isRefused).open(key) / fetch(key) / watchOpenProgress(key) take the key's branded type. A
write that changes a birth key is refused (birth-key-write-once).nomosConsoleEnrolmentTimeout); a timeout is a retryable
transport failure, so a slow console no longer holds a person's write (CAP-807).nomosFrameworkChildWorkspaces (behind the
generated mine() / available()) waits out a retryable not-ready answer while the device is still preparing
its copy, as every other one-shot read does, so the caller gets the children or a real error. A write that meets
unfinished preparation is held and reported as NomosWritePhase.preparing, then completes; no client change.Breaking: regenerate generated Dart clients with this compiler.
Breaking: regenerate generated Dart clients with this compiler.
lawUnitSet and
lawPackageSha256 in place of applicationBirthContract, and no generated offer carries a law expectation;
the kernel selects current law from the workspace's own state. OpenReceivingGroupRequest.contract is retired:
a Home is born under the law its platform serves. Pass unitSet to NomosApprovedModel (nomos_types 0.13.0).NmsRowsMerge, NomosRows), and NomosRowProjection redoes only those rows
(CAP-731, CAP-751).CustodianWarmingPosture, not as an error (CAP-769).--dart-define=NOMOS_TRACE=true writes an opt-in [nomos-trace] timeline across the save path (CAP-741).NmsTestPeer stands on an explicit NmsTestPeerHost; NOMOS_TEST_PEER_HOST=native runs AppSim on the
real Apple native host (CAP-717). NOMOS_PEER_CLASSES selects the Node peer's classes, e.g.
personal-device (CAP-722).Bundles the 0.113.4 runtime: owed watch re-reads never starve the Peer Office's maintenance.
Git custody upkeep backing off after a failure is reported as upkeepRetrying, not retrying: the workspace is ready meanwhile, so it no longer shows as
upkeepRetrying, not retrying: the workspace is
ready meanwhile, so it no longer shows as a sync problem (CAP-693).A write sent over the live link has its receipt converge on the custodian's admission: the live desk reports the admitted intent ids of its own batch,
receipt.converged resolves (CAP-656).Retain the completed browser runtime: durable custody receipts, independent WebSocket follows, correct admission of HTTP-relayed sealed offers, and no
Keep the browser Peer Office alive when a shallow outbox reaches omitted ancestry. Request bounded history in the background and let unrelated workspa
Restaged the generated runtime bridge: regenerated vendored runtime assets. Published pub.dev archives are immutable, so regenerated bytes ride their
Restaged the generated runtime bridge: regenerated vendored runtime assets. Published pub.dev archives are immutable, so regenerated bytes ride their
Share the existing typed platform-effect handler with browser background work, so console enrolment, device identity and law acquisition can complete
Prepare delayed workspace enrollment inside Peer Office and retry a proven non-admitted write once. Generated applications can observe preparation whi
Recover sync after loss of the upstream bookmark by fetching provider history and allowing the kernel to verify a shared ancestor. Preserve pending lo
Let reception close promptly when presentation stream listeners are paused.
Resolve the Node runtime runner through @githolon/runtime, the public name for the application runtime package.
@githolon/runtime, the public name for the application runtime package.Generate parent-law authentication cascades that wait for both provider and signer custody, without a child self-enrolment shortcut.
ready plus stable-identity differences, while explicit counterfactual results remain
outside ordinary law adoption.Preserve complete typed birth lineage and recover existing workspaces through the authenticated installed-controller lifecycle without falling back to
Publish the generated nominal application call and query surfaces required by current DSL output, so Flutter consumers retain typed USDA calls instead
Consume the generated typed offer-admission ABI from nomos_types 0.9.0 and keep current birth certificate evidence as structured USDA values rather th
nomos_types 0.9.0 and keep current birth
certificate evidence as structured USDA values rather than JSON envelopes.Recover expired or missing sync credentials from typed failures. Preserve authorization and domain refusals without refreshing credentials based on di
Resolve kernel compatibility through typed OSGi Contract Namespace requirements and OpenUSD candidate custody, removing the private JSON selection and
Restaged with the current kernel candidate: regenerated vendored assets (kernel release identity is baked into them). Published pub.dev archives are i
Keep the typed birth certificate on the birth offer only, so preliminary signer enrolment can settle before generated business APIs open.
Converge arbitrary historical generated-model backlogs while failing a genuinely repeated immutable lifecycle step with a typed stall error.
Prove a restored generated-application device is enrolled before exposing business APIs, including recovery from an interrupted bootstrap journal.
Restage the validated intent-offer byte gate and deterministic signer-posture reader into the immutable Dart runner.
Restaged with the current kernel candidate: regenerated vendored assets (kernel release identity is baked into them). Published pub.dev archives are i
Restaged with the current kernel candidate: regenerated vendored assets (kernel release identity is baked into them). Published pub.dev archives are i
Make https://nomos.cafe the sole default Nomos Cloud surface used by the WebView bridge. The published Dart runtime no longer points at the retired Ca
https://nomos.cafe the sole default Nomos Cloud surface used by the
WebView bridge. The published Dart runtime no longer points at the retired
Captain App hostname.Restaged with the current kernel candidate: regenerated vendored assets (kernel release identity is baked into them). Published pub.dev archives are i
Rebuild the vendored Dart runner from @githolon/client 0.105.8. Web-client source is an input to this immutable pub.dev archive, so the Dart package n
@githolon/client 0.105.8. Web-client source is an input to
this immutable pub.dev archive, so the Dart package now advances whenever that source changes.Restaged with the current kernel candidate: regenerated vendored assets (kernel release identity is baked into them). Published pub.dev archives are i
Rebuild the self-contained runner without the retired structural-interface sidecar assumption; compatibility is carried by the generated client and of
nomos_types 0.8.7 so JSON-valued domain objects retain fields alongside value.connect() no longer manufactures a custody verdict from an unrelated failure. A boot error propagates as itself; nomos.custody.snapshot_corrupt is rai
nomos.custody.snapshot_corrupt is raised only by the snapshot reader that
found the bytes unreadable, so a transient network fault cannot trigger quarantine-and-reclone of
healthy local custody.NEW: Realm.snapshot(name) — export one workspace's exact resident custody without manufacturing a runner session. A generated birth can leave a child
Realm.snapshot(name) — export one workspace's exact resident custody without manufacturing a
runner session. A generated birth can leave a child resident in the shared kernel before
application code acquires it, so host persistence cannot be defined as "every connected session":
mounted, parked and born-but-unopened residents all export. This is what makes a locally-born
estate survive a close.NEW: bridge.localWorkRejectedEvents — a typed stream of NomosLocalWorkRejectedEvent (from nomos_types 0.8.6) forwarded over the runner bridge, so apps
bridge.localWorkRejectedEvents — a typed stream of NomosLocalWorkRejectedEvent (from
nomos_types 0.8.6) forwarded over the runner bridge, so apps render honest UX ("queued, will
retry" vs "preserved for review — contact support") instead of scraping raw refusal prose.parentSignerEnrollment gains remote: true — force the CLOUD-gateway read even when this holon
IS the parent: the seated barrier's proof-by-read (enrolled there ⇒ durably in custody, not merely
locally folded).Rebuild the bundled runner assets from @githolon/client 0.105.3: fixes ensureParentSignerEnrollment routing enrollFirstDevice when the caller is alrea
ensureParentSignerEnrollment
routing enrollFirstDevice when the caller is already connected directly to the target workspace
(parent === workspace) — the local structural lookup can never find it (deliberately absent from
public business OpenAPI), and the framework-route fallback was previously gated to skip exactly this
case.Restaged with the current kernel candidate: regenerated vendored assets (kernel release identity is baked into them). Published pub.dev archives are i
Rebuild the bundled runner assets from @githolon/client 0.104.0 (the evolve-on-read release). Published pub.dev archives are immutable, so regenerated
Rebundle the runner runtime (node-entry.mjs, offline-install.mjs) generated from @githolon/client 0.103.19, which carries the evolve-gate fix: promote
node-entry.mjs, offline-install.mjs) generated from @githolon/client 0.103.19, which carries the evolve-gate fix: promoteDomain dispositions are read from the law that DECLARES the call, so a law upgrade with a genuine field/aggregate removal can pass the offer lane.DomainClientModelAdoptionRequired.accept gains an optional dispositions parameter, threaded through to the bridge's nomosFrameworkAdoptGeneratedModel
DomainClientModelAdoptionRequired.accept gains an optional dispositions parameter, threaded through to the bridge's nomosFrameworkAdoptGeneratedModel — a tenant can now acknowledge a genuine field/aggregate removal ({"retired": [sid, ...]}) from a generated client's model.adopt() decision instead of only via a raw adapter script.