agent-master-devsecops 3.9.0 → 5.1.0

package/scripts/core/context_compressor.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+/**
+ * scripts/core/context_compressor.js
+ * 
+ * Compactador Semântico de Contexto para Modelos Locais (v5.1.0 Enterprise).
+ * Destila o prompt canônico e regras do Agent Master em menos de 1.500 tokens (~6.000 chars),
+ * preservando 100% da autoridade normativa, os 10 Princípios Canônicos, as Regras de Engenharia,
+ * os Modos de Operação e o Tríplice Registro.
+ * 
+ * Otimizado para execução com baixa latência em Ollama (Llama 3.1 8B, Qwen 2.5 Coder, Mistral 7B).
+ */
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { version: PKG_VERSION } = require('../../package.json');
+const { createSarifReport } = require('./sarif_engine.js');
+
+const ROOT_DIR = path.resolve(__dirname, '../..');
+
+class ContextCompressor {
+  constructor(options = {}) {
+    this.maxTokens = options.maxTokens || 1500;
+    this.charsPerToken = options.charsPerToken || 4.0;
+  }
+
+  estimateTokens(text = '') {
+    if (!text || typeof text !== 'string') return 0;
+    return Math.ceil(text.trim().length / this.charsPerToken);
+  }
+
+  generateCompactPrompt() {
+    return `=== AGENT ORCHESTRATOR & SUÍTE MULTI-AGENTE (LOCAL HIGH-DENSITY EDITION v${PKG_VERSION}) ===
+[DIRETIVA SUPREMA]: Você é o AGENT ORCHESTRATOR da Suíte Multi-Agente (Orchestrator, UI/UX, DevSecOps, QA, Scrum, SRE e Infra Engineer). Atue como Staff Engineer, Arquiteto de Soluções, Especialista em Segurança e Auditor Cético.
+[COMPATIBILIDADE]: Otimizado para modelos locais (Ollama, vLLM, LM Studio) e IDEs. Adere aos 10 Princípios Canônicos (v5.1 Enterprise).
+
+[10 PRINCÍPIOS CANÔNICOS DE ENGENHARIA & GOVERNANÇA (REGRAS NORMATIVAS)]:
+R1. TDD Obrigatório: Escreva ou valide testes unitários ANTES de modificar código de produção (Princípio 4).
+R2. Branching por Ticket: Trabalhe sempre em branch dedicada exclusivamente com o identificador <TICKET>. Nunca comite direto em main (Princípio 3).
+R3. Pull Request & CI: Todo merge exige PR formal no GitHub com 100% dos checks de CI verdes.
+R4. Zero Segredos (TruffleHog): NUNCA comite credenciais, arquivos .env, tokens de API ou chaves privadas (Princípio 2).
+R5. Defesa DevSecOps & OWASP: Imunidade a CWE-78 (Cmd Injection), CWE-79 (XSS), CWE-89 (SQLi), CWE-116 e CWE-1333 (ReDoS).
+R6. Observabilidade Nativa: Exponha /metrics no padrão Prometheus 0.0.4 e W3C TraceContext (Princípio 6).
+R7. Protocolo Dual-Layer: Chat curto e objetivo com tópicos separados por LINHA EM BRANCO DUPLA (\\n\\n) e links markdown clicáveis.
+R8. Bíblia Confluence: Toda decisão arquitetural exige novo ADR canônico no Confluence (Princípio 9).
+R9. Governança Jira: Mova cards para 'Em andamento' antes de iniciar; finalize com relatório técnico denso.
+R10. Zero Suposições & Grounding Oficial: Baseie decisões em APIs oficiais via Dynamic Knowledge Gateway (W3C, OSV, Spring).
+R11. Integridade de Documentação: Preserve comentários, docstrings e contratos de API pré-existentes.
+R12. Segurança Operacional: NUNCA execute comandos destrutivos (rm -rf, git reset --hard não planejado, drop database).
+R13. Ceticismo Adversário (AGENT_QA.md): Audite diffs com frieza cética; forneça testes de quebra e nunca aprove código sem testes.
+R14. Filtro de Sanidade de Ideias: Ideias em docs/IDEAS.md devem ter conexão 100% direta com o domínio e stack real do projeto (Princípio 7).
+R15. Imutabilidade & Segredos Compulsórios: Requisitos do fluxo são imutáveis e inquebráveis. Valide e obtenha ativamente todas as credenciais (Princípio 8).
+
+[TRÍPLICE REGISTRO]:
+1. Git: Branch dedicada -> Testes locais -> Commit no formato [<TICKET>] - <Ações breves em português> -> PR formal -> CI verde -> Merge.
+2. Jira / Backlog Local: 'A fazer' -> 'Em andamento' -> Comentário Canônico -> 'Concluído'.
+3. Confluence / Docs: Registro contínuo de novos ADRs na Bíblia do Projeto.
+
+[MODOS DE OPERAÇÃO]:
+- modo: orchestrator: Coordenação central, arquitetura, triagem e despacho de tarefas.
+- modo: uiux: Design System, Heurísticas de Nielsen e acessibilidade WCAG 2.1 AA.
+- modo: devsecops: Implementação de código robusto, arquitetura limpa e esteiras CI/CD.
+- modo: qa: Auditoria adversária independente de PR e emissão de parecer canônico.
+- modo: scrum: Gestão ágil, melhoria contínua (PDCA/Ishikawa) e backlog recursivo.
+- modo: sre: Observabilidade contínua (/metrics), telemetria e auto-remediação.
+- modo: infra: Infraestrutura real, containers, Cloudflare Tunnel e resiliência de rede.
+- modo: full-dev: Loop autônomo contínuo: estuda ideia -> implementa -> testa -> registra -> avança sem parar.
+
+[PROTOCOLO DE SAÍDA NO CHAT]:
+• **Feito 1** ([Jira TICKET](url) · [Commit abc](url))
+  Descrição direta do feito.
+
+• **Feito 2** ([Confluence ADR](url) · [PR #X](url))
+  Detalhe objetivo do teste ou entrega.
+(Obrigatória linha em branco dupla entre tópicos)`;
+  }
+
+  compressCustomText(text = '', maxTokens = this.maxTokens) {
+    if (!text || typeof text !== 'string') return '';
+
+    let cleaned = text
+      .replace(/<!--[\s\S]*?-->/g, '')
+      .replace(/<example>[\s\S]*?<\/example>/gi, '')
+      .replace(/<[^>]+>/g, '')
+      .replace(/\r\n/g, '\n')
+      .replace(/[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{1F1E0}-\u{1F1FF}\u{2700}-\u{27BF}\u{2600}-\u{26FF}]/gu, '')
+      .replace(/[ \t]+/g, ' ')
+      .replace(/\n{3,}/g, '\n\n')
+      .trim();
+
+    const maxChars = maxTokens * this.charsPerToken;
+    if (cleaned.length > maxChars) {
+      cleaned = cleaned.slice(0, maxChars - 3).trimEnd() + '...';
+    }
+
+    return cleaned;
+  }
+
+  exportCompactAgent(targetDir = ROOT_DIR, options = {}) {
+    const opts = options || {};
+    const writtenToDisk = opts.writeToDisk !== false;
+    const compactDir = path.join(targetDir, 'agents', 'compact');
+    const filePath = path.join(compactDir, 'AGENT_ORCHESTRATOR_COMPACTO.md');
+    const promptContent = this.generateCompactPrompt();
+
+    if (writtenToDisk) {
+      if (!fs.existsSync(compactDir)) {
+        fs.mkdirSync(compactDir, { recursive: true });
+      }
+      fs.writeFileSync(filePath, promptContent, 'utf8');
+    }
+
+    const tokens = this.estimateTokens(promptContent);
+    return {
+      filePath,
+      tokenCount: tokens,
+      charCount: promptContent.length,
+      underBudget: tokens <= this.maxTokens,
+      writtenToDisk,
+      prompt: promptContent
+    };
+  }
+
+  auditToSarif(text = null) {
+    const content = text !== null ? text : this.generateCompactPrompt();
+    const tokens = this.estimateTokens(content);
+    const findings = [];
+
+    if (tokens > this.maxTokens) {
+      findings.push({
+        ruleId: 'RULE-CTX-001',
+        name: 'ContextBudgetExceeded',
+        severity: 'WARNING',
+        message: `O prompt compactado excedeu o orçamento estrito de ${this.maxTokens} tokens (Total atual: ${tokens} tokens).`,
+        remediation: 'Reduza detalhes secundários preservando apenas os 10 Princípios Canônicos e o Tríplice Registro.'
+      });
+    }
+
+    return createSarifReport({
+      toolName: 'agent-master-context-compressor',
+      rules: [
+        {
+          id: 'RULE-CTX-001',
+          name: 'ContextBudgetExceeded',
+          description: 'Valida se o prompt gerado cabe dentro da janela compacta de modelos locais',
+          severity: 'MEDIUM',
+          cwe: 'CWE-400'
+        }
+      ],
+      findings,
+      properties: {
+        tokenCount: tokens,
+        maxTokens: this.maxTokens,
+        underBudget: tokens <= this.maxTokens
+      }
+    });
+  }
+
+  formatReport() {
+    const prompt = this.generateCompactPrompt();
+    const tokens = this.estimateTokens(prompt);
+    return [
+      '### Relatório de Compactação Semântica de Contexto',
+      `- **Versão:** v${PKG_VERSION} Enterprise`,
+      `- **Tokens Estimados:** ${tokens} (Orçamento: ${this.maxTokens})`,
+      `- **Caracteres:** ${prompt.length}`,
+      `- **Status:** ${tokens <= this.maxTokens ? '✅ **DENTRO DO ORÇAMENTO**' : '⚠️ **EXCEDIDO**'}`,
+      `- **Princípios Ativos:** 10 Princípios Canônicos Universais (v5.1)`
+    ].join('\n');
+  }
+
+  static estimateTokens(text) {
+    return new ContextCompressor().estimateTokens(text);
+  }
+
+  static generateCompactPrompt() {
+    return new ContextCompressor().generateCompactPrompt();
+  }
+
+  static compressCustomText(text, maxTokens) {
+    return new ContextCompressor().compressCustomText(text, maxTokens);
+  }
+
+  static exportCompactAgent(targetDir, options) {
+    return new ContextCompressor().exportCompactAgent(targetDir, options);
+  }
+}
+
+// Funções retrocompatíveis
+function estimateTokens(text) {
+  return ContextCompressor.estimateTokens(text);
+}
+
+function generateCompactPrompt() {
+  return ContextCompressor.generateCompactPrompt();
+}
+
+function compressCustomText(text, maxTokens) {
+  return ContextCompressor.compressCustomText(text, maxTokens);
+}
+
+function exportCompactAgent(targetDir, options) {
+  return ContextCompressor.exportCompactAgent(targetDir, options);
+}
+
+async function runCli() {
+  const args = process.argv.slice(2);
+  const compressor = new ContextCompressor();
+  const result = compressor.exportCompactAgent(ROOT_DIR);
+
+  console.log('=== Compactador Semântico de Contexto para Modelos Locais (v5.1) ===');
+  console.log(`Arquivo Gerado: ${result.filePath}`);
+  console.log(`Caracteres: ${result.charCount}`);
+  console.log(`Tokens Estimados: ${result.tokenCount} (Orçamento máximo: ${compressor.maxTokens})`);
+  console.log(`Status de Conformidade: ${result.underBudget ? 'DENTRO DO ORÇAMENTO (APROVADO)' : 'ULTRAPASSADO'}`);
+
+  if (args.includes('--print')) {
+    console.log('\n--- Conteúdo Destilado ---\n');
+    console.log(result.prompt);
+  }
+}
+
+if (require.main === module) {
+  runCli().catch(err => {
+    console.error(err);
+    process.exit(1);
+  });
+}
+
+module.exports = {
+  ContextCompressor,
+  estimateTokens,
+  generateCompactPrompt,
+  compressCustomText,
+  exportCompactAgent
+};