@xmarts/genius-setup 1.16.1 → 1.17.0

package/hooks/genius_inject.py

@@ -90,7 +90,7 @@ def _inject(cfg, prompt):
 # version dictated by the server (xma_genius.hook_pin_version, returned in the
 # inject response) and otherwise fall back to this bundled known-good pin — the
 # client never resolves the mutable `@latest` tag.
-PINNED_FALLBACK = "1.16.1"
+PINNED_FALLBACK = "1.17.0"
 
 
 def _pkg_spec(pin_version):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmarts/genius-setup",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "One-command, self-updating onboarding for Xmarts Genius (Brain MCP + per-turn injection + automatic session/time capture + presence heartbeat for honest time-tracking 'amarre' + plan/committee→Brain enforcement + CLAUDE.md protocol + MCP fan-out: provisions the consultant's granted MCP servers into Claude Code & Claude Desktop). Secret-free onboarding via single-use setup-token exchange. Installs once; self-updates daily so new tools/skills/features arrive with zero action.",
   "bin": {
     "genius-setup": "bin/genius-setup.js"

package/plugin/skills/cinematic-scroll-site/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: cinematic-scroll-site
+description: Construye sitios "cinematic 3D-scroll" award-winning (efecto Apple: un video que se scrubbea con el scroll como una sola toma de cámara) con la técnica REAL (canvas frame-sequence + Lenis/GSAP), plantilla de brief de un-prompt, y 10 verticales listos (producto de lujo, restaurante, real estate, portafolio, e-commerce, SaaS, agencia, gym...). USAR cuando el usuario pida un sitio cinematic, "3D scroll", "scroll-scrub", una landing premium con video hero, o un sitio para un negocio local. Los assets se generan con higgsfield-video; el gusto lo pone design-taste-frontend; el copy pasa por content-humanizer.
+---
+
+# Cinematic Scroll Site: la técnica real, no la del lead-magnet
+
+Base verificada (Brain #6649, scouts 2026-07-07). El efecto "el video se mueve con
+el scroll como una toma continua" es la firma de estos sitios. La mayoría lo hace mal.
+
+## Regla dura #1: NO se scrubbea un `<video>`
+
+Scrubbear `video.currentTime` con el scroll tartamudea, snapea a keyframes, y FALLA
+en Safari iOS (decodifica para playback, no para seek). Apple NO scrubbea un video:
+dibuja una SECUENCIA DE FRAMES en un `<canvas>`. Caso de producción que lo documenta:
+OPTIKKA (Codrops, 2025-10-16), que migró de `<video>` a frame-sequence justo por esto.
+
+La técnica correcta: `frame = round(scrollProgress * (n-1))`, y `ctx.drawImage(frame)`
+en un solo canvas pinneado a pantalla completa.
+
+## Paso a paso (build-ready)
+
+### 1. Genera el clip y extrae frames
+El clip cinematográfico se genera con `higgsfield-video` (Kling 3.0 default por costo;
+premium solo para el hero final). Luego:
+```bash
+ffmpeg -i clip.mp4 -vf "fps=30" png/frame_%03d.png
+ffmpeg -i png/frame_%03d.png -c:v libwebp -quality 80 webp/frame_%03d.webp
+```
+Target 20 a 60 KB por frame (147 frames a 40 KB = ~6 MB, presupuesto de hero sano).
+Exporta un set REDUCIDO (menos frames, menos resolución) para móvil.
+
+### 2. Un canvas pinneado + el helper oficial de GreenSock
+Nunca cambies el `src` de un `<img>` en scroll (flicker + reflow). Siempre `drawImage`
+a un canvas. Dimensiona el canvas por `devicePixelRatio` y calcula offsets cover-fit.
+```javascript
+gsap.registerPlugin(ScrollTrigger);
+
+function imageSequence(config) {
+  let playhead = { frame: 0 },
+      canvas = gsap.utils.toArray(config.canvas)[0],
+      ctx = canvas.getContext("2d"),
+      curFrame = -1,
+      onUpdate = config.onUpdate,
+      images,
+      updateImage = function () {
+        let frame = Math.round(playhead.frame);
+        if (frame !== curFrame) {
+          config.clear && ctx.clearRect(0, 0, canvas.width, canvas.height);
+          ctx.drawImage(images[frame], 0, 0);
+          curFrame = frame;
+          onUpdate && onUpdate.call(this, frame, images[frame]);
+        }
+      };
+  images = config.urls.map((url, i) => {
+    let img = new Image();
+    img.src = url;
+    i || (img.onload = updateImage); // dibuja el primer frame al cargar
+    return img;
+  });
+  return gsap.to(playhead, {
+    frame: images.length - 1,
+    ease: "none",
+    onUpdate: updateImage,
+    duration: images.length / (config.fps || 30),
+    paused: !!config.paused,
+    scrollTrigger: config.scrollTrigger
+  });
+}
+
+imageSequence({
+  urls: Array.from({ length: 147 }, (_, i) =>
+    `frames/frame_${String(i + 1).padStart(3, "0")}.webp`),
+  canvas: "#hero-canvas",
+  clear: true, // solo si los frames tienen transparencia; omítelo si son opacos full-bleed
+  scrollTrigger: { trigger: ".hero", start: "top top", end: "+=3000", scrub: true, pin: true }
+});
+```
+`end` largo = scrub más lento y cinemático. En React existe `@bsmnt/scrollytelling`
+con un `ImageSequenceCanvas` ya hecho (misma mecánica).
+
+### 3. Preload inteligente
+Primeros ~10 frames eager, el resto por cola en background, prefetch direccional
+(unos frames adelante al bajar, atrás al subir). Dibuja el primer frame en su `onload`.
+
+### 4. Smooth scroll (glue de UNA sola RAF)
+Verbatim del README oficial de Lenis. NO corras además tu propio `requestAnimationFrame`
+para Lenis (double-drive = jitter).
+```javascript
+const lenis = new Lenis();
+lenis.on("scroll", ScrollTrigger.update);
+gsap.ticker.add((time) => { lenis.raf(time * 1000); });
+gsap.ticker.lagSmoothing(0);
+```
+Alternativa: GSAP ScrollSmoother. Nunca los dos a la vez.
+
+## Plantilla de brief de un-prompt
+
+```
+Construye un sitio award-winning cinematic 3D-scroll para <MARCA>.
+VISUALS (higgsfield-video, std 1080p, aspecto 16:9, ~8s/clip, sin audio):
+  genera UNA hero image primero y pásala como referencia a CADA clip (consistencia).
+  <3 a 5 shots, UN movimiento de cámara por shot, numerados>.
+WEBSITE: scroll-scrub del hero como canvas frame-sequence (Lenis + GSAP), secciones
+  pinneadas: <lista de secciones>.
+DESIGN: <fondo> / <acento único> / <tipografía>.
+COPY TONE: <voz>, pocas palabras.
+Launch on localhost and verify <la animación> before telling me it's done.
+```
+Esa última línea (auto-verificación forzada) es nuestra disciplina, no un adorno.
+Ver `references/verticals.md` para los 10 briefs por vertical ya armados.
+
+## Consistencia y encadenado (con honestidad)
+
+- **Hero-image primero:** genera una imagen y úsala como referencia (`input_files`) en
+  cada clip. Best practice DOCUMENTADA de Seedance 2.0 ("faces, clothing, visual style
+  stay locked across shots").
+- **Personas recurrentes:** entrena un Soul ID una vez y reusa su `reference_id`
+  (más fuerte que una imagen suelta).
+- **Encadenar clips:** Seedance 2.0 SÍ acepta start + end frame ("Start & End Frames").
+  Encadenar 5 clips (last-frame de uno como start-frame del siguiente) para "una toma
+  continua sin cortes" es un truco best-effort, NO garantizado por Higgsfield. No lo
+  prometas al cliente. El nombre exacto del param end-frame del MCP no está documentado;
+  resuélvelo en runtime (probe / `extra_params`).
+
+## Defaults de costo (los créditos expiran)
+
+std 1080p, ~8s, sin audio por default. 4K SOLO para el render final. "Compress the
+videos for web" (~-90%). Genera 2 a 3 tomas SOLO del hero (el hero-scrub es ~80% del wow).
+
+## Iterar como director, no como developer
+
+Notas por sensación: "hazlo 20% más lento", "esta sección se siente plana, agrega una
+interacción de cursor sutil", "cambia la tipografía, se ve genérica". El agente traduce
+intención a código.
+
+## Deploy "un prompt más" (Cloudflare Pages, gratis)
+
+1. `git push` de los estáticos a un repo de GitHub.
+2. Dash Cloudflare, Workers & Pages, Create application, Pages, Connect to Git, autoriza
+   el repo.
+3. Build command en BLANCO (HTML plano), Build output directory = carpeta del HTML.
+4. Save and Deploy (30 a 60s, obtienes `proyecto.pages.dev`).
+5. Custom domains, agrega el dominio (si ya está en Cloudflare crea el CNAME solo).
+
+Gotchas: (1) un proyecto Git-integration NO se puede pasar luego a Direct Upload;
+(2) completa el paso de custom-domain en el dash ANTES de agregar el CNAME o da 522;
+(3) records CAA que no permitan Cloudflare bloquean el certificado.
+
+## GTM (empaquetable)
+
+Los verticales restaurante, realtor y gym son un entregable local de $2,000 a $5,000:
+construye un sample, muéstralo a 5 negocios, cobra. Nunca han visto un sitio así.
+
+## Referencia autoritativa (opcional, para el admin)
+
+Para que el agente escriba pin/scrub/refresh/cleanup de GSAP impecables, el admin puede
+sumar a la flota el skill OFICIAL de GreenSock (MIT, auditado seguro):
+`/plugin marketplace add greensock/gsap-skills`. Este skill ya trae la receta inline,
+así que funciona sin él; es un plus, no un requisito.
+
+## Cross-refs
+
+- Assets (imagen/video): `higgsfield-video`, y NanoBanana2 para keyframes.
+- Gusto y anti-slop de diseño: `design-taste-frontend` + el theme engine OKLCH.
+- Copy sin señales de IA: `content-humanizer`.
+- Finishing determinista de clips (grain, Ken Burns, transiciones): `remotion-video`.

package/plugin/skills/cinematic-scroll-site/references/verticals.md

@@ -0,0 +1,92 @@
+# 10 verticales cinematic 3D-scroll (briefs base)
+
+Cada uno: para quién, los shots (3 a 5, UN movimiento de cámara cada uno), las secciones
+pinneadas, y la dirección de diseño. Rellena marca, ciudad y cifras; genera la hero image
+primero y pásala como referencia a cada clip.
+
+## 1. Producto de lujo (relojes, joyería, audio, sneakers)
+- Shots: (1) orbit 360 lento del producto flotando en vacío negro, rim light dramático;
+  (2) macro fly-through sobre el detalle (dial, textura, costura); (3) exploded assembly,
+  el producto se arma desde componentes flotantes.
+- Secciones: hero con el nombre en tracking, historia, macro-detalles, vista técnica con
+  spec callouts, edición limitada + CTA de waitlist.
+- Diseño: fondo off-black, un acento (oro/champagne), serif display alto contraste + sans
+  minimal. Copy: callado, caro, muy pocas palabras.
+
+## 2. Experiencia / storytelling (turismo, expediciones, museos)
+- Shots encadenados (aquí sí conviene el chaining best-effort): un descenso o recorrido
+  por zonas, cada clip termina donde arranca el siguiente. HUD fijo (profundidad, tiempo).
+- Secciones: hero con pregunta, un dato por zona, specs, CTA de reserva.
+- Diseño: color-grade que evoluciona con el scroll, un acento luminoso, sans técnica con
+  micro-detalles tipo instrumento.
+
+## 3. Portafolio personal (creadores, freelancers, consultores)
+- Sube una foto tuya bien iluminada de frente como referencia de identidad en cada clip.
+- Shots: (1) orbit 360 alrededor de ti, brazos cruzados, rim light; (2) tú entre pantallas
+  holográficas con tu trabajo, push-in lento; (3) caminas hacia cámara, pose final.
+- Secciones: nombre en display gigante letra por letra, strip de stats que cuentan al
+  scroll, 3 pilares, grid de trabajo con hover, CTA + socials.
+- Diseño: fondo tinta, un acento, display condensado bold, grano sutil.
+
+## 4. E-commerce / streetwear (drops, merch, ediciones limitadas)
+- Shots: (1) modelo camina hacia cámara entre niebla, el viento mueve la tela; (2) spins
+  1:1 de cada prenda en maniquí invisible, 360 limpio; (3) macro de costura y cierre.
+- Secciones: hero scroll-scrub del walk + countdown, grid de producto (cards que autoplay
+  su spin en hover), manifiesto de calidad, captura de email para tallas agotadas.
+- Diseño: gris concreto + negro mate, un acento ácido, condensada brutalista.
+
+## 5. Restaurante / cafe / bar (LOCAL, vendible $2k a $5k)
+- Shots: (1) macro slow-motion de la proteína sobre fuego, brasas subiendo; (2) dolly lento
+  por el salón en hora dorada; (3) cenital de un plato emplatándose, vapor subiendo.
+- Secciones: hero full-bleed scrub del fuego, historia breve, menú en dos columnas con
+  precios, reservación con formulario de fecha/party-size.
+- Diseño: fondo casi negro, crema cálida, acento ámbar, grano de película, parallax lento.
+  Móvil: menú colapsa a una columna elegante. Usa las fotos reales del negocio.
+
+## 6. Real estate (realtors, desarrollos, rentas vacacionales, hoteles)
+- Shots encadenados en un tour continuo: (1) drone que curva alrededor de la torre al
+  atardecer; (2) del elevador al living; (3) cocina y suite principal; (4) terraza de noche,
+  alberca infinita reflejando el skyline.
+- Secciones: hero, strip de facts (recámaras/baños/m2), galería, amenidades con reveals,
+  precio, "Request a Private Showing" con card del agente.
+- Diseño: fondo tinta, acento champagne-gold, serif delgado, mucho whitespace. Usa las
+  fotos reales de la propiedad como start frames.
+
+## 7. Automotriz / producto grande (autos, drones, bikes, maquinaria)
+- Shots encadenados del producto moviéndose por terreno real, no en estudio: (1) reveal en
+  desierto al amanecer; (2) low tracking shot lanzándose; (3) cañón a velocidad; (4) modo
+  noche, solo su firma de luz.
+- Secciones: hero con el nombre ultrawide, stats que cuentan al scroll, diseño con macro
+  stills, sección night-mode, teaser de configurador, CTA de reserva.
+- Diseño: negro sobre negro, acento cian eléctrico, condensada ultrawide, motion blur sutil.
+
+## 8. SaaS / app (software, herramientas AI, startups)
+- Shots: (1) partículas de datos que se ensamblan en un dashboard flotante que "late";
+  (2) macro sobre charts holográficos, una anomalía roja se enciende; (3) el dashboard en
+  una laptop en oficina minimal luminosa, todo bajo control.
+- Secciones: hero donde el dashboard se construye al scroll, logo strip de social proof,
+  3 bloques de feature, contadores de métricas, screenshot real del producto en mockup de
+  navegador, tabla de pricing (tier medio destacado), FAQ, CTA final.
+- Diseño: hero casi negro que funde a blanco para el body, un acento violeta, sans
+  geométrica, cards glassmorphism. Combo de credibilidad: hero generado + screenshots reales.
+
+## 9. Agencia / estudio creativo
+- Shots: (1) tinta negra floreciendo en agua en slow motion, con destellos de oro;
+  (2) showreel: posters y pantallas con tipografía bold deslizándose por paredes de galería;
+  (3) siluetas de un equipo pequeño trabajando de noche, bokeh de ciudad por la ventana.
+- Secciones: hero con la tinta detrás del nombre en display enorme, manifiesto kinético
+  (una palabra por paso de scroll), grid de casos con hover-video, servicios en dos columnas
+  editoriales, equipo, footer sobredimensionado con CTA.
+- Diseño: negro puro + hueso, oro usado exactamente 3 veces en todo el sitio, mezcla de un
+  display brutalista con un serif refinado. Cursor = punto de oro con estela.
+
+## 10. Gym / fitness (LOCAL, vendible $2k+)
+- Shots: (1) atleta choca manos con tiza en gym oscuro, la nube de tiza florece en un haz de
+  luz cenital; (2) macro tracking por una barra cargada, textura de knurling y tiza;
+  (3) corredor en pista al amanecer, aliento visible, cámara baja y rápida al lado.
+- Secciones: hero scrub de la nube de tiza, filosofía (una línea por paso de scroll), grid
+  de programas con hover, coaches, strip de resultados con contadores, pricing (3 tiers,
+  medio destacado), horario + mapa + formulario.
+- Diseño: fondo carbón, tipo hueso, un acento rojo sangre, display industrial condensado,
+  grano y viñeta en toda la imagen. Móvil: programas en cards swipeables. Usa fotos reales
+  del espacio y su horario y precios.

package/plugin/skills/reasoning-discipline/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: reasoning-discipline
+description: Eleva a CUALQUIER modelo (Opus/Sonnet/Haiku/Fable) a operar con la disciplina de un modelo fuerte, vía 5 compuertas (scoping, evidencia, adversarial, verificación, reporte) + ruteo por modelo/esfuerzo. USAR antes de una tarea multi-paso difícil, un build, una auditoría, una migración, o cuando el usuario pida "modo riguroso", "fable mode", "piensa/razona con disciplina", "no me falles", "verifica antes de terminar", o cuando vayas a delegar a subagentes. Es la versión de UN-solo-agente del protocolo de comité.
+---
+
+# Reasoning Discipline: el proceso es el foso, no el modelo
+
+Regla de fondo (validada, Brain #6648): no puedes quedarte con la INTELIGENCIA de
+un modelo, pero sí con su PROCESO. Lo que produce salidas confiables es el harness,
+las compuertas y los loops, no el modelo. Esta disciplina eleva a un modelo barato,
+pero NO cambia su capacidad de base: no la sobre-vendas como un upgrade de inteligencia.
+
+Cárgala cuando la tarea sea cara de equivocar. Para trabajo trivial, no estorbes.
+
+## Las 5 compuertas (no las saltes)
+
+1. **SCOPING (antes de tocar nada).** No solo listar pasos: hacer de abogado del
+   diablo sobre lo desconocido. ¿Qué podría salir mal? ¿Qué supuestos no verifiqué?
+   Escribe el plan por etapas, numeradas, cada una con su condición de "pasa".
+2. **EVIDENCIA antes de razonar.** Lee el archivo, corre el grep, mira el esquema
+   real ANTES de teorizar. No razones sobre lo que crees que dice el código; ábrelo.
+3. **RAZONAR ADVERSARIALMENTE.** Ataca tu propia solución. ¿Qué caso la rompe?
+   ¿Qué cifra inventé? ¿Qué claim no es objetivamente verificable? Ante la duda,
+   asume que está mal hasta probar lo contrario.
+4. **VERIFICAR antes de declarar hecho.** Cada etapa define una condición que un
+   ARTEFACTO EXTERNO satisface (un test que pasa, un grep que devuelve la línea, un
+   `execute_orm` que da el número, un screenshot que se ve bien). "Se ve bien" no es
+   verificación; un artefacto sí. Re-verifica cada "listo" antes de decirlo.
+5. **REPORTAR / CALIBRAR.** Di qué falló, qué quedó sin verificar, qué es supuesto
+   vs. hecho. Honestidad sobre impresión. El reporte es parte del trabajo.
+
+Esto es el `feedback_committee_operating_protocol` en formato de un-solo-agente.
+Cuando la tarea amerite paralelismo o red-team, escala al comité (Workflow).
+
+## Principios operativos (del system prompt filtrado de Fable 5)
+
+Fuente CC0 pública (`asgeirtj/system_prompts_leaks`, corroborada por
+`jujumilk3/leaked-system-prompts`). Citar como filtrado, no confirmado por Anthropic.
+Cuatro reglas listas para usar:
+
+- **Verifica antes de confiar en la memoria.** "El reconocimiento parcial del training
+  no es conocimiento actual." Si lo recuerdas pero no lo comprobaste, compruébalo.
+- **Comprueba que el archivo exista.** Que el prompt implique que un archivo está
+  presente no significa que lo esté (el usuario pudo olvidar subirlo). Revisa tú mismo.
+- **Responde primero, pregunta después.** Atiende una consulta ambigua ANTES de pedir
+  aclaración. Máximo UNA pregunta por respuesta.
+- **Escala el esfuerzo a la tarea.** 1 llamada de herramienta para un dato simple,
+  3 a 5 para una tarea media, 5 a 10 para research o comparación honda.
+
+## Calibración de esfuerzo (importante)
+
+Más esfuerzo NO es siempre mejor. El esfuerzo bajo de un modelo top suele igualar al
+esfuerzo alto del tier siguiente. Subir a `xhigh`/`max` a veces EMPEORA: el modelo se
+sobre-piensa y se contradice. Default sensato: `high`. Sube solo si la tarea lo exige
+y estás dispuesto a pagar la latencia y el riesgo de overthinking.
+
+## Ruteo de modelo (delega el trabajo mecánico al tier barato)
+
+Palanca NATIVA de Claude Code (sin código):
+- `CLAUDE_CODE_SUBAGENT_MODEL` rutea TODOS los subagentes a un tier barato.
+- Cada subagente acepta el campo `model:` (incluido `inherit`).
+
+Policy de delegación:
+| Trabajo | Tier | Por qué |
+|---|---|---|
+| Razonamiento real, diseño, review de código, síntesis | Opus / Fable | Necesita juicio |
+| Variantes creativas, transformaciones con contexto | Sonnet | Buen costo/juicio |
+| Bulk mecánico: extracción, clasificación, sweeps, scouts | Haiku | ~3× más barato/token |
+
+Empareja el tier a la DIFICULTAD de la etapa, no al hábito.
+
+**Corrección de honestidad (no propagar el mito).** La frase de la comunidad
+"orquestador Opus + scouts Haiku = misma calidad, 3× más barato" NO tiene benchmark.
+El dato publicado de Anthropic (`anthropic.com/engineering/multi-agent-research-system`)
+es Opus-líder + Sonnet-subagentes = +90.2% en su eval de research, a ~15× MÁS tokens.
+O sea: el patrón orquestador-worker COMPRA calidad a mayor costo de tokens. "Haiku
+~3× más barato por token" es cierto; el combinado "misma calidad Y 3× más barato" no.
+Cuando cites el fundamento de nuestros comités, usa el número real (Opus+Sonnet,
++90.2%, 15× tokens), nunca el mito del ahorro.
+
+## Endurecer una compuerta con un hook (opcional)
+
+Una regla enforzada por un hook real vence a la prosa. Igual que el `ai-slop-lint`
+que falla el build, se puede enforzar una compuerta (p. ej. "un test nunca nombra una
+ruta de datos productiva") con un hook `PostToolUse` que bloquee la violación. Patrón:
+un solo gate mecánico, no todo el skill. Si vas a construir uno, documenta qué cazá,
+qué salta y qué NO cubre (los blind spots) en el propio hook.
+
+## Al cerrar
+
+Si esto fue un plan o un comité, captura sus perspectivas al Brain (`capture_learning`)
+antes de terminar. El análisis de un plan es conocimiento durable; perderlo es el error.