@polymorphism-tech/morph-spec 8.28.0 → 8.29.0

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 8.28.0  
+**Version:** 8.29.0  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -368,4 +368,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v8.28.0 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v8.29.0 by [Polymorphism Tech](https://polymorphism.tech)*

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "8.28.0",
+  "version": "8.29.0",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -186,4 +186,4 @@ Never edited directly — go through CLI commands or `morph-spec update` instead
 
 ---
 
-*morph-spec v8.28.0 by Polymorphism Tech*
+*morph-spec v8.29.0 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -249,4 +249,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v8.28.0 by Polymorphism Tech*
+*morph-spec v8.29.0 by Polymorphism Tech*

package/framework/agents.json

@@ -101,16 +101,27 @@
       "domains": ["ui", "ux", "design-system", "accessibility"],
       "keywords": [
         "design", "ui", "ux", "design system", "tokens", "wcag",
-        "accessibility", "mockup", "flow", "shadcn", "tailwind"
+        "accessibility", "mockup", "flow", "shadcn", "tailwind",
+        "motion", "scroll", "scrub", "gsap", "lenis", "seo"
       ],
       "stack": ["*"],
       "standards": [
         "frontend-design-system-naming",
         "frontend-design-system-animations",
-        "frontend-nextjs-motion-patterns"
+        "frontend-nextjs-motion-patterns",
+        "frontend-design-system-premium-finish",
+        "frontend-design-system-ai-image-generation",
+        "frontend-design-system-ai-video-generation",
+        "frontend-scroll-driven-frame-scrub",
+        "frontend-scroll-driven-smooth-scroll",
+        "frontend-scroll-driven-scroll-components",
+        "frontend-seo-meta-schema-audit",
+        "frontend-gsap-core",
+        "frontend-gsap-scrolltrigger",
+        "frontend-gsap-plugins"
       ],
       "tools": "Read, Write, Edit, Glob, Grep",
-      "mcp": ["context7", "stitch", "gemini-image", "playwright"],
+      "mcp": ["context7", "stitch", "gemini-image", "playwright", "seedance"],
       "model": "sonnet",
       "persona": "Você desenha sistemas, não telas isoladas. Pensa em tokens (cor, espaço, tipografia), componentes reutilizáveis, estados (default/hover/focus/disabled/loading/error), acessibilidade WCAG AA. Mockups em Tailwind direto, sem Figma intermediário."
     },

package/framework/commands/create-umbraco-lp.md

@@ -30,6 +30,6 @@ Cria um projeto de landing page novo a partir do template canônico `MORPH_Umbra
 ## Referências
 
 - `.claude/skills/create-umbraco-lp/SKILL.md`
-- `docs/umbraco-lp-patterns.md` (em `main`)
+- `references/umbraco-lp-patterns.md` (dentro da skill `create-umbraco-lp`)
 
 **Projeto:** $ARGUMENTS

package/framework/mcp/registry.json

@@ -176,15 +176,15 @@
         "testCall": "Call get_configuration_status to verify API key and server health",
         "testParams": {},
         "successIndicator": "Returns status with valid API key configured",
-        "failureHint": "Gemini Image MCP not responding. Ensure GEMINI_API_KEY is set in MCP server configuration. Install: npx gemini-image-mcp@latest"
+        "failureHint": "Gemini Image MCP not responding. Check that GEMINI_API_KEY is set in the MCP env config and that MORPH_HUB points at a built morph-HUB checkout."
       },
       "install": {
         "autoInstall": false,
         "transport": "stdio",
         "config": {
           "type": "stdio",
-          "command": "cmd",
-          "args": ["/c", "npx", "-y", "gemini-image-mcp@latest"]
+          "command": "node",
+          "args": ["${MORPH_HUB}/mcps/gemini-image/dist/index.js"]
         },
         "credentials": [
           {
@@ -194,19 +194,70 @@
             "helpUrl": "https://aistudio.google.com/apikey"
           }
         ],
-        "prerequisites": ["Google AI Studio API key"],
+        "prerequisites": [
+          "Google AI Studio API key",
+          "Local morph-HUB checkout with mcps/gemini-image built, exposed via the MORPH_HUB env var"
+        ],
         "stackRelevance": ["nextjs", "next"],
-        "warnings": ["Requires GEMINI_API_KEY environment variable. Image generation costs apply per Google AI pricing."],
-        "setupGuide": "1. Get API key from https://aistudio.google.com/apikey\n2. Run: claude mcp add gemini-image-mcp -- npx gemini-image-mcp@latest\n3. Set GEMINI_API_KEY in MCP env config"
+        "warnings": [
+          "Internal Polymorphism MCP, not published to npm. The public gemini-image-mcp package was unpublished in 2025-04, so npx installs no longer work.",
+          "Requires GEMINI_API_KEY environment variable. Image generation costs apply per Google AI pricing."
+        ],
+        "setupGuide": "1. Get an API key at https://aistudio.google.com/apikey\n2. Build the MCP: cd $MORPH_HUB/mcps/gemini-image && npm install && npm run build\n3. Run: claude mcp add gemini-image-mcp -e GEMINI_API_KEY=<key> -- node $MORPH_HUB/mcps/gemini-image/dist/index.js\n4. Verify with get_configuration_status"
+      }
+    },
+    "seedance": {
+      "phases": ["uiux", "implement"],
+      "tools": ["generate_video", "generate_loop_video", "get_video", "list_videos"],
+      "detection": "mcpServers includes seedance",
+      "fallback": "Use client-provided footage or a static poster image; canvas frame-scrub works from any frame sequence, AI-generated or not",
+      "usage": "AI video generation for scroll-driven heroes and ambient backgrounds. generate_video with endImage produces the directional footage that frame-scrub needs (start frame differs from end frame); generate_loop_video is only for seamless ambient loops",
+      "healthCheck": {
+        "toolPattern": "seedance",
+        "testCall": "Call list_videos with limit 1 to verify the server responds (reads local history, spends no credits)",
+        "testParams": {
+          "limit": 1
+        },
+        "successIndicator": "Returns the local job history, or 'No videos in history yet'",
+        "failureHint": "Seedance MCP not responding. Check that REPLICATE_API_TOKEN is set in the MCP env config and that MORPH_HUB points at a built morph-HUB checkout."
+      },
+      "install": {
+        "autoInstall": false,
+        "transport": "stdio",
+        "config": {
+          "type": "stdio",
+          "command": "node",
+          "args": ["${MORPH_HUB}/mcps/seedance/dist/index.js"]
+        },
+        "credentials": [
+          {
+            "name": "Replicate API Token",
+            "envVar": "REPLICATE_API_TOKEN",
+            "secret": true,
+            "helpUrl": "https://replicate.com/account/api-tokens"
+          }
+        ],
+        "prerequisites": [
+          "Replicate account with billing enabled",
+          "Local morph-HUB checkout with mcps/seedance built, exposed via the MORPH_HUB env var",
+          "ffmpeg on PATH to extract frames for scroll-scrubbing"
+        ],
+        "stackRelevance": ["next", "react", "vite", "astro"],
+        "warnings": [
+          "Internal Polymorphism MCP, not published to npm. Requires a local morph-HUB checkout.",
+          "Paid per generation. Draft at fast/480p/4s first, render 1080p only after the take is approved.",
+          "Generation is stochastic and needs a human approval gate. Do not wire it into an unattended phase."
+        ],
+        "setupGuide": "1. Get a token at https://replicate.com/account/api-tokens\n2. Build the MCP: cd $MORPH_HUB/mcps/seedance && npm install && npm run build\n3. Run: claude mcp add seedance -e REPLICATE_API_TOKEN=<token> -- node $MORPH_HUB/mcps/seedance/dist/index.js\n4. Verify with list_videos (reads local history, spends no credits)"
       }
     }
   },
   "_phaseMatrixNote": "Keys must be the v5 phases from framework/phases.json. The v4 keys 'design' and 'tasks' both collapsed into 'plan'; 'review' was absent entirely, so a project in review resolved to undefined. Stack-scoped MCPs (asaas) stay out of this matrix on purpose — only universal ones are listed.",
   "phaseMatrix": {
     "proposal": ["context7"],
-    "uiux": ["playwright", "context7", "stitch", "gemini-image"],
+    "uiux": ["playwright", "context7", "stitch", "gemini-image", "seedance"],
     "plan": ["context7"],
-    "implement": ["context7", "playwright", "vercel", "gemini-image"],
+    "implement": ["context7", "playwright", "vercel", "gemini-image", "seedance"],
     "review": ["playwright", "context7"]
   }
 }

package/framework/skills/core/create-umbraco-lp/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a criação de uma landing page nova ponta-a-ponta a partir do
 version: core
 when-to-invoke: ao iniciar um novo projeto de LP com o template Umbraco genérico
 user-invokable: true
-cliVersion: "8.28.0"
+cliVersion: "8.29.0"
 stacks:
   - umbraco
 ---
@@ -199,6 +199,17 @@ Edite `frontend/src/app/globals.css`. As variáveis CSS de base do tema são def
 
 Para tipografias customizadas, importe via `next/font` em `frontend/src/app/layout.tsx` e exponha como variável CSS.
 
+> **Se a LP nasce cinematográfica (scroll-driven):** o template não traz `gsap` nem `lenis`; adicione ao
+> `frontend/package.json` e monte o runtime de motion como componente `'use client'` montado uma vez na
+> page, com guard de SSR no registro do ScrollTrigger. O conhecimento está nos standards
+> `frontend/scroll-driven/smooth-scroll.md` (wiring Lenis com o ticker do GSAP, `window.__lenis`,
+> armadilha de HMR), `frame-scrub.md` (canvas quadro a quadro, extração ffmpeg, poster no mobile) e
+> `scroll-components.md` (pin, modal, parallax, reveal). Regra de assets que vale desde o primeiro dia:
+> **sequência de frames é asset estrutural em `frontend/public/` com cache-bust `?v=N` manual, e só o
+> poster vira mídia editável no backoffice.** Frames na Media Library perdem o webp (o ImageSharp do
+> Umbraco 17 exige URL assinada por HMAC, não relaxável por config) e viram 145 requests assinadas
+> por visitante.
+
 **4.2 — Módulos disponíveis (Content Types *Section):**
 
 O template já inclui os seguintes módulos versionados em `backend/uSync/v17/ContentTypes/`:
@@ -268,7 +279,7 @@ Antes de fazer deploy ou entregar o projeto ao cliente:
 ## Referências
 
 - `polymorphism-tech/MORPH_Umbraco_LP_Template` (privado, branch `master`) — template canônico: `scripts/new-lp.ps1`, `scripts/new-lp.sh`, `backend/Infrastructure/SeedContentHandler.cs`, `backend/Controllers/LeadController.cs`, `backend/uSync/v17/`.
-- `docs/umbraco-lp-patterns.md` (em `main` neste repo) — padrões e gotchas detalhados: controller público (seção 1), DI multi-sink (seção 2), leitura server-side de config oculta (seção 3), segurança Delivery API (seção 4), uSync config-as-code (seção 5), dropdown gotcha (seção 6), seed idempotente (seção 7), endpoint Ping (seção 10), skip silencioso em dev (seção 11), build Next.js exige backend (seção 12).
+- `references/umbraco-lp-patterns.md` (carregue sob demanda) — padrões e gotchas detalhados: controller público (seção 1), DI multi-sink (seção 2), leitura server-side de config oculta (seção 3), segurança Delivery API (seção 4), uSync config-as-code (seção 5), dropdown gotcha (seção 6), seed idempotente (seção 7), endpoint Ping (seção 10), skip silencioso em dev (seção 11), build Next.js exige backend (seção 12).
 - `backend/appsettings.json` — `Umbraco:CMS:DeliveryApi:DisallowedContentTypeAliases` e `uSync:Settings:ImportAtStartup`.
 - `backend/Properties/launchSettings.json` — portas de dev: HTTP `:19223`, HTTPS `:44324`.
 - `docker-compose.yml` — orquestração de produção (backend porta `5001`, frontend `3000`).