feat(linkedin-studio): RE-R3a — persist relevance score on the store record + rank the morning brief on it [skip-docs]

R3 slice 1 (research-deepening). Stop discarding the relevance judgment the
trend-spotter already computes: persist a 4-field TrendScore {mode, dimensions,
composite, priority} on TrendRecord (schema v2->v3, additive lossless migrate),
computed by the existing score.ts composite()+band() (one owner, no new arithmetic),
threaded item->store; then rankForBrief sorts each bucket composite-first (sentinel
-1 for unscored) and renderBrief surfaces "· <priority> (<mode>)" per body entry
(briefSummary shows the band only). First-sight only; mode-blind ranking with the mode
shown so the operator can disambiguate instruments.

- score.ts: TrendScore + requiredDimensions(mode) (ordered) + scoreEnvelope (composes
  composite+band; throws on bad dim by contract)
- types.ts: SCHEMA_VERSION 2->3; TrendRecord.score?
- store.ts: TrendInput.score?; addTrend persists first-sight (duplicate keeps it);
  migrate comment v1->v2->v3 (logic unchanged, JSON.stringify preserves the field)
- item.ts: TrendItem.score?; normalizeItem validates (non-array score/dimensions + the
  mode's five dims in [1,10]) -> structured error never throw, carries validated dims;
  itemToInput -> scoreEnvelope (no throw on the capture path; direct call throws by contract)
- brief.ts: composite-primary comparator; band+mode render; exact ranking: descriptor
- cli.ts: capture persists score via itemToInput (doc-only); add/score paths unchanged
- agents/trend-spotter.md Step 4.5: capture batch carries the Step-2 dimensions
- gate: TRENDS_TESTS_FLOOR 104->146; new unconditional Section 16j; ASSERT floor 94->99

Tests: trends 146/146 (RED two-phase: logic-RED store/brief/cli; stub-first then
assertion-RED score/item). Gate green (Passed 114 / Failed 0; 113 checks >= 99).
Hook suite 139/139 untouched. Counts 27/19/29 unchanged. No new source file/agent/command.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VmHCQjJHUyWwxGAVVjNLgp

scripts/trends/src/brief.ts

@@ -91,7 +91,14 @@ export function rankForBrief(
     entries.push({ trend, overlap, matchedPillars, effectiveDate, ageDays: ageDaysBetween(effectiveDate, today) });
   }
 
+  // Composite is the PRIMARY within-bucket key (RE-R3a / D2): a higher persisted relevance
+  // composite sorts first; an unscored record uses the sentinel -1 (composite is a weighted
+  // sum of [1,10] dims, so it is always >= 1.0 — -1 sorts unscored last and subtracts
+  // cleanly, where -Infinity - -Infinity = NaN would corrupt the comparator). Buckets are
+  // unchanged; composite only re-orders WITHIN a bucket. The existing overlap → effectiveDate
+  // → title → url chain still gives a total order (the (title,url) pair is the unique dedupe id).
   const cmp = (a: BriefEntry, b: BriefEntry): number =>
+    (b.trend.score?.composite ?? -1) - (a.trend.score?.composite ?? -1) ||
     b.overlap - a.overlap ||
     b.effectiveDate.localeCompare(a.effectiveDate) ||
     a.trend.title.localeCompare(b.trend.title) ||
@@ -124,15 +131,23 @@ export function briefSummary(ranking: BriefRanking): string {
   if (fresh > 0) {
     const top = ranking.topMatches[0] ?? ranking.singleMatches[0];
     const pillar = top.matchedPillars[0];
-    return `${fresh} ferske tema-signaler matcher pillarene dine. Topp: «${top.trend.title}» (${pillar} · ${top.ageDays}d).`;
+    // Band only (no mode) — the mode stays a body-entry detail to keep the one-line headline clean.
+    const band = top.trend.score ? ` · ${top.trend.score.priority}` : "";
+    return `${fresh} ferske tema-signaler matcher pillarene dine. Topp: «${top.trend.title}» (${pillar}${band} · ${top.ageDays}d).`;
   }
   return `Ingen ferske tema-signaler på pillarene dine (av ${ranking.totals.trends} i lager).`;
 }
 
+/** ` · <priority> (<mode>)` when scored, else "" — the band+mode token shared by both renders (RE-R3a). */
+function scoreToken(e: BriefEntry): string {
+  const s = e.trend.score;
+  return s ? ` · ${s.priority} (${s.mode})` : "";
+}
+
 function renderTopEntry(e: BriefEntry, n: number): string[] {
   const lines = [
     `### ${n}. ${e.trend.title}`,
-    `- Kilde: ${e.trend.source} · Publisert: ${e.effectiveDate} (${e.ageDays}d) · Pillarer: ${e.matchedPillars.join(", ")}`,
+    `- Kilde: ${e.trend.source} · Publisert: ${e.effectiveDate} (${e.ageDays}d)${scoreToken(e)} · Pillarer: ${e.matchedPillars.join(", ")}`,
   ];
   if (e.trend.summary) lines.push(`- ${e.trend.summary}`);
   lines.push(`- 🔗 ${e.trend.url}`);
@@ -141,7 +156,7 @@ function renderTopEntry(e: BriefEntry, n: number): string[] {
 }
 
 function renderBulletEntry(e: BriefEntry): string {
-  return `- **${e.trend.title}** — «${e.matchedPillars.join(", ")}» · ${e.effectiveDate} (${e.ageDays}d) · 🔗 ${e.trend.url}`;
+  return `- **${e.trend.title}** — «${e.matchedPillars.join(", ")}» · ${e.effectiveDate} (${e.ageDays}d)${scoreToken(e)} · 🔗 ${e.trend.url}`;
 }
 
 /**
@@ -157,7 +172,7 @@ export function renderBrief(ranking: BriefRanking): string {
   lines.push(`date: ${ranking.today}`);
   lines.push(`summary: ${briefSummary(ranking)}`);
   lines.push(`store: { trends: ${totals.trends}, matched: ${totals.matched}, fresh: ${totals.fresh} }`);
-  lines.push(`ranking: pillar-overlap desc, then publishedAt desc (capturedAt fallback); freshDays ${ranking.freshDays}`);
+  lines.push(`ranking: composite desc, then pillar-overlap desc, then publishedAt desc (capturedAt fallback); freshDays ${ranking.freshDays}`);
   lines.push(`schemaVersion: ${BRIEF_SCHEMA_VERSION}`);
   lines.push("---");
   lines.push("");