Build Cobble project structure from the handoff

- Remove the preset document suite (letters, emails, invoices, quotes,
  PDF generation, line items) with its routes, API handlers and tables
- Rebrand to Cobble: site data, Lato, handoff design tokens (light and
  dark) in main.css, brand assets in public/brand, ember stone logo and
  regenerated favicons
- Add bots, bot_messages, bot_tasks and bot_task_steps tables, regenerate
  DB types (BUN_SQLITE_COBBLE_*) and add a sample crew seed (seed:bots)
- Add the chat shell at /admin/bots: rail with pinned coordinator and
  user popover, bottom-anchored conversation with composer, working-on
  panel, and a send-message API scoped to the session user
- Add BotStone and Wordmark components, crew status and relative time
  utils with tests, and update AGENTS.md

Co-Authored-By: Claude Opus 5.5 <[email protected]>

src/functions/backend/db/bots/grab-active-bot-task.ts

@@ -0,0 +1,35 @@
+import type {
+    BUN_SQLITE_COBBLE_BOT_TASK_STEPS,
+    BUN_SQLITE_COBBLE_BOT_TASKS,
+} from "@/db/types/db";
+import type { BotTaskWithSteps } from "@/src/types";
+import BunSQLite from "@moduletrace/bun-sqlite";
+
+type Params = {
+    bot_id: number | string;
+};
+
+/**
+ * The bot's most recent active task and its steps, for the working-on panel.
+ */
+export default async function grabActiveBotTask({
+    bot_id,
+}: Params): Promise<BotTaskWithSteps | null> {
+    const task_res = await BunSQLite.sql<BUN_SQLITE_COBBLE_BOT_TASKS>({
+        sql: `SELECT * FROM bot_tasks WHERE bot_id = ? AND status = 'active' ORDER BY created_at DESC, id DESC LIMIT 1`,
+        values: [bot_id],
+    });
+
+    const task = task_res.singleRes || task_res.payload?.[0];
+
+    if (!task?.id) {
+        return null;
+    }
+
+    const steps_res = await BunSQLite.sql<BUN_SQLITE_COBBLE_BOT_TASK_STEPS>({
+        sql: `SELECT * FROM bot_task_steps WHERE task_id = ? ORDER BY position ASC, id ASC`,
+        values: [task.id],
+    });
+
+    return { ...task, steps: steps_res.payload || [] };
+}

src/functions/backend/db/bots/grab-bot-messages.ts

@@ -0,0 +1,31 @@
+import type { BUN_SQLITE_COBBLE_BOT_MESSAGES } from "@/db/types/db";
+import BunSQLite from "@moduletrace/bun-sqlite";
+
+type Params = {
+    bot_id: number | string;
+    limit?: number;
+};
+
+/**
+ * The latest messages of a bot's conversation, oldest first.
+ */
+export default async function grabBotMessages({
+    bot_id,
+    limit = 100,
+}: Params): Promise<BUN_SQLITE_COBBLE_BOT_MESSAGES[]> {
+    let sql = ``;
+
+    sql += `SELECT * FROM (\n`;
+    sql += `    SELECT * FROM bot_messages\n`;
+    sql += `    WHERE bot_id = ?\n`;
+    sql += `    ORDER BY created_at DESC, id DESC\n`;
+    sql += `    LIMIT ?\n`;
+    sql += `) ORDER BY created_at ASC, id ASC\n`;
+
+    const res = await BunSQLite.sql<BUN_SQLITE_COBBLE_BOT_MESSAGES>({
+        sql,
+        values: [bot_id, limit],
+    });
+
+    return res.payload || [];
+}

src/functions/backend/db/bots/grab-bots.ts

@@ -0,0 +1,39 @@
+import type { BotWithLastMessage } from "@/src/types";
+import BunSQLite from "@moduletrace/bun-sqlite";
+
+type Params = {
+    user_id: number | string;
+};
+
+/**
+ * A workspace's crew for the rail: the coordinator pinned first, then
+ * workers by latest activity. Each row carries its latest message.
+ */
+export default async function grabBots({
+    user_id,
+}: Params): Promise<BotWithLastMessage[]> {
+    let sql = ``;
+
+    sql += `SELECT\n`;
+    sql += `    b.*,\n`;
+    sql += `    lm.text AS last_message_text,\n`;
+    sql += `    lm.created_at AS last_message_at\n`;
+    sql += `FROM bots b\n`;
+    sql += `LEFT JOIN bot_messages lm ON lm.id = (\n`;
+    sql += `    SELECT id FROM bot_messages\n`;
+    sql += `    WHERE bot_id = b.id\n`;
+    sql += `    ORDER BY created_at DESC, id DESC\n`;
+    sql += `    LIMIT 1\n`;
+    sql += `)\n`;
+    sql += `WHERE b.user_id = ?\n`;
+    sql += `ORDER BY\n`;
+    sql += `    CASE WHEN b.kind = 'coordinator' THEN 0 ELSE 1 END,\n`;
+    sql += `    COALESCE(lm.created_at, b.last_activity_at, b.created_at) DESC\n`;
+
+    const res = await BunSQLite.sql<BotWithLastMessage>({
+        sql,
+        values: [user_id],
+    });
+
+    return res.payload || [];
+}

src/functions/backend/db/bots/grab-user-bot.ts

@@ -0,0 +1,22 @@
+import type { BUN_SQLITE_COBBLE_BOTS } from "@/db/types/db";
+import BunSQLite from "@moduletrace/bun-sqlite";
+
+type Params = {
+    bot_id: number | string;
+    user_id: number | string;
+};
+
+/**
+ * A bot only if it belongs to the given workspace owner.
+ */
+export default async function grabUserBot({
+    bot_id,
+    user_id,
+}: Params): Promise<BUN_SQLITE_COBBLE_BOTS | null> {
+    const res = await BunSQLite.sql<BUN_SQLITE_COBBLE_BOTS>({
+        sql: `SELECT * FROM bots WHERE id = ? AND user_id = ? LIMIT 1`,
+        values: [bot_id, user_id],
+    });
+
+    return res.payload?.[0] || null;
+}

src/functions/backend/db/bots/insert-user-message.ts

@@ -0,0 +1,50 @@
+import type {
+    BUN_SQLITE_COBBLE_BOT_MESSAGES,
+    BunSQLiteTables,
+} from "@/db/types/db";
+import BunSQLite from "@moduletrace/bun-sqlite";
+
+type Params = {
+    bot_id: number;
+    text: string;
+};
+
+/**
+ * Appends a user message to a bot's conversation and bumps its activity.
+ * Callers must check the bot belongs to the session user first.
+ */
+export default async function insertUserMessage({
+    bot_id,
+    text,
+}: Params): Promise<BUN_SQLITE_COBBLE_BOT_MESSAGES> {
+    const now = Date.now();
+
+    const res = await BunSQLite.insert<
+        BUN_SQLITE_COBBLE_BOT_MESSAGES,
+        (typeof BunSQLiteTables)[number]
+    >({
+        table: "bot_messages",
+        data: [{ bot_id, author: "user", text, needs_you: 0 }],
+    });
+
+    const id = res.postInsertReturn?.insertId;
+
+    if (!res.success || !id) {
+        throw new Error(`Failed to save message: ${res.msg}`);
+    }
+
+    await BunSQLite.sql({
+        sql: `UPDATE bots SET last_activity_at = ? WHERE id = ?`,
+        values: [now, bot_id],
+    });
+
+    return {
+        id,
+        bot_id,
+        author: "user",
+        text,
+        needs_you: 0,
+        created_at: now,
+        updated_at: now,
+    };
+}

src/functions/backend/db/bots/mark-bot-read.ts

@@ -0,0 +1,16 @@
+import BunSQLite from "@moduletrace/bun-sqlite";
+
+type Params = {
+    bot_id: number | string;
+    user_id: number | string;
+};
+
+/**
+ * Clears a bot's unread flag when its owner opens the conversation.
+ */
+export default async function markBotRead({ bot_id, user_id }: Params) {
+    await BunSQLite.sql({
+        sql: `UPDATE bots SET unread = 0 WHERE id = ? AND user_id = ? AND unread = 1`,
+        values: [bot_id, user_id],
+    });
+}