feat(usage): count what happened away from a record's own project — the readout #3735 needs

Milestone 385 step 8 (#3735 "a lesson is recalled on a project it was not written on") is defined by opened-on-another-project. The reader's project has been recorded on every usage event since 0c8e109, but nothing compared it with the record's own, so the criterion was still unreadable. - note_usage.usage_for_notes: a second aggregate in the same session joins notes and counts surfaced_away_count / pulled_away_count. Counted only where both projects are known and differ; ranked surfacings only (#2477). The first aggregate is untouched, so events on deleted notes still count. - empty_usage carries both keys zero-filled; every door that attaches usage (list_lessons, get_lesson, snippets, knowledge) gets them through attach_usage. - UsageBadge tooltip says "On other projects: surfaced N×, opened M×" when it happened, and nothing when it did not. - Tests: the mocked split test feeds both aggregates; a unit test for the away counters; a real-Postgres test that home, unreported and ambient events are all left out. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 10:47:03 -04:00
parent 582a5a4f48
commit 2e4c2d9493
4 changed files with 140 additions and 4 deletions
@@ -20,4 +20,9 @@ export interface RecordUsage {
  pull_count: number;
  last_surfaced_at: string | null;
  last_pulled_at: string | null;
+  /** The subsets that happened on a project other than the record's own —
+   *  the evidence it transferred (milestone 385). Notes and snippets carry
+   *  them; rules are global, so their readout does not. */
+  surfaced_away_count?: number;
+  pulled_away_count?: number;
 }