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/store.ts

@@ -19,6 +19,7 @@ import { createHash } from "node:crypto";
 
 import { SCHEMA_VERSION } from "./types.js";
 import type { TrendStore, TrendRecord, TrendQueryHit } from "./types.js";
+import type { TrendScore } from "./score.js";
 
 export { SCHEMA_VERSION } from "./types.js";
 
@@ -32,6 +33,8 @@ export interface TrendInput {
   publishedAt?: string;
   topics: string[];
   summary?: string;
+  /** The persisted relevance envelope (RE-R3a), if the caller computed one. First-sight, never updated on re-capture. */
+  score?: TrendScore;
 }
 
 export interface AddResult {
@@ -76,10 +79,11 @@ export function emptyStore(): TrendStore {
 export function loadStore(path: string): TrendStore {
   if (!existsSync(path)) return emptyStore();
   const parsed = JSON.parse(readFileSync(path, "utf8")) as Partial<TrendStore>;
-  // Forward migrate-on-load: stamp to the current version, never downgrade. v1→v2 is
-  // purely additive-optional (an old record is already a valid v2 record that simply
-  // lacks the optional publishedAt), so the migration is the version stamp alone —
-  // records pass through untouched (lossless + idempotent for any well-formed store).
+  // Forward migrate-on-load: stamp to the current version, never downgrade. v1→v2→v3 are
+  // all purely additive-optional (an old record is already a valid v3 record that simply
+  // lacks the optional publishedAt [v2] / score [v3]), so the migration is the version
+  // stamp alone — records pass through untouched (lossless + idempotent for any
+  // well-formed store; a new optional field survives JSON.stringify on resave).
   // A string / NaN / absent version coerces to the current version (never crashes); the
   // non-array `trends` coercion below is unchanged and out of the losslessness claim.
   const onDisk = typeof parsed.schemaVersion === "number" ? parsed.schemaVersion : SCHEMA_VERSION;
@@ -134,6 +138,7 @@ export function addTrend(store: TrendStore, input: TrendInput): AddResult {
     ...(input.publishedAt !== undefined ? { publishedAt: input.publishedAt } : {}),
     topics: [...input.topics],
     ...(input.summary !== undefined ? { summary: input.summary } : {}),
+    ...(input.score !== undefined ? { score: input.score } : {}),
   };
   store.trends.push(trend);
   return { store, added: true, merged: false };