egc-guardian

validate_command({ command: string })

Valida um comando de terminal antes de executar. Bloqueia padrões de shell injection (ponto e vírgula, pipe para o bash, execução com crase), binários sabidamente perigosos, eval inline mesmo quando a flag está colada ao valor, arquivos de padrão do grep apontados para caminhos protegidos, caminhos escondidos em formas flag=valor e comandos que miram caminhos protegidos. A ocultação de segredos também cobre chaves de API no estilo do Google.

Retorna: { allowed: boolean, reason?: string }

validate_write({ filepath: string })

Valida uma gravação de arquivo. Bloqueia gravações em caminhos sensíveis do sistema (~/.ssh/, /etc/, /usr/, /bin/) e em caminhos fora da pasta do projeto.

Retorna: { allowed: boolean, reason?: string }

validate_content({ content: string, source?: string })

Procura, por heurística, padrões de prompt injection em conteúdo não confiável (páginas da web baixadas, arquivos de terceiros, respostas de API, diffs de PRs de forks) antes que ele seja tratado como confiável. Só avisa: retorna [FLAGGED] ou [CLEAN] e nunca bloqueia; quem chamou decide o que fazer com o conteúdo marcado. O rótulo opcional source vai para o log de auditoria.

Retorna: [FLAGGED] com os padrões encontrados, ou [CLEAN].

reduce_context({ filepaths: string[], mode?: 'FAST_RESPONSE' | 'DEEP_COGNITION' })

Remove duplicatas e enxuga um conteúdo em Markdown para reduzir a contagem de tokens. Tira cabeçalhos repetidos, junta espaços em branco e corta no limite de tokens, se houver.

Retorna: Texto em Markdown enxuto.

orchestrate_task({ prompt: string, filepaths?: string[] })

Analisa um prompt e devolve uma sugestão de encaminhamento: quais agents e skills são mais relevantes, pontuados localmente contra o catálogo, sem chave de API. Só oferece componentes que a ferramenta tem instalados; os componentes compatíveis que não estão instalados aparecem à parte, com o comando que os adiciona, para a IA nunca chamar algo que falta. Não executa nada. A decisão continua com a IA, pela intenção.

Retorna: Objeto com os agents e skills instalados, uma lista not_installed com um install_hint e se a instalação é conhecida.

auto_learn({ project_path: string, target_file?: string, limit?: number })

Garimpa as falhas recentes de ferramentas no histórico das sessões e escreve recomendações práticas em todos os arquivos de configuração de ferramentas de IA encontrados no projeto (CLAUDE.md, GEMINI.md, AGENTS.md, regras do Cursor, instruções do Copilot, regras do Devin Desktop e outros). Só escreve em arquivos que já existem. Pode ser chamado a qualquer momento; se não houver falhas, simplesmente não faz nada.

Retorna: Objeto com patterns_found, recommendations_written, target_file, propagated_to (lista dos arquivos gravados) e skipped.