Organize src/ into concern folders (http, auth, admin, plugin-host, ui); co-locate tests, move plugin-api barrel into plugin-host, sync docs + AGENTS layout

src/ui/dashboard.ts

@@ -0,0 +1,25 @@
+// Dashboard view model: the gated "/dashboard" app home. By default a short instructional
+// starter — what the dashboard is and how to replace it by exporting a `dashboard` handler from a
+// plugin (views/index.ejs holds the prose). A plugin owns the real one (PluginManifest.dashboard);
+// this placeholder renders until then. Pure: `nav` is the one global menu (ctx.chrome.nav), built
+// once per request by the host, so the dashboard shows the exact same menu as every other page.
+
+import type { User } from "../http/context.ts";
+import { DEFAULT_MENU, type MenuConfig } from "./menu-config.ts";
+import type { NavNode } from "./nav.ts";
+import { buildShellContext } from "./shell-context.ts";
+
+export function buildDashboardModel(opts: { csrfToken?: string; menu?: MenuConfig; nav?: NavNode[]; user?: User | null } = {}) {
+  return {
+    nav: opts.nav ?? [],
+    shell: buildShellContext({
+      breadcrumbs: [{ label: "Dashboard" }],
+      csrfToken: opts.csrfToken ?? "",
+      menu: opts.menu ?? DEFAULT_MENU,
+      title: "Dashboard",
+      user: opts.user ?? null,
+    }),
+  };
+}
+
+export type DashboardModel = ReturnType<typeof buildDashboardModel>;