zugzbot 1.4.0 → 1.5.0

package/.opencode/agents/sdd-orchestrator.md

@@ -50,12 +50,13 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
     1. **Inicialización Atómica**: Llama obligatoriamente a `sdd_get_initial_session_data` para obtener estado, memorias e Oh-My-Design en un solo turno.
     2. **Brain Pre-carga (OBLIGATORIO)**: Inmediatamente después, invoca `brain_read_memory({ category: "learnings" })` y `brain_read_memory({ category: "errors" })` para extraer errores y lecciones históricas que prevengan repetir problemas conocidos. Guarda el resultado en una variable interna para inyectarlo en cada brief de subagente.
     2.5 **Detección de intención de catálogo externo (CRÍTICO — bugfix sesión 1176)**: Analiza la petición. Si contiene ALGUNA keyword de marketing/landing/auth/composite, animaciones/shaders/WebGL, AI components, o un nombre propio de cualquier catálogo:
-       - Keywords marketing/landing (shadcn): `hero`, `landing`, `pricing`, `features`, `faq`, `testimonials`, `footer`, `cta`, `navbar`, `stats`, `logo cloud`, `login page`, `signup page`, `forgot password`, `chart`, `sidebar`, `dashboard section`, `comparison`, `use cases`, `how it works`, `changelog`, `cookie banner`, `newsletter`, `bento`, `marquee`, `gallery`, `integration`
+       - Keywords marketing/landing (shadcn): `hero`, `landing`, `pricing`, `features`, `faq`, `testimonials`, `footer`, `cta`, `navbar`, `logo cloud`, `comparison`, `use cases`, `how it works`, `changelog`, `cookie banner`, `newsletter`, `bento`, `marquee`, `gallery`, `integration`
+       - Keywords forms/stats/tables (blocks-so): `form`, `formulario`, `stats`, `métricas`, `KPIs`, `tabla`, `data table`, `data grid`, `file upload`, `subir archivo`, `drag and drop`, `dialog`, `modal`, `command menu`, `command palette`, `onboarding`, `ai component`, `ai chat`, `grid list`, `login page`, `signup page`, `forgot password`
        - Keywords animaciones (reactbits): `shader`, `webgl`, `gsap`, `framer-motion`, `three.js`, `drei`, `animated background`, `animated text`, `gradient mesh`, `magnet`, `floating dock`, `cursor`, `particles`, `noise`, `orbit`, `aurora`, `dither`, `iridescence`, `blob`, `glare`, `staggered`, `magic bento`, `electric border`, `metallic paint`
-       - Nombres propios: `akash`, `akash3444`, `shadcnui-blocks`, `shadcn-ui-blocks`, `basecn`, `shadcn blocks`, `reactbits`, `react-bits`, `david haz`
-       - **Acción obligatoria**: cargar la skill `shadcn-templates` (que ahora referencia las tools MCP `sdd_catalog_list_blocks`, `sdd_catalog_get_block` y `sdd_catalog_warm_index` — NUNCA uses `webfetch` directo a GitHub/reactbits.dev; esta cacheado).
-       - En modo HIL: llama `sdd_catalog_list_blocks({category, limit: 5, registry: 'all'})` y presenta las 2-3 mejores opciones con `preview_url` para que el usuario elija. **Incluir siempre `preview_url` en la respuesta** — para reactbits el demo es animado y el usuario puede ver cómo se ve antes de instalar.
-       - En modo autopiloto (`/loop`): llama `sdd_catalog_get_block({name})` sobre 2-3 candidatos (uno de cada registry) y elige el que mejor encaje.
+       - Nombres propios: `akash`, `akash3444`, `shadcnui-blocks`, `shadcn-ui-blocks`, `basecn`, `shadcn blocks`, `reactbits`, `react-bits`, `david haz`, `ephraim`, `ephraimduncan`, `blocks.so`, `blocks-so`, `blocks so`
+       - **Acción obligatoria**: cargar la skill `shadcn-templates` (que ahora referencia las tools MCP `sdd_catalog_list_blocks`, `sdd_catalog_get_block` y `sdd_catalog_warm_index` — NUNCA uses `webfetch` directo a GitHub/reactbits.dev/blocks.so; esta cacheado).
+       - En modo HIL: llama `sdd_catalog_list_blocks({category, limit: 5, registry: 'all'})` y presenta las 2-3 mejores opciones con `preview_url` para que el usuario elija. **Incluir siempre `preview_url` en la respuesta** — para reactbits el demo es animado, para blocks.so es live en `https://blocks.so/<category>/<name>`, y el usuario puede ver cómo se ve antes de instalar.
+       - En modo autopiloto (`/loop`): llama `sdd_catalog_get_block({name})` sobre 2-3 candidatos (uno de cada registry) y elige el que mejor encaje. Prioriza `blocks-so` si la keyword cae en sus 11 categorías (stats, login, form-layout, file-upload, tables, dialogs, sidebar, command-menu, ai, onboarding, grid-list).
        - Esto evita el ciclo "ping-pong" de 3+ turnos que vimos en sesión 1176 donde el usuario tuvo que guiar al orquestador hacia el catálogo correcto.
     3. **Detección Fast-Track Dashboard (CRÍTICO — bugfix sesión 1186 y 1180)**: Analiza la petición del usuario. Si contiene ALGUNA de estas keywords: `dashboard`, `admin panel`, `panel de control`, `panel admin`, `crm`, `erp`, `panel`:
        - **NO preguntes NADA**. Asume todos los defaults: Stack = Next.js 16 + Shadcn UI + Tailwind v4, Persistencia = localStorage/mock, Diseño = `default` (zinc nativo de Shadcn, NO inyectar marcas de Oh-My-Design), Verificación = `console`.
@@ -142,7 +143,7 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
          - Anúnciala en 1 línea y delega la siguiente iteración completa a un NUEVO hilo `sdd-orchestrator` con contexto de 0 tokens.
        - Si `loopCurrentIteration >= loopTargetIterations` o modo normal: Concluye con `sdd_set_phase({ phase: "F0_DETECT", loopMode: false })`.
     2. **Brain save OBLIGATORIO**: Sintetiza 1-3 lecciones y regístralas con `brain_save_memory` (categoría: `learnings`, `errors`, `design` o `routing`). BLOQUEANTE — no omitir.
-    2.5 **Memory Post-Sesión para Catálogos (CRÍTICO — bugfix sesión 1176)**: Si la sesión tocó cualquier catálogo externo de UI (Akash shadcn-ui-blocks, basecn, reactbits.dev), registra OBLIGATORIAMENTE en `brain.routing`:
+    2.5 **Memory Post-Sesión para Catálogos (CRÍTICO — bugfix sesión 1176)**: Si la sesión tocó cualquier catálogo externo de UI (Akash shadcn-ui-blocks, basecn, reactbits.dev, blocks.so), registra OBLIGATORIAMENTE en `brain.routing`:
        - URL canónica del catálogo
        - Comando `npx shadcn@latest add <URL>` listo para usar
        - Nombre del autor/repo (para evitar redescubrimiento en próximas sesiones)
@@ -164,7 +165,7 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
 <mcp_guidelines>
 - **MCPs**: `shadcn` (UI), `context7` (APIs Next.js/FastAPI), `playwright` (Visual tests), `lucide-icons` (Iconos).
 - `next-devtools` deshabilitado por defecto. MCPs invocados exclusivamente por subagentes.
-- **Catálogos externos (Tools internas)**: `sdd_catalog_list_blocks`, `sdd_catalog_get_block`, `sdd_catalog_warm_index` — cachean el catálogo unificado (Akash shadcn-ui-blocks + basecn + reactbits.dev) en `.openspec/cache/` con TTL 7d (Akash/Basecn) y 1d (reactbits). NUNCA uses `webfetch` directo a GitHub o reactbits.dev para descubrir bloques; usa siempre estas tools. Solo se soportan registries con catálogo JSON oficialmente discoverable.
+- **Catálogos externos (Tools internas)**: `sdd_catalog_list_blocks`, `sdd_catalog_get_block`, `sdd_catalog_warm_index` — cachean el catálogo unificado (Akash shadcn-ui-blocks + basecn + reactbits.dev + blocks.so) en `.openspec/cache/` con TTL 7d (Akash/Basecn/blocks-so) y 1d (reactbits). NUNCA uses `webfetch` directo a GitHub o reactbits.dev para descubrir bloques; usa siempre estas tools. Solo se soportan registries con catálogo JSON oficialmente discoverable.
 </mcp_guidelines>
 
 <communication_rules>

package/.opencode/rules/sdd-global.md

@@ -33,14 +33,18 @@ Para optimizar el tiempo de desarrollo, garantizar una experiencia visual premiu
   - **Preservación de Datos Dummy**: El archivo de datos del bloque (por ejemplo, `data.json` o constantes locales) debe mantenerse intacto en su ruta inyectada por la CLI en esta Fase A para garantizar que la vista se muestre de inmediato en el navegador exactamente idéntica al demo real.
 - **Sustitución Atómica de Datos en Fase B**: Una vez que el bloque compila e interactúa en el navegador de manera idéntica al demo con los datos de ejemplo, el Coder procederá de forma exclusiva a sustituir los datos mock por lógica y fetchings de datos dinámicos del backend, manteniendo intactos los contenedores estructurales del bloque (grids de diseño, paddings y contenedores flex) sin alteración alguna para evitar aberraciones visuales.
 - **Resolución Activa de Conflictos de Ruteo por Inyección de Bloques**: Si la CLI de Shadcn inyecta automáticamente una estructura de rutas (ej: `src/app/dashboard/page.tsx`) que compite con las rutas del contrato (como un route group `(dashboard)` o una ruta raíz), el Coder **debe** borrar o refactorizar de inmediato el código inyectado por defecto para evitar bucles de redirección infinitos o colisiones en el router.
-- **Catálogo Unificado `sdd_catalog` (3 registries, todos discoverables)**: Antes de inventar cualquier layout/bloque desde cero, el Spec-Writer (F1) y el Coder (F2) **deben** consultar `sdd_catalog_list_blocks({ registry: "all", category: "<cat>" })`. El catálogo cubre 3 fuentes con catálogo JSON oficial en un solo tool:
-  1. **`shadcn`** (akash3444/shadcn-ui-blocks, GitHub Contents API) — ~540 bloques Radix/Next.js curados. **Default** para marketing, landing, auth, dashboards, footers.
+- **Catálogo Unificado `sdd_catalog` (4 registries, todos discoverables)**: Antes de inventar cualquier layout/bloque desde cero, el Spec-Writer (F1) y el Coder (F2) **deben** consultar `sdd_catalog_list_blocks({ registry: "all", category: "<cat>" })`. El catálogo cubre 4 fuentes con catálogo JSON oficial en un solo tool:
+  1. **`shadcn`** (akash3444/shadcn-ui-blocks, GitHub Contents API) — ~540 bloques Radix/Next.js curados. **Default** para marketing, landing, hero, pricing, features, faq, testimonials, footer, cta, navbar, logo-cloud, bento, marquee, comparison, use-cases, how-it-works, changelog, cookie-banner, newsletter.
   2. **`basecn`** (akash3444/basecn, GitHub Contents API) — ~60 bloques fork Base UI. Usar solo si el proyecto está en Base UI.
   3. **`reactbits`** (reactbits.dev, `/r/registry.json` oficial shadcn-compatible) — 134 primitivas animadas × 4 variantes (JS-CSS/JS-TW/TS-CSS/TS-TW, default `TS-TW`). **Fuente preferente** para backgrounds animados, textos con efecto, cards interactivas, cursors custom, dock flotante. Tratar como third-party trust: revisar siempre el campo `dependencies` (suelen incluir `gsap`, `three`, `@react-three/fiber`, `motion`) y validar compat con el stack target antes de instalar.
+  4. **`blocks-so`** (ephraimduncan/blocks, GitHub Contents API sobre `/content/components/`) — 60+ bloques Radix prod-ready con `categories[]` explícito en cada JSON. **Default** para sus 11 categorías: `stats` (15 vars), `login` (9 vars), `form-layout` (5 vars), `file-upload` (6 vars), `tables` (5 vars), `dialogs` (12 vars), `sidebar` (6 vars), `command-menu` (3 vars), `ai` (5 vars), `onboarding` (7 vars), `grid-list` (3 vars). MIT license, autor Ephraim Duncan (1.7k⭐). Para `sidebar` y `login` hay empates con shadcn — el orquestador prefiere blocks-so y solo consulta shadcn si el usuario lo pide explícito o si la categoría quedó sin resultados.
   - **Criterio de inclusion**: solo se soportan registries con catálogo JSON oficialmente discoverable. 21st.dev fue removido porque su catálogo es JS-rendered y rompe el principio de "siempre saber qué hay disponible antes de elegir".
-  - El comando install siempre viene en el campo `install_command` del resultado de `sdd_catalog_get_block`. **Prohibido** ejecutar `npx shadcn add` con una URL adivinada; usar siempre el `install_command` literal que devuelve la tool.
-  - El catálogo guarda caché local en `.openspec/cache/` con TTL diferenciado (7d shadcn/basecn, 1d reactbits) — **NUNCA** usar `webfetch` directo a GitHub o reactbits.dev, está cacheado.
-  - Todos los items exponen `preview_url`. Para reactbits el demo es animado vivo (`https://reactbits.dev/<BaseName>`) — el orchestrator debe **siempre** presentar el `preview_url` al usuario en modo HIL para que vea cómo se ve antes de elegir.
+  - El comando install siempre viene en el campo `install_command` del resultado de `sdd_catalog_get_block`. **Prohibido** ejecutar `npx shadcn add` con una URL adivinada; usar siempre el `install_command` literal que devuelve la tool. Formatos válidos por registry:
+    - shadcn/basecn: `npx shadcn@latest add https://shadcnui-blocks.com/r/radix/<name>.json --yes` o `https://basecn.dev/r/<name>.json`
+    - reactbits: `npx shadcn@latest add https://reactbits.dev/r/<Name>-TS-TW.json --yes`
+    - blocks-so: `npx shadcn@latest add https://blocks.so/r/<name>.json --yes` (o `@blocks-so/<name>` si `components.json` del proyecto lo tiene declarado).
+  - El catálogo guarda caché local en `.openspec/cache/` con TTL diferenciado (7d shadcn/basecn/blocks-so, 1d reactbits) — **NUNCA** usar `webfetch` directo a GitHub o reactbits.dev, está cacheado.
+  - Todos los items exponen `preview_url`. Para blocks.so el preview es live (`https://blocks.so/<category>/<name>`); para reactbits también (`https://reactbits.dev/<BaseName>`). El orchestrator debe **siempre** presentar el `preview_url` al usuario en modo HIL para que vea cómo se ve antes de elegir.
 
 ## 4. Soporte para Subdirectorios, Monorepos (targetDir) y Estándar Corporativo `src/`
 Si el proyecto o aplicación principal vive en un subdirectorio (ej. `next-app`, `frontend`, `backend`), se deben seguir estas directivas estrictas para mantener la consistencia y el "estándar corporativo con carpeta `src/`":

package/.opencode/skills/shadcn-templates/SKILL.md

@@ -154,54 +154,58 @@ El `@sdd-coder` utiliza el template base `nextjs-shadcn`. Si el contrato no deta
 
 ## 5. Catálogo Unificado de Bloques Externos (`sdd_catalog`)
 
-Además del catálogo nativo de Shadcn UI, el arnés expone un catálogo unificado de **3 registries** externos (todos con catálogo JSON oficial y discoverable programáticamente). Si el usuario pide cualquier interfaz (hero, footer, dashboard, login, AI chat, animated background, etc.), **TIENES LA OBLIGACIÓN** de explorar este catálogo ANTES de inventar desde cero.
+Además del catálogo nativo de Shadcn UI, el arnés expone un catálogo unificado de **4 registries** externos (todos con catálogo JSON oficial y discoverable programáticamente). Si el usuario pide cualquier interfaz (hero, footer, dashboard, login, AI chat, animated background, stats, form, table, etc.), **TIENES LA OBLIGACIÓN** de explorar este catálogo ANTES de inventar desde cero.
 
 ### 5.0 Registries Soportados (todos discoverables)
 
 | Registry | Fuente de catálogo | Contenido | TTL | Notas |
 |---|---|---|---|---|
-| `shadcn` | akash3444/shadcn-ui-blocks (GitHub Contents API) | ~540 bloques Radix | 7d | **Default** para marketing/landing/auth/dashboards |
+| `shadcn` | akash3444/shadcn-ui-blocks (GitHub Contents API) | ~540 bloques Radix | 7d | **Default** para marketing/landing/hero/pricing/features/faq/testimonials/footer/cta/navbar/logo-cloud/bento/marquee |
 | `basecn` | akash3444/basecn (GitHub Contents API) | ~60 bloques fork Base UI | 7d | Alternativa si el proyecto usa Base UI |
 | `reactbits` | reactbits.dev/r/registry.json (JSON oficial shadcn) | 134 bases × 4 variantes = 536 items | 1d | Primitivas animadas (backgrounds, text, cards, cursors, etc.) |
+| `blocks-so` | ephraimduncan/blocks (GitHub Contents API sobre `/content/components/`) | 60+ bloques Radix con `categories[]` explícito en cada JSON | 7d | **Default** para `stats` (15), `login` (9), `form-layout` (5), `file-upload` (6), `tables` (5), `dialogs` (12), `sidebar` (6), `command-menu` (3), `ai` (5), `onboarding` (7), `grid-list` (3). MIT, Ephraim Duncan. |
 
 > **Criterio de inclusion**: solo se soportan registries con catálogo JSON oficialmente discoverable. 21st.dev fue removido porque su catálogo es JS-rendered y requiere scraping para descubrir items nuevos — eso rompe el principio de "siempre saber qué hay disponible antes de elegir".
 
 ### 5.1 Herramientas MCP Nativas del Arnés (PREFERENTE — `sdd_catalog_*`)
 
-**PROHIBIDO** usar `webfetch` directo a GitHub o reactbits.dev para descubrir bloques. El arnés expone 3 tools MCP dedicadas que cachean en `.openspec/cache/` y evitan redescubrimiento:
+**PROHIBIDO** usar `webfetch` directo a GitHub, reactbits.dev o blocks.so para descubrir bloques. El arnés expone 3 tools MCP dedicadas que cachean en `.openspec/cache/` y evitan redescubrimiento:
 
 - `sdd_catalog_list_blocks({ category?, query?, registry?, limit?, force_refresh? })`
-  - `registry`: `"shadcn"` | `"basecn"` | `"reactbits"` | `"all"` (default).
-  - Filtra por categoria exacta (`hero`, `pricing`, `backgrounds`, `text`, `cards`, `navigation`, ...) o substring libre (sobre `name`, `description`, `tags`).
+  - `registry`: `"shadcn"` | `"basecn"` | `"reactbits"` | `"blocks-so"` | `"all"` (default).
+  - Filtra por categoria exacta (`hero`, `pricing`, `backgrounds`, `text`, `cards`, `navigation`, `stats`, `login`, `form-layout`, ...) o substring libre (sobre `name`, `description`, `tags`).
   - Para `reactbits`: devuelve las **134 bases** (cada una con `variants[]` y `default_variant`), NO las 536 variantes. Esto evita duplicados y permite ver opciones de un vistazo.
+  - Para `blocks-so`: devuelve los **60+ bloques Radix** distribuidos en 11 categorías oficiales. La categoría se infiere del path del directorio GitHub (`content/components/<category>/`), no del nombre del archivo.
 - `sdd_catalog_get_block({ name, registry?, variant?, force_refresh? })`
   - Formatos de `name`:
     - shadcn/basecn: `"hero-06"`, `"sidebar-07"`
+    - blocks-so: `"stats-01"`, `"login-03"`, `"form-layout-02"`, `"ai-01"`, etc.
     - reactbits: `"Dither"` (auto-resuelve a `Dither-TS-TW` por default) **o** `"Dither-JS-CSS"` (variante canónica completa)
-    - URL directa: `"https://reactbits.dev/r/Dither-TS-TW.json"` o `"https://shadcnui-blocks.com/r/radix/hero-06.json"`
-    - Namespace shadcn: `"@acme/button"`
+    - URL directa: `"https://reactbits.dev/r/Dither-TS-TW.json"`, `"https://blocks.so/r/stats-01.json"` o `"https://shadcnui-blocks.com/r/radix/hero-06.json"`
+    - Namespace shadcn: `"@acme/button"` o `"@blocks-so/stats-01"` (auto-routing a blocks-so)
   - Para reactbits, parámetro opcional `variant`: `"JS-CSS" | "JS-TW" | "TS-CSS" | "TS-TW"` (default `"TS-TW"`). Aplicar solo cuando pasas el nombre base sin sufijo de variante.
   - `registry` autodetecta por el formato; pasalo explícito solo si necesitas forzar.
   - Devuelve `source_files[]`, `dependencies[]`, `preview_url`, `install_command` listo y metadatos `base_name` + `variant` (para reactbits).
 - `sdd_catalog_warm_index({ registry? })`
-  - Pre-calienta caches. Llamar al bootstrap (F0) o inicio de F1.
+  - Pre-calienta caches. Llamar al bootstrap (F0) o inicio de F1. Para `blocks-so` consume ~12 GitHub API calls (1 para categorias + 11 para listar archivos) — TTL 7d minimiza esto.
 
 ### 5.2 Flujo de Descubrimiento (Fase F1 - Spec-Writer)
 
 Cuando el usuario pide una UI, sigue este orden de prioridad:
 
-1. **Primero** `sdd_catalog_list_blocks({ registry: "all", category: "<categoria>", limit: 10 })` — devuelve candidatos de los 3 registries simultáneamente.
-2. **Si el usuario pide animaciones/shaders/efectos visuales cinematograficos**, prioriza `registry: "reactbits"` (es donde estan las primitivas animadas reales: `Dither`, `Aurora`, `GlareHover`, `Magnet`, `StaggeredMenu`, `FloatingDock`, etc.).
-3. **Si el usuario pide paginas de marketing completas** (landing, pricing, features), prioriza `registry: "shadcn"` (bloques Radix mas completos con texto, CTAs, imagenes placeholder).
-4. **Si el usuario ya dio una URL** (`https://reactbits.dev/...` o `https://shadcnui-blocks.com/...`), ve directo a `sdd_catalog_get_block` con esa URL.
-5. **Presenta opciones con `preview_url`** para que el usuario vea cada una antes de elegir:
+1. **Primero** `sdd_catalog_list_blocks({ registry: "all", category: "<categoria>", limit: 10 })` — devuelve candidatos de los 4 registries simultáneamente.
+2. **Si la keyword cae en las 11 categorías de blocks-so** (stats, login, signup, form-layout, file-upload, tables, dialogs, sidebar, command-menu, ai, onboarding, grid-list), prioriza `registry: "blocks-so"`. Es la fuente más actualizada y curada para esos casos de uso. Ejemplo: si el usuario pide *"un formulario de registro"*, el Spec-Writer debe ir directo a `sdd_catalog_list_blocks({registry: "blocks-so", category: "form-layout", limit: 5})` y mostrar las 5 variantes (`form-layout-01` a `form-layout-05`).
+3. **Si el usuario pide animaciones/shaders/efectos visuales cinematograficos**, prioriza `registry: "reactbits"` (es donde estan las primitivas animadas reales: `Dither`, `Aurora`, `GlareHover`, `Magnet`, `StaggeredMenu`, `FloatingDock`, etc.).
+4. **Si el usuario pide paginas de marketing completas** (landing, pricing, features, hero), prioriza `registry: "shadcn"` (bloques Radix mas completos con texto, CTAs, imagenes placeholder).
+5. **Si el usuario ya dio una URL** (`https://reactbits.dev/...`, `https://blocks.so/...` o `https://shadcnui-blocks.com/...`), ve directo a `sdd_catalog_get_block` con esa URL.
+6. **Presenta opciones con `preview_url`** para que el usuario vea cada una antes de elegir:
    - **Asistido (HIL):** muestra `preview_url` (que el usuario puede abrir en navegador) + `install_command` para los 2-3 mejores candidatos y deja que elija. Si el usuario dice "ese", ejecuta el `install_command`.
    - **Autopiloto (`/loop`):** inspecciona 2-3 candidatos con `sdd_catalog_get_block`, analiza dependencias y compat con el stack del contrato, elige autonomamente.
 
 ### 5.3 Seleccion de Bloques (Interactiva o Autonoma)
 
 Cuando hay multiples opciones para una categoria (ej. 10 heroes):
-- **Modo Asistido (default):** pregunta al usuario con `question` o en chat: *"Tengo X opciones de [categoria]. ¿Quieres revisar alguna? Puedo darte el `preview_url` (ej. `https://shadcnui-blocks.com/blocks/hero-06` o `https://reactbits.dev/Dither`) para que elijas."*
+- **Modo Asistido (default):** pregunta al usuario con `question` o en chat: *"Tengo X opciones de [categoria]. ¿Quieres revisar alguna? Puedo darte el `preview_url` (ej. `https://shadcnui-blocks.com/blocks/hero-06`, `https://blocks.so/stats/stats-04` o `https://reactbits.dev/Dither`) para que elijas."*
 - **Modo Autopiloto:** lee el codigo de 2-3 opciones con `sdd_catalog_get_block` y elige sin preguntar.
 
 ### 5.4 Inyeccion e Instalacion (Spec-Writer + Coder)
@@ -211,6 +215,7 @@ Cuando hay multiples opciones para una categoria (ej. 10 heroes):
   "frontend": {
     "components": [
       { "name": "hero-06", "registry": "shadcn", "source": "akash3444/shadcn-ui-blocks" },
+      { "name": "stats-01", "registry": "blocks-so", "source": "ephraimduncan/blocks" },
       { "name": "Dither", "registry": "reactbits", "variant": "TS-TW", "source": "reactbits.dev/Dither" }
     ]
   }
@@ -223,6 +228,10 @@ Cuando hay multiples opciones para una categoria (ej. 10 heroes):
   npx shadcn@latest add https://basecn.dev/r/footer-04.json --yes
   # reactbits (variante TS-TW explicita)
   npx shadcn@latest add https://reactbits.dev/r/Dither-TS-TW.json --yes
+  # blocks-so (ephraimduncan/blocks)
+  npx shadcn@latest add https://blocks.so/r/stats-01.json --yes
+  # blocks-so via namespace (requiere declararlo en components.json)
+  npx shadcn@latest add @blocks-so/stats-01 --yes
   ```
   La CLI v3 de Shadcn negocia `Accept: application/json` automaticamente, descarga el codigo y resuelve las `registryDependencies`.
 
@@ -263,8 +272,55 @@ reactbits.dev es el registry mas "vivo" del catalogo unificado. Cada componente
 | shadcn | `https://shadcnui-blocks.com/blocks/<name>` | iframe del demo oficial |
 | basecn | `https://basecn.dev/blocks/<name>` | iframe del demo oficial |
 | reactbits | `https://reactbits.dev/<BaseName>` | demo vivo con animacion real + codigo a la derecha |
+| blocks-so | `https://blocks.so/<category>/<name>` | demo vivo con el bloque real renderizado (sin animaciones) |
 
-Cuando el orchestrator presente opciones al usuario, **siempre incluir el `preview_url`** en el chat. Para reactbits en particular, el demo es animado y se ve inmediatamente cómo se mueve la UI en el navegador del usuario — esto cierra el ciclo "imaginar como se ve → ver real → decidir instalar" sin hacer conjeturas.
+Cuando el orchestrator presente opciones al usuario, **siempre incluir el `preview_url`** en el chat. Para reactbits y blocks-so el demo es interactivo y se ve inmediatamente cómo se ve en el navegador del usuario — esto cierra el ciclo "imaginar como se ve → ver real → decidir instalar" sin hacer conjeturas.
+
+### 5.8 blocks.so (ephraimduncan/blocks) - Detalles
+
+blocks.so es el registry más curado para interfaces funcionales: **60+ bloques Radix prod-ready** con `categories[]` explícito en cada JSON. La diferencia clave frente a akash es que cada bloque de blocks.so **incluye un `categories[]` array** dentro del JSON, lo que elimina la ambigüedad de la heurística por nombre de archivo.
+
+**Estructura del repo**:
+```
+ephraimduncan/blocks/
+  content/
+    components/
+      ai/              ai-01.tsx ... ai-05.tsx          (5 bloques)
+      command-menu/    command-menu-01.tsx ...          (3 bloques)
+      dialogs/         dialog-01.tsx ... dialog-12.tsx  (12 bloques)
+      file-upload/     file-upload-01.tsx ...            (6 bloques)
+      form-layout/     form-layout-01.tsx ...            (5 bloques)
+      grid-list/       grid-list-01.tsx ...              (3 bloques)
+      login/           login-01.tsx ... login-09.tsx    (9 bloques)
+      onboarding/      onboarding-01.tsx ...             (7 bloques)
+      sidebar/         sidebar-01.tsx ... sidebar-06.tsx (6 bloques)
+      stats/           stats-01.tsx ... stats-15.tsx     (15 bloques)
+      tables/          tables-01.tsx ... tables-05.tsx   (5 bloques)
+```
+
+**Campos clave del JSON de cada bloque**:
+- `name`: canonical (ej: `"stats-01"`)
+- `type`: `"registry:block"` (estándar shadcn)
+- `title`: `"Stats with Trending"`
+- `description`: `"A stats with trending block."`
+- `author`: `"ephraim duncan <https://ephraimduncan.com>"`
+- `registryDependencies`: ej: `["card"]` — el coder debe pre-instalar via `sdd_bootstrap` antes del `npx shadcn add`.
+- `dependencies`: ej: `[]` — paquetes npm necesarios (rara vez hay, son 100% Radix).
+- `files[]`: cada item tiene `path` (origen en el repo), `type` (`"registry:component"`) y `target` (ruta destino en el proyecto, ej: `"components/stats-01.tsx"`).
+- `categories[]`: ej: `["stats"]` — usado para filtrado.
+
+**Patrones de uso en el contrato**:
+```json
+{
+  "frontend": {
+    "components": [
+      { "name": "stats-01", "registry": "blocks-so", "source": "ephraimduncan/blocks" }
+    ]
+  }
+}
+```
+
+**Cuidado con `field` y `FieldGroup`**: algunos bloques de `form-layout` y `onboarding` usan el primitivo `field` (Field, FieldLabel, FieldDescription) que no viene por defecto en `npx shadcn add`. Si `sdd_catalog_get_block` lista `field` en `registryDependencies[]`, el coder debe correr `npx shadcn@latest add field` antes de instalar el bloque.
 
 ---
 

package/.opencode/templates/nextjs-shadcn/components.json

@@ -18,6 +18,7 @@
   },
   "iconLibrary": "lucide",
   "registries": {
-    "@react-bits": "https://reactbits.dev/r/{name}.json"
+    "@react-bits": "https://reactbits.dev/r/{name}.json",
+    "@blocks-so": "https://blocks.so/r/{name}.json"
   }
 }

package/.opencode/tools/sdd_catalog.ts

@@ -20,17 +20,27 @@ import path from "path"
 //                 TS-CSS / TS-TW) = 536 items. Fuente: /r/registry.json
 //                 oficial shadcn-compatible. Default variant para el stack
 //                 Next.js 16 + Tailwind v4 es TS-TW. TTL 1d.
+//   - blocks-so:  https://blocks.so (ephraimduncan/blocks)
+//                 60+ bloques Radix prod-ready organizados en 11 categorias
+//                 (stats, login, form-layout, file-upload, tables, dialogs,
+//                 command-menu, sidebar, onboarding, ai, grid-list). Cada
+//                 bloque incluye `categories[]` explicito en el JSON.
+//                 Fuente: GitHub Contents API sobre /content/components.
+//                 Default para forms/stats/tables/file-upload/dialogs/login/
+//                 command-menu/onboarding/ai/grid-list. TTL 7d.
 //
 // Cache local:
 //   - .openspec/cache/shadcn-index.json
 //   - .openspec/cache/basecn-index.json
 //   - .openspec/cache/reactbits-index.json
+//   - .openspec/cache/blocks-so-index.json
 //   - .openspec/cache/blocks/<registry>/[<author>/]<name>.json
 //
 // Registries configurables via env:
 //   - SDD_CATALOG_TTL_DAYS_AKASH      (default 7)
 //   - SDD_CATALOG_TTL_DAYS_BASECN     (default 7)
 //   - SDD_CATALOG_TTL_DAYS_REACTBITS  (default 1)
+//   - SDD_CATALOG_TTL_DAYS_BLOCKSSO   (default 7)
 //
 // Tools exportadas (prefijo opencode = "sdd_catalog_<export>"):
 //   - list_blocks    Lista componentes/bloques por registry, categoria, query.
@@ -42,6 +52,8 @@ import path from "path"
 //   - reactbits:      "Dither" (base, resuelve a Dither-TS-TW por default)
 //                     "Dither-JS-CSS" (variante canonica completa)
 //                     "https://reactbits.dev/r/Dither-TS-TW.json" (URL directa)
+//   - blocks-so:      "stats-01", "login-03", "form-layout-02", etc.
+//                     "https://blocks.so/r/stats-01.json" (URL directa)
 // ============================================================================
 
 // ---------------------------------------------------------------------------
@@ -135,6 +147,36 @@ const REACTBITS_CATEGORY_BY_BASE: Map<string, string> = (() => {
   return map
 })()
 
+// ---------------------------------------------------------------------------
+// blocks.so (ephraimduncan/blocks)
+// ---------------------------------------------------------------------------
+// Repo: ephraimduncan/blocks
+// Public registry URL: https://blocks.so/r/<name>.json
+// Categorias oficiales (11): ai, command-menu, dialogs, file-upload,
+//   form-layout, grid-list, login, onboarding, sidebar, stats, tables.
+// Fuente de descubrimiento: GitHub Contents API sobre /content/components.
+// Cada bloque es un .tsx bajo content/components/<category>/; el nombre
+// canonico es `<category>-<NN>` (ej: stats-01, login-03, form-layout-02).
+// Cada JSON de bloque incluye `categories[]` explicito y `target` para
+// inyeccion Zero-Touch en el proyecto Next.js destino.
+const BLOCKSSO_REPO = "ephraimduncan/blocks"
+const BLOCKSSO_CATEGORIES_API =
+  `https://api.github.com/repos/${BLOCKSSO_REPO}/contents/content/components`
+const BLOCKSSO_CATEGORY_FILES_API = (category: string) =>
+  `https://api.github.com/repos/${BLOCKSSO_REPO}/contents/content/components/${category}`
+const BLOCKSSO_RAW = (name: string) =>
+  `https://raw.githubusercontent.com/${BLOCKSSO_REPO}/main/content/components/${name}.json`
+const BLOCKSSO_INSTALL = (name: string) => `https://blocks.so/r/${name}.json`
+const BLOCKSSO_PREVIEW = (category: string, name: string) =>
+  `https://blocks.so/${category}/${name}`
+const BLOCKSSO_TTL_DAYS = Number(process.env.SDD_CATALOG_TTL_DAYS_BLOCKSSO || 7)
+
+// Categorias oficiales de blocks.so (orden estable para la UI).
+const BLOCKSSO_CATEGORIES = [
+  "ai", "command-menu", "dialogs", "file-upload", "form-layout",
+  "grid-list", "login", "onboarding", "sidebar", "stats", "tables"
+] as const
+
 // ---------------------------------------------------------------------------
 // Categorias (heuristica por nombre de archivo para Akash/Basecn)
 // ---------------------------------------------------------------------------
@@ -156,7 +198,7 @@ const CATEGORY_PREFIXES = [
 // Helpers
 // ============================================================================
 
-type RegistryName = "shadcn" | "basecn" | "reactbits"
+type RegistryName = "shadcn" | "basecn" | "reactbits" | "blocks-so"
 
 const getRoot = (context: any): string => {
   if (context?.directory && context.directory !== "/") return context.directory
@@ -505,6 +547,208 @@ const resolveReactbitsSlug = (
   }
 }
 
+// ---------------------------------------------------------------------------
+// blocks.so index builder
+// ---------------------------------------------------------------------------
+//
+// Estrategia de descubrimiento en 2 niveles (idempotente, TTL 7d):
+//   1. Listar subdirectorios bajo /content/components/ (las 11 categorias).
+//   2. Para cada categoria, listar archivos .tsx y derivar name canonico.
+//
+// Output: IndexEntry[] con category real (de la carpeta GitHub), install_url
+// apuntando a https://blocks.so/r/<name>.json y preview_url al demo vivo.
+//
+// Para no saturar la GitHub API (rate limit 60/h sin token), cacheamos el
+// indice completo durante 7d. Cualquier update en el repo se reflejara
+// solo tras `force_refresh: true` o expiracion del TTL.
+
+type GitHubContentEntry = {
+  name: string
+  path: string
+  size: number
+  sha: string
+  type: "dir" | "file"
+}
+
+const fetchGithubContents = async (
+  apiUrl: string,
+  repoLabel: string
+): Promise<GitHubContentEntry[]> => {
+  const res = await fetch(apiUrl, {
+    headers: {
+      "User-Agent": "zugzbot-sdd-catalog/1.0",
+      Accept: "application/vnd.github+json"
+    }
+  })
+  if (!res.ok) {
+    if (res.status === 403) {
+      throw new Error(
+        `GitHub API rate limit hit consultando ${repoLabel}. ` +
+          `Espera 1h o usa force_refresh=false con cache existente.`
+      )
+    }
+    if (res.status === 404) {
+      throw new Error(
+        `Repositorio ${repoLabel} no encontrado o ruta cambiada. ` +
+          `Verifica que ${apiUrl} siga vigente.`
+      )
+    }
+    throw new Error(`GitHub API ${res.status} ${res.statusText} consultando ${repoLabel}`)
+  }
+  return (await res.json()) as GitHubContentEntry[]
+}
+
+const buildBlocksSoIndex = async (
+  root: string,
+  forceRefresh: boolean
+): Promise<{ index: Index; refreshed: boolean; error?: string }> => {
+  const indexPath = getIndexPath(root, "blocks-so")
+  const ttl = ttlMs(BLOCKSSO_TTL_DAYS)
+
+  const cached = readJson<Index>(indexPath)
+  if (!forceRefresh && !isCacheStale(cached, ttl)) {
+    return { index: cached!, refreshed: false }
+  }
+
+  try {
+    const entries: IndexEntry[] = []
+
+    // Paso 1: listar las 11 categorias oficiales.
+    // Si la API falla 404 (ej: rama renombrada) usamos la lista hardcodeada
+    // como fallback para no romper el resto del catalogo.
+    let categories = [...BLOCKSSO_CATEGORIES] as readonly string[]
+    try {
+      const catEntries = await fetchGithubContents(
+        BLOCKSSO_CATEGORIES_API,
+        BLOCKSSO_REPO
+      )
+      const live = catEntries
+        .filter((e) => e.type === "dir")
+        .map((e) => e.name)
+        .filter((n) => !n.startsWith("_") && !n.startsWith("."))
+      if (live.length > 0) categories = live
+    } catch (e) {
+      if (!cached) throw e
+    }
+
+    // Paso 2: por cada categoria, enumerar .tsx (formato plano) O
+    // subdirectorios (formato multi-file, usado por sidebar) y derivar
+    // el name canonico. Estructuras mixtas soportadas:
+    //   - ai/             ai-01.tsx ... ai-05.tsx
+    //   - command-menu/   command-menu-01.tsx ... -03.tsx
+    //   - dialogs/        dialog-01.tsx ... -12.tsx  (prefijo singular)
+    //   - login/          login-01.tsx ... -09.tsx
+    //   - onboarding/     onboarding-01.tsx ... -07.tsx
+    //   - stats/          stats-01.tsx ... -15.tsx
+    //   - tables/         table-01.tsx ... -05.tsx  (prefijo singular)
+    //   - form-layout/    form-layout-01.tsx ... -05.tsx
+    //   - grid-list/      grid-list-01.tsx ... -03.tsx
+    //   - file-upload/    file-upload-01.tsx ... -06.tsx
+    //                     (+ file-upload-01/ subdir durante transicion)
+    //   - sidebar/        sidebar-01/ ... sidebar-06/  (SUBDIRS multi-file)
+    //
+    // Si un mismo name aparece como .tsx Y como subdir (transicion en el
+    // repo fuente), preferimos el subdir (multi-file) y descartamos el .tsx
+    // huerfano. Esto evita entradas duplicadas en el indice.
+    const seenNames = new Set<string>()
+    const dedupEntries: IndexEntry[] = []
+
+    for (const cat of categories) {
+      let items: GitHubContentEntry[]
+      try {
+        items = await fetchGithubContents(
+          BLOCKSSO_CATEGORY_FILES_API(cat),
+          BLOCKSSO_REPO
+        )
+      } catch (e) {
+        // Si falla una categoria puntual, seguimos con las demas para no
+        // abortar el indice completo. Logueamos via error[] abajo.
+        continue
+      }
+      for (const it of items) {
+        // Ignorar archivos no-componente (index.ts, .DS_Store, etc.)
+        if (it.name.startsWith("index.")) continue
+        if (it.name.startsWith("_")) continue
+        if (it.name.startsWith(".")) continue
+
+        // Caso A: archivo .tsx plano. name = file sin extension.
+        if (it.type === "file" && it.name.endsWith(".tsx")) {
+          const name = it.name.replace(/\.tsx$/, "")
+          if (!name) continue
+          if (seenNames.has(name)) continue  // dedup
+          seenNames.add(name)
+          dedupEntries.push({
+            name,
+            filename: it.name,
+            category: cat,
+            registry: "blocks-so",
+            author: "ephraimduncan",
+            description: `blocks.so ${cat} block (${name})`,
+            tags: [cat, "shadcn-registry", "blocks-so"],
+            install_url: BLOCKSSO_INSTALL(name),
+            preview_url: BLOCKSSO_PREVIEW(cat, name),
+            source: "github"
+          })
+          continue
+        }
+
+        // Caso B: subdirectorio (multi-file block, ej. sidebar-XX/).
+        // El nombre del subdir ES el canonical name del bloque.
+        // Sobrescribe cualquier .tsx huerfano con el mismo name.
+        if (it.type === "dir") {
+          const name = it.name
+          if (!name) continue
+          // Si ya vimos un .tsx con este name, lo removemos para
+          // reemplazarlo por la version multi-file (mas completa).
+          const existingIdx = dedupEntries.findIndex(
+            (e) => e.name === name && e.category === cat
+          )
+          if (existingIdx >= 0) dedupEntries.splice(existingIdx, 1)
+          seenNames.add(name)
+          dedupEntries.push({
+            name,
+            filename: `${name}/`,
+            category: cat,
+            registry: "blocks-so",
+            author: "ephraimduncan",
+            description: `blocks.so ${cat} block (${name}, multi-file)`,
+            tags: [cat, "shadcn-registry", "blocks-so", "multi-file"],
+            install_url: BLOCKSSO_INSTALL(name),
+            preview_url: BLOCKSSO_PREVIEW(cat, name),
+            source: "github"
+          })
+          continue
+        }
+      }
+    }
+
+    dedupEntries.sort((a, b) => {
+      if (a.category !== b.category) return a.category.localeCompare(b.category)
+      return a.name.localeCompare(b.name)
+    })
+    entries.push(...dedupEntries)
+
+    const index: Index = {
+      cached_at: new Date().toISOString(),
+      ttl_days: BLOCKSSO_TTL_DAYS,
+      source: `${BLOCKSSO_REPO} (${BLOCKSSO_CATEGORIES_API})`,
+      total: entries.length,
+      entries
+    }
+    writeJson(indexPath, index)
+    return { index, refreshed: true }
+  } catch (e) {
+    if (cached) {
+      return {
+        index: cached,
+        refreshed: false,
+        error: `Refresh fallo (${(e as Error).message}); usando cache de ${cached.cached_at}`
+      }
+    }
+    throw e
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Fetchers compartidos
 // ---------------------------------------------------------------------------
@@ -550,6 +794,8 @@ const normalizeBlock = (parsed: any, registry: RegistryName, name: string) => {
     installUrl = REACTBITS_INSTALL(name)
   } else if (registry === "basecn") {
     installUrl = BASECN_INSTALL(name)
+  } else if (registry === "blocks-so") {
+    installUrl = BLOCKSSO_INSTALL(name)
   } else {
     installUrl = AKASH_INSTALL(name)
   }
@@ -591,16 +837,22 @@ type ListResult = {
   hints?: string[]
 }
 
-const REGISTRIES_ALL: RegistryName[] = ["shadcn", "basecn", "reactbits"]
+const REGISTRIES_ALL: RegistryName[] = ["shadcn", "basecn", "reactbits", "blocks-so"]
+
+
+
 
 export const list_blocks = tool({
   description:
     "Lista bloques/componentes del catalogo unificado sdd_catalog. " +
-    "Soporta 3 registries con catalogo JSON oficial: 'shadcn' (akash3444/shadcn-ui-blocks, " +
-    "Radix), 'basecn' (akash3444/basecn, fork Base UI) y 'reactbits' (reactbits.dev, " +
-    "primitivas animadas; para cada base se exponen sus 4 variantes JS-CSS/JS-TW/TS-CSS/TS-TW). " +
-    "Cachea en .openspec/cache/ con TTL por registry (7d shadcn/basecn, 1d reactbits). " +
-    "Filtra por categoria (hero, footer, pricing, backgrounds, text, cards, etc) " +
+    "Soporta 4 registries con catalogo JSON oficial: 'shadcn' (akash3444/shadcn-ui-blocks, " +
+    "Radix), 'basecn' (akash3444/basecn, fork Base UI), 'reactbits' (reactbits.dev, " +
+    "primitivas animadas; para cada base se exponen sus 4 variantes JS-CSS/JS-TW/TS-CSS/TS-TW) " +
+    "y 'blocks-so' (ephraimduncan/blocks, 60+ bloques Radix prod-ready con categories[] explicito; " +
+    "default para stats, login, form-layout, file-upload, tables, dialogs, sidebar, " +
+    "command-menu, ai, onboarding, grid-list). " +
+    "Cachea en .openspec/cache/ con TTL por registry (7d shadcn/basecn/blocks-so, 1d reactbits). " +
+    "Filtra por categoria (hero, footer, pricing, backgrounds, text, cards, stats, login, etc) " +
     "y por query libre (substring sobre name/description/tags).",
   args: {
     category: tool.schema
@@ -615,10 +867,10 @@ export const list_blocks = tool({
       .optional()
       .describe("Busqueda libre por substring sobre name/filename/description. Opcional."),
     registry: tool.schema
-      .enum(["shadcn", "basecn", "reactbits", "all"])
+      .enum(["shadcn", "basecn", "reactbits", "blocks-so", "all"])
       .optional()
       .default("all")
-      .describe("Que catalogos consultar. 'all' = shadcn+basecn+reactbits."),
+      .describe("Que catalogos consultar. 'all' = shadcn+basecn+reactbits+blocks-so."),
     limit: tool.schema
       .number()
       .optional()
@@ -661,6 +913,24 @@ export const list_blocks = tool({
               "TS-TW (TypeScript + Tailwind v4). Para otra variante, pasa " +
               "`variant='JS-CSS'` a `sdd_catalog_get_block`."
           )
+        } else if (reg === "blocks-so") {
+          const { index, refreshed, error } = await buildBlocksSoIndex(
+            root,
+            args.force_refresh || false
+          )
+          cachedAt[reg] = index.cached_at
+          if (refreshed) {
+            // ok
+          }
+          if (error) errors.push(`[${reg}] ${error}`)
+          allEntries.push(...index.entries)
+          hints.push(
+            "[blocks-so] ephraimduncan/blocks (https://blocks.so). " +
+              "Default para sus 11 categorias: stats, login, form-layout, " +
+              "file-upload, tables, dialogs, sidebar, command-menu, ai, " +
+              "onboarding, grid-list. Install: `npx shadcn@latest add " +
+              "https://blocks.so/r/<name>.json --yes`."
+          )
         } else {
           const { index, refreshed, error } = await buildOrLoadIndex(
             root,
@@ -758,9 +1028,12 @@ export const get_block = tool({
     "especifico del catalogo unificado. " +
     "Para shadcn/basecn: `name='hero-06'`. " +
     "Para reactbits: `name='Dither'` (resuelve a Dither-TS-TW por default) o " +
-    "`name='Dither-JS-CSS'` (variante canonica completa). Tambien acepta URL " +
-    "directa `name='https://reactbits.dev/r/Dither-TS-TW.json'` y namespace shadcn " +
-    "`name='@acme/button'`. Cachea en .openspec/cache/blocks/<registry>/<name>.json. " +
+    "`name='Dither-JS-CSS'` (variante canonica completa). " +
+    "Para blocks-so: `name='stats-01'`. " +
+    "Tambien acepta URL directa `name='https://reactbits.dev/r/Dither-TS-TW.json'` " +
+    "o `name='https://blocks.so/r/stats-01.json'`, y namespace shadcn " +
+    "`name='@acme/button'` (incluido `@blocks-so/stats-01`). " +
+    "Cachea en .openspec/cache/blocks/<registry>/<name>.json. " +
     "Devuelve `install_command` listo para ejecutar con `npx shadcn@latest add`.",
   args: {
     name: tool.schema
@@ -768,12 +1041,13 @@ export const get_block = tool({
       .describe(
         "Identificador del bloque. Formatos aceptados:\n" +
           "  - shadcn/basecn: 'hero-06', 'sidebar-07'\n" +
+          "  - blocks-so: 'stats-01', 'login-03', 'form-layout-02'\n" +
           "  - reactbits: 'Dither' (default TS-TW) o 'Dither-JS-CSS' (canonica)\n" +
-          "  - URL directa: 'https://reactbits.dev/r/Dither-TS-TW.json'\n" +
-          "  - Namespace shadcn: '@acme/button'"
+          "  - URL directa: 'https://reactbits.dev/r/Dither-TS-TW.json' o 'https://blocks.so/r/stats-01.json'\n" +
+          "  - Namespace shadcn: '@acme/button' o '@blocks-so/stats-01'"
       ),
     registry: tool.schema
-      .enum(["auto", "shadcn", "basecn", "reactbits"])
+      .enum(["auto", "shadcn", "basecn", "reactbits", "blocks-so"])
       .optional()
       .default("auto")
       .describe(
@@ -823,6 +1097,18 @@ export const get_block = tool({
         baseName = resolved.baseName
         variant = resolved.variant
         directUrl = url
+      } else if (url.includes("blocks.so/r/")) {
+        const m = url.match(/\/r\/([a-zA-Z0-9_.-]+)\.json/)
+        if (!m) {
+          return JSON.stringify({
+            status: "ERROR",
+            message: `URL blocks.so invalida: ${url}. Esperado patron /r/<name>.json.`,
+            block: null
+          }, null, 2)
+        }
+        registry = "blocks-so"
+        canonicalName = m[1]
+        directUrl = url
       } else {
         // URL generica shadcn: tratarla como shadcn (1 sola parte)
         const m = url.match(/\/([a-zA-Z0-9_.-]+)\.json/)
@@ -838,7 +1124,8 @@ export const get_block = tool({
         directUrl = url
       }
     } else if (rawName.startsWith("@")) {
-      // Namespace shadcn @acme/item
+      // Namespace shadcn @<author>/<item>. Detectamos @blocks-so y lo
+      // redirigimos al registry blocks-so (canonicalName sin prefijo).
       const m = rawName.match(/^@([a-zA-Z0-9_.-]+)\/(.+)$/)
       if (!m) {
         return JSON.stringify({
@@ -847,8 +1134,13 @@ export const get_block = tool({
           block: null
         }, null, 2)
       }
-      registry = "shadcn"
-      canonicalName = `${m[1]}/${m[2]}`
+      if (m[1] === "blocks-so" || m[1] === "blocks_so") {
+        registry = "blocks-so"
+        canonicalName = m[2]
+      } else {
+        registry = "shadcn"
+        canonicalName = `${m[1]}/${m[2]}`
+      }
     } else {
       // Auto-detectar: si contiene '-JS-' o '-TS-' seguido de CSS/TW, es reactbits canonica.
       // Si el registry forzado es reactbits, resolver siempre.
@@ -866,6 +1158,9 @@ export const get_block = tool({
       } else if (requestedReg === "basecn") {
         registry = "basecn"
         canonicalName = rawName
+      } else if (requestedReg === "blocks-so") {
+        registry = "blocks-so"
+        canonicalName = rawName
       } else {
         registry = "shadcn"
         canonicalName = rawName
@@ -897,6 +1192,19 @@ export const get_block = tool({
       installCommand = `npx shadcn@latest add ${installUrl} --yes`
       category = inferCategory(canonicalName)
       notes = "Bloque Base UI (fork). Verifica que tu proyecto tenga Base UI instalado."
+    } else if (registry === "blocks-so") {
+      // blocks.so: el JSON crudo vive en /content/components/<category>/<name>.tsx
+      // pero el contrato del arnes siempre expone el `name` canonico
+      // (ej: "stats-01"), NO el path del repo. La URL raw debe apuntar al
+      // archivo .tsx fuente para que `content` contenga el codigo completo.
+      rawUrl = directUrl || BLOCKSSO_RAW(canonicalName)
+      cachePath = path.resolve(getBlocksDir(root, "blocks-so"), `${canonicalName}.json`)
+      installUrl = BLOCKSSO_INSTALL(canonicalName)
+      const resolvedCategory = inferCategory(canonicalName)
+      previewUrl = BLOCKSSO_PREVIEW(resolvedCategory, canonicalName)
+      installCommand = `npx shadcn@latest add ${installUrl} --yes`
+      category = resolvedCategory
+      notes = "Bloque blocks.so (ephraimduncan/blocks). Formato shadcn registry estandar (registry:block). Compatible con stack nextjs-shadcn."
     } else {
       rawUrl = AKASH_RAW(canonicalName)
       cachePath = path.resolve(getBlocksDir(root, "shadcn"), `${canonicalName}.json`)
@@ -989,10 +1297,10 @@ export const warm_index = tool({
     "Pre-calienta (descarga) los indices de los registries soportados " +
     "para evitar la latencia del primer list_blocks/get_block. " +
     "Idempotente: si el cache existe y es fresco, no re-descarga. " +
-    "TTL por registry: shadcn/basecn 7d, reactbits 1d.",
+    "TTL por registry: shadcn/basecn/blocks-so 7d, reactbits 1d.",
   args: {
     registry: tool.schema
-      .enum(["shadcn", "basecn", "reactbits", "all"])
+      .enum(["shadcn", "basecn", "reactbits", "blocks-so", "all"])
       .optional()
       .default("all")
       .describe("Que catalogos pre-calentar.")
@@ -1016,6 +1324,13 @@ export const warm_index = tool({
               ? `${reg} (re-descargado, ${index.total} bases)`
               : `${reg} (cache fresco de ${index.cached_at})`
           )
+        } else if (reg === "blocks-so") {
+          const { index, refreshed } = await buildBlocksSoIndex(root, false)
+          warmed.push(
+            refreshed
+              ? `${reg} (re-descargado, ${index.total} bloques)`
+              : `${reg} (cache fresco de ${index.cached_at})`
+          )
         } else {
           const { index, refreshed } = await buildOrLoadIndex(root, reg, false)
           warmed.push(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zugzbot",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Fácil instalador del arnés SDD de Zugzbot para proyectos OpenCode",
   "type": "module",
   "bin": {