Skip to content

Design-standard consistency + dead-code cleanup (review #7, #9, #12) - #47

Merged
mayeack merged 1 commit into
mainfrom
claude/caption2-and-cleanup
Jun 2, 2026
Merged

mayeack merged 1 commit into
mainfrom
claude/caption2-and-cleanup

Conversation

@mayeack

@mayeack mayeack commented Jun 2, 2026

Copy link
Copy Markdown
Owner

Summary

Acts on three findings from docs/CODE_REVIEW_2026-06-02.md.

#9 — Resolve .caption2 rule vs. reality

The rule says "never .caption2 for user-facing content" but 24 uses existed. Decision: bump text content to .caption (the documented floor) and carve two narrow, documented exceptions so rule and code finally agree.

  • Bumped (16, text content): ContactListView (count, last-interaction date, met-via name, pill name, "+N"), MergeContactPickerView (email), ActivityListView (calendar source + contact/group counts), SubscriptionView ("BEST VALUE", per-period, renewal disclaimer), SettingsView (store-error help), BackupRestoreView (type/device badges).
  • Exempt (8, now documented in rules.md): inline SF Symbol glyphs (score-trend arrows, filter-chip icons, disclosure chevrons) and Canvas spatial labels (network-graph node names — larger text overlaps nodes). These size an icon or a canvas label, not body text.

#7 — Correct stale "Icon 1 = 48×48"

rules.md described icon1Size as 48×48 with a larger Location row/header. The code has icon1Size = 36, and Locations use the standard 36×36 collection row (verified: no view renders a 48pt badge; icon1Size is referenced only by its own definition). Corrected the Icon-1 section to 36 and replaced the obsolete "Location Row Layout" / "Location Detail Header" sections with "Locations use the standard collection row/header."

#12 — Delete dead code

Blackbook/Services/LocalSyncServer.swift (718 lines) was never instantiated; the live handlers are in BlackbookServer/App/BackupServer.swift. Deleted + regenerated pbxproj.

Notes

  • No .cursor/pages/*.md sync needed — none referenced .caption2.
  • No behavior change beyond a one-tier font bump on metadata. Recommend a quick on-device glance at the Contacts table + Activities rows, since the bump can nudge row heights.

Test plan

  • iOS Simulator: 206 XCTest + 13 Swift Testing pass
  • macOS: build clean
  • xcodegen generate dropped the deleted file's refs
  • CI green
  • (manual) visual check of Contacts/Activities row density

🤖 Generated with Claude Code

Resolves three findings from docs/CODE_REVIEW_2026-06-02.md:

#9 — .caption2 rule vs. reality. Bumped 16 user-facing TEXT sites from .caption2
to .caption (the documented floor): ContactListView (count, last-interaction date,
metVia name, pill name, +N overflow), MergeContactPickerView (email),
ActivityListView (calendar source + contact/group counts + names), SubscriptionView
(BEST VALUE, per-period, renewal disclaimer), SettingsView (store-error help),
BackupRestoreView (type/device badges). rules.md now documents the only two
.caption2 exceptions — inline SF Symbol glyphs (trend arrows, chip icons, chevrons)
and Canvas spatial labels (network-graph node names) — so rule and code agree. The
8 remaining .caption2 uses are exactly those two exempt categories.

#7 — stale "Icon 1 = 48×48". rules.md described icon1Size as 48×48 with a larger
Location row/header for prominence; the code has icon1Size = 36 and Locations use
the standard 36×36 collection row (verified: no view renders a 48pt badge; icon1Size
is referenced only by its own definition). Corrected the Icon 1 section to 36 and
replaced the obsolete "Location Row Layout"/"Location Detail Header" sections with
"Locations use the standard collection row/header."

#12 — dead code. Deleted Blackbook/Services/LocalSyncServer.swift (718 lines). The
class was never instantiated; the live sync handlers are in
BlackbookServer/App/BackupServer.swift. Keeping it invited editing the wrong file
(the exact confusion recorded in the work log for PR #36). Regenerated pbxproj.

No page-doc (.cursor/pages) sync needed — none referenced .caption2. No behavior
change; fonts shift one tier on metadata. iOS 206 + 13 tests pass; macOS builds.
Recommend a quick on-device glance at the Contacts table + Activities rows since
the bump can nudge row heights.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mayeack
mayeack merged commit 33b7687 into main Jun 2, 2026
2 checks passed
@mayeack
mayeack deleted the claude/caption2-and-cleanup branch June 2, 2026 19:44
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