@planu/cli 0.24.0 → 0.25.0

package/src/config/framework-registry/python-fastapi.json

@@ -0,0 +1,72 @@
+{
+  "framework": "fastapi",
+  "displayName": "FastAPI",
+  "frameworkVersion": "0.100+",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "python",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Pydantic v2 BaseModel para request/response schemas",
+      "example": "class UserCreate(BaseModel): name: str; email: EmailStr; model_config = ConfigDict(str_strip_whitespace=True)",
+      "since": "0.100"
+    },
+    {
+      "pattern": "Depends() para dependency injection",
+      "example": "async def get_current_user(token: str = Depends(oauth2_scheme)): ...",
+      "since": "0.1"
+    },
+    {
+      "pattern": "async/await para rutas de I/O",
+      "example": "@app.get('/users') async def read_users(db: AsyncSession = Depends(get_db)): ...",
+      "since": "0.1"
+    },
+    {
+      "pattern": "HTTPException para errores HTTP",
+      "example": "raise HTTPException(status_code=404, detail='User not found')",
+      "since": "0.1"
+    },
+    {
+      "pattern": "lifespan context manager para startup/shutdown en FastAPI 0.93+",
+      "example": "@asynccontextmanager async def lifespan(app: FastAPI): await db.connect(); yield; await db.disconnect()",
+      "since": "0.93"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "on_event('startup') / on_event('shutdown') decorators",
+      "replacedBy": "lifespan context manager en FastAPI 0.93+",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Pydantic v1 validator() decorator",
+      "replacedBy": "Pydantic v2 field_validator() con mode='before'/'after'",
+      "severity": "error"
+    },
+    {
+      "pattern": "Pydantic v1 .dict() en lugar de .model_dump()",
+      "replacedBy": ".model_dump() de Pydantic v2",
+      "severity": "error"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Ruta sincrona para operaciones de I/O",
+      "example": "@app.get('/data') def read_data(): return requests.get('...').json() — bloquea el event loop",
+      "replacedBy": "@app.get('/data') async def read_data(): return await httpx.get('...')",
+      "severity": "error"
+    },
+    {
+      "pattern": "No validar el response_model — retornar datos sensibles",
+      "example": "@app.get('/users') async def get_user(): return user_from_db — puede exponer password_hash",
+      "replacedBy": "@app.get('/users', response_model=UserPublic) — filtrar con Pydantic",
+      "severity": "error"
+    },
+    {
+      "pattern": "spring.datasource.url con formato antiguo de Spring Boot 3",
+      "example": "spring.datasource.url=jdbc:mysql://localhost:3306/db (formato Spring Boot 2)",
+      "replacedBy": "spring.datasource.url=jdbc:mysql://localhost:3306/db (sigue igual pero con driver actualizado)",
+      "severity": "info"
+    }
+  ]
+}

package/src/config/framework-registry/ruby-rails.json

@@ -0,0 +1,67 @@
+{
+  "framework": "rails",
+  "displayName": "Rails",
+  "frameworkVersion": "7.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "ruby",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Hotwire (Turbo + Stimulus) para interactividad sin SPA",
+      "example": "turbo_stream_from @room — subscripcion a Turbo Stream desde el view",
+      "since": "7.0"
+    },
+    {
+      "pattern": "Strong Parameters con require y permit",
+      "example": "def user_params; params.require(:user).permit(:name, :email); end",
+      "since": "4.0"
+    },
+    {
+      "pattern": "ActiveRecord scopes para queries reutilizables",
+      "example": "scope :active, -> { where(status: 'active') }",
+      "since": "3.0"
+    },
+    {
+      "pattern": "Importmap para JavaScript sin Node/npm en produccion",
+      "example": "pin 'stimulus', to: 'https://cdn.jsdelivr.net/npm/@hotwired/stimulus@3/dist/stimulus.js'",
+      "since": "7.0"
+    },
+    {
+      "pattern": "credentials.yml.enc para secrets",
+      "example": "Rails.application.credentials.aws[:access_key_id]",
+      "since": "5.2"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "Webpacker para asset bundling en Rails 7",
+      "replacedBy": "Importmap (default) o jsbundling-rails con esbuild/rollup",
+      "severity": "error"
+    },
+    {
+      "pattern": "protect_from_forgery :null_session para APIs",
+      "replacedBy": "Heredar de ActionController::API para controllers de solo API",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "N+1 queries sin eager loading",
+      "example": "Post.all.each { |p| p.author.name } — N+1",
+      "replacedBy": "Post.includes(:author).each { |p| p.author.name }",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Logica de negocio en el controller",
+      "example": "def create; @user = User.new(user_params); @user.send_welcome_email; @user.save; end — logica en controller",
+      "replacedBy": "Mover a Service Objects o Concerns",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Secrets en el codigo fuente en lugar de credentials",
+      "example": "API_KEY = 'sk-hardcoded-key' en el codigo",
+      "replacedBy": "Rails.application.credentials.my_api[:key]",
+      "severity": "error"
+    }
+  ]
+}

package/src/config/framework-registry/rust-actix.json

@@ -0,0 +1,61 @@
+{
+  "framework": "actix",
+  "displayName": "Actix-web",
+  "frameworkVersion": "4.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "rust",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "web::Data para estado compartido entre handlers",
+      "example": "let data = web::Data::new(AppState { db: pool }); App::new().app_data(data.clone())",
+      "since": "4.0"
+    },
+    {
+      "pattern": "HttpResponse::Ok().json() para respuestas JSON",
+      "example": "async fn handler() -> impl Responder { HttpResponse::Ok().json(User { name: 'Alice' }) }",
+      "since": "4.0"
+    },
+    {
+      "pattern": "Extractors para parsear request (Path, Query, Json)",
+      "example": "async fn get_user(path: web::Path<u32>, db: web::Data<DbPool>) -> impl Responder { ... }",
+      "since": "4.0"
+    },
+    {
+      "pattern": "App::new().service() para registrar rutas",
+      "example": "App::new().service(web::resource('/users').route(web::get().to(list_users)))",
+      "since": "4.0"
+    },
+    {
+      "pattern": "ResponseError trait para errores tipados",
+      "example": "impl ResponseError for AppError { fn error_response(&self) -> HttpResponse { ... } }",
+      "since": "4.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "actix_web::web::ServiceConfig con firma antigua de Actix 3",
+      "replacedBy": "Actix 4: fn configure(cfg: &mut web::ServiceConfig) — misma firma pero el trait configure() cambio",
+      "severity": "error"
+    },
+    {
+      "pattern": "System::new().block_on() de Actix 1/2 para async runtime",
+      "replacedBy": "#[actix_web::main] macro o tokio runtime directamente",
+      "severity": "error"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Compartir estado no-Send entre threads con Arc sin Mutex",
+      "example": "let data = Arc::new(state); — si state no es Sync, falla en compilacion",
+      "replacedBy": "Arc<Mutex<State>> o Arc<RwLock<State>> para estado mutable compartido",
+      "severity": "error"
+    },
+    {
+      "pattern": "Olvidar .await en handlers async",
+      "example": "async fn handler() -> impl Responder { fetch_data() } — sin await devuelve un Future",
+      "replacedBy": "async fn handler() -> impl Responder { fetch_data().await }",
+      "severity": "error"
+    }
+  ]
+}

package/src/config/framework-registry/swift-swiftui.json

@@ -0,0 +1,67 @@
+{
+  "framework": "swiftui",
+  "displayName": "SwiftUI",
+  "frameworkVersion": "5.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "swift",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "@State para estado local del view",
+      "example": "@State private var isPresented = false",
+      "since": "1.0"
+    },
+    {
+      "pattern": "@ObservedObject o @StateObject para ViewModels",
+      "example": "@StateObject private var viewModel = UserViewModel()",
+      "since": "1.0"
+    },
+    {
+      "pattern": "NavigationStack para navegacion en iOS 16+",
+      "example": "NavigationStack { List(items) { item in NavigationLink(item.title, value: item) }.navigationDestination(for: Item.self) { item in DetailView(item: item) } }",
+      "since": "4.0"
+    },
+    {
+      "pattern": "@Query de SwiftData para data fetching en iOS 17+",
+      "example": "@Query var items: [Item]",
+      "since": "5.0"
+    },
+    {
+      "pattern": "task() modifier para async work asociado al view lifecycle",
+      "example": ".task { await viewModel.load() }",
+      "since": "3.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "NavigationView para navegacion en iOS 16+",
+      "replacedBy": "NavigationStack (iOS 16+) o NavigationSplitView para iPad",
+      "severity": "warning"
+    },
+    {
+      "pattern": "CoreData directamente en SwiftUI sin SwiftData",
+      "replacedBy": "SwiftData con @Model macro en iOS 17+",
+      "severity": "info"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Mutar @State desde un thread secundario",
+      "example": "DispatchQueue.global().async { self.isLoading = false } — debe ser en main thread",
+      "replacedBy": "DispatchQueue.main.async { self.isLoading = false } o usar @MainActor",
+      "severity": "error"
+    },
+    {
+      "pattern": "Crear @StateObject en el body del view",
+      "example": "var body: some View { let vm = ViewModel(); ... } — se crea en cada render",
+      "replacedBy": "@StateObject private var vm = ViewModel() — fuera del body",
+      "severity": "error"
+    },
+    {
+      "pattern": "Usar @ObservedObject cuando deberia ser @StateObject",
+      "example": "@ObservedObject var vm = ViewModel() — vm se puede perder al rerender",
+      "replacedBy": "@StateObject var vm = ViewModel() — SwiftUI gestiona el lifecycle",
+      "severity": "warning"
+    }
+  ]
+}

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

@@ -0,0 +1,67 @@
+{
+  "framework": "angular",
+  "displayName": "Angular",
+  "frameworkVersion": "17.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Standalone Components sin NgModule",
+      "example": "@Component({ standalone: true, imports: [CommonModule], template: '...' }) export class MyComponent {}",
+      "since": "15.0"
+    },
+    {
+      "pattern": "Signals para estado reactivo en Angular 17+",
+      "example": "const count = signal(0); const doubled = computed(() => count() * 2);",
+      "since": "16.0"
+    },
+    {
+      "pattern": "inject() en lugar de constructor DI en funciones",
+      "example": "const service = inject(MyService);",
+      "since": "14.0"
+    },
+    {
+      "pattern": "provideRouter() en lugar de RouterModule.forRoot()",
+      "example": "bootstrapApplication(AppComponent, { providers: [provideRouter(routes)] });",
+      "since": "15.0"
+    },
+    {
+      "pattern": "HttpClient con provideHttpClient()",
+      "example": "bootstrapApplication(App, { providers: [provideHttpClient(withFetch())] });",
+      "since": "17.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "NgModule-based architecture para nuevos proyectos",
+      "replacedBy": "Standalone Components (Angular 15+)",
+      "severity": "warning"
+    },
+    {
+      "pattern": "HttpClientModule en imports del modulo",
+      "replacedBy": "provideHttpClient() en bootstrapApplication providers",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Olvidar el decorador @Injectable() en servicios",
+      "example": "export class UserService { } — sin @Injectable({ providedIn: 'root' })",
+      "replacedBy": "@Injectable({ providedIn: 'root' }) export class UserService {}",
+      "severity": "error"
+    },
+    {
+      "pattern": "Suscribirse a Observables sin unsubscribe en componentes",
+      "example": "ngOnInit() { this.service.getUsers().subscribe(...) } — memory leak",
+      "replacedBy": "Usar takeUntilDestroyed() o async pipe en el template",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Usar ChangeDetectorRef.markForCheck() en lugar de signals",
+      "example": "this.cdr.markForCheck() — anti-patron con signals",
+      "replacedBy": "Usar signals y computed() para reactividad automatica",
+      "severity": "warning"
+    }
+  ]
+}

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

@@ -0,0 +1,61 @@
+{
+  "framework": "astro",
+  "displayName": "Astro",
+  "frameworkVersion": "4.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "client:load para Islands con hidratacion inmediata",
+      "example": "<ReactComponent client:load /> — hidrata al cargar la pagina",
+      "since": "1.0"
+    },
+    {
+      "pattern": "getCollection() para Content Collections",
+      "example": "const posts = await getCollection('blog');",
+      "since": "2.0"
+    },
+    {
+      "pattern": "Astro.props para acceder a props del componente",
+      "example": "const { title, author } = Astro.props;",
+      "since": "1.0"
+    },
+    {
+      "pattern": "SSR con output: 'server' en astro.config.mjs",
+      "example": "export default defineConfig({ output: 'server', adapter: node() });",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Frontmatter en .astro para logica server-side",
+      "example": "---\\nconst data = await fetch('...').then(r => r.json());\\n---",
+      "since": "1.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "Astro.fetchContent() de Astro 1",
+      "replacedBy": "getCollection() de Content Collections (Astro 2+)",
+      "severity": "error"
+    },
+    {
+      "pattern": "import.meta.glob para colecciones de contenido",
+      "replacedBy": "getCollection() con defineSSchema de Zod",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Usar hooks de React en un componente .astro",
+      "example": "const [state, setState] = useState() — en archivo .astro sin client directive",
+      "replacedBy": "Mover logica interactiva a un componente React/Vue con client:* directive",
+      "severity": "error"
+    },
+    {
+      "pattern": "client:visible sin justificacion de performance",
+      "example": "Usar client:load para todo en lugar de client:visible para contenido fuera del viewport",
+      "replacedBy": "client:visible para componentes debajo del fold, client:idle para no urgentes",
+      "severity": "warning"
+    }
+  ]
+}

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

@@ -0,0 +1,67 @@
+{
+  "framework": "express",
+  "displayName": "Express",
+  "frameworkVersion": "4.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Router modular para organizar rutas",
+      "example": "const router = express.Router(); router.get('/users', handler); app.use('/api', router);",
+      "since": "4.0"
+    },
+    {
+      "pattern": "Middleware de error con 4 parametros (err, req, res, next)",
+      "example": "app.use((err: Error, req: Request, res: Response, next: NextFunction) => { res.status(500).json({ error: err.message }); });",
+      "since": "4.0"
+    },
+    {
+      "pattern": "express.json() para parsear body JSON",
+      "example": "app.use(express.json()); app.use(express.urlencoded({ extended: true }));",
+      "since": "4.16"
+    },
+    {
+      "pattern": "next(error) para pasar errores al error handler",
+      "example": "try { ... } catch (err) { next(err); }",
+      "since": "4.0"
+    },
+    {
+      "pattern": "Tipos TypeScript con @types/express",
+      "example": "import type { Request, Response, NextFunction } from 'express';",
+      "since": "4.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "bodyParser npm package separado",
+      "replacedBy": "express.json() y express.urlencoded() incluidos en Express 4.16+",
+      "severity": "warning"
+    },
+    {
+      "pattern": "res.send() con objetos sin res.json()",
+      "replacedBy": "res.json({ data }) para respuestas JSON con Content-Type correcto",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Olvidar next() en middleware — la request se cuelga",
+      "example": "app.use((req, res, next) => { console.log(req.path); }); — sin next() el request queda pendiente",
+      "replacedBy": "Llamar next() al final del middleware: app.use((req, res, next) => { ...; next(); });",
+      "severity": "error"
+    },
+    {
+      "pattern": "Definir error handler ANTES de las rutas",
+      "example": "app.use(errorHandler); app.get('/users', handler); — el error handler debe ir al final",
+      "replacedBy": "Definir el error handler DESPUES de todas las rutas",
+      "severity": "error"
+    },
+    {
+      "pattern": "Async route handler sin try/catch ni wrapper",
+      "example": "app.get('/data', async (req, res) => { const data = await getDb(); res.json(data); }) — errores no llegaran al error handler",
+      "replacedBy": "Wrap async con try/catch y next(err) o usar express-async-errors",
+      "severity": "error"
+    }
+  ]
+}

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

@@ -0,0 +1,62 @@
+{
+  "framework": "nestjs",
+  "displayName": "NestJS",
+  "frameworkVersion": "10.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "@Injectable() para servicios con inyeccion de dependencias",
+      "example": "@Injectable() export class UserService { constructor(private readonly db: DatabaseService) {} }",
+      "since": "6.0"
+    },
+    {
+      "pattern": "@Controller() y @Get()/@Post() para definir rutas",
+      "example": "@Controller('users') export class UserController { @Get() findAll() { return this.service.findAll(); } }",
+      "since": "6.0"
+    },
+    {
+      "pattern": "@Module() para organizar la aplicacion en modulos",
+      "example": "@Module({ imports: [TypeOrmModule.forFeature([User])], controllers: [UserController], providers: [UserService] }) export class UserModule {}",
+      "since": "6.0"
+    },
+    {
+      "pattern": "Guards con @UseGuards() para autorizacion",
+      "example": "@UseGuards(JwtAuthGuard) @Get('profile') getProfile(@Request() req) { return req.user; }",
+      "since": "6.0"
+    },
+    {
+      "pattern": "Pipes para validacion de DTOs con class-validator",
+      "example": "@Body() createUserDto: CreateUserDto // con ValidationPipe global",
+      "since": "6.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "@nestjs/swagger sin versionado de API",
+      "replacedBy": "Usar versionado: app.enableVersioning({ type: VersioningType.URI })",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Olvidar registrar un Provider en el Module",
+      "example": "Inyectar UserService sin agregarlo a providers: [UserService] en UserModule",
+      "replacedBy": "Agregar todos los providers en el @Module() correspondiente",
+      "severity": "error"
+    },
+    {
+      "pattern": "Circular dependency entre modulos sin forwardRef",
+      "example": "ModuleA imports ModuleB y ModuleB imports ModuleA — error de circular dependency",
+      "replacedBy": "Usar forwardRef(() => ModuleB) en los imports",
+      "severity": "error"
+    },
+    {
+      "pattern": "Crear instancias de servicios con new en lugar de DI",
+      "example": "const service = new UserService() — rompe la inyeccion de dependencias",
+      "replacedBy": "Inyectar via constructor: constructor(private userService: UserService) {}",
+      "severity": "error"
+    }
+  ]
+}

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

@@ -0,0 +1,82 @@
+{
+  "framework": "nextjs",
+  "displayName": "Next.js",
+  "frameworkVersion": "14.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "typescript",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "App Router usa directorios page.tsx para definir rutas",
+      "example": "app/dashboard/page.tsx exporta un React component como ruta /dashboard",
+      "since": "13.4"
+    },
+    {
+      "pattern": "Server Components son async por defecto en App Router",
+      "example": "export default async function Page() { const data = await fetch('...'); return <div>{data}</div>; }",
+      "since": "13.4"
+    },
+    {
+      "pattern": "useRouter de next/navigation para App Router",
+      "example": "import { useRouter } from 'next/navigation'; const router = useRouter();",
+      "since": "13.0"
+    },
+    {
+      "pattern": "Server Actions para mutaciones de datos",
+      "example": "async function create(formData: FormData) { 'use server'; ... }",
+      "since": "14.0"
+    },
+    {
+      "pattern": "generateStaticParams para rutas estaticas dinamicas",
+      "example": "export async function generateStaticParams() { return [{ slug: 'post-1' }]; }",
+      "since": "13.4"
+    },
+    {
+      "pattern": "next/image para imagenes optimizadas",
+      "example": "import Image from 'next/image'; <Image src='/logo.png' width={100} height={100} alt='logo' />",
+      "since": "10.0"
+    },
+    {
+      "pattern": "metadata export para SEO en App Router",
+      "example": "export const metadata: Metadata = { title: 'Page Title', description: '...' };",
+      "since": "13.4"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "getServerSideProps en App Router",
+      "replacedBy": "Server Components con fetch() directo o generateStaticParams()",
+      "severity": "error"
+    },
+    {
+      "pattern": "getStaticProps / getStaticPaths en App Router",
+      "replacedBy": "generateStaticParams() + Server Components async",
+      "severity": "error"
+    },
+    {
+      "pattern": "pages/ directory para nuevas rutas cuando ya se usa app/",
+      "replacedBy": "app/ directory con page.tsx, layout.tsx, loading.tsx",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Usar useRouter() de next/router en App Router",
+      "example": "import { useRouter } from 'next/router' — INCORRECTO en App Router",
+      "replacedBy": "import { useRouter } from 'next/navigation'",
+      "severity": "error"
+    },
+    {
+      "pattern": "app.useRouter() — API que no existe en Next.js",
+      "example": "const router = app.useRouter() — nunca existio en ninguna version",
+      "replacedBy": "import { useRouter } from 'next/navigation' (App Router) o 'next/router' (Pages Router)",
+      "severity": "error"
+    },
+    {
+      "pattern": "Llamar fetch() dentro de un Client Component sin useEffect o SWR",
+      "example": "const data = await fetch('/api/data') — dentro de un 'use client' component sin hook",
+      "replacedBy": "Usar Server Component o usar SWR/TanStack Query en Client Components",
+      "severity": "warning"
+    }
+  ]
+}