Skip to content

Features: suggested records, click-to-sort columns, hidden-filter chokepoint - #51

Merged
mayeack merged 2 commits into
mainfrom
claude/features-suggestions-sort-notifications
Jun 4, 2026
Merged

mayeack merged 2 commits into
mainfrom
claude/features-suggestions-sort-notifications

Conversation

@mayeack

@mayeack mayeack commented Jun 4, 2026

Copy link
Copy Markdown
Owner

Three of the five requested features (recreated against `main` after the stacked base branch was deleted on #48 merge; supersedes #49). Notifications + archive follow.

2a — Three suggested records in contact pickers

New `ContactSuggestionEngine` ranks candidates by shared tags (×3), groups (×2), locations (×2) + a per-field signal, with a relationship-score fallback so suggestions are always available. `IntroducedToPickerView` / `MetViaPickerView` show a Suggested section (top 3) when not searching.

2b — Click column headers to sort

`ContactListViewModel` gains `sortColumn` + `sortAscending` + `toggleSort()`. Clicking a header sorts by it; clicking the active column flips direction (▲/▼). String columns sort by first value with blanks last; numeric columns default descending.

2e — Hidden contacts excluded from every search surface

Audit found every surface already filtered. Added a single `Sequence.selectable` chokepoint + adopted it in the pickers/VM + regression test.

Tests

`ContactSuggestionEngineTests` + `ContactListViewModelTests`. Full macOS suite green (226 tests).

🤖 Generated with Claude Code

Michael Yeack and others added 2 commits June 3, 2026 17:53
…he score

Two app-breaking issues, shipped together as an urgent hotfix.

1. Import-All crash / app won't reopen
   ContactSyncService imported on the MAIN ModelContext and saved once there.
   "Import All" inserts hundreds of Contacts; that main-context save fires
   ContactListView's @query mid-transaction and faults the Contact.interactions
   inverse (EXC_BAD_ACCESS) — the exact failure PR #43 fixed for the pull path.
   Because startAutoSync re-imports on every .onAppear, it became a crash loop
   so the app couldn't reopen.
   Fix: importContacts/importSelected apply mergeOrInsert on a background
   ModelContext (autosaveEnabled=false) with a single settled save, so the main
   context's @queries only ever see one committed state. startAutoSync also
   defers the launch import by 1s so the first frame renders first. Posts
   .blackbookSyncDidComplete after import so the Dashboard refetches.

2. Recent interactions don't raise the relationship score (Hugo Dooner)
   The score reads the denormalized Contact.lastInteractionDate. Synced
   iMessage interaction *records* arrive cleanly, but the contact-field update
   carrying lastInteractionDate is rejected by conflict resolution when the
   local copy is newer + pending — so recency stays 0 and the score sits at
   priority-only (exactly 20 / "Fading").
   Fix: RelationshipScoreEngine.recalculateAll now re-derives each contact's
   lastInteractionDate from the Interaction records this device already holds
   (single FetchDescriptor<Interaction>, grouped by the to-one
   interaction.contact?.id — the same controlled pattern the server uses; never
   touches the faulting Contact.interactions inverse), taking max() so a newer
   manual date is never lowered. recalculateAll is now also invoked right after
   each sync pull on the background context, so scores refresh regardless of the
   visible tab (on macOS the Dashboard's own recalc wouldn't run otherwise).

Tests: +3 regression cases in RelationshipScoreEngineTests covering the
heal-from-records behavior (stale date healed, priority contact recovers above
the boost, newer manual date preserved). Full macOS suite green (220 tests).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…en-filter chokepoint

Three of the five requested features (notifications + archive-on-import follow in PR 3).

2a. Three suggested records in contact pickers
New ContactSuggestionEngine ranks candidates by contextual similarity to the subject
— shared tags (x3), groups (x2), locations (x2), plus a per-field signal — and falls
back to relationship score so suggestions are always available. IntroducedToPickerView
and MetViaPickerView now show a "Suggested" section (top 3) when not searching, with the
rest under "All Contacts".

2b. Click column headers to sort
ContactListViewModel gains sortColumn + sortAscending and toggleSort(): clicking a
header sorts by that column; clicking the active column flips direction. The active
column shows a chevron. Sorts Name, Score, Groups, Locations, Tags, Met via, Introduced
to (string columns sort their first value alphabetically with blanks last; numeric
columns default to descending). The sort menu was updated to the same model and keeps
Recent/Added. Replaces the old ContactSortOrder enum.

2e. Hidden contacts excluded from every search surface
Audit found all selection surfaces already filtered !isHidden && !isMergedAway. Added a
single chokepoint — `Sequence<Contact>.selectable` — and adopted it in the contact
pickers and ContactListViewModel so the CLAUDE.md rule has one enforcement point.
(A hidden contact still appearing on another device is sync propagation, not a missing
filter — same conflict-resolution family as the score fix in PR #48.)

Tests: ContactSuggestionEngineTests (ranking, exclusions, score fallback) and
ContactListViewModelTests (+toggle direction, string-column blanks-last, .selectable).
Full macOS suite green (226 tests).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mayeack
mayeack merged commit 72333ad into main Jun 4, 2026
2 checks passed
@mayeack
mayeack deleted the claude/features-suggestions-sort-notifications branch June 4, 2026 03:16
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