# Changelog

Cambios notables de **frida-pi-studio**. Formato [Keep a Changelog](https://keepachangelog.com/es/1.1.0/);
versionado [SemVer](https://semver.org/lang/es/); cada versión = tag git
annotated + [GitHub Release](https://github.com/efuentesp/frida-pi-studio/releases)
(los releases enlazan los issues cerrados; los commits los referencian con `Refs #N`).

Secciones de versiones publicadas: **inmutables**. Lo nuevo entra por
`[Unreleased]` (regenerable con el skill `changelog` del operador).

## [0.6.6] — 2026-09-09

### Fixed

- Hotfix: pi se cerraba solo al arrancar con 0.6.5 — el splash de bienvenida usaba un color de theme inexistente y la excepción tumbaba la sesión antes de mostrar nada. El splash ahora renderiza de forma defensiva (un adorno jamás puede cerrar pi) y el release ganó verificación interactiva con PTY para cambios de interfaz.
- El README estrenaba el arte nuevo de marca en la fuente correcta (bloques sólidos ANSI Regular, a la par del kit) y la sección de desinstalación gana troubleshooting para el `ETARGET` de npx cuando el registry (mirror corporativo o edge CDN) sincroniza el `latest` antes que el metadata de la versión — con workarounds de registry directo, pin de versión y limpieza de cache.

## [0.6.5] — 2026-09-08

### Added

- El setup instala el monorepo privado pi-extensions (devengine, enterprise, relay, command-guard) cuando detecta acceso al repo (credenciales gh) — el equipo lo recibe automáticamente junto al stack; los externos lo saltan. El paquete npm público nunca lo incluye.
- Splash de arranque FRIDA: overlay centrado con el arte en gradiente (FRIDA-STUDIO completo, o FRIDA en terminales chicas), versión, modelo y hints reales; se cierra solo a los 30s o con cualquier tecla. Quien no lo quiera: `frida.welcome: false` en settings.

### Changed

- El arte de marca cambia de fuente figlet ANSI Shadow (contornos + sombras) a ANSI Regular: bloques sólidos al estilo del logo de pi — mis 5 filas y más angosto (FRIDA-STUDIO 87 columnas vs 97), así el banner completo cabe en más terminales. Header, welcome y verificación de release usan la nueva fuente.
- El header FRIDA-STUDIO estrena gradiente de colores (magenta→cian, el mismo estilo del welcome overlay de powerline) sobre el arte — los glifos figlet siguen intactos y verificados. Los hints del banner pierden el `? ayuda` (ese atajo no existe en pi; lo que escribía iba al modelo).
- El footer pasa de extensión propia a `pi-powerline-footer`: status bar powerline completa (modelo, thinking, git con conteos, contexto con colores, tokens, costo) con el segmento FRIDA-STUDIO + versión al inicio de la barra — branding publica el status y el setup lo promueve a segmento (customItems + layout). El welcome overlay queda desactivado por defecto: la marca de arranque vive en el header FRIDA.

### Removed

- La familia monopi completa (background tasks, web remote, timing por prompt, analytics, safe-mode, git guard) sale del kit, del stack del setup y del manifest — llevaban ciclos dada de baja del prefix; su widget de timing ocupaba 2 líneas de footer en pantallas chicas. Si se necesitan, se instalan manual.

### Fixed

- El banner quedaba clavado en v0.6.2 aunque instalara 0.6.3 o 0.6.4: el número mostrado vive en branding.ts (no en package.json) y no se re-sincronizó tras el bump de versión. Sincronizado; y para que no se repita, el runbook verifica el drift con `sync-kit.mjs --check` (aborta el release si difieren) — viaja visible en la próxima versión.

## [0.6.4] — 2026-09-08

### Changed

- El paquete npm del kit lleva ahora solo sus recursos propios: el stack (22 paquetes) y los acompañantes rpiv (8) los instala el bootstrap como paquetes individuales. Causa raíz del #37: el hoisting de npm dejaba colgando las rutas node_modules/ del manifest bundleado — y sin deps ni overrides en el paquete, el conflicto de peers desaparece con ellas.
- Fuera el plugin de Telegram del stack (decisión del dueño); las instalaciones existentes pueden removerlo con `pi remove npm:@llblab/pi-telegram`.
- Arranque limpio por defecto: el kit setea `quietStartup: true` solo si el usuario no tiene la clave (nunca pisa su elección; la identidad vive en el footer y `/frida`).

## [0.6.3] — 2026-09-08

### Fixed

- `--remove` estaba cableado a la forma git y fallaba con el kit instalado vía npm: ahora detecta la forma real (npm/git con o sin pin) leyendo settings, remueve exactamente eso y es tolerante cuando no hay nada instalado.
- El theme frida cargaba con error y quedaba excluido: completados los 21 slots de color que exige el schema actual de pi (sintaxis, niveles de thinking, markdown).
- (La materialización de deps in-place de esta versión resultó insuficiente — el hoisting de npm la deshacía; la solución definitiva viaja en la siguiente como cambio de modelo.)

## [0.6.2] — 2026-09-08

### Fixed

- Conflicto de tools con la familia rpiv: los 8 paquetes salen del bundle y el bootstrap los instala como paquetes separados — rpiv-pi los detecta (sus agents quedan habilitados, sin warning de /rpiv-setup) y desaparece el riesgo de conflictos para quien lo hubiera corrido.
- El bootstrap ahora instala por defecto desde npm (público); la vía git queda como `--source` para el equipo.

## [0.6.1] — 2026-09-07

### Changed

- Empaquetado para npm público: allowlist `files` (sin gobernanza interna en el tarball), sin `private`, y `overrides` que resuelven los peers mal declarados upstream — el artefacto instala sin `legacy-peer-deps` y sin GitHub (verificado en contenedor). El publish queda en manos del dueño.

## [0.6.0] — 2026-09-07

### Added

- Web remote por Tailscale: `/remote` comparte la sesión live (URL + QR) solo dentro del tailnet del equipo — pairing sin exposición a internet (decisión de seguridad del dueño).
- Banner personalizable: `banner.txt` del usuario reemplaza el arte del header conservando subtítulo y hints; el arte default del kit sigue verificado con figlet.

## [0.5.0] — 2026-09-06

### Added

- CI en GitHub Actions: E2E de instalación por git (el camino exacto del equipo, con el token del runner) y verificación de compatibilidad contra pi pineado (0.84/0.85) en cada push/PR.
- Git guard en el kit: guard rails contra operaciones destructivas de git en las máquinas del equipo.
- Logo FRIDA-STUDIO: SVG como fuente y PNG como artefacto regenerado, embebido en el README.
- `--doctor` del setup: diagnostica prerequisitos, layout managed, kit instalado y theme activo, sin instalar nada.
- Telemetría del kit: timing por prompt y uso agregado en SQLite con dashboard local (adopción de extensiones monopi sobre pi stock).
- Perfiles del kit: `--profile lite` instala la variante marca + núcleo (vía Package Filtering de pi, reversible a `full`).
- Importadores de otros harness: `--scan-imports` detecta rules de Claude Code/Cursor/Cline/Copilot/Windsurf y `--import` las fusiona en `AGENTS.md` con procedencia e idempotencia.
- Learn → skill: skill learn-review que revisa lecciones recurrentes de la memoria y propone su promoción a skills del kit vía issue (con evidencia y borrador listo para revisar).
- URIs del equipo: herramienta read_uri — pr://N, issue://N y diff://N del repo actual se leen como archivos (una interfaz para el modelo en vez de flags de gh).

## [0.4.0] — 2026-09-06

### Added

- Theme `arctic-aurora` como default del kit — paleta aurora boreal (cian hielo, fondos azul-glaciar), del kit MIT awesome-pi-themes de isashi. La paleta cálida `frida` queda seleccionable; el header se colorea con el accent del theme activo.
- Comando `/frida` — identidad del kit en un panel: versión, theme activo, modelo y cómo actualizar.
- Banner responsivo — arte completo en terminales anchas; en estrechas, banner compacto que avisa cuántas columnas faltan (el arte jamás se trunca ni se degrada en silencio).
- Footer FRIDA — status bar propia con marca + modelo + % de contexto + rama git, refresco cada 30 segundos.
- Meta-installer — el setup resuelve la última versión y el transporte correcto (HTTPS con credenciales gh, o llave SSH), soporta `--version` (pin), `--theme`, `--local`, `--remove` y `--completions` (bash/zsh/fish), y verifica la instalación con `pi list` (smoke post-instalación).

### Changed

- `pi-powerline-footer` sale del bundle (27 extensiones): el footer FRIDA propio toma el slot para no pelear por él — quien lo prefiera lo instala aparte.

## [0.3.0] — 2026-09-06

### Added

- Regla de máxima prioridad: nada se instala en el equipo base (MacBook) del dueño — toda prueba o instalación del kit corre en contenedor o ambiente separado desechable.
- Tareas en background (`/bg`) y safe-mode ante el crash de una extensión (adopción de extensiones monopi sobre pi stock, validada en contenedor).
- Plantillas de rol como punto de partida por perfil: `/rol-dev`, `/rol-fullstack`, `/rol-datos-ia` y `/rol-seguridad`.
- Catálogo de features del kit por capacidad, con tiers (docs/feature-catalog.md).
- Roadmap con ideas futuras priorizadas por valor; lo que se decide construir se promueve a issue.
- Plantilla de issue para proponer nueva funcionalidad (junto a las de ajuste de extensiones y bugs).

### Fixed

- Fuente única de versión realineada: la raíz quedó en 0.1.0 al taggear v0.2.0; de vuelta alineada con `KIT_VERSION` sincronizado.
- Verificación de arte del runbook: falso positivo por líneas vacías del extractor — ahora filtra ambos lados.

### Changed

- Todo cambio del repo (nueva funcionalidad, ajuste, eliminación, defecto) nace en un issue y aterriza en el CHANGELOG antes de su versión.
- Regla de vehículos de implementación y sync con prefix sintético en contenedor: adoptar extensiones de terceros sobre pi stock sin instalar nada en el host.
- Estrategia de distribución decidida tras investigar oh-my-pi y monopi: meta-installer npx sobre pi stock (fork y binarios descartados).

## [0.2.0] — 2026-09-05

### Added

- CHANGELOG y política de versionado con fuente única (el `package.json` raíz; `sync-kit.mjs` sincroniza `KIT_VERSION`).
- Plantillas de issues para el equipo: alta/baja de extensiones del kit y bugs de branding/theme/setup.
- GitHub Releases como canal público de cada versión.

### Changed

- Pruebas de instalación/E2E del kit pasan a contenedores Docker desechables (no contaminan el host del operador).
- El kit NO se despliega a los hosts propios del dueño: sus servidores espejan el prefix del Mac; el kit es solo para equipos externos y su instalación es manual.

### Fixed

- Comando de instalación por git: la forma sin `git@` (`git:github.com:usuario/repo`) generaba una URL inválida ("port number…") — el comando correcto es `git:git@github.com:efuentesp/frida-pi-studio@vX.Y.Z` (#1).
- Instalación por git del paquete: la raíz del repo ES el paquete pi (manifest + dependencias + `.npmrc` en la raíz) — antes vivían en `packages/studio/` y el clon no cargaba nada.

## [0.1.0] — 2026-09-05

### Added

- Kit `frida-pi-studio`: las 25 extensiones del stack en un solo paquete pi (skills y prompts incluidos).
- Header de marca `FRIDA-STUDIO` con comandos `/header-frida` y `/header-pi` para alternar con el nativo de pi.
- Theme `frida` (paleta cálida: naranja/rosa/teal sobre fondos oscuros).
- CLI `frida-pi-studio-setup`: bootstrap de una línea (`--check` para dry-run; activa el theme sin tocar el resto de settings).
- Runbook de release (`docs/release.md`) y documentación jerárquica DOX por paquete.