Read-Led Cutover — the plan

2 Convex — reshape the panel into a prose read Slice B · convex

Swap the structured items array for an advisor-authored prose read. Public-safe by construction — the only fields are buyer-facing prose the advisor chose to say.

schema.ts — learningPanels

// was: items: v.array(v.object({ label, confidence }))
learningPanels: defineTable({
  userId: v.string(),
  read: v.object({
    summary: v.string(),              // 1–2 sentences, the advisor's voice
    points: v.array(v.string()),      // up to ~3 short bullets (may be empty)
  }),
  updatedAt: v.number(),
}).index("by_user", ["userId"]),

board.ts — setLearningPanel → setRead

export const setRead = internalMutation({
  args: { userId: v.string(),
    summary: v.string(),
    points: v.optional(v.array(v.string())) },
  handler: async (ctx, { userId, summary, points }) => {
    const read = { summary: summary.slice(0, 600),
      points: (points ?? []).slice(0, 4).map((p) => p.slice(0, 160)) };
    const now = Date.now();
    const prev = await ctx.db.query("learningPanels")
      .withIndex("by_user", (q) => q.eq("userId", userId)).unique();
    if (prev) { await ctx.db.patch(prev._id, { read, updatedAt: now }); return { ok: true }; }
    await ctx.db.insert("learningPanels", { userId, read, updatedAt: now });
    return { ok: true };
  },
});

board.ts — cardsForUser returns the read

// replace the learningPanel items mapping (~lines 237–245)
const panel = await ctx.db.query("learningPanels")
  .withIndex("by_user", (q) => q.eq("userId", userId)).unique();
const read = panel?.read ?? null;   // { summary, points } | null
return { cards, read };
// and the empty-user early return becomes: { cards: [], read: null }

5 Convex — the Market Report billboard metrics Slice C · convex

A query that returns the five billboard tiles for a market, computed live from listings + verdicts — reusing the market/active filter that preview already uses (lines ~113–152).

export const marketMetrics = query({
  args: { marketCell: v.optional(v.string()),
    where: v.optional(v.string()) },
  handler: async (ctx, args) => {
    // resolve the same active-in-market listing set `preview` builds
    const active = /* reuse preview's town/active filter */;
    const prices = active.map(l => l.price).sort((a,b)=>a-b);
    const doms = active.map(l => l.daysOnMarket).filter((d):d is number => d!=null).sort((a,b)=>a-b);
    const med = (xs:number[]) => xs.length ? xs[Math.floor((xs.length-1)/2)] : null;
    return {
      onMarket: active.length,
      typicalAsking: med(prices),                                  // $
      medianDom: med(doms),                                        // days
      overRecord: active.filter(l => l.verdict?.category === "overpriced").length,
      honestDeals: active.filter(l => l.verdict?.category === "good").length,
    };
  },
});