superkit-mcp-server 1.2.3 → 1.2.5

package/build/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import * as path from "path";
 import * as fs from "fs/promises";
 import * as toml from "@iarna/toml";
@@ -11,11 +11,11 @@ import { manageSession } from "./tools/sessionManager.js";
 import { runChecklist } from "./tools/checklist.js";
 import { runVerifyAll } from "./tools/verifyAll.js";
 import { logSkill, logWorkflow, rotateLogs } from "./tools/loggerTools.js";
-import { getNextTodoId, createTodo, startTodo, doneTodo, completeTodo } from "./tools/todoTools.js";
-import { compoundSearch, updateSolutionRef, validateCompound, auditStateDrift, suggestSkills, compoundHealth, compoundDashboard, compoundMetrics } from "./tools/compoundTools.js";
-import { bootstrapFolderDocs, checkDocsFreshness, discoverUndocumentedFolders, validateFolderDocs } from "./tools/docsTools.js";
-import { generateChangelog, validateChangelog, archiveCompleted, prePushHousekeeping } from "./tools/gitTools.js";
-import { validateSpecConsistency, completePlan, validateArchitecture, syncSpec, updateSpecPhase } from "./tools/archTools.js";
+import { getNextTodoId, createTodo, startTodo, doneTodo, completeTodo, } from "./tools/todoTools.js";
+import { compoundSearch, updateSolutionRef, validateCompound, auditStateDrift, suggestSkills, compoundHealth, compoundDashboard, compoundMetrics, } from "./tools/compoundTools.js";
+import { bootstrapFolderDocs, checkDocsFreshness, discoverUndocumentedFolders, validateFolderDocs, } from "./tools/docsTools.js";
+import { generateChangelog, validateChangelog, archiveCompleted, prePushHousekeeping, } from "./tools/gitTools.js";
+import { validateSpecConsistency, completePlan, validateArchitecture, syncSpec, updateSpecPhase, } from "./tools/archTools.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const superKitRoot = path.resolve(__dirname, "../");
@@ -32,7 +32,7 @@ const server = new Server({
 async function listDirectorySafe(dirPath) {
     try {
         const entries = await fs.readdir(dirPath, { withFileTypes: true });
-        return entries.map((entry) => (entry.isDirectory() ? `${entry.name}/` : entry.name));
+        return entries.map((entry) => entry.isDirectory() ? `${entry.name}/` : entry.name);
     }
     catch (err) {
         return [];
@@ -56,10 +56,10 @@ const TOOLS = [
             type: "object",
             properties: {
                 action: { type: "string", enum: ["start", "stop", "status"] },
-                port: { type: "number", default: 3000 }
+                port: { type: "number", default: 3000 },
             },
             required: ["action"],
-        }
+        },
     },
     {
         name: "call_tool_session_manager",
@@ -68,10 +68,10 @@ const TOOLS = [
             type: "object",
             properties: {
                 command: { type: "string", enum: ["status", "info"] },
-                path: { type: "string", default: "." }
+                path: { type: "string", default: "." },
             },
             required: ["command"],
-        }
+        },
     },
     {
         name: "call_tool_checklist",
@@ -81,10 +81,10 @@ const TOOLS = [
             properties: {
                 projectPath: { type: "string", default: "." },
                 url: { type: "string" },
-                skipPerformance: { type: "boolean", default: false }
+                skipPerformance: { type: "boolean", default: false },
             },
-            required: ["projectPath"]
-        }
+            required: ["projectPath"],
+        },
     },
     {
         name: "call_tool_verify_all",
@@ -95,10 +95,10 @@ const TOOLS = [
                 projectPath: { type: "string", default: "." },
                 url: { type: "string" },
                 skipE2E: { type: "boolean", default: false },
-                stopOnFail: { type: "boolean", default: false }
+                stopOnFail: { type: "boolean", default: false },
             },
-            required: ["projectPath", "url"]
-        }
+            required: ["projectPath", "url"],
+        },
     },
     {
         name: "call_tool_logger_manager",
@@ -106,13 +106,16 @@ const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                action: { type: "string", enum: ["logSkill", "logWorkflow", "rotateLogs"] },
+                action: {
+                    type: "string",
+                    enum: ["logSkill", "logWorkflow", "rotateLogs"],
+                },
                 name: { type: "string" },
                 outcome: { type: "string" },
-                projectPath: { type: "string", default: "." }
+                projectPath: { type: "string", default: "." },
             },
-            required: ["action", "projectPath"]
-        }
+            required: ["action", "projectPath"],
+        },
     },
     {
         name: "call_tool_todo_manager",
@@ -120,16 +123,20 @@ const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                action: { type: "string", enum: ["nextId", "create", "start", "done", "complete"] },
+                action: {
+                    type: "string",
+                    enum: ["nextId", "create", "start", "done", "complete"],
+                },
                 title: { type: "string" },
                 description: { type: "string" },
-                priority: { type: "number" },
+                priority: { type: "string" },
+                criteria: { type: "array", items: { type: "string" } },
                 todoId: { type: "string" },
                 force: { type: "boolean", default: false },
-                projectPath: { type: "string", default: "." }
+                projectPath: { type: "string", default: "." },
             },
-            required: ["action", "projectPath"]
-        }
+            required: ["action", "projectPath"],
+        },
     },
     {
         name: "call_tool_compound_manager",
@@ -137,15 +144,27 @@ const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                action: { type: "string", enum: ["search", "updateRef", "validate", "auditDrift", "suggestSkills", "health", "dashboard", "metrics"] },
+                action: {
+                    type: "string",
+                    enum: [
+                        "search",
+                        "updateRef",
+                        "validate",
+                        "auditDrift",
+                        "suggestSkills",
+                        "health",
+                        "dashboard",
+                        "metrics",
+                    ],
+                },
                 terms: { type: "array", items: { type: "string" } },
                 files: { type: "array", items: { type: "string" } },
                 fix: { type: "boolean", default: false },
                 force: { type: "boolean", default: false },
-                projectPath: { type: "string", default: "." }
+                projectPath: { type: "string", default: "." },
             },
-            required: ["action", "projectPath"]
-        }
+            required: ["action", "projectPath"],
+        },
     },
     {
         name: "call_tool_docs_manager",
@@ -153,15 +172,18 @@ const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                action: { type: "string", enum: ["bootstrap", "freshness", "discover", "validate"] },
+                action: {
+                    type: "string",
+                    enum: ["bootstrap", "freshness", "discover", "validate"],
+                },
                 folder: { type: "string" },
                 skipDocs: { type: "boolean", default: false },
                 strict: { type: "boolean", default: false },
                 targetFolders: { type: "array", items: { type: "string" } },
-                projectPath: { type: "string", default: "." }
+                projectPath: { type: "string", default: "." },
             },
-            required: ["action", "projectPath"]
-        }
+            required: ["action", "projectPath"],
+        },
     },
     {
         name: "call_tool_git_manager",
@@ -169,12 +191,15 @@ const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                action: { type: "string", enum: ["changelog", "validateChangelog", "archive", "housekeeping"] },
+                action: {
+                    type: "string",
+                    enum: ["changelog", "validateChangelog", "archive", "housekeeping"],
+                },
                 applyFix: { type: "boolean", default: false },
-                projectPath: { type: "string", default: "." }
+                projectPath: { type: "string", default: "." },
             },
-            required: ["action", "projectPath"]
-        }
+            required: ["action", "projectPath"],
+        },
     },
     {
         name: "call_tool_arch_manager",
@@ -182,17 +207,26 @@ const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                action: { type: "string", enum: ["validateSpecs", "completePlan", "validateArch", "syncSpec", "updatePhase"] },
+                action: {
+                    type: "string",
+                    enum: [
+                        "validateSpecs",
+                        "completePlan",
+                        "validateArch",
+                        "syncSpec",
+                        "updatePhase",
+                    ],
+                },
                 planFile: { type: "string" },
                 force: { type: "boolean", default: false },
                 specDir: { type: "string" },
                 specName: { type: "string" },
                 phaseNum: { type: "string" },
                 status: { type: "string" },
-                projectPath: { type: "string", default: "." }
+                projectPath: { type: "string", default: "." },
             },
-            required: ["action", "projectPath"]
-        }
+            required: ["action", "projectPath"],
+        },
     },
     {
         name: "list_superkit_assets",
@@ -369,7 +403,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             if (args.action === "nextId")
                 res = String(await getNextTodoId(args.projectPath));
             else if (args.action === "create")
-                res = await createTodo(args.title, args.description, args.priority, args.projectPath);
+                res = await createTodo(String(args.priority ?? "p3"), args.title, args.description, args.criteria || [], args.projectPath);
             else if (args.action === "start")
                 res = await startTodo(args.todoId, args.force, args.projectPath);
             else if (args.action === "done")
@@ -497,7 +531,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const fallbackSafePath = getSafePath(path.join(superKitRoot, "skills"), path.join(args.category, args.skillName));
                 if (fallbackSafePath) {
                     const items = await listDirectorySafe(fallbackSafePath);
-                    return { content: [{ type: "text", text: `SKILL.md not found. Directory contains: ${items.join(', ')}` }] };
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `SKILL.md not found. Directory contains: ${items.join(", ")}`,
+                            },
+                        ],
+                    };
                 }
                 throw e;
             }
@@ -518,7 +559,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
     catch (error) {
         return {
-            content: [{ type: "text", text: `Error executing tool: ${error.message}` }],
+            content: [
+                { type: "text", text: `Error executing tool: ${error.message}` },
+            ],
             isError: true,
         };
     }

package/build/tools/sessionManager.js

@@ -4,11 +4,18 @@ export async function manageSession(command, rootPath = '.') {
     const root = path.resolve(rootPath);
     const pkgPath = path.join(root, 'package.json');
     const getPackageInfo = async () => {
+        let name = root.split(path.sep).pop() || 'unnamed';
+        let version = '0.0.0';
+        const stack = [];
+        let scripts = [];
+        // 1. Node.js Check
         try {
             const data = await fs.readFile(pkgPath, 'utf8');
             const pkg = JSON.parse(data);
+            name = pkg.name || name;
+            version = pkg.version || version;
+            scripts = Object.keys(pkg.scripts || {});
             const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
-            const stack = [];
             if (allDeps['next'])
                 stack.push("Next.js");
             else if (allDeps['react'])
@@ -27,16 +34,69 @@ export async function manageSession(command, rootPath = '.') {
                 stack.push("Prisma");
             if (allDeps['typescript'])
                 stack.push("TypeScript");
-            return {
-                name: pkg.name || 'unnamed',
-                version: pkg.version || '0.0.0',
-                stack,
-                scripts: Object.keys(pkg.scripts || {})
-            };
+            if (stack.length === 0)
+                stack.push("Node.js");
         }
-        catch (e) {
-            return { name: root.split(path.sep).pop() || 'unnamed', version: '0.0.0', stack: ['Generic'], scripts: [] };
+        catch { }
+        // 2. Polyglot Checks
+        try {
+            const files = await fs.readdir(root);
+            // Python
+            if (files.includes('requirements.txt') || files.includes('Pipfile') || files.includes('pyproject.toml')) {
+                if (!stack.includes("Python"))
+                    stack.push("Python");
+                if (files.includes('manage.py'))
+                    stack.push("Django");
+                if (files.includes('requirements.txt')) {
+                    const content = await fs.readFile(path.join(root, 'requirements.txt'), 'utf8');
+                    if (content.includes('flask'))
+                        stack.push("Flask");
+                    if (content.includes('fastapi'))
+                        stack.push("FastAPI");
+                    if (content.includes('django') && !stack.includes("Django"))
+                        stack.push("Django");
+                }
+            }
+            // Go
+            if (files.includes('go.mod'))
+                stack.push("Go");
+            // Rust
+            if (files.includes('Cargo.toml'))
+                stack.push("Rust");
+            // Java / Kotlin
+            if (files.includes('pom.xml'))
+                stack.push("Java (Maven)");
+            if (files.includes('build.gradle') || files.includes('build.gradle.kts'))
+                stack.push("Java/Kotlin (Gradle)");
+            // PHP
+            if (files.includes('composer.json')) {
+                if (!stack.includes("PHP"))
+                    stack.push("PHP");
+                try {
+                    const composer = JSON.parse(await fs.readFile(path.join(root, 'composer.json'), 'utf8'));
+                    const deps = { ...(composer.require || {}), ...(composer['require-dev'] || {}) };
+                    if (deps['laravel/framework'])
+                        stack.push("Laravel");
+                    if (deps['symfony/framework-bundle'])
+                        stack.push("Symfony");
+                }
+                catch { }
+            }
+            // Infrastructure
+            if (files.includes('Dockerfile') || files.includes('docker-compose.yml'))
+                stack.push("Docker");
+            if (files.some(f => f.endsWith('.tf')))
+                stack.push("Terraform");
         }
+        catch { }
+        if (stack.length === 0)
+            stack.push("Generic");
+        return {
+            name,
+            version,
+            stack: Array.from(new Set(stack)),
+            scripts
+        };
     };
     const countFiles = async (dir) => {
         let count = 0;
@@ -91,7 +151,16 @@ export async function manageSession(command, rootPath = '.') {
         output += `📁 Project: ${info.name}\n`;
         output += `📂 Path: ${root}\n`;
         output += `🏷️  Type: ${info.stack.join(', ')}\n`;
-        output += `📊 Status: Active\n\n`;
+        // Check for active todos to determine status
+        let status = 'Idle';
+        try {
+            const todos = await fs.readdir(path.join(root, 'todos'));
+            const hasActive = todos.some(f => f.endsWith('.md') && !f.includes('template') && !f.includes('archive'));
+            if (hasActive)
+                status = 'Active';
+        }
+        catch { }
+        output += `📊 Status: ${status}\n\n`;
         output += `🔧 Tech Stack:\n`;
         for (const tech of info.stack)
             output += `   • ${tech}\n`;

package/commands/plan.toml

@@ -1,4 +1,4 @@
-description = "Create detailed implementation plans (Planner Agent)"
+description = "Create detailed implementation plans and auto-create a task (Planner Agent)"
 
 prompt = """
 # 📋 PLANNER AGENT
@@ -153,6 +153,40 @@ When fixing complex bugs:
 ## OUTPUT
 Save to: `plans/[feature-name]-YYYYMMDD.md`
 
+---
+
+## AUTO-TASK CREATION (MANDATORY)
+
+After saving the plan file, you **MUST** automatically create a todo task using the `call_tool_todo_manager` tool.
+
+**Do NOT ask the user — just do it.**
+
+Call the tool with:
+- `action`: `"create"`
+- `title`: The feature/task name from the plan (e.g., `"Add user authentication"`)
+- `description`: A 1-2 sentence summary of what the plan covers
+- `priority`: `"p2"` by default (use `"p1"` for urgent/critical, `"p3"` for low-impact)
+- `criteria`: The top acceptance criteria extracted from the plan (as a string array)
+- `projectPath`: `"."`
+
+Example tool call:
+```json
+{
+  "action": "create",
+  "title": "Add user authentication",
+  "description": "Implement JWT-based authentication with login, logout, and protected routes.",
+  "priority": "p2",
+  "criteria": [
+    "User can log in with email and password",
+    "JWT token is issued and stored securely",
+    "Protected routes redirect unauthenticated users"
+  ],
+  "projectPath": "."
+}
+```
+
+After the todo is created, confirm to the user with the todo ID and file path returned by the tool.
+
 ## NEXT STEPS
 ```bash
 # Ready? Run:
@@ -165,8 +199,8 @@ Save to: `plans/[feature-name]-YYYYMMDD.md`
 # ---
 # USAGE:
 # /plan Add user authentication
-# /plan:two REST vs GraphQL for mobile app  
+# /plan:two REST vs GraphQL for mobile app
 # /plan:hard Fix checkout race condition causing double charges
 # /plan:cro Improve signup conversion rate
 # /plan:ci Fix failing GitHub Actions workflow
-# ---
+# ---

package/package.json

@@ -1,36 +1,36 @@
-{
-    "name": "superkit-mcp-server",
-    "version": "1.2.3",
-    "type": "module",
-    "description": "An MCP server for exploring and loading Super-Kit AI agent resources.",
-    "main": "build/index.js",
-    "bin": {
-        "superkit-mcp-server": "./build/index.js"
-    },
-    "scripts": {
-        "build": "tsc",
-        "start": "node build/index.js",
-        "dev": "tsc --watch"
-    },
-    "dependencies": {
-        "@iarna/toml": "^2.2.5",
-        "@modelcontextprotocol/sdk": "^1.4.1",
-        "playwright": "^1.58.2",
-        "toml": "^3.0.0",
-        "zod": "^3.23.8"
-    },
-    "devDependencies": {
-        "@types/node": "^22.19.13",
-        "typescript": "^5.7.2",
-        "vitest": "^4.0.18"
-    },
-    "files": [
-        "build/",
-        "agents/",
-        "skills/",
-        "commands/",
-        "SUPERKIT.md",
-        "README.md",
-        "ARCHITECTURE.md"
-    ]
-}
+{
+  "name": "superkit-mcp-server",
+  "version": "1.2.5",
+  "type": "module",
+  "description": "An MCP server for exploring and loading Super-Kit AI agent resources.",
+  "main": "build/index.js",
+  "bin": {
+    "superkit-mcp-server": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "@modelcontextprotocol/sdk": "^1.4.1",
+    "playwright": "^1.58.2",
+    "toml": "^3.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.13",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "files": [
+    "build/",
+    "agents/",
+    "skills/",
+    "commands/",
+    "SUPERKIT.md",
+    "README.md",
+    "ARCHITECTURE.md"
+  ]
+}