tech-debt: dedupe helpers, surface real errors, prune pass-throughs

.github/workflows/ci.yml

@@ -55,7 +55,6 @@ jobs:
 
       - name: Typecheck
         run: bun run typecheck
-        working-directory: apps/web
 
       - name: Build
         run: bun run build

apps/web/__tests__/lib/strip-markdown.test.ts

@@ -0,0 +1,65 @@
+import { describe, it, expect } from "vitest";
+import { stripMarkdown } from "@/lib/utils/strip-markdown";
+
+describe("stripMarkdown", () => {
+  it("strips heading markers", () => {
+    expect(stripMarkdown("# Hello World")).toBe("Hello World");
+  });
+
+  it("strips bold (**) markers", () => {
+    expect(stripMarkdown("This is **bold** text")).toBe("This is bold text");
+  });
+
+  it("strips italic asterisk markers", () => {
+    expect(stripMarkdown("This is *italic* text")).toBe("This is italic text");
+  });
+
+  it("strips italic underscore markers", () => {
+    expect(stripMarkdown("This is _italic_ text")).toBe("This is italic text");
+  });
+
+  it("strips strikethrough markers", () => {
+    expect(stripMarkdown("This is ~~struck~~ text")).toBe(
+      "This is struck text",
+    );
+  });
+
+  it("strips inline code markers", () => {
+    expect(stripMarkdown("Use `code` here")).toBe("Use code here");
+  });
+
+  it("strips link syntax keeping the label", () => {
+    expect(stripMarkdown("Visit [Straude](https://straude.com) today")).toBe(
+      "Visit Straude today",
+    );
+  });
+
+  it("strips image syntax (link rule consumes the body, leaving the bang)", () => {
+    // The link rule runs before the image rule, so [alt](url) is captured
+    // first — only the leading "!" survives. Locked in to preserve current
+    // OG-card output byte-for-byte.
+    expect(stripMarkdown("Look ![alt](https://x.com/img.png) here")).toBe(
+      "Look !alt here",
+    );
+  });
+
+  it("strips unordered list bullet markers", () => {
+    expect(stripMarkdown("- first item")).toBe("first item");
+  });
+
+  it("strips ordered list markers", () => {
+    expect(stripMarkdown("1. first item")).toBe("first item");
+  });
+
+  it("strips blockquote markers", () => {
+    expect(stripMarkdown("> a quoted line")).toBe("a quoted line");
+  });
+
+  it("collapses double newlines to a single space", () => {
+    expect(stripMarkdown("para one\n\npara two")).toBe("para one para two");
+  });
+
+  it("collapses single newlines to a single space", () => {
+    expect(stripMarkdown("line one\nline two")).toBe("line one line two");
+  });
+});

apps/web/app/admin/components/CodexGrowthCharts.tsx

@@ -16,6 +16,7 @@ import {
   ReferenceLine,
 } from "recharts";
 import { useAdminTheme } from "./AdminShell";
+import { formatDateMonDay as formatDate } from "@/lib/utils/dates";
 
 interface ModelUsageRow {
   date: string;
@@ -29,11 +30,6 @@ const RANGES = [
   { key: "all", label: "All", days: Infinity },
 ] as const;
 
-function formatDate(dateStr: string) {
-  const d = new Date(dateStr + "T00:00:00");
-  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
 function useChartTheme() {
   const { theme } = useAdminTheme();
   const isDark = theme === "dark";

apps/web/app/admin/components/GrowthMetrics.tsx

@@ -10,18 +10,14 @@ import {
   ResponsiveContainer,
 } from "recharts";
 import { useAdminTheme } from "./AdminShell";
+import { formatDateMonDay as formatDate } from "@/lib/utils/dates";
 
 interface GrowthRow {
   date: string;
   signups: number;
   cumulative_users: number;
 }
 
-function formatDate(dateStr: string) {
-  const d = new Date(dateStr + "T00:00:00");
-  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
 export function GrowthMetrics({ data }: { data: GrowthRow[] }) {
   const { theme } = useAdminTheme();
   const isDark = theme === "dark";

apps/web/app/admin/components/ModelShareChart.tsx

@@ -12,6 +12,7 @@ import {
   Legend,
 } from "recharts";
 import { useAdminTheme } from "./AdminShell";
+import { formatDateMonDay as formatDate } from "@/lib/utils/dates";
 
 interface RpcRow {
   date: string;
@@ -40,11 +41,6 @@ const RANGES = [
 
 type DayRow = Record<string, string | number>;
 
-function formatDate(dateStr: string) {
-  const d = new Date(dateStr + "T00:00:00");
-  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
 function Skeleton() {
   return (
     <div className="admin-card">

apps/web/app/admin/components/ModelUsageChart.tsx

@@ -14,6 +14,7 @@ import {
   Legend,
 } from "recharts";
 import { useAdminTheme } from "./AdminShell";
+import { formatDateMonDay as formatDate } from "@/lib/utils/dates";
 
 interface ModelUsageRow {
   date: string;
@@ -35,11 +36,6 @@ const VIEW_MODES: { key: ViewMode; label: string }[] = [
   { key: "daily", label: "Daily" },
 ];
 
-function formatDate(dateStr: string) {
-  const d = new Date(dateStr + "T00:00:00");
-  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
 function formatUsd(value: number) {
   return `$${value.toLocaleString("en-US", { minimumFractionDigits: 0, maximumFractionDigits: 0 })}`;
 }

apps/web/app/admin/components/NorthStarChart.tsx

@@ -11,6 +11,7 @@ import {
   ResponsiveContainer,
 } from "recharts";
 import { useAdminTheme } from "./AdminShell";
+import { formatDateMonDay as formatDate } from "@/lib/utils/dates";
 
 interface SpendRow {
   date: string;
@@ -25,11 +26,6 @@ const RANGES = [
   { key: "all", label: "All", days: Infinity },
 ] as const;
 
-function formatDate(dateStr: string) {
-  const d = new Date(dateStr + "T00:00:00");
-  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
 function formatUsd(value: number) {
   return `$${value.toLocaleString("en-US", { minimumFractionDigits: 0, maximumFractionDigits: 0 })}`;
 }

apps/web/app/admin/components/UserSignupsChart.tsx

@@ -11,6 +11,7 @@ import {
   ResponsiveContainer,
 } from "recharts";
 import { useAdminTheme } from "./AdminShell";
+import { formatDateMonDay as formatDate } from "@/lib/utils/dates";
 
 interface SignupRow {
   date: string;
@@ -23,11 +24,6 @@ const RANGES = [
   { key: "all", label: "All", days: Infinity },
 ] as const;
 
-function formatDate(dateStr: string) {
-  const d = new Date(dateStr + "T00:00:00");
-  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
 function Skeleton() {
   return (
     <div className="admin-card">

apps/web/app/api/embed/[username]/svg/route.ts

@@ -1,4 +1,5 @@
 import { NextRequest } from "next/server";
+import { formatTokens } from "@straude/shared/format";
 import { getServiceClient } from "@/lib/supabase/service";
 import { getProfileShareCardData } from "@/lib/share-assets/profile-card-data";
 import {
@@ -20,13 +21,6 @@ function esc(str: string): string {
     .replace(/"/g, """);
 }
 
-function formatTokens(n: number): string {
-  if (n >= 1_000_000_000) return `${(n / 1_000_000_000).toFixed(1)}B`;
-  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
-  if (n >= 1_000) return `${(n / 1_000).toFixed(1)}k`;
-  return String(n);
-}
-
 // ── SVG gradient workaround ────────────────────────────────────────
 // SVG <rect> doesn't support CSS `linear-gradient()`. We use a
 // <linearGradient> def for the warm background matching the stats card.

apps/web/app/api/users/me/route.ts

@@ -37,8 +37,8 @@ function normalizeProfileLink(value: unknown): string | null {
   let parsed: URL;
   try {
     parsed = new URL(link);
-  } catch {
-    throw new Error("Profile link must be a valid URL");
+  } catch (err) {
+    throw new Error("Profile link must be a valid URL", { cause: err });
   }
 
   if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {

apps/web/app/recap/[username]/page.tsx

@@ -1,7 +1,7 @@
 import { notFound } from "next/navigation";
 import { createClient } from "@/lib/supabase/server";
 import { getServiceClient } from "@/lib/supabase/service";
-import { getRecapData } from "@/lib/utils/recap";
+import { fillContributionDays, getRecapData } from "@/lib/utils/recap";
 import { formatCurrency, formatTokens, getCellColor } from "@/lib/utils/format";
 import type { Metadata } from "next";
 import Link from "next/link";
@@ -61,7 +61,11 @@ export default async function PublicRecapPage({
     profile.streak_freezes ?? 0
   );
 
-  const allDays = fillDays(data.contribution_data, data.total_days, data.period);
+  const allDays = fillContributionDays(
+    data.contribution_data,
+    data.total_days,
+    data.period,
+  );
 
   return (
     <div className="flex min-h-screen flex-col items-center justify-center bg-background p-4">
@@ -228,36 +232,3 @@ export default async function PublicRecapPage({
   );
 }
 
-function fillDays(
-  data: { date: string; cost_usd: number }[],
-  totalDays: number,
-  period: "week" | "month"
-): { date: string; cost_usd: number }[] {
-  const lookup = new Map(data.map((d) => [d.date, d.cost_usd]));
-  const now = new Date();
-  let start: Date;
-
-  if (period === "week") {
-    const day = now.getDay();
-    const mondayOffset = day === 0 ? -6 : 1 - day;
-    start = new Date(now);
-    start.setDate(now.getDate() + mondayOffset);
-  } else {
-    start = new Date(now.getFullYear(), now.getMonth(), 1);
-  }
-
-  // Cap at today — don't render future days
-  const msPerDay = 86400000;
-  const daysSinceStart =
-    Math.floor((now.getTime() - start.getTime()) / msPerDay) + 1;
-  const cappedDays = Math.min(totalDays, daysSinceStart);
-
-  const result: { date: string; cost_usd: number }[] = [];
-  for (let i = 0; i < cappedDays; i++) {
-    const d = new Date(start);
-    d.setDate(start.getDate() + i);
-    const key = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
-    result.push({ date: key, cost_usd: lookup.get(key) ?? 0 });
-  }
-  return result;
-}

apps/web/components/app/feed/ActivityCard.tsx

@@ -7,6 +7,8 @@ import { Avatar } from "@/components/ui/Avatar";
 import { ImageGrid } from "@/components/app/shared/ImageGrid";
 import { ImageLightbox } from "@/components/app/shared/ImageLightbox";
 import { ShareMenu } from "./ShareMenu";
+import { prettifyModel } from "@straude/shared/models";
+export { prettifyModel } from "@straude/shared/models";
 import { cn } from "@/lib/utils/cn";
 import { formatCurrency, formatTokens } from "@/lib/utils/format";
 import { mentionsToMarkdownLinks } from "@/lib/utils/mentions";
@@ -54,26 +56,6 @@ function timeAgo(dateStr: string, usageDate?: string | null) {
   return createdAt.toLocaleDateString("en-US", { month: "short", day: "numeric" });
 }
 
-export function prettifyModel(model: string): string {
-  const normalized = model.trim();
-  if (/claude-opus-4/i.test(normalized)) return "Claude Opus";
-  if (/claude-sonnet-4/i.test(normalized)) return "Claude Sonnet";
-  if (/claude-haiku-4/i.test(normalized)) return "Claude Haiku";
-  // Preserve full OpenAI model names (e.g. gpt-5.3-codex -> GPT-5.3-Codex)
-  if (/^gpt-/i.test(normalized)) {
-    return normalized
-      .replace(/^gpt/i, "GPT")
-      .replace(/-codex$/i, "-Codex");
-  }
-  if (/^o4/i.test(normalized)) return "o4";
-  if (/^o3/i.test(normalized)) return "o3";
-  // Legacy: broader Claude matching
-  if (normalized.includes("opus")) return "Claude Opus";
-  if (normalized.includes("sonnet")) return "Claude Sonnet";
-  if (normalized.includes("haiku")) return "Claude Haiku";
-  return normalized;
-}
-
 function formatModels(
   models: string[] | undefined,
   breakdown: ModelBreakdownEntry[] | null | undefined,

apps/web/components/app/profile/ContributionGraph.tsx

@@ -3,6 +3,7 @@
 import { useState, useCallback } from "react";
 import { cn } from "@/lib/utils/cn";
 import { formatCurrency, getCellColor } from "@/lib/utils/format";
+import { formatDateKey } from "@/lib/utils/dates";
 import { getHeatmapLegend } from "@/lib/share-assets/heatmap";
 import type { ContributionDay } from "@/types";
 
@@ -14,13 +15,6 @@ const STEP = CELL_SIZE + GAP;
 const DAYS = 7;
 const MONTH_LABEL_HEIGHT = 16;
 
-function formatDateKey(d: Date): string {
-  const y = d.getFullYear();
-  const m = String(d.getMonth() + 1).padStart(2, "0");
-  const day = String(d.getDate()).padStart(2, "0");
-  return `${y}-${m}-${day}`;
-}
-
 function formatDateLabel(d: Date): string {
   return d.toLocaleDateString("en-US", {
     month: "long",

apps/web/components/app/profile/ProfileSharePanel.tsx

@@ -3,10 +3,7 @@
 import Image from "next/image";
 import { useEffect, useMemo, useState } from "react";
 import { Check, Copy, Download, ImageIcon } from "lucide-react";
-import {
-  buildProfileIntentUrl,
-  buildProfileShareUrl,
-} from "@/lib/utils/profile-share";
+import { buildProfileIntentUrl } from "@/lib/utils/profile-share";
 
 export function ProfileSharePanel({
   username,
@@ -43,7 +40,8 @@ export function ProfileSharePanel({
 
   useEffect(() => {
     setPublicUrl(
-      shareUrlOverride ?? buildProfileShareUrl(window.location.origin, username)
+      shareUrlOverride ??
+        new URL(`/stats/${username}`, window.location.origin).toString()
     );
     setSupportsClipboardImage(
       typeof ClipboardItem !== "undefined" &&