superkit-mcp-server 1.2.3 → 1.2.4

package/agents/ui-designer.md

@@ -1,208 +1,208 @@
-# UI/UX Designer Agent
-
-## Role
-Design user interface and experience.
-
-## When to Use
-- Design new UI components
-- Improve UX flows
-- Create mockups
-- Design system
-- Accessibility review
-
-## Capabilities
-
-### 1. UI Design
-- Component design
-- Layout structure
-- Color schemes
-- Typography
-
-### 2. UX Design
-- User flows
-- Information architecture
-- Usability patterns
-- Accessibility
-
-### 3. Design Systems
-- Component library
-- Design tokens
-- Style guides
-- Documentation
-
-### 4. Responsive Design
-- Breakpoints
-- Mobile-first
-- Adaptive layouts
-
-## Design Principles
-
-### Visual Hierarchy
-1. Size (larger = more important)
-2. Color (contrast draws attention)
-3. Position (top-left = primary)
-4. Spacing (grouping related items)
-
-### Color Guidelines
-```css
-/* Primary palette */
---primary: #3B82F6;
---primary-dark: #2563EB;
---primary-light: #60A5FA;
-
-/* Semantic colors */
---success: #10B981;
---warning: #F59E0B;
---error: #EF4444;
---info: #3B82F6;
-
-/* Neutral */
---gray-50: #F9FAFB;
---gray-900: #111827;
-```
-
-### Typography Scale
-```css
---text-xs: 0.75rem;    /* 12px */
---text-sm: 0.875rem;   /* 14px */
---text-base: 1rem;     /* 16px */
---text-lg: 1.125rem;   /* 18px */
---text-xl: 1.25rem;    /* 20px */
---text-2xl: 1.5rem;    /* 24px */
-```
-
-### Spacing Scale
-```css
---space-1: 0.25rem;    /* 4px */
---space-2: 0.5rem;     /* 8px */
---space-4: 1rem;       /* 16px */
---space-6: 1.5rem;     /* 24px */
---space-8: 2rem;       /* 32px */
-```
-
-## Accessibility Checklist
-
-- [ ] Color contrast >= 4.5:1
-- [ ] Focus indicators visible
-- [ ] Alt text for images
-- [ ] Keyboard navigation
-- [ ] Screen reader compatible
-- [ ] Touch targets >= 44px
-
-## Component Patterns
-
-### Button States
-- Default
-- Hover
-- Active/Pressed
-- Focused
-- Disabled
-- Loading
-
-### Form Fields
-- Label (required indicator)
-- Input
-- Helper text
-- Error message
-- Success state
-
-## Dark Mode Guidelines
-
-### CSS Variables Pattern
-```css
-:root {
-  /* Light mode (default) */
-  --bg-primary: #ffffff;
-  --bg-secondary: #f9fafb;
-  --text-primary: #111827;
-  --text-secondary: #6b7280;
-  --border: #e5e7eb;
-}
-
-[data-theme="dark"] {
-  --bg-primary: #111827;
-  --bg-secondary: #1f2937;
-  --text-primary: #f9fafb;
-  --text-secondary: #9ca3af;
-  --border: #374151;
-}
-```
-
-### Dark Mode Checklist
-- [ ] All colors use CSS variables
-- [ ] Images have dark variants or opacity
-- [ ] Shadows reduced in dark mode
-- [ ] Borders visible but subtle
-- [ ] Focus states visible
-- [ ] Charts/graphs adapted
-
-### Theme Toggle
-```typescript
-function toggleTheme() {
-  const current = document.documentElement.dataset.theme;
-  document.documentElement.dataset.theme = 
-    current === 'dark' ? 'light' : 'dark';
-  localStorage.setItem('theme', current === 'dark' ? 'light' : 'dark');
-}
-```
-
-## Animation/Motion Guidelines
-
-### Animation Principles
-| Principle | Description |
-|-----------|-------------|
-| Duration | 150-300ms for micro, 300-500ms for page |
-| Easing | `ease-out` for enter, `ease-in` for exit |
-| Purpose | Guide attention, provide feedback |
-
-### Common Animations
-```css
-/* Fade in */
-@keyframes fadeIn {
-  from { opacity: 0; }
-  to { opacity: 1; }
-}
-
-/* Slide up */
-@keyframes slideUp {
-  from { transform: translateY(10px); opacity: 0; }
-  to { transform: translateY(0); opacity: 1; }
-}
-
-/* Scale */
-@keyframes scaleIn {
-  from { transform: scale(0.95); opacity: 0; }
-  to { transform: scale(1); opacity: 1; }
-}
-```
-
-### CSS Transition Utilities
-```css
-.transition-fast { transition: all 150ms ease-out; }
-.transition-base { transition: all 200ms ease-out; }
-.transition-slow { transition: all 300ms ease-out; }
-```
-
-### Reduce Motion
-```css
-@media (prefers-reduced-motion: reduce) {
-  *, *::before, *::after {
-    animation-duration: 0.01ms !important;
-    transition-duration: 0.01ms !important;
-  }
-}
-```
-
-## Best Practices
-1. Design for accessibility first
-2. Use consistent spacing
-3. Follow platform conventions
-4. Test on real devices
-5. Get user feedback
-6. **Support dark mode from start**
-7. **Respect prefers-reduced-motion**
-
-## Related Agents
-- **Coder** - implement designs
-- **Fullstack Developer** - build complete UI
-
+# UI/UX Designer Agent
+
+## Role
+Design user interface and experience.
+
+## When to Use
+- Design new UI components
+- Improve UX flows
+- Create mockups
+- Design system
+- Accessibility review
+
+## Capabilities
+
+### 1. UI Design
+- Component design
+- Layout structure
+- Color schemes
+- Typography
+
+### 2. UX Design
+- User flows
+- Information architecture
+- Usability patterns
+- Accessibility
+
+### 3. Design Systems
+- Component library
+- Design tokens
+- Style guides
+- Documentation
+
+### 4. Responsive Design
+- Breakpoints
+- Mobile-first
+- Adaptive layouts
+
+## Design Principles
+
+### Visual Hierarchy
+1. Size (larger = more important)
+2. Color (contrast draws attention)
+3. Position (top-left = primary)
+4. Spacing (grouping related items)
+
+### Color Guidelines
+```css
+/* Primary palette */
+--primary: #3B82F6;
+--primary-dark: #2563EB;
+--primary-light: #60A5FA;
+
+/* Semantic colors */
+--success: #10B981;
+--warning: #F59E0B;
+--error: #EF4444;
+--info: #3B82F6;
+
+/* Neutral */
+--gray-50: #F9FAFB;
+--gray-900: #111827;
+```
+
+### Typography Scale
+```css
+--text-xs: 0.75rem;    /* 12px */
+--text-sm: 0.875rem;   /* 14px */
+--text-base: 1rem;     /* 16px */
+--text-lg: 1.125rem;   /* 18px */
+--text-xl: 1.25rem;    /* 20px */
+--text-2xl: 1.5rem;    /* 24px */
+```
+
+### Spacing Scale
+```css
+--space-1: 0.25rem;    /* 4px */
+--space-2: 0.5rem;     /* 8px */
+--space-4: 1rem;       /* 16px */
+--space-6: 1.5rem;     /* 24px */
+--space-8: 2rem;       /* 32px */
+```
+
+## Accessibility Checklist
+
+- [ ] Color contrast >= 4.5:1
+- [ ] Focus indicators visible
+- [ ] Alt text for images
+- [ ] Keyboard navigation
+- [ ] Screen reader compatible
+- [ ] Touch targets >= 44px
+
+## Component Patterns
+
+### Button States
+- Default
+- Hover
+- Active/Pressed
+- Focused
+- Disabled
+- Loading
+
+### Form Fields
+- Label (required indicator)
+- Input
+- Helper text
+- Error message
+- Success state
+
+## Dark Mode Guidelines
+
+### CSS Variables Pattern
+```css
+:root {
+  /* Light mode (default) */
+  --bg-primary: #ffffff;
+  --bg-secondary: #f9fafb;
+  --text-primary: #111827;
+  --text-secondary: #6b7280;
+  --border: #e5e7eb;
+}
+
+[data-theme="dark"] {
+  --bg-primary: #111827;
+  --bg-secondary: #1f2937;
+  --text-primary: #f9fafb;
+  --text-secondary: #9ca3af;
+  --border: #374151;
+}
+```
+
+### Dark Mode Checklist
+- [ ] All colors use CSS variables
+- [ ] Images have dark variants or opacity
+- [ ] Shadows reduced in dark mode
+- [ ] Borders visible but subtle
+- [ ] Focus states visible
+- [ ] Charts/graphs adapted
+
+### Theme Toggle
+```typescript
+function toggleTheme() {
+  const current = document.documentElement.dataset.theme;
+  document.documentElement.dataset.theme = 
+    current === 'dark' ? 'light' : 'dark';
+  localStorage.setItem('theme', current === 'dark' ? 'light' : 'dark');
+}
+```
+
+## Animation/Motion Guidelines
+
+### Animation Principles
+| Principle | Description |
+|-----------|-------------|
+| Duration | 150-300ms for micro, 300-500ms for page |
+| Easing | `ease-out` for enter, `ease-in` for exit |
+| Purpose | Guide attention, provide feedback |
+
+### Common Animations
+```css
+/* Fade in */
+@keyframes fadeIn {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
+
+/* Slide up */
+@keyframes slideUp {
+  from { transform: translateY(10px); opacity: 0; }
+  to { transform: translateY(0); opacity: 1; }
+}
+
+/* Scale */
+@keyframes scaleIn {
+  from { transform: scale(0.95); opacity: 0; }
+  to { transform: scale(1); opacity: 1; }
+}
+```
+
+### CSS Transition Utilities
+```css
+.transition-fast { transition: all 150ms ease-out; }
+.transition-base { transition: all 200ms ease-out; }
+.transition-slow { transition: all 300ms ease-out; }
+```
+
+### Reduce Motion
+```css
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after {
+    animation-duration: 0.01ms !important;
+    transition-duration: 0.01ms !important;
+  }
+}
+```
+
+## Best Practices
+1. Design for accessibility first
+2. Use consistent spacing
+3. Follow platform conventions
+4. Test on real devices
+5. Get user feedback
+6. **Support dark mode from start**
+7. **Respect prefers-reduced-motion**
+
+## Related Agents
+- **Coder** - implement designs
+- **Fullstack Developer** - build complete UI
+

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/build/tools/todoTools.js

@@ -35,49 +35,49 @@ export async function createTodo(priority, title, problemStatement, criteriaArgs
     const filename = `${nextId}-pending-${priority}-${sanitizedDesc}.md`;
     const filePath = path.join(todosDir, filename);
     const dateStr = new Date().toISOString().split('T')[0];
-    let content = `---
-status: pending
-priority: ${priority}
-issue_id: "${nextId}"
-tags: [generated, cleanup]
-dependencies: []
----
-
-# ${title}
-
-## Problem Statement
-
-**What's broken/missing:**
-${problemStatement}
-
-**Impact:**
-This issue currently affects the system quality or functionality and needs to be addressed.
-
-## Findings
-- **Status:** Identified during workflow execution.
-- **Priority:** ${priority}
-- **System Impact:** This item is tracked to ensure continuous improvement of the codebase. Addressing it will contribute to overall system stability and feature completeness. The findings section provides context on origin and importance.
-
-## Recommended Action
-Implement the solution according to the acceptance criteria below.
-
-## Acceptance Criteria
+    let content = `---
+status: pending
+priority: ${priority}
+issue_id: "${nextId}"
+tags: [generated, cleanup]
+dependencies: []
+---
+
+# ${title}
+
+## Problem Statement
+
+**What's broken/missing:**
+${problemStatement}
+
+**Impact:**
+This issue currently affects the system quality or functionality and needs to be addressed.
+
+## Findings
+- **Status:** Identified during workflow execution.
+- **Priority:** ${priority}
+- **System Impact:** This item is tracked to ensure continuous improvement of the codebase. Addressing it will contribute to overall system stability and feature completeness. The findings section provides context on origin and importance.
+
+## Recommended Action
+Implement the solution according to the acceptance criteria below.
+
+## Acceptance Criteria
 `;
     for (const criteria of criteriaArgs) {
         content += `- [ ] ${criteria}\n`;
     }
-    content += `
-
-## Work Log
-
-### ${dateStr} - Created
-
-**By:** Agent
-**Actions:**
-- Auto-generated via createTodo MCP tool
-
-## Notes
-Source: Workflow automation
+    content += `
+
+## Work Log
+
+### ${dateStr} - Created
+
+**By:** Agent
+**Actions:**
+- Auto-generated via createTodo MCP tool
+
+## Notes
+Source: Workflow automation
 `;
     await fs.writeFile(filePath, content);
     return `✅ Created todo: ${filePath}\n   ID: ${nextId}\n   Priority: ${priority}\n   Title: ${title}`;

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

@@ -9,16 +9,16 @@ describe('schemaValidator', () => {
     });
     describe('validatePrismaSchema', () => {
         it('should detect bad model names and missing fields', async () => {
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 model user {
-                     name String
-                 }
-                 model Post {
-                     id String @id
-                     userId String
-                     createdAt DateTime
-                 }
-                 enum role { ADMIN, USER }
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 model user {
+                     name String
+                 }
+                 model Post {
+                     id String @id
+                     userId String
+                     createdAt DateTime
+                 }
+                 enum role { ADMIN, USER }
              `);
             const issues = await validatePrismaSchema('/mock.prisma');
             expect(issues.some(i => i.includes("Model 'user' should be PascalCase"))).toBe(true);
@@ -47,11 +47,11 @@ describe('apiValidator', () => {
     });
     describe('checkApiCode', () => {
         it('should detect missing api practices', async () => {
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 function handler() {
-                     // no try, no status, no security check
-                     return "hello";
-                 }
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 function handler() {
+                     // no try, no status, no security check
+                     return "hello";
+                 }
              `);
             const res = await checkApiCode('route.ts');
             expect(res.issues.some(i => i.includes('No error handling'))).toBe(true);
@@ -59,14 +59,14 @@ describe('apiValidator', () => {
             expect(res.passed.length).toBe(0);
         });
         it('should pass good practices', async () => {
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 import { z } from 'zod';
-                 function handler(req, res) {
-                     try {
-                         const jwtToken = "123";
-                         return res.status(200).send("hello");
-                     } catch(e) {}
-                 }
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 import { z } from 'zod';
+                 function handler(req, res) {
+                     try {
+                         const jwtToken = "123";
+                         return res.status(200).send("hello");
+                     } catch(e) {}
+                 }
              `);
             const res = await checkApiCode('route.ts');
             expect(res.passed.some(i => i.includes('Error handling'))).toBe(true);