@planu/cli 0.24.0 → 0.26.0

package/dist/config/ai-model-pricing.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12",
+  "version": "1.0.0",
+  "lastUpdated": "2026-03-04",
+  "models": [
+    {
+      "id": "claude-opus-4",
+      "displayName": "Claude Opus 4",
+      "provider": "Anthropic",
+      "inputPricePerMillion": 15.0,
+      "outputPricePerMillion": 75.0,
+      "avgThroughputLOCPerTurn": 150,
+      "contextWindowK": 200
+    },
+    {
+      "id": "claude-sonnet-4",
+      "displayName": "Claude Sonnet 4",
+      "provider": "Anthropic",
+      "inputPricePerMillion": 3.0,
+      "outputPricePerMillion": 15.0,
+      "avgThroughputLOCPerTurn": 120,
+      "contextWindowK": 200
+    },
+    {
+      "id": "claude-haiku-3-5",
+      "displayName": "Claude Haiku 3.5",
+      "provider": "Anthropic",
+      "inputPricePerMillion": 0.25,
+      "outputPricePerMillion": 1.25,
+      "avgThroughputLOCPerTurn": 80,
+      "contextWindowK": 200
+    },
+    {
+      "id": "gpt-4o",
+      "displayName": "GPT-4o",
+      "provider": "OpenAI",
+      "inputPricePerMillion": 2.5,
+      "outputPricePerMillion": 10.0,
+      "avgThroughputLOCPerTurn": 110,
+      "contextWindowK": 128
+    },
+    {
+      "id": "gpt-4-1",
+      "displayName": "GPT-4.1",
+      "provider": "OpenAI",
+      "inputPricePerMillion": 2.0,
+      "outputPricePerMillion": 8.0,
+      "avgThroughputLOCPerTurn": 110,
+      "contextWindowK": 128
+    },
+    {
+      "id": "gemini-2-5-pro",
+      "displayName": "Gemini 2.5 Pro",
+      "provider": "Google",
+      "inputPricePerMillion": 1.25,
+      "outputPricePerMillion": 10.0,
+      "avgThroughputLOCPerTurn": 100,
+      "contextWindowK": 1000
+    }
+  ],
+  "languageTokenRatios": {
+    "typescript": 3.5,
+    "javascript": 3.5,
+    "python": 3.2,
+    "go": 3.0,
+    "rust": 3.3,
+    "java": 3.1,
+    "kotlin": 3.1,
+    "swift": 3.2,
+    "ruby": 3.0,
+    "php": 3.0,
+    "csharp": 3.1,
+    "dart": 3.1,
+    "default": 3.2
+  },
+  "constants": {
+    "toolDefinitionsOverheadTokens": 4000,
+    "charsPerToken": 3.5,
+    "avgLOCChars": 45
+  }
+}

package/dist/config/framework-registry/csharp-aspnet.json

@@ -0,0 +1,67 @@
+{
+  "framework": "aspnet",
+  "displayName": "ASP.NET Core",
+  "frameworkVersion": "8.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "csharp",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Minimal APIs para endpoints simples en .NET 8",
+      "example": "app.MapGet('/users', async (AppDbContext db) => await db.Users.ToListAsync());",
+      "since": "6.0"
+    },
+    {
+      "pattern": "Dependency Injection via constructor en controllers",
+      "example": "public class UserController : ControllerBase { public UserController(IUserService svc) { _svc = svc; } }",
+      "since": "1.0"
+    },
+    {
+      "pattern": "IActionResult o ActionResult<T> para respuestas tipadas",
+      "example": "public async Task<ActionResult<User>> GetUser(int id) { var user = await _db.Users.FindAsync(id); return user is null ? NotFound() : Ok(user); }",
+      "since": "2.1"
+    },
+    {
+      "pattern": "appsettings.json con IConfiguration para configuracion",
+      "example": "var conn = builder.Configuration.GetConnectionString('Default');",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Middleware pipeline con app.Use() y app.Map()",
+      "example": "app.UseAuthentication(); app.UseAuthorization(); app.MapControllers();",
+      "since": "1.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "System.Web namespace de ASP.NET Framework clasico",
+      "replacedBy": "Microsoft.AspNetCore namespace en ASP.NET Core",
+      "severity": "error"
+    },
+    {
+      "pattern": "Global.asax para startup en ASP.NET MVC clasico",
+      "replacedBy": "Program.cs con WebApplication.CreateBuilder() en ASP.NET Core",
+      "severity": "error"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Registrar servicios como Singleton cuando deben ser Scoped",
+      "example": "builder.Services.AddSingleton<DbContext>() — DbContext debe ser Scoped",
+      "replacedBy": "builder.Services.AddDbContext<AppDbContext>() — AddDbContext usa Scoped por defecto",
+      "severity": "error"
+    },
+    {
+      "pattern": "No usar async/await en controladores con operaciones de I/O",
+      "example": "public IActionResult GetData() { return Ok(_db.Users.ToList()); } — bloquea el thread",
+      "replacedBy": "public async Task<IActionResult> GetData() { return Ok(await _db.Users.ToListAsync()); }",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Poner logica de negocio en el controller",
+      "example": "Validaciones complejas, calculos de negocio directo en el action method",
+      "replacedBy": "Usar Service Layer o Command/Query handlers (CQRS)",
+      "severity": "warning"
+    }
+  ]
+}

package/dist/config/framework-registry/dart-flutter.json

@@ -0,0 +1,61 @@
+{
+  "framework": "flutter",
+  "displayName": "Flutter",
+  "frameworkVersion": "3.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "dart",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "StatefulWidget con setState() para estado local",
+      "example": "class CounterPage extends StatefulWidget { ... } class _CounterPageState extends State<CounterPage> { int _count = 0; void _inc() { setState(() { _count++; }); } }",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Navigator 2.0 con GoRouter para navegacion",
+      "example": "GoRouter(routes: [GoRoute(path: '/', builder: (ctx, state) => const HomePage())]);",
+      "since": "2.0"
+    },
+    {
+      "pattern": "BuildContext para acceder a Theme y MediaQuery",
+      "example": "Theme.of(context).colorScheme.primary; MediaQuery.of(context).size.width;",
+      "since": "1.0"
+    },
+    {
+      "pattern": "const widgets para performance — evitar rebuilds innecesarios",
+      "example": "const Text('Hello'); const SizedBox(height: 16);",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Riverpod o Bloc para estado global",
+      "example": "final counterProvider = StateNotifierProvider<CounterNotifier, int>((ref) => CounterNotifier());",
+      "since": "2.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "Navigator 1.0 para navegacion en apps complejas",
+      "replacedBy": "GoRouter o Router 2.0 para deep linking y web support",
+      "severity": "warning"
+    },
+    {
+      "pattern": "setState() para estado global compartido entre widgets",
+      "replacedBy": "Riverpod, Bloc, o Provider para estado global",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Llamar setState() en un widget desmontado",
+      "example": "await Future.delayed(duration); setState(() { ... }); — puede correr despues del dispose",
+      "replacedBy": "Verificar mounted antes: if (mounted) setState(() { ... });",
+      "severity": "error"
+    },
+    {
+      "pattern": "Crear objetos en build() sin memoizacion",
+      "example": "Widget build(ctx) { final style = TextStyle(fontSize: 16); ... } — se crea en cada rebuild",
+      "replacedBy": "Definir como constante de clase o usar const TextStyle(fontSize: 16)",
+      "severity": "warning"
+    }
+  ]
+}

package/dist/config/framework-registry/go-gin.json

@@ -0,0 +1,62 @@
+{
+  "framework": "gin",
+  "displayName": "Gin",
+  "frameworkVersion": "1.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "go",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "gin.New() con middleware explicito para produccion",
+      "example": "r := gin.New(); r.Use(gin.Logger()); r.Use(gin.Recovery());",
+      "since": "1.0"
+    },
+    {
+      "pattern": "ShouldBindJSON para parsear request body",
+      "example": "var req CreateUserRequest; if err := c.ShouldBindJSON(&req); err != nil { c.JSON(400, gin.H{\"error\": err.Error()}); return }",
+      "since": "1.0"
+    },
+    {
+      "pattern": "RouterGroup para agrupar rutas con prefijo",
+      "example": "api := r.Group('/api/v1'); api.GET('/users', handler);",
+      "since": "1.0"
+    },
+    {
+      "pattern": "c.JSON() para respuestas JSON",
+      "example": "c.JSON(http.StatusOK, gin.H{\"data\": users})",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Middleware personalizado como HandlerFunc",
+      "example": "func AuthMiddleware() gin.HandlerFunc { return func(c *gin.Context) { ...; c.Next() } }",
+      "since": "1.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "gin.Default() en produccion (incluye Logger y Recovery por defecto)",
+      "replacedBy": "gin.New() con middleware explicito para control total",
+      "severity": "info"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "No llamar c.Next() en middleware — la chain se interrumpe",
+      "example": "func(c *gin.Context) { authenticate(c); } — sin c.Next() el handler no se ejecuta",
+      "replacedBy": "func(c *gin.Context) { if !authenticate(c) { return }; c.Next() }",
+      "severity": "error"
+    },
+    {
+      "pattern": "Pasar c *gin.Context a goroutines — unsafe",
+      "example": "go func() { processData(c) }() — c no es seguro para uso concurrente",
+      "replacedBy": "Copiar los datos necesarios antes de lanzar la goroutine",
+      "severity": "error"
+    },
+    {
+      "pattern": "Olvidar return despues de c.JSON() en error paths",
+      "example": "c.JSON(400, gin.H{\"error\": \"bad req\"}); // falta return; handler continua",
+      "replacedBy": "c.JSON(400, gin.H{\"error\": \"bad req\"}); return",
+      "severity": "error"
+    }
+  ]
+}

package/dist/config/framework-registry/index.json

@@ -0,0 +1,164 @@
+{
+  "frameworks": [
+    {
+      "id": "nextjs",
+      "displayName": "Next.js",
+      "ecosystem": "typescript",
+      "frameworkVersion": "14.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-nextjs.json"
+    },
+    {
+      "id": "react",
+      "displayName": "React",
+      "ecosystem": "typescript",
+      "frameworkVersion": "18.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-react.json"
+    },
+    {
+      "id": "vue",
+      "displayName": "Vue",
+      "ecosystem": "typescript",
+      "frameworkVersion": "3.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-vue.json"
+    },
+    {
+      "id": "nuxt",
+      "displayName": "Nuxt",
+      "ecosystem": "typescript",
+      "frameworkVersion": "3.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-nuxt.json"
+    },
+    {
+      "id": "angular",
+      "displayName": "Angular",
+      "ecosystem": "typescript",
+      "frameworkVersion": "17.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-angular.json"
+    },
+    {
+      "id": "sveltekit",
+      "displayName": "SvelteKit",
+      "ecosystem": "typescript",
+      "frameworkVersion": "2.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-sveltekit.json"
+    },
+    {
+      "id": "astro",
+      "displayName": "Astro",
+      "ecosystem": "typescript",
+      "frameworkVersion": "4.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-astro.json"
+    },
+    {
+      "id": "remix",
+      "displayName": "Remix",
+      "ecosystem": "typescript",
+      "frameworkVersion": "2.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-remix.json"
+    },
+    {
+      "id": "express",
+      "displayName": "Express",
+      "ecosystem": "typescript",
+      "frameworkVersion": "4.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-express.json"
+    },
+    {
+      "id": "nestjs",
+      "displayName": "NestJS",
+      "ecosystem": "typescript",
+      "frameworkVersion": "10.x",
+      "lastUpdated": "2026-03-04",
+      "file": "typescript-nestjs.json"
+    },
+    {
+      "id": "django",
+      "displayName": "Django",
+      "ecosystem": "python",
+      "frameworkVersion": "5.x",
+      "lastUpdated": "2026-03-04",
+      "file": "python-django.json"
+    },
+    {
+      "id": "fastapi",
+      "displayName": "FastAPI",
+      "ecosystem": "python",
+      "frameworkVersion": "0.100+",
+      "lastUpdated": "2026-03-04",
+      "file": "python-fastapi.json"
+    },
+    {
+      "id": "springboot",
+      "displayName": "Spring Boot",
+      "ecosystem": "java",
+      "frameworkVersion": "3.x",
+      "lastUpdated": "2026-03-04",
+      "file": "java-springboot.json"
+    },
+    {
+      "id": "rails",
+      "displayName": "Rails",
+      "ecosystem": "ruby",
+      "frameworkVersion": "7.x",
+      "lastUpdated": "2026-03-04",
+      "file": "ruby-rails.json"
+    },
+    {
+      "id": "laravel",
+      "displayName": "Laravel",
+      "ecosystem": "php",
+      "frameworkVersion": "11.x",
+      "lastUpdated": "2026-03-04",
+      "file": "php-laravel.json"
+    },
+    {
+      "id": "gin",
+      "displayName": "Gin",
+      "ecosystem": "go",
+      "frameworkVersion": "1.x",
+      "lastUpdated": "2026-03-04",
+      "file": "go-gin.json"
+    },
+    {
+      "id": "actix",
+      "displayName": "Actix-web",
+      "ecosystem": "rust",
+      "frameworkVersion": "4.x",
+      "lastUpdated": "2026-03-04",
+      "file": "rust-actix.json"
+    },
+    {
+      "id": "aspnet",
+      "displayName": "ASP.NET Core",
+      "ecosystem": "csharp",
+      "frameworkVersion": "8.x",
+      "lastUpdated": "2026-03-04",
+      "file": "csharp-aspnet.json"
+    },
+    {
+      "id": "flutter",
+      "displayName": "Flutter",
+      "ecosystem": "dart",
+      "frameworkVersion": "3.x",
+      "lastUpdated": "2026-03-04",
+      "file": "dart-flutter.json"
+    },
+    {
+      "id": "swiftui",
+      "displayName": "SwiftUI",
+      "ecosystem": "swift",
+      "frameworkVersion": "5.x",
+      "lastUpdated": "2026-03-04",
+      "file": "swift-swiftui.json"
+    }
+  ]
+}

package/dist/config/framework-registry/java-springboot.json

@@ -0,0 +1,67 @@
+{
+  "framework": "springboot",
+  "displayName": "Spring Boot",
+  "frameworkVersion": "3.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "java",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "@SpringBootApplication para clase principal",
+      "example": "@SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }",
+      "since": "1.2"
+    },
+    {
+      "pattern": "@RestController con @RequestMapping para REST endpoints",
+      "example": "@RestController @RequestMapping('/api/users') public class UserController { @GetMapping public List<User> list() { ... } }",
+      "since": "4.0"
+    },
+    {
+      "pattern": "application.properties / application.yml con perfiles",
+      "example": "spring.datasource.url=${DATABASE_URL} — usar variables de entorno en produccion",
+      "since": "1.0"
+    },
+    {
+      "pattern": "@Transactional para operaciones de base de datos",
+      "example": "@Transactional public void createUser(UserDto dto) { userRepository.save(new User(dto)); }",
+      "since": "1.0"
+    },
+    {
+      "pattern": "Spring Data JPA con JpaRepository",
+      "example": "public interface UserRepository extends JpaRepository<User, Long> { Optional<User> findByEmail(String email); }",
+      "since": "1.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "XML bean configuration en lugar de anotaciones",
+      "replacedBy": "@Bean en @Configuration classes o component scanning",
+      "severity": "warning"
+    },
+    {
+      "pattern": "spring.datasource.url formato antiguo Spring Boot 2 con driver legacy",
+      "replacedBy": "Usar drivers JDBC modernos y URL de formato estandar JDBC 4.x",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "Exponer entidades JPA directamente como Response body",
+      "example": "@GetMapping public User getUser() { return userRepository.findById(1); } — expone lazily-loaded relations",
+      "replacedBy": "Usar DTOs con MapStruct o ModelMapper para mapear la respuesta",
+      "severity": "error"
+    },
+    {
+      "pattern": "No usar @Transactional en operaciones de escritura",
+      "example": "public void updateUser(User user) { userRepo.save(user); } — sin @Transactional no hay rollback",
+      "replacedBy": "@Transactional public void updateUser(User user) { ... }",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Inyectar dependencias por campo en lugar de constructor",
+      "example": "@Autowired private UserService userService; — dificil de testear",
+      "replacedBy": "Constructor injection: private final UserService userService; @Autowired public Controller(UserService s) { this.userService = s; }",
+      "severity": "warning"
+    }
+  ]
+}

package/dist/config/framework-registry/php-laravel.json

@@ -0,0 +1,67 @@
+{
+  "framework": "laravel",
+  "displayName": "Laravel",
+  "frameworkVersion": "11.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "php",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Eloquent ORM para acceso a base de datos",
+      "example": "$users = User::where('active', true)->with('posts')->get();",
+      "since": "4.0"
+    },
+    {
+      "pattern": "Route model binding para inyeccion automatica de modelos",
+      "example": "Route::get('/users/{user}', function (User $user) { return $user; });",
+      "since": "5.0"
+    },
+    {
+      "pattern": "Form Requests para validacion de inputs",
+      "example": "class StoreUserRequest extends FormRequest { public function rules(): array { return ['name' => 'required|string']; } }",
+      "since": "5.0"
+    },
+    {
+      "pattern": "Artisan commands para CLI tasks",
+      "example": "php artisan make:command SendEmails && php artisan send:emails",
+      "since": "4.0"
+    },
+    {
+      "pattern": "Folio para page-based routing en Laravel 11",
+      "example": "pages/users/[User].php — ruta automatica /users/{user} con Folio",
+      "since": "11.0"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "Route::resource con el formato antiguo de Laravel 5",
+      "replacedBy": "Route::apiResource para APIs o Route::resource actualizado",
+      "severity": "info"
+    },
+    {
+      "pattern": "$request->input() para validacion sin Form Request",
+      "replacedBy": "Form Request classes con rules()",
+      "severity": "warning"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "N+1 queries con Eloquent sin eager loading",
+      "example": "User::all()->each(fn($u) => $u->posts->count()) — N+1",
+      "replacedBy": "User::withCount('posts')->get()",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Poner logica en rutas en lugar de controllers",
+      "example": "Route::get('/users', function() { return User::all(); }) — no escala",
+      "replacedBy": "Route::get('/users', [UserController::class, 'index'])",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Usar DB::statement() para queries sin bindings parametrizados",
+      "example": "DB::statement('SELECT * FROM users WHERE id = ' . $id) — SQL injection",
+      "replacedBy": "DB::select('SELECT * FROM users WHERE id = ?', [$id])",
+      "severity": "error"
+    }
+  ]
+}

package/dist/config/framework-registry/python-django.json

@@ -0,0 +1,72 @@
+{
+  "framework": "django",
+  "displayName": "Django",
+  "frameworkVersion": "5.x",
+  "lastUpdated": "2026-03-04",
+  "ecosystem": "python",
+  "customEntry": false,
+  "correctPatterns": [
+    {
+      "pattern": "Class-based views con ListView, DetailView, CreateView",
+      "example": "class PostListView(ListView): model = Post; template_name = 'posts/list.html'",
+      "since": "3.0"
+    },
+    {
+      "pattern": "ORM queryset con select_related y prefetch_related para N+1",
+      "example": "Post.objects.select_related('author').prefetch_related('tags').all()",
+      "since": "1.0"
+    },
+    {
+      "pattern": "settings.py con SECRET_KEY en variable de entorno",
+      "example": "SECRET_KEY = os.environ.get('DJANGO_SECRET_KEY', 'fallback-for-dev-only')",
+      "since": "1.0"
+    },
+    {
+      "pattern": "DATABASES con dj-database-url para produccion",
+      "example": "DATABASES = {'default': dj_database_url.config(default=os.environ.get('DATABASE_URL'))}",
+      "since": "3.0"
+    },
+    {
+      "pattern": "Migraciones con makemigrations y migrate",
+      "example": "python manage.py makemigrations && python manage.py migrate",
+      "since": "1.7"
+    }
+  ],
+  "deprecatedPatterns": [
+    {
+      "pattern": "from django.utils.encoding import force_text",
+      "replacedBy": "from django.utils.encoding import force_str",
+      "severity": "error"
+    },
+    {
+      "pattern": "url() en URLconf de Django < 4",
+      "replacedBy": "path() y re_path() en urls.py",
+      "severity": "error"
+    },
+    {
+      "pattern": "ugettext() y ugettext_lazy()",
+      "replacedBy": "gettext() y gettext_lazy()",
+      "severity": "error"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "pattern": "DEBUG=True en produccion",
+      "example": "DEBUG = True en settings.py de produccion — expone stack traces y datos sensibles",
+      "replacedBy": "DEBUG = os.environ.get('DEBUG', 'False') == 'True'",
+      "severity": "error"
+    },
+    {
+      "pattern": "Queryset evaluation en bucles (N+1 problem)",
+      "example": "for post in Post.objects.all(): print(post.author.name) — N+1 queries",
+      "replacedBy": "Post.objects.select_related('author').all()",
+      "severity": "warning"
+    },
+    {
+      "pattern": "Usar models sin null=True ni blank=True para CharField opcional",
+      "example": "description = models.CharField(max_length=200) — si puede estar vacio necesita blank=True",
+      "replacedBy": "description = models.CharField(max_length=200, blank=True, default='')",
+      "severity": "warning"
+    }
+  ]
+}