Basinfy (BasinMind)

Basinfy é uma ferramenta sofisticada de mapeamento arquitetural e auto-cura preditiva impulsionada por IA. Ela analisa matematicamente a topologia da sua base de código em Bacias de Atração (Basins of Attraction) isoladas, reduzindo o consumo de tokens dos agentes em até 90% e diagnosticando continuamente a entropia estrutural ao longo do tempo.

🌍 Idiomas Suportados (Parsing AST)

O Basinfy atua como um scanner de projetos e analisador AST robusto. Ele não depende apenas de regexes básicos; em vez disso, utiliza um registro de analisadores multi-idioma para extrair exportações, importações, assinaturas e resumos estruturais nativamente para: TypeScript, JavaScript, C, C++, Python, Rust, SQL, Go, Java, Kotlin, C#, Ruby, PHP, Swift, Scala, Elixir, Dart, Lua, Haskell, Nim, Julia, Zig, Fortran, Perl e R.

🤖 Integração de Agentes: O Protocolo Basinfy (MCP-first)

Basinfy fornece uma integração poderosa, focada em MCP (Model Context Protocol), para agentes de IA (como Claude, Cursor, Windsurf ou agentes personalizados) navegarem, entenderem e modificarem bases de código de forma contínua com eficiência de tokens e segurança arquitetural.

Ao mapear o código em Bacias de Atração matemáticas, o Basinfy elimina a necessidade de agentes fazerem buscas cegas com grep ou leituras completas de arquivos, economizando até 90% no consumo de tokens.

O Fluxo de Trabalho do Protocolo Principal

Quando um agente entra em um workspace indexado pelo Basinfy (contendo um diretório .basinfy/), ele deve seguir este protocolo padrão:

1. Iniciar a Sessão (basinfy_session_start / basinfy_brief)

   • Nunca execute grep no shell ou realize leituras completas de arquivos às cegas.
   • Use a ferramenta basinfy_session_start como a primeira ação para detectar o contexto, verificar a atualização do índice, verificar a saúde e obter um briefing arquitetural unificado.
   • Alternativamente, use basinfy_brief para um briefing de tarefa direcionada (pirâmide de contexto L0-L3). Ele inclui inline automaticamente e exatamente o que você precisa.

2. Verificações Pré-voo para Edições (basinfy_prepare_edit)

   • Antes de modificar um símbolo existente, chame basinfy_prepare_edit. Isso executa uma análise combinada de locate + gate + impact em uma única chamada, dando ao agente a localização exata do código, validações de limite e análise de raio de impacto downstream.

3. Verificações Pré-voo para Criação (basinfy_prepare_create)

   • Antes de criar um novo arquivo, chame basinfy_prepare_create com o targetPath e plannedImports. Isso fornece uma revisão consultiva sobre o posicionamento correto da camada/bacia e a saúde das importações (evitando dependências circulares).

4. Sincronizar o Índice (basinfy_update)

   • Crucial: Após quaisquer modificações de código, o agente deve chamar imediatamente basinfy_update para reindexar incrementalmente a topografia.

5. Verificações de Recursos

   • Verifique o recurso basinfy://index/freshness se um briefing parecer desatualizado ou fora de sincronia.

Ferramentas MCP Disponíveis

Os agentes têm acesso a um rico conjunto de ferramentas MCP expostas pelo servidor Basinfy:

Inteligência & Briefing

• basinfy_session_start: Inicia a sessão do agente. Retorna o contexto do agente, a atualização do índice, a saúde e um briefing arquitetural de base.
• basinfy_brief: O ponto de entrada preferido para tarefas direcionadas. Retorna uma Pirâmide de Contexto condensada (L0-L3). Suporta prompt, budget (orçamento) e anchors (âncoras).
• basinfy_query: (Obsoleto) Alias para basinfy_brief com format=packet. Prefira basinfy_brief.
• basinfy_explain: Obtenha uma explicação estruturada de alto nível de uma bacia ou atrator específico.

Navegação & Análise de Código

• basinfy_locate: Encontra a file:startLine-endLine exata e o hash para um dado símbolo, permitindo edições direcionadas precisas sem ler arquivos inteiros.
• basinfy_orbit: Inspeciona como um arquivo específico se conecta ao seu módulo central (hub) e avalia seu fluxo global.
• basinfy_path: Descobre o caminho de dependência mais curto entre dois símbolos ou arquivos.
• basinfy_impact: Analisa o impacto downstream (raio de impacto) da alteração de um arquivo.
• basinfy_health: Executa diagnósticos de saúde do projeto.

Edição & Modificação Seguras

• basinfy_prepare_edit: O passo de preparação tudo-em-um antes de tocar em um símbolo existente (Locate + Gate + Impact).
• basinfy_prepare_create: O passo de revisão arquitetural antes de estruturar (scaffold) um novo arquivo (Posicionamento de Camada/Bacia + Validação de Importação).
• basinfy_gate_edit: Valida se uma edição de arquivo proposta viola limites estruturais.
• basinfy_update: Sincroniza o índice topológico incrementalmente após alterações no código.

Memória Persistente & Feedback

• basinfy_remember: Persiste uma nova decisão ou regra arquitetural na memória da equipe a longo prazo.
• basinfy_recall: Busca na memória cognitiva por decisões passadas sobre um tópico específico.
• basinfy_forget: Remove uma memória desatualizada.
• basinfy_feedback: Um loop heurístico para reforçar ou penalizar arquivos para uma dada consulta, para melhorar a classificação online futura.
• basinfy_skills_sync: Sincroniza os arquivos .agents/skills/*/SKILL.md no registro de briefing.

Harness Autônomo (v2)

• basinfy_drive: Inicia uma sessão de Harness Agêntico Delegada pelo Host.
• basinfy_drive_step: Relata a conclusão de uma fase (Planejar, Implementar, Revisar, Verificar) para a Máquina de Estados Finitos do Harness.
• basinfy_drive_apply: Aplica ou rejeita as alterações geradas com base na aprovação do usuário.
• basinfy_drive_status: Consulta o estado e a fase atuais de uma sessão harness em execução.

Alternativa (Modo CLI)

Se o MCP estiver indisponível ou desativado, os agentes devem recorrer ao CLI:

1. basinfy brief "<task>" --anchors
2. Realizar edições usando operações padrão de arquivo.
3. basinfy update

Nota sobre Economia de Tokens: Ao utilizar este protocolo MCP, os agentes evitam ler árvores de diretórios amplas e grandes arquivos irrelevantes. O Basinfy poda ativamente o ruído fora da bacia, deixando apenas o "resíduo" matemático necessário para a tarefa em questão.

Funcionalidades de Auto-Cura Arquitetural Preditiva

O Basinfy fornece capacidades avançadas de diagnóstico e auto-cura para detectar sobrecargas de entropia, anomalias de alto acoplamento e decadência estrutural antes que se agravem. Essas funcionalidades são acessíveis via o comando basinfy doctor e operam continuamente sobre o grafo topológico indexado.

Análise de Dados Topológicos (TDA Holes)

O Basinfy aproveita a Análise de Dados Topológicos para detectar ciclos não-contráteis (TDA Holes) dentro da arquitetura. Um "TDA hole" (buraco TDA) emerge quando um conjunto de arestas de inter-bacias estruturais (ressonâncias diagonais) forma um ciclo contínuo, mas não possui inteiramente uma bacia de abstração central unificada para ancorá-los. Identificar esses "buracos" alerta os desenvolvedores para refatorar a lógica dispersa em um módulo central unificado antes que ela se solidifique em um gargalo espaguete.

Vórtices de Acoplamento (Dependências Circulares)

Indo além da detecção simplista de dependências circulares, o Basinfy analisa loops de dependência triádica (A → B → C → A) para computar uma pontuação de Rotacional Discreto (Discrete Curl): Curl(A, B, C) = w(A→B) * w(B→C) - w(C→B) * w(B→A) Ao medir a intensidade e o peso desses ciclos, o Basinfy identifica "Vórtices de Acoplamento" — anomalias de acoplamento pesadas e entrelaçadas, onde a lógica aprisiona o estado e a execução. O sistema classifica os vórtices por sua magnitude absoluta de rotacional, trazendo as anomalias arquiteturais mais perigosas primeiro.

Lei de Densidade da Bacia (Desvios P-02/P-03)

Baseado no Teorema 3.3 (Lei de Densidade da Bacia), o Basinfy mede a distorção (skew) matemática de sua arquitetura comparando a densidade observada de resíduos modulares em relação a limites teóricos.

• P-02 (Validação Modular Pura): Valida distribuições de densidade agrupando estritamente contagens de nós pelo seu resíduo modular puro.
• P-03 (Distorção Gratuita vs. Faturável): Estabelece um limite de base determinístico de (b-1)/N. Qualquer distorção que caia dentro deste limite de ruído matemático é ignorada como "gratuita", enquanto desvios excedendo o limite indicam desequilíbrios severos na distribuição de módulos e são penalizados como anomalias arquiteturais "faturáveis".

Memórias Cognitivas (Motor de Memória Topológica)

O Basinfy implementa um sistema de armazenamento RAG local sem dependências (.basinfy/memories/) para fixar a memória conversacional e contexto diretamente a bacias arquiteturais específicas.

• Vínculo Cognitivo (Cognitive Binding): Decisões arquiteturais, contexto e resultados de consultas são salvos diretamente no pool de memórias de uma bacia alvo como memórias cognitivas L1.5, garantindo que futuras interações de IA entendam inerentemente a justificativa histórica por trás de módulos específicos.
• Impulsos de Co-modificação: Quando nós são historicamente consultados ou contextualizados, eles deixam rastros (breadcrumbs) leves. A força de ativação deles ajusta e decai dinamicamente, garantindo que módulos com relevância comprovada em consultas flutuem automaticamente em janelas de contexto.

O Comando basinfy doctor

A interface de linha de comando para profilaxia de arquitetura. Executar basinfy doctor [path] roda a suíte de diagnósticos preditiva, emitindo uma pontuação de saúde abrangente de 0–100 agrupada em um veredito healthy (saudável), moderate (moderado) ou critical (crítico). O Doctor calcula penalidades limitadas em:

1. Bifurcação de Módulo: Detecta classes anômalas excedendo limites de controle.
2. Cadeias Orbitais Profundas: Sinaliza caminhos transitórios profundos (hops > 4) isolados do seu atrator central.
3. God Objects: Sinaliza antipadrões baseados em desequilíbrios severos de grau de entrada/saída (> 20).
4. Ressonâncias Diagonais & TDA Holes: Verifica acoplamento excessivo de inter-camadas estruturais.
5. Vórtices de Acoplamento & Distorção de Densidade de Bacia: Emite avisos sobre acoplamentos cíclicos pesados e desvios dos limites de densidade estrutural.

Visualizador & Dashboard de Analytics

O Basinfy gera um visualizador HTML rico, offline-first, que fornece percepções profundas sobre a estrutura topológica, saúde e evolução de sua base de código. Ao executar basinfy map, o sistema constrói um workspace interativo localizado em .basinfy/html/ apresentando duas interfaces principais: o Mapa Basinfy e o Dashboard de Analytics.

🌌 O Mapa Basinfy Interativo (map.html)

O mapa é um grafo de rede dinâmico de tema escuro premium, construído em vis-network, renderizando sua topologia arquitetural como uma "Galáxia" interativa.

• Layout de Galáxia & Clustering Visual: Ao invés de um amontoado caótico direcionado por força, o Basinfy utiliza um algoritmo espiral de Vogel consciente de colisão para organizar o mapa. Cada Bacia (módulo) age como um "sistema solar" separado, se afastando para evitar sobreposição.
• Órbitas Intra-Bacia: Dentro de cada bacia, arquivos orbitam seu atrator central em uma espiral de Kronecker. Nós (arquivos) são colocados em anéis concêntricos representando sua profundidade de dependência (hops a partir do núcleo).
• Física ForceAtlas2: O grafo é estabilizado usando física ForceAtlas2 (gravitationalConstant: -150, centralGravity: 0.01), que aproxima organicamente nós interagentes enquanto repele clusters distintos, garantindo um layout limpo e legível.
• Dimensionamento Proporcional ao Grau & Estética: Nós são dimensionados dinamicamente com base em seu grau (dependências de entrada/saída). Módulos centrais (hop 0) têm estilo proeminente e sombras brilhantes, enquanto satélites periféricos diminuem de forma graciosa. Neurônios virtuais procedurais e memórias cognitivas recebem formatos de diamante especiais e bordas tracejadas.
• Arestas Inteligentes & Ressonâncias Diagonais: Dependências arquiteturais padrão são setas limpas e direcionais. "Ressonâncias Diagonais" (acoplamento entre bacias) são destacadas com arestas curvas, tracejadas e de cores vivas, revelando imediatamente vazamentos de encapsulamento.
• Interações Ricas:
  • Pesquisa & Foco: Pesquise arquivos ou domínios específicos. Clicar num resultado foca e dá zoom suavemente na câmera sobre o nó.
  • Painel de Inspetor de Nó: Clicar num nó revela seu domínio, grupo da bacia, grau, dependências topológicas, memórias cognitivas associadas e vizinhos clicáveis.
  • Legenda Interativa: Alternar bacias inteiras ativadas/desativadas, isolar clusters específicos, ou alternar entre os modos de visualização Structural (Estrutural) e Cognitive (Cognitivo) para filtrar o ruído.

📊 O Dashboard de Analytics (index.html)

O dashboard é um painel de controle abrangente com várias abas que audita a saúde estrutural e rastreia a evolução arquitetural.

• KPIs Topológicos & Visão Geral: Uma grade de alto nível rastreando Total de Arquivos, Arestas, Bacias, Módulos Centrais, Taxa de Compressão de Tokens, Links Cruzados, e Saúde do Sistema geral (Healthy/Moderate/Critical).
• Diagnósticos de Saúde: Analisa as dívidas arquiteturais em penalidades quantificadas:
  • Fragmentação: Bacias com demasiados atratores.
  • Órbita Profunda: Arquivos com profundidade de dependência perigosamente alta.
  • God Objects: Arquivos monolíticos com fan-in/fan-out excessivo.
  • Vórtices de Acoplamento & TDA Holes: Ciclos ciclomáticos e links estruturais em falta.
• Linha do Tempo de Evolução & Atividade: Rastreia mutações basinfy ao longo do tempo. Apresenta um feed de atividades de memórias de equipe, refatorações cognitivas e eventos Git, mapeando-os diretamente para mudanças arquiteturais.
• Gráficos Interativos (Chart.js): Análises visuais de distribuição de domínio, tipos de arestas, tendências de mutação, e análises detalhadas mapeando latência de consultas, economia de payload e confiança no roteamento.
• Explorar & Relatórios: Tabelas ordenáveis detalhando os principais hubs, pontuações de coesão de bacia, e resíduo modular. Pesquise arquivos facilmente para visualizar sua profundidade de dependência e contagem de memórias.

Uso da CLI Basinfy

A CLI do Basinfy fornece um conjunto abrangente de comandos para interagir com o seu índice de base de código topológico.

Opções Globais

• -v, --verbose : Ativar a saída detalhada.
• -l, --lang <language> : Definir a linguagem de saída (en para Inglês, pt para Português, es para Espanhol).

Operações Principais

basinfy init [path]

Indexar um projeto em grupos de módulos relacionados (bacias). Opções:

• -k, --exponent <number> : Parâmetro de ajuste avançado (expoente de agrupamento).
• -b, --base <number> : Parâmetro de ajuste avançado (base de agrupamento).
• --no-auto-tune : Desativar o ajuste automático de parâmetros.
• --no-mcp : Pular configuração stdio automática do MCP.
• --portable-mcp : Escrever a configuração MCP npm-portable (npx).
• --agents <agents> : Lista separada por vírgula de assistentes IA a configurar.

basinfy update [path]

Atualização incremental rápida do índice que regista memórias do módulo. Execute isto depois de modificar arquivos. Opções:

• --force : Forçar reindexação completa.
• --from-git : Semear e registrar memórias de módulos a partir do histórico de commits do git.
• --reason <string> : Motivo ou mensagem de commit descrevendo o contexto da mutação.
• --no-auto-tune : Desativar o ajuste automático de parâmetros.
• --retune : Forçar o grid search de auto-tune.

basinfy lang [codeOrName] / basinfy language

Visualizar ou definir o idioma de saída padrão para o CLI. Opções:

• -g, --global : Definir idioma globalmente.
• --local : Definir idioma localmente para o projeto atual.

basinfy status

Exibe métricas do índice, saúde e os orçamentos (budgets) de tokens atuais. Opções:

• -p, --path <path> : Caminho para o root (raiz) do workspace (padrão: .).

basinfy watch [path]

Executa o Basinfy em segundo plano e atualiza automaticamente o índice em caso de alterações em arquivos.

Consultas & Briefings (Contexto do Agente)

basinfy brief <prompt>

Compilar um BriefingPacket com um certificado de roteamento (Representação Intermediária pre-prompt). O ponto de entrada preferencial para buscar contexto. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• -B, --budget <number> : Orçamento (budget) máximo de tokens.
• -f, --format <format> : Formato de saída: packet, json, llm, ou markdown (padrão).
• --at <commit> : Reproduzir contexto associado no commit git especificado.
• --fast : Roteamento lexical (padrão, ~30ms).
• --hybrid : Roteamento híbrido lexical+embedding (~2.5s).
• --semantic : Roteamento focado em embed.
• --task <type> : Tipo de tarefa: fix-bug, add-feature, review, explain.
• --anchors : Incluir âncoras exatas de edição no pacote.
• --no-persist : Pular persistência do certificado.
• --hypothesize : Retornar um checklist arquitetural em vez de contexto de código.

basinfy query <prompt>

Corresponder uma pergunta em linguagem natural ao grupo de módulos mais relevante. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• -B, --budget <number> : Orçamento (budget) máximo de tokens.
• --anchors : Anexar âncoras exatas de edição para edição de baixo token.
• --fast, --hybrid, --semantic : Estratégias de roteamento.
• -f, --format <format> : Formato de saída (markdown, json, packet).
• --seeds : Imprimir a lista de nós semente no estilo Graphify antes do briefing.
• --json : Exportar payload de contexto comprimido no formato JSON.
• -g, --global : Forçar busca global e exibir resumos da Bacia L3.

basinfy rag <prompt>

Montar um payload de contexto pronto para uso especificamente formatado para a ingestão de IA/LLM. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• -B, --budget <number> : Orçamento (budget) máximo de tokens.
• -f, --format <format> : Formato de saída: llm (padrão), markdown, json, packet.
• --fast, --hybrid, --semantic : Estratégias de roteamento.

Navegação & Análise de Código

basinfy locate <symbol>

Resolver o exato intervalo file:line range e o hash do conteúdo de um símbolo/chave para edições precisas com poucos tokens. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• -f, --file <file> : Restringir a busca para um arquivo específico.
• -w, --window <number> : Linhas de contexto extras para mostrar ao redor da âncora.
• --content : Imprimir a janela do código-fonte ancorado com números de linha.
• --json : Exportar as âncoras em formato JSON.

basinfy path <from> <to>

Encontrar o caminho de dependência mais curto entre dois símbolos ou arquivos. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.

basinfy orbit [filepath]

Rastrear como um arquivo específico se conecta ao seu módulo central (hub). Opções:

• -p, --path <path> : Caminho para a raiz do workspace.

basinfy orbits

Analisar e exibir os caminhos de dependência para TODOS os arquivos em todos os grupos de módulos. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.

basinfy explain <attractorOrBasin>

Recuperar um resumo de um módulo central (atrator) ou grupo de módulos. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.

basinfy impact <filepath> (Alias: blast-radius)

Simular o raio de impacto e a cascata de dependência inversa de alterar um arquivo. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.

basinfy bifurcation <domain>

Analisar a fragmentação de módulo e limites arquiteturais dentro de um domínio específico. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.

Memória & Feedback

basinfy remember <content>

Armazenar uma memória cognitiva nos grupos de módulos mais relevantes. Opções:

• -p, --project <path> : Caminho para a raiz do workspace.
• -c, --context <tags> : Tags de contexto separadas por vírgulas.
• -s, --source <type> : Fonte da memória (SYSTEM, USER, AGENT).

basinfy recall <query>

Recuperar memórias estruturais e cognitivas a longo prazo dos grupos de módulos. Opções:

• -p, --project <path> : Caminho para a raiz do workspace.

basinfy forget <memory_id>

Excluir uma memória cognitiva do banco de dados de memória. Opções:

• -p, --project <path> : Caminho para a raiz do workspace.

basinfy feedback <files...>

Reforçar (+1) ou penalizar (-1) links entre arquivos com base nos resultados das consultas. Opções:

• -p, --project <path> : Caminho para a raiz do workspace.
• -r, --reward <number> : Valor de recompensa (1 ou -1).
• -q, --question <text> : Comando de consulta (query) para o resultado da memória.
• --no-infer-question : Pular a dedução da pergunta da última sessão.

Integrações de Agentes & MCP

basinfy install

Detectar automaticamente assistentes de programação de IA e registrar o skill Basinfy global ou localmente. Opções:

• -y, --yes : Pular o assistente interativo.
• --lang <codeOrName> : Pré-selecionar idioma.
• --agents <ids> : IDs de assistentes de IA separados por vírgula a configurar.
• --scope <local|global|both> : Escopo de instalação.
• -p, --path <path> : Raiz do projeto para a configuração do MCP.
• --no-mcp, --portable-mcp : Substituições de configuração de MCP.

basinfy config

Gerar a configuração stdio MCP para assistentes de programação IA. Opções:

• -p, --project <path> : Raiz do projeto.
• --agent <id> : Configurar um único agente.
• --all-agents : Configurar todos os agentes suportados.
• --detect : Listar assistentes IA detetados sem gravar configuração.
• --global, --portable-mcp : Substituições de saída.
• -y, --yes : Pular o prompt interativo.
• --set-lang <language> : Definir o idioma padrão.
• --verify : Testar o aperto de mão (handshake) stdio MCP após gravar.

basinfy skills <command>

Sincronizar e inspecionar skills de agente instalados (.agents/skills/). Comandos:

• sync : Escanear arquivos SKILL.md, destilar os pontos chaves e armazenar na memória a longo prazo.
  • -p, --path <path> : Caminho para a raiz do workspace.
  • --llm : Enriquecer resumos usando um LLM.
  • --dry-run : Pré-visualizar alterações.
• list : Listar skills no .basinfy/skills-registry.json.
  • -p, --path <path> : Caminho para a raiz do workspace.
• show <skillId> : Mostrar detalhes destilados para um skill específico.
  • -p, --path <path> : Caminho para a raiz do workspace.

basinfy harness <action> [keyOrValue] [value]

Gerenciar configurações do Harness Agêntico v2. As ações incluem on, off, set, e status. Opções:

• -p, --project <path> : Caminho para a raiz do workspace.

Ferramentas Avançadas & Refatoração

basinfy crystallize

Executar a Refatoração Topológica Ativa via o Otimizador de Topologia. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• --iterations <number> : Passos termodinâmicos para modelos de gravidade (padrão: 5000).

basinfy evolve

Evoluir pesos de calibração de classificação (rank) utilizando LDStrata e CMA-ES para melhor roteamento. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• --budget <n> : Avaliações de aptidão (fitness) máximas (padrão: 200).
• --online : Misturar aptidão com memórias de resultado de consulta.
• --per-basin : Armazenar pesos evoluídos por bacia.
• --quick : Execução rápida.

basinfy doctor [path]

Executar uma verificação de saúde arquitetural abrangente no projeto.

basinfy map

Gerar um mapa visual interativo em HTML/Canvas da topologia do seu projeto. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• --no-update : Pular a atualização automática do índice se desatualizado.

basinfy export [outputPath]

Exportar dados de índice topológico para CSV ou JSON. Opções:

• -p, --path <path> : Caminho para a raiz do workspace.
• -f, --format <format> : Formato de saída (csv ou json).

basinfy install-hooks [path] / basinfy uninstall-hooks [path]

Instalar ou remover watchdogs de atualização contínua do Basinfy no seu .git/hooks/.

Licenciamento & Configuração

O Basinfy é um software proprietário licenciado. É necessária uma licença válida via ativação vinculada ao hardware.

basinfy activate <key>
basinfy info

Harness Agêntico v2

O Harness Agêntico v2 (modo autônomo e Doctor de código) é ativado e configurado totalmente via CLI.

Por que a CLI e não o Dashboard HTML? O dashboard visual gerado pelo Basinfy é um arquivo HTML estático, offline, visualizado pelo protocolo file://. Por motivos de segurança e técnicos, os navegadores modernos não permitem que arquivos HTML estáticos locais gravem configurações diretamente de volta no diretório .basinfy do projeto. Portanto, todas as configurações do provedor de IA e dos modelos devem ser gerenciadas de forma segura através dos comandos basinfy harness no seu terminal.

Use os seguintes comandos para gerenciar seu Harness de IA:

# Verificar status atual do harness
basinfy harness status

# Ativar ou desativar o Harness
basinfy harness on
basinfy harness off

# Configurar provedor e modelo
basinfy harness set provider host
basinfy harness set model llama-3.3-70b-versatile

# Configurar a API key e orçamento de tokens
basinfy harness set key sk-sua-chave-aqui
basinfy harness set budget 500000