Skip to content

refactor(persona): the copy outside the pane speaks the vocabulary too - #281

Merged
stormer78 merged 1 commit into
mainfrom
fix/persona-vocabulary-join-flow
Sep 7, 2026
Merged

refactor(persona): the copy outside the pane speaks the vocabulary too#281
stormer78 merged 1 commit into
mainfrom
fix/persona-vocabulary-join-flow

Conversation

@stormer78

Copy link
Copy Markdown
Contributor

Third of three PRs bringing the persona vocabulary into sync across the stack:

  • verifiable-trust-infrastructure#1291 — pnm persona …
  • vta-browser-plugin#183 — the console's persona pane (which was also stale)
  • this one — the OpenVTC copy outside the identity pane

#280 brought the pane over and left the rest for "when next touched".

What changed

The join flow's identity choice — "Who should this community know you as?",
"Choose the persona this community will know you as", "Already known to:",
"Be someone new to this community" — the invitation list, and the communities
panel's empty state.

The reuse warning is the one that matters. It is the last thing a person
reads before linking themselves across two communities, and it now carries the
table's sentence verbatim:

Being known here as "Work me" makes you the same person to anyone who sees
both this community and the others using it.

The point of a fixed phrase is that meeting it twice teaches it. A paraphrase in
one surface spends the recognition and gives nothing back.

What I deliberately left alone

profile in setup, backup and --profile. That is the config profile — a
local installation profile that predates the persona family, has its own meaning
to operators, and appears in a flag they type. It is exactly the collision the
vocabulary doc cites when it declines to use "profile" for a face; renaming it
here would manufacture the confusion the table exists to prevent.

Pre-merge checklist (vti-stack-development-guide §9)

- [x] No new clients/timeouts (R1.2) — copy only
- [x] No lock held across a network await (R1.3)
- [x] No local state before its remote effect (R2.1)
- [x] Retries bounded (R1.4) — none added
- [x] Loops survive transient errors (R1.5) — n/a
- [x] Acks after durable handoff (R1.6) — n/a
- [x] Wire types (R3.*) — none changed
- [x] Config absence = most restrictive (R5.*) — unchanged
- [x] Logs/status claim only what was verified (R6.*) — the linkage warning
      keeps its exact claim, in the shared wording
- [x] "Process dies on the next line" (R2.1) — n/a
- [x] Deviations — none

cargo test --workspace green (426 in the binary); clippy -D warnings clean.

#280 brought the identity pane to `design-docs/persona-vocabulary.md` and left
the persona copy elsewhere for when it was next touched. This is that copy: the
join flow's identity choice, its reuse warning, the invitation list, and the
communities panel's empty state.

The reuse warning is the one that matters. It is the last thing a person reads
before linking themselves across two communities, and it now carries the
sentence the table asks every surface to share verbatim — "the same person to
anyone who sees both" — rather than a paraphrase of it. The point of a fixed
phrase is that meeting it twice teaches it; a paraphrase in one surface spends
the recognition and gives nothing back.

## What was deliberately left alone

`profile` in setup, backup and `--profile`. That is the **config profile** — a
local installation profile that predates the persona family, has its own
meaning to operators, and appears in flags they type. It is exactly the collision
the vocabulary doc cites when it declines to use "profile" for a face, and
renaming it here would create the confusion the table exists to prevent.

Signed-off-by: Glenn Gore <glenn.g@affinidi.com>
@stormer78
stormer78 requested a review from a team as a code owner September 7, 2026 13:17
@stormer78
stormer78 merged commit 55cf2b1 into main Sep 7, 2026
14 checks passed
@stormer78
stormer78 deleted the fix/persona-vocabulary-join-flow branch September 7, 2026 14:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant