superkit-mcp-server 1.0.2 → 1.1.0

package/build/tools/validators/__tests__/mobileAudit.test.js

@@ -11,16 +11,16 @@ describe('mobileAudit', () => {
                 name: 'Screen.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            import React from 'react';
-            import { View, ScrollView } from 'react-native';
-            export const Screen = () => {
-                return (
-                    <ScrollView>
-                       {data.map(d => <View key={index} />)}
-                    </ScrollView>
-                )
-            }
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            import React from 'react';
+            import { View, ScrollView } from 'react-native';
+            export const Screen = () => {
+                return (
+                    <ScrollView>
+                       {data.map(d => <View key={index} />)}
+                    </ScrollView>
+                )
+            }
         `);
         const res = await runMobileAudit('.');
         expect(res.passed).toBe(false);
@@ -31,8 +31,8 @@ describe('mobileAudit', () => {
                 name: 'regular.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            export const App = () => <div>Hello Web</div>
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            export const App = () => <div>Hello Web</div>
         `);
         const res = await runMobileAudit('.');
         expect(res.passed).toBe(true);

package/build/tools/validators/__tests__/reactPerformanceChecker.test.js

@@ -11,14 +11,14 @@ describe('reactPerformanceChecker', () => {
                 name: 'Home.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            import { something } from '@/components/index';
-            
-            async function loadData() {
-                const a = await fetchA();
-                const b = await fetchB();
-                return { a, b };
-            }
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            import { something } from '@/components/index';
+            
+            async function loadData() {
+                const a = await fetchA();
+                const b = await fetchB();
+                return { a, b };
+            }
         `);
         const res = await runReactPerformanceChecker('.');
         console.log("RPC BAD REPORT:", res.report);
@@ -31,15 +31,15 @@ describe('reactPerformanceChecker', () => {
                 name: 'App.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            import { useQuery } from '@tanstack/react-query';
-            import Image from 'next/image';
-            
-            const App = React.memo((props: Props) => {
-                const q = useQuery('data', fetchParallel);
-                return <Image src="foo" alt="bar" />
-            });
-            export default App;
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            import { useQuery } from '@tanstack/react-query';
+            import Image from 'next/image';
+            
+            const App = React.memo((props: Props) => {
+                const q = useQuery('data', fetchParallel);
+                return <Image src="foo" alt="bar" />
+            });
+            export default App;
         `);
         const res = await runReactPerformanceChecker('.');
         console.log("RPC GOOD REPORT:", res.report);

package/build/tools/validators/__tests__/securityScan.test.js

@@ -13,8 +13,8 @@ describe('securityScan', () => {
                     name: 'config.json',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 { "aws_key": "AKIA1234567890123456" }
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 { "aws_key": "AKIA1234567890123456" }
              `);
             const result = await scanSecrets('/mock');
             expect(result.findings).toBeDefined();
@@ -28,10 +28,10 @@ describe('securityScan', () => {
                     name: 'bad_code.js',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 eval('2 + 2');
-                 import { exec } from 'child_process';
-                 child_process.exec('rm -rf /');
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 eval('2 + 2');
+                 import { exec } from 'child_process';
+                 child_process.exec('rm -rf /');
              `);
             const result = await scanCodePatterns('/mock');
             expect(result.findings.length).toBeGreaterThan(1);

package/build/tools/validators/__tests__/seoChecker.test.js

@@ -11,22 +11,22 @@ describe('seoChecker', () => {
                 name: 'index.tsx', // valid page layout file
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            export default function Index() {
-                return (
-                    <html>
-                        <head>
-                            <title>Oops missing description and og</title>
-                        </head>
-                        <body>
-                            <h1>Title</h1>
-                            <h1>Duplicate Title</h1>
-                            <img src="foo" />
-                            <img src="bar" alt="" />
-                        </body>
-                    </html>
-                )
-            }
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            export default function Index() {
+                return (
+                    <html>
+                        <head>
+                            <title>Oops missing description and og</title>
+                        </head>
+                        <body>
+                            <h1>Title</h1>
+                            <h1>Duplicate Title</h1>
+                            <img src="foo" />
+                            <img src="bar" alt="" />
+                        </body>
+                    </html>
+                )
+            }
         `);
         const res = await runSeoChecker('.');
         expect(res.passed).toBe(false);

package/build/tools/validators/__tests__/typeCoverage.test.js

@@ -14,9 +14,9 @@ describe('typeCoverage', () => {
                     isDirectory: () => false
                 }]);
             // Mock readFile to return a snippet with an untyped function and an "any"
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                function test(): any { return 1; }
-                const test2 = (x) => console.log(x);
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                function test(): any { return 1; }
+                const test2 = (x) => console.log(x);
             `);
             const result = await checkTypescriptCoverage('/mock/folder');
             expect(result.type).toBe('typescript');
@@ -29,8 +29,8 @@ describe('typeCoverage', () => {
                     name: 'good.ts',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                function typedFunc(val: string): number { return val.length; }
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                function typedFunc(val: string): number { return val.length; }
             `);
             const result = await checkTypescriptCoverage('/mock/good');
             expect(result.stats.any_count).toBe(0);
@@ -44,15 +44,15 @@ describe('typeCoverage', () => {
                     name: 'script.py',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-def bad_func(arg):
-    pass
-    
-def good_func(arg: str) -> bool:
-    return True
-    
-def any_func(arg: Any) -> Any:
-    pass
+            vi.mocked(fs.readFile).mockResolvedValue(`
+def bad_func(arg):
+    pass
+    
+def good_func(arg: str) -> bool:
+    return True
+    
+def any_func(arg: Any) -> Any:
+    pass
              `);
             const result = await checkPythonCoverage('/mock/py');
             expect(result.stats.any_count).toBeGreaterThan(0);

package/package.json

@@ -1,34 +1,34 @@
-{
-    "name": "superkit-mcp-server",
-    "version": "1.0.2",
-    "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": {
-        "@modelcontextprotocol/sdk": "^1.4.1",
-        "playwright": "^1.58.2",
-        "zod": "^3.23.8"
-    },
-    "devDependencies": {
-        "@types/node": "^22.19.13",
-        "typescript": "^5.7.2",
-        "vitest": "^4.0.18"
-    },
-    "files": [
-        "build/",
-        "agents/",
-        "skills/",
-        "workflows/",
-        "SUPERKIT.md",
-        "README.md",
-        "ARCHITECTURE.md"
-    ]
+{
+    "name": "superkit-mcp-server",
+    "version": "1.1.0",
+    "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": {
+        "@modelcontextprotocol/sdk": "^1.4.1",
+        "playwright": "^1.58.2",
+        "zod": "^3.23.8"
+    },
+    "devDependencies": {
+        "@types/node": "^22.19.13",
+        "typescript": "^5.7.2",
+        "vitest": "^4.0.18"
+    },
+    "files": [
+        "build/",
+        "agents/",
+        "skills/",
+        "workflows/",
+        "SUPERKIT.md",
+        "README.md",
+        "ARCHITECTURE.md"
+    ]
 }

package/skills/meta/README.md

@@ -1,30 +1,30 @@
-# Agent Skills & Capabilities
-
-## Purpose
-The "brain" of the AI Agent. This directory contains the definitions, memories, and tools that enable the Agent to work effectively on the codebase.
-
-## Components
-
-| Component | Description |
-|-----------|-------------|
-| `compound-docs/` | Templates and logic for the Compounding Knowledge system. |
-| `file-todos/` | Logic for the file-based task management system. |
-| `session-resume/` | Context restoration protocols for new sessions. |
-| `code-review/` | Checklists and workflows for automated code review. |
-| `testing/` | Custom testing infrastructure and patterns. |
-| `debug/` | Root-cause analysis and debugging protocols. |
-| `react-hooks/` | Best practices and patterns for React development. |
-| `examples/` | Project-specific or optional skill examples (e.g. Supabase). |
-
-## Component Details
-
-### `compound-docs/`
-Contains the `SKILL.md` instruction set and template files used by the `/compound` workflow to generate persistent documentation.
-
-### `file-todos/`
-Contains the logic for managing the `todos/` directory, including status transitions and priority handling.
-
-## Changelog
-
-### 2025-12-23
-- Initialized README documentation.
+# Agent Skills & Capabilities
+
+## Purpose
+The "brain" of the AI Agent. This directory contains the definitions, memories, and tools that enable the Agent to work effectively on the codebase.
+
+## Components
+
+| Component | Description |
+|-----------|-------------|
+| `compound-docs/` | Templates and logic for the Compounding Knowledge system. |
+| `file-todos/` | Logic for the file-based task management system. |
+| `session-resume/` | Context restoration protocols for new sessions. |
+| `code-review/` | Checklists and workflows for automated code review. |
+| `testing/` | Custom testing infrastructure and patterns. |
+| `debug/` | Root-cause analysis and debugging protocols. |
+| `react-hooks/` | Best practices and patterns for React development. |
+| `examples/` | Project-specific or optional skill examples (e.g. Supabase). |
+
+## Component Details
+
+### `compound-docs/`
+Contains the `SKILL.md` instruction set and template files used by the `/compound` workflow to generate persistent documentation.
+
+### `file-todos/`
+Contains the logic for managing the `todos/` directory, including status transitions and priority handling.
+
+## Changelog
+
+### 2025-12-23
+- Initialized README documentation.

package/skills/meta/api-design/SKILL.md

@@ -1,134 +1,134 @@
-# API Design Skill
-
-## Overview
-RESTful API patterns, GraphQL design, and API best practices.
-
-## RESTful Design Principles
-
-### 1. Resource Naming
-```
-✅ Good:
-GET    /users          # List users
-GET    /users/123      # Get user
-POST   /users          # Create user
-PUT    /users/123      # Update user
-DELETE /users/123      # Delete user
-
-❌ Bad:
-GET /getUsers
-POST /createUser
-GET /user/delete/123
-```
-
-### 2. HTTP Status Codes
-```typescript
-// Success
-200 OK           - Successful GET/PUT
-201 Created      - Successful POST
-204 No Content   - Successful DELETE
-
-// Client Errors
-400 Bad Request      - Invalid input
-401 Unauthorized     - Auth required
-403 Forbidden        - No permission
-404 Not Found        - Resource doesn't exist
-422 Unprocessable    - Validation failed
-
-// Server Errors
-500 Internal Error   - Server bug
-503 Service Unavailable - Maintenance
-```
-
-### 3. Response Format
-```typescript
-// Success response
-{
-  "data": {
-    "id": "123",
-    "name": "John",
-    "email": "john@example.com"
-  }
-}
-
-// Error response
-{
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Email is required",
-    "details": [
-      { "field": "email", "message": "This field is required" }
-    ]
-  }
-}
-
-// List with pagination
-{
-  "data": [...],
-  "meta": {
-    "page": 1,
-    "perPage": 20,
-    "total": 150,
-    "totalPages": 8
-  }
-}
-```
-
-### 4. Pagination
-```typescript
-// Offset-based
-GET /posts?page=2&limit=20
-
-// Cursor-based (better for large datasets)
-GET /posts?cursor=abc123&limit=20
-```
-
-### 5. Filtering & Sorting
-```typescript
-// Filtering
-GET /posts?status=published&author=123
-
-// Sorting
-GET /posts?sort=-createdAt,title  // - for DESC
-```
-
-## API Versioning
-```typescript
-// URL versioning (recommended)
-GET /api/v1/users
-
-// Header versioning
-GET /api/users
-Accept: application/vnd.myapp.v1+json
-```
-
-## Rate Limiting
-```typescript
-import rateLimit from 'express-rate-limit';
-
-const limiter = rateLimit({
-  windowMs: 15 * 60 * 1000, // 15 minutes
-  max: 100, // 100 requests per window
-  message: { error: 'Too many requests' },
-});
-
-app.use('/api/', limiter);
-```
-
-## Input Validation
-```typescript
-import { z } from 'zod';
-
-const CreateUserSchema = z.object({
-  name: z.string().min(2).max(100),
-  email: z.string().email(),
-  age: z.number().int().min(0).max(150).optional(),
-});
-
-function createUser(req, res) {
-  const result = CreateUserSchema.safeParse(req.body);
-  if (!result.success) {
-    return res.status(422).json({ error: result.error });
-  }
-  // Process validated data
-}
-```
+# API Design Skill
+
+## Overview
+RESTful API patterns, GraphQL design, and API best practices.
+
+## RESTful Design Principles
+
+### 1. Resource Naming
+```
+✅ Good:
+GET    /users          # List users
+GET    /users/123      # Get user
+POST   /users          # Create user
+PUT    /users/123      # Update user
+DELETE /users/123      # Delete user
+
+❌ Bad:
+GET /getUsers
+POST /createUser
+GET /user/delete/123
+```
+
+### 2. HTTP Status Codes
+```typescript
+// Success
+200 OK           - Successful GET/PUT
+201 Created      - Successful POST
+204 No Content   - Successful DELETE
+
+// Client Errors
+400 Bad Request      - Invalid input
+401 Unauthorized     - Auth required
+403 Forbidden        - No permission
+404 Not Found        - Resource doesn't exist
+422 Unprocessable    - Validation failed
+
+// Server Errors
+500 Internal Error   - Server bug
+503 Service Unavailable - Maintenance
+```
+
+### 3. Response Format
+```typescript
+// Success response
+{
+  "data": {
+    "id": "123",
+    "name": "John",
+    "email": "john@example.com"
+  }
+}
+
+// Error response
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Email is required",
+    "details": [
+      { "field": "email", "message": "This field is required" }
+    ]
+  }
+}
+
+// List with pagination
+{
+  "data": [...],
+  "meta": {
+    "page": 1,
+    "perPage": 20,
+    "total": 150,
+    "totalPages": 8
+  }
+}
+```
+
+### 4. Pagination
+```typescript
+// Offset-based
+GET /posts?page=2&limit=20
+
+// Cursor-based (better for large datasets)
+GET /posts?cursor=abc123&limit=20
+```
+
+### 5. Filtering & Sorting
+```typescript
+// Filtering
+GET /posts?status=published&author=123
+
+// Sorting
+GET /posts?sort=-createdAt,title  // - for DESC
+```
+
+## API Versioning
+```typescript
+// URL versioning (recommended)
+GET /api/v1/users
+
+// Header versioning
+GET /api/users
+Accept: application/vnd.myapp.v1+json
+```
+
+## Rate Limiting
+```typescript
+import rateLimit from 'express-rate-limit';
+
+const limiter = rateLimit({
+  windowMs: 15 * 60 * 1000, // 15 minutes
+  max: 100, // 100 requests per window
+  message: { error: 'Too many requests' },
+});
+
+app.use('/api/', limiter);
+```
+
+## Input Validation
+```typescript
+import { z } from 'zod';
+
+const CreateUserSchema = z.object({
+  name: z.string().min(2).max(100),
+  email: z.string().email(),
+  age: z.number().int().min(0).max(150).optional(),
+});
+
+function createUser(req, res) {
+  const result = CreateUserSchema.safeParse(req.body);
+  if (!result.success) {
+    return res.status(422).json({ error: result.error });
+  }
+  // Process validated data
+}
+```