openprompt-lang 0.3.0

package/docs/referencia-metodologia/docs/PROMPTS/PLANTILLAS/14-tauri-wrapper-typescript.md

@@ -0,0 +1,92 @@
+---
+title: Wrapper TypeScript para comandos Tauri
+tags: [tauri, typescript, wrapper, frontend]
+usado_en: []
+fecha_creacion: 2026-05-14
+ultima_modificacion: 2026-05-14
+---
+
+## Cuándo usar
+
+Cuando necesites crear el wrapper TypeScript que llama a un comando Tauri desde el frontend, con tipado estricto y manejo de errores.
+
+## Prompt
+
+```markdown
+## Contexto
+Stack: Tauri v2 + React + TypeScript.
+Convenciones: wrappers en src/services/tauri/, un archivo por comando, máximo 80 líneas.
+Comando Rust ya creado en src-tauri/src/commands/{module}.rs con #[tauri::command].
+
+## Objetivo
+Crear el wrapper TypeScript `{serviceName}` para el comando Tauri `{command_name}` con tipado estricto de entrada/salida, errores tipados y documentación inline.
+
+## Especificaciones técnicas
+- Archivo: `src/services/tauri/{module}.ts`
+- Usar `import { invoke } from '@tauri-apps/api/core'` (Tauri v2)
+- Exportar una función por comando
+- Cada función tipa inputs y output con interfaces
+- Capturar errores del comando y convertirlos a un tipo manejable
+- Máximo 60 líneas por archivo
+
+## Reglas estrictas
+- Input y output tipados con interfaces dedicadas (no `Record<string, unknown>`)
+- Errores del comando se capturan como `string` y se tipan con un discriminated union
+- Documentar cada error posible con JSDoc
+- Inferir tipos desde el comando Rust (los tipos deben coincidir 1:1)
+- Funciones async siempre, el IPC de Tauri es asíncrono
+
+## Anti-patrones
+- NO usar `any` en tipos de entrada o salida
+- NO mezclar múltiples comandos en el mismo archivo
+- NO hacer lógica de UI en el wrapper
+- NO cachear resultados del comando en el wrapper (hacerlo en el hook)
+
+## Ejemplo correcto
+```typescript
+import { invoke } from '@tauri-apps/api/core'
+
+export interface ReadFileInput {
+  path: string
+}
+
+export interface ReadFileOutput {
+  content: string
+}
+
+export type ReadFileError =
+  | { type: 'not_found'; message: string }
+  | { type: 'access_denied'; message: string }
+  | { type: 'read_error'; message: string }
+
+/**
+ * Lee el contenido de un archivo del sistema.
+ * @param input.path - Ruta relativa al directorio de trabajo
+ * @returns El contenido del archivo
+ * @throws ReadFileError con tipo específico
+ */
+export async function readFileContent(input: ReadFileInput): Promise<ReadFileOutput> {
+  try {
+    const content = await invoke<string>('read_file_content', { path: input.path })
+    return { content }
+  } catch (err) {
+    const message = String(err)
+    if (message.includes('no encontrado')) throw { type: 'not_found', message } as ReadFileError
+    if (message.includes('denegado')) throw { type: 'access_denied', message } as ReadFileError
+    throw { type: 'read_error', message } as ReadFileError
+  }
+}
+```
+
+## Ejemplo incorrecto
+```typescript
+// ❌ Sin tipos, any, sin manejo de errores
+export async function readFile(path: string) {
+  const result = await invoke('read_file_content', { path })
+  return result
+}
+```
+
+## Formato de salida esperado
+Archivo completo `src/services/tauri/{module}.ts` listo para importar desde hooks.
+```

package/docs/referencia-metodologia/docs/PROMPTS/PLANTILLAS/15-documentar-tabla-db.md

@@ -0,0 +1,50 @@
+---
+title: Documentar tabla de base de datos
+tags: [docs, database, supabase, postgresql, documentacion]
+usado_en: []
+fecha_creacion: 2026-05-14
+ultima_modificacion: 2026-05-14
+---
+
+## Cuándo usar
+
+Cuando necesites documentar una tabla de la base de datos con todas sus columnas, tipos, relaciones, RLS policies e índices. Sigue el estándar de docs/CONVENCIONES_DOCUMENTACION.md.
+
+## Prompt
+
+```markdown
+## Contexto
+Stack: Supabase + PostgreSQL.
+Convenciones de documentación: docs/CONVENCIONES_DOCUMENTACION.md (tabla markdown estándar + RLS + índices).
+Base de datos: Supabase project {project_ref}.
+
+## Objetivo
+Generar la documentación completa de la tabla `{table_name}` siguiendo el formato estándar definido en CONVENCIONES_DOCUMENTACION.md.
+
+## Especificaciones técnicas
+La documentación debe incluir:
+1. Descripción de la tabla (propósito en el negocio)
+2. Tabla de columnas con:
+   - Nombre, tipo PostgreSQL exacto, nullable, default, FK referencias, descripción
+3. Índices existentes (nombre, columnas, tipo, condición si partial)
+4. RLS policies por operación (SELECT, INSERT, UPDATE, DELETE)
+5. Relaciones con otras tablas (FKs y referencias inversas)
+6. Notas adicionales (triggers, constraints especiales, convenciones)
+
+Basarse en el schema real de la tabla: {DESCRIBE table_name o mostrar CREATE TABLE}
+
+## Reglas estrictas
+- Tipos PostgreSQL exactos (TIMESTAMPTZ, no "fecha"; NUMERIC(10,2), no "número")
+- RLS documentada por cada operación con la policy exacta
+- FKs listadas con tabla de origen → tabla destino
+- Índices incluir tipo (B-tree, GIN, BRIN) y condición si partial
+- Si hay generated columns o triggers, documentarlos en notas
+
+## Anti-patrones
+- NO abreviar tipos (escribir `text` no "string" o "varchar")
+- NO omitir RLS (toda tabla con datos de usuario DEBE tener RLS)
+- NO documentar columnas que no existen en el schema real
+
+## Formato de salida esperado
+Documentación en markdown lista para agregar a `docs/DB/TABLES.md`. Usar el formato exacto de CONVENCIONES_DOCUMENTACION.md sección 1.
+```

package/docs/referencia-metodologia/docs/PROMPTS/PLANTILLAS/16-diagrama-arquitectura.md

@@ -0,0 +1,60 @@
+---
+title: Diagrama Mermaid de arquitectura y flujo de datos
+tags: [docs, diagrama, mermaid, arquitectura, documentacion]
+usado_en: []
+fecha_creacion: 2026-05-14
+ultima_modificacion: 2026-05-14
+---
+
+## Cuándo usar
+
+Cuando necesites generar diagramas de arquitectura visuales para documentar un feature, página o flujo completo. Usar Mermaid para que sea renderizable en GitHub y Markdown.
+
+## Prompt
+
+```markdown
+## Contexto
+Stack: React 18 + TypeScript + Vite + Supabase + Tailwind.
+Convenciones de documentación: docs/CONVENCIONES_DOCUMENTACION.md (diagramas Mermaid tree y sequence).
+Framework: openPrompt-Lang con anotaciones @kind, @compose, @deps, @state.
+
+## Objetivo
+Generar diagramas Mermaid para documentar la arquitectura del feature `{feature_name}`.
+
+Se requieren 2 diagramas:
+
+### 1. Árbol de componentes (graph TD)
+Mostrar la jerarquía de componentes desde la página hasta los componentes UI primitivos.
+Formato: `graph TD` con flechas `-->`.
+Cada nodo debe tener el nombre del archivo/componente.
+
+### 2. Flujo de datos (sequenceDiagram)
+Mostrar la interacción entre:
+- Usuario (actor)
+- Componente página
+- Hooks personalizados
+- Servicios
+- Supabase / API externa
+- Base de datos PostgreSQL
+
+Formato: `sequenceDiagram` con participantes y flechas `->>`, `-->>`.
+
+Basarse en la siguiente estructura del feature:
+{describir componentes, hooks, servicios y flujo}
+Anotaciones disponibles: {listar @kind y @compose del feature}
+
+## Reglas estrictas
+- Usar sintaxis Mermaid válida (verificar que graph TD y sequenceDiagram sean correctos)
+- En graph TD: nombres cortos, sin espacios, usar --> para relaciones
+- En sequenceDiagram: actores con `actor U as Usuario`, participantes con mayúscula
+- Incluir notas en el diagrama con `Note over X: texto` para eventos clave
+- Si el feature usa soft delete o RLS, agregar nota en el sequence
+
+## Anti-patrones
+- NO mezclar graph TD con sequenceDiagram en el mismo bloque
+- NO usar caracteres especiales en nombres de nodos (espacios, puntos, paréntesis)
+- NO agregar flechas de retorno implícitas (la DB no "vuelve" sola)
+
+## Formato de salida esperado
+Dos bloques de código markdown con ```mermaid, listos para copiar a la documentación del feature.
+```

package/docs/referencia-metodologia/docs/PROMPTS/PLANTILLAS/17-documentar-api-rpc.md

@@ -0,0 +1,56 @@
+---
+title: Documentar función RPC de Supabase
+tags: [docs, supabase, rpc, api, postgresql, documentacion]
+usado_en: []
+fecha_creacion: 2026-05-14
+ultima_modificacion: 2026-05-14
+---
+
+## Cuándo usar
+
+Cuando necesites documentar una función RPC (Remote Procedure Call) de Supabase con su contrato de entrada/salida, errores posibles y ejemplo de uso desde el frontend.
+
+## Prompt
+
+```markdown
+## Contexto
+Stack: Supabase + PostgreSQL + React + TypeScript.
+Convenciones de documentación: docs/CONVENCIONES_DOCUMENTACION.md sección 3 (contrato RPC).
+Base de datos: Supabase project {project_ref}.
+Función RPC: {rpc_function_name}.
+
+## Objetivo
+Generar la documentación completa de la función RPC `{rpc_function_name}` con contrato de entrada/salida, errores PostgreSQL posibles, seguridad y ejemplos de uso frontend.
+
+## Especificaciones técnicas
+La documentación debe incluir:
+1. Nombre y descripción de la función
+2. Contrato:
+   - Parámetros de entrada: nombre, tipo PostgreSQL, descripción
+   - Tipo de retorno (especificar si es scalar, JSONB, TABLE)
+   - Errores posibles: código PostgreSQL + causa + mensaje amigable
+3. Seguridad:
+   - SECURITY DEFINER o SECURITY INVOKER
+   - RLS aplicado (si accede a tablas)
+   - Restricciones de ejecución (quién puede llamarla)
+4. Ejemplo de llamado desde frontend TypeScript
+5. Ejemplo de llamado SQL directo (para pruebas en consola)
+
+Basarse en la definición real de la función:
+{SHOW CREATE FUNCTION o describir la función}
+
+## Reglas estrictas
+- Tipos PostgreSQL exactos (no abreviar)
+- Códigos de error PostgreSQL documentados con su significado
+- Ejemplo frontend con tipos inferidos (sin any)
+- Si usa SECURITY DEFINER, indicar con qué permisos ejecuta
+- Indicar explícitamente si la función es transaction-safe
+
+## Anti-patrones
+- NO documentar parámetros que no existen en la función real
+- NO omitir la sección de seguridad (especialmente con SECURITY DEFINER)
+- NO asumir que el frontend puede llamar cualquier RPC (verificar RLS)
+
+## Formato de salida esperado
+Documentación en markdown lista para agregar a `docs/DB/RPCS.md`. Incluir el contrato, errores, seguridad y ejemplos de uso.
+```

package/docs/referencia-metodologia/docs/PROMPTS/STACK/ionic-capacitor.md

@@ -0,0 +1,52 @@
+---
+title: Contexto para proyecto mobile con Ionic + Capacitor
+tags: [stack, ionic, capacitor, mobile, react]
+usado_en: []
+fecha_creacion: 2026-05-13
+ultima_modificacion: 2026-05-13
+---
+
+## Cuándo usar
+
+Cuando el proyecto requiera **empaquetado mobile** (Android/iOS) con Ionic Framework + Capacitor. Incluye tanto desarrollo mobile como web (responsive).
+
+## Prompt
+
+```markdown
+## Stack del proyecto
+- React 18 + TypeScript + Vite
+- Ionic Framework 8 (componentes mobile-first: IonPage, IonContent, IonButton, etc.)
+- Capacitor 6 (acceso nativo: cámara, GPS, notificaciones, almacenamiento)
+- Tailwind CSS 3.4 (utility-first, 0 CSS personalizado)
+- Supabase (backend, autenticación)
+- Zustand (estado global)
+- React Router v6 (ruteo)
+
+## Arquitectura
+- Mobile-first: diseñar primero para pantallas pequeñas, escalar a desktop
+- Ionic UI para componentes mobile (listas, tabs, modales, inputs)
+- Tailwind para estilos personalizados y espaciado
+- Plugins nativos de Capacitor encapsulados en hooks useCapacitor*
+
+## Convenciones (de docs/Framework de Desarrollo Asistido por IA.md)
+- Vistas mobile con componentes Ionic (`<IonPage>`, `<IonContent>`)
+- Hooks de Capacitor en src/hooks/ con prefijo useCapacitor*
+- NO mezclar lógica de Capacitor con Tauri
+- Un componente por archivo, máximo 120 líneas
+- Un hook por archivo, máximo 80 líneas
+- 100% Tailwind utility classes (para lo que no cubre Ionic)
+- Barrel exports en cada carpeta
+
+## NO aplica (este proyecto no usa)
+- Tauri (desktop nativo)
+- Componentes desktop-sidebar (usar tabs o menú hamburguesa)
+```
+
+## Plugins Capacitor comunes
+| Funcionalidad | Plugin | Hook recomendado |
+|---|---|---|
+| Cámara | @capacitor/camera | useCapacitorCamera |
+| GPS | @capacitor/geolocation | useCapacitorLocation |
+| Notificaciones | @capacitor/local-notifications | useCapacitorNotifications |
+| Almacenamiento | @capacitor/storage | useCapacitorStorage |
+| Archivos | @capacitor/filesystem | useCapacitorFileSystem |

package/docs/referencia-metodologia/docs/PROMPTS/STACK/react-web-puro.md

@@ -0,0 +1,46 @@
+---
+title: Contexto para proyecto web React + Supabase
+tags: [stack, web, supabase, react, tailwind]
+usado_en: []
+fecha_creacion: 2026-05-13
+ultima_modificacion: 2026-05-13
+---
+
+## Cuándo usar
+
+Cuando inicies un proyecto **web puro** (sin Ionic, Capacitor ni Tauri). Este prompt establece el contexto completo para que la IA entienda el stack y las convenciones sin necesidad de aclararlo cada vez.
+
+## Prompt
+
+```markdown
+## Stack del proyecto
+- React 18 + TypeScript + Vite
+- Tailwind CSS 3.4 (utility-first, 0 CSS personalizado)
+- Supabase (base de datos, autenticación, storage)
+- react-hook-form + zod (formularios y validación)
+- Zustand (estado global)
+- React Router v6 (ruteo)
+- Vitest + Testing Library (tests)
+
+## Arquitectura
+- Fat-DB philosophy: lógica de negocio en la base de datos (RLS, funciones, triggers)
+- Frontend delgado: componentes solo consumen y presentan
+- Sin backend intermedio: el frontend se conecta directo a Supabase
+
+## Convenciones (de docs/Framework de Desarrollo Asistido por IA.md)
+- Un componente por archivo, máximo 120 líneas
+- Un hook por archivo, máximo 80 líneas
+- Servicios en src/services/supabase/
+- Features en src/features/{domain}/ (con components/, hooks/, services/, types/)
+- 100% Tailwind utility classes
+- Barrel exports (index.ts) en cada carpeta
+- Custom hooks para toda lógica reutilizable
+
+## NO aplica (este proyecto no usa)
+- Ionic / Capacitor
+- Tauri
+- Componentes nativos de dispositivo
+```
+
+## Cuándo NO usar
+Si el proyecto requiere acceso nativo (cámara, GPS, notificaciones push) o empaquetado desktop, usa el stack correspondiente (ionic-capacitor.md o tauri-desktop.md).

package/docs/referencia-metodologia/docs/PROMPTS/STACK/tauri-desktop.md

@@ -0,0 +1,53 @@
+---
+title: Contexto para proyecto desktop con Tauri
+tags: [stack, tauri, desktop, rust, react]
+usado_en: []
+fecha_creacion: 2026-05-13
+ultima_modificacion: 2026-05-13
+---
+
+## Cuándo usar
+
+Cuando el proyecto requiera **empaquetado desktop** (Windows/Mac/Linux) con Tauri v2. Ideal para apps de escritorio con acceso al sistema de archivos, procesos locales o rendimiento nativo.
+
+## Prompt
+
+```markdown
+## Stack del proyecto
+- React 18 + TypeScript + Vite
+- Tauri v2 (Rust + backend nativo)
+- Tailwind CSS 3.4 (utility-first, 0 CSS personalizado)
+- Supabase (backend opcional)
+- Zustand (estado global)
+- React Router v6 (ruteo)
+
+## Arquitectura
+- Frontend React (webview) para UI
+- Backend Rust para operaciones nativas (archivos, procesos, hardware)
+- Comunicación via IPC: frontend llama comandos Tauri con invoke()
+- Comandos Rust en src-tauri/src/commands/, un archivo por comando
+- Llamadas desde frontend en src/services/tauri/
+
+## Convenciones (de docs/Framework de Desarrollo Asistido por IA.md)
+- Comandos Tauri con tipado estricto en Rust (String, no &str para parámetros)
+- Wrapper tipado en frontend para cada comando
+- Validar inputs en Rust antes de ejecutar
+- NO mezclar lógica de Tauri con Capacitor
+- Un componente por archivo, máximo 120 líneas
+- Un hook por archivo, máximo 80 líneas
+- 100% Tailwind utility classes
+- Barrel exports en cada carpeta
+
+## NO aplica (este proyecto no usa)
+- Ionic / Capacitor (acceso nativo mobile)
+- Componentes mobile (no hay IonPage, IonContent, etc.)
+- Plugins de dispositivo (cámara, GPS)
+```
+
+## Comandos Tauri comunes
+| Funcionalidad | Comando Rust | Wrapper frontend |
+|---|---|---|
+| Leer archivo | read_file_content | readFileContent(path) |
+| Escribir archivo | write_file_content | writeFileContent(path, content) |
+| Diálogo abrir archivo | dialog.open | openFileDialog() |
+| Ejecutar comando | Command.execute | executeCommand(cmd) |

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "openprompt-lang",
+  "version": "0.3.0",
+  "description": "PromptLang CLI — Framework de anotaciones para desarrollo asistido por IA",
+  "type": "module",
+  "main": "./bin/cli.js",
+  "bin": {
+    "openPrompt-Lang": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "schemas/",
+    "docs/",
+    "vscode-extension/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node bin/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm test",
+    "postinstall": "node -e \"console.log('\\n📦 openPrompt-Lang instalado. Ejecuta: npx openPrompt-Lang init\\n')\""
+  },
+  "keywords": [
+    "prompt-lang",
+    "openprompt-lang",
+    "ai",
+    "development",
+    "framework",
+    "annotations",
+    "react",
+    "typescript"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "inquirer": "^9.3.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.6"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DeadJustLive/OpenPrompt-Lang.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DeadJustLive/OpenPrompt-Lang/issues"
+  },
+  "homepage": "https://github.com/DeadJustLive/OpenPrompt-Lang#readme"
+}

package/schemas/prompt-lang.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "openPrompt-Lang Config",
+  "description": "Configuración del proyecto para el framework openPrompt-Lang",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Nombre del proyecto"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Versión del proyecto (semver)"
+    },
+    "stack": {
+      "type": "object",
+      "properties": {
+        "base": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["react", "typescript", "vite", "tailwind", "vue", "angular"]
+          },
+          "description": "Stack base del proyecto"
+        },
+        "extensions": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["supabase", "ionic", "capacitor", "tauri", "firebase", "trpc", "next"]
+          },
+          "description": "Extensiones opcionales del stack"
+        }
+      },
+      "required": ["base"]
+    },
+    "profile": {
+      "type": "string",
+      "enum": ["junior", "mid", "senior"],
+      "description": "Perfil del desarrollador"
+    },
+    "pipeline": {
+      "type": "object",
+      "properties": {
+        "pre-commit": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["lint", "typecheck", "doctor", "test", "build"]
+          },
+          "description": "Pasos del pipeline pre-commit"
+        },
+        "scripts": {
+          "type": "object",
+          "properties": {
+            "lint": { "type": "string" },
+            "typecheck": { "type": "string" },
+            "doctor": { "type": "string" },
+            "test": { "type": "string" },
+            "build": { "type": "string" }
+          }
+        }
+      }
+    },
+    "annotations": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "strict": { "type": "boolean", "default": false }
+      }
+    },
+    "docs": {
+      "type": "object",
+      "properties": {
+        "commits": { "type": "boolean", "default": true },
+        "logs": { "type": "boolean", "default": true },
+        "backlog": { "type": "boolean", "default": true }
+      }
+    },
+    "extractor": {
+      "type": "object",
+      "properties": {
+        "ignore": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Patrones a ignorar en la extracción de contexto"
+        },
+        "output": {
+          "type": "string",
+          "default": "contexto.md",
+          "description": "Archivo de salida del extractor"
+        }
+      }
+    }
+  },
+  "required": ["name", "stack"]
+}