@agent-native/core 0.69.0 → 0.70.0

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/index.tsx

@@ -48,6 +48,7 @@ import {
   DropdownMenu,
   DropdownMenuContent,
   DropdownMenuItem,
+  DropdownMenuLabel,
   DropdownMenuSeparator,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
@@ -995,53 +996,107 @@ export default function SqlDashboardPage() {
             </Button>
           </AddPanelPopover>
         ) : null}
-        {canEdit || canManage ? (
-          <DropdownMenu>
-            <Tooltip>
-              <TooltipTrigger asChild>
-                <DropdownMenuTrigger asChild>
-                  <Button
-                    size="sm"
-                    variant="ghost"
-                    className="text-muted-foreground hover:text-foreground"
-                    aria-label="Dashboard actions"
-                  >
-                    <IconDots className="h-4 w-4" />
-                  </Button>
-                </DropdownMenuTrigger>
-              </TooltipTrigger>
-              <TooltipContent>More actions</TooltipContent>
-            </Tooltip>
-            <DropdownMenuContent align="end" className="w-44">
-              {canEdit && !archivedAt ? (
-                <DropdownMenuItem
-                  onSelect={(event) => {
-                    event.preventDefault();
-                    void handleArchive();
-                  }}
-                >
-                  <IconArchive className="mr-2 h-3.5 w-3.5" />
-                  Archive
-                </DropdownMenuItem>
-              ) : null}
-              {canEdit && !archivedAt && canManage ? (
-                <DropdownMenuSeparator />
-              ) : null}
-              {canManage ? (
-                <DropdownMenuItem
-                  onSelect={(event) => {
-                    event.preventDefault();
-                    setConfirmDeleteOpen(true);
-                  }}
-                  className="text-destructive focus:text-destructive"
+        <DropdownMenu>
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <DropdownMenuTrigger asChild>
+                <Button
+                  size="sm"
+                  variant="ghost"
+                  className="text-muted-foreground hover:text-foreground"
+                  aria-label="Dashboard details and actions"
                 >
-                  <IconTrash className="mr-2 h-3.5 w-3.5" />
-                  Delete permanently
-                </DropdownMenuItem>
-              ) : null}
-            </DropdownMenuContent>
-          </DropdownMenu>
-        ) : null}
+                  <IconDots className="h-4 w-4" />
+                </Button>
+              </DropdownMenuTrigger>
+            </TooltipTrigger>
+            <TooltipContent>Details</TooltipContent>
+          </Tooltip>
+          <DropdownMenuContent align="end" className="w-56">
+            <DropdownMenuLabel className="font-normal">
+              <div className="flex flex-col gap-1.5 text-xs text-muted-foreground">
+                {dashboardUpdatedAt && (
+                  <span className="flex items-center gap-1.5">
+                    <IconClock className="h-3 w-3" />
+                    Updated{" "}
+                    {new Date(dashboardUpdatedAt).toLocaleDateString("en-US", {
+                      year: "numeric",
+                      month: "short",
+                      day: "numeric",
+                    })}
+                  </span>
+                )}
+                {dashboardOwner && (
+                  <span className="flex items-center gap-1.5">
+                    <IconUser className="h-3 w-3" />
+                    {dashboardOwner.split("@")[0]}
+                  </span>
+                )}
+                {dashboardVisibility ? (
+                  <span
+                    className={`flex items-center gap-1.5 font-medium ${
+                      dashboardVisibility === "public"
+                        ? "text-green-600"
+                        : dashboardVisibility === "org"
+                          ? "text-blue-600"
+                          : "text-yellow-600"
+                    }`}
+                  >
+                    <span
+                      className={`h-1.5 w-1.5 rounded-full ${
+                        dashboardVisibility === "public"
+                          ? "bg-green-500"
+                          : dashboardVisibility === "org"
+                            ? "bg-blue-500"
+                            : "bg-yellow-500"
+                      }`}
+                    />
+                    {dashboardVisibility === "public"
+                      ? "Public"
+                      : dashboardVisibility === "org"
+                        ? "Shared with org"
+                        : "Private"}
+                  </span>
+                ) : null}
+                {hiddenAt && (
+                  <span className="flex items-center gap-1.5 font-medium text-amber-600 dark:text-amber-400">
+                    <IconEyeOff className="h-3 w-3" />
+                    Hidden
+                  </span>
+                )}
+              </div>
+            </DropdownMenuLabel>
+            {(canEdit && !archivedAt) || canManage ? (
+              <DropdownMenuSeparator />
+            ) : null}
+            {canEdit && !archivedAt ? (
+              <DropdownMenuItem
+                onSelect={(event) => {
+                  event.preventDefault();
+                  void handleArchive();
+                }}
+              >
+                <IconArchive className="mr-2 h-3.5 w-3.5" />
+                Archive
+              </DropdownMenuItem>
+            ) : null}
+            {canEdit && !archivedAt && canManage ? (
+              <DropdownMenuSeparator />
+            ) : null}
+            {canManage ? (
+              <DropdownMenuItem
+                onSelect={(event) => {
+                  event.preventDefault();
+                  setConfirmDeleteOpen(true);
+                }}
+                className="text-destructive focus:text-destructive"
+              >
+                <IconTrash className="mr-2 h-3.5 w-3.5" />
+                Delete permanently
+              </DropdownMenuItem>
+            ) : null}
+          </DropdownMenuContent>
+        </DropdownMenu>
         {canManage ? (
           <AlertDialog
             open={confirmDeleteOpen}
@@ -1152,59 +1207,6 @@ export default function SqlDashboardPage() {
           </Button>
         </Alert>
       ) : null}
-      {/* Author, last updated, and visibility metadata */}
-      <div className="flex flex-wrap items-center gap-3 text-xs text-muted-foreground">
-        {hiddenAt && (
-          <span className="flex items-center gap-1.5 font-medium text-amber-600 dark:text-amber-400">
-            <IconEyeOff className="h-3 w-3" />
-            Hidden
-          </span>
-        )}
-        {dashboardUpdatedAt && (
-          <span className="flex items-center gap-1">
-            <IconClock className="h-3 w-3" />
-            Updated{" "}
-            {new Date(dashboardUpdatedAt).toLocaleDateString("en-US", {
-              year: "numeric",
-              month: "short",
-              day: "numeric",
-            })}
-          </span>
-        )}
-        {dashboardOwner && (
-          <span className="flex items-center gap-1">
-            <IconUser className="h-3 w-3" />
-            {dashboardOwner.split("@")[0]}
-          </span>
-        )}
-        {dashboardVisibility ? (
-          <span
-            className={`flex items-center gap-1.5 font-medium ${
-              dashboardVisibility === "public"
-                ? "text-green-600"
-                : dashboardVisibility === "org"
-                  ? "text-blue-600"
-                  : "text-yellow-600"
-            }`}
-          >
-            <span
-              className={`h-1.5 w-1.5 rounded-full ${
-                dashboardVisibility === "public"
-                  ? "bg-green-500"
-                  : dashboardVisibility === "org"
-                    ? "bg-blue-500"
-                    : "bg-yellow-500"
-              }`}
-            />
-            {dashboardVisibility === "public"
-              ? "Public"
-              : dashboardVisibility === "org"
-                ? "Shared with org"
-                : "Private"}
-          </span>
-        ) : null}
-      </div>
-
       {/* Description (click to edit) */}
       {editingDescription && canEdit ? (
         <Textarea

package/corpus/templates/analytics/app/pages/overview/OverviewPage.tsx

@@ -134,7 +134,7 @@ export default function OverviewPage() {
               key={`${item.type}:${item.id}`}
               to={
                 item.type === "dashboard"
-                  ? `/adhoc/${item.id}`
+                  ? `/dashboards/${item.id}`
                   : `/analyses/${item.id}`
               }
               className="block"

package/corpus/templates/analytics/app/routes/adhoc.$id.tsx

@@ -1,9 +1,22 @@
-import AdhocRouter from "@/pages/adhoc/AdhocRouter";
+import { redirect, type LoaderFunctionArgs } from "react-router";
 
-export function meta() {
-  return [{ title: "Dashboard — Analytics" }];
+// `/adhoc/:id` is the legacy dashboard URL. The canonical, user-facing URL is
+// now `/dashboards/:id`. Forward old links (bookmarks, deep links, query
+// params like `?id=` and `?config=`) to the canonical path so nothing breaks.
+function target({ request, params }: LoaderFunctionArgs): string {
+  const url = new URL(request.url);
+  const id = params.id ?? "";
+  return `/dashboards/${encodeURIComponent(id)}${url.search}${url.hash}`;
 }
 
-export default function AdhocRoute() {
-  return <AdhocRouter />;
+export function loader(args: LoaderFunctionArgs) {
+  throw redirect(target(args));
+}
+
+export function clientLoader(args: LoaderFunctionArgs) {
+  throw redirect(target(args));
+}
+
+export default function AdhocRedirectRoute() {
+  return null;
 }

package/corpus/templates/analytics/app/routes/catalog.tsx

@@ -76,7 +76,7 @@ function dashboardPathForTemplate(
   if (template.id === "demo-node-exporter") {
     return demoNodeExporterDashboardPath(dashboardId, options);
   }
-  return `/adhoc/${dashboardId}`;
+  return `/dashboards/${dashboardId}`;
 }
 
 function sourceLabel(source: string): string {

package/corpus/templates/analytics/app/routes/dashboards.$id.tsx

@@ -0,0 +1,9 @@
+import AdhocRouter from "@/pages/adhoc/AdhocRouter";
+
+export function meta() {
+  return [{ title: "Dashboard — Analytics" }];
+}
+
+export default function DashboardRoute() {
+  return <AdhocRouter />;
+}

package/corpus/templates/analytics/app/routes/traffic.tsx

@@ -1,6 +1,6 @@
 import { redirect, type LoaderFunctionArgs } from "react-router";
 
-const TRAFFIC_DASHBOARD_PATH = "/adhoc/agent-native-templates-first-party";
+const TRAFFIC_DASHBOARD_PATH = "/dashboards/agent-native-templates-first-party";
 
 function target(request: Request): string {
   const url = new URL(request.url);

package/corpus/templates/analytics/changelog/2026-06-23-the-dashboards-and-analyses-sidebar-settings-buttons-now-sta.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-23
+---
+
+The Dashboards and Analyses sidebar settings buttons now stay hidden until you hover the section, for a cleaner sidebar

package/corpus/templates/analytics/seeds/dashboards/agent-native-templates-first-party.json

@@ -187,6 +187,151 @@
         "yKey": "count",
         "color": "#10b981"
       }
+    },
+    {
+      "id": "virality-referrals-section",
+      "title": "Virality & Referrals",
+      "chartType": "section",
+      "width": 1,
+      "columns": 3,
+      "config": {
+        "description": "Signups attributed to shared clips and plans, who is driving referrals, and the share view to click to signup funnel. referral_* and utm_* fields are read from the signup event's properties JSON; share_view and share_cta_click track shared-surface engagement."
+      }
+    },
+    {
+      "id": "referred-signups-30d",
+      "title": "Referred Signups (30d)",
+      "chartType": "metric",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT COUNT(*) AS count FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '30 days' AND properties::jsonb ->> 'referral_source' IS NOT NULL AND properties::jsonb ->> 'referral_source' <> '' AND properties::jsonb ->> 'referral_source' <> 'direct'",
+      "config": {
+        "yKey": "count",
+        "yFormatter": "number",
+        "description": "Signups in the last 30 days with a non-direct referral_source (clip_share, plan_share, external)."
+      }
+    },
+    {
+      "id": "viral-signup-share-30d",
+      "title": "Viral Signup Share (30d)",
+      "chartType": "metric",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT CASE WHEN COUNT(*) = 0 THEN 0 ELSE 1.0 * COUNT(*) FILTER (WHERE properties::jsonb ->> 'referral_source' IS NOT NULL AND properties::jsonb ->> 'referral_source' <> '' AND properties::jsonb ->> 'referral_source' <> 'direct') / COUNT(*) END AS rate FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '30 days'",
+      "config": {
+        "yKey": "rate",
+        "yFormatter": "percent",
+        "description": "Headline virality number: referred signups divided by all signups over the last 30 days."
+      }
+    },
+    {
+      "id": "clip-share-signups-30d",
+      "title": "Clip-Share Signups (30d)",
+      "chartType": "metric",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT COUNT(*) AS count FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '30 days' AND properties::jsonb ->> 'referral_source' = 'clip_share'",
+      "config": {
+        "yKey": "count",
+        "yFormatter": "number",
+        "description": "Signups in the last 30 days attributed to a shared clip."
+      }
+    },
+    {
+      "id": "signups-by-referral-source",
+      "title": "Signups by Referral Source (90d)",
+      "chartType": "bar",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT COALESCE(NULLIF(properties::jsonb ->> 'referral_source', ''), 'direct') AS referral_source, COUNT(*) AS count FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '90 days' GROUP BY COALESCE(NULLIF(properties::jsonb ->> 'referral_source', ''), 'direct') ORDER BY count DESC LIMIT 20",
+      "config": {
+        "xKey": "referral_source",
+        "yKey": "count",
+        "color": "var(--brand-purple)",
+        "description": "Signups grouped by referral_source over the last 90 days. Null/empty sources are bucketed as direct."
+      }
+    },
+    {
+      "id": "referred-signups-over-time",
+      "title": "Referred Signups Over Time (90d)",
+      "chartType": "area",
+      "source": "first-party",
+      "width": 2,
+      "sql": "SELECT substr(timestamp, 1, 10) AS date, COUNT(*) AS count FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '90 days' AND properties::jsonb ->> 'referral_source' IS NOT NULL AND properties::jsonb ->> 'referral_source' <> '' AND properties::jsonb ->> 'referral_source' <> 'direct' GROUP BY substr(timestamp, 1, 10) ORDER BY date",
+      "config": {
+        "xKey": "date",
+        "yKey": "count",
+        "color": "var(--brand-purple)",
+        "description": "Daily referred (non-direct) signups over the last 90 days."
+      }
+    },
+    {
+      "id": "top-referrers",
+      "title": "Top Referrers (90d)",
+      "chartType": "table",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT properties::jsonb ->> 'referrer_user' AS referrer_user, COUNT(*) AS signups FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '90 days' AND properties::jsonb ->> 'referrer_user' IS NOT NULL AND properties::jsonb ->> 'referrer_user' <> '' GROUP BY properties::jsonb ->> 'referrer_user' ORDER BY signups DESC LIMIT 20",
+      "config": {
+        "description": "Users (by id) driving the most referred signups over the last 90 days.",
+        "columns": [
+          { "key": "referrer_user", "label": "Referrer (user id)" },
+          { "key": "signups", "label": "Signups", "format": "number" }
+        ]
+      }
+    },
+    {
+      "id": "share-funnel-30d",
+      "title": "Share Funnel (30d)",
+      "chartType": "bar",
+      "source": "first-party",
+      "width": 2,
+      "sql": "SELECT 'Share views' AS stage, COUNT(*) AS count FROM analytics_events WHERE event_name = 'share_view' AND timestamp::timestamptz >= now() - interval '30 days' UNION ALL SELECT 'CTA clicks' AS stage, COUNT(*) AS count FROM analytics_events WHERE event_name = 'share_cta_click' AND timestamp::timestamptz >= now() - interval '30 days' UNION ALL SELECT 'Clip-share signups' AS stage, COUNT(*) AS count FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '30 days' AND properties::jsonb ->> 'referral_source' = 'clip_share'",
+      "config": {
+        "xKey": "stage",
+        "yKey": "count",
+        "color": "var(--brand-teal)",
+        "description": "View to click to signup funnel for shared surfaces over the last 30 days: share_view, share_cta_click, then clip_share signups."
+      }
+    },
+    {
+      "id": "viral-participation-rate-90d",
+      "title": "Viral Participation Rate (90d)",
+      "chartType": "metric",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT COALESCE(COUNT(*) FILTER (WHERE recent.auth_user_id IN (SELECT properties::jsonb ->> 'referrer_user' FROM analytics_events WHERE event_name = 'signup' AND properties::jsonb ->> 'referrer_user' IS NOT NULL AND properties::jsonb ->> 'referrer_user' <> ''))::float / NULLIF(COUNT(*), 0), 0) AS rate FROM (SELECT DISTINCT properties::jsonb ->> 'auth_user_id' AS auth_user_id FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '90 days' AND properties::jsonb ->> 'auth_user_id' IS NOT NULL AND properties::jsonb ->> 'auth_user_id' <> '') AS recent",
+      "config": {
+        "yKey": "rate",
+        "yFormatter": "percent",
+        "description": "Share of users who signed up in the last 90d who have since referred at least one new signup (referrers counted across all time). New cohorts under-count: recent signups haven't had time to refer yet. Matches auth_user_id to referrer_user (both better-auth ids)."
+      }
+    },
+    {
+      "id": "viral-coefficient-90d",
+      "title": "Viral Coefficient K (90d)",
+      "chartType": "metric",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT COALESCE(COUNT(*) FILTER (WHERE properties::jsonb ->> 'referrer_user' IS NOT NULL AND properties::jsonb ->> 'referrer_user' <> '')::float / NULLIF(COUNT(DISTINCT properties::jsonb ->> 'auth_user_id'), 0), 0) AS k FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '90 days'",
+      "config": {
+        "yKey": "k",
+        "yFormatter": "number",
+        "description": "Viral coefficient (K): referred signups divided by new users over the last 90d. K >= 1 means each user brings on at least one more, i.e. self-sustaining growth."
+      }
+    },
+    {
+      "id": "activated-referrers-90d",
+      "title": "Activated Referrers (90d)",
+      "chartType": "metric",
+      "source": "first-party",
+      "width": 1,
+      "sql": "SELECT COUNT(DISTINCT properties::jsonb ->> 'referrer_user') AS count FROM analytics_events WHERE event_name = 'signup' AND timestamp::timestamptz >= now() - interval '90 days' AND properties::jsonb ->> 'referrer_user' IS NOT NULL AND properties::jsonb ->> 'referrer_user' <> ''",
+      "config": {
+        "yKey": "count",
+        "yFormatter": "number",
+        "description": "Distinct users who drove at least one referred signup in the last 90d (distinct referrer_user on signups in the window)."
+      }
     }
   ]
 }

package/corpus/templates/analytics/server/db/index.ts

@@ -11,7 +11,7 @@ registerShareableResource({
   sharesTable: schema.dashboardShares,
   displayName: "Dashboard",
   titleColumn: "title",
-  getResourcePath: (dashboard) => `/adhoc/${dashboard.id}`,
+  getResourcePath: (dashboard) => `/dashboards/${dashboard.id}`,
   getDb,
 });
 

package/corpus/templates/analytics/server/lib/dashboard-catalog.ts

@@ -924,8 +924,15 @@ export const dashboardCatalogEntries: DashboardCatalogEntry[] = [
     category: "Product",
     defaultDashboardId: "agent-native-templates-first-party",
     dataSources: ["first-party"],
-    tags: ["templates", "traffic", "signups", "sessions"],
-    panelCount: 14,
+    tags: [
+      "templates",
+      "traffic",
+      "signups",
+      "sessions",
+      "referrals",
+      "virality",
+    ],
+    panelCount: 25,
     version: CATALOG_VERSION,
     recommended: true,
     buildConfig: () => seedConfig("agent-native-templates-first-party"),

package/corpus/templates/analytics/server/lib/demo-dashboards.ts

@@ -60,7 +60,7 @@ function demoDashboardPath(dashboardId: string): string {
   const params = new URLSearchParams({
     tab: DEMO_NODE_EXPORTER_DEFAULT_TAB,
   });
-  return `/adhoc/${dashboardId}?${params.toString()}`;
+  return `/dashboards/${dashboardId}?${params.toString()}`;
 }
 
 function nowIso(): string {

package/corpus/templates/analytics/server/plugins/agent-chat.ts

@@ -240,11 +240,11 @@ export default createAgentChatPlugin({
           return filtered.slice(0, 20).map((d) => ({
             id: `dashboard:${d.id}`,
             label: d.name || "Untitled dashboard",
-            description: `/adhoc/${d.id}`,
+            description: `/dashboards/${d.id}`,
             icon: "deck",
             refType: "dashboard",
             refId: d.id,
-            refPath: `/adhoc/${d.id}`,
+            refPath: `/dashboards/${d.id}`,
           }));
         } catch (err) {
           console.error("[analytics] Dashboard mention provider failed:", err);

package/corpus/templates/analytics/server/plugins/core-routes.ts

@@ -3,17 +3,17 @@ import { createCoreRoutesPlugin } from "@agent-native/core/server";
 // Land external-agent deep links straight on the real SPA route. Without
 // this, `/_agent-native/open?app=analytics&view=adhoc&dashboardId=…` falls
 // back to `/<view>` = `/adhoc`, which has no matching route (the dashboard
-// route is `adhoc.$id.tsx` → `/adhoc/:id`) and 404s — so an "Open in
-// Analytics" link produced by `update-dashboard` / `save-analysis` for a
+// route is `dashboards.$id.tsx` → `/dashboards/:id`) and 404s — so an "Open
+// in Analytics" link produced by `update-dashboard` / `save-analysis` for a
 // connected Claude Code / Codex / Cowork never opened the record.
 export default createCoreRoutesPlugin({
   resolveOpenPath: ({ view, params }) => {
-    if (params.dashboardId) return `/adhoc/${params.dashboardId}`;
+    if (params.dashboardId) return `/dashboards/${params.dashboardId}`;
     if (params.analysisId) return `/analyses/${params.analysisId}`;
     if (view === "analyses") return "/analyses";
-    // `adhoc`/unknown with no id: there is no bare `/adhoc` route — send to
-    // the app root rather than 404 (the polled `navigate` command still
-    // applies any record focus once the SPA is loaded).
+    // `adhoc`/unknown with no id: there is no bare `/dashboards` record route —
+    // send to the app root rather than 404 (the polled `navigate` command
+    // still applies any record focus once the SPA is loaded).
     if (view === "adhoc") return "/";
     return null;
   },

package/corpus/templates/assets/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable user-facing changes to Assets are documented here. Open it any
+time from the command menu (Cmd+K → "What's new") or from Settings.
+
+## 2026-06-23
+
+### Added
+
+- See what's new right inside Assets — a changelog now lives in the command menu (Cmd+K) and in Settings.

package/corpus/templates/assets/app/root.tsx

@@ -16,6 +16,7 @@ import {
 import { Toaster } from "@/components/ui/sonner";
 import { IconSun, IconMoon } from "@tabler/icons-react";
 import { Layout as AppLayout } from "@/components/layout/Layout";
+import changelog from "../CHANGELOG.md?raw";
 import type { LinksFunction } from "react-router";
 import stylesheet from "./global.css?url";
 
@@ -106,7 +107,12 @@ export default function Root() {
     <AppProviders queryClient={queryClient}>
       <DbSyncSetup />
       <Toaster richColors position="bottom-left" />
-      <CommandMenu open={cmdkOpen} onOpenChange={setCmdkOpen}>
+      <CommandMenu
+        open={cmdkOpen}
+        onOpenChange={setCmdkOpen}
+        changelog={changelog}
+        changelogKey="assets"
+      >
         <CommandMenu.Group heading="Actions">
           <CommandMenu.Item onSelect={() => {}}>Search</CommandMenu.Item>
         </CommandMenu.Group>

package/corpus/templates/assets/app/routes/settings.tsx

@@ -1,9 +1,11 @@
 import {
+  ChangelogSettingsCard,
   agentNativePath,
   useActionQuery,
   useBuilderConnectFlow,
   useBuilderStatus,
 } from "@agent-native/core/client";
+import changelog from "../../CHANGELOG.md?raw";
 import {
   useOnboarding,
   type OnboardingMethod,
@@ -75,6 +77,10 @@ export default function SettingsPage() {
       description="Asset generation, storage, and brand kit access."
       className="max-w-4xl space-y-6"
     >
+      <div className="max-w-2xl">
+        <ChangelogSettingsCard markdown={changelog} />
+      </div>
+
       <div className="max-w-2xl">
         <h2 className="text-lg font-semibold tracking-tight">Connections</h2>
         <p className="mt-1 text-sm leading-6 text-muted-foreground">

package/corpus/templates/brain/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable user-facing changes to Agent-Native Brain are documented here. Open it any
+time from the command menu (Cmd+K → "What's new") or from Settings.
+
+## 2026-06-23
+
+### Added
+
+- See what's new right inside Agent-Native Brain — a changelog now lives in the command menu (Cmd+K) and in Settings.

package/corpus/templates/brain/app/root.tsx

@@ -24,6 +24,7 @@ import { Layout as AppLayout } from "@/components/layout/Layout";
 import { useDistillationBridge } from "@/hooks/use-distillation-bridge";
 import { useNavigationState } from "@/hooks/use-navigation-state";
 import { TAB_ID } from "@/lib/tab-id";
+import changelog from "../CHANGELOG.md?raw";
 import type { LinksFunction } from "react-router";
 import stylesheet from "./global.css?url";
 
@@ -137,7 +138,12 @@ function AppContent() {
   useCommandMenuShortcut(useCallback(() => setCmdkOpen(true), []));
   return (
     <>
-      <CommandMenu open={cmdkOpen} onOpenChange={setCmdkOpen}>
+      <CommandMenu
+        open={cmdkOpen}
+        onOpenChange={setCmdkOpen}
+        changelog={changelog}
+        changelogKey="brain"
+      >
         <CommandMenu.Group heading="Navigate">
           <CommandMenu.Item onSelect={() => navigate("/")}>
             Ask Brain

package/corpus/templates/brain/app/routes/settings.tsx

@@ -1,5 +1,10 @@
 import { useEffect, useMemo, useState } from "react";
-import { useActionMutation, useActionQuery } from "@agent-native/core/client";
+import {
+  ChangelogSettingsCard,
+  useActionMutation,
+  useActionQuery,
+} from "@agent-native/core/client";
+import changelog from "../../CHANGELOG.md?raw";
 import {
   IconAdjustments,
   IconBuilding,
@@ -146,6 +151,8 @@ export default function SettingsRoute() {
 
       <div className="grid gap-5 p-4 sm:p-5 lg:grid-cols-[minmax(0,1fr)_360px] lg:p-7">
         <main className="grid gap-5">
+          <ChangelogSettingsCard markdown={changelog} />
+
           <Card>
             <CardHeader>
               <CardTitle className="flex items-center gap-2 text-base">