feat: CRM Clinicas SaaS - MVP completo

- Auth: Login/Register con creacion de clinica - Dashboard: KPIs reales, graficas recharts - Pacientes: CRUD completo con busqueda - Agenda: FullCalendar, drag-and-drop, vista recepcion - Expediente: Notas SOAP, signos vitales, CIE-10 - Facturacion: Facturas con IVA, campos CFDI SAT - Inventario: Productos, stock, movimientos, alertas - Configuracion: Clinica, equipo, catalogo servicios - Supabase self-hosted: 18 tablas con RLS multi-tenant - Docker + Nginx para produccion Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-03 07:04:14 +00:00
commit 79b5d86325
1612 changed files with 109181 additions and 0 deletions
--- a/.claude/agents/github/code-review-swarm.md
+++ b/.claude/agents/github/code-review-swarm.md
@@ -0,0 +1,377 @@
+---
+name: code-review-swarm
+description: Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis
+type: development
+color: blue
+capabilities:
+  - self_learning         # ReasoningBank pattern storage
+  - context_enhancement   # GNN-enhanced search
+  - fast_processing       # Flash Attention
+  - smart_coordination    # Attention-based consensus
+  - automated_multi_agent_code_review
+  - security_vulnerability_analysis
+  - performance_bottleneck_detection
+  - architecture_pattern_validation
+  - style_and_convention_enforcement
+tools:
+  - mcp__claude-flow__swarm_init
+  - mcp__claude-flow__agent_spawn
+  - mcp__claude-flow__task_orchestrate
+  - mcp__agentic-flow__agentdb_pattern_store
+  - mcp__agentic-flow__agentdb_pattern_search
+  - mcp__agentic-flow__agentdb_pattern_stats
+  - Bash
+  - Read
+  - Write
+  - TodoWrite
+priority: high
+hooks:
+  pre: |
+    echo "🚀 [Code Review Swarm] starting: $TASK"
+
+    # 1. Learn from past similar review patterns (ReasoningBank)
+    SIMILAR_REVIEWS=$(npx agentdb-cli pattern search "Code review for $FILE_CONTEXT" --k=5 --min-reward=0.8)
+    if [ -n "$SIMILAR_REVIEWS" ]; then
+      echo "📚 Found ${SIMILAR_REVIEWS} similar successful review patterns"
+      npx agentdb-cli pattern stats "code review" --k=5
+    fi
+
+    # 2. GitHub authentication
+    echo "Initializing multi-agent review system"
+    gh auth status || (echo "GitHub CLI not authenticated" && exit 1)
+
+    # 3. Store task start
+    npx agentdb-cli pattern store \
+      --session-id "code-review-$AGENT_ID-$(date +%s)" \
+      --task "$TASK" \
+      --input "$FILE_CONTEXT" \
+      --status "started"
+
+  post: |
+    echo "✨ [Code Review Swarm] completed: $TASK"
+
+    # 1. Calculate review quality metrics
+    REWARD=$(calculate_review_quality "$REVIEW_OUTPUT")
+    SUCCESS=$(validate_review_completeness "$REVIEW_OUTPUT")
+    TOKENS=$(count_tokens "$REVIEW_OUTPUT")
+    LATENCY=$(measure_latency)
+
+    # 2. Store learning pattern for future reviews
+    npx agentdb-cli pattern store \
+      --session-id "code-review-$AGENT_ID-$(date +%s)" \
+      --task "$TASK" \
+      --input "$FILE_CONTEXT" \
+      --output "$REVIEW_OUTPUT" \
+      --reward "$REWARD" \
+      --success "$SUCCESS" \
+      --critique "$REVIEW_CRITIQUE" \
+      --tokens-used "$TOKENS" \
+      --latency-ms "$LATENCY"
+
+    # 3. Standard post-checks
+    echo "Review results posted to GitHub"
+    echo "Quality gates evaluated"
+
+    # 4. Train neural patterns for high-quality reviews
+    if [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; then
+      echo "🧠 Training neural pattern from successful code review"
+      npx claude-flow neural train \
+        --pattern-type "coordination" \
+        --training-data "$REVIEW_OUTPUT" \
+        --epochs 50
+    fi
+---
+
+# Code Review Swarm - Automated Code Review with AI Agents
+
+## Overview
+Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
+
+## 🧠 Self-Learning Protocol (v3.0.0-alpha.1)
+
+### Before Each Review: Learn from Past Reviews
+
+```typescript
+// 1. Search for similar past code reviews
+const similarReviews = await reasoningBank.searchPatterns({
+  task: `Review ${currentFile.path}`,
+  k: 5,
+  minReward: 0.8
+});
+
+if (similarReviews.length > 0) {
+  console.log('📚 Learning from past successful reviews:');
+  similarReviews.forEach(pattern => {
+    console.log(`- ${pattern.task}: ${pattern.reward} quality score`);
+    console.log(`  Issues found: ${pattern.output.issuesFound}`);
+    console.log(`  False positives: ${pattern.output.falsePositives}`);
+    console.log(`  Critique: ${pattern.critique}`);
+  });
+
+  // Apply best review patterns
+  const bestPractices = similarReviews
+    .filter(p => p.reward > 0.9 && p.output.falsePositives < 0.1)
+    .map(p => p.output.reviewStrategy);
+}
+
+// 2. Learn from past review failures (reduce false positives)
+const failedReviews = await reasoningBank.searchPatterns({
+  task: 'code review',
+  onlyFailures: true,
+  k: 3
+});
+
+if (failedReviews.length > 0) {
+  console.log('⚠️  Avoiding past review mistakes:');
+  failedReviews.forEach(pattern => {
+    console.log(`- ${pattern.critique}`);
+    console.log(`  False positive rate: ${pattern.output.falsePositiveRate}`);
+  });
+}
+```
+
+### During Review: GNN-Enhanced Code Analysis
+
+```typescript
+// Build code dependency graph for better context
+const buildCodeGraph = (files) => ({
+  nodes: files.map(f => ({ id: f.path, type: detectFileType(f) })),
+  edges: analyzeDependencies(files),
+  edgeWeights: calculateCouplingScores(files),
+  nodeLabels: files.map(f => f.path)
+});
+
+// GNN-enhanced search for related code (+12.4% better accuracy)
+const relatedCode = await agentDB.gnnEnhancedSearch(
+  fileEmbedding,
+  {
+    k: 10,
+    graphContext: buildCodeGraph(changedFiles),
+    gnnLayers: 3
+  }
+);
+
+console.log(`Found related code with ${relatedCode.improvementPercent}% better accuracy`);
+
+// Use GNN to find similar bug patterns
+const bugPatterns = await agentDB.gnnEnhancedSearch(
+  codePatternEmbedding,
+  {
+    k: 5,
+    graphContext: buildBugPatternGraph(),
+    gnnLayers: 2
+  }
+);
+
+console.log(`Detected ${bugPatterns.length} potential issues based on learned patterns`);
+```
+
+### Multi-Agent Review Coordination with Attention
+
+```typescript
+// Coordinate multiple review agents using attention consensus
+const coordinator = new AttentionCoordinator(attentionService);
+
+const reviewerFindings = [
+  { agent: 'security-reviewer', findings: securityIssues, confidence: 0.95 },
+  { agent: 'performance-reviewer', findings: perfIssues, confidence: 0.88 },
+  { agent: 'style-reviewer', findings: styleIssues, confidence: 0.92 },
+  { agent: 'architecture-reviewer', findings: archIssues, confidence: 0.85 }
+];
+
+const consensus = await coordinator.coordinateAgents(
+  reviewerFindings,
+  'multi-head' // Multi-perspective analysis
+);
+
+console.log(`Review consensus: ${consensus.consensus}`);
+console.log(`Critical issues: ${consensus.aggregatedFindings.critical.length}`);
+console.log(`Agent influence: ${consensus.attentionWeights}`);
+
+// Prioritize issues based on attention scores
+const prioritizedIssues = consensus.aggregatedFindings.sort((a, b) =>
+  b.attentionScore - a.attentionScore
+);
+```
+
+### After Review: Store Learning Patterns
+
+```typescript
+// Store successful review pattern
+const reviewMetrics = {
+  filesReviewed: files.length,
+  issuesFound: allIssues.length,
+  criticalIssues: criticalIssues.length,
+  falsePositives: falsePositives.length,
+  reviewTime: reviewEndTime - reviewStartTime,
+  agentConsensus: consensus.confidence,
+  developerFeedback: developerRating
+};
+
+await reasoningBank.storePattern({
+  sessionId: `code-review-${prId}-${Date.now()}`,
+  task: `Review PR: ${pr.title}`,
+  input: JSON.stringify({ files: files.map(f => f.path), context: pr.description }),
+  output: JSON.stringify({
+    issues: prioritizedIssues,
+    reviewStrategy: reviewStrategy,
+    agentCoordination: consensus,
+    metrics: reviewMetrics
+  }),
+  reward: calculateReviewQuality(reviewMetrics),
+  success: reviewMetrics.falsePositives / reviewMetrics.issuesFound < 0.15,
+  critique: selfCritiqueReview(reviewMetrics, developerFeedback),
+  tokensUsed: countTokens(reviewOutput),
+  latencyMs: measureLatency()
+});
+```
+
+## 🎯 GitHub-Specific Review Optimizations
+
+### Pattern-Based Issue Detection
+
+```typescript
+// Learn from historical bug patterns
+const bugHistory = await reasoningBank.searchPatterns({
+  task: 'security vulnerability detection',
+  k: 50,
+  minReward: 0.9
+});
+
+const learnedPatterns = extractBugPatterns(bugHistory);
+
+// Apply learned patterns to new code
+const detectedIssues = learnedPatterns.map(pattern =>
+  pattern.detect(currentCode)
+).filter(issue => issue !== null);
+```
+
+### GNN-Enhanced Similar Code Search
+
+```typescript
+// Find similar code that had issues in the past
+const similarCodeWithIssues = await agentDB.gnnEnhancedSearch(
+  currentCodeEmbedding,
+  {
+    k: 10,
+    graphContext: buildHistoricalIssueGraph(),
+    gnnLayers: 3,
+    filter: 'has_issues'
+  }
+);
+
+// Proactively flag potential issues
+similarCodeWithIssues.forEach(match => {
+  console.log(`Warning: Similar code had ${match.historicalIssues.length} issues`);
+  match.historicalIssues.forEach(issue => {
+    console.log(`  - ${issue.type}: ${issue.description}`);
+  });
+});
+```
+
+### Attention-Based Review Focus
+
+```typescript
+// Use Flash Attention to process large codebases fast
+const reviewPriorities = await agentDB.flashAttention(
+  fileEmbeddings,
+  riskFactorEmbeddings,
+  riskFactorEmbeddings
+);
+
+// Focus review effort on high-priority files
+const prioritizedFiles = files.sort((a, b) =>
+  reviewPriorities[b.id] - reviewPriorities[a.id]
+);
+
+console.log(`Prioritized review order based on risk: ${prioritizedFiles.map(f => f.path)}`);
+```
+
+## Core Features
+
+### 1. Multi-Agent Review System
+```bash
+# Initialize code review swarm with gh CLI
+# Get PR details
+PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
+PR_DIFF=$(gh pr diff 123)
+
+# Initialize swarm with PR context
+npx claude-flow@v3alpha github review-init \
+  --pr 123 \
+  --pr-data "$PR_DATA" \
+  --diff "$PR_DIFF" \
+  --agents "security,performance,style,architecture,accessibility" \
+  --depth comprehensive
+
+# Post initial review status
+gh pr comment 123 --body "🔍 Multi-agent code review initiated"
+```
+
+### 2. Specialized Review Agents
+
+#### Security Agent
+```bash
+# Security-focused review with gh CLI
+# Get changed files
+CHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')
+
+# Run security review
+SECURITY_RESULTS=$(npx claude-flow@v3alpha github review-security \
+  --pr 123 \
+  --files "$CHANGED_FILES" \
+  --check "owasp,cve,secrets,permissions" \
+  --suggest-fixes)
+
+# Post security findings
+if echo "$SECURITY_RESULTS" | grep -q "critical"; then
+  # Request changes for critical issues
+  gh pr review 123 --request-changes --body "$SECURITY_RESULTS"
+  # Add security label
+  gh pr edit 123 --add-label "security-review-required"
+else
+  # Post as comment for non-critical issues
+  gh pr comment 123 --body "$SECURITY_RESULTS"
+fi
+```
+
+## 📈 Performance Targets
+
+| Metric | Target | Enabled By |
+|--------|--------|------------|
+| **Review Accuracy** | +12.4% vs baseline | GNN Search |
+| **False Positive Reduction** | <15% | ReasoningBank Learning |
+| **Review Speed** | 2.49x-7.47x faster | Flash Attention |
+| **Issue Detection Rate** | >95% | Combined capabilities |
+| **Developer Satisfaction** | >90% | Attention Consensus |
+
+## 🔧 Implementation Examples
+
+### Example: Security Review with Learning
+
+```typescript
+// Before review: Learn from past security reviews
+const pastSecurityReviews = await reasoningBank.searchPatterns({
+  task: 'security vulnerability review',
+  k: 10,
+  minReward: 0.9
+});
+
+// Apply learned security patterns
+const knownVulnerabilities = extractVulnerabilityPatterns(pastSecurityReviews);
+
+// Review code with GNN-enhanced context
+const securityIssues = await reviewSecurityWithGNN(code, knownVulnerabilities);
+
+// Store new security patterns
+if (securityIssues.length > 0) {
+  await reasoningBank.storePattern({
+    task: 'security vulnerability detected',
+    output: JSON.stringify(securityIssues),
+    reward: calculateSecurityReviewQuality(securityIssues),
+    success: true
+  });
+}
+```
+
+See also: [swarm-pr.md](./swarm-pr.md), [workflow-automation.md](./workflow-automation.md)