@bcelep/capint 0.4.2 → 0.6.5

package/skills/database-blueprints/references/migration-safety.md

@@ -0,0 +1,55 @@
+# Segurança de Migração
+
+## Princípio
+
+Migrações devem preservar dados, ter ordem clara, validação e rollback.
+
+## Fluxo
+
+1. Levantar estado atual: banco, tabelas, migrations e dados reais.
+2. Projetar schema alvo: tabelas, campos, FKs, índices e permissões.
+3. Dividir: base, negócio, relacionamentos, backfill, constraints, índices e seed.
+4. Validar em banco vazio e staging com dados.
+5. Definir rollback.
+
+## Padrões seguros
+
+### Renomear campo
+
+Adicionar campo novo, backfill, código lê novo/antigo, verificar, remover antigo.
+
+### Alterar tipo
+
+Criar campo temporário, converter, validar, trocar código, remover antigo.
+
+### Campo not null
+
+Adicionar nullable, preencher, validar sem null, aplicar `not null`.
+
+### Foreign key
+
+Criar pai primeiro, limpar órfãos, conferir tipos, criar índice e só então adicionar FK.
+
+## Numeração
+
+```text
+001_create_core_identity_tables
+002_create_customer_tables
+003_create_order_tables
+004_create_payment_tables
+005_create_file_message_tables
+006_add_indexes
+007_add_rls_policies
+008_seed_demo_data
+```
+
+## Checklist de produção
+
+Backup, staging, rollback, ordem confirmada, índices, integridade de FK, DTO/front-end atualizados e teste de salvar/refresh/listar/editar/excluir.
+
+## Casos comuns
+
+- “precisa atualizar a tabela no banco?”: compare campos esperados pelo código com colunas reais.
+- “banco não está abrindo”: verifique conexão, serviço, migration, permissão e pool.
+- “não sei qual script rodar primeiro”: renumerar e documentar ordem.
+- “dados não aparecem”: verificar insert, select, RLS, cache e coluna errada.

package/skills/database-blueprints/references/mysql.md

@@ -0,0 +1,50 @@
+# MySQL
+
+## Configuração padrão
+
+Use `utf8mb4`, InnoDB e collation consistente com o projeto.
+
+Campos de chave estrangeira devem ter tipo, unsigned, tamanho e charset compatíveis com a coluna referenciada.
+
+## Convenções
+
+- Chave primária: `char(36)` UUID ou `bigint unsigned auto_increment`, seguindo o projeto.
+- `created_at`, `updated_at` e, quando necessário, `deleted_at`.
+- Dinheiro em `decimal(12,2)`.
+- Índices em `organization_id`, `status`, `created_at`, `customer_id`.
+
+## Erro errno 150
+
+Verifique:
+
+1. Tipos iguais dos dois lados.
+2. Campo referenciado é primary ou unique.
+3. Ambas as tabelas usam InnoDB.
+4. Charset/collation consistentes.
+5. Tabela pai criada antes.
+6. Sem dados órfãos.
+
+## Ordem de migrations
+
+Use arquivos numerados:
+
+```text
+001_create_organizations.sql
+002_create_users_roles.sql
+003_create_customers.sql
+004_create_orders.sql
+005_create_payments.sql
+006_create_files_messages.sql
+007_create_indexes.sql
+008_seed_initial_data.sql
+```
+
+Nunca faça o usuário adivinhar a ordem.
+
+## Mapeamento de campos
+
+Quando um campo salva errado, verifique: `name` do formulário, state do front-end, request body, DTO, model ORM, coluna e query de listagem/detalhe.
+
+## Segurança
+
+Não hardcode senha admin, não use root no app, não exponha SQL debug em produção e mantenha tokens em variáveis de ambiente.

package/skills/database-blueprints/references/prisma.md

@@ -0,0 +1,47 @@
+# Prisma
+
+## Quando usar
+
+Carregue este arquivo se houver `schema.prisma`, `prisma migrate`, `prisma generate`, `PrismaClient` ou erro `Invalid prisma.<model>.<action>() invocation`.
+
+## Checklist de campo novo
+
+1. Campo existe no `schema.prisma`.
+2. Migration foi gerada.
+3. Banco executou a migration.
+4. API envia campo válido.
+5. Front-end usa nome correto.
+
+## Relações
+
+Inclua o campo scalar da FK e o campo relation. Tipos devem bater e campos filtrados com frequência devem ter `@@index`.
+
+## Erros comuns
+
+### Unknown argument
+
+A API envia um campo inexistente no model. Atualize o schema, crie migration e rode `prisma generate`.
+
+### Migration drift
+
+Não resete produção. Compare schema real com migrations, use diff e valide em staging.
+
+### PrismaClient múltiplo
+
+Em dev com hot reload, use singleton para evitar excesso de conexões.
+
+## Seed
+
+Inclua dados mínimos: organization, admin, roles, customer, order/service order e payment. Nunca use tokens reais.
+
+## Validação
+
+```bash
+npx prisma format
+npx prisma validate
+npx prisma migrate dev
+npx prisma generate
+npm test
+```
+
+Em produção, use `prisma migrate deploy`.

package/skills/database-blueprints/references/supabase-postgres.md

@@ -0,0 +1,63 @@
+# Supabase / Postgres
+
+## Escolha padrão
+
+Em projetos Supabase, use:
+
+- Postgres para dados de negócio.
+- Supabase Auth para identidade.
+- Row Level Security para tenant e papéis.
+- Supabase Storage para arquivos.
+- Edge Functions para webhooks, pagamentos e WhatsApp.
+
+## Convenções
+
+- `id uuid primary key default gen_random_uuid()`
+- `created_at timestamptz not null default now()`
+- `updated_at timestamptz not null default now()`
+- `organization_id uuid not null references organizations(id)` em tabelas multi-tenant
+- `jsonb` para eventos brutos
+- índices em `organization_id`, `status`, `created_at` e FKs
+
+## Auth
+
+Não copie senha ou token do Supabase Auth.
+
+Recomendado:
+
+- `auth.users.id` como origem da identidade.
+- `public.users.id` pode referenciar `auth.users.id`.
+- Dados isolados por `organization_id`.
+- `user_roles` define permissões no tenant.
+
+## RLS base
+
+- Usuário lê seu próprio registro.
+- Membro lê dados da própria organização.
+- Admin/owner escreve configurações.
+- Service role só em backend confiável.
+- Webhook não deve depender de permissões anon abertas.
+
+## Storage
+
+Salve metadados: bucket, path, nome original, mime type, tamanho, owner e uploader.
+
+Arquivos de clientes, animais, documentos ou ordens de serviço devem ser privados por padrão, com signed URLs.
+
+## Problemas comuns
+
+### Inseriu mas não aparece
+
+Verifique RLS, `organization_id`, filtros da query, retorno do insert e cache da UI.
+
+### `function_search_path_mutable`
+
+Corrija a assinatura exata da função e defina `search_path`.
+
+### Vários GoTrueClient
+
+Centralize a criação do client em um singleton.
+
+## Webhook
+
+Fluxo: validar assinatura, salvar evento bruto, aplicar idempotência por `provider + event_id`, atualizar tabelas em transação e registrar status.

package/skills/delivery-acceptance/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: delivery-acceptance
+description: |
+  Skill de aceitação de entrega. Cobre validação funcional, Playwright smoke test,
+  mobile, upload, PDF, QR, CRUD, permissões e reteste antes de declarar o sistema
+  pronto.
+metadata:
+  version: '1.0.0'
+origin: verdent
+prismx_bundle: verdent
+prismx_imported_at: 2026-05-27
+---
+# Aceitação de Entrega
+
+Skill de aceitação de entrega para levar o projeto de “código pronto” para “usuário consegue usar”.
+
+## Uso
+
+Quando o Verdent finalizar ou revisar Web/App/painel/sistema de negócio, injete um processo de validação real.
+
+Cobre:
+
+- Botão sem ação, menu faltando, campo divergente.
+- Login, cadastro e permissões quebradas.
+- CRUD que perde dados após refresh.
+- Upload, PDF, QR Code e impressão falhando.
+- Layout mobile quebrado.
+- Usuário pedindo `testar`, `verifique`, `corrija`.
+
+## Gatilhos
+
+`testar` · `teste` · `verifique` · `revisar` · `corrija` · `não funciona` · `não aparece` · `botão` · `mobile` · `PDF` · `QR Code` · `upload` · `checkin` · `admin panel`
+
+## Como usar
+
+1. Defina o escopo de aceitação.
+2. Gere checklist de páginas, contas, CRUD, arquivos, pagamentos, mensagens, mobile e erros.
+3. Rode testes existentes ou crie smoke test.
+4. Capture evidências das rotas críticas.
+5. Registre falhas com reprodução, esperado, atual e causa provável.
+6. Corrija e reteste o mesmo item.
+
+## Arquivos de conhecimento
+
+| Arquivo | Conteúdo |
+|---------|----------|
+| `knowledge/acceptance-checklist.md` | Checklist geral de entrega |
+| `knowledge/playwright-smoke.md` | Estratégia de smoke test com Playwright |
+| `knowledge/mobile-print-file.md` | Mobile, impressão/PDF, upload e QR |
+
+## Saída esperada
+
+Inclua escopo, itens verificados, falhas, correções, reteste e riscos não cobertos.
+
+## Proibições
+
+- Não dizer “tudo funciona” sem validação.
+- Não validar só estrutura estática.
+- Não ignorar mobile, refresh, persistência e permissão.
+- Não tratar “botão não funciona” apenas como UI; verifique handler, API, permissão e dados.

package/skills/delivery-acceptance/agents/verdent.yaml

@@ -0,0 +1,12 @@
+category: Productivity
+interface:
+  display_name: Delivery Acceptance
+  short_description: Verify deliverables against acceptance criteria and quality gates.
+  icon_dark: './assets/icon-dark.png'
+  icon_light: './assets/icon-light.png'
+  default_prompt: Help me run acceptance checks on this deliverable.
+  label:
+    - acceptance
+    - qa
+    - delivery
+    - verification

package/skills/delivery-acceptance/references/acceptance-checklist.md

@@ -0,0 +1,44 @@
+# Checklist de Aceitação
+
+## Validação básica
+
+Antes de entregar, verificar:
+
+1. App inicia sem erro visível.
+2. Página inicial abre.
+3. Navegação principal funciona.
+4. Login e logout funcionam.
+5. Formulários críticos submetem.
+6. Dados permanecem após refresh.
+7. Lista, detalhe e edição mostram dados consistentes.
+8. Erros têm mensagens úteis.
+9. Mobile não tem quebra bloqueante.
+
+## CRUD
+
+Para cada entidade: criar, listar, detalhar, editar, excluir/arquivar, atualizar página e checar permissões.
+
+## Contas e permissões
+
+Verifique admin, usuário comum, menu protegido, erros de senha, papéis e regras premium/basic/trial.
+
+## Fluxos de negócio
+
+Teste o fluxo real: ordem de serviço, ingresso, resgate animal, e-commerce/pedido ou qualquer fluxo central do usuário.
+
+## Formato de falha
+
+```text
+Falha:
+- Caminho:
+- Passos:
+- Esperado:
+- Atual:
+- Causa provável:
+- Arquivos a alterar:
+- Como retestar:
+```
+
+## Definição de pronto
+
+Fluxo central rodou, falhas conhecidas foram corrigidas ou listadas, itens corrigidos foram retestados e riscos restantes estão claros.

package/skills/delivery-acceptance/references/mobile-print-file.md

@@ -0,0 +1,19 @@
+# Mobile, Impressão, Arquivos e QR
+
+## Mobile
+
+Verifique navegação, tabelas, botões, formulários, link de WhatsApp e acesso externo sem ambiente local.
+
+## Impressão/PDF
+
+Verifique A4, margens, paginação, imagens, QR, valores, datas, status, download e mensagens de erro.
+
+Prefira template HTML/CSS com geração via navegador quando possível.
+
+## Upload
+
+Verifique tipos aceitos, múltiplas imagens, visualização após upload, persistência após refresh, privacidade e metadados.
+
+## QR Code
+
+Verifique exibição, unicidade, rota correta ao escanear, status usado/inválido, botão para ler outro QR e mensagens de erro.

package/skills/delivery-acceptance/references/playwright-smoke.md

@@ -0,0 +1,35 @@
+# Smoke Test com Playwright
+
+## Quando usar
+
+Use em Web apps quando o usuário pedir teste, correção de botão, validação de página, mobile ou entrega.
+
+## Cobertura mínima
+
+- Carregar home.
+- Login ou modo demo.
+- Navegar pelo fluxo principal.
+- Criar dado central.
+- Dar refresh e confirmar persistência.
+- Testar viewport mobile.
+
+## Viewports
+
+- Desktop: `1280x720`
+- Mobile: `390x844`
+
+## Seletores
+
+Prefira role, label, texto e test id. Evite classes CSS frágeis.
+
+## Quando não automatizar
+
+Se houver captcha, pagamento real, WhatsApp real ou aprovação externa, use mock/sandbox ou descreva validação manual. Não finja aprovação.
+
+## Evidências
+
+Capture prints de login, formulário, lista após submissão, detalhe, mobile e PDF/print quando aplicável.
+
+## Falhas
+
+Após falha, verifique DOM, URL, console, network, logs backend e escrita no banco.

package/skills/dependency-audit/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: dependency-audit
+description: >
+  Scans project dependencies for vulnerabilities, outdated packages, and unused deps.
+  Produces prioritized action report. Run before releases and periodically.
+  PrismX adaptation (vibe-coder-kit, MIT).
+---
+
+# Dependency Audit
+
+## When to trigger
+
+- Before production release
+- Monthly maintenance
+- After public CVE affecting your stack
+- Before onboarding new contributors
+
+## Process
+
+### 1. Detect ecosystems
+
+| File | Tool |
+|------|------|
+| `package.json` | npm / pnpm / yarn audit |
+| `composer.json` | composer audit |
+| `requirements.txt` / `pyproject.toml` | pip-audit / poetry |
+| `go.mod` | govulncheck |
+| `Cargo.toml` | cargo audit |
+
+Run applicable scanners for this repo only.
+
+### 2. Security scan
+
+Example (Node):
+
+```bash
+npm audit
+pnpm audit
+yarn audit
+```
+
+Capture critical/high findings with package name, path, advisory ID.
+
+### 3. Outdated packages
+
+```bash
+npm outdated
+composer outdated
+```
+
+Note major vs minor bumps — majors need changelog review.
+
+### 4. Unused dependencies (optional)
+
+Heuristic: dep not imported anywhere — flag for human review, do not auto-remove without confirmation.
+
+### 5. Write report
+
+`.prismx/audits/dependency-audit-YYYY-MM-DD.md`:
+
+```markdown
+# Dependency Audit — YYYY-MM-DD
+
+## Summary
+<n critical, n high, n outdated>
+
+## Critical / High
+| Package | Severity | Advisory | Suggested action |
+
+## Outdated (major)
+| Package | Current | Latest | Notes |
+
+## Recommended actions
+1. … (priority ordered)
+
+## Skipped / N/A
+<ecosystems not present>
+```
+
+### 6. Remediation
+
+- Apply patch/minor security fixes when low risk
+- Major upgrades → separate task with tests
+- Document accepted risk with expiry date if deferring
+
+## Rules
+
+- Never upgrade all deps blindly in one commit.
+- Run test suite after each security fix batch.
+- Record accepted risks in wiki (`knowledge-base-update` → `decision`).
+- Pair with `security-and-hardening` for app-level review.
+
+## PrismX integration
+
+- Release workflow: run before `shipping-and-launch`.
+- CVE incident → also `incident-response`.
+- Update `wiki/CHANGELOG.md` if dependency changes ship to production.