Repository navigation
docs: bring the docs up to 0.14.0 - #99
Merged
Merged
Conversation
SECURITY.md still said publishing was opt-in: since 0.14.0 every served stream takes publishers, so a reachable port is a writable one. The restore fence is 2**20 past a replica's record or 2**40 without one, where seven places said 2**20 alone; SPEC 8b covers the replica-less path, the exact shape and retire-then-revive. The README gains a "Retiring a stream" section, API.md the restore and retire signatures and the StreamRetired and Rejected refusals, and Stream.retired and Stream.retirement each point at the other. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FsSDkeb5rVAxA1FSmKKfQi
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A docs and docstring pass over what 0.14.0 changed. No behaviour changes.
The one that matters:
SECURITY.mdIt still said publishing was "opt-in … and off by default so an upgrade cannot make a server writable on its own". Since 0.14.0, every served stream takes publishers, and only a retired one refuses them. It now says a reachable port is a writable one, so authentication isn't optional, and notes the 0.14.0 change. The in-scope list now names "publish into a retired stream", not "a server where
publish=Truewas not set".Stale
_log,_client,_catchup(a user-facing message),_limits,_stream, and SPEC three times. Since 0.14.0 it's 220 past a replica's record, or 2**40 without one. Each place only needed the number brought up to date; the point (offset gaps are normal) stands.Missing
migrate,restoreandretiresignatures in theStreamblock.restore'sschema,sort_by,config, reserves andrevivewere documented only in its docstring.StreamRetiredandRejectedin the refusals tree.Rejectedhad been missing since remote publishing.Stream.retiredandStream.retirement: each now points at the other. One lists the logs a migration sealed; the other says whether this stream is retired.Gates are clean.
🤖 Generated with Claude Code
https://claude.ai/code/session_01FsSDkeb5rVAxA1FSmKKfQi