@seedgrid/ai-toolkit 0.0.0-stage → 0.3.0

package/seedgridKB/SeedGrid/Versoes.md

@@ -0,0 +1,64 @@
+---
+tags: [seedgrid, versoes, gerado]
+gerado-por: scripts/kb-versions.mjs
+gerado-em: 2026-10-15
+---
+
+# Versões documentadas × atuais
+
+> Nota **gerada por script** a partir dos poms, `package.json`, `Cargo.toml` e do git. Não edite à mão: rode `node scripts/kb-versions.mjs --write`.
+
+## Como usar
+
+- **Documentada**: versão do artefato no commit que as notas da KB declaram descrever (`commit` no frontmatter).
+- **Atual**: versão no repositório de origem hoje. **Publicada**: última versão no Maven Central / npm.
+- Compare a **Documentada** com a versão que o seu projeto usa (`pom.xml` / `package.json`). Se forem diferentes, as notas podem não refletir o comportamento do projeto: confirme no código, no jar ou no pacote e avise.
+- **Situação** compara o código atual com o commit documentado, ignorando testes, documentação e lockfiles. "Defasada" significa que a nota precisa de revisão; não significa que está errada.
+- Em Java, `groupId` é `br.com.seedgrid`; versões são datas (`yyyy.MM.dd`, com sufixo `-N` a partir da segunda publicação do dia) e **não são sincronizadas entre módulos**.
+
+## Java / Quarkus
+
+| Módulo | Artefatos (artifactId) | Documentada | Atual | Publicada | Situação |
+|---|---|---|---|---|---|
+| [[SeedGrid/Extensions/ai-pricing/Visao-geral\|ext-ai-pricing]] | `seedgrid-ai-pricing`, `seedgrid-ai-pricing-parent` | `2026.10.13` | `2026.10.14` | `2026.10.14` | **defasada**: 4 arquivo(s) de código mudaram em 1 commit(s); versão mudou 2026.10.13 → 2026.10.14 |
+| [[SeedGrid/Extensions/apikeys/Visao-geral\|ext-apikeys]] | `seedgrid-apikeys`, `seedgrid-apikeys-parent` | `2026.10.09` | `2026.10.14` | `2026.10.14` | **defasada**: 4 arquivo(s) de código mudaram em 1 commit(s); versão mudou 2026.10.09 → 2026.10.14 |
+| [[SeedGrid/Extensions/audit/Visao-geral\|ext-audit]] | `seedgrid-audit`, `seedgrid-audit-core`, `seedgrid-audit-mongodb`, `seedgrid-audit-postgresql` | `2026.09.25` | `2026.09.25` | `2026.09.25` | em dia; alterações locais não commitadas |
+| [[SeedGrid/Extensions/backup/Visao-geral\|ext-backup]] | `seedgrid-backup`, `seedgrid-backup-parent` | `2026.10.09` | `2026.10.09` | `2026.10.09` | em dia; alterações locais não commitadas |
+| [[SeedGrid/Extensions/billing/Visao-geral\|ext-billing]] | `seedgrid-billing`, `seedgrid-billing-core`, `seedgrid-billing-stripe` | `2026.10.14` | `2026.10.14-1` | `2026.10.14-1` | **defasada**: 8 arquivo(s) de código mudaram em 1 commit(s); versão mudou 2026.10.14 → 2026.10.14-1 |
+| [[SeedGrid/Extensions/exchange/Visao-geral\|ext-exchange]] | `seedgrid-exchange`, `seedgrid-exchange-parent` | `2026.10.13` | `2026.10.14` | `2026.10.14` | **defasada**: 4 arquivo(s) de código mudaram em 1 commit(s); versão mudou 2026.10.13 → 2026.10.14 |
+| [[SeedGrid/Extensions/login-tenancy/Visao-geral\|ext-login-tenancy]] | `seedgrid-login-tenancy`, `seedgrid-login-tenancy-parent` | `2026.10.14` | `2026.10.14-1` | `2026.10.14-1` | **defasada**: 3 arquivo(s) de código mudaram em 2 commit(s); versão mudou 2026.10.14 → 2026.10.14-1 |
+| [[SeedGrid/Extensions/notification/Visao-geral\|ext-notification]] | `seedgrid-notification`, `seedgrid-notification-api`, `seedgrid-notification-parent` | `2026.10.13` | `2026.10.15` | `2026.10.15` | **defasada**: 7 arquivo(s) de código mudaram em 2 commit(s); versão mudou 2026.10.13 → 2026.10.15 |
+| [[SeedGrid/Extensions/realtime/Visao-geral\|ext-realtime]] | `seedgrid-realtime`, `seedgrid-realtime-parent` | `2026.10.08` | `2026.10.08` | `2026.10.08` | em dia |
+| [[SeedGrid/Extensions/resilience/Visao-geral\|ext-resilience]] | `seedgrid-resilience-core`, `seedgrid-resilience-core-parent` | `2026.10.13` | `2026.10.13` | `2026.10.13` | em dia; alterações locais não commitadas |
+| [[SeedGrid/Extensions/security/Visao-geral\|ext-security]] | `seedgrid-security`, `seedgrid-security-parent` | `2026.10.13` | `2026.10.14` | `2026.10.14` | **defasada**: 7 arquivo(s) de código mudaram em 1 commit(s); versão mudou 2026.10.13 → 2026.10.14 |
+| [[SeedGrid/Extensions/subdomain-tenancy/Visao-geral\|ext-subdomain-tenancy]] | `seedgrid-subdomain-tenancy`, `seedgrid-subdomain-tenancy-parent` | `2026.10.14` | `2026.10.14-1` | `2026.10.14-1` | **defasada**: 3 arquivo(s) de código mudaram em 2 commit(s); versão mudou 2026.10.14 → 2026.10.14-1 |
+| [[SeedGrid/Extensions/whatsapp/Visao-geral\|ext-whatsapp]] | `seedgrid-whatsapp`, `seedgrid-whatsapp-core`, `seedgrid-whatsapp-core-deployment`, `seedgrid-whatsapp-evolution`, `seedgrid-whatsapp-whatsapp-cloud` | `2026.08.16` | `2026.08.16` | `2026.08.16` | em dia; alterações locais não commitadas |
+| [[SeedGrid/Extensions/cache/Visao-geral\|lib-cache]] | `seedgrid-cache`, `seedgrid-cache-core`, `seedgrid-cache-dragonfly`, `seedgrid-cache-redis`, `seedgrid-cache-valkey` | `2026.10.13` | `2026.10.13` | `2026.10.13` | em dia; alterações locais não commitadas |
+| [[SeedGrid/Extensions/commons/Visao-geral\|lib-commons]] | `seedgrid-commons` | `2026.10.08` | `2026.10.08` | `2026.10.08` | em dia; alterações locais não commitadas |
+| [[SeedGrid/Extensions/filemanagement/Visao-geral\|lib-filemanagement]] | `seedgrid-filemanagement` | `2026.07.08` | `2026.07.08` | `2026.07.08` | em dia; alterações locais não commitadas |
+| [[SeedGrid/Extensions/privacy/Visao-geral\|lib-privacy]] | `seedgrid-privacy` | `2026.07.27` | `2026.07.27` | `2026.07.27` | em dia; alterações locais não commitadas |
+
+## Front-end (npm)
+
+| Pacote | Documentada | Atual | Publicada | Situação |
+|---|---|---|---|---|
+| `@seedgrid/fe-apikeys` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-audit` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-backup` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-billing-platform` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-billing-user` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-login-tenancy` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-security` | `2026.7.3` | `2026.7.3` | `2026.10.0` | em dia |
+| `@seedgrid/fe-self-enter` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-subdomain-tenancy` | `2026.7.0` | `2026.7.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-commons` | `0.2.0` | `0.2.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-components` | `2026.7.1` | `2026.7.1` | `2026.10.0` | em dia |
+| `@seedgrid/fe-core` | `2026.7.1` | `2026.7.1` | `2026.10.0` | em dia |
+| `@seedgrid/fe-playground` | `0.1.0` | `0.1.0` | `2026.10.0` | em dia |
+| `@seedgrid/fe-theme` | `0.3.0` | `0.3.0` | `2026.10.0` | em dia |
+
+## Rust
+
+| Crates | Documentada | Atual | Situação |
+|---|---|---|---|
+| seedgrid-rust-crate-* (workspace) | `2026.7.27` | `2026.10.14` | **defasada**: 4 arquivo(s) de código mudaram em 1 commit(s); versão mudou 2026.7.27 → 2026.10.14 |

package/seedgridKB/SeedGrid/Visao-geral.md

@@ -0,0 +1,35 @@
+---
+tags: [seedgrid, visao-geral, indice]
+fonte: seedgrid-platform
+analisado-em: 2026-10-14
+---
+
+# SeedGrid — visão geral
+
+Base de documentação técnica do ecossistema SeedGrid, gerada a partir do código em `seedgrid-platform` em **2026-10-14**. Commits analisados por repositório: [[SeedGrid/Mapa-dos-repositorios|Mapa dos repositórios]].
+
+## O ecossistema em uma frase por frente
+
+| Frente | Onde | O que é |
+|---|---|---|
+| Extensions e libraries Java | `java/seedgrid-quarkus-*` | Blocos reutilizáveis para apps Quarkus 3.30: segurança (JWT/RBAC/2FA), API keys, multitenancy (login e subdomínio), billing, auditoria, backup/export, notificações, realtime, resiliência, WhatsApp, cache, privacidade, storage, câmbio e preços de IA. |
+| Crates Rust | `rust/` | Portes 1:1 das extensions para servidores Axum (Java é a fonte da verdade), mais `broker` (mensageria) e `runtime`/`macros` (auto-wiring estilo CDI). |
+| Front-end | `front/seedgrid-fe-components` | Biblioteca React `@seedgrid/fe-components` (componentes `Sg*`), tema, core de módulos, playground e módulos de tela `@seedgrid/fe-*` que consomem as APIs das extensions. |
+
+## Por onde começar
+
+- **Esqueci o nome de uma propriedade** → [[SeedGrid/Extensions/Catalogo-de-propriedades|Catálogo de propriedades]] (busque com `Ctrl+F` ou pela busca do Obsidian).
+- **Quais valores um enum aceita / o que cada valor faz** → [[SeedGrid/Extensions/Catalogo-de-enums|Catálogo de enums]].
+- **Quero entender uma extension** → [[SeedGrid/Extensions/Indice|Índice das extensions]].
+- **Quero usar um componente React** → [[SeedGrid/SeedGrid-components/Indice|Índice dos componentes]].
+- **Quero saber o que depende do quê** → [[SeedGrid/Mapa-dos-repositorios|Mapa dos repositórios]].
+- **Qual versão do artefato esta documentação descreve** (e se o seu projeto usa outra) → [[SeedGrid/Versoes|Versões documentadas × atuais]].
+
+## Convenções desta base
+
+- Cada nota tem frontmatter com `fonte`, `branch`, `commit` e `analisado-em`.
+- Grau de certeza: **Confirmado** (lido no código ou teste), **Inferência** (deduzido, com justificativa), **Não confirmado**.
+- 🔒 marca propriedades sensíveis; os valores aparecem sempre como placeholders.
+- Caminhos de fonte são relativos a `seedgrid-platform/`.
+- Só entra aqui o que funciona: propriedade, prop ou variável declarada e nunca lida não é documentada.
+- Regras de manutenção: `AGENTS.md` na raiz do vault.

package/seedgridKB/manifest.json

@@ -0,0 +1,142 @@
+{
+  "schemaVersion": 2,
+  "contentVersion": "0.3.0",
+  "toolkitBase": "SeedGrid/Toolkit",
+  "components": [
+    {
+      "id": "agents",
+      "type": "agents",
+      "files": [
+        "agents/arquiteto.md",
+        "agents/backend-java.md",
+        "agents/backend-rust.md",
+        "agents/frontend-react.md",
+        "agents/qa.md",
+        "agents/revisor.md"
+      ]
+    },
+    {
+      "id": "rules",
+      "type": "rules",
+      "files": [
+        "rules/coordenacao.md",
+        "rules/formato-entrega.md",
+        "rules/personalizacao-local.md",
+        "rules/frontend-seedgrid.md",
+        "rules/backend-java-seedgrid.md"
+      ]
+    },
+    {
+      "id": "templates",
+      "type": "templates",
+      "files": [
+        "templates/especificacao-tarefa.md",
+        "templates/decisao-arquitetura.md",
+        "templates/relatorio-validacao.md"
+      ]
+    },
+    {
+      "id": "references",
+      "type": "references",
+      "files": [
+        "references/modos-shared-native.md",
+        "references/glossario.md",
+        "references/fluxo-de-trabalho.md"
+      ]
+    },
+    {
+      "id": "skill:planejar-mudanca",
+      "type": "skill",
+      "name": "planejar-mudanca",
+      "files": [
+        "SKILL.md",
+        {
+          "path": "assets/especificacao-tarefa.md",
+          "from": "templates/especificacao-tarefa.md"
+        }
+      ]
+    },
+    {
+      "id": "skill:revisar-codigo",
+      "type": "skill",
+      "name": "revisar-codigo",
+      "files": [
+        "SKILL.md",
+        "references/checklist.md"
+      ]
+    },
+    {
+      "id": "skill:validar-mudanca",
+      "type": "skill",
+      "name": "validar-mudanca",
+      "files": [
+        "SKILL.md",
+        {
+          "path": "assets/relatorio-validacao.md",
+          "from": "templates/relatorio-validacao.md"
+        }
+      ]
+    },
+    {
+      "id": "skill:seedgrid-backend-crud",
+      "type": "skill",
+      "name": "seedgrid-backend-crud",
+      "files": [
+        "SKILL.md"
+      ]
+    },
+    {
+      "id": "skill:seedgrid-crud",
+      "type": "skill",
+      "name": "seedgrid-crud",
+      "files": [
+        "SKILL.md",
+        "references/patterns.md",
+        "references/routing.md",
+        "references/checklist.md",
+        "agents/openai.yaml"
+      ]
+    },
+    {
+      "id": "skill:seedgrid-new-screen",
+      "type": "skill",
+      "name": "seedgrid-new-screen",
+      "files": [
+        "SKILL.md",
+        "references/steps.md",
+        "references/checklist.md",
+        "agents/openai.yaml"
+      ]
+    },
+    {
+      "id": "skill:seedgrid-bump",
+      "type": "skill",
+      "name": "seedgrid-bump",
+      "files": [
+        "SKILL.md"
+      ]
+    },
+    {
+      "id": "skill:seedgrid-review",
+      "type": "skill",
+      "name": "seedgrid-review",
+      "files": [
+        "SKILL.md"
+      ]
+    },
+    {
+      "id": "brain",
+      "type": "brain",
+      "base": "SeedGrid",
+      "entrypoints": [
+        "Visao-geral.md",
+        "Versoes.md",
+        "Extensions/Catalogo-de-propriedades.md",
+        "Extensions/Catalogo-de-enums.md",
+        "Extensions/Indice.md",
+        "SeedGrid-components/Indice.md",
+        "Mapa-dos-repositorios.md"
+      ]
+    }
+  ]
+}