siesa-agents 2.1.46 → 2.1.48

package/README.md

@@ -11,15 +11,20 @@ Paquete para instalar y configurar el ecosistema **BMAD v6** con los agentes esp
 Esta versión está diseñada y optimizada para el siguiente stack tecnológico empresarial:
 
 **Frontend:**
-- Next.js 16 con TypeScript (App Router)
+- Vite 6+ como bundler (builds rápidos, HMR instantáneo)
+- TanStack Router 1+ (file-based routing, type-safe)
+- React 18+ con TypeScript (strict mode)
+- TanStack Query 5+ para server state
+- Zustand 5+ para client state
 - Shadcn/ui + Radix UI + TailwindCSS v4
-- Zustand para state management
 - React Hook Form + Zod para formularios
+- Vitest para testing
+- Preparado para microfrontends con Module Federation
 
 **Backend:**
 - .NET 10 con C# Minimal API
 - Entity Framework Core 10 + linq2db + LinqKit
-- PostgreSQL como base de datos primaria
+- PostgreSQL 18+ como base de datos primaria
 - Arquitectura de Microservicios
 
 **Principios Arquitectónicos:**
@@ -27,25 +32,6 @@ Esta versión está diseñada y optimizada para el siguiente stack tecnológico
 - Test-Driven Development (TDD)
 - Database per Microservice
 
-## Sistema de Publicación Automática
-
-Este proyecto cuenta con un sistema de CI/CD automatizado que maneja las publicaciones de manera inteligente:
-
-### Versiones Estables (`latest`)
-- **Rama**: `npm-package`
-- **Propósito**: Versiones oficiales para producción
-- **Funcionamiento**: Cada commit en esta rama incrementa automáticamente la versión y la publica en npm
-
-### Versiones de Desarrollo (`dev`)
-- **Rama**: `developer`
-- **Propósito**: Versiones de prueba y desarrollo
-- **Funcionamiento**: Incrementa automáticamente el contador de desarrollo
-
-### Flujo de Trabajo
-1. **Desarrollo**: Trabaja en la rama `developer` para cambios experimentales
-2. **Estable**: Mueve cambios finalizados a `npm-package` para versiones oficiales
-3. **Automático**: El sistema maneja todo el versionado sin intervención manual
-
 ## Instalación
 
 ### Instalación única con npx (Recomendado)
@@ -105,8 +91,8 @@ El sistema detectará automáticamente que ya existe una instalación y la actua
 
 ## Requisitos
 
-- Node.js >= 14.0.0
-- npm >= 6.0.0
+- Node.js >= 20.0.0
+- npm >= 8.0.0 (o pnpm >= 8.0.0 recomendado)
 - Python >= 3.7 (requerido para hooks de Claude Code)
 
 ## Estructura de archivos instalados

package/bmad/bmm/workflows/3-solutioning/create-architecture/data/company-standards/architecture-patterns.md

@@ -7,26 +7,34 @@
 
 ### Folder Structure
 
-Next.js 16 App Router Structure with Clean Architecture + DDD:
+Vite + TanStack Router Structure with Clean Architecture + DDD:
 
 ```
-├── app/                         # Next.js App Router directory
-│   ├── (dashboard)/            # Route groups for dashboard
-│   ├── sales/                  # Routes for sales module
-│   │   ├── quotes/             # Quote management pages
-│   │   └── invoices/           # Invoice pages
-│   ├── inventory/              # Inventory routes
-│   ├── globals.css             # Global styles
-│   ├── layout.tsx              # Root layout component
-│   ├── page.tsx               # Home page
-│   ├── loading.tsx            # Global loading UI
-│   └── not-found.tsx          # 404 page
-│
 ├── src/
-│   ├── modules/                # Business modules following DDD
-│   │   ├── sales/              # Sales module
-│   │   │   ├── quotes/         # Quote domain
-│   │   │   │   ├── cart/       # Shopping cart feature
+│   ├── main.tsx                     # React entry point
+│   ├── router.tsx                   # TanStack Router config
+│   ├── routeTree.gen.ts             # Auto-generated (DO NOT EDIT)
+│   ├── globals.css                  # Global styles + Tailwind
+│   │
+│   ├── routes/                      # TanStack Router file-based routing
+│   │   ├── __root.tsx               # Root layout (providers)
+│   │   ├── index.tsx                # Home redirect
+│   │   ├── _auth.tsx                # Public layout (pathless)
+│   │   ├── _auth/
+│   │   │   └── login.tsx            # /login
+│   │   ├── _app.tsx                 # Protected layout (pathless)
+│   │   └── _app/
+│   │       ├── dashboard.tsx        # /dashboard
+│   │       ├── sales/
+│   │       │   ├── quotes.tsx       # /sales/quotes
+│   │       │   └── invoices.tsx     # /sales/invoices
+│   │       └── inventory/
+│   │           └── products.tsx     # /inventory/products
+│   │
+│   ├── modules/                     # Business modules following DDD
+│   │   ├── sales/                   # Sales module
+│   │   │   ├── quotes/              # Quote domain
+│   │   │   │   ├── cart/            # Shopping cart feature
 │   │   │   │   │   ├── domain/
 │   │   │   │   │   │   ├── entities/
 │   │   │   │   │   │   ├── repositories/
@@ -41,29 +49,43 @@ Next.js 16 App Router Structure with Clean Architecture + DDD:
 │   │   │   │   │   │   ├── api/
 │   │   │   │   │   │   └── adapters/
 │   │   │   │   │   └── presentation/
-│   │   │   │   │       └── components/    # Only components, pages in app/
-│   │   │   │   └── products/              # Products feature
-│   │   │   └── billing/                   # Billing domain
-│   │   ├── inventory/                     # Inventory module
-│   │   └── users/                         # User module
+│   │   │   │   │       └── components/
+│   │   │   │   └── products/        # Products feature
+│   │   │   └── billing/             # Billing domain
+│   │   ├── inventory/               # Inventory module
+│   │   └── users/                   # User module
 │   │
 │   ├── shared/
-│   │   ├── components/         # Reusable UI components
-│   │   ├── hooks/              # Shared hooks
-│   │   ├── utils/              # Utility functions
-│   │   ├── types/              # Common TypeScript types
-│   │   └── constants/          # App constants
+│   │   ├── components/              # Reusable UI components
+│   │   │   └── ui/                  # shadcn/ui components
+│   │   ├── hooks/                   # Shared hooks
+│   │   ├── lib/                     # Utilities (utils.ts, api-client.ts)
+│   │   ├── types/                   # Common TypeScript types
+│   │   └── constants/               # App constants
 │   │
-│   ├── providers/              # React context providers
-│   ├── store/                  # Global Zustand stores
-│   └── middleware.ts           # Next.js middleware
+│   ├── app/                         # Global configuration
+│   │   ├── providers/               # React context providers
+│   │   └── store/                   # Global Zustand stores
+│   │
+│   └── infrastructure/              # Global external services
+│       ├── api/                     # API configuration
+│       ├── storage/                 # IndexedDB, localStorage
+│       └── pwa/                     # PWA configuration
 │
-├── lib/                        # Next.js utilities and configurations
-├── components/                 # Global UI components (alternative to src/shared)
-├── public/                     # Static assets and PWA manifest
-└── styles/                     # Additional stylesheets
+├── public/                          # Static assets and PWA manifest
+├── index.html                       # Vite entry point
+└── vite.config.ts                   # Vite + TanStack Router plugin config
 ```
 
+### TanStack Router Conventions
+
+| Prefix | Effect | Example |
+|--------|--------|---------|
+| `_` | Pathless layout (no URL segment) | `_app.tsx` → layout only |
+| `.` | Flat routing (nested without folders) | `orders.$id.tsx` → `/orders/:id` |
+| `-` | Ignored by router (colocated files) | `-components/` |
+| `$` | Dynamic parameter | `$orderId.tsx` → `:orderId` |
+
 ### Core Principles
 
 #### Clean Architecture First
@@ -71,7 +93,7 @@ Strict separation of:
 - **Domain layer** - Business entities, repositories interfaces, domain services, and types
 - **Application layer** - Use cases, hooks, and state management (Zustand stores)
 - **Infrastructure layer** - Repository implementations, API clients, and adapters
-- **Presentation layer** - UI components (pages go in `app/`, components in `presentation/`)
+- **Presentation layer** - UI components in `presentation/`, routes in `routes/`
 
 #### Domain-Driven Design
 Business logic drives architecture decisions. Organize by business modules and domains, not technical layers.
@@ -83,7 +105,7 @@ Build complex UIs from simple, reusable components.
 Leverage TypeScript for compile-time safety and developer experience.
 
 #### Performance by Design
-- Lazy loading
+- Lazy loading (automatic with TanStack Router)
 - Memoization
 - Bundle optimization
 
@@ -107,11 +129,11 @@ Use MCP to install Shadcn components instead of creating manually.
 
 ### Framework Selection Rules
 
-**Default**: Always use Next.js 16 with App Router unless explicitly told otherwise.
+**Default**: Always use Vite + TanStack Router with TypeScript.
 
-**Exceptions**: Only use pure React + Vite when user specifically mentions offline-first functionality or requests non-Next.js setup.
+**Microfrontends**: Use Vite + Module Federation for distributed architecture.
 
-**Reasoning**: Next.js provides better developer experience, built-in optimization, and easier deployment while maintaining PWA capabilities.
+**Reasoning**: Vite provides faster builds, TanStack Router offers type-safe routing, and the combination is prepared for microfrontends with Module Federation.
 
 ## Backend Architecture
 
@@ -388,9 +410,11 @@ app.MapScalarApiReference();  // NOT app.UseSwagger()
 ## Summary
 
 ### Frontend
-- **Framework**: Next.js 16 with TypeScript and App Router
+- **Bundler**: Vite 5+
+- **Router**: TanStack Router (file-based, type-safe)
+- **Framework**: React 18+ with TypeScript (strict mode)
 - **Architecture**: Clean Architecture + DDD
-- **State**: Zustand
+- **State**: Zustand (client) + TanStack Query (server)
 - **UI**: shadcn/ui + Radix UI + TailwindCSS v4
 - **Testing**: Vitest + React Testing Library
 - **Validation**: Zod + React Hook Form
@@ -412,4 +436,4 @@ app.MapScalarApiReference();  // NOT app.UseSwagger()
 3. **Test-Driven Development** - Tests before/alongside implementation
 4. **Database per Microservice** - Complete isolation between services
 5. **Type Safety** - TypeScript (frontend) and C# (backend) strong typing
-6. **Docker for Production** - Local development without containers
+6. **Docker for Production** - Local development without containers

package/bmad/bmm/workflows/3-solutioning/create-architecture/data/company-standards/technology-stack.md

@@ -2,26 +2,39 @@
 
 ## Frontend Stack
 
-### Framework
-- **Next.js 16** with TypeScript (App Router)
-  - Default framework unless explicitly told otherwise
-  - Built-in Turbopack/Webpack for building
-  - File-based routing with App Router
-  - Exception: Use pure React + Vite only when user specifically mentions offline-first functionality or requests non-Next.js setup
+### Bundler & Dev Server
+- **Vite 6+** with TypeScript
+  - Default bundler for all frontend projects
+  - Native ES modules for fast development
+  - Optimized for Module Federation (microfrontends)
+  - HMR (Hot Module Replacement) instantáneo
+
+### Router
+- **TanStack Router 1+** (file-based routing)
+  - Type-safe routing with auto-generated route tree
+  - File-based routing with special prefixes (`_`, `.`, `-`, `$`)
+  - Automatic code-splitting per route
+  - Integrated with TanStack Query
 
 ### State Management
-- **Zustand**
+- **Zustand 5+** (client state)
+  - Feature-based stores following DDD patterns
+  - Prepared for microfrontends (singleton stores)
+- **TanStack Query 5+** (server state)
+  - Cache and synchronization
+  - Optimistic updates
 
 ### UI Framework & Styling
-- **Shadcn/ui** (component library)
+- **shadcn/ui** (component library)
 - **Radix UI** (primitives)
 - **TailwindCSS v4** (styling)
 
 ### Architecture
 - **Clean Architecture** + **Domain-Driven Design (DDD)**
+- **Module/Domain/Feature** structure for enterprise scale
 
 ### Testing
-- **Vitest** (test runner)
+- **Vitest** (test runner - native Vite integration)
 - **React Testing Library** (component testing)
 - **MSW** (Mock Service Worker - API mocking)
 
@@ -33,11 +46,34 @@
 - **Axios** with interceptors
 
 ### Progressive Web App (PWA)
-- **Next.js PWA plugin**
+- **vite-plugin-pwa** (PWA plugin for Vite)
 - **Workbox** (service worker library)
 
-### Routing
-- **Next.js App Router** (file-based routing)
+## Microfrontends Configuration
+
+### Module Federation Shared Dependencies
+
+Para evitar dependencias duplicadas entre microfrontends:
+
+```typescript
+// vite.config.ts - Host y cada Remote
+import { federation } from '@module-federation/vite';
+
+federation({
+  shared: {
+    react: { singleton: true, requiredVersion: '^18.3.0' },
+    'react-dom': { singleton: true, requiredVersion: '^18.3.0' },
+    '@tanstack/react-router': { singleton: true, requiredVersion: '^1.95.0' },
+    '@tanstack/react-query': { singleton: true, requiredVersion: '^5.62.0' },
+    zustand: { singleton: true, requiredVersion: '^5.0.0' },
+  },
+})
+```
+
+| Configuración | Propósito |
+|---------------|-----------|
+| `singleton: true` | Garantiza una sola instancia en runtime |
+| `requiredVersion: '^x.x.0'` | Rango semver para flexibilidad sin romper compatibilidad |
 
 ## Core Principles
 
@@ -58,9 +94,10 @@ Build complex UIs from simple, reusable components
 Leverage TypeScript for compile-time safety and developer experience
 
 ### Performance by Design
-- Lazy loading
+- Lazy loading (automatic with TanStack Router)
 - Memoization
 - Bundle optimization
+- Singleton shared dependencies for microfrontends
 
 ### Accessibility as Standard
 WCAG 2.1 AA compliance in all components
@@ -233,3 +270,25 @@ Implement security at every layer
 ### Docker for Production Only
 - Development: dotnet run locally
 - Production: Docker containers
+
+## Version Summary
+
+### Frontend
+| Technology | Version | Notes |
+|------------|---------|-------|
+| Vite | 6+ | Bundler, optimized for Module Federation |
+| React | 18+ | Functional components, hooks |
+| TypeScript | 5+ | Strict mode enabled |
+| TanStack Router | 1+ | File-based, type-safe routing |
+| TanStack Query | 5+ | Server state management |
+| Zustand | 5+ | Client state management |
+| TailwindCSS | 4+ | Utility-first CSS |
+| Vitest | Latest | Native Vite test runner |
+
+### Backend
+| Technology | Version | Notes |
+|------------|---------|-------|
+| .NET | 10 | LTS |
+| Entity Framework Core | 10 | Matches .NET version |
+| PostgreSQL | 18+ | Mandatory, one per microservice |
+| xUnit | Latest | Testing framework |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siesa-agents",
-  "version": "2.1.46",
+  "version": "2.1.48",
   "description": "Paquete para instalar y configurar agentes SIESA en tu proyecto",
   "main": "index.js",
   "bin": {