@planu/cli 0.24.0 → 0.26.0

package/src/config/framework-registry/typescript-nuxt.json

@@ -0,0 +1,67 @@
+{
+  "framework": "nuxt",
+  "displayName": "Nuxt",
+  "frameworkVersion": "3.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "useFetch() para data fetching con SSR en Nuxt 3",
+      "example": "const { data, pending } = await useFetch('/api/items');",
+      "since": "3.0"
+    },
+    {
+      "pattern": "Auto-imports de composables — no se importan manualmente",
+      "example": "// useState, useRoute, useFetch disponibles sin import",
+      "since": "3.0"
+    },
+    {
+      "pattern": "server/api/*.ts para rutas de API server-side",
+      "example": "server/api/users.get.ts exporta defineEventHandler(event => { return { users: [] }; })",
+      "since": "3.0"
+    },
+    {
+      "pattern": "definePageMeta para metadatos de pagina",
+      "example": "definePageMeta({ layout: 'admin', middleware: 'auth' });",
+      "since": "3.0"
+    },
+    {
+      "pattern": "useRuntimeConfig para variables de entorno",
+      "example": "const config = useRuntimeConfig(); console.log(config.public.apiBase);",
+      "since": "3.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "asyncData() / fetch() de Nuxt 2",
+      "replacedBy": "useFetch() o useAsyncData() de Nuxt 3",
+      "severity": "error"
+    },
+    {
+      "pattern": "nuxt.config.js con modules de Nuxt 2 sin actualizar",
+      "replacedBy": "nuxt.config.ts con modulos compatibles Nuxt 3",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Importar manualmente composables que son auto-importados",
+      "example": "import { useFetch } from '#app' — innecesario en Nuxt 3",
+      "replacedBy": "Usar directamente useFetch() sin import",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Acceder a process.env directamente en cliente",
+      "example": "process.env.MY_KEY — no disponible en el browser",
+      "replacedBy": "useRuntimeConfig().public.myKey",
+      "severity": "error"
+    },
+    {
+      "pattern": "Mezclar Nuxt 2 y Nuxt 3 APIs en el mismo proyecto",
+      "example": "asyncData() junto a useFetch()",
+      "replacedBy": "Migrar completamente a Nuxt 3 con useFetch/useAsyncData",
+      "severity": "error"
+    }
+  ]
+}

package/src/config/framework-registry/typescript-react.json

@@ -0,0 +1,77 @@
+{
+  "framework": "react",
+  "displayName": "React",
+  "frameworkVersion": "18.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "useState para estado local en componentes funcionales",
+      "example": "const [count, setCount] = useState<number>(0);",
+      "since": "16.8"
+    },
+    {
+      "pattern": "useEffect para side effects con array de dependencias",
+      "example": "useEffect(() => { fetchData(); }, [userId]);",
+      "since": "16.8"
+    },
+    {
+      "pattern": "useCallback para memoizar funciones y evitar re-renders",
+      "example": "const handleClick = useCallback(() => { ... }, [dep]);",
+      "since": "16.8"
+    },
+    {
+      "pattern": "Suspense para carga lazy y data fetching",
+      "example": "<Suspense fallback={<Spinner />}><LazyComponent /></Suspense>",
+      "since": "18.0"
+    },
+    {
+      "pattern": "createRoot para renderizado React 18",
+      "example": "import { createRoot } from 'react-dom/client'; createRoot(document.getElementById('root')).render(<App />);",
+      "since": "18.0"
+    },
+    {
+      "pattern": "useTransition para actualizaciones de estado no urgentes",
+      "example": "const [isPending, startTransition] = useTransition(); startTransition(() => setFilter(value));",
+      "since": "18.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "ReactDOM.render() — reemplazado en React 18",
+      "replacedBy": "createRoot(element).render(<App />)",
+      "severity": "error"
+    },
+    {
+      "pattern": "Class Components con lifecycle methods para nuevo codigo",
+      "replacedBy": "Function Components con hooks",
+      "severity": "warning"
+    },
+    {
+      "pattern": "componentWillMount / componentWillReceiveProps / componentWillUpdate",
+      "replacedBy": "useEffect o getDerivedStateFromProps",
+      "severity": "error"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Mutar el estado directamente en lugar de usar el setter",
+      "example": "state.items.push(newItem) — INCORRECTO",
+      "replacedBy": "setItems([...items, newItem])",
+      "severity": "error"
+    },
+    {
+      "pattern": "useEffect sin array de dependencias para ejecutar solo una vez",
+      "example": "useEffect(() => { init(); }) — sin [] ejecuta en cada render",
+      "replacedBy": "useEffect(() => { init(); }, []) — con [] ejecuta solo al montar",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Usar index como key en listas con reordenamiento",
+      "example": "items.map((item, index) => <Item key={index} />) — causa bugs con reordenamiento",
+      "replacedBy": "Usar un ID unico: items.map(item => <Item key={item.id} />)",
+      "severity": "warning"
+    }
+  ]
+}

package/src/config/framework-registry/typescript-remix.json

@@ -0,0 +1,61 @@
+{
+  "framework": "remix",
+  "displayName": "Remix",
+  "frameworkVersion": "2.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "loader function para data fetching server-side",
+      "example": "export const loader: LoaderFunction = async ({ params }) => { return json({ post: await getPost(params.id) }); };",
+      "since": "1.0"
+    },
+    {
+      "pattern": "action function para mutaciones de datos",
+      "example": "export const action: ActionFunction = async ({ request }) => { const data = await request.formData(); ... };",
+      "since": "1.0"
+    },
+    {
+      "pattern": "useLoaderData para consumir datos del loader",
+      "example": "const { post } = useLoaderData<typeof loader>();",
+      "since": "1.0"
+    },
+    {
+      "pattern": "ErrorBoundary export para manejar errores de ruta",
+      "example": "export function ErrorBoundary() { const error = useRouteError(); return <div>Error: {String(error)}</div>; }",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Form de Remix para submissions con progressive enhancement",
+      "example": "import { Form } from '@remix-run/react'; <Form method='post'>",
+      "since": "1.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "CatchBoundary de Remix v1",
+      "replacedBy": "ErrorBoundary con useRouteError() en Remix v2",
+      "severity": "error"
+    },
+    {
+      "pattern": "useTransition() de Remix v1",
+      "replacedBy": "useNavigation() en Remix v2",
+      "severity": "error"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Intentar acceder a window/document en el loader",
+      "example": "export const loader = () => { window.localStorage.getItem('key') } — loader corre en server",
+      "replacedBy": "El loader solo corre en server; acceder a cookies via request.headers",
+      "severity": "error"
+    },
+    {
+      "pattern": "Confundir useLoaderData con useActionData",
+      "example": "useLoaderData para leer resultado de action — INCORRECTO",
+      "replacedBy": "useActionData para leer resultado de actions, useLoaderData para loaders",
+      "severity": "warning"
+    }
+  ]
+}

package/src/config/framework-registry/typescript-sveltekit.json

@@ -0,0 +1,67 @@
+{
+  "framework": "sveltekit",
+  "displayName": "SvelteKit",
+  "frameworkVersion": "2.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "load function en +page.server.ts para data fetching server-side",
+      "example": "export const load: PageServerLoad = async ({ params }) => { return { post: await getPost(params.id) }; };",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Form Actions en +page.server.ts para mutaciones",
+      "example": "export const actions: Actions = { create: async ({ request }) => { ... } };",
+      "since": "1.0"
+    },
+    {
+      "pattern": "use:enhance para progressive enhancement de formularios",
+      "example": "<form method='POST' use:enhance>",
+      "since": "1.0"
+    },
+    {
+      "pattern": "$state rune para estado reactivo en Svelte 5",
+      "example": "let count = $state(0);",
+      "since": "2.0"
+    },
+    {
+      "pattern": "hooks.server.ts para middleware global",
+      "example": "export const handle: Handle = async ({ event, resolve }) => { return resolve(event); };",
+      "since": "1.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "writable() stores de Svelte 4 para nuevo codigo Svelte 5",
+      "replacedBy": "$state rune y $derived rune",
+      "severity": "warning"
+    },
+    {
+      "pattern": "onMount para data fetching en lugar de load function",
+      "replacedBy": "load function en +page.server.ts o +page.ts",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Usar fetch directamente en componente para SSR data",
+      "example": "onMount(async () => { data = await fetch('/api/...') }) — no funciona en SSR",
+      "replacedBy": "load function en +page.server.ts",
+      "severity": "error"
+    },
+    {
+      "pattern": "Confundir +page.ts (universal) con +page.server.ts (solo server)",
+      "example": "Acceder a DB en +page.ts — expone credenciales al cliente",
+      "replacedBy": "Usar +page.server.ts para logica con acceso a DB/secrets",
+      "severity": "error"
+    },
+    {
+      "pattern": "Importar stores de Svelte 4 ($store syntax) en contexto server-side",
+      "example": "import { get } from 'svelte/store'; get(myStore) — no funciona en SSR",
+      "replacedBy": "Pasar datos via load function y props",
+      "severity": "error"
+    }
+  ]
+}

package/src/config/framework-registry/typescript-vue.json

@@ -0,0 +1,72 @@
+{
+  "framework": "vue",
+  "displayName": "Vue",
+  "frameworkVersion": "3.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Composition API con <script setup> para componentes Vue 3",
+      "example": "<script setup lang='ts'>\\nconst count = ref(0)\\n</script>",
+      "since": "3.0"
+    },
+    {
+      "pattern": "ref() para valores primitivos reactivos",
+      "example": "const message = ref<string>('hello'); console.log(message.value);",
+      "since": "3.0"
+    },
+    {
+      "pattern": "reactive() para objetos reactivos",
+      "example": "const state = reactive({ count: 0, name: '' });",
+      "since": "3.0"
+    },
+    {
+      "pattern": "Pinia para estado global en Vue 3",
+      "example": "const useStore = defineStore('main', () => { const count = ref(0); return { count }; });",
+      "since": "3.0"
+    },
+    {
+      "pattern": "defineProps y defineEmits en <script setup>",
+      "example": "const props = defineProps<{ title: string }>(); const emit = defineEmits<{ click: [] }>();",
+      "since": "3.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "Vue 2 Options API new Vue({ data, methods }) para nuevo codigo",
+      "replacedBy": "Vue 3 Composition API con <script setup>",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Vuex para nuevo codigo Vue 3",
+      "replacedBy": "Pinia (store oficial para Vue 3)",
+      "severity": "warning"
+    },
+    {
+      "pattern": "this.$set() de Vue 2 para reactividad",
+      "replacedBy": "ref() o reactive() — son automaticamente reactivos en Vue 3",
+      "severity": "error"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Acceder a ref sin .value en <script setup>",
+      "example": "const count = ref(0); count++ — INCORRECTO, count es un objeto Ref",
+      "replacedBy": "count.value++ — acceder via .value en JS/TS",
+      "severity": "error"
+    },
+    {
+      "pattern": "Usar $emit en lugar de defineEmits en <script setup>",
+      "example": "this.$emit('change') — INCORRECTO en <script setup>",
+      "replacedBy": "const emit = defineEmits(['change']); emit('change')",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Mutar props directamente",
+      "example": "props.value = newValue — las props son de solo lectura",
+      "replacedBy": "Emitir un evento al padre para que actualice el valor",
+      "severity": "error"
+    }
+  ]
+}

package/src/config/license-plans.json

@@ -38,7 +38,8 @@
     "learn_pattern",
     "consult_docs",
     "facilitate",
-    "check_config_health"
+    "check_config_health",
+    "list_templates"
   ],
   "proTools": [
     "audit",
@@ -79,9 +80,28 @@
     "security_check",
     "suggest_mcps",
     "suggest_tooling",
-    "validate_workflow"
+    "spec_history",
+    "validate_workflow",
+    "spec_coverage",
+    "estimate_ai_cost",
+    "generate_ci",
+    "manage_hooks",
+    "apply_template",
+    "check_spec_accuracy",
+    "update_registry"
+  ],
+  "alwaysAllowed": [
+    "activate_license",
+    "deactivate_license",
+    "license_status",
+    "usage_stats",
+    "usage_report",
+    "start_dashboard",
+    "stop_dashboard",
+    "start_webhook",
+    "stop_webhook",
+    "webhook_status"
   ],
-  "alwaysAllowed": ["activate_license", "deactivate_license", "license_status", "usage_stats", "usage_report"],
   "variantMapping": {
     "Planu Pro": "pro",
     "Planu Team": "team"