@prajwolkc/stk 0.7.0 → 0.7.1

package/dist/mcp/tools/infra.js

@@ -0,0 +1,263 @@
+import { z } from "zod";
+import { loadConfig, enabledServices } from "../../lib/config.js";
+import { getChecker, allCheckerNames, loadPluginCheckers } from "../../services/registry.js";
+import { execSync } from "child_process";
+export function registerInfraTools(server) {
+    // ──────────────────────────────────────────
+    // Tool: stk_health
+    // ──────────────────────────────────────────
+    server.tool("stk_health", "Check the health of all configured infrastructure services (databases, deploy providers, storage, billing). Returns structured results with status, latency, and details for each service.", {
+        all: z.boolean().optional().describe("Check all known services, not just configured ones"),
+    }, async ({ all }) => {
+        await loadPluginCheckers();
+        const config = loadConfig();
+        const serviceList = all ? allCheckerNames() : enabledServices(config);
+        const checks = serviceList.map(async (name) => {
+            const checker = getChecker(name);
+            if (!checker) {
+                return { name, status: "skipped", detail: `unknown service "${name}"` };
+            }
+            return checker();
+        });
+        const results = await Promise.all(checks);
+        const down = results.filter((r) => r.status === "down");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        project: config.name,
+                        services: results,
+                        summary: {
+                            healthy: results.filter((r) => r.status === "healthy").length,
+                            down: down.length,
+                            skipped: results.filter((r) => r.status === "skipped").length,
+                            total: results.length,
+                        },
+                        ok: down.length === 0,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    // ──────────────────────────────────────────
+    // Tool: stk_status
+    // ──────────────────────────────────────────
+    server.tool("stk_status", "Get a complete status overview: git state, service health, last deploy, and open issues — everything in one call.", {}, async () => {
+        const config = loadConfig();
+        const status = { project: config.name };
+        // Git
+        try {
+            status.git = {
+                branch: execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim(),
+                dirty: execSync("git status --porcelain", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim().split("\n").filter(Boolean).length,
+                lastCommit: execSync('git log -1 --format="%s"', { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim(),
+                lastCommitAge: execSync('git log -1 --format="%cr"', { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim(),
+            };
+        }
+        catch {
+            status.git = null;
+        }
+        // Services
+        await loadPluginCheckers();
+        const serviceList = enabledServices(config);
+        if (serviceList.length > 0) {
+            const checks = serviceList.map(async (name) => {
+                const checker = getChecker(name);
+                if (!checker)
+                    return { name, status: "skipped" };
+                return checker();
+            });
+            const results = await Promise.all(checks);
+            status.services = {
+                healthy: results.filter((r) => r.status === "healthy").length,
+                down: results.filter((r) => r.status === "down").map((r) => r.name),
+                skipped: results.filter((r) => r.status === "skipped").length,
+                total: results.length,
+            };
+        }
+        else {
+            status.services = { total: 0, note: "no services configured" };
+        }
+        // Deploy
+        if (process.env.VERCEL_TOKEN) {
+            try {
+                const res = await fetch("https://api.vercel.com/v6/deployments?limit=1", {
+                    headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },
+                });
+                const data = (await res.json());
+                const dep = data.deployments?.[0];
+                if (dep) {
+                    status.lastDeploy = {
+                        provider: "vercel",
+                        state: dep.readyState ?? dep.state,
+                        url: dep.url,
+                        created: dep.created,
+                    };
+                }
+            }
+            catch { /* skip */ }
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(status, null, 2) }],
+        };
+    });
+    // ──────────────────────────────────────────
+    // Tool: stk_doctor
+    // ──────────────────────────────────────────
+    server.tool("stk_doctor", "Diagnose infrastructure configuration issues. Checks for missing env vars, mismatched config, invalid URLs, and suggests fixes with documentation links.", {}, async () => {
+        const config = loadConfig();
+        const enabled = enabledServices(config);
+        const issues = [];
+        const ENV_REQS = {
+            railway: { required: ["RAILWAY_API_TOKEN"], optional: ["RAILWAY_PROJECT_ID", "RAILWAY_ENVIRONMENT_ID", "RAILWAY_SERVICE_ID"] },
+            vercel: { required: ["VERCEL_TOKEN"], optional: ["VERCEL_PROJECT_ID"] },
+            fly: { required: ["FLY_API_TOKEN"], optional: ["FLY_APP_NAME"] },
+            render: { required: ["RENDER_API_KEY"], optional: [] },
+            aws: { required: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"], optional: ["AWS_REGION"] },
+            database: { required: ["DATABASE_URL"], optional: [] },
+            mongodb: { required: ["MONGODB_URL"], optional: [] },
+            redis: { required: ["REDIS_URL"], optional: [] },
+            supabase: { required: ["SUPABASE_URL"], optional: ["SUPABASE_SERVICE_KEY"] },
+            r2: { required: ["CLOUDFLARE_ACCOUNT_ID", "CLOUDFLARE_API_TOKEN"], optional: [] },
+            stripe: { required: ["STRIPE_SECRET_KEY"], optional: [] },
+        };
+        for (const svc of enabled) {
+            const reqs = ENV_REQS[svc];
+            if (!reqs)
+                continue;
+            const missingReq = reqs.required.filter((v) => !process.env[v]);
+            const missingOpt = reqs.optional.filter((v) => !process.env[v]);
+            if (missingReq.length > 0) {
+                issues.push({ level: "error", service: svc, message: `Missing required: ${missingReq.join(", ")}` });
+            }
+            else {
+                issues.push({ level: "ok", service: svc, message: "Configured correctly" });
+            }
+            if (missingOpt.length > 0) {
+                issues.push({ level: "warn", service: svc, message: `Missing optional: ${missingOpt.join(", ")}`, fix: "Needed for logs, env sync, deploy watching" });
+            }
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        project: config.name,
+                        issues,
+                        summary: {
+                            errors: issues.filter((i) => i.level === "error").length,
+                            warnings: issues.filter((i) => i.level === "warn").length,
+                            ok: issues.filter((i) => i.level === "ok").length,
+                        },
+                    }, null, 2),
+                }],
+        };
+    });
+    // ──────────────────────────────────────────
+    // Tool: stk_config
+    // ──────────────────────────────────────────
+    server.tool("stk_config", "Read the current stk configuration for this project. Shows which services are enabled, deploy settings, and project name.", {}, async () => {
+        const config = loadConfig();
+        return {
+            content: [{ type: "text", text: JSON.stringify(config, 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),
+                }],
+        };
+    });
+} // end registerInfraTools

package/dist/mcp/tools/ops.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerOpsTools(server: McpServer): void;