@corbat-tech/coding-standards-mcp 1.0.0

package/dist/utils/retry.js

@@ -0,0 +1,74 @@
+import pRetry, { AbortError } from 'p-retry';
+/**
+ * Default retry options.
+ */
+const DEFAULT_OPTIONS = {
+    maxAttempts: 3,
+    baseDelayMs: 100,
+    maxDelayMs: 5000,
+    verbose: false,
+};
+/**
+ * Execute an async operation with exponential backoff retry.
+ *
+ * @param operation - The async function to execute
+ * @param options - Retry configuration options
+ * @returns The result of the operation
+ * @throws The last error if all retries fail
+ *
+ * @example
+ * ```typescript
+ * const content = await withRetry(
+ *   () => readFile(filePath, 'utf-8'),
+ *   { maxAttempts: 3, baseDelayMs: 100 }
+ * );
+ * ```
+ */
+export async function withRetry(operation, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const pRetryOptions = {
+        retries: opts.maxAttempts - 1,
+        minTimeout: opts.baseDelayMs,
+        maxTimeout: opts.maxDelayMs,
+        factor: 2,
+        onFailedAttempt: opts.verbose
+            ? (error) => {
+                console.error(`Retry attempt ${error.attemptNumber}/${opts.maxAttempts} failed: ${error.message}`);
+            }
+            : undefined,
+    };
+    return pRetry(operation, pRetryOptions);
+}
+/**
+ * Check if an error is retryable (transient).
+ * File system errors like EBUSY, EAGAIN, ETIMEDOUT are retryable.
+ */
+export function isRetryableError(error) {
+    if (error instanceof Error) {
+        const nodeError = error;
+        const retryableCodes = ['EBUSY', 'EAGAIN', 'ETIMEDOUT', 'ECONNRESET', 'ENOTFOUND'];
+        return retryableCodes.includes(nodeError.code || '');
+    }
+    return false;
+}
+/**
+ * Execute a file operation with retry only for transient errors.
+ *
+ * @param operation - The async file operation to execute
+ * @param options - Retry configuration options
+ * @returns The result of the operation
+ */
+export async function withFileRetry(operation, options = {}) {
+    return withRetry(async () => {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (!isRetryableError(error)) {
+                throw new AbortError(error instanceof Error ? error.message : String(error));
+            }
+            throw error;
+        }
+    }, options);
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,EAAE,EAAE,UAAU,EAAiC,MAAM,SAAS,CAAC;AAgB5E;;GAEG;AACH,MAAM,eAAe,GAA2B;IAC9C,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,KAAK;CACf,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,SAA2B,EAAE,UAAwB,EAAE;IACxF,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAEhD,MAAM,aAAa,GAAkB;QACnC,OAAO,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC;QAC7B,UAAU,EAAE,IAAI,CAAC,WAAW;QAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,CAAC;QACT,eAAe,EAAE,IAAI,CAAC,OAAO;YAC3B,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE;gBACR,OAAO,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrG,CAAC;YACH,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAA8B,CAAC;QACjD,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QACnF,OAAO,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,SAA2B,EAAE,UAAwB,EAAE;IAC5F,OAAO,SAAS,CAAC,KAAK,IAAI,EAAE;QAC1B,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,EAAE,OAAO,CAAC,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@corbat-tech/coding-standards-mcp",
+  "version": "1.0.0",
+  "description": "AI coding standards that apply themselves - MCP server for Claude",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "corbat-mcp": "dist/index.js",
+    "corbat-init": "dist/cli/init.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/corbat-tech/corbat-mcp.git"
+  },
+  "homepage": "https://github.com/corbat-tech/corbat-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/corbat-tech/corbat-mcp/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "init": "node dist/cli/init.js",
+    "dev": "node --import tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run validate && npm run build",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "validate": "npm run check && npm run test",
+    "validate:arch": "depcruise src --config .dependency-cruiser.cjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "coding-standards",
+    "best-practices",
+    "hexagonal-architecture",
+    "ddd",
+    "clean-code",
+    "tdd"
+  ],
+  "author": "Corbat <info@corbat.tech> (https://corbat.tech)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "profiles",
+    "standards",
+    "assets"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "p-retry": "^6.2.0",
+    "yaml": "^2.3.4",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "dependency-cruiser": "^16.5.0",
+    "tsx": "^4.6.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}

package/profiles/README.md

@@ -0,0 +1,199 @@
+# Corbat MCP Profiles
+
+Los perfiles definen los estándares de código y mejores prácticas que el LLM aplicará durante el desarrollo.
+
+## Estructura de Carpetas
+
+```
+profiles/
+├── templates/           # Perfiles oficiales (NO editar)
+│   ├── java-spring-backend.yaml  # Java + Spring Boot enterprise
+│   ├── nodejs.yaml               # Node.js + TypeScript
+│   ├── python.yaml               # Python + FastAPI/Django
+│   ├── react.yaml                # React + TypeScript
+│   ├── angular.yaml              # Angular 19+ + TypeScript
+│   ├── vue.yaml                  # Vue 3.5+ + TypeScript
+│   ├── minimal.yaml              # Configuración mínima
+│   └── _template.yaml            # Plantilla para crear nuevos perfiles
+│
+├── custom/              # TUS perfiles personalizados
+│   └── (tus archivos .yaml)
+│
+└── README.md            # Esta guía
+```
+
+## Uso Rápido
+
+### 1. Usar un perfil existente
+
+```bash
+# En tu cliente MCP, especifica el perfil:
+get_coding_standards(profile: "java-spring-backend")
+get_coding_standards(profile: "nodejs")
+get_coding_standards(profile: "react")
+```
+
+### 2. Crear un perfil personalizado
+
+```bash
+# 1. Copia la plantilla
+cp profiles/templates/_template.yaml profiles/custom/mi-proyecto.yaml
+
+# 2. Edita con tu configuración
+code profiles/custom/mi-proyecto.yaml
+
+# 3. Usa tu perfil
+get_coding_standards(profile: "mi-proyecto")
+```
+
+## Perfiles Disponibles
+
+| Perfil | Descripción | Stack |
+|--------|-------------|-------|
+| `java-spring-backend` | Enterprise backend con arquitectura hexagonal, DDD, CQRS | Java 21, Spring Boot 3.x |
+| `nodejs` | Backend/fullstack con TypeScript | Node.js, TypeScript, Express/Nest |
+| `python` | Backend con tipado estricto | Python 3.11+, FastAPI/Django |
+| `react` | Aplicaciones React modernas | React 18+, TypeScript |
+| `angular` | Aplicaciones Angular modernas con signals y zoneless | Angular 19+, TypeScript |
+| `vue` | Aplicaciones Vue modernas con Composition API | Vue 3.5+, TypeScript |
+| `minimal` | Configuración mínima para empezar | Cualquiera |
+
+## Estructura de un Perfil
+
+```yaml
+# Metadatos
+name: "Nombre del perfil"
+description: "Descripción breve"
+
+# Arquitectura
+architecture:
+  type: hexagonal | clean | layered | onion
+  layers: [...]
+
+# DDD (opcional)
+ddd:
+  enabled: true
+  patterns: {...}
+
+# Calidad de código
+codeQuality:
+  maxMethodLines: 20
+  minimumTestCoverage: 80
+
+# Convenciones de nombrado
+naming:
+  general: {...}
+  suffixes: {...}
+
+# Testing
+testing:
+  framework: "JUnit5"
+  types: {...}
+
+# Tecnologías específicas
+technologies:
+  - name: java
+    version: "21"
+    specificRules: {...}
+```
+
+## Secciones Disponibles
+
+| Sección | Propósito |
+|---------|-----------|
+| `architecture` | Patrón arquitectónico y capas |
+| `ddd` | Patrones Domain-Driven Design |
+| `cqrs` | Command Query Responsibility Segregation |
+| `eventDriven` | Arquitectura basada en eventos |
+| `codeQuality` | Métricas y principios de calidad |
+| `naming` | Convenciones de nombrado |
+| `testing` | Frameworks y tipos de tests |
+| `httpClients` | Clientes HTTP y APIs |
+| `observability` | Logging, métricas, tracing |
+| `security` | Autenticación, autorización |
+| `errorHandling` | Manejo de errores |
+| `database` | Migraciones, auditoría |
+| `technologies` | Stack tecnológico específico |
+
+## Ejemplos de Personalización
+
+### Proyecto microservicio simple
+
+```yaml
+# profiles/custom/order-service.yaml
+name: "Order Service"
+description: "Microservicio de órdenes"
+
+architecture:
+  type: hexagonal
+  enforceLayerDependencies: true
+
+ddd:
+  enabled: true
+  patterns:
+    aggregates: true
+    domainEvents: true
+
+codeQuality:
+  minimumTestCoverage: 85
+
+technologies:
+  - name: java
+    version: "21"
+  - name: spring-boot
+    version: "3.2"
+```
+
+### Proyecto frontend React
+
+```yaml
+# profiles/custom/admin-dashboard.yaml
+name: "Admin Dashboard"
+description: "Panel de administración React"
+
+architecture:
+  type: clean
+  layers:
+    - name: ui
+      description: "Componentes visuales"
+      packages: ["components/*"]
+    - name: features
+      description: "Lógica de features"
+      packages: ["features/*"]
+    - name: shared
+      description: "Código compartido"
+      packages: ["shared/*"]
+
+codeQuality:
+  maxMethodLines: 30
+  minimumTestCoverage: 70
+
+technologies:
+  - name: react
+    version: "18"
+  - name: typescript
+    version: "5"
+```
+
+## Tips
+
+1. **Empieza con `minimal.yaml`** si no estás seguro de qué necesitas
+2. **Copia `_template.yaml`** para crear perfiles desde cero
+3. **No modifiques `templates/`** - usa `custom/` para tus cambios
+4. **Solo incluye secciones que uses** - el resto usará defaults sensatos
+5. **Un perfil por proyecto** es la recomendación para equipos
+
+## Contribuir Perfiles
+
+Si creas un perfil útil que podría beneficiar a otros:
+
+1. Asegúrate de que sea genérico (no específico de tu empresa)
+2. Documenta las decisiones de diseño
+3. Abre un PR añadiéndolo a `templates/`
+
+---
+
+Para más información sobre el workflow de desarrollo, usa:
+```
+get_development_workflow()
+```

package/profiles/custom/.gitkeep

@@ -0,0 +1,2 @@
+# This folder is for your custom profiles
+# Copy profiles/templates/_template.yaml here and customize

package/profiles/templates/_template.yaml

@@ -0,0 +1,159 @@
+# ============================================================================
+# CORBAT MCP - Profile Template
+# ============================================================================
+# Copy this file to profiles/custom/ and customize for your project.
+#
+# Usage:
+#   1. cp profiles/templates/_template.yaml profiles/custom/my-project.yaml
+#   2. Edit my-project.yaml with your project's standards
+#   3. Use profile "my-project" in your MCP calls
+#
+# Tips:
+#   - Only include sections relevant to your project
+#   - Remove sections you don't need (they'll use sensible defaults)
+#   - See profiles/templates/ for complete examples
+# ============================================================================
+
+# REQUIRED: Name and description
+name: "My Project Standards"
+description: "Brief description of your project's coding standards"
+
+# ----------------------------------------------------------------------------
+# ARCHITECTURE (choose one type)
+# ----------------------------------------------------------------------------
+architecture:
+  # Options: hexagonal | clean | layered | onion | none
+  type: hexagonal
+  enforceLayerDependencies: true
+
+  # Define your layers (customize as needed)
+  layers:
+    - name: domain
+      description: "Core business logic"
+      allowedDependencies: []
+      packages:
+        - "*.domain"
+
+    - name: application
+      description: "Use cases and services"
+      allowedDependencies:
+        - domain
+      packages:
+        - "*.application"
+
+    - name: infrastructure
+      description: "External adapters"
+      allowedDependencies:
+        - domain
+        - application
+      packages:
+        - "*.infrastructure"
+
+# ----------------------------------------------------------------------------
+# DDD (optional - remove if not using DDD)
+# ----------------------------------------------------------------------------
+ddd:
+  enabled: true
+  ubiquitousLanguageEnforced: true
+  patterns:
+    aggregates: true
+    valueObjects: true
+    domainEvents: true
+    repositories: true
+
+# ----------------------------------------------------------------------------
+# CODE QUALITY
+# ----------------------------------------------------------------------------
+codeQuality:
+  maxMethodLines: 20
+  maxClassLines: 200
+  maxFileLines: 400
+  maxMethodParameters: 4
+  maxCyclomaticComplexity: 10
+  requireDocumentation: true
+  requireTests: true
+  minimumTestCoverage: 80
+
+  principles:
+    - "SOLID principles"
+    - "DRY (Don't Repeat Yourself)"
+    - "KISS (Keep It Simple)"
+
+# ----------------------------------------------------------------------------
+# NAMING CONVENTIONS
+# ----------------------------------------------------------------------------
+naming:
+  general:
+    class: PascalCase
+    method: camelCase
+    variable: camelCase
+    constant: SCREAMING_SNAKE_CASE
+
+  suffixes:
+    controller: "Controller"
+    service: "Service"
+    repository: "Repository"
+
+  testing:
+    unitTest: "Test"
+    integrationTest: "IT"
+    testMethod: "should_ExpectedBehavior_When_Condition"
+
+# ----------------------------------------------------------------------------
+# TESTING
+# ----------------------------------------------------------------------------
+testing:
+  framework: "JUnit5"  # or: Jest, Pytest, Vitest, etc.
+  assertionLibrary: "AssertJ"
+  mockingLibrary: "Mockito"
+
+  types:
+    unit:
+      suffix: "Test"
+      coverage: 80
+
+    integration:
+      suffix: "IT"
+      useTestcontainers: true
+
+# ----------------------------------------------------------------------------
+# TECHNOLOGIES (list your stack)
+# ----------------------------------------------------------------------------
+technologies:
+  - name: java
+    version: "21"
+    specificRules:
+      useRecordsForValueObjects: true
+
+  - name: spring-boot
+    version: "3.x"
+    specificRules:
+      useConstructorInjection: true
+
+# ============================================================================
+# OPTIONAL SECTIONS (uncomment and customize as needed)
+# ============================================================================
+
+# cqrs:
+#   enabled: true
+#   separation: "logical"
+
+# eventDriven:
+#   enabled: true
+#   approach: "domain-events"
+
+# observability:
+#   enabled: true
+#   logging:
+#     framework: "SLF4J"
+#     format: "JSON"
+
+# security:
+#   authentication:
+#     method: "JWT"
+#   authorization:
+#     method: "RBAC"
+
+# database:
+#   migrations:
+#     tool: "Flyway"