npm - @riligar/agents-kit - Versions diffs - 1.0.0 - Mend

@riligar/agents-kit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

package/.agent/skills/riligar-dev-seo/references/implementation.md ADDED Viewed

@@ -0,0 +1,215 @@
+# Implementação de SEO Técnico (React + Bun/Elysia)
+Esta referência detalha como implementar os elementos técnicos de SEO usando a stack RiLiGar.
+---
+## 1. Estrutura de Arquivos SEO
+```
+project/
+├── frontend/ (React/Vite)
+│   ├── public/
+│   │   ├── robots.txt       # Diretivas fixas
+│   │   ├── sitemap.xml      # Sitemap estático (se não for dinâmico)
+│   │   ├── og-image.png     # Imagem padrão de compartilhamento
+│   │   └── favicon.ico      # Ícone do navegador
+│   └── index.html           # Meta tags base
+└── backend/ (Bun/Elysia)
+    └── src/
+        └── routes/
+            └── seo.js       # Endpoints para sitemap dinâmico
+```
+---
+## 2. Metadados Globais (index.html)
+No projeto React/Vite, o `index.html` fornece o baseline:
+```html
+<!DOCTYPE html>
+<html lang="pt-BR">
+    <head>
+        <meta charset="UTF-8" />
+        <meta
+            name="viewport"
+            content="width=device-width, initial-scale=1.0"
+        />
+        <title>Nome da Marca — Tagline Curta e Assertiva</title>
+        <meta
+            name="description"
+            content="Descrição de 155 caracteres que inclui a palavra-chave principal e uma chamada para ação clara."
+        />
+        <!-- OpenGraph (Redes Sociais) -->
+        <meta
+            property="og:type"
+            content="website"
+        />
+        <meta
+            property="og:url"
+            content="https://suadominio.com/"
+        />
+        <meta
+            property="og:title"
+            content="Nome da Marca — Tagline"
+        />
+        <meta
+            property="og:description"
+            content="Descrição expandida para redes sociais."
+        />
+        <meta
+            property="og:image"
+            content="https://suadominio.com/og-image.png"
+        />
+        <meta
+            property="og:site_name"
+            content="Nome da Marca"
+        />
+        <!-- Twitter -->
+        <meta
+            name="twitter:card"
+            content="summary_large_image"
+        />
+        <meta
+            name="twitter:title"
+            content="Nome da Marca — Tagline"
+        />
+        <meta
+            name="twitter:description"
+            content="Descrição para o Twitter."
+        />
+        <meta
+            name="twitter:image"
+            content="https://suadominio.com/og-image.png"
+        />
+        <!-- Canonical URL -->
+        <link
+            rel="canonical"
+            href="https://suadominio.com/"
+        />
+    </head>
+    <body>
+        <div id="root"></div>
+        <script
+            type="module"
+            src="/src/main.jsx"
+        ></script>
+    </body>
+</html>
+```
+---
+## 3. Sitemap Dinâmico com Elysia
+Se houver posts de blog ou produtos, o backend deve gerar o XML:
+```javascript
+// backend/src/services/seo.js
+import { db } from '../database'
+export const generateSitemap = async baseUrl => {
+    const posts = await db.query.posts.findMany({
+        where: (posts, { eq }) => eq(posts.published, true),
+    })
+    const urls = [
+        { loc: `${baseUrl}/`, priority: '1.0' },
+        { loc: `${baseUrl}/pricing`, priority: '0.8' },
+        { loc: `${baseUrl}/about`, priority: '0.7' },
+    ]
+    posts.forEach(post => {
+        urls.push({
+            loc: `${baseUrl}/blog/${post.slug}`,
+            lastmod: post.updatedAt.toISOString().split('T')[0],
+            priority: '0.6',
+        })
+    })
+    const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+    ${urls
+        .map(
+            u => `
+    <url>
+        <loc>${u.loc}</loc>
+        ${u.lastmod ? `<lastmod>${u.lastmod}</lastmod>` : ''}
+        <priority>${u.priority}</priority>
+    </url>`
+        )
+        .join('')}
+</urlset>`
+    return xml
+}
+// backend/src/routes/seo.js
+import { Elysia } from 'elysia'
+import { generateSitemap } from '../services/seo'
+export const seoRoutes = new Elysia().get('/sitemap.xml', async ({ set }) => {
+    const baseUrl = process.env.SITE_URL || 'https://example.com'
+    const xml = await generateSitemap(baseUrl)
+    set.headers['Content-Type'] = 'application/xml'
+    return xml
+})
+```
+---
+## 4. Robots.txt (Frontend `public/robots.txt`)
+```text
+User-agent: *
+Allow: /
+# Evitar que crawlers indexem logs ou áreas administrativas
+Disallow: /api/
+Disallow: /dashboard/
+Disallow: /admin/
+Disallow: /settings/
+# Bloquear bots de treinamento de IA (Opcional, mas recomendado para RiLiGar)
+User-agent: GPTBot
+Disallow: /
+User-agent: ChatGPT-User
+Disallow: /
+User-agent: CCBot
+Disallow: /
+User-agent: anthropic-ai
+Disallow: /
+User-agent: Google-Extended
+Disallow: /
+Sitemap: https://suadominio.com/sitemap.xml
+```
+---
+## 5. Middleware de Autenticação
+Certifique-se de que as rotas de SEO estão liberadas:
+```javascript
+// Exemplo no backend/Elysia se houver middleware global
+const isPublicRoute = path => {
+    const publics = ['/sitemap.xml', '/robots.txt', '/.well-known/']
+    return publics.some(p => path.startsWith(p))
+}
+```
+---
+## 6. Otimização de Imagens para SEO
+- **Formato:** Use `.webp` para imagens de conteúdo.
+- **Lazy Loading:** `loading="lazy"` em todas as imagens fora da dobra inicial.
+- **Alt Text:** Sempre inclua `alt="descrição da imagem"` para acessibilidade e crawlers.
+- **OG Image:** Deve ter 1200x630px, preferencialmente formato `.png` ou `.jpg`.

package/.agent/skills/riligar-dev-seo/references/structured-data.md ADDED Viewed

@@ -0,0 +1,119 @@
+# Dados Estruturados (JSON-LD)
+Dados estruturados ajudam os motores de busca a entender seu conteúdo e habilitam "rich snippets" nos resultados de pesquisa.
+---
+## Implementação
+### Tag de Script
+Em projetos React ou HTML puro, os dados estruturados são inseridos via uma tag `<script>` no `<head>` ou próximo ao conteúdo relevante.
+```html
+<script type="application/ld+json">
+    {
+        "@context": "https://schema.org",
+        "@type": "Organization",
+        "name": "RiLiGar",
+        "url": "https://riligar.com",
+        "logo": "https://riligar.com/logo.png",
+        "sameAs": ["https://twitter.com/riligar", "https://linkedin.com/company/riligar"]
+    }
+</script>
+```
+### Dinâmico com React
+```javascript
+// Exemplo de componente simples
+export function JsonLd({ data }) {
+    return (
+        <script
+            type="application/ld+json"
+            dangerouslySetInnerHTML={{ __html: JSON.stringify(data) }}
+        />
+    )
+}
+```
+---
+## Templates de Schema
+### Organização (Homepage)
+```javascript
+const organizationSchema = {
+    '@context': 'https://schema.org',
+    '@type': 'Organization',
+    name: 'Nome da Marca',
+    url: 'https://seudominio.com',
+    logo: 'https://seudominio.com/logo.png',
+    description: 'Descrição breve da empresa.',
+    foundingDate: '2025',
+    sameAs: ['https://twitter.com/marca', 'https://linkedin.com/company/marca'],
+}
+```
+### WebSite (Search Box)
+```javascript
+const websiteSchema = {
+    '@context': 'https://schema.org',
+    '@type': 'WebSite',
+    name: 'Nome da Marca',
+    url: 'https://seudominio.com',
+    potentialAction: {
+        '@type': 'SearchAction',
+        target: 'https://seudominio.com/search?q={search_term_string}',
+        'query-input': 'required name=search_term_string',
+    },
+}
+```
+### SoftwareApplication (SaaS)
+```javascript
+const softwareSchema = {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: 'RiLiGar Autopilot',
+    applicationCategory: 'BusinessApplication',
+    operatingSystem: 'Web',
+    offers: {
+        '@type': 'Offer',
+        price: '0.00',
+        priceCurrency: 'USD',
+    },
+    aggregateRating: {
+        '@type': 'AggregateRating',
+        ratingValue: '4.8',
+        ratingCount: '150',
+    },
+}
+```
+### Article (Blog Posts)
+```javascript
+const articleSchema = {
+    '@context': 'https://schema.org',
+    '@type': 'Article',
+    headline: 'Título do Artigo',
+    image: ['https://seudominio.com/blog/capa.jpg'],
+    datePublished: '2025-01-20T08:00:00+00:00',
+    dateModified: '2025-01-20T10:00:00+00:00',
+    author: {
+        '@type': 'Person',
+        name: 'Autor Nome',
+    },
+}
+```
+---
+## Ferramentas de Teste
+1. **Google Rich Results Test**: [Acesse aqui](https://search.google.com/test/rich-results)
+2. **Schema.org Validator**: [Acesse aqui](https://validator.schema.org/)

package/.agent/skills/riligar-infrastructure/SKILL.md ADDED Viewed

@@ -0,0 +1,126 @@
+---
+name: riligar-infrastructure
+description: Especialista em Infraestrutura da RiLiGar. Use para configurar deployments no Fly.io, DNS e proxying no Cloudflare, e garantir padrões de infraestrutura e deployment.
+license: Apache-2.0
+metadata:
+    author: riligar
+    version: '1.0'
+---
+# RiLiGar Infrastructure Expert
+Você é um especialista em infraestrutura seguindo os padrões da RiLiGar. Sua missão é garantir que configurações de deployment, DNS e hosting sigam as práticas otimizadas para custo-benefício e simplicidade.
+## 1. Filosofia de Infraestrutura
+- **Simplicidade:** Configurações mínimas e eficientes.
+- **Custo-benefício:** Uso de recursos compartilhados onde possível.
+- **Portabilidade:** Evitar vendor lock-in excessivo.
+- **Observabilidade:** Logs e métricas acessíveis.
+## 2. Cloudflare
+### DNS & Proxying
+- **Modo Proxy:** Sempre ativado (orange cloud) para domínios de produção.
+- **SSL/TLS:** Full (strict) mode.
+- **Cache:** Respeitar headers da origem por padrão.
+### Configuração de DNS
+```
+# Exemplo para subdomínio apontando para Fly.io
+tipo: CNAME
+nome: app
+conteúdo: <app-name>.fly.dev
+proxy: ativado
+```
+## 3. Fly.io
+### Configuração Padrão de VM
+```toml
+[vm]
+  cpu_kind = 'shared'
+  memory = '512mb'
+  cpus = 2
+```
+### Volume de Dados
+```toml
+[mounts]
+  source = "data_volume"
+  destination = "/app/data"
+```
+### Estrutura fly.toml Básica
+```toml
+app = '<app-name>'
+primary_region = 'iad'
+[build]
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = 'off'
+  auto_start_machines = true
+  min_machines_running = 1
+[vm]
+  cpu_kind = 'shared'
+  memory = '512mb'
+  cpus = 2
+[mounts]
+  source = "data_volume"
+  destination = "/app/data"
+```
+## 4. Comandos Essenciais Fly.io
+```bash
+# Deploy
+fly deploy
+# Criar volume (antes do primeiro deploy com mount)
+fly volumes create data_volume --region iad --size 1
+# Ver logs
+fly logs
+# SSH na máquina
+fly ssh console
+# Secrets
+fly secrets set KEY=value
+fly secrets list
+```
+## 5. Regras de Deployment
+1. **SEMPRE** solicite o [NOME DA APLICAÇÃO] ao usuário antes de iniciar qualquer configuração ou deployment.
+2. **SEMPRE** use região `iad` (Virginia) como primary_region.
+3. **SEMPRE** configure `force_https = true` para production.
+4. **SEMPRE** crie volumes antes do primeiro deploy se usar mounts.
+5. **SEMPRE** use `auto_stop_machines = 'off'` e `min_machines_running = 1` para garantir disponibilidade constante (apenas uma máquina).
+6. **EVITE** máquinas dedicadas; comece com shared.
+7. **SEMPRE** configure GitHub Actions (`.github/workflows/deploy.yml`) para realizar o deploy automático no Fly.io a cada push na branch principal.
+    - **PROCESSO:** Gere o token via CLI (`fly tokens create deploy -a <app-name>`) e coloque o valor diretamente no campo `FLY_API_TOKEN` do arquivo `deploy.yml`.
+8. **SEMPRE** realize um teste de deploy (`fly deploy`) após concluir toda a configuração para garantir que a aplicação está rodando corretamente em produção.
+9. **SEMPRE** verifique se a conta logada no Fly.io (`fly auth whoami`) corresponde aos dados na seção `Flyer` do `README.md` do projeto antes de qualquer operação.
+## 6. Multi-Account Management (Flyer)
+Para lidar com múltiplas contas Fly.io no mesmo ambiente:
+1. Verifique as credenciais no `README.md` do repositório (Seção `Flyer`).
+2. Confirme o usuário logado: `fly auth whoami`.
+3. Se necessário, troque de conta: `fly auth logout` seguido de `fly auth login`.
+## 7. Referências
+Para configurações detalhadas, consulte `references/infrastructure.md`.

package/.agent/skills/riligar-infrastructure/references/infrastructure.md ADDED Viewed

@@ -0,0 +1,229 @@
+# RiLiGar Infrastructure Reference
+Documentação detalhada das configurações de infraestrutura.
+## Fly.io
+### fly.toml Completo
+```toml
+# Configuração padrão RiLiGar para Fly.io
+app = '<app-name>'
+primary_region = 'iad'
+[build]
+  # Usa Dockerfile por padrão
+[env]
+  NODE_ENV = 'production'
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = 'off'
+  auto_start_machines = true
+  min_machines_running = 1
+  processes = ['app']
+  [http_service.concurrency]
+    type = 'connections'
+    hard_limit = 25
+    soft_limit = 20
+[[http_service.checks]]
+  interval = '10s'
+  timeout = '2s'
+  grace_period = '5s'
+  method = 'GET'
+  path = '/health'
+[vm]
+  cpu_kind = 'shared'
+  memory = '512mb'
+  cpus = 2
+[mounts]
+  source = 'data_volume'
+  destination = '/app/data'
+```
+### Volumes
+```bash
+# Criar volume de 1GB
+fly volumes create data_volume --region iad --size 1
+# Listar volumes
+fly volumes list
+# Estender volume
+fly volumes extend <volume-id> --size 3
+```
+### Secrets
+```bash
+# Definir secrets
+fly secrets set DATABASE_URL="..." JWT_SECRET="..."
+# Listar secrets
+fly secrets list
+# Remover secret
+fly secrets unset SECRET_NAME
+```
+### Deploy & Monitoramento
+```bash
+# Deploy com build
+fly deploy
+# Deploy sem cache
+fly deploy --no-cache
+# Ver status
+fly status
+# Ver logs em tempo real
+fly logs
+# SSH na máquina
+fly ssh console
+# Executar comando remoto
+fly ssh console -C "ls -la /app/data"
+```
+### Scaling
+````bash
+# Ver máquinas
+fly machines list
+# Parar todas máquinas
+fly scale count 0
+# Iniciar máquinas
+fly scale count 1
+### Gerenciamento de Contas
+```bash
+# Verificar usuário logado
+fly auth whoami
+# Login em uma conta específica
+fly auth login
+# Logout da conta atual
+fly auth logout
+# Listar aplicativos da conta logada
+fly apps list
+````
+```
+---
+## Cloudflare
+### Configuração DNS
+| Tipo  | Nome | Conteúdo          | Proxy |
+| ----- | ---- | ----------------- | ----- |
+| CNAME | app  | myapp.fly.dev     | ✓     |
+| CNAME | api  | myapi.fly.dev     | ✓     |
+| A     | @    | 192.0.2.1         | ✓     |
+| MX    | @    | mail.provedor.com | ✗     |
+### SSL/TLS Settings
+- **Mode:** Full (strict)
+- **Minimum TLS Version:** 1.2
+- **Always Use HTTPS:** On
+- **Automatic HTTPS Rewrites:** On
+### Cache Rules
+- Por padrão, respeitar headers de cache da origem
+- Para assets estáticos, usar TTL de 1 ano
+### Security Headers (via Transform Rules)
+```
+X-Content-Type-Options: nosniff
+X-Frame-Options: DENY
+X-XSS-Protection: 1; mode=block
+Referrer-Policy: strict-origin-when-cross-origin
+````
+---
+## GitHub Actions CI/CD
+### Deploy para Fly.io (Template)
+Crie o arquivo em `.github/workflows/deploy.yml`:
+```yaml
+name: Deploy
+on:
+  push:
+    branches:
+      - main # ou master
+jobs:
+  deploy:
+    name: Deploy app
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: superfly/flyctl-actions/setup-flyctl@master
+      - run: flyctl deploy --remote-only
+        env:
+          FLY_API_TOKEN: "SEU_FLY_TOKEN_AQUI"
+```
+**Nota:** Para gerar o token e colocá-lo no arquivo, siga estes passos:
+1. Execute: `fly tokens create deploy -a <app-name>`
+2. Copie o token gerado.
+3. Cole o valor no campo `FLY_API_TOKEN` acima.
+Isso facilita a manutenção técnica em repositórios privados da RiLiGar.
+---
+## Dockerfile Padrão (Bun)
+```dockerfile
+FROM oven/bun:1
+WORKDIR /app
+COPY package.json bun.lock* ./
+RUN bun install --frozen-lockfile --production
+COPY . .
+EXPOSE 3000
+CMD ["bun", "run", "src/index.js"]
+````
+---
+## Checklist de Deploy
+- [ ] Dockerfile configurado e testado localmente
+- [ ] `fly.toml` com configurações corretas
+- [ ] Volume criado (se necessário)
+- [ ] Secrets configurados
+- [ ] DNS no Cloudflare apontando para Fly.io
+- [ ] SSL/TLS em modo Full (strict)
+- [ ] Health check endpoint implementado
+- [ ] Usuário logado confere com a seção `Flyer` do `README.md`
+- [ ] **Realizar teste de deploy (`fly deploy`) e validar funcionamento**