@goonnguyen/human-mcp 1.3.0 → 2.0.0

package/plans/templates/bug-fix-template.md

@@ -1,69 +0,0 @@
-# [Bug Fix] Implementation Plan
-
-**Date**: YYYY-MM-DD  
-**Type**: Bug Fix  
-**Priority**: [Critical/High/Medium/Low]  
-**Context Tokens**: <150 words
-
-## Executive Summary
-Brief description of the bug and its impact.
-
-## Issue Analysis
-### Symptoms
-- [ ] Symptom 1
-- [ ] Symptom 2
-
-### Root Cause
-Brief explanation of the underlying cause.
-
-### Evidence
-- **Logs**: Reference to log files (don't include full logs)
-- **Error Messages**: Key error patterns
-- **Affected Components**: List of impacted files/modules
-
-## Context Links
-- **Related Issues**: [GitHub issue numbers]
-- **Recent Changes**: [Relevant commits or PRs]
-- **Dependencies**: [Related systems]
-
-## Solution Design
-### Approach
-High-level fix strategy in 2-3 sentences.
-
-### Changes Required
-1. **File 1** (`path/to/file.ts`): Brief change description
-2. **File 2** (`path/to/file.ts`): Brief change description
-
-### Testing Changes
-- [ ] Update existing tests
-- [ ] Add new test cases
-- [ ] Validate fix doesn't break existing functionality
-
-## Implementation Steps
-1. [ ] Step 1 - file: `path/to/file.ts`
-2. [ ] Step 2 - file: `path/to/file.ts`
-3. [ ] Run test suite
-4. [ ] Validate fix in relevant environments
-
-## Verification Plan
-### Test Cases
-- [ ] Test case 1: Expected behavior
-- [ ] Test case 2: Edge case handling
-- [ ] Regression test: Ensure no new issues
-
-### Rollback Plan
-If the fix causes issues:
-1. Revert commit: `git revert <commit-hash>`
-2. Restore previous behavior in files X, Y, Z
-
-## Risk Assessment
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-| Risk 1 | Medium | Mitigation plan |
-
-## TODO Checklist
-- [ ] Implement fix
-- [ ] Update tests
-- [ ] Run full test suite
-- [ ] Code review
-- [ ] Deploy and verify

package/plans/templates/feature-implementation-template.md

@@ -1,84 +0,0 @@
-# [Feature Name] Implementation Plan
-
-**Date**: YYYY-MM-DD  
-**Type**: Feature Implementation  
-**Status**: Planning  
-**Context Tokens**: <200 words
-
-## Executive Summary
-Brief 2-3 sentence description of the feature and its business value.
-
-## Context Links
-- **Related Plans**: [List other plan files - no full content]
-- **Dependencies**: [External systems, APIs, existing features]
-- **Reference Docs**: [Link to docs in ./docs directory]
-
-## Requirements
-### Functional Requirements
-- [ ] Requirement 1
-- [ ] Requirement 2
-
-### Non-Functional Requirements  
-- [ ] Performance target
-- [ ] Security requirement
-- [ ] Scalability requirement
-
-## Architecture Overview
-```mermaid
-[Simple component diagram]
-```
-
-### Key Components
-- **Component 1**: Brief description
-- **Component 2**: Brief description
-
-### Data Models
-- **Model 1**: Key fields
-- **Model 2**: Key fields
-
-## Implementation Phases
-
-### Phase 1: [Name] (Est: X days)
-**Scope**: Specific boundaries
-**Tasks**:
-1. [ ] Task 1 - file: `path/to/file.ts`
-2. [ ] Task 2 - file: `path/to/file.ts`
-
-**Acceptance Criteria**:
-- [ ] Criteria 1
-- [ ] Criteria 2
-
-### Phase 2: [Name] (Est: X days)
-[Repeat structure]
-
-## Testing Strategy
-- **Unit Tests**: Specific test coverage targets
-- **Integration Tests**: Key interaction points
-- **E2E Tests**: Critical user flows
-
-## Security Considerations
-- [ ] Security item 1
-- [ ] Security item 2
-
-## Risk Assessment
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-| Risk 1 | High | Mitigation strategy |
-
-## Quick Reference
-### Key Commands
-```bash
-npm run command
-```
-
-### Configuration Files
-- `config/file.ts`: Purpose
-- `.env.example`: Environment variables
-
-## TODO Checklist
-- [ ] Phase 1 Task 1
-- [ ] Phase 1 Task 2
-- [ ] Phase 2 Task 1
-- [ ] Testing complete
-- [ ] Documentation updated
-- [ ] Code review passed

package/plans/templates/refactor-template.md

@@ -1,82 +0,0 @@
-# [Component/Module] Refactoring Plan
-
-**Date**: YYYY-MM-DD  
-**Type**: Refactoring  
-**Scope**: [Module/Component/System level]  
-**Context Tokens**: <200 words
-
-## Executive Summary
-Brief description of what is being refactored and why.
-
-## Current State Analysis
-### Issues with Current Implementation
-- [ ] Issue 1: Performance bottleneck
-- [ ] Issue 2: Code maintainability
-- [ ] Issue 3: Technical debt
-
-### Metrics (Before)
-- **Performance**: Current benchmarks
-- **Code Quality**: Complexity metrics
-- **Test Coverage**: Current percentage
-
-## Context Links
-- **Affected Modules**: [List without full content]
-- **Dependencies**: [Other systems impacted]
-- **Related Documentation**: [Links to docs]
-
-## Refactoring Strategy
-### Approach
-High-level strategy for the refactoring in 2-3 sentences.
-
-### Architecture Changes
-```mermaid
-[Before/After comparison diagram]
-```
-
-### Key Improvements
-- **Improvement 1**: Brief description
-- **Improvement 2**: Brief description
-
-## Implementation Plan
-
-### Phase 1: Preparation (Est: X days)
-**Scope**: Setup and preparation work
-1. [ ] Create comprehensive tests for current functionality
-2. [ ] Document current behavior
-3. [ ] Identify all dependencies
-
-### Phase 2: Core Refactoring (Est: X days)
-**Scope**: Main refactoring work
-1. [ ] Refactor component A - file: `path/to/file.ts`
-2. [ ] Refactor component B - file: `path/to/file.ts`
-3. [ ] Update integration points
-
-### Phase 3: Integration & Testing (Est: X days)
-**Scope**: Validation and cleanup
-1. [ ] Integration testing
-2. [ ] Performance validation
-3. [ ] Documentation updates
-
-## Backward Compatibility
-- **Breaking Changes**: [List any breaking changes]
-- **Migration Path**: [Steps for users/systems]
-- **Deprecation Timeline**: [If applicable]
-
-## Success Metrics (After)
-- **Performance**: Target improvements
-- **Code Quality**: Target metrics
-- **Test Coverage**: Target percentage
-
-## Risk Assessment
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-| Breaking changes | High | Comprehensive testing |
-| Performance regression | Medium | Benchmarking |
-
-## TODO Checklist
-- [ ] Phase 1: Preparation complete
-- [ ] Phase 2: Core refactoring complete  
-- [ ] Phase 3: Integration complete
-- [ ] Performance benchmarks validated
-- [ ] Documentation updated
-- [ ] Code review passed

package/plans/templates/template-usage-guide.md

@@ -1,58 +0,0 @@
-# Plan Template Usage Guide
-
-## Template Selection
-
-### Feature Implementation Template
-**Use when**: Adding new functionality, endpoints, services, or modules
-**File**: `feature-implementation-template.md`
-**Size**: Medium to large scope changes
-
-### Bug Fix Template  
-**Use when**: Fixing specific issues, errors, or broken functionality
-**File**: `bug-fix-template.md`
-**Size**: Small to medium scope changes
-
-### Refactoring Template
-**Use when**: Improving code structure, performance, or maintainability without changing functionality
-**File**: `refactor-template.md` 
-**Size**: Medium to large scope changes
-
-## Context Management Best Practices
-
-### Keep Plans Focused
-- **Executive Summary**: Max 3 sentences
-- **Context Links**: Reference files, don't include full content
-- **Tasks**: Max 10 per phase
-- **Context Tokens**: Target <200 words for summaries
-
-### Template Adaptation
-1. Copy the appropriate template to `plans/NNN-feature-name-plan.md`
-2. Replace bracketed placeholders with actual content
-3. Remove sections not relevant to your specific use case
-4. Keep the core structure intact for consistency
-
-### Cross-References Instead of Duplication
-- Link to existing documentation in `./docs/`
-- Reference other plans without copying content
-- Use file paths instead of code blocks where possible
-- Focus on "what" and "why", not detailed "how"
-
-## Quality Checklist
-
-Before finalizing any plan:
-- [ ] Executive summary is clear and concise
-- [ ] Tasks are specific and actionable
-- [ ] File paths are included for implementation tasks
-- [ ] Success criteria are measurable
-- [ ] Context links are used instead of full content
-- [ ] TODO checklist is complete and realistic
-
-## Context Refresh Triggers
-
-Use these templates when:
-- Starting a new development phase
-- Switching between different types of work (feature → bugfix)
-- After major context accumulation (>8000 tokens)
-- When agent handoffs occur
-
-This ensures each plan starts with fresh, focused context optimized for the specific task type.

package/src/index.ts

@@ -1,49 +0,0 @@
-#!/usr/bin/env bun
-
-import { createServer } from "./server.js";
-import { TransportManager } from "./transports/index.js";
-import { loadConfig } from "./utils/config.js";
-import { logger } from "./utils/logger.js";
-
-async function main() {
-  try {
-    const config = loadConfig();
-    const server = await createServer();
-    
-    const transportConfig = {
-      type: config.transport.type,
-      http: config.transport.http?.enabled ? {
-        port: config.transport.http.port,
-        host: config.transport.http.host,
-        sessionMode: config.transport.http.sessionMode,
-        enableSse: config.transport.http.enableSse,
-        enableJsonResponse: config.transport.http.enableJsonResponse,
-        enableSseFallback: config.transport.http.enableSseFallback,
-        ssePaths: config.transport.http.ssePaths,
-        security: config.transport.http.security
-      } : undefined
-    };
-    
-    const transportManager = new TransportManager(server, transportConfig);
-    await transportManager.start();
-    
-    logger.info(`Human MCP Server started with ${config.transport.type} transport`);
-    
-    // Graceful shutdown
-    process.on('SIGINT', async () => {
-      logger.info('Shutting down server...');
-      process.exit(0);
-    });
-    
-    process.on('SIGTERM', async () => {
-      logger.info('Shutting down server...');
-      process.exit(0);
-    });
-    
-  } catch (error) {
-    logger.error('Failed to start server:', error);
-    process.exit(1);
-  }
-}
-
-main();

package/src/prompts/debugging-prompts.ts

@@ -1,149 +0,0 @@
-export const debuggingPrompts = [
-  {
-    name: "debug_ui_screenshot",
-    title: "Debug UI Screenshot",
-    description: "Analyze a UI screenshot to identify layout issues, misalignments, or rendering problems",
-    arguments: [
-      {
-        name: "screenshot",
-        description: "The screenshot to analyze",
-        required: true
-      },
-      {
-        name: "expected_behavior", 
-        description: "Description of expected UI behavior",
-        required: false
-      }
-    ],
-    template: `Analyze this UI screenshot for debugging:
-Screenshot: {{screenshot}}
-Expected behavior: {{expected_behavior}}
-
-Please identify:
-1. Any visible errors or anomalies
-2. Layout or alignment issues
-3. Missing or broken elements
-4. Accessibility concerns
-5. Performance indicators
-
-Use the eyes.analyze tool with analysis_type="ui_debug" to get detailed insights.`
-  },
-  {
-    name: "analyze_error_recording",
-    title: "Analyze Error Recording", 
-    description: "Analyze a screen recording to understand when and how an error occurs",
-    arguments: [
-      {
-        name: "recording",
-        description: "Video recording of the error",
-        required: true
-      },
-      {
-        name: "error_description",
-        description: "Description of the error",
-        required: true
-      }
-    ],
-    template: `Analyze this screen recording to debug an error:
-Recording: {{recording}}
-Error description: {{error_description}}
-
-Focus on:
-1. The sequence of events leading to the error
-2. Visual cues indicating the problem
-3. UI state changes
-4. Potential root causes
-5. Reproduction steps
-
-Use the eyes.analyze tool with analysis_type="error_detection" and type="video" for comprehensive analysis.`
-  },
-  {
-    name: "accessibility_audit", 
-    title: "Accessibility Audit",
-    description: "Perform a visual accessibility audit of a UI screenshot",
-    arguments: [
-      {
-        name: "screenshot",
-        description: "Screenshot of the UI to audit",
-        required: true
-      },
-      {
-        name: "focus_areas",
-        description: "Specific accessibility areas to focus on",
-        required: false
-      }
-    ],
-    template: `Perform an accessibility audit of this UI:
-Screenshot: {{screenshot}}
-Focus areas: {{focus_areas}}
-
-Analyze for:
-1. Color contrast ratios
-2. Text readability
-3. Focus indicators
-4. Alternative text presence
-5. WCAG compliance issues
-6. Keyboard navigation support
-
-Use the eyes.analyze tool with analysis_type="accessibility" and check_accessibility=true.`
-  },
-  {
-    name: "performance_visual_audit",
-    title: "Performance Visual Audit",
-    description: "Analyze a screenshot for visual performance indicators",
-    arguments: [
-      {
-        name: "screenshot",
-        description: "Screenshot showing performance metrics or loading states",
-        required: true
-      }
-    ],
-    template: `Analyze this screenshot for performance issues:
-Screenshot: {{screenshot}}
-
-Look for:
-1. Loading indicators and their appropriateness
-2. Layout shift evidence
-3. Render blocking signs
-4. Large unoptimized images
-5. Performance metric readings
-6. Visual indicators of slow responses
-
-Use the eyes.analyze tool with analysis_type="performance".`
-  },
-  {
-    name: "layout_comparison",
-    title: "Layout Comparison",
-    description: "Compare two UI layouts to identify differences",
-    arguments: [
-      {
-        name: "layout1",
-        description: "First layout screenshot",
-        required: true
-      },
-      {
-        name: "layout2", 
-        description: "Second layout screenshot",
-        required: true
-      },
-      {
-        name: "comparison_context",
-        description: "Context for the comparison (e.g., before/after, desktop/mobile)",
-        required: false
-      }
-    ],
-    template: `Compare these two layouts:
-Layout 1: {{layout1}}
-Layout 2: {{layout2}}
-Context: {{comparison_context}}
-
-Identify:
-1. Structural differences
-2. Element positioning changes
-3. Spacing and alignment variations
-4. Responsive design issues
-5. Visual hierarchy changes
-
-Use the eyes.compare tool with comparison_type="structural".`
-  }
-];

package/src/prompts/index.ts

@@ -1,55 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { debuggingPrompts } from "./debugging-prompts.js";
-import { logger } from "@/utils/logger.js";
-
-export async function registerPrompts(server: McpServer) {
-  // Register each debugging prompt
-  for (const prompt of debuggingPrompts) {
-    // Build zod schema for arguments
-    const argsSchema: Record<string, z.ZodTypeAny> = {};
-    for (const arg of prompt.arguments) {
-      if (arg.required) {
-        argsSchema[arg.name] = z.string().describe(arg.description);
-      } else {
-        argsSchema[arg.name] = z.string().optional().describe(arg.description);
-      }
-    }
-
-    logger.debug(`Registering prompt: ${prompt.name}`);
-    
-    server.registerPrompt(
-      prompt.name,
-      {
-        title: prompt.title,
-        description: prompt.description,
-        argsSchema
-      },
-      (args) => {
-        logger.debug(`Getting prompt: ${prompt.name}`);
-        
-        let content = prompt.template;
-        
-        // Replace template variables
-        if (args) {
-          for (const [key, value] of Object.entries(args)) {
-            const placeholder = `{{${key}}}`;
-            content = content.replace(new RegExp(placeholder, 'g'), String(value));
-          }
-        }
-        
-        return {
-          messages: [
-            {
-              role: "user",
-              content: {
-                type: "text",
-                text: content
-              }
-            }
-          ]
-        };
-      }
-    );
-  }
-}