NEC-131: User guide: seven screenshots by hand, and fourteen facts to verify #198

Merged

nectenda-agent merged 5 commits from worktree-nec-131-user-guide-seven-screenshots-by-hand-and into main 2026-09-28 15:14:02 +01:00

Conversation 0 Commits 5 Files changed 23 +477 -52

nectenda-agent commented 2026-09-27 15:52:28 +01:00

Collaborator

Copy link

Task: NEC-131 — https://projectron.nerchure.com/tasks/131

Settles ten of the user guide's fourteen verify notes against the code. Share links and the status-icon colours were wrong and are corrected; the other pages now say what the code does, and the four that need a device, Obsidian's UI or a new support path (NEC-138) stay as notes, with one added for immediate cancellation. Six of the seven pending screenshots now come from docs-shots.mts --guides (file-marks is staged, and says so), and sync-status-icons-1 is now the status menu its caption describes. Only Obsidian's own plugin browser is left for a person. guide-labels.test.mjs now fails on a missing guide image and on exact plugin labels (Share link, Copy, Turn on). Ride-along NEC-139: security-model.md no longer implies content keys are rotated, and a claims test defends the admission. Review follow-up filed as NEC-142 (possible billing bug, Backlog).

Spec: docs/changes/NEC-131-user-guide-shots-and-facts/spec.md

Also fixes NEC-139: security-model.md implies content-key rotation exists; nothing rotates a folder key

Changelog

NONE

Task: NEC-131 — https://projectron.nerchure.com/tasks/131 Settles ten of the user guide's fourteen verify notes against the code. Share links and the status-icon colours were wrong and are corrected; the other pages now say what the code does, and the four that need a device, Obsidian's UI or a new support path (NEC-138) stay as notes, with one added for immediate cancellation. Six of the seven pending screenshots now come from docs-shots.mts --guides (file-marks is staged, and says so), and sync-status-icons-1 is now the status menu its caption describes. Only Obsidian's own plugin browser is left for a person. guide-labels.test.mjs now fails on a missing guide image and on exact plugin labels (Share link, Copy, Turn on). Ride-along NEC-139: security-model.md no longer implies content keys are rotated, and a claims test defends the admission. Review follow-up filed as NEC-142 (possible billing bug, Backlog). Spec: `docs/changes/NEC-131-user-guide-shots-and-facts/spec.md` Also fixes NEC-139: security-model.md implies content-key rotation exists; nothing rotates a folder key ## Changelog NONE

nectenda-agent added the

area:docs

label 2026-09-27 15:52:28 +01:00

nectenda-agent added 5 commits 2026-09-27 15:52:28 +01:00

Settle ten of the guides' verify notes against the code ... 713ac02b33

Two pages were wrong. Share links has Replace…, Turn off… and Turn on on
the organisation's page, and a leaked link wants Replace, because turning
it off and on brings back the same link. The status icon also goes red
for an ended session, and faint grey when disconnected or moving servers.

The rest now say what the code does. Nothing changes a person's key.
Removing someone does not rotate the folder key. Signing out keeps the
device slot. Nothing prunes backups, but a conflict copy someone else
deletes goes to .trash. The attachment budget applies on every device.
Plan changes apply on the payment webhook and retry hourly, and a
cancellation takes effect at the end of the period. Losing both passphrase
and recovery key is a support question until NEC-138.

Task: NEC-131

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018cKNtJ2rCnNAtBY58Lhtof

Say in the security model that folder keys are not rotated ... 8c2e50cd3e

"Key rotation limits the window" read as though rotation existed. Nothing
rotates a content key: every folder keeps its v1 key for life, including
after a member is removed. The document now says so, and the claims test
holds the admission in place until something rotates.

Task: NEC-131
Also-fixes: NEC-139

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018cKNtJ2rCnNAtBY58Lhtof

Shoot six more guide screenshots, and fail on a missing one ... e7d6b7b1ba

docs-shots.mts now takes the recover and save-recovery-key dialogs
through the real sign-in screen, the plan picker from a price-only
merchant, the device-limit page from the shard's own session and roster
calls, and a second vault's caret and name in the shared note. The five
file-explorer marks are staged, and say so: five states cannot exist at
once. sync-status-icons-1 is now the status menu its caption describes.

Only Obsidian's own plugin browser is left for a person. The label test
now fails when a guide shows an image that does not exist and is not
on the hand-taken list, and when a hand-taken one arrives but is still
listed.

Task: NEC-131

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018cKNtJ2rCnNAtBY58Lhtof

Name the presigned-URL window after a removal ... 79e2c6c344

A removed member is stopped by the server no longer serving them, except
for an attachment download link already issued, which lasts until it
expires (an hour by default).

Task: NEC-131
Also-fixes: NEC-139

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018cKNtJ2rCnNAtBY58Lhtof

Tighten three guides and two checks after review ... 4d0be6c361

The attachment budget is learned from a crash, not a 100 MB threshold
that no hosted plan can exceed. Recovering from a signed-in device means
signing out first, and folders are re-added after. Only a cancellation
scheduled for the end of the period waits until then; whether the
provider offers an immediate one is left as a note.

The label test now also checks Share link, Copy and Turn on as whole
literals, since rule 2 cannot see labels with no ellipsis. docs-shots
--guides throws on a lost shot instead of leaving the old image.

Task: NEC-131

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018cKNtJ2rCnNAtBY58Lhtof

cruelacid force-pushed worktree-nec-131-user-guide-seven-screenshots-by-hand-and from 4d0be6c361 to b7d3b5adad 2026-09-28 15:08:01 +01:00 Compare

nectenda-agent merged commit b7d3b5adad into main 2026-09-28 15:14:02 +01:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

area:docs

docs/

  

area:identity

packages/identity

  

area:ops

deploy/, CI, hosting

  

area:plugin

packages/plugin

  

area:server

packages/server

  

channel:community

Obsidian forum, Obsidian Discord, Reddit

  

channel:direct

Cold outreach to named firms

  

channel:owned

nectenda.com pages, the feedback board

  

channel:press

Hacker News, newsletters, outlets, YouTube creators

  

channel:social

Bluesky, Mastodon, X, YouTube accounts

  

e2ee-constrained

End-to-end encryption changes the shape of the answer

  

gate:at-ga

Held until Gates A-C close and terms/privacy leave DRAFT

  

gate:pre-ga

Safe to do before the launch gates close

  

marketing

Reach and positioning; work published off nectenda.com

  

parity

Relay feature-parity programme

  

relay:absent

4 - Not supported, not requested, not planned at Relay

  

relay:planned

2 - On Relay's roadmap (Active/Planned) or has an open PR

  

relay:requested

3 - Asked for by Relay users or under 'Considering'; not committed

  

relay:supported

1 - Relay ships this today

  

risk:additive

New message type, table or column; backward compatible

  

risk:contract

Changes something existing accounts or stored data depend on

  

risk:none

Client-only; the server is untouched

  

usability

How the product is understood and learned, not what it does

No labels

area:docs

area:identity

area:ops

area:plugin

area:server

channel:community

channel:direct

channel:owned

channel:press

channel:social

e2ee-constrained

gate:at-ga

gate:pre-ga

marketing

parity

relay:absent

relay:planned

relay:requested

relay:supported

risk:additive

risk:contract

risk:none

usability

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

Nectenda/nectenda!198

No description provided.