elsabro 2.2.0 → 3.7.0

package/templates/observability-config.json

@@ -0,0 +1,109 @@
+{
+  "observability": {
+    "enabled": true,
+    "serviceName": "elsabro",
+    "environment": "development",
+    "version": "3.0.0",
+
+    "tracing": {
+      "enabled": true,
+      "samplingRate": 1.0,
+      "propagation": "w3c",
+      "exporters": ["console"],
+      "spanProcessors": {
+        "batch": {
+          "maxQueueSize": 2048,
+          "maxExportBatchSize": 512,
+          "scheduledDelayMillis": 5000
+        }
+      }
+    },
+
+    "metrics": {
+      "enabled": true,
+      "collectionInterval": 60000,
+      "exporters": ["console"],
+      "predefinedMetrics": {
+        "agents": true,
+        "flows": true,
+        "checkpoints": true,
+        "interrupts": true,
+        "memory": true
+      },
+      "histogramBuckets": {
+        "duration": [1, 5, 10, 30, 60, 120, 300],
+        "tokens": [100, 500, 1000, 5000, 10000, 50000]
+      }
+    },
+
+    "logging": {
+      "enabled": true,
+      "level": "INFO",
+      "structured": true,
+      "includeTraceContext": true,
+      "exporters": ["console"],
+      "format": {
+        "timestamp": true,
+        "level": true,
+        "message": true,
+        "context": true
+      }
+    },
+
+    "events": {
+      "enabled": true,
+      "types": [
+        "agent.started",
+        "agent.completed",
+        "agent.failed",
+        "flow.started",
+        "flow.completed",
+        "checkpoint.saved",
+        "checkpoint.restored",
+        "interrupt.triggered",
+        "interrupt.resolved",
+        "memory.learned",
+        "error.occurred"
+      ]
+    },
+
+    "exporters": {
+      "console": {
+        "enabled": true,
+        "colorize": true,
+        "prettyPrint": true
+      },
+      "file": {
+        "enabled": false,
+        "path": ".planning/telemetry/",
+        "format": "jsonl",
+        "rotation": {
+          "enabled": true,
+          "maxSize": "10MB",
+          "maxFiles": 5
+        }
+      },
+      "jaeger": {
+        "enabled": false,
+        "endpoint": "http://localhost:14268/api/traces",
+        "serviceName": "elsabro"
+      },
+      "langtrace": {
+        "enabled": false,
+        "apiKey": "",
+        "projectId": ""
+      },
+      "otlp": {
+        "enabled": false,
+        "endpoint": "http://localhost:4318",
+        "protocol": "http/protobuf"
+      }
+    },
+
+    "dashboard": {
+      "refreshInterval": 5000,
+      "showActiveOnly": false,
+      "historyLimit": 100
+    }
+  }
+}

package/templates/patterns.md.template

@@ -0,0 +1,114 @@
+# Patrones Preferidos
+
+> Este archivo contiene patrones de codigo que el proyecto prefiere.
+> Claude usa estos patrones como referencia al escribir codigo nuevo.
+
+## Componentes React
+
+```tsx
+// Estructura preferida de componente
+interface Props {
+  // Props tipadas
+}
+
+export function ComponentName({ prop1, prop2 }: Props) {
+  // Hooks primero
+  const [state, setState] = useState<Type>(initial);
+
+  // Efectos despues
+  useEffect(() => {
+    // ...
+  }, [deps]);
+
+  // Handlers
+  const handleClick = () => {
+    // ...
+  };
+
+  // Early returns para casos edge
+  if (!data) return <Loading />;
+
+  // Render principal
+  return (
+    <div>
+      {/* ... */}
+    </div>
+  );
+}
+```
+
+## Custom Hooks
+
+```tsx
+// Estructura preferida de hook
+export function useCustomHook(param: Type) {
+  const [state, setState] = useState<Type>(initial);
+
+  useEffect(() => {
+    // Efecto
+    return () => {
+      // Cleanup
+    };
+  }, [param]);
+
+  return { state, actions };
+}
+```
+
+## API Calls
+
+```tsx
+// Patron preferido para fetch
+async function fetchData<T>(url: string): Promise<T> {
+  const response = await fetch(url);
+
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+  }
+
+  return response.json();
+}
+```
+
+## Error Handling
+
+```tsx
+// Patron preferido para errores
+try {
+  const result = await riskyOperation();
+  return { success: true, data: result };
+} catch (error) {
+  console.error('[Context]:', error);
+  return { success: false, error: error.message };
+}
+```
+
+## Testing
+
+```tsx
+// Estructura preferida de test
+describe('ComponentName', () => {
+  it('should render correctly', () => {
+    render(<ComponentName />);
+    expect(screen.getByRole('button')).toBeInTheDocument();
+  });
+
+  it('should handle user interaction', async () => {
+    const user = userEvent.setup();
+    render(<ComponentName />);
+
+    await user.click(screen.getByRole('button'));
+
+    expect(/* resultado */).toBe(/* esperado */);
+  });
+});
+```
+
+---
+
+## Como Agregar Patrones
+
+Cuando quieras que Claude use un patron especifico, di:
+- "Siempre usa este patron para..."
+- "Prefiero que los componentes se vean asi..."
+- "Guarda este patron en tu memoria"

package/templates/performance-profiler-config.json

@@ -0,0 +1,125 @@
+{
+  "performanceProfiler": {
+    "enabled": true,
+    "version": "1.0.0",
+
+    "profiler": {
+      "defaultMode": "sampling",
+      "samplingInterval": 100,
+      "maxSamples": 10000,
+      "captureStacks": true,
+      "stackDepth": 20,
+      "autoStart": false,
+      "targets": [
+        { "type": "agent", "pattern": "*" },
+        { "type": "flow", "pattern": "*" },
+        { "type": "tool", "pattern": "*" }
+      ]
+    },
+
+    "tracing": {
+      "enabled": true,
+      "traceAgents": true,
+      "traceFlows": true,
+      "traceTools": true,
+      "traceLLMCalls": true,
+      "minDuration": 100,
+      "captureMetadata": true
+    },
+
+    "bottleneckDetection": {
+      "enabled": true,
+      "realtime": true,
+      "thresholds": {
+        "latencyP95": 30000,
+        "latencyP99": 60000,
+        "throughputMin": 0.1,
+        "memoryPressure": 0.8,
+        "errorRate": 0.05
+      },
+      "autoAnalyze": true,
+      "analyzeInterval": 60000
+    },
+
+    "memory": {
+      "trackHeap": true,
+      "trackGC": true,
+      "leakDetection": true,
+      "leakThreshold": 0.1,
+      "snapshotOnLeak": false
+    },
+
+    "latency": {
+      "trackPercentiles": [50, 75, 90, 95, 99],
+      "histogramBuckets": [100, 500, 1000, 5000, 10000, 30000, 60000],
+      "sloTargets": {
+        "agent": { "p95": 30000, "p99": 60000 },
+        "tool": { "p95": 5000, "p99": 10000 },
+        "flow": { "p95": 120000, "p99": 300000 }
+      }
+    },
+
+    "dashboard": {
+      "enabled": true,
+      "refreshInterval": 1000,
+      "showHotspots": true,
+      "showBottlenecks": true,
+      "showRecommendations": true,
+      "showResourceUsage": true,
+      "maxHotspots": 10,
+      "maxBottlenecks": 5,
+      "maxRecommendations": 5
+    },
+
+    "export": {
+      "formats": ["json", "flamegraph", "chrome-trace"],
+      "autoExport": false,
+      "exportPath": ".elsabro/profiles",
+      "retention": {
+        "enabled": true,
+        "maxProfiles": 50,
+        "maxAge": 604800000
+      }
+    },
+
+    "alerts": {
+      "enabled": true,
+      "channels": ["console"],
+      "rules": [
+        {
+          "name": "high-latency",
+          "condition": "p95 > 60000",
+          "severity": "high",
+          "cooldown": 300000
+        },
+        {
+          "name": "memory-leak",
+          "condition": "heapTrend > 0.1",
+          "severity": "critical",
+          "cooldown": 600000
+        },
+        {
+          "name": "low-throughput",
+          "condition": "throughput < 0.05",
+          "severity": "medium",
+          "cooldown": 180000
+        }
+      ]
+    },
+
+    "benchmarking": {
+      "enabled": true,
+      "defaultIterations": 5,
+      "warmupIterations": 1,
+      "cooldownMs": 1000,
+      "compareBaseline": true,
+      "baselinePath": ".elsabro/baselines"
+    },
+
+    "integration": {
+      "observability": true,
+      "costTracking": true,
+      "flowEngine": true
+    }
+  }
+}

package/templates/plugin-config.json

@@ -0,0 +1,170 @@
+{
+  "plugins": {
+    "enabled": true,
+    "version": "1.0.0",
+
+    "discovery": {
+      "sources": [
+        {
+          "type": "directory",
+          "path": ".elsabro/plugins",
+          "enabled": true
+        },
+        {
+          "type": "directory",
+          "path": "~/.elsabro/global-plugins",
+          "enabled": true
+        },
+        {
+          "type": "npm",
+          "scope": "@elsabro",
+          "enabled": false
+        }
+      ],
+      "autoDiscover": true,
+      "scanInterval": 60000
+    },
+
+    "loading": {
+      "validateManifest": true,
+      "checkDependencies": true,
+      "timeout": 30000,
+      "parallel": false
+    },
+
+    "activation": {
+      "autoActivate": true,
+      "activateOnStartup": true,
+      "lazyActivation": true,
+      "activationTimeout": 10000
+    },
+
+    "hotReload": {
+      "enabled": true,
+      "watchPatterns": ["**/*.js", "**/*.ts", "**/*.json"],
+      "ignorePatterns": ["**/node_modules/**", "**/.git/**"],
+      "debounce": 1000
+    },
+
+    "sandbox": {
+      "enabled": true,
+      "timeout": 30000,
+      "resourceLimits": {
+        "memory": 134217728,
+        "cpu": 0.5
+      },
+      "allowedBuiltins": ["path", "url", "util", "events", "crypto"],
+      "blockedBuiltins": ["child_process", "cluster", "dgram", "dns", "net", "tls", "vm", "worker_threads"]
+    },
+
+    "permissions": {
+      "promptUser": true,
+      "rememberChoice": true,
+      "defaultDeny": true,
+      "trustedPublishers": [],
+      "definitions": {
+        "filesystem:read": {
+          "name": "Read Files",
+          "description": "Read files from the filesystem",
+          "risk": "low"
+        },
+        "filesystem:write": {
+          "name": "Write Files",
+          "description": "Create or modify files on the filesystem",
+          "risk": "medium"
+        },
+        "network": {
+          "name": "Network Access",
+          "description": "Make HTTP/HTTPS requests to external services",
+          "risk": "medium"
+        },
+        "shell": {
+          "name": "Execute Commands",
+          "description": "Run shell commands and scripts",
+          "risk": "high"
+        },
+        "env": {
+          "name": "Environment Variables",
+          "description": "Access environment variables",
+          "risk": "low"
+        },
+        "secrets": {
+          "name": "Secrets Access",
+          "description": "Access the secrets vault",
+          "risk": "high"
+        },
+        "config:read": {
+          "name": "Read Configuration",
+          "description": "Read ELSABRO configuration",
+          "risk": "low"
+        },
+        "config:write": {
+          "name": "Write Configuration",
+          "description": "Modify ELSABRO configuration",
+          "risk": "medium"
+        }
+      }
+    },
+
+    "storage": {
+      "path": ".elsabro/plugin-data",
+      "maxSizePerPlugin": 52428800,
+      "backupEnabled": true,
+      "encryptSensitive": true
+    },
+
+    "registry": {
+      "deduplicateContributions": true,
+      "allowOverrides": false,
+      "namespaceContributions": true
+    },
+
+    "hooks": {
+      "enabled": true,
+      "timeout": 5000,
+      "continueOnError": true,
+      "builtinPoints": [
+        "agent:beforeRun",
+        "agent:afterRun",
+        "tool:beforeExecute",
+        "tool:afterExecute",
+        "llm:beforeCall",
+        "llm:afterCall",
+        "config:change",
+        "plugin:activate",
+        "plugin:deactivate",
+        "session:start",
+        "session:end",
+        "error:occurred"
+      ]
+    },
+
+    "marketplace": {
+      "enabled": false,
+      "url": "https://plugins.elsabro.dev",
+      "checkUpdates": true,
+      "updateCheckInterval": 86400000,
+      "autoUpdate": false
+    },
+
+    "telemetry": {
+      "enabled": false,
+      "collectUsage": false,
+      "collectErrors": true,
+      "anonymize": true
+    },
+
+    "logging": {
+      "enabled": true,
+      "level": "info",
+      "perPlugin": true,
+      "logPath": ".elsabro/logs/plugins"
+    },
+
+    "defaults": {
+      "disabled": [],
+      "alwaysEnabled": [],
+      "preInstalled": []
+    }
+  }
+}

package/templates/prompt-management-config.json

@@ -0,0 +1,86 @@
+{
+  "promptManagement": {
+    "enabled": true,
+    "version": "1.0.0",
+
+    "registry": {
+      "loadBuiltins": true,
+      "customPath": ".elsabro/prompts",
+      "watchForChanges": true,
+      "cacheEnabled": true,
+      "cacheTTL": 300000
+    },
+
+    "engine": {
+      "strictMode": false,
+      "escapeHtml": false,
+      "maxTemplateSize": 100000,
+      "maxNestingDepth": 10,
+      "customHelpers": {}
+    },
+
+    "variables": {
+      "validation": {
+        "enabled": true,
+        "strict": false
+      },
+      "defaults": {
+        "language": "typescript",
+        "framework": null
+      }
+    },
+
+    "versioning": {
+      "strategy": "semver",
+      "autoIncrement": false,
+      "keepVersions": 10
+    },
+
+    "experiments": {
+      "enabled": true,
+      "minSampleSize": 30,
+      "maxConcurrent": 5,
+      "defaultTrafficSplit": "equal",
+      "defaultMetrics": ["success_rate", "quality_score", "completion_time"],
+      "autoAnalyze": true,
+      "confidenceThreshold": 0.95,
+      "persistence": {
+        "enabled": true,
+        "path": ".elsabro/experiments"
+      }
+    },
+
+    "builtinTemplates": {
+      "explore": { "enabled": true, "category": "exploration" },
+      "implement": { "enabled": true, "category": "implementation" },
+      "review": { "enabled": true, "category": "review" },
+      "plan": { "enabled": true, "category": "planning" },
+      "debug": { "enabled": true, "category": "debugging" },
+      "test": { "enabled": true, "category": "testing" }
+    },
+
+    "categories": [
+      "exploration",
+      "implementation",
+      "review",
+      "planning",
+      "debugging",
+      "testing",
+      "documentation",
+      "analysis",
+      "custom"
+    ],
+
+    "export": {
+      "formats": ["json", "yaml"],
+      "includeMetadata": true,
+      "includeExperiments": false
+    },
+
+    "logging": {
+      "enabled": true,
+      "logRenders": false,
+      "logExperiments": true
+    }
+  }
+}