@prajwolkc/stk 0.4.0 → 0.4.1

package/dist/mcp/server.js

@@ -1204,6 +1204,161 @@ server.tool("stk_brain_stats", "Check what the brain knows — total knowledge e
             }],
     };
 });
+// ──────────────────────────────────────────
+// Tool: stk_brain_claudemd
+// ──────────────────────────────────────────
+server.tool("stk_brain_claudemd", "Auto-generate a CLAUDE.md file for the current project. Analyzes the tech stack, project structure, services, and brain knowledge to create comprehensive project instructions for Claude Code.", {
+    projectName: z.string().optional().describe("Project name (auto-detected from stk.config.json if omitted)"),
+    write: z.boolean().optional().default(false).describe("Actually write the CLAUDE.md file to disk. If false, just returns the content for review."),
+}, async ({ projectName, write }) => {
+    const config = loadConfig();
+    const name = projectName ?? config.name ?? "my-project";
+    const enabled = enabledServices(config);
+    // Detect project info
+    let gitBranch = "";
+    let gitRemote = "";
+    let packageJson = {};
+    try {
+        gitBranch = execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    }
+    catch { }
+    try {
+        gitRemote = execSync("git remote get-url origin", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    }
+    catch { }
+    try {
+        const { readFileSync } = await import("fs");
+        packageJson = JSON.parse(readFileSync("package.json", "utf-8"));
+    }
+    catch { }
+    // Detect tech stack
+    const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+    const stack = [];
+    if (deps?.["next"])
+        stack.push("Next.js");
+    if (deps?.["react"])
+        stack.push("React");
+    if (deps?.["vue"])
+        stack.push("Vue");
+    if (deps?.["express"])
+        stack.push("Express.js");
+    if (deps?.["fastify"])
+        stack.push("Fastify");
+    if (deps?.["@supabase/supabase-js"])
+        stack.push("Supabase");
+    if (deps?.["stripe"])
+        stack.push("Stripe");
+    if (deps?.["prisma"] || deps?.["@prisma/client"])
+        stack.push("Prisma");
+    if (deps?.["mongoose"])
+        stack.push("Mongoose/MongoDB");
+    if (deps?.["redis"] || deps?.["ioredis"])
+        stack.push("Redis");
+    if (deps?.["tailwindcss"])
+        stack.push("Tailwind CSS");
+    if (deps?.["typescript"])
+        stack.push("TypeScript");
+    if (deps?.["zod"])
+        stack.push("Zod");
+    if (stack.length === 0 && Object.keys(deps ?? {}).length > 0) {
+        stack.push("Node.js");
+    }
+    // Detect file structure
+    let fileStructure = "";
+    try {
+        fileStructure = execSync("find . -maxdepth 3 -type f -name '*.ts' -o -name '*.js' -o -name '*.tsx' -o -name '*.jsx' -o -name '*.json' -o -name '*.css' -o -name '*.html' | grep -v node_modules | grep -v dist | grep -v .git | sort | head -40", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    }
+    catch { }
+    // Build CLAUDE.md
+    const lines = [];
+    lines.push(`# ${name}\n`);
+    // Project overview
+    lines.push(`## Overview\n`);
+    if (packageJson.description)
+        lines.push(`${packageJson.description}\n`);
+    if (stack.length > 0)
+        lines.push(`**Tech Stack:** ${stack.join(", ")}\n`);
+    if (gitRemote)
+        lines.push(`**Repo:** ${gitRemote}`);
+    if (gitBranch)
+        lines.push(`**Main Branch:** ${gitBranch}`);
+    lines.push("");
+    // Services
+    if (enabled.length > 0) {
+        lines.push(`## Services\n`);
+        for (const svc of enabled) {
+            const svcName = svc.charAt(0).toUpperCase() + svc.slice(1);
+            lines.push(`- **${svcName}** — configured and monitored via stk`);
+        }
+        lines.push("");
+    }
+    // Project structure
+    if (fileStructure) {
+        lines.push(`## Project Structure\n`);
+        lines.push("```");
+        lines.push(fileStructure);
+        lines.push("```\n");
+    }
+    // Development commands
+    lines.push(`## Development\n`);
+    if (packageJson.scripts) {
+        lines.push("```bash");
+        if (packageJson.scripts.dev)
+            lines.push(`npm run dev        # Start dev server`);
+        if (packageJson.scripts.build)
+            lines.push(`npm run build      # Build for production`);
+        if (packageJson.scripts.test)
+            lines.push(`npm test           # Run tests`);
+        if (packageJson.scripts.start)
+            lines.push(`npm start          # Start production server`);
+        lines.push("```\n");
+    }
+    // stk tools available
+    lines.push(`## stk Tools Available\n`);
+    lines.push(`This project uses stk for infrastructure monitoring. Available commands:\n`);
+    lines.push(`- \`stk_health\` — Check service health`);
+    lines.push(`- \`stk_status\` — Full project overview`);
+    lines.push(`- \`stk_logs\` — Production logs`);
+    lines.push(`- \`stk_db\` — Query database`);
+    lines.push(`- \`stk_alerts\` — Check for problems`);
+    lines.push(`- \`stk_deploy\` — Deploy to production`);
+    lines.push(`- \`stk_brain_search\` — Search knowledge base`);
+    lines.push(`- \`stk_brain_learn\` — Save patterns for future use`);
+    lines.push("");
+    // Conventions
+    lines.push(`## Conventions\n`);
+    if (deps?.["typescript"]) {
+        lines.push(`- TypeScript strict mode enabled`);
+    }
+    lines.push(`- Use existing patterns in the codebase before introducing new ones`);
+    lines.push(`- Check stk_health before debugging production issues`);
+    lines.push(`- Use stk_brain_search to find how other projects solve similar problems`);
+    lines.push(`- Save useful patterns with stk_brain_learn for future reference`);
+    lines.push("");
+    // Environment
+    lines.push(`## Environment Variables\n`);
+    lines.push(`Environment variables are managed via \`.env\` files. See \`.env.example\` for required variables.`);
+    if (enabled.includes("vercel"))
+        lines.push(`Use \`stk_env_sync\` to compare local vs remote env vars.`);
+    lines.push("");
+    const content = lines.join("\n");
+    if (write) {
+        const { writeFileSync } = await import("fs");
+        writeFileSync("CLAUDE.md", content);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ written: true, path: "CLAUDE.md", lines: content.split("\n").length }, null, 2),
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({ preview: true, content, note: "Call again with write: true to save to disk" }, null, 2),
+            }],
+    };
+});
 // Helper
 function detectGitHubRepo() {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prajwolkc/stk",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "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",
@@ -35,7 +35,7 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "scripts": {
     "build": "tsc",