feat(v1.5.2): Execute database migrations and complete setup

- Execute all 6 migrations on Desk CRM production database - Create missing tables: cr_lsps, cr_agent_lsps, cr_lsp_usage - Create archive tables: cr_*_usage_archive (4 tables) - Create system tables: cr_migrations, cr_maintenance_log - Make all scripts executable (chmod +x) - Total cr_* tables: 38 Migration files: - 001_initial_schema.sql - 002_add_lsps.sql - 003_add_relationships.sql - 004_add_telemetry.sql - 005_add_archive_tables.sql - 006_add_maintenance_log.sql Scripts: - session-init.sh, session-end.sh - inject-context.sh, inject-agent-context.sh - record-usage.sh, db-backup.sh, sync-to-mysql.sh Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 16:18:02 +00:00
commit 692475a315
55 changed files with 11950 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,253 @@
+# Descomplicar Meta-Plugin
+
+Meta-plugin para gestão automatizada da infraestrutura Claude Code com suporte completo a MCPs, LSPs, relacionamentos e telemetria.
+
+## Versão
+
+**v1.2.0** - Adicionado suporte completo a LSPs, telemetria e documentação de boas práticas.
+
+## Documentação
+
+| Documento | Descrição |
+|-----------|-----------|
+| [STANDARDS.md](STANDARDS.md) | Regras oficiais do ecossistema |
+| [docs/01-GUIA-SKILLS.md](docs/01-GUIA-SKILLS.md) | Guia definitivo para skills |
+| [docs/02-GUIA-AGENTS.md](docs/02-GUIA-AGENTS.md) | Guia definitivo para agents |
+| [docs/03-GUIA-HOOKS.md](docs/03-GUIA-HOOKS.md) | Guia completo de hooks (12 eventos) |
+| [docs/04-GUIA-PLUGINS.md](docs/04-GUIA-PLUGINS.md) | Guia de plugins |
+| [docs/05-CHECKLISTS.md](docs/05-CHECKLISTS.md) | Checklists de validação |
+| [docs/06-TEMPLATES.md](docs/06-TEMPLATES.md) | Templates prontos |
+
+## Funcionalidades
+
+- **Monitorização** - Health check de todos os componentes (Agents, Skills, MCPs, LSPs, SDKs)
+- **Relacionamentos** - Gestão de 800+ mapeamentos entre componentes
+- **LSPs** - Language Server Protocols para agentes de desenvolvimento
+- **Telemetria** - Métricas de uso de agentes, skills, MCPs e LSPs
+- **Sincronização** - Bidireccional entre ficheiros e MySQL
+- **Descoberta** - Plugins relevantes nos marketplaces
+- **Injecção** - Contexto dinâmico para agentes (MCPs + LSPs)
+- **Decision Trees** - Selecção automática de agentes baseada em keywords
+
+## Instalação
+
+```bash
+# Via plugin-dir (desenvolvimento)
+claude --plugin-dir ~/mcp-servers/descomplicar-meta-plugin
+
+# Via marketplace (produção)
+/plugin marketplace add descomplicar/meta-plugin
+/plugin install descomplicar-meta-plugin
+```
+
+### Configurar Base de Dados
+
+```bash
+# Executar SQL de criação das tabelas LSP
+mysql -u user -p ealmeida_desk24 < sql/create-lsp-tables.sql
+```
+
+## Comandos
+
+| Comando | Descrição |
+|---------|-----------|
+| `/descomplicar:status` | Dashboard completo de infraestrutura |
+| `/descomplicar:sync` | Sincronização ficheiros ↔ MySQL |
+| `/descomplicar:discover` | Descoberta de plugins |
+| `/descomplicar:agent-config` | Configuração de recursos por agente |
+| `/descomplicar:relationships` | Gestão de relacionamentos |
+| `/descomplicar:telemetry` | Métricas de uso e performance |
+| `/descomplicar:decision-trees` | Gestão de árvores de decisão |
+| `/descomplicar:lsps` | Gestão de Language Server Protocols |
+
+## Skills
+
+| Skill | Trigger |
+|-------|---------|
+| `infrastructure-manager` | Problemas de sistema, health < 90 |
+| `relationship-manager` | Configuração de relacionamentos |
+| `plugin-curator` | Recomendações de plugins |
+| `agent-context-injector` | Hook SubagentStart automático |
+| `lsp-manager` | Gestão de LSPs para dev agents |
+
+## Agents
+
+| Agent | Uso |
+|-------|-----|
+| `infrastructure-orchestrator` | Diagnóstico e gestão de sistema |
+| `plugin-evaluator` | Avaliação de plugins |
+
+## Hooks
+
+| Evento | Script | Função |
+|--------|--------|--------|
+| SessionStart | `session-init.sh` | Quick health check |
+| SubagentStart | `inject-agent-context.sh` | Injecção de contexto (MCPs + LSPs) |
+| Stop | `session-end.sh` | Cleanup e logging |
+
+## Estrutura
+
+```
+descomplicar-meta-plugin/
+├── .claude-plugin/
+│   └── plugin.json              # Manifesto v1.1.0
+├── commands/
+│   ├── infra-status.md          # /descomplicar:status
+│   ├── infra-sync.md            # /descomplicar:sync
+│   ├── discover-plugins.md      # /descomplicar:discover
+│   ├── agent-config.md          # /descomplicar:agent-config
+│   ├── relationships.md         # /descomplicar:relationships
+│   ├── telemetry.md             # /descomplicar:telemetry
+│   ├── decision-trees.md        # /descomplicar:decision-trees
+│   └── lsps.md                  # /descomplicar:lsps
+├── skills/
+│   ├── infrastructure-manager/
+│   ├── relationship-manager/
+│   ├── plugin-curator/
+│   ├── agent-context-injector/
+│   └── lsp-manager/
+├── agents/
+│   ├── infrastructure-orchestrator.md
+│   └── plugin-evaluator.md
+├── docs/
+│   ├── 01-GUIA-SKILLS.md
+│   ├── 02-GUIA-AGENTS.md
+│   ├── 03-GUIA-HOOKS.md
+│   ├── 04-GUIA-PLUGINS.md
+│   ├── 05-CHECKLISTS.md
+│   ├── 06-TEMPLATES.md
+│   └── README.md
+├── hooks/
+│   └── hooks.json
+├── scripts/
+│   ├── session-init.sh
+│   ├── inject-agent-context.sh
+│   ├── session-end.sh
+│   └── sync-to-mysql.sh
+├── sql/
+│   └── create-lsp-tables.sql    # Tabelas LSP
+├── lib/
+│   └── (scripts auxiliares)
+└── .mcp.json
+```
+
+## Base de Dados
+
+### Core Tables (Entidades)
+
+| Tabela | Registos | Descrição |
+|--------|----------|-----------|
+| `cr_agents` | 46 | Agentes especializados |
+| `cr_skills` | 54 | Skills invocáveis |
+| `cr_mcps` | 33 | Servidores MCP |
+| `cr_lsps` | 11 | Language Server Protocols |
+| `cr_sdks` | 29 | Software Development Kits |
+| `cr_mcp_tools` | 822 | Ferramentas por MCP |
+| `cr_plugins` | 5+ | Plugins instalados |
+
+### Relationship Tables (800+ relacionamentos)
+
+| Tabela | Registos | Relacionamento |
+|--------|----------|----------------|
+| `cr_agent_mcps` | 483 | Agente ↔ MCP (primary/recommended/available) |
+| `cr_agent_lsps` | ~40 | Agente ↔ LSP (primary/recommended/available) |
+| `cr_sdk_agents` | 131 | SDK ↔ Agente |
+| `cr_sdk_skills` | 75 | SDK ↔ Skill |
+| `cr_sdk_mcps` | 56 | SDK ↔ MCP |
+| `cr_agent_skills` | ~50 | Agente ↔ Skill |
+| `cr_skill_mcps` | ~45 | Skill ↔ MCP |
+| `cr_agent_collaborations` | ~30 | Agente ↔ Agente |
+
+### Telemetry Tables
+
+| Tabela | Descrição |
+|--------|-----------|
+| `cr_agent_usage` | Tracking uso de agentes |
+| `cr_skill_usage` | Tracking uso de skills |
+| `cr_mcp_tool_usage` | Tracking uso de ferramentas MCP |
+| `cr_lsp_usage` | Tracking uso de LSPs |
+
+### Intelligence Tables
+
+| Tabela | Descrição |
+|--------|-----------|
+| `cr_decision_trees` | Árvores de decisão para selecção de agentes |
+| `cr_recommendations` | Sugestões de melhorias |
+| `cr_component_issues` | Issues abertos |
+| `cr_reflections` | Reflexões do sistema |
+
+## LSPs Suportados
+
+| LSP | Linguagem | Agentes Típicos |
+|-----|-----------|-----------------|
+| intelephense | PHP | php-fullstack-engineer, wordpress-plugin-developer |
+| typescript-language-server | TypeScript/JS | javascript-fullstack-specialist |
+| pyright | Python | dev-helper |
+| gopls | Go | dev-helper |
+| rust-analyzer | Rust | dev-helper |
+| yaml-language-server | YAML | easypanel-specialist, n8n-automation-expert |
+| bash-language-server | Bash | cwp-server-manager, backup-specialist |
+| sql-language-server | SQL | database-design-specialist |
+| vscode-css-languageserver | CSS | web-designer, ui-designer |
+| vscode-html-languageserver | HTML | web-designer, elementor-specialist |
+| vscode-json-languageserver | JSON | n8n-automation-expert |
+
+## Dependências
+
+- Claude Code >= 1.0.33
+- MCPs: desk-crm-v3, filesystem, gitea, mcp-time
+- MySQL (ealmeida_desk24)
+- jq (opcional, para scripts avançados)
+
+## Health Score
+
+```
+Health Score = (
+  entities_sync * 20 +
+  relationships_consistent * 20 +
+  mcps_responsive * 15 +
+  lsps_installed * 10 +
+  hooks_healthy * 10 +
+  decision_trees_valid * 10 +
+  telemetry_active * 10 +
+  plugins_functional * 5
+) / 100
+```
+
+**Thresholds:**
+- >= 90: Excelente (verde)
+- 70-89: Bom (amarelo)
+- < 70: Crítico (vermelho)
+
+## Métricas
+
+| Métrica | Target |
+|---------|--------|
+| Health Score | >= 90 |
+| Órfãos | 0 |
+| Context injection | < 2s |
+| Sync frequency | 6h |
+| LSP coverage (dev agents) | >= 80% |
+
+## Changelog
+
+### v1.1.0 (2026-02-04)
+- Adicionado suporte completo a LSPs (11 language servers)
+- Nova tabela `cr_lsps` e `cr_agent_lsps`
+- Novo comando `/descomplicar:lsps`
+- Nova skill `lsp-manager`
+- Telemetria de LSPs (`cr_lsp_usage`)
+- Actualizado health score para incluir LSPs
+
+### v1.0.0 (2026-02-04)
+- Release inicial
+- Suporte a MCPs, relacionamentos, telemetria
+- 8 comandos, 5 skills, 2 agents
+
+## Autor
+
+Descomplicar® | descomplicar.pt
+
+## Licença
+
+MIT