@maestro-ai/mcp-server 5.4.5 → 5.5.1

package/dist/middleware/adr-generation.middleware.js

@@ -0,0 +1,214 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { parsearEstado } from "../state/storage.js";
+import { getFluxoComStitch } from "../flows/types.js";
+import { KnowledgeBase } from "../core/knowledge/KnowledgeBase.js";
+// v6.3 S3.1: Fases que disparam geração automática de ADR (expandido)
+const FASES_ARQUITETURAIS = new Set([
+    'Arquitetura',
+    'Arquitetura Avançada',
+    'Banco de Dados',
+    'Segurança',
+    'Contrato API',
+    'Requisitos',
+    'Modelo de Domínio',
+]);
+// Padrões regex para detectar decisões arquiteturais no texto
+const PADROES_DECISAO = [
+    /decidimos?\s+(?:usar?|utilizar?|adotar?)\s+([^.\n]+)/gi,
+    /escolhemos?\s+([^.\n]+?)(?:\s+por\s+[^.\n]+)?/gi,
+    /adotamos?\s+([^.\n]+)/gi,
+    /stack[:\s]+([^.\n]+)/gi,
+    /adr[-\s]?\d+[:\s]+([^.\n]+)/gi,
+    /usaremos?\s+([^.\n]+)/gi,
+    /optamos?\s+por\s+([^.\n]+)/gi,
+];
+export function withADRGeneration(handler) {
+    return async (args) => {
+        const result = await handler(args);
+        // Só gerar ADR se a operação foi bem-sucedida
+        if (result.isError)
+            return result;
+        const diretorio = args.diretorio;
+        if (!diretorio)
+            return result;
+        // Ler estado — preferir estado atualizado (pós-persistência)
+        const estadoJson = result.estado_atualizado || args.estado_json;
+        // Guard: garantir que é string válida antes de parsear
+        if (!estadoJson || typeof estadoJson !== 'string')
+            return result;
+        try {
+            const estado = parsearEstado(estadoJson);
+            if (!estado)
+                return result;
+            // Verificar se a fase anterior (que acabou de ser concluída) é arquitetural
+            // A fase_atual já avançou, então a fase concluída é a anterior
+            const faseConcluidaNum = estado.fase_atual - 1;
+            if (faseConcluidaNum < 1)
+                return result;
+            // v6.2: Usar getFluxoComStitch para obter nome correto da fase
+            // (estado.fases não existe — o estado usa nivel + fase_atual)
+            const nomeFaseConcluida = args.nomeFaseConcluida ||
+                inferirNomeFase(estado, faseConcluidaNum);
+            if (!nomeFaseConcluida || !FASES_ARQUITETURAIS.has(nomeFaseConcluida))
+                return result;
+            // Extrair entregável dos args (guard: deve ser string com conteúdo)
+            const entregavel = args.entregavel;
+            if (!entregavel || typeof entregavel !== 'string' || entregavel.length < 100)
+                return result;
+            // Extrair decisões do entregável
+            const decisoes = extrairDecisoes(entregavel, nomeFaseConcluida);
+            if (decisoes.length === 0)
+                return result;
+            // Salvar ADRs no diretório do projeto (arquivos .md)
+            await salvarADRs(diretorio, decisoes, nomeFaseConcluida);
+            // v6.3 S3.2: Persistir ADRs no KnowledgeBase para consulta futura
+            await persistirNoKnowledgeBase(diretorio, decisoes, faseConcluidaNum);
+            console.log(`[ADRGeneration] ${decisoes.length} ADR(s) gerados para fase: ${nomeFaseConcluida}`);
+            // Adicionar nota ao resultado sobre ADRs gerados
+            if (result.content?.[0]?.text) {
+                result.content[0].text +=
+                    `\n\n---\n\n📋 **${decisoes.length} ADR(s) gerado(s) automaticamente** em \`.maestro/adrs/\`\n` +
+                        decisoes.map(d => `- ${d.id}: ${d.titulo}`).join('\n') +
+                        `\n\n> 💡 Use \`contexto()\` para ver todas as decisões acumuladas do projeto.`;
+            }
+        }
+        catch (error) {
+            // ADR generation é best-effort — não bloqueia o fluxo
+            console.warn('[ADRGeneration] Falha ao gerar ADRs (non-blocking):', error);
+        }
+        return result;
+    };
+}
+/**
+ * v6.2: Infere o nome da fase usando getFluxoComStitch ao invés de estado.fases
+ * (que não existe no tipo EstadoProjeto)
+ */
+function inferirNomeFase(estado, faseNum) {
+    try {
+        const nivel = estado.nivel;
+        const usarStitch = estado.usar_stitch;
+        if (!nivel)
+            return '';
+        const fluxo = getFluxoComStitch(nivel, usarStitch ?? false);
+        const fase = fluxo.fases.find((f) => f.numero === faseNum);
+        return fase?.nome || '';
+    }
+    catch {
+        return '';
+    }
+}
+function extrairDecisoes(entregavel, nomeFase) {
+    const decisoes = [];
+    const vistas = new Set();
+    for (const padrao of PADROES_DECISAO) {
+        padrao.lastIndex = 0; // Reset regex state
+        let match;
+        while ((match = padrao.exec(entregavel)) !== null) {
+            const decisaoTexto = match[1]?.trim();
+            if (!decisaoTexto || decisaoTexto.length < 5)
+                continue;
+            // Evitar duplicatas
+            const chave = decisaoTexto.toLowerCase().slice(0, 50);
+            if (vistas.has(chave))
+                continue;
+            vistas.add(chave);
+            // Extrair contexto (linha anterior à decisão)
+            const posicao = match.index;
+            const textoAntes = entregavel.slice(Math.max(0, posicao - 200), posicao);
+            const linhasAntes = textoAntes.split('\n');
+            const contexto = linhasAntes[linhasAntes.length - 2]?.trim() || '';
+            const id = `ADR-${String(decisoes.length + 1).padStart(3, '0')}`;
+            decisoes.push({
+                id,
+                titulo: decisaoTexto.slice(0, 80),
+                fase: nomeFase,
+                decisao: decisaoTexto,
+                contexto,
+                timestamp: new Date().toISOString(),
+                status: 'aceito'
+            });
+            // Limitar a 10 ADRs por fase para evitar ruído
+            if (decisoes.length >= 10)
+                break;
+        }
+        if (decisoes.length >= 10)
+            break;
+    }
+    return decisoes;
+}
+/**
+ * v6.3 S3.2: Persiste ADRs no KnowledgeBase para consulta via contexto()
+ */
+async function persistirNoKnowledgeBase(diretorio, adrs, faseNum) {
+    try {
+        const kb = new KnowledgeBase(diretorio);
+        for (const adr of adrs) {
+            await kb.record({
+                id: adr.id,
+                type: 'adr',
+                content: {
+                    decision: adr.decisao,
+                    context: adr.contexto,
+                    alternatives: [],
+                    consequences: { positive: [], negative: [] },
+                },
+                metadata: {
+                    fase: faseNum,
+                    timestamp: adr.timestamp,
+                    tags: [adr.fase.toLowerCase().replace(/\s+/g, '-'), 'auto-generated'],
+                    relevance: 0.8,
+                },
+            });
+        }
+    }
+    catch (err) {
+        // KnowledgeBase é best-effort — não bloqueia o fluxo
+        console.warn('[ADRGeneration] Falha ao persistir no KnowledgeBase (non-blocking):', err);
+    }
+}
+async function salvarADRs(diretorio, adrs, nomeFase) {
+    const adrsDir = path.join(diretorio, '.maestro', 'adrs');
+    await fs.mkdir(adrsDir, { recursive: true });
+    for (const adr of adrs) {
+        const nomeArquivo = `${adr.id}-${nomeFase.toLowerCase().replace(/\s+/g, '-')}.md`;
+        const caminhoArquivo = path.join(adrsDir, nomeArquivo);
+        const conteudo = `# ${adr.id}: ${adr.titulo}
+
+**Status:** ${adr.status}  
+**Fase:** ${adr.fase}  
+**Data:** ${new Date(adr.timestamp).toLocaleDateString('pt-BR')}
+
+## Contexto
+
+${adr.contexto || 'Extraído automaticamente do entregável da fase.'}
+
+## Decisão
+
+${adr.decisao}
+
+## Consequências
+
+> ⚠️ Este ADR foi gerado automaticamente. Revise e complemente com consequências e alternativas consideradas.
+
+---
+*Gerado automaticamente pelo MCP Maestro v6.1 — withADRGeneration*
+`;
+        await fs.writeFile(caminhoArquivo, conteudo, 'utf-8');
+    }
+    // Atualizar índice de ADRs
+    const indiceArquivo = path.join(adrsDir, 'INDEX.md');
+    let indice = '# Índice de ADRs\n\n';
+    try {
+        indice = await fs.readFile(indiceArquivo, 'utf-8');
+    }
+    catch { /* arquivo não existe ainda */ }
+    for (const adr of adrs) {
+        const linha = `- [${adr.id}](${adr.id}-${nomeFase.toLowerCase().replace(/\s+/g, '-')}.md): ${adr.titulo}\n`;
+        if (!indice.includes(adr.id)) {
+            indice += linha;
+        }
+    }
+    await fs.writeFile(indiceArquivo, indice, 'utf-8');
+}
+//# sourceMappingURL=adr-generation.middleware.js.map

package/dist/middleware/adr-generation.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-generation.middleware.js","sourceRoot":"","sources":["../../src/middleware/adr-generation.middleware.ts"],"names":[],"mappings":"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"}

package/dist/middleware/flow-engine.middleware.d.ts

@@ -1,11 +1,13 @@
 /**
  * Middleware: withFlowEngine
  *
+ * v6.0 Sprint 4: FlowEngine FORÇADO (não sugestivo)
+ *
  * Após execução da tool, calcula next_action via flow engine
- * de forma consistente, substituindo lógica local duplicada nas tools.
+ * e SEMPRE sobrescreve, mesmo se a tool definiu um valor diferente.
  *
- * Se a tool já retornou next_action, o middleware NÃO sobrescreve
- * (permite que tools específicas tenham controle granular).
+ * Isso garante que o fluxo seja controlado centralmente pelo FlowEngine,
+ * impedindo que tools individuais desviem do caminho correto.
  */
 import type { ToolResult } from "../types/index.js";
 type ToolHandler = (args: Record<string, unknown>) => Promise<ToolResult>;

package/dist/middleware/flow-engine.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-engine.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/flow-engine.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1E,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CA4ChE"}
+{"version":3,"file":"flow-engine.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/flow-engine.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1E,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAsDhE"}

package/dist/middleware/flow-engine.middleware.js

@@ -1,11 +1,13 @@
 /**
  * Middleware: withFlowEngine
  *
+ * v6.0 Sprint 4: FlowEngine FORÇADO (não sugestivo)
+ *
  * Após execução da tool, calcula next_action via flow engine
- * de forma consistente, substituindo lógica local duplicada nas tools.
+ * e SEMPRE sobrescreve, mesmo se a tool definiu um valor diferente.
  *
- * Se a tool já retornou next_action, o middleware NÃO sobrescreve
- * (permite que tools específicas tenham controle granular).
+ * Isso garante que o fluxo seja controlado centralmente pelo FlowEngine,
+ * impedindo que tools individuais desviem do caminho correto.
  */
 import { parsearEstado } from "../state/storage.js";
 import { getNextStep, getFlowProgress, flowStepToNextAction } from "../services/flow-engine.js";
@@ -29,13 +31,19 @@ export function withFlowEngine(handler) {
             const estado = parsearEstado(estadoJson);
             if (!estado)
                 return result;
-            // Calcular next_action via flow engine (se a tool não definiu um)
-            if (!result.next_action) {
-                const nextStep = getNextStep(estado, diretorio);
-                result.next_action = flowStepToNextAction(nextStep);
-                if (nextStep.specialist) {
-                    result.specialist_persona = result.specialist_persona || nextStep.specialist;
-                }
+            // v6.0: SEMPRE calcular e sobrescrever next_action (forçado)
+            const nextStep = getNextStep(estado, diretorio);
+            const commandedAction = flowStepToNextAction(nextStep);
+            // Logar se a tool tentou definir um next_action diferente
+            if (result.next_action && result.next_action.tool !== commandedAction.tool) {
+                console.warn(`[FlowEngine] Override detected: ` +
+                    `tool wanted "${result.next_action.tool}", ` +
+                    `flow commands "${commandedAction.tool}"`);
+            }
+            // SEMPRE sobrescrever (não é mais condicional)
+            result.next_action = commandedAction;
+            if (nextStep.specialist) {
+                result.specialist_persona = result.specialist_persona || nextStep.specialist;
             }
             // Sempre atualizar progress (é barato e útil)
             if (!result.progress) {

package/dist/middleware/flow-engine.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow-engine.middleware.js","sourceRoot":"","sources":["../../src/middleware/flow-engine.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAKhG,MAAM,UAAU,cAAc,CAAC,OAAoB;IAC/C,OAAO,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnC,wCAAwC;QACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAA+B,CAAC;QACvD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,6DAA6D;QAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,IAAK,IAAI,CAAC,WAAkC,CAAC;QACxF,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM;gBAAE,OAAO,MAAM,CAAC;YAE3B,kEAAkE;YAClE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBACtB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAChD,MAAM,CAAC,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;gBAEpD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;oBACtB,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,QAAQ,CAAC,UAAU,CAAC;gBACjF,CAAC;YACL,CAAC;YAED,8CAA8C;YAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACnB,MAAM,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"flow-engine.middleware.js","sourceRoot":"","sources":["../../src/middleware/flow-engine.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAKhG,MAAM,UAAU,cAAc,CAAC,OAAoB;IAC/C,OAAO,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnC,wCAAwC;QACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAA+B,CAAC;QACvD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,6DAA6D;QAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,IAAK,IAAI,CAAC,WAAkC,CAAC;QACxF,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM;gBAAE,OAAO,MAAM,CAAC;YAE3B,6DAA6D;YAC7D,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAChD,MAAM,eAAe,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAEvD,0DAA0D;YAC1D,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC;gBACzE,OAAO,CAAC,IAAI,CACR,kCAAkC;oBAClC,gBAAgB,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK;oBAC5C,kBAAkB,eAAe,CAAC,IAAI,GAAG,CAC5C,CAAC;YACN,CAAC;YAED,+CAA+C;YAC/C,MAAM,CAAC,WAAW,GAAG,eAAe,CAAC;YAErC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,QAAQ,CAAC,UAAU,CAAC;YACjF,CAAC;YAED,8CAA8C;YAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACnB,MAAM,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC"}

package/dist/middleware/index.d.ts

@@ -1,14 +1,18 @@
 /**
- * Middleware Pipeline do Maestro v5
+ * Middleware Pipeline do Maestro v6
  *
- * Composição de middlewares para tools:
- * withErrorHandling → withStateLoad → withFlowEngine → withPersistence → withSkillInjection
+ * v6.0: Pipeline Unificada — TODAS as tools usam applyOrchestrationPipeline
+ * Ordem fixa: Error → State → Flow → Persistence → Skill
+ *
+ * DEPRECATED: applyMiddlewares, applySmartMiddlewares, applyLightMiddlewares, applyPersistenceMiddlewares
+ * Serão removidos na v7.0
  */
+export { applyOrchestrationPipeline, applyLightOrchestrationPipeline } from "./orchestration-pipeline.middleware.js";
 export { withStateLoad } from "./state-loader.middleware.js";
 export { withPersistence } from "./persistence.middleware.js";
 export { withFlowEngine } from "./flow-engine.middleware.js";
 export { withSkillInjection } from "./skill-injection.middleware.js";
-export { withPromptValidation, defaultValidations } from "./validation.middleware.js";
+export { withPromptValidation, withCompulsoryStateGuard, defaultValidations } from "./validation.middleware.js";
 import type { ToolResult } from "../types/index.js";
 type ToolHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
 /**
@@ -23,21 +27,24 @@ type ToolHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
  *
  * O handler original executa no centro do pipeline.
  */
+/**
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
+ */
 export declare function applyMiddlewares(toolName: string, handler: ToolHandler): ToolHandler;
 /**
- * Aplica apenas middlewares leves (sem skill injection e sem persistence).
- * Útil para tools que já fazem injeção ativa internamente (proximo, maestro).
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
  */
 export declare function applyLightMiddlewares(toolName: string, handler: ToolHandler): ToolHandler;
 /**
- * Aplica middlewares inteligentes: estado + skill injection condicional.
- * v5.1: Injeta skill apenas quando o projeto está em fase de desenvolvimento (não onboarding).
- * Substitui applyLightMiddlewares para tools que se beneficiam de skill injection.
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
  */
 export declare function applySmartMiddlewares(toolName: string, handler: ToolHandler): ToolHandler;
 /**
- * Aplica middlewares de persistência e estado (sem skill injection).
- * Útil para tools que não precisam de injeção de skills mas precisam de persistência.
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
  */
 export declare function applyPersistenceMiddlewares(toolName: string, handler: ToolHandler): ToolHandler;
 //# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAOtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAWpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAKzF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAOzF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAO/F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,MAAM,wCAAwC,CAAC;AAGrH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAOhH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAYpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAMzF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAQzF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAQ/F"}

package/dist/middleware/index.js

@@ -1,14 +1,20 @@
 /**
- * Middleware Pipeline do Maestro v5
+ * Middleware Pipeline do Maestro v6
  *
- * Composição de middlewares para tools:
- * withErrorHandling → withStateLoad → withFlowEngine → withPersistence → withSkillInjection
+ * v6.0: Pipeline Unificada — TODAS as tools usam applyOrchestrationPipeline
+ * Ordem fixa: Error → State → Flow → Persistence → Skill
+ *
+ * DEPRECATED: applyMiddlewares, applySmartMiddlewares, applyLightMiddlewares, applyPersistenceMiddlewares
+ * Serão removidos na v7.0
  */
+// v6.0: Pipeline Unificada (RECOMENDADO)
+export { applyOrchestrationPipeline, applyLightOrchestrationPipeline } from "./orchestration-pipeline.middleware.js";
+// Middlewares individuais (para uso avançado)
 export { withStateLoad } from "./state-loader.middleware.js";
 export { withPersistence } from "./persistence.middleware.js";
 export { withFlowEngine } from "./flow-engine.middleware.js";
 export { withSkillInjection } from "./skill-injection.middleware.js";
-export { withPromptValidation, defaultValidations } from "./validation.middleware.js"; // v6.0
+export { withPromptValidation, withCompulsoryStateGuard, defaultValidations } from "./validation.middleware.js";
 import { withStateLoad } from "./state-loader.middleware.js";
 import { withPersistence } from "./persistence.middleware.js";
 import { withFlowEngine } from "./flow-engine.middleware.js";
@@ -26,29 +32,36 @@ import { withErrorHandling } from "../errors/index.js";
  *
  * O handler original executa no centro do pipeline.
  */
+/**
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
+ */
 export function applyMiddlewares(toolName, handler) {
+    console.warn(`[Middleware] DEPRECATED: applyMiddlewares used for ${toolName}. Use applyOrchestrationPipeline.`);
     return withErrorHandling(toolName, withStateLoad(withFlowEngine(withPersistence(withSkillInjection(handler)))));
 }
 /**
- * Aplica apenas middlewares leves (sem skill injection e sem persistence).
- * Útil para tools que já fazem injeção ativa internamente (proximo, maestro).
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
  */
 export function applyLightMiddlewares(toolName, handler) {
+    console.warn(`[Middleware] DEPRECATED: applyLightMiddlewares used for ${toolName}. Use applyOrchestrationPipeline.`);
     return withErrorHandling(toolName, withStateLoad(handler));
 }
 /**
- * Aplica middlewares inteligentes: estado + skill injection condicional.
- * v5.1: Injeta skill apenas quando o projeto está em fase de desenvolvimento (não onboarding).
- * Substitui applyLightMiddlewares para tools que se beneficiam de skill injection.
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
  */
 export function applySmartMiddlewares(toolName, handler) {
+    console.warn(`[Middleware] DEPRECATED: applySmartMiddlewares used for ${toolName}. Use applyOrchestrationPipeline.`);
     return withErrorHandling(toolName, withStateLoad(withSkillInjection(handler)));
 }
 /**
- * Aplica middlewares de persistência e estado (sem skill injection).
- * Útil para tools que não precisam de injeção de skills mas precisam de persistência.
+ * @deprecated v6.0 — Use applyOrchestrationPipeline instead
+ * Será removido na v7.0
  */
 export function applyPersistenceMiddlewares(toolName, handler) {
+    console.warn(`[Middleware] DEPRECATED: applyPersistenceMiddlewares used for ${toolName}. Use applyOrchestrationPipeline.`);
     return withErrorHandling(toolName, withStateLoad(withPersistence(handler)));
 }
 //# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC,CAAC,OAAO;AAE9F,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAKvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAAoB;IACnE,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CACT,cAAc,CACV,eAAe,CACX,kBAAkB,CAAC,OAAO,CAAC,CAC9B,CACJ,CACJ,CACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAAoB;IACxE,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CAAC,OAAO,CAAC,CACzB,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAAoB;IACxE,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CACT,kBAAkB,CAAC,OAAO,CAAC,CAC9B,CACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAgB,EAAE,OAAoB;IAC9E,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CACT,eAAe,CAAC,OAAO,CAAC,CAC3B,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yCAAyC;AACzC,OAAO,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,MAAM,wCAAwC,CAAC;AAErH,8CAA8C;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAKvD;;;;;;;;;;;GAWG;AACH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAAoB;IACnE,OAAO,CAAC,IAAI,CAAC,sDAAsD,QAAQ,mCAAmC,CAAC,CAAC;IAChH,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CACT,cAAc,CACV,eAAe,CACX,kBAAkB,CAAC,OAAO,CAAC,CAC9B,CACJ,CACJ,CACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAAoB;IACxE,OAAO,CAAC,IAAI,CAAC,2DAA2D,QAAQ,mCAAmC,CAAC,CAAC;IACrH,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CAAC,OAAO,CAAC,CACzB,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAAoB;IACxE,OAAO,CAAC,IAAI,CAAC,2DAA2D,QAAQ,mCAAmC,CAAC,CAAC;IACrH,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CACT,kBAAkB,CAAC,OAAO,CAAC,CAC9B,CACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAgB,EAAE,OAAoB;IAC9E,OAAO,CAAC,IAAI,CAAC,iEAAiE,QAAQ,mCAAmC,CAAC,CAAC;IAC3H,OAAO,iBAAiB,CACpB,QAAQ,EACR,aAAa,CACT,eAAe,CAAC,OAAO,CAAC,CAC3B,CACJ,CAAC;AACN,CAAC"}

package/dist/middleware/orchestration-pipeline.middleware.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pipeline Unificada de Orquestração v6.3
+ *
+ * Ordem fixa de execução:
+ * 1. Error Handling     — captura erros e formata resposta
+ * 2. State Load         — auto-carrega estado se não fornecido
+ * 3. [Handler executa]  — tool original
+ * 4. Persistence        — salva estado ANTES do FlowEngine
+ * 5. ADR Generation     — extrai decisões de fases arquiteturais (best-effort)
+ * 6. Flow Engine        — calcula next_action com estado já persistido (FORÇADO)
+ * 7. Skill Inject       — injeta contexto do especialista (OBRIGATÓRIA)
+ * 8. Prompt Validation  — valida uso correto das tools na resposta
+ *
+ * @since v6.0 — Sprint 1 do Roadmap de Orquestração
+ * @since v6.1 — Correção 3: Persistence antes de FlowEngine + Sprint 6: ADR Generation
+ * @since v6.2 — Sprint 2: withPromptValidation integrado
+ * @since v6.3 — S1.1: Corrigido withPromptValidation (era no-op — expectedTool não era passado)
+ */
+import type { ToolResult } from "../types/index.js";
+type ToolHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
+/**
+ * Aplica pipeline completo e unificado de middlewares a um handler de tool.
+ *
+ * Esta é a ÚNICA função que deve ser usada para wrappear tools públicas.
+ * Garante que todos os middlewares críticos sejam aplicados em ordem consistente.
+ *
+ * @param toolName - Nome da tool (para logs e error handling)
+ * @param handler - Handler original da tool
+ * @returns Handler wrapped com todos os middlewares
+ */
+export declare function applyOrchestrationPipeline(toolName: string, handler: ToolHandler): ToolHandler;
+/**
+ * Variante leve da pipeline (DEPRECATED — usar applyOrchestrationPipeline)
+ *
+ * Mantida apenas para compatibilidade temporária com código legado.
+ * Será removida na v7.0.
+ *
+ * @deprecated Use applyOrchestrationPipeline instead
+ */
+export declare function applyLightOrchestrationPipeline(toolName: string, handler: ToolHandler): ToolHandler;
+export {};
+//# sourceMappingURL=orchestration-pipeline.middleware.d.ts.map

package/dist/middleware/orchestration-pipeline.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-pipeline.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/orchestration-pipeline.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1E;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACrB,WAAW,CAsBb;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACrB,WAAW,CAQb"}

package/dist/middleware/orchestration-pipeline.middleware.js

@@ -0,0 +1,57 @@
+/**
+ * Pipeline Unificada de Orquestração v6.3
+ *
+ * Ordem fixa de execução:
+ * 1. Error Handling     — captura erros e formata resposta
+ * 2. State Load         — auto-carrega estado se não fornecido
+ * 3. [Handler executa]  — tool original
+ * 4. Persistence        — salva estado ANTES do FlowEngine
+ * 5. ADR Generation     — extrai decisões de fases arquiteturais (best-effort)
+ * 6. Flow Engine        — calcula next_action com estado já persistido (FORÇADO)
+ * 7. Skill Inject       — injeta contexto do especialista (OBRIGATÓRIA)
+ * 8. Prompt Validation  — valida uso correto das tools na resposta
+ *
+ * @since v6.0 — Sprint 1 do Roadmap de Orquestração
+ * @since v6.1 — Correção 3: Persistence antes de FlowEngine + Sprint 6: ADR Generation
+ * @since v6.2 — Sprint 2: withPromptValidation integrado
+ * @since v6.3 — S1.1: Corrigido withPromptValidation (era no-op — expectedTool não era passado)
+ */
+import { withErrorHandling } from "../errors/index.js";
+import { withStateLoad } from "./state-loader.middleware.js";
+import { withFlowEngine } from "./flow-engine.middleware.js";
+import { withSkillInjection } from "./skill-injection.middleware.js";
+import { withPersistence } from "./persistence.middleware.js";
+import { withADRGeneration } from "./adr-generation.middleware.js";
+import { withPromptValidation, withCompulsoryStateGuard } from "./validation.middleware.js";
+/**
+ * Aplica pipeline completo e unificado de middlewares a um handler de tool.
+ *
+ * Esta é a ÚNICA função que deve ser usada para wrappear tools públicas.
+ * Garante que todos os middlewares críticos sejam aplicados em ordem consistente.
+ *
+ * @param toolName - Nome da tool (para logs e error handling)
+ * @param handler - Handler original da tool
+ * @returns Handler wrapped com todos os middlewares
+ */
+export function applyOrchestrationPipeline(toolName, handler) {
+    console.log(`[OrchestrationPipeline] Registering tool: ${toolName}`);
+    // V6 Sprint 2: withCompulsoryStateGuard é o PRIMEIRO middleware da cadeia.
+    // Bloqueia tools não-permitidas quando `em_estado_compulsorio = true`,
+    // antes de qualquer outra lógica ser executada.
+    return withCompulsoryStateGuard(toolName)(withErrorHandling(toolName, withStateLoad(withPersistence(withADRGeneration(withFlowEngine(withSkillInjection(withPromptValidation(toolName, toolName)(handler))))))));
+}
+/**
+ * Variante leve da pipeline (DEPRECATED — usar applyOrchestrationPipeline)
+ *
+ * Mantida apenas para compatibilidade temporária com código legado.
+ * Será removida na v7.0.
+ *
+ * @deprecated Use applyOrchestrationPipeline instead
+ */
+export function applyLightOrchestrationPipeline(toolName, handler) {
+    console.warn(`[OrchestrationPipeline] DEPRECATED: applyLightOrchestrationPipeline used for ${toolName}. ` +
+        `Use applyOrchestrationPipeline instead.`);
+    // Mesmo comportamento — não há mais "light" vs "full"
+    return applyOrchestrationPipeline(toolName, handler);
+}
+//# sourceMappingURL=orchestration-pipeline.middleware.js.map

package/dist/middleware/orchestration-pipeline.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-pipeline.middleware.js","sourceRoot":"","sources":["../../src/middleware/orchestration-pipeline.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAK5F;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACtC,QAAgB,EAChB,OAAoB;IAEpB,OAAO,CAAC,GAAG,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;IAErE,2EAA2E;IAC3E,uEAAuE;IACvE,gDAAgD;IAChD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,CACrC,iBAAiB,CACb,QAAQ,EACR,aAAa,CACT,eAAe,CACX,iBAAiB,CACb,cAAc,CACV,kBAAkB,CACd,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CACpD,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAC3C,QAAgB,EAChB,OAAoB;IAEpB,OAAO,CAAC,IAAI,CACR,gFAAgF,QAAQ,IAAI;QAC5F,yCAAyC,CAC5C,CAAC;IAEF,sDAAsD;IACtD,OAAO,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/middleware/skill-injection.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-injection.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/skill-injection.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAuDpE"}
+{"version":3,"file":"skill-injection.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/skill-injection.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAqDpE"}

package/dist/middleware/skill-injection.middleware.js

@@ -9,10 +9,9 @@
  * injeção diretamente.
  */
 import { parsearEstado } from "../state/storage.js";
-import { ContentResolverService } from "../services/content-resolver.service.js";
-import { SkillLoaderService } from "../services/skill-loader.service.js";
 import { getSkillParaFase } from "../utils/prompt-mapper.js";
 import { getFaseComStitch } from "../flows/types.js";
+import { formatSkillHydrationCommand, detectIDE } from "../utils/ide-paths.js";
 export function withSkillInjection(handler) {
     return async (args) => {
         const result = await handler(args);
@@ -44,13 +43,11 @@ export function withSkillInjection(handler) {
                 if (!actionsThatNeedSkill.includes(result.next_action.tool)) {
                     return result;
                 }
-                const mode = (estado.config?.mode || "balanced");
-                const contentResolver = new ContentResolverService(diretorio);
-                const skillLoader = new SkillLoaderService(contentResolver);
-                const contextPkg = await skillLoader.loadForPhase(faseInfo.nome, "economy");
-                if (contextPkg && result.content?.[0]) {
-                    // Append contexto resumido à resposta
-                    result.content[0].text += `\n\n---\n\n## 🧠 Contexto do Especialista (${faseInfo.nome})\n\n${skillLoader.formatAsMarkdown(contextPkg)}`;
+                // v7.0: Substituído injeção ativa por menção dinâmica da IDE
+                const ide = estado.ide || detectIDE(diretorio) || 'windsurf';
+                const hydrationCommand = formatSkillHydrationCommand(skillName, ide);
+                if (result.content?.[0]) {
+                    result.content[0].text += `\n\n---\n\n## 🧠 Contexto do Especialista (${faseInfo.nome})\n\n${hydrationCommand}`;
                 }
             }
             catch (error) {

package/dist/middleware/skill-injection.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-injection.middleware.js","sourceRoot":"","sources":["../../src/middleware/skill-injection.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKrD,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACnD,OAAO,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnC,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,SAA+B,CAAC;QACvD,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,kFAAkF;QAClF,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;YACvD,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,mEAAmE;QACnE,oDAAoD;QACpD,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACjD,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBACvD,IAAI,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC;gBAE3B,MAAM,QAAQ,GAAG,gBAAgB,CAC7B,MAAM,CAAC,KAAY,EACnB,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,WAAW,CACrB,CAAC;gBACF,IAAI,CAAC,QAAQ;oBAAE,OAAO,MAAM,CAAC;gBAE7B,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,SAAS;oBAAE,OAAO,MAAM,CAAC;gBAE9B,+EAA+E;gBAC/E,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;gBAC/E,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1D,OAAO,MAAM,CAAC;gBAClB,CAAC;gBAED,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,UAAU,CAAuC,CAAC;gBACvF,MAAM,eAAe,GAAG,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;gBAC9D,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;gBAC5D,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAE5E,IAAI,UAAU,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpC,sCAAsC;oBACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,8CAA8C,QAAQ,CAAC,IAAI,QAAQ,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5I,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAC;YACxE,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"skill-injection.middleware.js","sourceRoot":"","sources":["../../src/middleware/skill-injection.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAK/E,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACnD,OAAO,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnC,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,SAA+B,CAAC;QACvD,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,kFAAkF;QAClF,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;YACvD,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,mEAAmE;QACnE,oDAAoD;QACpD,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACjD,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBACvD,IAAI,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC;gBAE3B,MAAM,QAAQ,GAAG,gBAAgB,CAC7B,MAAM,CAAC,KAAY,EACnB,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,WAAW,CACrB,CAAC;gBACF,IAAI,CAAC,QAAQ;oBAAE,OAAO,MAAM,CAAC;gBAE7B,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,SAAS;oBAAE,OAAO,MAAM,CAAC;gBAE9B,+EAA+E;gBAC/E,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;gBAC/E,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1D,OAAO,MAAM,CAAC;gBAClB,CAAC;gBAED,6DAA6D;gBAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC;gBAC7D,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBAErE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,8CAA8C,QAAQ,CAAC,IAAI,QAAQ,gBAAgB,EAAE,CAAC;gBACpH,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAC;YACxE,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC"}

package/dist/middleware/validation.middleware.d.ts

@@ -27,5 +27,16 @@ export declare function validateTools(toolMappings: Record<string, string>): Rec
  * Configuração padrão de validações
  */
 export declare const defaultValidations: Record<string, (handler: ToolHandler) => ToolHandler>;
+/**
+ * V6 Sprint 2: Middleware de Estado Compulsório
+ *
+ * Intercepta chamadas de tools ANTES de executar o handler.
+ * Quando `em_estado_compulsorio = true`, bloqueia qualquer tool
+ * que não esteja na whitelist (`tools_permitidas_no_compulsorio`).
+ *
+ * Objetivo: Impedir que a IA "divague" chamando `maestro()`, `analisar()` etc
+ * enquanto deveria estar corrigindo o entregável reprovado no Gate.
+ */
+export declare function withCompulsoryStateGuard(toolName: string): (handler: ToolHandler) => ToolHandler;
 export {};
 //# sourceMappingURL=validation.middleware.d.ts.map