docs: tell the name's story — a relay that cannot testify - #115
Merged
Conversation
The rationale for the name has been locked in docs/naming.md since 2026-06-08 and appeared nowhere a user would see it. Tell it in three places, and no more: - README.md gains a short "Why the name?" section next to the security screen, with one line of the Shakespeare layer; - SECURITY.md opens the rendezvous-relay section with the claim it earns — the relay cannot testify to terminal plaintext, while the metadata, registry blobs, and revocation tombstones it does hold stay spelled out unchanged; - docs/naming.md records where the story now ships, so it stays the source rather than the only home. Documentation only: no CLI output, no code, no new claims. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeiotDVE94wEzvc7wcvm1y
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
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
1 participant
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.
The name has had a good rationale since
docs/naming.mdlocked it on2026-06-08, and none of it reached a reader of the product. This tells the
story in three places and stops there.
README.md — a short "Why the name?" section, sized like the "Is it 'P2P
tmux'?" one, placed after the five claims and before the security screen, so
the name lands as the summary of claim 2. One sentence of the Shakespeare
layer for warmth; no theme built on it, and no component renamed.
SECURITY.md — the rendezvous-relay section now opens with "A relay that
cannot testify" and two sentences of the idea, then the existing technical
content follows unchanged. The claim is bounded to terminal plaintext on
purpose: the same paragraph repeats that the relay still sees the metadata
listed below it, still holds encrypted registry blobs while an agent is live,
and still persists owner-signed revocation tombstones. No "the relay stores
nothing" — that overclaim was caught once already in #108. Headings are
untouched, so
SECURITY.md#components-and-truststill resolves.docs/naming.md — a status note recording where the story now ships, so the
file stays the source rather than the only home. Existing content kept.
Documentation only. No CLI output changes, no code.
## Installis untouched,so the
web/test/empty-state.test.jspin againstINSTALL_CMDstill holds.cd go && go test ./...andcd web && npm testboth green (167 web tests).The branch keeps the
114-prefix it was cut with, but this does not close#114 — that one is about
mir-signalreading as Signal the messenger.🤖 Generated with Claude Code
https://claude.ai/code/session_01KeiotDVE94wEzvc7wcvm1y
Note
Low Risk
Documentation-only edits with no runtime, crypto, or install-path changes.
Overview
This PR ships the existing Miranda naming rationale from internal docs into reader-facing material—no code or CLI changes.
README gains a "Why the name?" section (after the five claims, before the security screen): the Miranda warning as “the relay cannot testify” about keystrokes, plus one Tempest line for tone.
SECURITY.md’s rendezvous-relay section now opens with that same framing (“a relay that cannot testify”), then the prior technical bullets follow unchanged. The new copy is explicitly bounded—plaintext only; metadata, encrypted registry blobs, and revocation tombstones are still called out so it does not overclaim “the relay stores nothing.”
docs/naming.mdrecords where the story now lives (README + SECURITY only); it remains the full source record.Reviewed by Cursor Bugbot for commit 23fc859. Bugbot is set up for automated code reviews on this repo. Configure here.