@riligar/agents-kit 1.19.0 → 1.20.1

package/.agent/rules/naming-conventions.md

@@ -4,18 +4,18 @@ Consistent naming across all RiLiGar projects.
 
 ## Quick Reference
 
-| Element | Convention | Example |
-| --- | --- | --- |
-| Components | PascalCase | `UserProfile`, `NavBar` |
-| Functions | camelCase | `getUserData`, `handleSubmit` |
-| Variables | camelCase | `userName`, `isLoading` |
-| Constants | SCREAMING_SNAKE | `API_URL`, `MAX_RETRIES` |
-| Files (components) | PascalCase | `UserProfile.jsx` |
-| Files (utilities) | camelCase | `formatDate.js` |
-| Directories | kebab-case | `user-profile/`, `api-utils/` |
-| CSS classes | kebab-case | `nav-bar`, `user-card` |
-| Database tables | snake_case | `user_profiles`, `order_items` |
-| API endpoints | kebab-case | `/api/user-profiles`, `/api/order-items` |
+| Element            | Convention      | Example                                  |
+| ------------------ | --------------- | ---------------------------------------- |
+| Components         | PascalCase      | `UserProfile`, `NavBar`                  |
+| Functions          | camelCase       | `getUserData`, `handleSubmit`            |
+| Variables          | camelCase       | `userName`, `isLoading`                  |
+| Constants          | SCREAMING_SNAKE | `API_URL`, `MAX_RETRIES`                 |
+| Files (components) | PascalCase      | `UserProfile.jsx`                        |
+| Files (utilities)  | camelCase       | `formatDate.js`                          |
+| Directories        | kebab-case      | `user-profile/`, `api-utils/`            |
+| CSS classes        | kebab-case      | `nav-bar`, `user-card`                   |
+| database tables    | snake_case      | `user_profiles`, `order_items`           |
+| API endpoints      | kebab-case      | `/api/user-profiles`, `/api/order-items` |
 
 ## Components
 
@@ -59,8 +59,8 @@ const MAX_RETRY_ATTEMPTS = 3
 const DEFAULT_PAGE_SIZE = 20
 
 // Bad
-const apiBaseUrl = 'https://api.example.com'  // camelCase
-const maxRetryAttempts = 3                    // camelCase
+const apiBaseUrl = 'https://api.example.com' // camelCase
+const maxRetryAttempts = 3 // camelCase
 ```
 
 ## Booleans
@@ -131,10 +131,10 @@ src/
     └── api.js
 ```
 
-## Database and API
+## database and API
 
 ```javascript
-// Database tables - snake_case
+// database tables - snake_case
 // user_profiles, order_items, payment_transactions
 
 // API endpoints - kebab-case
@@ -162,7 +162,7 @@ const htmlContent = '<div>...</div>'
 const xmlParser = new Parser()
 
 // Bad
-const userID = 123    // ID should be Id
+const userID = 123 // ID should be Id
 const APIURL = '/api' // Should be ApiUrl
 const HTMLContent = '<div>...</div>'
 ```

package/.agent/skills/riligar-dev-auth-react/SKILL.md

@@ -11,10 +11,10 @@ This skill provides a complete workflow for integrating authentication and permi
 
 ### 1. Installation
 
-Install the SDK using bun (preferred) or npm:
+Install the SDK and its core dependencies (Mantine & Tabler Icons) using bun:
 
 ```bash
-bun add @riligar/auth-react
+bun add @riligar/auth-react @mantine/core @mantine/hooks @mantine/notifications @tabler/icons-react
 ```
 
 ### 2. Environment Variables
@@ -34,19 +34,29 @@ VITE_AUTH_API_KEY=pk_live_your_public_key
 
 ### 3. AuthProvider Setup
 
-Wrap your application (usually in `main.jsx` or `App.jsx`) with the `AuthProvider`.
+Wrap your application (usually in `main.jsx` or `App.jsx`) with the `AuthProvider` and `MantineProvider`.
 
 ```jsx
 import { AuthProvider } from '@riligar/auth-react'
+import { MantineProvider } from '@mantine/core'
 
 ReactDOM.createRoot(document.getElementById('root')).render(
-    <AuthProvider apiKey={import.meta.env.VITE_AUTH_API_KEY}>
-        <App />
-    </AuthProvider>
+    <MantineProvider theme={yourTheme}>
+        <AuthProvider apiKey={import.meta.env.VITE_AUTH_API_KEY}>
+            <App />
+        </AuthProvider>
+    </MantineProvider>
 )
 ```
 
-For more setup patterns, see [setup-snippets.js](assets/setup-snippets.js).
+## Ready-to-Use Templates
+
+Use these assets to quickly scaffold a complete authentication flow:
+
+- **Routing Architecture**: Comprehensive [routes.jsx](assets/routes.jsx) showing Public vs Protected patterns.
+- **Login & Signup**: Generic [signin.jsx](assets/signin.jsx) and [signup.jsx](assets/signup.jsx) templates.
+- **Email Verification**: [verify-email.jsx](assets/verify-email.jsx) handler.
+- **Utility Wrappers**: [auth-loader.jsx](assets/auth-loader.jsx), [require-feature.jsx](assets/require-feature.jsx), and [layout.jsx](assets/layout.jsx).
 
 ## Specialized Guides
 
@@ -64,25 +74,21 @@ Use `useAuth()` to access user data and authentication status.
 const { user, isAuthenticated, loading } = useAuth()
 ```
 
-### Adding a Login Form
-
-Simply drop the `<SignIn />` component. Use `variant="modal"` if you want it in a popup.
-
-```jsx
-<SignIn />
-// or
-<SignIn variant="modal" opened={isOpen} onClose={() => setIsOpen(false)} />
-```
-
 ### Protecting a Dashboard
 
-Wrap your sub-routes with `<Protect />`.
+The recommended pattern is to use the **Protected Group** pattern with React Router as shown in [routes.jsx](assets/routes.jsx).
 
 ```jsx
-<Route element={<Protect redirectTo="/login" />}>
+// Nested routes under <Protect /> guarantee that all sub-routes are guarded.
+<Route element={<Protect fallback={<AuthLoader />} />}>
     <Route
-        path="/dashboard"
-        element={<Dashboard />}
-    />
+        path="/"
+        element={<Layout />}
+    >
+        <Route
+            index
+            element={<Home />}
+        />
+    </Route>
 </Route>
 ```

package/.agent/skills/riligar-dev-auth-react/assets/auth-loader.jsx

@@ -0,0 +1,31 @@
+import { Center, Loader, Stack, Text } from '@mantine/core'
+
+/**
+ * AuthLoader Component
+ *
+ * Standard loading screen used during authentication state transitions
+ * (e.g., checking tokens on initial load or redirects).
+ */
+export default function AuthLoader() {
+    return (
+        <Center h="100vh">
+            <Stack
+                align="center"
+                gap="md"
+            >
+                <Loader
+                    size="lg"
+                    variant="dots"
+                    color="brand"
+                />
+                <Text
+                    size="sm"
+                    c="dimmed"
+                    fw={500}
+                >
+                    Verificando acesso...
+                </Text>
+            </Stack>
+        </Center>
+    )
+}

package/.agent/skills/riligar-dev-auth-react/assets/layout.jsx

@@ -0,0 +1,54 @@
+import { AppShell, Burger, Group, Text } from '@mantine/core'
+import { useDisclosure } from '@mantine/hooks'
+import { Outlet } from 'react-router-dom'
+
+/**
+ * Layout Component
+ *
+ * Standard Dashboard layout using Mantine AppShell.
+ * Provides the structure for sidebars, headers, and main content area.
+ */
+export default function Layout() {
+    const [opened, { toggle }] = useDisclosure()
+
+    return (
+        <AppShell
+            header={{ height: 60 }}
+            navbar={{
+                width: 300,
+                breakpoint: 'sm',
+                collapsed: { mobile: !opened },
+            }}
+            padding="md"
+        >
+            <AppShell.Header>
+                <Group
+                    h="100%"
+                    px="md"
+                >
+                    <Burger
+                        opened={opened}
+                        onClick={toggle}
+                        hiddenFrom="sm"
+                        size="sm"
+                    />
+                    <Text fw={700}>Dashboard</Text>
+                </Group>
+            </AppShell.Header>
+
+            <AppShell.Navbar p="md">
+                {/* Navigation links go here */}
+                <Text
+                    size="sm"
+                    c="dimmed"
+                >
+                    Navigation Menu
+                </Text>
+            </AppShell.Navbar>
+
+            <AppShell.Main>
+                <Outlet />
+            </AppShell.Main>
+        </AppShell>
+    )
+}

package/.agent/skills/riligar-dev-auth-react/assets/require-feature.jsx

@@ -0,0 +1,33 @@
+import { useAuth } from '@riligar/auth-react'
+import { Navigate } from 'react-router-dom'
+import AuthLoader from './auth-loader'
+
+/**
+ * RequireFeature Wrapper
+ *
+ * Protects routes based on specific user attributes or feature flags.
+ * This is an example of how to extend authentication with business logic.
+ */
+export default function RequireFeature({ children }) {
+    const { user, isAuthenticated, loading } = useAuth()
+
+    if (loading) {
+        return <AuthLoader />
+    }
+
+    if (!isAuthenticated) {
+        return (
+            <Navigate
+                to="/auth/signin"
+                replace
+            />
+        )
+    }
+
+    // Example logic: Ensure user has a setup complete or a specific role
+    // if (!user.onboardingCompleted) {
+    //     return <Navigate to="/onboarding" replace />
+    // }
+
+    return children
+}

package/.agent/skills/riligar-dev-auth-react/references/route-protection.md

@@ -13,33 +13,38 @@ Use these components to control access to specific parts of your application.
 
 ## Usage Patterns
 
-### Protecting Routes (React Router)
+### Protecting Routes (createBrowserRouter)
+
+The most robust way to protect routes in a Riligar app is using the **Protected Group** pattern with `createBrowserRouter`. This ensures consistent layout and authentication guards.
 
 ```jsx
-import { Protect, SignIn } from '@riligar/auth-react'
-import { Routes, Route } from 'react-router-dom'
-
-;<Routes>
-    <Route
-        path="/login"
-        element={<SignIn />}
-    />
-
-    <Route element={<Protect redirectTo="/login" />}>
-        <Route
-            path="/dashboard"
-            element={<Dashboard />}
-        />
-        <Route
-            path="/settings"
-            element={<Settings />}
-        />
-    </Route>
-</Routes>
+import { createBrowserRouter, Navigate } from 'react-router-dom'
+import { Protect } from '@riligar/auth-react'
+import AuthLoader from '../components/auth-loader.jsx'
+import Layout from '../components/layout.jsx'
+
+export const router = createBrowserRouter([
+    // Public paths
+    { path: '/auth/signin', element: <SignIn /> },
+
+    // Protected paths
+    {
+        element: <Protect fallback={<AuthLoader />} />,
+        children: [
+            {
+                path: '/',
+                element: <Layout />,
+                children: [{ index: true, element: <Dashboard /> }],
+            },
+        ],
+    },
+])
 ```
 
 ### Conditional UI Elements
 
+Use these wrappers inside your components (headers, sidebars, etc.) for granular visibility.
+
 ```jsx
 import { SignedIn, SignedOut, AuthLoading } from '@riligar/auth-react'
 

package/.agent/skills/riligar-dev-database/SKILL.md

@@ -1,29 +1,29 @@
 ---
 name: riligar-dev-database
-description: Database patterns for RiLiGar using Drizzle ORM + bun:sqlite. Use when setting up database connections, defining schemas, creating migrations, or writing queries. Covers SQLite on Fly.io volumes with the drizzle-kit workflow.
+description: database patterns for RiLiGar using Drizzle ORM + bun:sqlite. Use when setting up database connections, defining schemas, creating migrations, or writing queries. Covers SQLite on Fly.io volumes with the drizzle-kit workflow.
 ---
 
-# Database — Drizzle + bun:sqlite
+# database — Drizzle + bun:sqlite
 
 > SQLite nativo no Bun. Zero drivers externos. Base de dados no volume do Fly.io (`/app/data`).
 
 ## Referências
 
-| Arquivo | Quando usar |
-| --- | --- |
-| [connection.md](references/connection.md) | Setup inicial: instalação, db.js, drizzle.config |
-| [schema.md](references/schema.md) | Definir tabelas, tipos de colunas, relações |
-| [migrations.md](references/migrations.md) | Criar e executar migrations com drizzle-kit |
-| [queries.md](references/queries.md) | Select, insert, update, delete, queries com relações |
+| Arquivo                                   | Quando usar                                          |
+| ----------------------------------------- | ---------------------------------------------------- |
+| [connection.md](references/connection.md) | Setup inicial: instalação, db.js, drizzle.config     |
+| [schema.md](references/schema.md)         | Definir tabelas, tipos de colunas, relações          |
+| [migrations.md](references/migrations.md) | Criar e executar migrations com drizzle-kit          |
+| [queries.md](references/queries.md)       | Select, insert, update, delete, queries com relações |
 
 ## Quick Start
 
 ```javascript
 // database/db.js
 import { drizzle } from 'drizzle-orm/bun-sqlite'
-import Database from 'bun:sqlite'
+import database from 'bun:sqlite'
 
-const sqlite = new Database(process.env.DB_PATH ?? './data/database.db')
+const sqlite = new database(process.env.DB_PATH ?? './database/database.db')
 const db = drizzle({ client: sqlite })
 
 export { db }
@@ -31,15 +31,15 @@ export { db }
 
 ## Regras
 
-- **Caminho do banco:** `/app/data/database.db` em produção (volume Fly.io). `./data/database.db` em desenvolvimento.
+- **Caminho do banco:** `/app/data/database.db` em produção (volume Fly.io). `./database/database.db` em desenvolvimento.
 - **Migrations sempre:** Use `drizzle-kit generate` + `drizzle-kit migrate`. Nunca edite migrations à mão.
 - **Schema único:** Todas as tabelas em `database/schema.js`.
 - **Migrations no startup:** Use `migrate()` no `index.js` antes de `.listen()`.
 
 ## Related Skills
 
-| Need | Skill |
-| --- | --- |
-| **Backend (Elysia)** | @[.agent/skills/riligar-dev-manager] |
+| Need                  | Skill                                 |
+| --------------------- | ------------------------------------- |
+| **Backend (Elysia)**  | @[.agent/skills/riligar-dev-manager]  |
 | **Payments (Stripe)** | @[.agent/skills/riligar-infra-stripe] |
-| **Infrastructure** | @[.agent/skills/riligar-infra-fly] |
+| **Infrastructure**    | @[.agent/skills/riligar-infra-fly]    |

package/.agent/skills/riligar-dev-database/references/connection.md

@@ -1,4 +1,4 @@
-# Database Connection
+# database Connection
 
 ## Installation
 
@@ -14,15 +14,15 @@ No additional drivers needed — `bun:sqlite` is built into Bun.
 ```javascript
 // database/db.js
 import { drizzle } from 'drizzle-orm/bun-sqlite'
-import Database from 'bun:sqlite'
+import database from 'bun:sqlite'
 
-const sqlite = new Database(process.env.DB_PATH ?? './data/database.db')
+const sqlite = new database(process.env.DB_PATH ?? './database/database.db')
 const db = drizzle({ client: sqlite })
 
 export { db }
 ```
 
-- Em **desenvolvimento**: `DB_PATH` não é definido → usa `./data/database.db`
+- Em **desenvolvimento**: `DB_PATH` não é definido → usa `./database/database.db`
 - Em **produção** (Fly.io): `fly secrets set DB_PATH=/app/data/database.db`
 
 ## drizzle.config.js
@@ -36,7 +36,7 @@ export default defineConfig({
     schema: './database/schema.js',
     out: './database/migrations',
     dbCredentials: {
-        url: process.env.DB_PATH ?? './data/database.db',
+        url: process.env.DB_PATH ?? './database/database.db',
     },
 })
 ```
@@ -53,9 +53,7 @@ import { db } from './database/db'
 await migrate(db, { migrationsFolder: './database/migrations' })
 
 // ... resto do setup
-const app = new Elysia()
-    .use(routes)
-    .listen(3000)
+const app = new Elysia().use(routes).listen(3000)
 ```
 
 Isso garante que o banco esteja sempre atualizado quando o servidor inicia no Fly.io.

package/.agent/skills/riligar-dev-database/references/queries.md

@@ -17,10 +17,12 @@ import { eq, and, or, desc, asc } from 'drizzle-orm'
 const allUsers = await db.select().from(users)
 
 // Campos específicos
-const names = await db.select({
-    id: users.id,
-    name: users.name,
-}).from(users)
+const names = await db
+    .select({
+        id: users.id,
+        name: users.name,
+    })
+    .from(users)
 ```
 
 ### Filtrar
@@ -30,23 +32,24 @@ const names = await db.select({
 const [user] = await db.select().from(users).where(eq(users.id, userId)).limit(1)
 
 // Múltiplos filtros (AND)
-const results = await db.select().from(users).where(
-    and(
-        eq(users.active, true),
-        eq(users.plan, 'pro')
-    )
-)
+const results = await db
+    .select()
+    .from(users)
+    .where(and(eq(users.active, true), eq(users.plan, 'pro')))
 
 // OR
-const results = await db.select().from(users).where(
-    or(eq(users.id, '1'), eq(users.id, '2'))
-)
+const results = await db
+    .select()
+    .from(users)
+    .where(or(eq(users.id, '1'), eq(users.id, '2')))
 ```
 
 ### Ordenar e Paginar
 
 ```javascript
-const page = await db.select().from(posts)
+const page = await db
+    .select()
+    .from(posts)
     .orderBy(desc(posts.createdAt))
     .limit(10)
     .offset(pageIndex * 10)
@@ -59,9 +62,7 @@ const page = await db.select().from(posts)
 await db.insert(users).values({ name: 'Dan', email: 'dan@email.com' })
 
 // Com retorno
-const [user] = await db.insert(users)
-    .values({ name: 'Dan', email: 'dan@email.com' })
-    .returning()
+const [user] = await db.insert(users).values({ name: 'Dan', email: 'dan@email.com' }).returning()
 
 // Múltiplos
 await db.insert(users).values([
@@ -70,7 +71,8 @@ await db.insert(users).values([
 ])
 
 // Upsert (conflict handling)
-await db.insert(users)
+await db
+    .insert(users)
     .values({ id: '1', name: 'Dan' })
     .onConflictDoUpdate({
         target: users.id,
@@ -81,15 +83,10 @@ await db.insert(users)
 ## Update
 
 ```javascript
-await db.update(users)
-    .set({ name: 'Mr. Dan', updatedAt: new Date() })
-    .where(eq(users.id, userId))
+await db.update(users).set({ name: 'Mr. Dan', updatedAt: new Date() }).where(eq(users.id, userId))
 
 // Com retorno
-const [updated] = await db.update(users)
-    .set({ plan: 'pro' })
-    .where(eq(users.id, userId))
-    .returning()
+const [updated] = await db.update(users).set({ plan: 'pro' }).where(eq(users.id, userId)).returning()
 ```
 
 ## Delete
@@ -98,9 +95,7 @@ const [updated] = await db.update(users)
 await db.delete(users).where(eq(users.id, userId))
 
 // Com retorno
-const [deleted] = await db.delete(users)
-    .where(eq(users.id, userId))
-    .returning()
+const [deleted] = await db.delete(users).where(eq(users.id, userId)).returning()
 ```
 
 ## Queries com Relações
@@ -159,7 +154,8 @@ export async function createUser(data) {
 }
 
 export async function updateUser(id, data) {
-    const [user] = await db.update(users)
+    const [user] = await db
+        .update(users)
         .set({ ...data, updatedAt: new Date() })
         .where(eq(users.id, id))
         .returning()

package/.agent/skills/riligar-dev-database/references/schema.md

@@ -8,37 +8,41 @@ import { sqliteTable, text, integer } from 'drizzle-orm/sqlite-core'
 import { relations } from 'drizzle-orm'
 
 export const users = sqliteTable('users', {
-    id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
+    id: text('id')
+        .primaryKey()
+        .$defaultFn(() => crypto.randomUUID()),
     email: text('email').notNull().unique(),
     name: text('name'),
-    createdAt: integer('created_at', { mode: 'timestamp' }).notNull().$defaultFn(() => new Date()),
+    createdAt: integer('created_at', { mode: 'timestamp' })
+        .notNull()
+        .$defaultFn(() => new Date()),
     updatedAt: integer('updated_at', { mode: 'timestamp' }),
 })
 ```
 
 ## Tipos de Colunas
 
-| Tipo | Uso | Exemplo |
-| --- | --- | --- |
-| `text()` | Strings, UUIDs, JSON | `text('name').notNull()` |
-| `integer()` | Números, booleans, timestamps | `integer('age')` |
-| `real()` | Decimais (float) | `real('price')` |
-| `blob()` | Dados binários | `blob('avatar')` |
-| `numeric()` | Valores numéricos precisos | `numeric('amount')` |
+| Tipo        | Uso                           | Exemplo                  |
+| ----------- | ----------------------------- | ------------------------ |
+| `text()`    | Strings, UUIDs, JSON          | `text('name').notNull()` |
+| `integer()` | Números, booleans, timestamps | `integer('age')`         |
+| `real()`    | Decimais (float)              | `real('price')`          |
+| `blob()`    | Dados binários                | `blob('avatar')`         |
+| `numeric()` | Valores numéricos precisos    | `numeric('amount')`      |
 
 ### Modes do `integer()`
 
 ```javascript
-integer('count')                                // número
-integer('active', { mode: 'boolean' })          // boolean (0/1)
-integer('created_at', { mode: 'timestamp' })    // Date (segundos)
+integer('count') // número
+integer('active', { mode: 'boolean' }) // boolean (0/1)
+integer('created_at', { mode: 'timestamp' }) // Date (segundos)
 integer('created_at', { mode: 'timestamp_ms' }) // Date (milissegundos)
 ```
 
 ### JSON via `text()`
 
 ```javascript
-text('metadata', { mode: 'json' })  // armazena JSON como text
+text('metadata', { mode: 'json' }) // armazena JSON como text
 ```
 
 ## Primary Key
@@ -55,11 +59,17 @@ id: integer('id').primaryKey({ autoIncrement: true }),
 
 ```javascript
 export const posts = sqliteTable('posts', {
-    id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
-    authorId: text('author_id').notNull().references(() => users.id),
+    id: text('id')
+        .primaryKey()
+        .$defaultFn(() => crypto.randomUUID()),
+    authorId: text('author_id')
+        .notNull()
+        .references(() => users.id),
     title: text('title').notNull(),
     body: text('body'),
-    createdAt: integer('created_at', { mode: 'timestamp' }).notNull().$defaultFn(() => new Date()),
+    createdAt: integer('created_at', { mode: 'timestamp' })
+        .notNull()
+        .$defaultFn(() => new Date()),
 })
 ```
 
@@ -84,8 +94,12 @@ export const postsRelations = relations(posts, ({ one }) => ({
 
 ```javascript
 export const usersToGroups = sqliteTable('users_to_groups', {
-    userId: text('user_id').notNull().references(() => users.id),
-    groupId: text('group_id').notNull().references(() => groups.id),
+    userId: text('user_id')
+        .notNull()
+        .references(() => users.id),
+    groupId: text('group_id')
+        .notNull()
+        .references(() => groups.id),
 })
 
 export const usersRelations = relations(users, ({ many }) => ({

package/.agent/skills/riligar-dev-manager/SKILL.md

@@ -22,21 +22,21 @@ const app = new Elysia()
     .post('/users', ({ body }) => createUser(body), {
         body: t.Object({
             name: t.String(),
-            email: t.String({ format: 'email' })
-        })
+            email: t.String({ format: 'email' }),
+        }),
     })
     .listen(3000)
 ```
 
 ## Content Map
 
-| File | Description | When to Read |
-| --- | --- | --- |
-| [elysia-basics.md](references/elysia-basics.md) | Setup, routes, handlers, context | Starting new project |
-| [elysia-plugins.md](references/elysia-plugins.md) | Plugins, guards, modular design | Organizing code |
-| [elysia-validation.md](references/elysia-validation.md) | TypeBox validation (body, query, params) | Input validation |
-| [elysia-lifecycle.md](references/elysia-lifecycle.md) | Hooks (onBeforeHandle, onError, etc.) | Middleware, auth checks |
-| [elysia-patterns.md](references/elysia-patterns.md) | REST patterns, responses, pagination | API design |
+| File                                                    | Description                              | When to Read            |
+| ------------------------------------------------------- | ---------------------------------------- | ----------------------- |
+| [elysia-basics.md](references/elysia-basics.md)         | Setup, routes, handlers, context         | Starting new project    |
+| [elysia-plugins.md](references/elysia-plugins.md)       | Plugins, guards, modular design          | Organizing code         |
+| [elysia-validation.md](references/elysia-validation.md) | TypeBox validation (body, query, params) | Input validation        |
+| [elysia-lifecycle.md](references/elysia-lifecycle.md)   | Hooks (onBeforeHandle, onError, etc.)    | Middleware, auth checks |
+| [elysia-patterns.md](references/elysia-patterns.md)     | REST patterns, responses, pagination     | API design              |
 
 ## Project Structure
 
@@ -61,13 +61,13 @@ src/
 
 ## Dependencies
 
-| Pacote | Versão | Descrição |
-|---|---|---|
-| `bun` | latest | Runtime |
-| `elysia` | latest | Framework HTTP |
-| `bun:sqlite` | builtin | SQLite driver |
-| `drizzle-orm` | latest | ORM |
-| `bun:s3` | latest | S3/R2 Storage |
+| Pacote        | Versão  | Descrição      |
+| ------------- | ------- | -------------- |
+| `bun`         | latest  | Runtime        |
+| `elysia`      | latest  | Framework HTTP |
+| `bun:sqlite`  | builtin | SQLite driver  |
+| `drizzle-orm` | latest  | ORM            |
+| `bun:s3`      | latest  | S3/R2 Storage  |
 
 ## Core Patterns
 
@@ -84,8 +84,8 @@ export const userRoutes = new Elysia({ prefix: '/users' })
     .post('/', ({ body }) => createUser(body), {
         body: t.Object({
             name: t.String({ minLength: 1 }),
-            email: t.String({ format: 'email' })
-        })
+            email: t.String({ format: 'email' }),
+        }),
     })
 ```
 
@@ -112,11 +112,11 @@ console.log(`Server running at ${app.server?.url}`)
 
 ## Related Skills
 
-| Need | Skill |
-| --- | --- |
+| Need               | Skill                                    |
+| ------------------ | ---------------------------------------- |
 | **Authentication** | @[.agent/skills/riligar-dev-auth-elysia] |
-| **Database** | @[.agent/skills/riligar-dev-database] |
-| **Infrastructure** | @[.agent/skills/riligar-infra-fly] |
+| **database**       | @[.agent/skills/riligar-dev-database]    |
+| **Infrastructure** | @[.agent/skills/riligar-infra-fly]       |
 
 ## Decision Checklist
 
@@ -126,14 +126,14 @@ Before building an API:
 - [ ] Planned validation for all inputs?
 - [ ] Error handling configured?
 - [ ] Auth middleware needed? → Use `riligar-dev-auth-elysia`
-- [ ] Database connection setup? → Use `riligar-dev-database`
+- [ ] database connection setup? → Use `riligar-dev-database`
 
 ## Anti-Patterns
 
-| Don't | Do |
-| --- | --- |
-| Put business logic in handlers | Extract to `services/` |
-| Skip input validation | Use TypeBox (`t.Object`) |
-| Ignore error handling | Use `onError` lifecycle |
-| Create monolithic files | Split into plugins |
+| Don't                            | Do                       |
+| -------------------------------- | ------------------------ |
+| Put business logic in handlers   | Extract to `services/`   |
+| Skip input validation            | Use TypeBox (`t.Object`) |
+| Ignore error handling            | Use `onError` lifecycle  |
+| Create monolithic files          | Split into plugins       |
 | Use verbs in routes (`/getUser`) | Use nouns (`/users/:id`) |

package/.agent/skills/riligar-infra-stripe/SKILL.md

@@ -21,8 +21,9 @@ Pergunte ao usuário:
 > Você pode encontrá-las em: https://dashboard.stripe.com/apikeys
 >
 > Por favor, me forneça:
-> 1. **Publishable Key** (pk_live_... ou pk_test_...)
-> 2. **Secret Key** (sk_live_... ou sk_test_...)
+>
+> 1. **Publishable Key** (pk*live*... ou pk*test*...)
+> 2. **Secret Key** (sk*live*... ou sk*test*...)
 
 Aguarde as chaves antes de prosseguir.
 
@@ -36,6 +37,7 @@ Após receber as chaves, pergunte:
 > 2. **Quais planos/produtos** você quer oferecer?
 >
 > Exemplo de resposta:
+>
 > - Assinatura mensal
 > - Plano Starter: R$ 29/mês (5 projetos, suporte email)
 > - Plano Pro: R$ 99/mês (ilimitado, suporte prioritário)
@@ -57,17 +59,17 @@ async function setupProducts() {
         {
             name: 'Plano Starter',
             description: '5 projetos, suporte email',
-            price: 2900,  // R$ 29,00 em centavos
+            price: 2900, // R$ 29,00 em centavos
             interval: 'month',
-            features: ['5 projetos', 'Suporte email', '1GB storage']
+            features: ['5 projetos', 'Suporte email', '1GB storage'],
         },
         {
             name: 'Plano Pro',
             description: 'Ilimitado, suporte prioritário',
-            price: 9900,  // R$ 99,00 em centavos
+            price: 9900, // R$ 99,00 em centavos
             interval: 'month',
-            features: ['Projetos ilimitados', 'Suporte prioritário', '10GB storage']
-        }
+            features: ['Projetos ilimitados', 'Suporte prioritário', '10GB storage'],
+        },
     ]
 
     console.log('Criando produtos no Stripe...\n')
@@ -76,14 +78,14 @@ async function setupProducts() {
         const stripeProduct = await stripe.products.create({
             name: product.name,
             description: product.description,
-            metadata: { features: JSON.stringify(product.features) }
+            metadata: { features: JSON.stringify(product.features) },
         })
 
         const stripePrice = await stripe.prices.create({
             product: stripeProduct.id,
             unit_amount: product.price,
             currency: 'brl',
-            recurring: product.interval ? { interval: product.interval } : undefined
+            recurring: product.interval ? { interval: product.interval } : undefined,
         })
 
         console.log(`✓ ${product.name}`)
@@ -111,6 +113,7 @@ Após executar o script, peça:
 Com as chaves e Price IDs, configure os arquivos de ambiente:
 
 **Backend: `.env.development` e `.env.production`**
+
 ```bash
 # .env.development (chaves de teste)
 STRIPE_SECRET_KEY=sk_test_...
@@ -122,6 +125,7 @@ STRIPE_WEBHOOK_SECRET=whsec_...
 ```
 
 **Frontend: `.env.development` e `.env.production`**
+
 ```bash
 # .env.development
 VITE_STRIPE_PUBLISHABLE_KEY=pk_test_...
@@ -130,7 +134,7 @@ VITE_STRIPE_PUBLISHABLE_KEY=pk_test_...
 VITE_STRIPE_PUBLISHABLE_KEY=pk_live_...
 ```
 
-### Step 6: Configurar Database
+### Step 6: Configurar database
 
 Gere a migration para adicionar campos do Stripe:
 
@@ -153,29 +157,29 @@ Instrua o usuário:
 > 2. Clique em "Add endpoint"
 > 3. URL: `https://seu-dominio.com/api/webhook`
 > 4. Selecione os eventos:
->    - `checkout.session.completed`
->    - `customer.subscription.updated`
->    - `customer.subscription.deleted`
->    - `invoice.paid`
->    - `invoice.payment_failed`
-> 5. Copie o "Signing secret" (whsec_...)
+>     - `checkout.session.completed`
+>     - `customer.subscription.updated`
+>     - `customer.subscription.deleted`
+>     - `invoice.paid`
+>     - `invoice.payment_failed`
+> 5. Copie o "Signing secret" (whsec\_...)
 > 6. Adicione ao `.env.development` e `.env.production`
 
 ### Step 8: Gerar Código
 
 Gere todos os arquivos necessários usando os templates de [assets/](assets/):
 
-| Arquivo | Baseado em |
-| --- | --- |
-| `plugins/stripe.js` | stripe-server.js (seção 1) |
-| `routes/billing.js` | stripe-server.js (seção 2) |
-| `routes/webhook.js` | stripe-server.js (seção 3) |
-| `services/billing.js` | stripe-server.js (seção 4) |
-| `config/stripe-prices.js` | Price IDs coletados (Step 9) |
-| `config/plans.js` | PLAN_MAP + PLAN_LIMITS (Step 9) |
-| `pages/Pricing.jsx` | stripe-client.js (seção 3) |
-| `components/BillingSettings.jsx` | stripe-client.js (seção 4) |
-| `hooks/useSubscription.js` | stripe-client.js (seção 2) |
+| Arquivo                          | Baseado em                      |
+| -------------------------------- | ------------------------------- |
+| `plugins/stripe.js`              | stripe-server.js (seção 1)      |
+| `routes/billing.js`              | stripe-server.js (seção 2)      |
+| `routes/webhook.js`              | stripe-server.js (seção 3)      |
+| `services/billing.js`            | stripe-server.js (seção 4)      |
+| `config/stripe-prices.js`        | Price IDs coletados (Step 9)    |
+| `config/plans.js`                | PLAN_MAP + PLAN_LIMITS (Step 9) |
+| `pages/Pricing.jsx`              | stripe-client.js (seção 3)      |
+| `components/BillingSettings.jsx` | stripe-client.js (seção 4)      |
+| `hooks/useSubscription.js`       | stripe-client.js (seção 2)      |
 
 ### Step 9: Criar Configs de Planos e Preços
 
@@ -188,24 +192,24 @@ export const STRIPE_PRICES = {
         priceId: 'price_COLETADO_STARTER',
         name: 'Starter',
         price: 29,
-        features: ['5 projetos', 'Suporte email', '1GB storage']
+        features: ['5 projetos', 'Suporte email', '1GB storage'],
     },
     pro: {
         priceId: 'price_COLETADO_PRO',
         name: 'Pro',
         price: 99,
-        features: ['Projetos ilimitados', 'Suporte prioritário', '10GB storage']
+        features: ['Projetos ilimitados', 'Suporte prioritário', '10GB storage'],
     },
     enterprise: {
         priceId: 'price_COLETADO_ENTERPRISE',
         name: 'Enterprise',
         price: 299,
-        features: ['Tudo do Pro', 'Storage ilimitado', 'SLA garantido']
-    }
+        features: ['Tudo do Pro', 'Storage ilimitado', 'SLA garantido'],
+    },
 }
 
-export const getPrice = (plan) => STRIPE_PRICES[plan]
-export const getPriceId = (plan) => STRIPE_PRICES[plan]?.priceId
+export const getPrice = plan => STRIPE_PRICES[plan]
+export const getPriceId = plan => STRIPE_PRICES[plan]?.priceId
 ```
 
 **B) Arquivo de mapeamento e limites (config/plans.js):**
@@ -215,9 +219,9 @@ export const getPriceId = (plan) => STRIPE_PRICES[plan]?.priceId
 
 // Mapeia Price IDs do Stripe para nomes de planos internos
 export const PLAN_MAP = {
-    'price_COLETADO_STARTER': 'starter',
-    'price_COLETADO_PRO': 'pro',
-    'price_COLETADO_ENTERPRISE': 'enterprise',
+    price_COLETADO_STARTER: 'starter',
+    price_COLETADO_PRO: 'pro',
+    price_COLETADO_ENTERPRISE: 'enterprise',
 }
 
 // Define limites de features por plano
@@ -283,12 +287,12 @@ stripe trigger checkout.session.completed
 
 ## Specialized Guides
 
-| Guide | Content |
-| --- | --- |
-| [stripe-elysia.md](references/stripe-elysia.md) | Backend routes completas |
-| [stripe-react.md](references/stripe-react.md) | Componentes React/Mantine |
-| [stripe-webhooks.md](references/stripe-webhooks.md) | Handlers de eventos |
-| [stripe-database.md](references/stripe-database.md) | Schema Drizzle |
+| Guide                                               | Content                   |
+| --------------------------------------------------- | ------------------------- |
+| [stripe-elysia.md](references/stripe-elysia.md)     | Backend routes completas  |
+| [stripe-react.md](references/stripe-react.md)       | Componentes React/Mantine |
+| [stripe-webhooks.md](references/stripe-webhooks.md) | Handlers de eventos       |
+| [stripe-database.md](references/stripe-database.md) | Schema Drizzle            |
 
 ---
 

package/.agent/skills/riligar-infra-stripe/references/stripe-database.md

@@ -1,6 +1,6 @@
-# Stripe Database Patterns (Drizzle)
+# Stripe database Patterns (Drizzle)
 
-Database schemas and queries for Stripe billing with SQLite and Drizzle ORM.
+database schemas and queries for Stripe billing with SQLite and Drizzle ORM.
 
 ## Schema
 
@@ -18,13 +18,15 @@ export const users = sqliteTable('users', {
     // Stripe fields
     stripeCustomerId: text('stripe_customer_id').unique(),
     stripeSubscriptionId: text('stripe_subscription_id').unique(),
-    plan: text('plan').default('free'),  // free, starter, pro, enterprise
-    subscriptionStatus: text('subscription_status'),  // active, past_due, canceled, trialing
+    plan: text('plan').default('free'), // free, starter, pro, enterprise
+    subscriptionStatus: text('subscription_status'), // active, past_due, canceled, trialing
     currentPeriodEnd: integer('current_period_end', { mode: 'timestamp' }),
     cancelAtPeriodEnd: integer('cancel_at_period_end', { mode: 'boolean' }).default(false),
 
-    createdAt: integer('created_at', { mode: 'timestamp' }).notNull().$defaultFn(() => new Date()),
-    updatedAt: integer('updated_at', { mode: 'timestamp' })
+    createdAt: integer('created_at', { mode: 'timestamp' })
+        .notNull()
+        .$defaultFn(() => new Date()),
+    updatedAt: integer('updated_at', { mode: 'timestamp' }),
 })
 ```
 
@@ -32,13 +34,19 @@ export const users = sqliteTable('users', {
 
 ```javascript
 export const invoices = sqliteTable('invoices', {
-    id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
-    userId: text('user_id').references(() => users.id).notNull(),
+    id: text('id')
+        .primaryKey()
+        .$defaultFn(() => crypto.randomUUID()),
+    userId: text('user_id')
+        .references(() => users.id)
+        .notNull(),
     stripeInvoiceId: text('stripe_invoice_id').unique().notNull(),
-    amount: integer('amount').notNull(),  // in cents
-    status: text('status').notNull(),  // paid, open, void
-    url: text('url'),  // hosted invoice URL
-    createdAt: integer('created_at', { mode: 'timestamp' }).notNull().$defaultFn(() => new Date())
+    amount: integer('amount').notNull(), // in cents
+    status: text('status').notNull(), // paid, open, void
+    url: text('url'), // hosted invoice URL
+    createdAt: integer('created_at', { mode: 'timestamp' })
+        .notNull()
+        .$defaultFn(() => new Date()),
 })
 ```
 
@@ -46,10 +54,12 @@ export const invoices = sqliteTable('invoices', {
 
 ```javascript
 export const webhookEvents = sqliteTable('webhook_events', {
-    id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
+    id: text('id')
+        .primaryKey()
+        .$defaultFn(() => crypto.randomUUID()),
     stripeEventId: text('stripe_event_id').unique().notNull(),
     type: text('type').notNull(),
-    processedAt: integer('processed_at', { mode: 'timestamp' }).notNull()
+    processedAt: integer('processed_at', { mode: 'timestamp' }).notNull(),
 })
 ```
 
@@ -61,10 +71,10 @@ export const products = sqliteTable('products', {
     stripePriceId: text('stripe_price_id').unique().notNull(),
     name: text('name').notNull(),
     description: text('description'),
-    amount: integer('amount').notNull(),  // in cents
-    interval: text('interval'),  // month, year, null for one-time
+    amount: integer('amount').notNull(), // in cents
+    interval: text('interval'), // month, year, null for one-time
     active: integer('active', { mode: 'boolean' }).default(true),
-    features: text('features', { mode: 'json' })  // ["feature1", "feature2"]
+    features: text('features', { mode: 'json' }), // ["feature1", "feature2"]
 })
 ```
 
@@ -78,10 +88,7 @@ import { users } from '../database/schema'
 import { eq } from 'drizzle-orm'
 
 export async function getUserWithSubscription(userId) {
-    const [user] = await db.select()
-        .from(users)
-        .where(eq(users.id, userId))
-        .limit(1)
+    const [user] = await db.select().from(users).where(eq(users.id, userId)).limit(1)
 
     return user
 }
@@ -91,10 +98,11 @@ export async function getUserWithSubscription(userId) {
 
 ```javascript
 export async function hasActiveSubscription(userId) {
-    const [user] = await db.select({
-        status: users.subscriptionStatus,
-        periodEnd: users.currentPeriodEnd
-    })
+    const [user] = await db
+        .select({
+            status: users.subscriptionStatus,
+            periodEnd: users.currentPeriodEnd,
+        })
         .from(users)
         .where(eq(users.id, userId))
         .limit(1)
@@ -110,10 +118,7 @@ export async function hasActiveSubscription(userId) {
 
 ```javascript
 export async function getUserByStripeCustomer(stripeCustomerId) {
-    const [user] = await db.select()
-        .from(users)
-        .where(eq(users.stripeCustomerId, stripeCustomerId))
-        .limit(1)
+    const [user] = await db.select().from(users).where(eq(users.stripeCustomerId, stripeCustomerId)).limit(1)
 
     return user
 }
@@ -123,10 +128,7 @@ export async function getUserByStripeCustomer(stripeCustomerId) {
 
 ```javascript
 export async function getUserBySubscription(stripeSubscriptionId) {
-    const [user] = await db.select()
-        .from(users)
-        .where(eq(users.stripeSubscriptionId, stripeSubscriptionId))
-        .limit(1)
+    const [user] = await db.select().from(users).where(eq(users.stripeSubscriptionId, stripeSubscriptionId)).limit(1)
 
     return user
 }
@@ -136,7 +138,8 @@ export async function getUserBySubscription(stripeSubscriptionId) {
 
 ```javascript
 export async function updateUserSubscription(userId, data) {
-    await db.update(users)
+    await db
+        .update(users)
         .set({
             stripeCustomerId: data.customerId,
             stripeSubscriptionId: data.subscriptionId,
@@ -144,7 +147,7 @@ export async function updateUserSubscription(userId, data) {
             subscriptionStatus: data.status,
             currentPeriodEnd: data.periodEnd,
             cancelAtPeriodEnd: data.cancelAtPeriodEnd,
-            updatedAt: new Date()
+            updatedAt: new Date(),
         })
         .where(eq(users.id, userId))
 }
@@ -154,12 +157,13 @@ export async function updateUserSubscription(userId, data) {
 
 ```javascript
 export async function cancelSubscriptionInDb(subscriptionId) {
-    await db.update(users)
+    await db
+        .update(users)
         .set({
             plan: 'free',
             subscriptionStatus: 'canceled',
             stripeSubscriptionId: null,
-            updatedAt: new Date()
+            updatedAt: new Date(),
         })
         .where(eq(users.stripeSubscriptionId, subscriptionId))
 }
@@ -171,11 +175,7 @@ export async function cancelSubscriptionInDb(subscriptionId) {
 import { desc } from 'drizzle-orm'
 
 export async function getUserInvoices(userId, limit = 10) {
-    return db.select()
-        .from(invoices)
-        .where(eq(invoices.userId, userId))
-        .orderBy(desc(invoices.createdAt))
-        .limit(limit)
+    return db.select().from(invoices).where(eq(invoices.userId, userId)).orderBy(desc(invoices.createdAt)).limit(limit)
 }
 ```
 
@@ -183,10 +183,7 @@ export async function getUserInvoices(userId, limit = 10) {
 
 ```javascript
 export async function isWebhookProcessed(eventId) {
-    const [event] = await db.select()
-        .from(webhookEvents)
-        .where(eq(webhookEvents.stripeEventId, eventId))
-        .limit(1)
+    const [event] = await db.select().from(webhookEvents).where(eq(webhookEvents.stripeEventId, eventId)).limit(1)
 
     return !!event
 }
@@ -195,7 +192,7 @@ export async function markWebhookProcessed(eventId, type) {
     await db.insert(webhookEvents).values({
         stripeEventId: eventId,
         type,
-        processedAt: new Date()
+        processedAt: new Date(),
     })
 }
 ```
@@ -274,42 +271,39 @@ export const billingService = {
 
     // Get user
     async getUser(userId) {
-        const [user] = await db.select()
-            .from(users)
-            .where(eq(users.id, userId))
-            .limit(1)
+        const [user] = await db.select().from(users).where(eq(users.id, userId)).limit(1)
         return user
     },
 
     // Link Stripe customer
     async linkStripeCustomer(userId, stripeCustomerId) {
-        await db.update(users)
-            .set({ stripeCustomerId, updatedAt: new Date() })
-            .where(eq(users.id, userId))
+        await db.update(users).set({ stripeCustomerId, updatedAt: new Date() }).where(eq(users.id, userId))
     },
 
     // Activate subscription
     async activateSubscription(userId, { subscriptionId, plan, periodEnd }) {
-        await db.update(users)
+        await db
+            .update(users)
             .set({
                 stripeSubscriptionId: subscriptionId,
                 plan,
                 subscriptionStatus: 'active',
                 currentPeriodEnd: periodEnd,
                 cancelAtPeriodEnd: false,
-                updatedAt: new Date()
+                updatedAt: new Date(),
             })
             .where(eq(users.id, userId))
     },
 
     // Deactivate subscription
     async deactivateSubscription(subscriptionId) {
-        await db.update(users)
+        await db
+            .update(users)
             .set({
                 plan: 'free',
                 subscriptionStatus: 'canceled',
                 stripeSubscriptionId: null,
-                updatedAt: new Date()
+                updatedAt: new Date(),
             })
             .where(eq(users.stripeSubscriptionId, subscriptionId))
     },
@@ -321,9 +315,9 @@ export const billingService = {
             stripeInvoiceId: stripeInvoice.id,
             amount: stripeInvoice.amount_paid,
             status: stripeInvoice.status,
-            url: stripeInvoice.hosted_invoice_url
+            url: stripeInvoice.hosted_invoice_url,
         })
-    }
+    },
 }
 ```
 
@@ -334,28 +328,28 @@ export const billingService = {
 const planFeatures = {
     free: {
         projects: 1,
-        storage: 100 * 1024 * 1024,  // 100MB
+        storage: 100 * 1024 * 1024, // 100MB
         apiCalls: 100,
-        support: 'community'
+        support: 'community',
     },
     starter: {
         projects: 5,
-        storage: 1 * 1024 * 1024 * 1024,  // 1GB
+        storage: 1 * 1024 * 1024 * 1024, // 1GB
         apiCalls: 1000,
-        support: 'email'
+        support: 'email',
     },
     pro: {
         projects: Infinity,
-        storage: 10 * 1024 * 1024 * 1024,  // 10GB
+        storage: 10 * 1024 * 1024 * 1024, // 10GB
         apiCalls: 10000,
-        support: 'priority'
+        support: 'priority',
     },
     enterprise: {
         projects: Infinity,
         storage: Infinity,
         apiCalls: Infinity,
-        support: 'dedicated'
-    }
+        support: 'dedicated',
+    },
 }
 
 export function getFeatureLimits(plan) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@riligar/agents-kit",
-    "version": "1.19.0",
+    "version": "1.20.1",
     "publishConfig": {
         "access": "public"
     },