project-customization-mcp 0.1.0

package/build/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * TypeScript interfaces and types for the MCP server
+ */
+export interface ProjectMetadata {
+    name: string;
+    description: string;
+    projectRoot: string;
+    projectType: 'nodejs' | 'python' | 'dotnet' | 'unknown';
+    hasGitHub: boolean;
+    hasPackageJson: boolean;
+    hasPythonProject: boolean;
+    hasReadme: boolean;
+    hasCopilotInstructions: boolean;
+    frameworks: string[];
+    programmingLanguages: string[];
+}
+export interface ProjectStructure {
+    root: string;
+    folders: FolderInfo[];
+    files: FileInfo[];
+    totalFiles: number;
+    keyDirectories: string[];
+}
+export interface FolderInfo {
+    path: string;
+    name: string;
+    depth: number;
+    fileCount: number;
+}
+export interface FileInfo {
+    path: string;
+    name: string;
+    extension: string;
+    size: number;
+}
+export interface AnalysisResult {
+    metadata: ProjectMetadata;
+    structure: ProjectStructure;
+    issues: ProjectIssue[];
+    recommendations: Recommendation[];
+}
+export interface ProjectIssue {
+    severity: 'low' | 'medium' | 'high';
+    category: 'missing' | 'outdated' | 'inconsistent';
+    message: string;
+}
+export interface Recommendation {
+    title: string;
+    description: string;
+    category: 'documentation' | 'guidelines' | 'structure' | 'best-practices';
+    priority: 'low' | 'medium' | 'high';
+    action: string;
+}
+export interface GeneratedContent {
+    filename: string;
+    content: string;
+    description: string;
+}
+export interface ToolInput {
+    projectPath?: string;
+    options?: Record<string, any>;
+}

package/build/types.js

@@ -0,0 +1,5 @@
+/**
+ * TypeScript interfaces and types for the MCP server
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/build/utils/bestPractices.d.ts

@@ -0,0 +1,16 @@
+/**
+ * VS Code customization best practices and templates
+ */
+import { ProjectMetadata } from '../types.js';
+/**
+ * Generate Copilot Instructions based on project metadata
+ */
+export declare function generateCopilotInstructions(metadata: ProjectMetadata): string;
+/**
+ * Generate README content with guidelines
+ */
+export declare function generateReadmeContent(metadata: ProjectMetadata, additionalGuidelines?: string): string;
+/**
+ * Generate recommendations based on project analysis
+ */
+export declare function generateRecommendations(metadata: ProjectMetadata): any[];

package/build/utils/bestPractices.js

@@ -0,0 +1,230 @@
+/**
+ * VS Code customization best practices and templates
+ */
+/**
+ * Generate Copilot Instructions based on project metadata
+ */
+export function generateCopilotInstructions(metadata) {
+    const sections = [];
+    sections.push('# Copilot Custom Instructions');
+    sections.push('');
+    sections.push(`*Auto-generated for ${metadata.name}*`);
+    sections.push('');
+    // Project Overview
+    sections.push('## Project Overview');
+    sections.push(`- **Project Name**: ${metadata.name}`);
+    if (metadata.description) {
+        sections.push(`- **Description**: ${metadata.description}`);
+    }
+    sections.push(`- **Type**: ${metadata.projectType}`);
+    if (metadata.frameworks.length > 0) {
+        sections.push(`- **Frameworks**: ${metadata.frameworks.join(', ')}`);
+    }
+    if (metadata.programmingLanguages.length > 0) {
+        sections.push(`- **Languages**: ${metadata.programmingLanguages.join(', ')}`);
+    }
+    sections.push('');
+    // Code Style and Standards
+    sections.push('## Code Style and Standards');
+    sections.push('');
+    if (metadata.frameworks.some((f) => f.includes('React') || f.includes('TypeScript'))) {
+        sections.push('### TypeScript/React Standards');
+        sections.push('- Use functional components with hooks');
+        sections.push('- Maintain strict TypeScript types (no `any`)');
+        sections.push('- Use ESLint and Prettier for code formatting');
+        sections.push('- Follow naming conventions: camelCase for variables/functions, PascalCase for components');
+        sections.push('');
+    }
+    if (metadata.frameworks.some((f) => f.includes('Node.js') || f.includes('Backend'))) {
+        sections.push('### Backend Standards');
+        sections.push('- Use async/await for asynchronous operations');
+        sections.push('- Implement proper error handling with try/catch');
+        sections.push('- Write unit tests for all utility functions');
+        sections.push('- Follow RESTful API design principles');
+        sections.push('');
+    }
+    // Project Structure
+    sections.push('## Project Structure');
+    sections.push('');
+    sections.push('The project should maintain the following directory structure:');
+    sections.push('');
+    if (metadata.frameworks.some((f) => f.includes('React'))) {
+        sections.push('```');
+        sections.push('src/');
+        sections.push('  ├── components/    # React components');
+        sections.push('  ├── pages/         # Page components');
+        sections.push('  ├── utils/         # Utility functions');
+        sections.push('  ├── hooks/         # Custom hooks');
+        sections.push('  ├── types/         # TypeScript types');
+        sections.push('  └── App.tsx        # Main app component');
+        sections.push('```');
+    }
+    else if (metadata.projectType === 'nodejs') {
+        sections.push('```');
+        sections.push('src/');
+        sections.push('  ├── routes/        # API routes');
+        sections.push('  ├── controllers/   # Request handlers');
+        sections.push('  ├── services/      # Business logic');
+        sections.push('  ├── utils/         # Utility functions');
+        sections.push('  └── types/         # TypeScript types');
+        sections.push('```');
+    }
+    sections.push('');
+    // Documentation Requirements
+    sections.push('## Documentation');
+    sections.push('');
+    sections.push('- Maintain an up-to-date README.md with setup instructions');
+    sections.push('- Document API endpoints with examples');
+    sections.push('- Include JSDoc comments for complex functions');
+    sections.push('- Add comments for non-obvious logic');
+    sections.push('');
+    // Git Workflow
+    sections.push('## Git Workflow');
+    sections.push('');
+    sections.push('- Use descriptive commit messages following conventional commits');
+    sections.push('- Create feature branches for new features (feature/*)');
+    sections.push('- Create bugfix branches for fixes (bugfix/*)');
+    sections.push('- Request code review before merging to main');
+    sections.push('');
+    // Testing
+    sections.push('## Testing');
+    sections.push('');
+    sections.push('- Write unit tests for all utility functions');
+    sections.push('- Maintain test coverage above 80%');
+    sections.push('- Use descriptive test names that explain what is being tested');
+    sections.push('- Mock external dependencies in tests');
+    sections.push('');
+    // Performance
+    sections.push('## Performance');
+    sections.push('');
+    sections.push('- Optimize bundle size for frontend projects');
+    sections.push('- Use lazy loading for components when appropriate');
+    sections.push('- Implement proper caching strategies');
+    sections.push('- Monitor and log performance metrics');
+    sections.push('');
+    // Security
+    sections.push('## Security');
+    sections.push('');
+    sections.push('- Never commit secrets or API keys');
+    sections.push('- Use environment variables for sensitive configuration');
+    sections.push('- Validate and sanitize user inputs');
+    sections.push('- Keep dependencies up-to-date');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * Generate README content with guidelines
+ */
+export function generateReadmeContent(metadata, additionalGuidelines) {
+    const sections = [];
+    sections.push(`# ${metadata.name}`);
+    sections.push('');
+    if (metadata.description) {
+        sections.push(metadata.description);
+        sections.push('');
+    }
+    sections.push('## Getting Started');
+    sections.push('');
+    if (metadata.projectType === 'nodejs') {
+        sections.push('### Prerequisites');
+        sections.push('- Node.js (v16 or higher)');
+        sections.push('- npm or yarn');
+        sections.push('');
+        sections.push('### Installation');
+        sections.push('');
+        sections.push('```bash');
+        sections.push('npm install');
+        sections.push('```');
+        sections.push('');
+        sections.push('### Running the Project');
+        sections.push('');
+        sections.push('```bash');
+        sections.push('npm run dev');
+        sections.push('```');
+        sections.push('');
+    }
+    else if (metadata.projectType === 'python') {
+        sections.push('### Prerequisites');
+        sections.push('- Python 3.8 or higher');
+        sections.push('- pip or conda');
+        sections.push('');
+        sections.push('### Installation');
+        sections.push('');
+        sections.push('```bash');
+        sections.push('pip install -r requirements.txt');
+        sections.push('```');
+        sections.push('');
+    }
+    if (additionalGuidelines) {
+        sections.push('## Development Guidelines');
+        sections.push('');
+        sections.push(additionalGuidelines);
+        sections.push('');
+    }
+    sections.push('## Contributing');
+    sections.push('');
+    sections.push('Please read our contributing guidelines before submitting pull requests.');
+    sections.push('');
+    sections.push('## License');
+    sections.push('');
+    sections.push('This project is licensed under the MIT License.');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * Generate recommendations based on project analysis
+ */
+export function generateRecommendations(metadata) {
+    const recommendations = [];
+    // Missing documentation
+    if (!metadata.hasReadme) {
+        recommendations.push({
+            priority: 'high',
+            title: 'Missing README.md',
+            description: 'Add a comprehensive README.md file to document the project',
+            category: 'documentation',
+            action: 'Create README.md with project overview, setup instructions, and development guidelines',
+        });
+    }
+    // Missing copilot instructions
+    if (!metadata.hasCopilotInstructions) {
+        recommendations.push({
+            priority: 'high',
+            title: 'Missing Copilot Instructions',
+            description: 'Create .github/copilot-instructions.md to guide Copilot behavior',
+            category: 'guidelines',
+            action: 'Generate copilot-instructions.md with project-specific guidelines',
+        });
+    }
+    // Missing GitHub configuration
+    if (!metadata.hasGitHub) {
+        recommendations.push({
+            priority: 'medium',
+            title: 'Initialize Git Repository',
+            description: 'Initialize a Git repository to enable version control',
+            category: 'structure',
+            action: 'Run git init and set up .gitignore',
+        });
+    }
+    // Framework-specific recommendations
+    if (metadata.frameworks.some((f) => f.includes('TypeScript'))) {
+        recommendations.push({
+            priority: 'medium',
+            title: 'TypeScript Configuration',
+            description: 'Ensure strict TypeScript configuration is enabled',
+            category: 'best-practices',
+            action: 'Update tsconfig.json with strict mode enabled',
+        });
+    }
+    if (metadata.frameworks.some((f) => f.includes('React'))) {
+        recommendations.push({
+            priority: 'medium',
+            title: 'React Best Practices',
+            description: 'Follow React best practices and hooks patterns',
+            category: 'guidelines',
+            action: 'Ensure use of functional components and hooks throughout the project',
+        });
+    }
+    return recommendations;
+}
+//# sourceMappingURL=bestPractices.js.map

package/build/utils/bestPractices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bestPractices.js","sourceRoot":"","sources":["../../src/utils/bestPractices.ts"],"names":[],"mappings":"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"}

package/build/utils/fileHandler.d.ts

@@ -0,0 +1,46 @@
+/**
+ * File I/O operations utility
+ */
+import * as fs from 'fs';
+export declare class FileHandler {
+    /**
+     * Read a file asynchronously
+     */
+    static readFile(filePath: string): Promise<string>;
+    /**
+     * Write content to a file asynchronously
+     */
+    static writeFile(filePath: string, content: string): Promise<void>;
+    /**
+     * Append content to a file
+     */
+    static appendFile(filePath: string, content: string): Promise<void>;
+    /**
+     * Check if file exists
+     */
+    static fileExists(filePath: string): Promise<boolean>;
+    /**
+     * Check if path is a directory
+     */
+    static isDirectory(dirPath: string): Promise<boolean>;
+    /**
+     * List files in a directory
+     */
+    static listFiles(dirPath: string, recursive?: boolean): Promise<string[]>;
+    /**
+     * Get file stats
+     */
+    static getFileStats(filePath: string): Promise<fs.Stats | null>;
+    /**
+     * Check if folder should be ignored
+     */
+    private static isIgnoredFolder;
+    /**
+     * Find git root directory
+     */
+    static findGitRoot(startPath: string): Promise<string | null>;
+    /**
+     * Get project root (git root or starting directory)
+     */
+    static getProjectRoot(startPath?: string): Promise<string>;
+}

package/build/utils/fileHandler.js

@@ -0,0 +1,144 @@
+/**
+ * File I/O operations utility
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from './logger.js';
+export class FileHandler {
+    /**
+     * Read a file asynchronously
+     */
+    static async readFile(filePath) {
+        try {
+            return await fs.promises.readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            logger.error(`Failed to read file: ${filePath}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Write content to a file asynchronously
+     */
+    static async writeFile(filePath, content) {
+        try {
+            const dir = path.dirname(filePath);
+            await fs.promises.mkdir(dir, { recursive: true });
+            await fs.promises.writeFile(filePath, content, 'utf-8');
+            logger.info(`File written successfully: ${filePath}`);
+        }
+        catch (error) {
+            logger.error(`Failed to write file: ${filePath}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Append content to a file
+     */
+    static async appendFile(filePath, content) {
+        try {
+            const dir = path.dirname(filePath);
+            await fs.promises.mkdir(dir, { recursive: true });
+            await fs.promises.appendFile(filePath, content, 'utf-8');
+            logger.info(`Content appended to file: ${filePath}`);
+        }
+        catch (error) {
+            logger.error(`Failed to append to file: ${filePath}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Check if file exists
+     */
+    static async fileExists(filePath) {
+        try {
+            await fs.promises.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if path is a directory
+     */
+    static async isDirectory(dirPath) {
+        try {
+            const stats = await fs.promises.stat(dirPath);
+            return stats.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List files in a directory
+     */
+    static async listFiles(dirPath, recursive = false) {
+        try {
+            const files = [];
+            const traverse = async (currentPath, relativePath = '') => {
+                const entries = await fs.promises.readdir(currentPath);
+                for (const entry of entries) {
+                    const fullPath = path.join(currentPath, entry);
+                    const relPath = relativePath ? `${relativePath}/${entry}` : entry;
+                    const stat = await fs.promises.stat(fullPath);
+                    if (stat.isDirectory()) {
+                        if (recursive && !this.isIgnoredFolder(relPath)) {
+                            await traverse(fullPath, relPath);
+                        }
+                    }
+                    else {
+                        files.push(relPath);
+                    }
+                }
+            };
+            await traverse(dirPath);
+            return files;
+        }
+        catch (error) {
+            logger.error(`Failed to list files in ${dirPath}`, error);
+            return [];
+        }
+    }
+    /**
+     * Get file stats
+     */
+    static async getFileStats(filePath) {
+        try {
+            return await fs.promises.stat(filePath);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Check if folder should be ignored
+     */
+    static isIgnoredFolder(folderName) {
+        const ignoredFolders = ['node_modules', '.git', 'dist', 'build', '.next', '__pycache__', '.venv', 'venv'];
+        return ignoredFolders.some((ignored) => folderName.includes(ignored));
+    }
+    /**
+     * Find git root directory
+     */
+    static async findGitRoot(startPath) {
+        let currentPath = startPath;
+        while (currentPath !== path.dirname(currentPath)) {
+            const gitPath = path.join(currentPath, '.git');
+            if (await this.fileExists(gitPath)) {
+                return currentPath;
+            }
+            currentPath = path.dirname(currentPath);
+        }
+        return null;
+    }
+    /**
+     * Get project root (git root or starting directory)
+     */
+    static async getProjectRoot(startPath = process.cwd()) {
+        const gitRoot = await this.findGitRoot(startPath);
+        return gitRoot || startPath;
+    }
+}
+//# sourceMappingURL=fileHandler.js.map

package/build/utils/fileHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileHandler.js","sourceRoot":"","sources":["../../src/utils/fileHandler.ts"],"names":[],"mappings":"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"}

package/build/utils/logger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Logging utility for MCP server
+ */
+export declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARN = "WARN",
+    ERROR = "ERROR"
+}
+declare class Logger {
+    private level;
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    debug(message: string, data?: any): void;
+    info(message: string, data?: any): void;
+    warn(message: string, data?: any): void;
+    error(message: string, error?: Error | any): void;
+}
+export declare const logger: Logger;
+export {};

package/build/utils/logger.js

@@ -0,0 +1,42 @@
+/**
+ * Logging utility for MCP server
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["WARN"] = "WARN";
+    LogLevel["ERROR"] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+class Logger {
+    level = LogLevel.INFO;
+    setLevel(level) {
+        this.level = level;
+    }
+    shouldLog(messageLevel) {
+        const levels = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];
+        return levels.indexOf(messageLevel) >= levels.indexOf(this.level);
+    }
+    debug(message, data) {
+        if (this.shouldLog(LogLevel.DEBUG)) {
+            console.log(`[${LogLevel.DEBUG}]`, message, data ? JSON.stringify(data, null, 2) : '');
+        }
+    }
+    info(message, data) {
+        if (this.shouldLog(LogLevel.INFO)) {
+            console.log(`[${LogLevel.INFO}]`, message, data ? JSON.stringify(data, null, 2) : '');
+        }
+    }
+    warn(message, data) {
+        if (this.shouldLog(LogLevel.WARN)) {
+            console.warn(`[${LogLevel.WARN}]`, message, data ? JSON.stringify(data, null, 2) : '');
+        }
+    }
+    error(message, error) {
+        if (this.shouldLog(LogLevel.ERROR)) {
+            console.error(`[${LogLevel.ERROR}]`, message, error);
+        }
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED,MAAM,MAAM;IACF,KAAK,GAAa,QAAQ,CAAC,IAAI,CAAC;IAExC,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,YAAsB;QACtC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9E,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAU;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAmB;QACxC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/build/utils/projectScanner.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Project analysis and scanning utility
+ */
+import { ProjectMetadata, ProjectStructure } from '../types.js';
+export declare class ProjectScanner {
+    /**
+     * Detect project type based on files
+     */
+    static detectProjectType(projectRoot: string): Promise<'nodejs' | 'python' | 'dotnet' | 'unknown'>;
+    /**
+     * Detect frameworks and languages
+     */
+    static detectFrameworks(projectRoot: string): Promise<string[]>;
+    /**
+     * Detect programming languages in the project
+     */
+    static detectLanguages(projectRoot: string): Promise<string[]>;
+    /**
+     * Scan project structure
+     */
+    static scanProjectStructure(projectRoot: string, maxDepth?: number): Promise<ProjectStructure>;
+    /**
+     * Collect project metadata
+     */
+    static getProjectMetadata(projectRoot: string): Promise<ProjectMetadata>;
+}