Skip to content

style(vaults): prune narrative comments from the join-links work - #227

Merged
kipavy merged 1 commit into
devfrom
chore/prune-comments
Sep 8, 2026
Merged

kipavy merged 1 commit into
devfrom
chore/prune-comments

Conversation

@kipavy

@kipavy kipavy commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #226. That code narrated itself — block headers restating what the next lines do, multi-line rationale that belongs in the commit message, and JSDoc on obvious test helpers. It also matched the dense commenting of the surrounding vault-share files, which is not the style to copy.

243 comment lines out, 54 in (most of those the shortened replacements). No behaviour change.

What stays is the load-bearing kind only, one or two lines each:

  • why the key-holder check lives in the button path rather than in distributeKeyToNewMember
  • why the expiry unit floors but the count rounds
  • why vaultId can be a team id
  • why fetchAuthRateLimited is not folded into fetchAuthJson
  • that a link carries membership and never the vault key
  • the account_id / KDF-salt constraint on the deep-link codec

tsc clean; 1381 tests across vault-share, terminal, layout, members and services pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_014gY5k7XbeR5zoTXdzsuWxF

The #226 code narrated itself: block headers restating what the next lines
do, multi-line rationale that belongs in the commit message, and JSDoc on
obvious test helpers. It also matched the dense commenting of the
surrounding vault-share files, which is not the house style to copy.

What stays is the load-bearing kind only, one or two lines each: why the
key-holder check happens in the button path rather than in
distributeKeyToNewMember, why the expiry unit floors but the count rounds,
why vaultId can be a team id, why fetchAuthRateLimited is not folded into
fetchAuthJson, and that a link carries membership and never the vault key.

No behaviour change; 1381 tests across the touched suites pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014gY5k7XbeR5zoTXdzsuWxF
@kipavy
kipavy merged commit adc007a into dev Sep 8, 2026
4 checks passed
@kipavy
kipavy deleted the chore/prune-comments branch September 8, 2026 11:35
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