@mcp-graph-workflow/mcp-graph 5.2.0 → 5.4.0

package/dist/core/skills/built-in-skills.js

@@ -0,0 +1,467 @@
+/**
+ * Built-in Skills Registry — 40 skills mapped to lifecycle phases.
+ * Each skill is a structured instruction set for agentic workflows.
+ */
+export const BUILT_IN_SKILLS = [
+    // ── ANALYZE ──────────────────────────────────
+    {
+        name: "create-prd-chat-mode",
+        description: "Guia interativo para criação de PRD a partir de conversa com o usuário",
+        category: "analyze",
+        phases: ["ANALYZE"],
+        instructions: "Conduza uma conversa estruturada para extrair requisitos do usuário. " +
+            "Pergunte sobre problema, usuários-alvo, critérios de sucesso e restrições. " +
+            "Gere um PRD markdown com seções: Problema, Solução, Requisitos Funcionais, " +
+            "Requisitos Não-Funcionais, Critérios de Aceitação, Riscos.",
+    },
+    {
+        name: "business-analyst",
+        description: "Análise de negócio para requisitos e viabilidade",
+        category: "analyze",
+        phases: ["ANALYZE"],
+        instructions: "Analise a proposta de negócio do ponto de vista de viabilidade técnica e comercial. " +
+            "Identifique stakeholders, mapeie processos AS-IS/TO-BE, defina KPIs mensuráveis. " +
+            "Output: relatório de análise com recomendações priorizadas.",
+    },
+    {
+        name: "product-manager",
+        description: "Visão de produto, roadmap e priorização",
+        category: "analyze",
+        phases: ["ANALYZE"],
+        instructions: "Assuma o papel de PM sênior. Defina visão do produto, personas, jobs-to-be-done. " +
+            "Priorize features via RICE ou MoSCoW. Garanta alinhamento entre valor de negócio " +
+            "e esforço técnico. Output: roadmap priorizado com justificativas.",
+    },
+    // ── DESIGN ──────────────────────────────────
+    {
+        name: "breakdown-epic-arch",
+        description: "Decomposição de epic em componentes arquiteturais",
+        category: "design",
+        phases: ["DESIGN"],
+        instructions: "Receba um epic e decomponha em componentes arquiteturais. Identifique bounded contexts, " +
+            "defina interfaces entre módulos, documente decisões via ADR. Considere escalabilidade, " +
+            "manutenibilidade e testabilidade. Output: diagrama de componentes + ADRs.",
+    },
+    {
+        name: "context-architect",
+        description: "Arquitetura de contexto e dependências entre módulos",
+        category: "design",
+        phases: ["DESIGN"],
+        instructions: "Mapeie o contexto do sistema: dependências externas, integrações, fluxos de dados. " +
+            "Use C4 model para documentar system context e container views. Identifique pontos " +
+            "de acoplamento e proponha abstrações. Output: diagrama C4 + dependency map.",
+    },
+    {
+        name: "backend-architect",
+        description: "Design de arquitetura backend e APIs",
+        category: "design",
+        phases: ["DESIGN"],
+        instructions: "Projete a arquitetura backend: API design (REST/GraphQL), data model, " +
+            "autenticação, cache strategy, error handling. Siga princípios SOLID e clean architecture. " +
+            "Documente contratos via OpenAPI. Output: API spec + data model + ADR.",
+    },
+    // ── PLAN ────────────────────────────────────
+    {
+        name: "breakdown-feature-prd",
+        description: "Decomposição de feature PRD em tasks atômicas",
+        category: "plan",
+        phases: ["PLAN"],
+        instructions: "Receba um PRD e decomponha cada feature em tasks atômicas (≤2h cada). " +
+            "Defina dependências entre tasks, estime complexidade, atribua a sprints. " +
+            "Cada task deve ter acceptance criteria testáveis. Output: lista de tasks com deps.",
+    },
+    {
+        name: "track-with-mcp-graph",
+        description: "Sincronizar trabalho com o grafo de execução mcp-graph",
+        category: "plan",
+        phases: ["PLAN"],
+        instructions: "Use as tools do mcp-graph para manter o grafo sincronizado com o trabalho real. " +
+            "Workflow: import_prd → decompose → plan_sprint → edge (dependências). " +
+            "Garanta que cada node tem AC, sprint e prioridade definidos antes de IMPLEMENT.",
+    },
+    // ── IMPLEMENT ────────────────────────────────
+    {
+        name: "subagent-driven-development",
+        description: "Desenvolvimento orientado por sub-agentes especializados",
+        category: "implement",
+        phases: ["IMPLEMENT"],
+        instructions: "Decomponha a implementação em sub-tasks que podem ser delegadas a agentes especializados. " +
+            "Cada sub-agente recebe contexto mínimo (via `context` tool) e entrega código testado. " +
+            "Orquestre: next → context → implement (TDD) → update_status. Anti-one-shot obrigatório.",
+    },
+    {
+        name: "xp-bootstrap",
+        description: "Bootstrap de projeto seguindo metodologia XP anti-vibe-coding",
+        category: "implement",
+        phases: ["IMPLEMENT"],
+        instructions: "Siga o workflow XP sequencial: Isolation → Foundation → TDD → Implementation → " +
+            "Optimization → Interface → Deploy. Cada fase tem gates de qualidade. " +
+            "TDD obrigatório em todas as fases. Skeleton & Organs: dev define arquitetura, AI implementa.",
+    },
+    // ── VALIDATE ─────────────────────────────────
+    {
+        name: "playwright-explore-website",
+        description: "Exploração automatizada de website via Playwright",
+        category: "validate",
+        phases: ["VALIDATE"],
+        instructions: "Use Playwright MCP para navegar no site/app, capturar screenshots, verificar elementos. " +
+            "Explore fluxos de usuário, verifique responsividade, identifique broken links. " +
+            "Documente findings com screenshots anotados. Output: relatório de exploração.",
+    },
+    {
+        name: "playwright-generate-test",
+        description: "Geração de testes E2E a partir de exploração Playwright",
+        category: "validate",
+        phases: ["VALIDATE"],
+        instructions: "A partir dos acceptance criteria, gere testes E2E com Playwright. " +
+            "Cada AC deve ter pelo menos 1 teste. Use page objects, fixtures e assertions robustas. " +
+            "Testes devem ser determinísticos e independentes. Output: test files prontos para CI.",
+    },
+    {
+        name: "playwright-tester-mode",
+        description: "Modo de teste interativo com Playwright",
+        category: "validate",
+        phases: ["VALIDATE"],
+        instructions: "Execute testes E2E em modo interativo usando Playwright MCP tools. " +
+            "Navegue, clique, preencha forms, valide snapshots. Reporte falhas com contexto " +
+            "completo (screenshot, DOM state, console errors). Output: test results + evidence.",
+    },
+    {
+        name: "e2e-testing",
+        description: "Framework completo de testes end-to-end",
+        category: "validate",
+        phases: ["VALIDATE"],
+        instructions: "Implemente cobertura E2E completa: happy paths, edge cases, error scenarios. " +
+            "Use test pyramid: unit → integration → E2E. Configure CI pipeline para executar " +
+            "testes em cada PR. Defina thresholds de cobertura. Output: test suite + CI config.",
+    },
+    // ── REVIEW ──────────────────────────────────
+    {
+        name: "code-reviewer",
+        description: "Code review estruturado com checklist de qualidade",
+        category: "review",
+        phases: ["REVIEW"],
+        instructions: "Revise o código contra checklist: correctness, security (OWASP top 10), performance, " +
+            "readability, test coverage, error handling. Use Code Intelligence para blast radius. " +
+            "Comente inline com severity (blocker/major/minor/nit). Output: review com action items.",
+    },
+    {
+        name: "code-review-checklist",
+        description: "Checklist detalhado para code review",
+        category: "review",
+        phases: ["REVIEW"],
+        instructions: "Aplique checklist sistemático: [ ] Testes escritos antes (TDD)? [ ] Sem mocks desnecessários? " +
+            "[ ] Logger em paths críticos? [ ] Error handling tipado? [ ] Sem dead code? " +
+            "[ ] Build + typecheck + tests passam? Documente cada item com evidência.",
+    },
+    {
+        name: "review-and-refactor",
+        description: "Review com foco em refatoração e melhoria contínua",
+        category: "review",
+        phases: ["REVIEW"],
+        instructions: "Analise o código para oportunidades de refatoração: DRY violations, complex conditionals, " +
+            "missing abstractions, code smells. Proponha refactors com justificativa e impacto. " +
+            "Garanta non-regression via testes antes e depois. Output: refactor plan + PRs.",
+    },
+    {
+        name: "log-standardization-framework",
+        description: "Padronização de logs e observabilidade",
+        category: "review",
+        phases: ["REVIEW"],
+        instructions: "Audite logs do projeto: [ ] Logger usado (nunca console.log)? [ ] Structured logging? " +
+            "[ ] Entry points logados (info)? [ ] Error paths com stack trace? [ ] External calls " +
+            "com timing (debug)? Corrija violações. Output: log audit report + fixes.",
+    },
+    {
+        name: "observability-engineer",
+        description: "Engenharia de observabilidade — métricas, traces, alertas",
+        category: "review",
+        phases: ["REVIEW"],
+        instructions: "Configure observabilidade: métricas de aplicação, distributed tracing, health checks. " +
+            "Defina SLIs/SLOs para endpoints críticos. Configure alertas para anomalias. " +
+            "Garanta que logs são queryable (structured, not free-text). Output: observability setup.",
+    },
+    // ── SOFTWARE DESIGN PRINCIPLES ────────────────────
+    {
+        name: "kiss",
+        description: "Keep It Simple, Stupid — simplicidade como princípio de design",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Aplique o princípio KISS em todas as decisões de design e implementação. " +
+            "Prefira soluções simples e diretas. Evite abstrações prematuras, generalizações desnecessárias " +
+            "e complexidade acidental. Pergunte: 'Qual é a forma mais simples de resolver isso?' " +
+            "Se a solução precisa de um diagrama para ser entendida, simplifique.",
+    },
+    {
+        name: "yagni",
+        description: "You Aren't Gonna Need It — não implemente o que não é necessário agora",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Aplique YAGNI rigorosamente. Não adicione features, configurações ou abstrações 'para o futuro'. " +
+            "Implemente apenas o que é explicitamente necessário para o requisito atual. " +
+            "Se não há user story ou AC pedindo, não implemente. Código não escrito é código sem bugs.",
+    },
+    {
+        name: "dry",
+        description: "Don't Repeat Yourself — elimine duplicação de conhecimento",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Identifique e elimine duplicação de conhecimento (não apenas código). " +
+            "Cada conceito deve ter uma única representação autoritativa no sistema. " +
+            "Atenção: DRY é sobre conhecimento, não sintaxe — duas funções com código similar " +
+            "mas razões de mudança diferentes NÃO são duplicação.",
+    },
+    {
+        name: "solid-srp",
+        description: "Single Responsibility Principle — uma razão para mudar",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Cada módulo/classe/função deve ter uma única razão para mudar. " +
+            "Identifique os atores (stakeholders) que podem solicitar mudanças e separe responsabilidades " +
+            "por ator. Se uma classe muda por mais de uma razão, extraia responsabilidades em módulos separados.",
+    },
+    {
+        name: "solid-ocp",
+        description: "Open/Closed Principle — aberto para extensão, fechado para modificação",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Projete módulos que possam ser estendidos sem modificação do código existente. " +
+            "Use abstrações (interfaces, strategy pattern, plugins) para pontos de extensão previsíveis. " +
+            "Quando um novo requisito chega, prefira adicionar código novo a alterar código estável.",
+    },
+    {
+        name: "solid-lsp",
+        description: "Liskov Substitution Principle — subtipos devem ser substituíveis",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Garanta que subtipos podem substituir seus tipos base sem quebrar o comportamento esperado. " +
+            "Verifique: pré-condições não são fortalecidas, pós-condições não são enfraquecidas, " +
+            "invariantes são preservados. Se uma subclasse precisa de um 'if instanceof', há violação de LSP.",
+    },
+    {
+        name: "solid-isp",
+        description: "Interface Segregation Principle — interfaces coesas e específicas",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Prefira interfaces pequenas e específicas a interfaces grandes e genéricas. " +
+            "Nenhum cliente deve ser forçado a depender de métodos que não usa. " +
+            "Quando uma interface tem muitos métodos, divida por coesão funcional.",
+    },
+    {
+        name: "solid-dip",
+        description: "Dependency Inversion Principle — dependa de abstrações",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Módulos de alto nível não devem depender de módulos de baixo nível — ambos devem depender de abstrações. " +
+            "Abstrações não devem depender de detalhes. Use injeção de dependência e interfaces " +
+            "para desacoplar camadas. A direção de dependência deve apontar para políticas, não para detalhes.",
+    },
+    {
+        name: "tell-dont-ask",
+        description: "Tell, Don't Ask — peça ao objeto que faça, não pergunte seu estado",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Em vez de perguntar o estado de um objeto para decidir o que fazer, diga ao objeto o que fazer. " +
+            "Evite getters seguidos de lógica condicional externa. Encapsule comportamento junto com dados. " +
+            "Se você faz obj.getX() para decidir algo, considere mover a decisão para dentro do obj.",
+    },
+    {
+        name: "law-of-demeter",
+        description: "Lei de Demeter — fale apenas com seus amigos próximos",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Cada módulo deve ter conhecimento limitado sobre outros módulos. " +
+            "Evite cadeias de chamadas como a.getB().getC().doSomething(). " +
+            "Um método deve chamar apenas: seus próprios métodos, métodos de seus parâmetros, " +
+            "métodos de objetos que ele cria, e métodos de suas dependências diretas.",
+    },
+    {
+        name: "composition-over-inheritance",
+        description: "Composição sobre Herança — favoreça composição de comportamento",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Prefira composição (has-a) sobre herança (is-a) para reutilização de código. " +
+            "Herança cria acoplamento forte e hierarquias rígidas. Use composição com interfaces " +
+            "para combinar comportamentos flexivelmente. Reserve herança para relações genuínas de subtipo.",
+    },
+    {
+        name: "fail-fast",
+        description: "Fail Fast — detecte e reporte erros imediatamente",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Valide inputs e pré-condições no ponto de entrada, não no meio do processamento. " +
+            "Use assertions, guards e validação Zod nas fronteiras. Falhe com mensagens claras " +
+            "e stack traces preservados. Nunca engula erros silenciosamente — log + rethrow ou handle explicitamente.",
+    },
+    {
+        name: "clean-architecture",
+        description: "Clean Architecture — camadas com direção de dependência controlada",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Organize o código em camadas concêntricas: Entities → Use Cases → Adapters → Frameworks. " +
+            "Dependências apontam para dentro (regra de dependência). O core de negócio não conhece " +
+            "frameworks, DB ou UI. Use interfaces para inverter dependências nas fronteiras.",
+    },
+    {
+        name: "separation-of-concerns",
+        description: "Separação de Responsabilidades — cada módulo faz uma coisa",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Separe o sistema em módulos distintos com responsabilidades claras e sobreposição mínima. " +
+            "Cada camada (CLI, API, Core, Store) tem um papel definido. Não misture lógica de apresentação " +
+            "com lógica de negócio. Não misture acesso a dados com regras de domínio.",
+    },
+    {
+        name: "boy-scout-rule",
+        description: "Regra do Escoteiro — deixe o código melhor do que encontrou",
+        category: "software-design",
+        phases: ["DESIGN", "IMPLEMENT", "REVIEW"],
+        instructions: "Ao tocar em código existente, faça pequenas melhorias incrementais: renomeie variáveis " +
+            "mal nomeadas, extraia funções longas, remova dead code, adicione tipagem faltante. " +
+            "Não refatore tudo de uma vez — melhorias pequenas e consistentes acumulam qualidade.",
+    },
+    // ── DDD ──────────────────────────────────────────
+    {
+        name: "domain-driven-design",
+        description: "Domain-Driven Design — modelagem orientada ao domínio de negócio",
+        category: "ddd",
+        phases: ["DESIGN", "PLAN"],
+        instructions: "Modele o software em torno do domínio de negócio. Identifique bounded contexts, " +
+            "entidades, value objects, aggregates e domain events. Use linguagem ubíqua — " +
+            "termos do domínio no código. Separe subdomínios (core, supporting, generic). " +
+            "Context maps para definir relacionamentos entre bounded contexts.",
+    },
+    // ── SECURITY ─────────────────────────────────────
+    {
+        name: "owasp-web-security",
+        description: "OWASP Top 10 — segurança web essencial",
+        category: "security",
+        phases: ["DESIGN", "REVIEW", "VALIDATE"],
+        instructions: "Verifique contra OWASP Top 10: Injection (SQL, NoSQL, OS), Broken Auth, " +
+            "Sensitive Data Exposure, XXE, Broken Access Control, Security Misconfiguration, " +
+            "XSS, Insecure Deserialization, Using Components with Known Vulns, Insufficient Logging. " +
+            "Para cada item: identifique superfície de ataque, aplique mitigação, documente.",
+    },
+    {
+        name: "auth-and-secrets",
+        description: "Autenticação, autorização e gestão de segredos",
+        category: "security",
+        phases: ["DESIGN", "REVIEW", "VALIDATE"],
+        instructions: "Nunca hardcode secrets — use variáveis de ambiente ou vault. Tokens JWT com expiração curta. " +
+            "Hash de senhas com bcrypt/argon2 (nunca MD5/SHA). RBAC ou ABAC para autorização. " +
+            "Valide tokens em cada request. Revogue sessões ativas em caso de compromisso. " +
+            "Audite acessos a recursos sensíveis. .env nunca no git.",
+    },
+    {
+        name: "database-and-deps-security",
+        description: "Segurança de banco de dados e dependências",
+        category: "security",
+        phases: ["DESIGN", "REVIEW", "VALIDATE"],
+        instructions: "Use prepared statements / parameterized queries para prevenir SQL injection. " +
+            "Princípio do menor privilégio para acessos ao DB. Audite dependências com npm audit. " +
+            "Lock files commitados. Mantenha deps atualizadas. Nunca exponha stack traces em produção. " +
+            "Encrypt dados sensíveis at rest. Backup strategy com testes de restore.",
+    },
+    // ── FRONTEND DESIGN ──────────────────────────────
+    {
+        name: "ui-ux-patterns",
+        description: "Padrões de UI/UX para interfaces eficazes",
+        category: "frontend-design",
+        phases: ["DESIGN", "IMPLEMENT"],
+        instructions: "Aplique padrões de UX comprovados: loading states para toda operação assíncrona, " +
+            "error states com ações de recovery, empty states informativos, feedback visual imediato. " +
+            "Acessibilidade: ARIA labels, keyboard navigation, contraste mínimo WCAG AA. " +
+            "Responsividade: mobile-first, breakpoints consistentes. Performance: lazy loading, " +
+            "virtualização para listas longas, debounce em inputs.",
+    },
+    // ── TESTING ──────────────────────────────────────
+    {
+        name: "comprehensive-testing-reference",
+        description: "Referência completa de estratégia de testes",
+        category: "testing",
+        phases: ["IMPLEMENT", "VALIDATE"],
+        instructions: "Siga a pirâmide de testes: muitos unit tests, integration tests moderados, poucos E2E. " +
+            "Unit: isolados, rápidos, uma assertion por conceito, factory functions para fixtures. " +
+            "Integration: real DB (in-memory), real file I/O (tmp), mock apenas fronteiras externas. " +
+            "E2E: fluxos reais do usuário, Playwright para browser. Cobertura: 80%+ para core, " +
+            "100% para paths críticos (auth, payments, data integrity). TDD: Red → Green → Refactor.",
+    },
+    // ── RESEARCH ─────────────────────────────────────
+    {
+        name: "research-methodology",
+        description: "Metodologia de pesquisa estruturada para decisões técnicas",
+        category: "research",
+        phases: ["ANALYZE"],
+        instructions: "Para pesquisa técnica: 1) Defina a pergunta central claramente. " +
+            "2) Liste opções candidatas (mín. 3). 3) Defina critérios de avaliação objetivos " +
+            "(performance, manutenibilidade, comunidade, licença, custo). " +
+            "4) Avalie cada opção contra cada critério com evidência. " +
+            "5) Documente trade-offs e decisão final em ADR. " +
+            "6) Prototipe a opção vencedora antes de comprometer. Use Context7 para docs atualizados.",
+    },
+    // ── COST REDUCER ─────────────────────────────────
+    {
+        name: "cloud-infra-cost",
+        description: "Otimização de custos de infraestrutura cloud",
+        category: "cost-reducer",
+        phases: ["DESIGN", "REVIEW"],
+        instructions: "Audite custos de infra: right-sizing de instâncias (CPU/memory utilization), " +
+            "reserved/spot instances, auto-scaling policies, storage tiering (hot/warm/cold). " +
+            "Identifique recursos ociosos (unused EIPs, unattached volumes, idle load balancers). " +
+            "CDN para assets estáticos. Serverless para workloads intermitentes. " +
+            "Budget alerts e cost anomaly detection. FinOps: tag resources por team/project.",
+    },
+    {
+        name: "code-level-savings",
+        description: "Economias a nível de código — performance e eficiência",
+        category: "cost-reducer",
+        phases: ["DESIGN", "REVIEW"],
+        instructions: "Otimize código para reduzir custo computacional: queries N+1 → batch/join, " +
+            "caching estratégico (Redis/in-memory) para dados lidos frequentemente, " +
+            "connection pooling, lazy loading de recursos pesados, pagination para datasets grandes. " +
+            "Compressão de responses (gzip/brotli). Índices de DB otimizados para queries frequentes. " +
+            "Elimine computações redundantes. Profile antes de otimizar.",
+    },
+    {
+        name: "finops-services",
+        description: "FinOps para serviços gerenciados e APIs externas",
+        category: "cost-reducer",
+        phases: ["DESIGN", "REVIEW"],
+        instructions: "Gerencie custos de serviços gerenciados e APIs externas: rate limiting para proteger budget, " +
+            "caching de responses de APIs pagas, batch requests quando possível. " +
+            "LLM costs: prompt compression, response caching, model tiering (use modelos menores " +
+            "para tasks simples). Monitore spend por serviço. Defina budgets por team/feature. " +
+            "Alertas quando spend excede threshold.",
+    },
+    // ── SELF-HEALING ─────────────────────────────────
+    {
+        name: "self-healing-awareness",
+        description: "Consulta memórias de auto-correção antes de executar tarefas",
+        category: "implement",
+        phases: ["IMPLEMENT", "VALIDATE"],
+        instructions: "Antes de executar uma tarefa, consulte rag_context para verificar memórias de self-healing " +
+            "relacionadas ao contexto atual. Padrões de erro conhecidos e suas prevenções estão " +
+            "armazenados em workflow-graph/memories/healing-*.md. Se encontrar uma memória relevante, " +
+            "aplique a regra de prevenção ANTES de implementar. Isso evita repetição de erros " +
+            "já cometidos e corrigidos anteriormente.",
+    },
+];
+/**
+ * Get all built-in skills.
+ */
+export function getBuiltInSkills() {
+    return BUILT_IN_SKILLS;
+}
+/**
+ * Get built-in skills filtered by lifecycle phase.
+ */
+export function getSkillsByPhase(phase) {
+    return BUILT_IN_SKILLS.filter((s) => s.phases.includes(phase));
+}
+/**
+ * Get a built-in skill by name.
+ */
+export function getSkillByName(name) {
+    return BUILT_IN_SKILLS.find((s) => s.name === name);
+}
+//# sourceMappingURL=built-in-skills.js.map

package/dist/core/skills/built-in-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-skills.js","sourceRoot":"","sources":["../../../src/core/skills/built-in-skills.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,gDAAgD;IAChD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,wEAAwE;QACrF,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,YAAY,EACV,uEAAuE;YACvE,6EAA6E;YAC7E,6EAA6E;YAC7E,4DAA4D;KAC/D;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,kDAAkD;QAC/D,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,YAAY,EACV,sFAAsF;YACtF,mFAAmF;YACnF,6DAA6D;KAChE;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,YAAY,EACV,mFAAmF;YACnF,mFAAmF;YACnF,mEAAmE;KACtE;IAED,+CAA+C;IAC/C;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,0FAA0F;YAC1F,yFAAyF;YACzF,2EAA2E;KAC9E;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,sDAAsD;QACnE,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,qFAAqF;YACrF,oFAAoF;YACpF,6EAA6E;KAChF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,sCAAsC;QACnD,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,wEAAwE;YACxE,4FAA4F;YAC5F,uEAAuE;KAC1E;IAED,+CAA+C;IAC/C;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,+CAA+C;QAC5D,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,CAAC,MAAM,CAAC;QAChB,YAAY,EACV,wEAAwE;YACxE,2EAA2E;YAC3E,oFAAoF;KACvF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,CAAC,MAAM,CAAC;QAChB,YAAY,EACV,kFAAkF;YAClF,wEAAwE;YACxE,iFAAiF;KACpF;IAED,gDAAgD;IAChD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,0DAA0D;QACvE,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,CAAC,WAAW,CAAC;QACrB,YAAY,EACV,4FAA4F;YAC5F,wFAAwF;YACxF,yFAAyF;KAC5F;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,+DAA+D;QAC5E,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,CAAC,WAAW,CAAC;QACrB,YAAY,EACV,iFAAiF;YACjF,uEAAuE;YACvE,8FAA8F;KACjG;IAED,gDAAgD;IAChD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,YAAY,EACV,0FAA0F;YAC1F,iFAAiF;YACjF,+EAA+E;KAClF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,yDAAyD;QACtE,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,YAAY,EACV,oEAAoE;YACpE,yFAAyF;YACzF,uFAAuF;KAC1F;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,YAAY,EACV,qEAAqE;YACrE,iFAAiF;YACjF,oFAAoF;KACvF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,YAAY,EACV,+EAA+E;YAC/E,kFAAkF;YAClF,oFAAoF;KACvF;IAED,+CAA+C;IAC/C;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,uFAAuF;YACvF,uFAAuF;YACvF,yFAAyF;KAC5F;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,sCAAsC;QACnD,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,gGAAgG;YAChG,8EAA8E;YAC9E,0EAA0E;KAC7E;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,4FAA4F;YAC5F,qFAAqF;YACrF,gFAAgF;KACnF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,wFAAwF;YACxF,uFAAuF;YACvF,0EAA0E;KAC7E;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,2DAA2D;QACxE,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,YAAY,EACV,wFAAwF;YACxF,8EAA8E;YAC9E,0FAA0F;KAC7F;IAED,qDAAqD;IACrD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gEAAgE;QAC7E,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,2EAA2E;YAC3E,iGAAiG;YACjG,sFAAsF;YACtF,sEAAsE;KACzE;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wEAAwE;QACrF,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,mGAAmG;YACnG,8EAA8E;YAC9E,2FAA2F;KAC9F;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,wEAAwE;YACxE,0EAA0E;YAC1E,mFAAmF;YACnF,sDAAsD;KACzD;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,iEAAiE;YACjE,+FAA+F;YAC/F,qGAAqG;KACxG;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,wEAAwE;QACrF,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,iFAAiF;YACjF,8FAA8F;YAC9F,yFAAyF;KAC5F;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,kEAAkE;QAC/E,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,8FAA8F;YAC9F,sFAAsF;YACtF,kGAAkG;KACrG;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,mEAAmE;QAChF,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,8EAA8E;YAC9E,qEAAqE;YACrE,uEAAuE;KAC1E;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,2GAA2G;YAC3G,qFAAqF;YACrF,mGAAmG;KACtG;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,oEAAoE;QACjF,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,kGAAkG;YAClG,iGAAiG;YACjG,yFAAyF;KAC5F;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,uDAAuD;QACpE,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,mEAAmE;YACnE,gEAAgE;YAChE,mFAAmF;YACnF,0EAA0E;KAC7E;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,+EAA+E;YAC/E,sFAAsF;YACtF,gGAAgG;KACnG;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,mFAAmF;YACnF,oFAAoF;YACpF,0GAA0G;KAC7G;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,oEAAoE;QACjF,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,2FAA2F;YAC3F,yFAAyF;YACzF,iFAAiF;KACpF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,4FAA4F;YAC5F,gGAAgG;YAChG,0EAA0E;KAC7E;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;QACzC,YAAY,EACV,yFAAyF;YACzF,qFAAqF;YACrF,sFAAsF;KACzF;IAED,oDAAoD;IACpD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,kEAAkE;QAC/E,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,YAAY,EACV,kFAAkF;YAClF,+EAA+E;YAC/E,+EAA+E;YAC/E,mEAAmE;KACtE;IAED,oDAAoD;IACpD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;QACxC,YAAY,EACV,0EAA0E;YAC1E,kFAAkF;YAClF,0FAA0F;YAC1F,iFAAiF;KACpF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;QACxC,YAAY,EACV,+FAA+F;YAC/F,mFAAmF;YACnF,gFAAgF;YAChF,yDAAyD;KAC5D;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;QACxC,YAAY,EACV,+EAA+E;YAC/E,uFAAuF;YACvF,4FAA4F;YAC5F,yEAAyE;KAC5E;IAED,oDAAoD;IACpD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC/B,YAAY,EACV,mFAAmF;YACnF,2FAA2F;YAC3F,8EAA8E;YAC9E,qFAAqF;YACrF,uDAAuD;KAC1D;IAED,oDAAoD;IACpD;QACE,IAAI,EAAE,iCAAiC;QACvC,WAAW,EAAE,6CAA6C;QAC1D,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;QACjC,YAAY,EACV,yFAAyF;YACzF,wFAAwF;YACxF,0FAA0F;YAC1F,oFAAoF;YACpF,yFAAyF;KAC5F;IAED,oDAAoD;IACpD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,YAAY,EACV,kEAAkE;YAClE,kFAAkF;YAClF,+DAA+D;YAC/D,2DAA2D;YAC3D,kDAAkD;YAClD,0FAA0F;KAC7F;IAED,oDAAoD;IACpD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,8CAA8C;QAC3D,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,YAAY,EACV,+EAA+E;YAC/E,mFAAmF;YACnF,uFAAuF;YACvF,sEAAsE;YACtE,iFAAiF;KACpF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,YAAY,EACV,6EAA6E;YAC7E,yEAAyE;YACzE,0FAA0F;YAC1F,2FAA2F;YAC3F,6DAA6D;KAChE;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,kDAAkD;QAC/D,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,YAAY,EACV,+FAA+F;YAC/F,sEAAsE;YACtE,sFAAsF;YACtF,oFAAoF;YACpF,wCAAwC;KAC3C;IAED,oDAAoD;IACpD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;QACjC,YAAY,EACV,6FAA6F;YAC7F,qFAAqF;YACrF,2FAA2F;YAC3F,mFAAmF;YACnF,0CAA0C;KAC7C;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/skills/self-healing-listener.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Self-Healing Listener — creates auto-memories when errors are detected.
+ * Subscribes to "error:detected" events on the GraphEventBus.
+ * Deduplicates via error hash to prevent flood.
+ */
+import type { GraphEventBus } from "../events/event-bus.js";
+export interface SelfHealingOptions {
+    memoriesDir: string;
+    eventBus: GraphEventBus;
+}
+/** Categorize an error message into a healing category. */
+export declare function categorizeError(message: string): string;
+/** Generate a short hash for deduplication of error patterns. */
+export declare function generateErrorHash(category: string, message: string): string;
+/** Build the healing memory content. */
+export declare function buildHealingMemory(category: string, errorMessage: string, toolName: string): string;
+/**
+ * Register the self-healing listener on the event bus.
+ * Returns an unsubscribe function.
+ */
+export declare function registerSelfHealingListener(options: SelfHealingOptions): () => void;
+//# sourceMappingURL=self-healing-listener.d.ts.map

package/dist/core/skills/self-healing-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-healing-listener.d.ts","sourceRoot":"","sources":["../../../src/core/skills/self-healing-listener.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAa3E;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAiDnF"}

package/dist/core/skills/self-healing-listener.js

@@ -0,0 +1,102 @@
+/**
+ * Self-Healing Listener — creates auto-memories when errors are detected.
+ * Subscribes to "error:detected" events on the GraphEventBus.
+ * Deduplicates via error hash to prevent flood.
+ */
+import { createHash } from "node:crypto";
+import { writeFileSync, existsSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { logger } from "../utils/logger.js";
+/** Categorize an error message into a healing category. */
+export function categorizeError(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("type") && (lower.includes("error") || lower.includes("mismatch")))
+        return "type-error";
+    if (lower.includes("validation") || lower.includes("invalid") || lower.includes("zod"))
+        return "validation-error";
+    if (lower.includes("build") || lower.includes("compile") || lower.includes("tsc"))
+        return "build-error";
+    if (lower.includes("test") && (lower.includes("fail") || lower.includes("assert")))
+        return "test-failure";
+    if (lower.includes("sqlite") || lower.includes("database") || lower.includes("migration"))
+        return "database-error";
+    if (lower.includes("import") || lower.includes("module") || lower.includes("require"))
+        return "module-error";
+    return "general-error";
+}
+/** Generate a short hash for deduplication of error patterns. */
+export function generateErrorHash(category, message) {
+    // Normalize: strip dynamic parts like timestamps, line numbers, ids
+    const normalized = message
+        .replace(/\d{4}-\d{2}-\d{2}T[\d:.Z]+/g, "")
+        .replace(/\b[a-f0-9]{12,}\b/g, "")
+        .replace(/line \d+/gi, "line N")
+        .replace(/:\d+:\d+/g, ":N:N")
+        .trim();
+    return createHash("sha256")
+        .update(`${category}:${normalized}`)
+        .digest("hex")
+        .slice(0, 12);
+}
+/** Build the healing memory content. */
+export function buildHealingMemory(category, errorMessage, toolName) {
+    const timestamp = new Date().toISOString();
+    return [
+        `# Self-Healing: ${category}`,
+        "",
+        "## Error Pattern",
+        errorMessage,
+        "",
+        "## Prevention Rule",
+        `When encountering similar ${category} issues, check the tool '${toolName}' inputs and outputs carefully.`,
+        "Apply validation at boundaries and verify types match expected schemas before proceeding.",
+        "",
+        "## Context",
+        `- Tool: ${toolName}`,
+        `- Category: ${category}`,
+        `- Date: ${timestamp}`,
+    ].join("\n");
+}
+/**
+ * Register the self-healing listener on the event bus.
+ * Returns an unsubscribe function.
+ */
+export function registerSelfHealingListener(options) {
+    const { memoriesDir, eventBus } = options;
+    // Ensure memories directory exists
+    if (!existsSync(memoriesDir)) {
+        mkdirSync(memoriesDir, { recursive: true });
+    }
+    const handler = (event) => {
+        if (event.type !== "error:detected")
+            return;
+        const { toolName, errorMessage, errorCategory, errorHash } = event.payload;
+        const memoryName = `healing-${errorCategory}-${errorHash}`;
+        const memoryPath = path.join(memoriesDir, `${memoryName}.md`);
+        // Deduplication: skip if memory already exists
+        if (existsSync(memoryPath)) {
+            logger.debug("self-healing:skip-duplicate", { memoryName });
+            return;
+        }
+        // Create healing memory
+        const content = buildHealingMemory(errorCategory, errorMessage, toolName);
+        try {
+            writeFileSync(memoryPath, content, "utf-8");
+            logger.info("self-healing:memory-created", { memoryName, category: errorCategory });
+            // Emit healing event
+            eventBus.emitTyped("healing:memory_created", {
+                memoryName,
+                errorCategory,
+                errorHash,
+            });
+        }
+        catch (err) {
+            logger.error("self-healing:write-failed", { memoryName, error: String(err) });
+        }
+    };
+    eventBus.on("error:detected", handler);
+    return () => {
+        eventBus.off("error:detected", handler);
+    };
+}
+//# sourceMappingURL=self-healing-listener.js.map

package/dist/core/skills/self-healing-listener.js.map

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

package/dist/core/skills/skill-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Skill Store — persistence layer for skill preferences and custom skills.
+ * Uses SQLite tables created by migration v9.
+ */
+import type Database from "better-sqlite3";
+import type { CustomSkill, CustomSkillInput } from "../../schemas/skill.schema.js";
+export declare function setSkillEnabled(db: Database.Database, projectId: string, skillName: string, enabled: boolean): void;
+export declare function getSkillPreferences(db: Database.Database, projectId: string): Map<string, boolean>;
+export declare function createCustomSkill(db: Database.Database, projectId: string, data: CustomSkillInput): CustomSkill;
+export declare function updateCustomSkill(db: Database.Database, projectId: string, id: string, data: Partial<CustomSkillInput>): CustomSkill;
+export declare function deleteCustomSkill(db: Database.Database, projectId: string, id: string): void;
+export declare function getCustomSkills(db: Database.Database, projectId: string): CustomSkill[];
+export declare function getCustomSkillByName(db: Database.Database, projectId: string, name: string): CustomSkill | undefined;
+//# sourceMappingURL=skill-store.d.ts.map

package/dist/core/skills/skill-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-store.d.ts","sourceRoot":"","sources":["../../../src/core/skills/skill-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyCnF,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnH;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAUlG;AAID,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAgC/G;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC9B,WAAW,CAkCb;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAS5F;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAMvF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAMpH"}