docs: atualizar instrucoes para bun e convex self-hosted

agents.md

@@ -13,23 +13,23 @@
 
 Os demais colaboradores reais são provisionados via **Convites & acessos**. Caso existam vestígios de dados demo, execute `node scripts/remove-legacy-demo-users.mjs` para limpá-los.
 
-> Execute `pnpm auth:seed` após configurar `.env` para (re)criar os usuários acima (campos `SEED_USER_*` podem sobrescrever credenciais).
+> Execute `bun run auth:seed` após configurar `.env` para (re)criar os usuários acima (campos `SEED_USER_*` podem sobrescrever credenciais).
 
 ## Backend Convex
 - Seeds de usuários/tickets demo: `convex/seed.ts`.
-- Para DEV: rode `pnpm convex:dev` e acesse `/dev/seed` uma vez para popular dados realistas.
+- Para DEV: rode `bun run convex:dev:bun` e acesse `/dev/seed` uma vez para popular dados realistas.
 
 ## Stack atual (18/10/2025)
 - **Next.js**: `15.5.5` (Turbopack em produção + cache de filesystem em DEV).  
   - Whitelist de domínios em `src/config/allowed-hosts.ts` é aplicada pelo `middleware.ts`.  
 - **React / React DOM**: `18.2.0`.
-- **Trilha de testes**: Vitest (`pnpm test`) sem modo watch por padrão (`--run --passWithNoTests`).  
-- **CI**: workflow `Quality Checks` (`.github/workflows/quality-checks.yml`) roda `pnpm install`, `prisma:generate`, `lint`, `test`, `build`. Variáveis críticas (`BETTER_AUTH_SECRET`, `NEXT_PUBLIC_APP_URL`, etc.) são definidas apenas no runner — não afetam a VPS.
-- **Disciplina pós-mudanças**: sempre que fizer alterações locais, rode **obrigatoriamente** `pnpm lint`, `pnpm build` e `pnpm test` antes de entregar ou abrir PR. Esses comandos são mandatórios também para os agentes/automations, garantindo que o projeto continua íntegro.
-- **Deploy**: pipeline `ci-cd-web-desktop.yml` (runner self-hosted). Build roda com pnpm 9, Node 20. Web é publicado em `/home/renan/apps/sistema` e o Swarm aponta `sistema_web` para essa pasta.
+- **Trilha de testes**: Vitest (`bun test`) sem modo watch por padrão (`--run --passWithNoTests`).  
+- **CI**: workflow `Quality Checks` (`.github/workflows/quality-checks.yml`) roda `bun install`, `bun run prisma:generate`, `bun run lint`, `bun test`, `bun run build:bun`. Variáveis críticas (`BETTER_AUTH_SECRET`, `NEXT_PUBLIC_APP_URL`, etc.) são definidas apenas no runner — não afetam a VPS.
+- **Disciplina pós-mudanças**: sempre que fizer alterações locais, rode **obrigatoriamente** `bun run lint`, `bun run build:bun` e `bun test` antes de entregar ou abrir PR. Esses comandos são mandatórios também para os agentes/automations, garantindo que o projeto continua íntegro.
+- **Deploy**: pipeline `ci-cd-web-desktop.yml` (runner self-hosted). Build roda com Bun 1.3 + Node 20. Web é publicado em `/home/renan/apps/sistema` e o Swarm aponta `sistema_web` para essa pasta.
 
 ## Setup local (atualizado)
-1. `pnpm install`
+1. `bun install`
 2. Copie `.env.example` → `.env.local`.  
    - Principais variáveis para DEV:
      ```
@@ -40,10 +40,10 @@ Os demais colaboradores reais são provisionados via **Convites & acessos**. Cas
      NEXT_PUBLIC_CONVEX_URL=http://127.0.0.1:3210
      DATABASE_URL=file:./prisma/db.dev.sqlite
      ```
-3. `pnpm auth:seed`
-4. (Opcional) `pnpm queues:ensure`
-5. `pnpm convex:dev`
-6. Em outro terminal: `pnpm dev`
+3. `bun run auth:seed`
+4. (Opcional) `bun run queues:ensure`
+5. `bun run convex:dev:bun`
+6. Em outro terminal: `bun run dev:bun`
 7. Acesse `http://localhost:3000` e valide login com os usuários padrão.
 
 ### Banco de dados
@@ -53,9 +53,9 @@ Os demais colaboradores reais são provisionados via **Convites & acessos**. Cas
 
 ### Verificações antes de PR/deploy
 ```bash
-pnpm lint
-pnpm test
-pnpm build
+bun run lint
+bun test
+bun run build:bun
 ```
 
 ## Aplicativo Desktop (Tauri)
@@ -86,11 +86,11 @@ pnpm build
 - Planejamos usar um cookie `desktop_shell` no futuro para diferenciar acessos do desktop vs navegador (não implementado).
 
 ## Qualidade e testes
-- **Lint**: `pnpm lint` (ESLint flat config).
+- **Lint**: `bun run lint` (ESLint flat config).
 - **Testes unitários/integrados (Vitest)**:
   - Cobertura atual inclui utilitários (`tests/*.test.ts`), rotas `/api/machines/*` e `sendSmtpMail`.
-  - Executar `pnpm test -- --watch` apenas quando precisar de modo interativo.
-- **Build**: `pnpm build` (`next build --turbopack`).
+  - Executar `bun test -- --watch` apenas quando precisar de modo interativo.
+- **Build**: `bun run build:bun` (`next build --turbopack`).
 - **CI**: falhas mais comuns
   - `ERR_PNPM_OUTDATED_LOCKFILE`: mantenha `pnpm-lock.yaml` atualizado (principalmente após alterar dependências do desktop).
   - Variáveis Better Auth ausentes (`BETTER_AUTH_SECRET`): definidas no workflow (`Quality Checks`).