wlmaker 1.9.1 → 1.9.2

package/README.md

@@ -1,833 +1,3 @@
-# Guía de Uso de wlmaker
+# wlmaker
 
-> **Para nuevos desarrolladores.** Aprendé a usar `wlmaker` para generar código Flutter/Dart
-> en monorepos Melos con Clean Architecture, BLoC, Freezed y Widgetbook.
-
----
-
-## 1. ¿Qué es wlmaker?
-
-**wlmaker** (alias: `wl`) es una CLI que **scaffoldea código Flutter/Dart** desde la terminal.
-Está pensada para equipos que trabajan con:
-
-- **Monorepos Melos** — múltiples paquetes y apps en un solo repo
-- **Clean Architecture** — separación en capas `data`, `domain`, `presentation`
-- **BLoC + Freezed** — manejo de estado con sealed classes
-- **Atomic Design** — sistema de diseño con átomos, moléculas, organismos y templates
-- **Widgetbook** — catálogo de componentes visuales
-- **BFF (Backend For Frontend)** — integración con Retrofit + DI automática
-
-En lugar de crear archivos a mano, wlmaker te hace las preguntas justas y genera todo el
-scaffold con barrels, imports y registros de dependencias actualizados automáticamente.
-
----
-
-## 2. Instalación y Primeros Pasos
-
-### Requisitos previos
-
-| Requisito | Versión mínima |
-|-----------|---------------|
-| Node.js   | 18+           |
-| pnpm      | Última estable |
-| Flutter SDK | 3.x         |
-| Un monorepo Melos | root `pubspec.yaml` con `workspace:` / `melos:` (Melos 8) o legacy `melos.yaml` |
-
-### Instalación
-
-```bash
-pnpm add -g wlmaker
-```
-
-Verificá que funcione:
-
-```bash
-wlmaker --version   # → 1.7.0
-wl --version        # alias más corto
-```
-
-### Primer comando
-
-Ejecutá `wlmaker` sin argumentos dentro de tu monorepo:
-
-```bash
-cd tu-monorepo/
-wlmaker
-```
-
-Te va a recibir un menú interactivo con todas las opciones disponibles:
-
-```
-┌  wlmaker  ┐
-│           │
-◇  What do you want to do?
-│  ● Vault          NEW — sync encrypted STG/PROD…
-│  ○ App
-│  ○ BLoC
-│  ○ Widget
-│  ○ Widgetbook Use-Case
-│  ○ Page
-│  ○ Endpoint
-│  ○ Package
-│  ○ Env Var
-│  ○ Collaborative
-│  ○ Docs
-└           ┘
-```
-
----
-
-## 3. Modos de Uso
-
-wlmaker tiene **dos modos** de uso:
-
-### Modo interactivo
-
-Ejecutás `wlmaker` sin argumentos (o `wlmaker <comando>` sin los argumentos requeridos) y
-la CLI te guía paso a paso con preguntas, validación y selección de opciones.
-
-**Ideal para:** cuando estás explorando, no recordás las opciones exactas, o preferís
-que te lleve de la mano.
-
-### Modo directo
-
-Pasás todos los argumentos en una sola línea. Útil para scripts, automatización, o cuando
-ya sabés exactamente qué querés.
-
-```bash
-wlmaker bloc user_login --no-build-runner
-wlmaker widget toggle -t atom
-wlmaker docs architecture
-```
-
-**Ideal para:** CI/CD, scripts del Makefile, power users.
-
----
-
-## 4. Guías Paso a Paso (Recetas)
-
-Cada receta explica **cuándo usarla**, cómo ejecutarla en **modo directo** e **interactivo**,
-y la estructura de archivos que vas a obtener.
-
----
-
-### 4.1 Crear un BLoC
-
-**Cuándo usarlo:** cuando necesitás manejar el estado de una pantalla o feature con
-BLoC + Freezed (sealed classes).
-
-#### Modo directo
-
-```bash
-wlmaker bloc user_login
-```
-
-Opciones disponibles:
-
-| Opción | Descripción |
-|--------|-------------|
-| `-d, --dir <path>` | Directorio donde crear el BLoC (default: cwd) |
-| `--no-build-runner` | No ejecutar `build_runner` después de generar |
-
-#### Modo interactivo
-
-```bash
-wlmaker bloc
-# → Seleccioná el proyecto
-# → Ingresá el nombre en snake_case
-# → Confirmá si querés correr build_runner
-```
-
-#### Resultado
-
-```
-lib/features/<feature>/
-├── bloc.dart                        # ← actualizado: agrega export
-└── user_login/
-    ├── user_login_bloc.dart         # Bloc + Event + State (partes)
-    ├── user_login_event.dart        # Evento sealed con Freezed
-    └── user_login_state.dart        # Estado sealed con Freezed
-```
-
-**Ejemplo:** `wlmaker bloc cart_checkout` genera `CartCheckoutBloc`, `CartCheckoutEvent`,
-y `CartCheckoutState`.
-
----
-
-### 4.2 Crear un Widget del Design System
-
-**Cuándo usarlo:** cuando necesitás crear un componente visual siguiendo Atomic Design
-(átomo, molécula, organismo, template).
-
-#### Tiers disponibles
-
-| Tier | Carpeta | Ejemplos |
-|------|---------|---------|
-| `atom` | `atoms/` | botón, input, ícono, texto |
-| `molecule` | `molecules/` | search bar, card header |
-| `organism` | `organisms/` | product card, checkout form |
-| `template` | `templates/` | page layout, scaffold |
-
-#### Modo directo
-
-```bash
-wlmaker widget toggle -t atom
-wlmaker widget search_bar -t molecule -p subdirectory-parts
-wlmaker widget product_card -t organism -p subdirectory-show
-```
-
-#### Modo desde JSON
-
-También podés generar un widget completo desde un archivo JSON con el árbol de componentes:
-
-```bash
-# Desde archivo
-wlmaker widget --file docs/examples/molecule-product-card.json
-
-# Desde JSON inline
-wlmaker widget --json '{"componentName":"WlCard","tier":"molecule","mode":"component",...}'
-```
-
-El JSON define propiedades, variantes, tokens, y el árbol completo de widgets (Container, Text, Icon, ComponentRef). Ver [`docs/JSON_SCHEMA.md`](docs/JSON_SCHEMA.md) para la documentación completa del formato.
-
-**Modos disponibles:**
-- `"mode": "component"` — genera el widget completo
-- `"mode": "skeleton"` — genera solo el skeleton y lo vincula al componente existente (inyecta `part`, `isLoading`, y `if (isLoading) return WlXxxSkeleton()`)
-
-**Widgetbook automático:** al generar un componente desde JSON, también se crea el use-case de Widgetbook con knobs interactivos para cada propiedad.
-
-**Ejemplos:** ver `docs/examples/` con JSONs de prueba para atom, molecule, organism, template y skeleton.
-
-#### Patrones por tier
-
-| Tier | Patrones disponibles |
-|------|---------------------|
-| `atom` | `single-public` (default), `single-factory` |
-| `molecule` | `single` (default), `subdirectory-parts`, `subdirectory-widgets` |
-| `organism` | `subdirectory-show` (default), `single` |
-| `template` | `simple` (default) |
-
-#### Modo interactivo
-
-```bash
-wlmaker widget
-# → Ingresá el nombre
-# → Seleccioná el tier
-# → Elegí el patrón
-```
-
-#### Resultado
-
-Se genera el widget en `packages/design_system/lib/wl_design_system/<tier>/<widget>/`
-y **automáticamente** se crea su use-case de Widgetbook.
-
----
-
-### 4.3 Crear un Use-Case de Widgetbook
-
-**Cuándo usarlo:** cuando ya tenés un widget y querés agregarle un showcase en Widgetbook
-para que diseño/testers puedan verlo en aislamiento.
-
-#### Modo directo
-
-```bash
-wlmaker usecase toggle -t atom
-```
-
-#### Opciones
-
-| Opción | Descripción |
-|--------|-------------|
-| `-t, --tier` | Tier del widget (requerido) |
-| `-d, --dir` | Raíz del proyecto (default: cwd) |
-| `--no-build-runner` | No ejecutar build_runner |
-
-#### Resultado
-
-Se genera el use-case en `apps/widgetbook/lib/usecases/<tier>/` y se actualiza el barrel
-de Widgetbook automáticamente.
-
----
-
-### 4.4 Crear una Página (GoRoute + View)
-
-**Cuándo usarlo:** cuando necesitás crear una pantalla nueva con navegación tipo GoRouter.
-
-#### Modo directo
-
-```bash
-wlmaker page profile -p /ruta/a/pages/
-```
-
-#### Opciones
-
-| Opción | Descripción |
-|--------|-------------|
-| `-p, --path` | Ruta absoluta al directorio `pages/` del feature |
-
-#### Modo interactivo
-
-```bash
-wlmaker page
-# → Ingresá el nombre (o dejalo vacío para elegir del menú)
-# → Seleccioná o ingresá la ruta al directorio pages/
-```
-
-#### Resultado
-
-```
-lib/features/<feature>/presentation/pages/
-├── pages.dart                      # ← actualizado: agrega export
-└── profile/
-    ├── profile_page.dart           # GoRoute + page builder
-    └── profile_view.dart           # Widget de la vista
-```
-
----
-
-### 4.5 Crear un Endpoint BFF
-
-**Cuándo usarlo:** cuando necesitás integrar un nuevo endpoint del Backend For Frontend
-con toda la stack de Clean Architecture.
-
-#### Modo interactivo (único disponible)
-
-```bash
-wlmaker endpoint
-```
-
-El flujo te va a preguntar:
-
-1. **Proyecto** — detecta automáticamente el paquete de feature
-2. **Método HTTP** — `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
-3. **Path del endpoint** — ej. `/api/v1/users/{userId}`
-4. **Nombre del caso de uso** — en snake_case, ej. `get_user_profile`
-5. **Archivo BFF API** — lo detecta automáticamente por dominio
-6. **Target de DI** — `app_base`, `app_base_loyalty`, o `none`
-7. **@lazySingleton** — si las dependencias se registran como lazy
-
-#### Resultado
-
-```
-lib/
-├── data/
-│   ├── datasources/
-│   │   └── <domain>_rest_datasource.dart  # ← método inyectado
-│   ├── models/
-│   │   └── <feature>/
-│   │       ├── <feature>.dart              # ← barrel actualizado
-│   │       ├── get_user_profile_model.dart
-│   │       └── get_user_profile_request_model.dart  # (si es POST/PUT/PATCH)
-│   └── repositories/
-│       └── <domain>_repository_data.dart   # ← implementación inyectada
-├── domain/
-│   ├── entities/
-│   │   └── <feature>/
-│   │       ├── <feature>.dart              # ← barrel actualizado
-│   │       └── get_user_profile_entity.dart
-│   ├── repositories/
-│   │   └── <domain>_repository.dart        # ← interfaz inyectada
-│   └── usecases/
-│       └── <feature>/
-│           ├── <feature>.dart              # ← barrel actualizado
-│           └── get_user_profile_usecase.dart
-```
-
-Además, si elegiste un target de DI, se registran los módulos automáticamente:
-- `DataSourceModule` ← datasource
-- `RepositoriesModule` ← repository impl
-- `UseCasesModule` ← use case
-
----
-
-### 4.6 Crear un Paquete
-
-**Cuándo usarlo:** cuando necesitás crear un paquete nuevo dentro del monorepo Melos.
-
-#### Modo interactivo
-
-```bash
-wlmaker package
-```
-
-#### Resultado
-
-```
-packages/<nombre>/
-├── lib/
-│   ├── <nombre>.dart       # barrel principal
-│   └── src/
-│       └── <nombre>.dart   # implementación base
-├── test/
-├── pubspec.yaml            # configurado con referencias del workspace
-├── analysis_options.yaml
-├── Makefile
-└── .gitignore
-```
-
-Además se actualizan:
-- `.vscode/<monorepo>.code-workspace` — agrega la referencia al paquete
-- `.helix/config` — si existe
-
----
-
-### 4.7 Agregar Variable de Entorno
-
-**Cuándo usarlo:** cuando necesitás agregar una variable de entorno (API key, URL, flag)
-a través de toda la stack del monorepo.
-
-#### Modo interactivo
-
-```bash
-wlmaker env-var
-```
-
-#### Resultado
-
-La variable se inyecta en **6 capas**:
-
-1. Archivos JSON de entorno por app (dev, qa, prod)
-2. `AppEnvironment` — getter abstracto
-3. `AppBuildEnvironment` — implementación concreta
-4. `VendorsModule` — defaults de RemoteConfig
-5. `AppConfig` — entidad
-6. `AppConfigModel` — modelo
-
----
-
-### 4.8 Crear una App
-
-**Cuándo usarlo:** cuando necesitás crear una nueva aplicación Flutter en el monorepo
-(ej. app de Colombia, app de Chile, etc.).
-
-#### Modo interactivo
-
-```bash
-wlmaker app
-```
-
-El flujo te permite:
-- Crear un **App Type** (tipo de mercado con locale, países soportados: CO, AR, CL, PE, EC, UY, BR, US)
-- Crear una **App** completa con:
-  - `pubspec.yaml` configurado
-  - `flavorizr` (flavors: dev, qa, prod)
-  - Assets (PNGs, Lottie JSONs)
-  - Tema del design system
-  - Configs de Android (Kotlin + Gradle)
-  - Entitlements de iOS
-  - Registro en Widgetbook
-  - GitHub Actions workflows
-
----
-
-### 4.9 Crear un Feature Colaborativo
-
-**Cuándo usarlo:** cuando necesitás crear una feature completa que sigue el patrón
-colaborativo del equipo (estructura predefinida con Clean Architecture, DI, barrels).
-
-#### Modo directo
-
-```bash
-wlmaker collaborative feature feature_orders
-```
-
-#### Modo interactivo
-
-```bash
-wlmaker collaborative
-# → Elegí "feature"
-# → Ingresá el nombre en snake_case
-```
-
-#### Resultado
-
-```
-packages/collaborative/<feature>/
-├── lib/
-│   ├── data/
-│   │   ├── api/bff/
-│   │   ├── datasources/
-│   │   ├── models/
-│   │   └── repositories/
-│   ├── domain/
-│   │   ├── entities/
-│   │   ├── repositories/
-│   │   └── usecases/
-│   ├── presentation/
-│   │   ├── bloc/
-│   │   └── pages/
-│   └── di/                        # Módulos de inyección
-├── pubspec.yaml
-└── .gitignore
-```
-
----
-
-### 4.10 Agregar Página a Feature Colaborativo
-
-```bash
-wlmaker collaborative page order_detail -f packages/collaborative/feature_orders
-```
-
-Agrega `order_detail_page.dart` + `order_detail_view.dart` y actualiza barrels.
-
----
-
-### 4.11 Agregar BLoC a Feature Colaborativo
-
-```bash
-wlmaker collaborative bloc order_form -f packages/collaborative/feature_orders
-```
-
-Agrega `order_form_bloc.dart`, `order_form_event.dart`, `order_form_state.dart` y
-actualiza el barrel del feature.
-
----
-
-### 4.12 Agregar Endpoint a Feature Colaborativo
-
-```bash
-wlmaker collaborative endpoint
-# → Flujo interactivo guiado, similar a 4.5 pero dentro del feature colaborativo
-```
-
----
-
-### 4.13 Scaffold de Personal Information (por país)
-
-**Cuándo usarlo:** cuando necesitás crear el formulario de datos personales para un nuevo
-mercado (país). Cada mercado puede tener distintos campos, validaciones, y modos de documento.
-
-#### Modo interactivo (único disponible)
-
-```bash
-wlmaker
-# → Elegí "Personal Information"
-```
-
-El flujo te pregunta:
-
-| Paso | Qué define |
-|------|-----------|
-| AppType | Tipo de app/mercado (CO, AR, BR, etc.) |
-| Market code | Código de 2 letras para la carpeta (ej. `co`, `ar`) |
-| Market name | Nombre en PascalCase (ej. `Colombia`) |
-| Campos | name, surname, email, document, gender, birthDate, issueDate, phone, loyaltyId |
-| Modo documento | `selector` (tipo + número) o `custom` (input dedicado) |
-| Formato fecha | `dd/MM/yyyy`, `MM/dd`, `MM/dd/yyyy`, `yyyy-MM-dd` |
-| Phone preset | `default-full`, `brazil-full`, `local-only`, `custom` |
-| Editabilidad | Campos editables después de guardar, bloqueados, siempre editables |
-| Opciones booleanas | Skip email, account deletion, block fields, document card, info alert, info text, delete buttons por plataforma |
-
-#### Resultado
-
-```
-packages/personal_information/lib/countries/<code>/
-├── pi_config_<pais>.dart         # Configuración específica del mercado
-├── pi_field_validation_<pais>.dart
-├── personal_information_form_<pais>.dart
-├── personal_information_body_<pais>.dart
-├── inputs/                       # Widgets de input específicos
-├── widgets/                      # Widgets compuestos
-└── barrels actualizados
-```
-
----
-
-### 4.14 Vault — Compartir Variables de Entorno Cifradas
-
-> **Guía para el día a día:** [`docs/VAULT.md`](docs/VAULT.md) — onboarding, cuándo hacer apply/capture y FAQ (español neutro).
-
-**Cuándo usarlo:** cuando necesitás distribuir valores reales de `development.env.json`
-(STG) y `production.env.json` (PROD) entre el equipo sin mandarlos por Slack ni 1Password,
-y sin perder el rastro de quién tiene acceso. Vault guarda cada valor cifrado dentro del
-repo (`.wlmaker.vault.json`) y solo lo materializa en texto plano en tu máquina cuando vos
-lo pedís explícitamente con Apply.
-
-Vault **complementa** a `wlmaker env-var` (4.7), no lo reemplaza: primero declarás la
-variable con `env-var` (eso la agrega a `example.env.json`, la plantilla committeada), y
-recién después la capturás en el Vault con el valor real. `example.env.json` sigue siendo
-el allowlist — Capture rechaza cualquier clave que no esté ahí, porque los nombres viajan
-en texto plano dentro del ciphertext y en v1 todo el equipo aprobado puede descifrar STG y
-PROD.
-
-#### Identidad local (una sola vez por persona)
-
-Cada persona tiene un par de llaves X25519 en `~/.wlmaker/identity`, cifrado en disco con
-una passphrase que vos elegís (scrypt + AES-256-GCM). Nadie más puede usar tu identidad sin
-esa passphrase, y no existe una "llave maestra": perder el archivo *y* la passphrase te deja
-sin acceso hasta que alguien te vuelva a aprobar.
-
-#### Modo interactivo
-
-```bash
-wlmaker
-# → Vault (primera opción del menú)
-# o: wlmaker vault
-```
-
-El submenú de Vault ofrece:
-
-| Acción | Qué hace |
-|--------|----------|
-| Status | Apps capturadas, cantidad de recipients/pendientes, tu estado de acceso |
-| Init | Crea el vault (una sola vez por monorepo) con vos como primer recipient |
-| Capture | Sella los valores locales de un app en el vault (respeta el allowlist de `example.env.json`) |
-| Apply | Descifra y escribe los valores del vault en `development.env.json` / `production.env.json` locales |
-| Diff | Compara tus archivos locales contra el vault sin mostrar valores descifrados |
-| Request Access | Pide unirte al keyring compartido (no necesita tener acceso previo) |
-| Approve | Aprueba una solicitud pendiente y le da acceso a STG + PROD juntos |
-| Who | Lista recipients y solicitudes pendientes (sin exponer llaves) |
-| Identity | Muestra tu fingerprint y clave pública (para compartir al pedir acceso) |
-| Revoke | Saca a un recipient y rota la data key compartida, invalidando su copia anterior |
-
-#### Modo directo
-
-```bash
-wlmaker vault status
-wlmaker vault init
-wlmaker vault capture --app co_jumbo
-wlmaker vault apply --app co_jumbo --env production
-wlmaker vault diff --app co_jumbo
-wlmaker vault who
-wlmaker vault identity
-wlmaker vault revoke
-```
-
-| Opción | Aplica a | Descripción |
-|--------|----------|-------------|
-| `--app <name>` | `capture`, `apply`, `diff` | App a targetear (si se omite, te lo pregunta) |
-| `--env <development\|production>` | `capture`, `apply`, `diff` | Limita a un solo entorno (default: ambos) |
-| `--force` | `capture` | Sella claves no declaradas en `example.env.json` sin la confirmación tipeada |
-
-Si corrés `wlmaker vault` sin una acción, se abre el mismo submenú interactivo.  
-(`wlmaker app vault` sigue funcionando como alias.)
-
-#### Qué se commitea y qué no
-
-| Archivo | Se commitea | Contenido |
-|---------|-------------|-----------|
-| `.wlmaker.vault.json` (raíz del monorepo) | **Sí** | Ciphertext AES-256-GCM por valor, nombres de variable en texto plano, recipients y su llave pública |
-| `apps/<app>/env/example.env.json` | **Sí** | Plantilla — nombres de variables permitidas, sin valores reales |
-| `apps/<app>/env/development.env.json` / `production.env.json` | **No** (gitignored) | Valores reales en texto plano, escritos solo por Apply |
-| `~/.wlmaker/identity` | **No** — vive fuera del repo | Tu llave privada X25519, cifrada con tu passphrase |
-
-Antes de escribir un archivo, Apply verifica que el `.gitignore` de `apps/<app>/env/` lo
-cubra (`*.json` + `!example.env.json`); si no puede probarlo, aborta sin escribir nada.
-
----
-
-## 5. Herramientas de Documentación
-
-### 5.1 Servir Documentación (Docusaurus)
-
-```bash
-wlmaker docs serve
-```
-
-Busca el directorio `book/` en el monorepo, instala dependencias npm si es necesario,
-y levanta el servidor de desarrollo de Docusaurus.
-
-```bash
-wlmaker docs serve -d /ruta/al/monorepo
-```
-
-### 5.2 Listar Comandos del Proyecto
-
-```bash
-wlmaker docs commands
-```
-
-Escanea los `Makefile` (raíz y book) y los scripts Melos (`melos.yaml` legacy o `melos.scripts` en el `pubspec.yaml` raíz) para extraer todos los comandos
-disponibles y los muestra agrupados por fuente:
-
-```
-Found 24 command(s)
-
-Makefile
-  ├── gen        → dart run build_runner build --delete-conflicting-outputs
-  ├── format     → dart format lib test
-  ├── test       → flutter test
-  └── ...
-
-Melos
-  ├── analyze    → melos run analyze
-  ├── gen:all    → melos run gen:all
-  └── ...
-```
-
-### 5.3 Ver Arquitectura del Monorepo
-
-```bash
-wlmaker docs architecture
-```
-
-Muestra un árbol del monorepo con apps, paquetes, sus dependencias clave, sistema de
-diseño y documentación:
-
-```
-dc-wl-groceries-app  (/Users/...)
-
-├── apps/
-│   ├── app_co
-│   ├── app_ar
-│   └── widgetbook
-│
-├── packages/
-│   ├── app_base         [flutter_bloc, retrofit, go_router]
-│   ├── core             [freezed, json_serializable]
-│   ├── design_system    [flutter_bloc, widgetbook]
-│   │   └── features/
-│   │       ├── home     [flutter_bloc, freezed]
-│   │       ├── cart     [flutter_bloc, freezed, injectable]
-│   │       └── ...
-│
-├── design_system (atoms, molecules, organisms, templates)
-├── book/ (Docusaurus)
-└── pubspec.yaml (workspace: + melos: — Melos 8) / melos.yaml (legacy)
-```
-
----
-
-## 6. Consejos y Mejores Prácticas
-
-### Dónde ejecutar cada comando
-
-| Comando | Dónde ejecutarlo |
-|---------|-----------------|
-| `bloc`, `widget`, `usecase`, `page` | En el paquete del feature (ej. `packages/features/cart/`) |
-| `endpoint` | En el paquete del feature |
-| `package`, `app`, `env-var` | Raíz del monorepo (donde está el `pubspec` con `workspace:` / `melos.yaml`) |
-| `collaborative` | Raíz del monorepo |
-| `personal-information` | Raíz del monorepo (necesita `packages/personal_information/`) |
-| `docs` | Raíz del monorepo |
-
-### Barrels automáticos
-
-**No edites los barrels a mano.** wlmaker actualiza automáticamente:
-- `bloc.dart` en features
-- Barriles de tier del design system
-- `datasources.dart`, `entities.dart`, `models.dart`, `usecases.dart`
-- Barriles internos de cada dominio
-
-Si ves una exportación duplicada, wlmaker la detecta y la omite.
-
-### Cuándo usar `--no-build-runner`
-
-Usá `--no-build-runner` cuando:
-- Estás generando varios BLoCs/widgets en lote y querés correr `build_runner` una sola vez al final
-- Ya sabés que build_runner va a fallar (ej. faltan dependencias)
-- Estás en CI y build_runner se ejecuta en otro paso
-
-### Resolución automática de proyectos
-
-Cuando ejecutás un comando que necesita un proyecto Flutter, wlmaker busca en este orden:
-
-1. **Directorio actual** — ¿tiene `pubspec.yaml` con `freezed` o `flutter_bloc`?
-2. **Monorepo Melos** — ¿estamos dentro de un monorepo? Escanea `packages/` y `packages/features/`
-3. **~/Development** — busca proyectos Flutter hasta 2 niveles de profundidad
-
-Si hay múltiples proyectos, te muestra un selector interactivo.
-
----
-
-## 7. Preguntas Frecuentes
-
-### "No encuentra mi proyecto"
-
-wlmaker busca `pubspec.yaml` que contenga `freezed` o `flutter_bloc` en sus dependencias.
-
-**Solución:** asegurate de que tu `pubspec.yaml` tenga al menos uno de estos paquetes.
-
-### "Not inside a monorepo"
-
-Varios comandos (`package`, `app`, `collaborative`, `personal-information`, `docs`)
-requieren estar dentro de un monorepo Melos.
-
-**Solución:** ejecutalos desde la raíz del monorepo (donde el `pubspec.yaml` tiene
-`workspace:` / `melos:`, o existe un `melos.yaml` legacy) o desde cualquier
-subdirectorio — wlmaker busca hacia arriba.
-
-### "El build_runner falla"
-
-Si `dart run build_runner build` falla después de generar un BLoC, puede ser por:
-- Dependencias faltantes en el `pubspec.yaml`
-- Código Dart con errores de sintaxis
-- Conflicto con archivos generados anteriores
-
-**Soluciones:**
-1. Usá `--no-build-runner` y corré build_runner manualmente después
-2. Ejecutá `dart run build_runner clean` antes de reintentar
-3. Revisá que `build_runner`, `freezed`, y `json_serializable` estén en `dev_dependencies`
-
-### "packages/personal_information not found"
-
-El comando de Personal Information necesita que exista el paquete `packages/personal_information`
-en tu monorepo.
-
-**Solución:** primero creá el paquete base con `wlmaker package` o asegurate de que el
-paquete exista en el monorepo.
-
-### "No AppTypes found"
-
-El scaffold de Personal Information requiere al menos un AppType definido en
-`packages/localization/lib/enum/app_type.dart`.
-
-**Solución:** ejecutá `wlmaker app` primero y creá un App Type.
-
----
-
-## 8. Referencia Rápida de Comandos
-
-### Comandos principales
-
-| Comando | Argumento | Opciones principales | Descripción |
-|---------|-----------|---------------------|-------------|
-| `wlmaker` | — | — | Modo interactivo (menú) |
-| `wlmaker bloc` | `[name]` | `-d`, `--no-build-runner` | Crear BLoC con Freezed |
-| `wlmaker widget` | `<name>` | `-t` (tier), `-p` (pattern), `-j` (json), `-f` (file) | Crear widget del design system |
-| `wlmaker usecase` | `<name>` | `-t` (tier), `--no-build-runner` | Crear use-case de Widgetbook |
-| `wlmaker page` | `[name]` | `-p` (pages path) | Crear página GoRoute + View |
-| `wlmaker endpoint` | — | — | Stack completa de endpoint BFF |
-| `wlmaker package` | — | — | Crear paquete en el monorepo |
-| `wlmaker env-var` | — | — | Agregar variable de entorno |
-| `wlmaker vault` | `[status\|init\|capture\|apply\|diff\|request-access\|approve\|who\|identity\|revoke]` | `--app`, `--env`, `--force` | Vault: sincronizar env cifrados entre el equipo |
-| `wlmaker app` | — | — | Crear y gestionar apps |
-
-### Comandos colaborativos
-
-| Comando | Argumento | Opciones | Descripción |
-|---------|-----------|----------|-------------|
-| `wlmaker collaborative` | — | — | Menú interactivo colaborativo |
-| `wlmaker collaborative feature` | `[name]` | — | Crear feature colaborativa completa |
-| `wlmaker collaborative page` | `[name]` | `-f` (feature path) | Agregar página a feature |
-| `wlmaker collaborative bloc` | `[name]` | `-f` (feature path) | Agregar BLoC a feature |
-| `wlmaker collaborative endpoint` | — | — | Agregar endpoint a feature |
-
-### Comandos de documentación
-
-| Comando | Opciones | Descripción |
-|---------|----------|-------------|
-| `wlmaker docs serve` | `-d` (project root) | Servir Docusaurus |
-| `wlmaker docs commands` | `-d` (project root) | Listar Makefile + Melos scripts |
-| `wlmaker docs architecture` | `-d` (project root) | Mostrar árbol del monorepo |
-
-### Flags comunes
-
-| Flag | Aplica a | Descripción |
-|------|----------|-------------|
-| `-d, --dir <path>` | `bloc`, `widget`, `usecase` | Directorio del proyecto |
-| `--no-build-runner` | `bloc`, `usecase` | No ejecutar build_runner |
-| `-t, --tier <tier>` | `widget`, `usecase` | Tier: atom, molecule, organism, template |
-| `-p, --pattern <pattern>` | `widget` | Patrón del widget |
-| `-p, --path <path>` | `page` | Ruta al directorio pages/ |
-| `-f, --feature <path>` | `collaborative page`, `collaborative bloc` | Ruta al paquete del feature |
-| `-j, --json <json>` | `widget` | JSON string con el árbol del componente |
-| `-f, --file <path>` | `widget` | Ruta a archivo JSON con el árbol del componente |
-
----
-
-## ¡Eso es todo!
-
-Si tenés dudas, revisá el [README](../README.md) o abrí un issue en
-[github.com/MatiasZL/wlmaker-cli](https://github.com/MatiasZL/wlmaker-cli).
+La documentación oficial está disponible en [wlmaker-docs]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wlmaker",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "description": "Create Flutter BLoCs with Freezed sealed classes from the terminal",
   "keywords": [
     "flutter",