AVENOR — CONECTOR LOCAL PARA VS CODE, CURSOR E GIT

Requer Node.js 18 ou superior e sua própria pasta de projeto. Não há dependências para instalar.

WINDOWS
1. Extraia este ZIP.
2. Dê dois cliques em INICIAR.bat.
3. Cole o caminho da pasta do projeto quando solicitado e pressione Enter.
4. Abra no navegador o endereço COMPLETO exibido na janela do conector. Ele começa com http://127.0.0.1:47821 e contém um código privado após #. Não compartilhe esse endereço.
5. Copie o código de conexão exibido apenas nessa página local.
6. No Avenor, abra Desenvolvimento privado > Conectar computador.
7. Cole o código e conecte. A conta e a API de IA não recebem esse código.
8. Cada comando ou transferência de HTML precisa de aprovação na página local.

ALTERNATIVA PELO TERMINAL
node bridge.mjs --workspace "C:\caminho\do\seu\projeto"

VS CODE E CURSOR
Os botões enviam code . e cursor . para aprovação local. O editor precisa estar instalado e seu comando disponível no PATH. Se falhar, abra o editor manualmente e use Arquivo > Abrir Pasta para escolher a mesma pasta.
O conector não controla os agentes internos do VS Code ou Cursor e não inclui suas assinaturas de IA.

GITHUB
Usa o Git e a autenticação já configurados no seu computador. O remoto origin, quando é do GitHub.com, aparece como link. git status, git diff e comandos digitados são executados na pasta escolhida, após sua aprovação.
Não cria conta, repositório, commit ou push automaticamente. Configure o remoto no seu editor, se necessário.

TROCAR O HTML
Enviar HTML grava somente avenor-preview.html na pasta escolhida. Um arquivo anterior é copiado para .avenor-backups.
Edite esse arquivo no VS Code ou Cursor. Trazer HTML lê esse mesmo arquivo após sua aprovação e atualiza a prévia do Avenor.
Não sobrescreve index.html, package.json ou arquivos de um projeto React/Vite automaticamente.

LIMITES E CUIDADOS
É um console de comandos com saída de texto, não um terminal interativo completo. Cada comando começa na pasta escolhida; cd não muda a pasta do próximo comando. Use cd subpasta; comando na mesma execução, quando necessário.
Comandos têm limite de 120 segundos e saída de 200 mil caracteres. Para npm run dev permanente, prompts de login e sessões interativas, use o terminal do VS Code/Cursor.
Os comandos usam suas permissões do sistema e podem alterar arquivos ou acessar a rede. A pasta escolhida não é uma barreira de isolamento. Não aprove comandos que você não entende.
O conector só escuta em 127.0.0.1, aceita o endereço do Avenor e localhost:5173, pede código de sessão e exige aprovação local de cada execução.
Não envie senhas, tokens, chaves ou dados sensíveis como comando. A saída fica na memória da sessão do navegador, sem envio automático à conta.
Feche o conector com Ctrl+C quando terminar. O código de conexão muda a cada início.

NAVEGADOR
Chrome/Edge podem pedir permissão de acesso ao computador/rede local. Conceda somente para o seu Avenor. Não desative proteções do navegador nem exponha a porta na internet. Se o acesso local for bloqueado, use o terminal do editor enquanto a compatibilidade é ajustada.

A criação visual continua disponível sem este conector. Este pacote não utiliza nem inclui chave de API de IA.
