@prajwolkc/stk 0.2.1 → 0.4.0

package/dist/mcp/server.js

@@ -366,6 +366,844 @@ server.tool("stk_config", "Read the current stk configuration for this project.
         content: [{ type: "text", text: JSON.stringify(config, null, 2) }],
     };
 });
+// ──────────────────────────────────────────
+// Tool: stk_db
+// ──────────────────────────────────────────
+server.tool("stk_db", "Query your Supabase database directly. Run SELECT queries, check row counts, inspect table data — all from chat. Only read operations are allowed for safety.", {
+    query: z.string().optional().describe("SQL query to run (SELECT only for safety)"),
+    table: z.string().optional().describe("Shorthand: just provide a table name to SELECT * with a limit"),
+    limit: z.number().optional().describe("Max rows to return (default 20)"),
+}, async ({ query, table, limit: rawLimit }) => {
+    const limit = rawLimit ?? 20;
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_KEY;
+    if (!url || !key) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: "SUPABASE_URL or SUPABASE_SERVICE_KEY not set" }) }] };
+    }
+    // If table shorthand is used, build a simple query
+    let sql = query ?? "";
+    if (table && !query) {
+        sql = `SELECT * FROM ${table} ORDER BY created_at DESC LIMIT ${limit}`;
+    }
+    if (!sql && !table) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: "Provide either a 'query' or 'table' parameter" }) }] };
+    }
+    // Safety: only allow read operations
+    const normalized = sql.trim().toUpperCase();
+    if (!normalized.startsWith("SELECT") && !normalized.startsWith("WITH")) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: "Only SELECT/WITH queries are allowed for safety. Use Supabase dashboard for mutations." }) }] };
+    }
+    try {
+        const res = await fetch(`${url}/rest/v1/rpc/`, {
+            method: "POST",
+            headers: {
+                apikey: key,
+                Authorization: `Bearer ${key}`,
+                "Content-Type": "application/json",
+                Prefer: "return=representation",
+            },
+            body: JSON.stringify({}),
+        });
+        // Use PostgREST query instead of RPC for better compatibility
+        // Parse table name from SQL for simple queries
+        const tableMatch = sql.match(/FROM\s+["']?(\w+)["']?/i);
+        const targetTable = table ?? tableMatch?.[1];
+        if (targetTable) {
+            const restRes = await fetch(`${url}/rest/v1/${targetTable}?select=*&limit=${limit}`, {
+                headers: {
+                    apikey: key,
+                    Authorization: `Bearer ${key}`,
+                    "Content-Type": "application/json",
+                    Prefer: "count=exact",
+                },
+            });
+            if (!restRes.ok) {
+                const errText = await restRes.text();
+                return { content: [{ type: "text", text: JSON.stringify({ error: `Query failed: ${errText}` }) }] };
+            }
+            const contentRange = restRes.headers.get("content-range");
+            const totalCount = contentRange ? contentRange.split("/")[1] : "unknown";
+            const data = await restRes.json();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            table: targetTable,
+                            totalRows: totalCount,
+                            returned: Array.isArray(data) ? data.length : 0,
+                            data,
+                        }, null, 2),
+                    }],
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify({ error: "Could not parse table name from query. Use the 'table' parameter instead." }) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: err.message }) }] };
+    }
+});
+// ──────────────────────────────────────────
+// Tool: stk_analytics
+// ──────────────────────────────────────────
+server.tool("stk_analytics", "Get live app analytics: total users, posts, payments, revenue, and recent activity. Pulls data from Supabase and Stripe in one call.", {}, async () => {
+    const results = {};
+    // Supabase stats
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_KEY;
+    if (url && key) {
+        const headers = {
+            apikey: key,
+            Authorization: `Bearer ${key}`,
+            Prefer: "count=exact",
+        };
+        // Get table counts in parallel
+        const [postsRes, usersRes, paymentsRes] = await Promise.all([
+            fetch(`${url}/rest/v1/posts?select=id&limit=0`, { headers }).catch(() => null),
+            fetch(`${url}/rest/v1/users?select=id&limit=0`, { headers }).catch(() => null),
+            fetch(`${url}/rest/v1/payments?select=id&limit=0`, { headers }).catch(() => null),
+        ]);
+        const getCount = (res) => {
+            if (!res?.ok)
+                return null;
+            const range = res.headers.get("content-range");
+            return range ? parseInt(range.split("/")[1]) || 0 : null;
+        };
+        results.supabase = {
+            totalPosts: getCount(postsRes),
+            totalUsers: getCount(usersRes),
+            totalPayments: getCount(paymentsRes),
+        };
+        // Recent posts (last 24h)
+        const oneDayAgo = Math.floor(Date.now() / 1000) - 86400;
+        const recentRes = await fetch(`${url}/rest/v1/posts?select=id&timestamp=gte.${oneDayAgo}&limit=0`, { headers: { ...headers, Prefer: "count=exact" } }).catch(() => null);
+        results.supabase.postsLast24h = getCount(recentRes);
+        // Recent users with paid posts
+        const paidUsersRes = await fetch(`${url}/rest/v1/users?select=id&paid_posts_available=gt.0&limit=0`, { headers: { ...headers, Prefer: "count=exact" } }).catch(() => null);
+        results.supabase.usersWithPaidPosts = getCount(paidUsersRes);
+    }
+    // Stripe stats
+    const stripeKey = process.env.STRIPE_SECRET_KEY;
+    if (stripeKey) {
+        try {
+            // Balance
+            const balRes = await fetch("https://api.stripe.com/v1/balance", {
+                headers: { Authorization: `Bearer ${stripeKey}` },
+            });
+            const balData = await balRes.json();
+            // Recent charges
+            const chargesRes = await fetch("https://api.stripe.com/v1/charges?limit=100", {
+                headers: { Authorization: `Bearer ${stripeKey}` },
+            });
+            const chargesData = await chargesRes.json();
+            const charges = chargesData.data ?? [];
+            const totalRevenue = charges.reduce((sum, c) => sum + (c.status === "succeeded" ? c.amount : 0), 0);
+            results.stripe = {
+                balance: balData.available?.map((b) => `${(b.amount / 100).toFixed(2)} ${b.currency.toUpperCase()}`) ?? [],
+                totalCharges: charges.length,
+                successfulCharges: charges.filter((c) => c.status === "succeeded").length,
+                totalRevenue: `${(totalRevenue / 100).toFixed(2)}`,
+                mode: stripeKey.startsWith("sk_live") ? "live" : "test",
+            };
+        }
+        catch (err) {
+            results.stripe = { error: err.message };
+        }
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ analytics: results }, null, 2) }],
+    };
+});
+// ──────────────────────────────────────────
+// Tool: stk_alerts
+// ──────────────────────────────────────────
+server.tool("stk_alerts", "Scan for problems across your entire stack: failed deploys, down services, error logs, Stripe failures, and database issues. Returns actionable alerts.", {}, async () => {
+    await loadPluginCheckers();
+    const config = loadConfig();
+    const alerts = [];
+    // 1. Check all service health
+    const serviceList = enabledServices(config);
+    const checks = serviceList.map(async (name) => {
+        const checker = getChecker(name);
+        if (!checker)
+            return null;
+        return checker();
+    });
+    const results = (await Promise.all(checks)).filter(Boolean);
+    for (const r of results) {
+        if (r.status === "down") {
+            alerts.push({ level: "critical", source: r.name, message: `Service is DOWN: ${r.detail ?? "unreachable"}` });
+        }
+        else if (r.status === "degraded") {
+            alerts.push({ level: "warning", source: r.name, message: `Service degraded: ${r.detail ?? "slow response"}` });
+        }
+        else if (r.latency && r.latency > 3000) {
+            alerts.push({ level: "warning", source: r.name, message: `High latency: ${r.latency}ms` });
+        }
+    }
+    // 2. Check Vercel for failed deploys
+    if (process.env.VERCEL_TOKEN) {
+        try {
+            const res = await fetch("https://api.vercel.com/v6/deployments?limit=5", {
+                headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },
+            });
+            const data = await res.json();
+            for (const dep of data.deployments ?? []) {
+                const state = dep.readyState ?? dep.state;
+                if (state === "ERROR" || state === "CANCELED") {
+                    alerts.push({ level: "critical", source: "Vercel", message: `Deploy ${state}: ${dep.url ?? dep.uid}` });
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    // 3. Check Stripe for recent failures
+    if (process.env.STRIPE_SECRET_KEY) {
+        try {
+            const res = await fetch("https://api.stripe.com/v1/charges?limit=20", {
+                headers: { Authorization: `Bearer ${process.env.STRIPE_SECRET_KEY}` },
+            });
+            const data = await res.json();
+            const failed = (data.data ?? []).filter((c) => c.status === "failed");
+            if (failed.length > 0) {
+                alerts.push({ level: "warning", source: "Stripe", message: `${failed.length} failed charge(s) in recent transactions` });
+            }
+        }
+        catch { /* skip */ }
+    }
+    // 4. Check for error logs in Vercel
+    if (process.env.VERCEL_TOKEN) {
+        try {
+            const depRes = await fetch("https://api.vercel.com/v6/deployments?limit=1", {
+                headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },
+            });
+            const depData = await depRes.json();
+            const dep = depData.deployments?.[0];
+            if (dep) {
+                const logRes = await fetch(`https://api.vercel.com/v2/deployments/${dep.uid}/events`, {
+                    headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },
+                });
+                const events = await logRes.json();
+                if (Array.isArray(events)) {
+                    const errors = events.filter((e) => e.type === "stderr");
+                    if (errors.length > 5) {
+                        alerts.push({ level: "warning", source: "Vercel Logs", message: `${errors.length} stderr entries in latest deploy` });
+                    }
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    if (alerts.length === 0) {
+        alerts.push({ level: "info", source: "stk", message: "All clear — no issues detected" });
+    }
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    project: config.name,
+                    alerts,
+                    summary: {
+                        critical: alerts.filter((a) => a.level === "critical").length,
+                        warnings: alerts.filter((a) => a.level === "warning").length,
+                        ok: alerts.every((a) => a.level === "info"),
+                    },
+                }, null, 2),
+            }],
+    };
+});
+// ──────────────────────────────────────────
+// Tool: stk_rollback
+// ──────────────────────────────────────────
+server.tool("stk_rollback", "Rollback to a previous Vercel deployment. Lists recent deploys and can promote an older one to production.", {
+    deployId: z.string().optional().describe("Deployment ID to rollback to. If omitted, lists recent deployments to choose from."),
+    confirm: z.boolean().optional().default(false).describe("Must be true to actually execute the rollback"),
+}, async ({ deployId, confirm }) => {
+    const token = process.env.VERCEL_TOKEN;
+    if (!token) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: "VERCEL_TOKEN not set" }) }] };
+    }
+    // List recent deployments
+    const depRes = await fetch("https://api.vercel.com/v6/deployments?limit=10", {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    const depData = await depRes.json();
+    const deployments = (depData.deployments ?? []).map((d) => ({
+        id: d.uid,
+        url: d.url,
+        state: d.readyState ?? d.state,
+        created: new Date(d.created).toISOString(),
+        target: d.target ?? "preview",
+    }));
+    if (!deployId) {
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        message: "Recent deployments — provide a deployId to rollback",
+                        deployments,
+                    }, null, 2),
+                }],
+        };
+    }
+    if (!confirm) {
+        const target = deployments.find((d) => d.id === deployId);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        message: "Rollback requires confirmation. Call again with confirm: true",
+                        target: target ?? deployId,
+                    }, null, 2),
+                }],
+        };
+    }
+    // Execute rollback by promoting the old deployment
+    try {
+        // Get the deployment's project
+        const detailRes = await fetch(`https://api.vercel.com/v13/deployments/${deployId}`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        const detail = await detailRes.json();
+        const projectId = detail.projectId;
+        if (!projectId) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: "Could not determine project from deployment" }) }] };
+        }
+        // Create a new deployment based on the old one (redeploy)
+        const rollbackRes = await fetch(`https://api.vercel.com/v13/deployments`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                name: detail.name,
+                deploymentId: deployId,
+                target: "production",
+            }),
+        });
+        if (!rollbackRes.ok) {
+            const errData = await rollbackRes.json();
+            return { content: [{ type: "text", text: JSON.stringify({ error: errData.error?.message ?? `HTTP ${rollbackRes.status}` }) }] };
+        }
+        const rollbackData = await rollbackRes.json();
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        rolledBack: true,
+                        newDeploymentId: rollbackData.id,
+                        url: rollbackData.url,
+                        note: "Rollback triggered. Use stk_health to verify.",
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: err.message }) }] };
+    }
+});
+// ──────────────────────────────────────────
+// Tool: stk_env_sync
+// ──────────────────────────────────────────
+server.tool("stk_env_sync", "Compare and sync environment variables between local .env and Vercel. Shows which vars are missing, extra, or mismatched.", {
+    action: z.enum(["diff", "pull", "push"]).optional().default("diff").describe("diff: compare local vs remote. pull: download remote to .env.pulled. push: upload local to Vercel."),
+    confirm: z.boolean().optional().default(false).describe("Required for push action"),
+}, async ({ action, confirm }) => {
+    const token = process.env.VERCEL_TOKEN;
+    const projectId = process.env.VERCEL_PROJECT_ID;
+    // Read local .env
+    let localVars = {};
+    try {
+        const { readFileSync } = await import("fs");
+        const envContent = readFileSync(".env", "utf-8");
+        for (const line of envContent.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eqIdx = trimmed.indexOf("=");
+            if (eqIdx > 0) {
+                localVars[trimmed.slice(0, eqIdx)] = trimmed.slice(eqIdx + 1);
+            }
+        }
+    }
+    catch {
+        localVars = {};
+    }
+    if (!token) {
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        localVars: Object.keys(localVars),
+                        remote: "VERCEL_TOKEN not set — cannot fetch remote env vars",
+                    }, null, 2),
+                }],
+        };
+    }
+    // Fetch Vercel env vars
+    let remoteVars = {};
+    const envUrl = projectId
+        ? `https://api.vercel.com/v9/projects/${projectId}/env`
+        : null;
+    if (envUrl) {
+        try {
+            const res = await fetch(envUrl, {
+                headers: { Authorization: `Bearer ${token}` },
+            });
+            const data = await res.json();
+            for (const env of data.envs ?? []) {
+                remoteVars[env.key] = env.value ?? "(encrypted)";
+            }
+        }
+        catch { /* skip */ }
+    }
+    const localKeys = new Set(Object.keys(localVars));
+    const remoteKeys = new Set(Object.keys(remoteVars));
+    const onlyLocal = [...localKeys].filter((k) => !remoteKeys.has(k));
+    const onlyRemote = [...remoteKeys].filter((k) => !localKeys.has(k));
+    const shared = [...localKeys].filter((k) => remoteKeys.has(k));
+    if (action === "diff" || !action) {
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        localCount: localKeys.size,
+                        remoteCount: remoteKeys.size,
+                        onlyInLocal: onlyLocal,
+                        onlyInRemote: onlyRemote,
+                        inBoth: shared.length,
+                        note: projectId ? undefined : "Set VERCEL_PROJECT_ID for remote env comparison",
+                    }, null, 2),
+                }],
+        };
+    }
+    if (action === "pull") {
+        const { writeFileSync } = await import("fs");
+        const lines = Object.entries(remoteVars).map(([k, v]) => `${k}=${v}`);
+        writeFileSync(".env.pulled", lines.join("\n") + "\n");
+        return {
+            content: [{ type: "text", text: JSON.stringify({ pulled: true, file: ".env.pulled", count: lines.length }) }],
+        };
+    }
+    if (action === "push") {
+        if (!confirm) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ message: "Push requires confirm: true. This will overwrite remote env vars.", varsToUpload: onlyLocal.length + shared.length }) }],
+            };
+        }
+        if (!projectId || !envUrl) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: "VERCEL_PROJECT_ID required for push" }) }] };
+        }
+        let uploaded = 0;
+        for (const [key, value] of Object.entries(localVars)) {
+            await fetch(envUrl, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    key,
+                    value,
+                    type: "encrypted",
+                    target: ["production", "preview", "development"],
+                }),
+            });
+            uploaded++;
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({ pushed: true, uploaded }) }],
+        };
+    }
+    return { content: [{ type: "text", text: JSON.stringify({ error: "Unknown action" }) }] };
+});
+// ──────────────────────────────────────────
+// Tool: stk_perf
+// ──────────────────────────────────────────
+server.tool("stk_perf", "Check performance across your stack: Supabase query latency, table sizes, Vercel deploy times, and API response times.", {
+    tables: z.array(z.string()).optional().describe("Specific Supabase tables to benchmark (defaults to all detected)"),
+}, async ({ tables }) => {
+    const perf = {};
+    // Supabase performance
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_KEY;
+    if (url && key) {
+        const headers = {
+            apikey: key,
+            Authorization: `Bearer ${key}`,
+            Prefer: "count=exact",
+        };
+        // Auto-detect tables or use provided list
+        const tablesToCheck = tables ?? ["posts", "users", "payments"];
+        const tableStats = [];
+        for (const table of tablesToCheck) {
+            const start = Date.now();
+            try {
+                const res = await fetch(`${url}/rest/v1/${table}?select=id&limit=0`, {
+                    headers,
+                });
+                const latency = Date.now() - start;
+                const range = res.headers.get("content-range");
+                const count = range ? parseInt(range.split("/")[1]) || 0 : null;
+                let status = "fast";
+                if (latency > 1000)
+                    status = "slow";
+                else if (latency > 500)
+                    status = "moderate";
+                tableStats.push({ table, rowCount: count, queryLatency: latency, status });
+            }
+            catch {
+                tableStats.push({ table, rowCount: null, queryLatency: Date.now() - start, status: "error" });
+            }
+        }
+        // API latency test
+        const apiStart = Date.now();
+        await fetch(`${url}/rest/v1/`, { headers }).catch(() => null);
+        const apiLatency = Date.now() - apiStart;
+        perf.supabase = {
+            apiLatency,
+            tables: tableStats,
+            recommendation: tableStats.some((t) => t.status === "slow")
+                ? "Some queries are slow. Consider adding database indexes."
+                : tableStats.some((t) => (t.rowCount ?? 0) > 10000)
+                    ? "Large tables detected. Ensure you have indexes on frequently queried columns."
+                    : "Performance looks good.",
+        };
+    }
+    // Vercel deploy performance
+    if (process.env.VERCEL_TOKEN) {
+        try {
+            const res = await fetch("https://api.vercel.com/v6/deployments?limit=5", {
+                headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },
+            });
+            const data = await res.json();
+            const deploys = (data.deployments ?? []).map((d) => {
+                const buildDuration = d.buildingAt && d.ready
+                    ? Math.round((d.ready - d.buildingAt) / 1000)
+                    : null;
+                return {
+                    id: d.uid,
+                    state: d.readyState ?? d.state,
+                    buildDuration: buildDuration ? `${buildDuration}s` : "unknown",
+                    created: new Date(d.created).toISOString(),
+                };
+            });
+            perf.vercel = {
+                recentDeploys: deploys,
+                avgBuildTime: deploys.filter((d) => d.buildDuration !== "unknown").length > 0
+                    ? "see individual deploys"
+                    : "no build data available",
+            };
+        }
+        catch { /* skip */ }
+    }
+    // Stripe API latency
+    if (process.env.STRIPE_SECRET_KEY) {
+        const start = Date.now();
+        await fetch("https://api.stripe.com/v1/balance", {
+            headers: { Authorization: `Bearer ${process.env.STRIPE_SECRET_KEY}` },
+        }).catch(() => null);
+        perf.stripe = { apiLatency: Date.now() - start };
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ performance: perf }, null, 2) }],
+    };
+});
+// ──────────────────────────────────────────
+// Tool: stk_cost
+// ──────────────────────────────────────────
+server.tool("stk_cost", "Track costs across your stack: Stripe fees, Vercel usage, Supabase plan details. Get a unified view of what you're spending.", {}, async () => {
+    const costs = {};
+    // Stripe revenue & fees
+    if (process.env.STRIPE_SECRET_KEY) {
+        try {
+            const stripeKey = process.env.STRIPE_SECRET_KEY;
+            // Balance
+            const balRes = await fetch("https://api.stripe.com/v1/balance", {
+                headers: { Authorization: `Bearer ${stripeKey}` },
+            });
+            const balData = await balRes.json();
+            // Recent balance transactions for fee tracking
+            const txRes = await fetch("https://api.stripe.com/v1/balance_transactions?limit=100", {
+                headers: { Authorization: `Bearer ${stripeKey}` },
+            });
+            const txData = await txRes.json();
+            const transactions = txData.data ?? [];
+            const totalFees = transactions.reduce((sum, t) => sum + (t.fee || 0), 0);
+            const totalGross = transactions.reduce((sum, t) => sum + (t.amount > 0 ? t.amount : 0), 0);
+            const totalNet = transactions.reduce((sum, t) => sum + (t.net || 0), 0);
+            costs.stripe = {
+                mode: stripeKey.startsWith("sk_live") ? "live" : "test",
+                balance: balData.available?.map((b) => ({
+                    amount: (b.amount / 100).toFixed(2),
+                    currency: b.currency.toUpperCase(),
+                })) ?? [],
+                recentTransactions: transactions.length,
+                totalGross: (totalGross / 100).toFixed(2),
+                totalFees: (totalFees / 100).toFixed(2),
+                totalNet: (totalNet / 100).toFixed(2),
+                feePercentage: totalGross > 0 ? ((totalFees / totalGross) * 100).toFixed(1) + "%" : "N/A",
+            };
+        }
+        catch (err) {
+            costs.stripe = { error: err.message };
+        }
+    }
+    // Vercel usage
+    if (process.env.VERCEL_TOKEN) {
+        try {
+            // Get team/user info for billing context
+            const userRes = await fetch("https://api.vercel.com/v2/user", {
+                headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },
+            });
+            const userData = await userRes.json();
+            // Count deployments
+            const depRes = await fetch("https://api.vercel.com/v6/deployments?limit=100", {
+                headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },
+            });
+            const depData = await depRes.json();
+            const deployments = depData.deployments ?? [];
+            // Deployments this month
+            const monthStart = new Date();
+            monthStart.setDate(1);
+            monthStart.setHours(0, 0, 0, 0);
+            const thisMonth = deployments.filter((d) => new Date(d.created) >= monthStart);
+            costs.vercel = {
+                plan: userData.user?.billing?.plan ?? "unknown",
+                deploymentsThisMonth: thisMonth.length,
+                totalDeployments: deployments.length,
+                note: "Vercel free tier includes 100 deployments/day. Check vercel.com/dashboard for detailed billing.",
+            };
+        }
+        catch { /* skip */ }
+    }
+    // Supabase usage estimate
+    if (process.env.SUPABASE_URL && process.env.SUPABASE_SERVICE_KEY) {
+        const url = process.env.SUPABASE_URL;
+        const key = process.env.SUPABASE_SERVICE_KEY;
+        const headers = {
+            apikey: key,
+            Authorization: `Bearer ${key}`,
+            Prefer: "count=exact",
+        };
+        const tableCounts = {};
+        for (const table of ["posts", "users", "payments"]) {
+            try {
+                const res = await fetch(`${url}/rest/v1/${table}?select=id&limit=0`, { headers });
+                const range = res.headers.get("content-range");
+                tableCounts[table] = range ? parseInt(range.split("/")[1]) || 0 : null;
+            }
+            catch {
+                tableCounts[table] = null;
+            }
+        }
+        const totalRows = Object.values(tableCounts).reduce((s, v) => s + (v ?? 0), 0);
+        costs.supabase = {
+            tables: tableCounts,
+            totalRows,
+            note: "Supabase free tier: 500MB database, 1GB storage, 50k monthly active users. Check supabase.com/dashboard for detailed usage.",
+        };
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ costs }, null, 2) }],
+    };
+});
+// ──────────────────────────────────────────
+// Brain: Supabase Knowledge Base Client
+// ──────────────────────────────────────────
+function getBrainClient() {
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_KEY;
+    if (!url || !key)
+        return null;
+    return {
+        async query(table, params = {}) {
+            const searchParams = new URLSearchParams(params);
+            const res = await fetch(`${url}/rest/v1/${table}?${searchParams}`, {
+                headers: {
+                    apikey: key,
+                    Authorization: `Bearer ${key}`,
+                    "Content-Type": "application/json",
+                    Prefer: "count=exact",
+                },
+            });
+            const count = res.headers.get("content-range")?.split("/")[1] ?? null;
+            const data = await res.json();
+            return { data, count, ok: res.ok };
+        },
+        async insert(table, row) {
+            const res = await fetch(`${url}/rest/v1/${table}`, {
+                method: "POST",
+                headers: {
+                    apikey: key,
+                    Authorization: `Bearer ${key}`,
+                    "Content-Type": "application/json",
+                    Prefer: "return=representation",
+                },
+                body: JSON.stringify(row),
+            });
+            const data = await res.json();
+            return { data, ok: res.ok };
+        },
+    };
+}
+// ──────────────────────────────────────────
+// Tool: stk_brain_search
+// ──────────────────────────────────────────
+server.tool("stk_brain_search", "Search the knowledge base for SaaS patterns, best practices, and architecture examples from top open-source projects (LangChain, Ollama, Transformers, llama.cpp, vLLM, AutoGen, OpenAI Cookbook). Use this when you need to know how successful projects solve specific problems.", {
+    query: z.string().describe("What to search for (e.g., 'authentication', 'real-time updates', 'payment integration')"),
+    category: z.string().optional().describe("Filter: architecture, auth, payments, database, api, deployment, testing, performance, security, ml, realtime, general"),
+}, async ({ query, category }) => {
+    const brain = getBrainClient();
+    if (!brain)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "SUPABASE_URL or SUPABASE_SERVICE_KEY not set" }) }] };
+    // Try ilike search on content and title
+    const words = query.split(" ").filter(w => w.length > 2);
+    const searchWord = words[0] ?? query;
+    const params = {
+        or: `(title.ilike.%${searchWord}%,content.ilike.%${searchWord}%)`,
+        limit: "10",
+        order: "source",
+    };
+    if (category)
+        params["category"] = `eq.${category}`;
+    const { data, ok } = await brain.query("knowledge", params);
+    if (!ok)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "Query failed", data }) }] };
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    query,
+                    results: (data ?? []).map((r) => ({ source: r.source, category: r.category, title: r.title, content: r.content, tags: r.tags })),
+                    total: data?.length ?? 0,
+                }, null, 2),
+            }],
+    };
+});
+// ──────────────────────────────────────────
+// Tool: stk_brain_patterns
+// ──────────────────────────────────────────
+server.tool("stk_brain_patterns", "Get best practice patterns for a specific feature. Returns how top projects implement auth, payments, real-time, caching, APIs, etc.", {
+    feature: z.string().describe("The feature or pattern (e.g., 'authentication', 'webhooks', 'caching', 'model serving', 'fine-tuning')"),
+}, async ({ feature }) => {
+    const brain = getBrainClient();
+    if (!brain)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "SUPABASE_URL or SUPABASE_SERVICE_KEY not set" }) }] };
+    const { data, ok } = await brain.query("knowledge", {
+        or: `(title.ilike.%${feature}%,content.ilike.%${feature}%)`,
+        limit: "15",
+        order: "source",
+    });
+    if (!ok)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "Query failed" }) }] };
+    // Group by source
+    const grouped = {};
+    for (const item of data ?? []) {
+        if (!grouped[item.source])
+            grouped[item.source] = [];
+        grouped[item.source].push({ title: item.title, category: item.category, content: item.content });
+    }
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    feature,
+                    patterns: grouped,
+                    totalSources: Object.keys(grouped).length,
+                    totalPatterns: data?.length ?? 0,
+                }, null, 2),
+            }],
+    };
+});
+// ──────────────────────────────────────────
+// Tool: stk_brain_stack
+// ──────────────────────────────────────────
+server.tool("stk_brain_stack", "Get recommendations specific to YOUR stack (Supabase + Vercel + Stripe + Node.js). Filters knowledge for patterns matching your technology choices.", {
+    question: z.string().describe("What you want to build or solve (e.g., 'add user auth', 'implement webhooks', 'optimize queries')"),
+}, async ({ question }) => {
+    const brain = getBrainClient();
+    if (!brain)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "SUPABASE_URL or SUPABASE_SERVICE_KEY not set" }) }] };
+    const words = question.split(" ").filter(w => w.length > 3);
+    const searchWord = words[0] ?? question;
+    const { data, ok } = await brain.query("knowledge", {
+        or: `(content.ilike.%${searchWord}%,title.ilike.%${searchWord}%)`,
+        limit: "10",
+    });
+    if (!ok)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "Query failed" }) }] };
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    question,
+                    stack: ["Supabase", "Vercel", "Stripe", "Node.js/Express"],
+                    recommendations: (data ?? []).map((r) => ({ source: r.source, title: r.title, content: r.content, relevance: r.category })),
+                    total: data?.length ?? 0,
+                }, null, 2),
+            }],
+    };
+});
+// ──────────────────────────────────────────
+// Tool: stk_brain_learn
+// ──────────────────────────────────────────
+server.tool("stk_brain_learn", "Save new knowledge to the brain. Use this to remember patterns, solutions, or learnings for future reference across all projects.", {
+    title: z.string().describe("Short title"),
+    content: z.string().describe("The knowledge — pattern, solution, or best practice"),
+    source: z.string().optional().describe("Where this came from (e.g., 'project:worldchat', 'github:vercel/next.js')"),
+    category: z.string().optional().describe("Category: architecture, auth, payments, database, api, deployment, testing, performance, security, ml, general"),
+    tags: z.array(z.string()).optional().describe("Tags for searchability"),
+}, async ({ title, content, source, category, tags }) => {
+    const brain = getBrainClient();
+    if (!brain)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "SUPABASE_URL or SUPABASE_SERVICE_KEY not set" }) }] };
+    const { data, ok } = await brain.insert("knowledge", {
+        title,
+        content,
+        source: source ?? "manual",
+        category: category ?? "general",
+        tags: tags ?? [],
+        created_at: new Date().toISOString(),
+    });
+    if (!ok)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "Insert failed", data }) }] };
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({ learned: true, title, message: "Knowledge saved. I can recall this in future conversations." }, null, 2),
+            }],
+    };
+});
+// ──────────────────────────────────────────
+// Tool: stk_brain_stats
+// ──────────────────────────────────────────
+server.tool("stk_brain_stats", "Check what the brain knows — total knowledge entries, categories, sources, and coverage.", {}, async () => {
+    const brain = getBrainClient();
+    if (!brain)
+        return { content: [{ type: "text", text: JSON.stringify({ error: "SUPABASE_URL or SUPABASE_SERVICE_KEY not set" }) }] };
+    const { data, count } = await brain.query("knowledge", { select: "category,source", limit: "1000" });
+    const categories = {};
+    const sources = {};
+    for (const row of data ?? []) {
+        categories[row.category] = (categories[row.category] || 0) + 1;
+        sources[row.source] = (sources[row.source] || 0) + 1;
+    }
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    totalKnowledge: count ?? data?.length ?? 0,
+                    categories,
+                    sources,
+                    topSources: Object.entries(sources)
+                        .sort(([, a], [, b]) => b - a)
+                        .slice(0, 10)
+                        .map(([name, count]) => ({ name, count })),
+                }, null, 2),
+            }],
+    };
+});
 // Helper
 function detectGitHubRepo() {
     try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prajwolkc/stk",
-  "version": "0.2.1",
-  "description": "One CLI to deploy, monitor, and debug your entire stack. Health checks, deploy watching, env sync, logs, and GitHub issues — all from one command.",
+  "version": "0.4.0",
+  "description": "One CLI to deploy, monitor, debug, and learn about your entire stack. Infrastructure monitoring, knowledge base brain, deploy watching, and GitHub issues — all from one command.",
   "type": "module",
   "license": "MIT",
   "author": "prajwolkc",