frida-pi-studio 0.6.1

package/CHANGELOG.md

@@ -0,0 +1,100 @@
+# 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).
+
+## [Unreleased]
+
+### 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.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Edgar F. Fuentes Perea
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# FRIDA-PI-STUDIO
+
+<p align="center"><img src="assets/logo.png" width="112" alt="FRIDA-STUDIO"></p>
+
+```
+███████╗██████╗ ██╗██████╗  █████╗       ███████╗████████╗██╗   ██╗██████╗ ██╗ ██████╗
+██╔════╝██╔══██╗██║██╔══██╗██╔══██╗      ██╔════╝╚══██╔══╝██║   ██║██╔══██╗██║██╔═══██╗
+█████╗  ██████╔╝██║██║  ██║███████║█████╗███████╗   ██║   ██║   ██║██║  ██║██║██║   ██║
+██╔══╝  ██╔══██╗██║██║  ██║██╔══██║╚════╝╚════██║   ██║   ██║   ██║██║  ██║██║██║   ██║
+██║     ██║  ██║██║██████╔╝██║  ██║      ███████║   ██║   ╚██████╔╝██████╔╝██║╚██████╔╝
+╚═╝     ╚═╝  ╚═╝╚═╝╚═════╝ ╚═╝  ╚═╝      ╚══════╝   ╚═╝    ╚═════╝ ╚═════╝ ╚═╝ ╚═════╝
+```
+
+Distribución de marca de **pi** para el equipo: un solo paquete instala todo
+el stack de extensiones, el theme `arctic-aurora` y el header FRIDA-STUDIO.
+
+## Requisitos
+
+- **Node.js ≥ 24** (`node --version`)
+- **pi** instalado — layout managed:
+
+  ```bash
+  curl -fsSL https://pi.dev/install.sh | PI_EXPERIMENTAL=1 sh
+  ```
+
+  ⚠️ `PI_EXPERIMENTAL=1` es obligatorio: sin él instala por npm y `pi update`
+  deja de funcionar.
+- Acceso a este repo (privado) — ver [Acceso del equipo](#acceso-del-equipo-repo-privado).
+
+## Acceso del equipo (repo privado)
+
+**Dueño del repo — invitar con acceso de solo lectura:**
+
+```bash
+gh api -X PUT repos/efuentesp/frida-pi-studio/collaborators/USUARIO -f permission=read
+```
+
+El invitado acepta por correo/notificación. Invitaciones pendientes:
+`gh api repos/efuentesp/frida-pi-studio/invitations`.
+
+**Miembro — una vez aceptada la invitación:**
+
+```bash
+gh auth login        # Protocol: HTTPS · "Authenticate Git with your GitHub credentials?" → Yes
+# si ya tenías sesión sin eso:
+gh auth setup-git
+# verifica acceso:
+gh repo view efuentesp/frida-pi-studio --json name -q .name   # → frida-pi-studio
+```
+
+Con rol **Read** el miembro puede clonar, instalar el kit, actualizar
+(`pi update --extensions`) y **abrir issues** (el canal para pedir
+ajustes) — pero no pushear.
+
+## Instalación
+
+Según cómo autentiques contra GitHub:
+
+**Con `gh auth login` (HTTPS)** — la forma con slash:
+
+```bash
+pi install git:github.com/efuentesp/frida-pi-studio@v0.4.0
+```
+
+**Con llave SSH** (`ssh -T git@github.com` te saluda) — la forma scp:
+
+```bash
+pi install git:git@github.com:efuentesp/frida-pi-studio@v0.4.0
+```
+
+⚠️ Nunca `git:github.com:efuentesp/…` (dos puntos sin `git@`): genera
+una URL inválida ("port number…"). Y no mezcles: la forma scp en una
+máquina sin llave SSH falla con "Permission denied (publickey)" (exit
+128 — mismo código que la URL rota, otra causa).
+
+**Sin acceso a este repo (vía npm público):**
+
+```bash
+pi install npm:frida-pi-studio      # o bootstrap: npx frida-pi-studio
+```
+
+*(disponible desde el primer `npm publish` — en preparación, issue #34;
+el repo privado sigue siendo la fuente y la vía del equipo)*
+
+(equipo: última versión en [releases](https://github.com/efuentesp/frida-pi-studio/releases))
+
+Alternativa con bootstrap (verifica prerequisitos, instala el kit y activa
+el theme `arctic-aurora`):
+
+```bash
+npx github:efuentesp/frida-pi-studio                # full (todo)
+npx github:efuentesp/frida-pi-studio --profile lite # marca + núcleo
+npx github:efuentesp/frida-pi-studio --import       # viene de Claude Code/Cursor? importa tus rules
+```
+
+## Qué incluye
+
+- **31 extensiones** del stack en un paquete: pi-lens, pi-telegram,
+  pi-extensible-workflows, rpiv (workflow, todo, advisor, i18n, web-tools…),
+  supi-context/web, pi-subagents, pi-worktree, pi-hermes-memory, `/bg`
+  (tareas en background), safe-mode (watchdog), git guard, telemetría (timing y uso en
+  SQLite) y más — con sus skills y
+  prompts. Inventario completo por capacidad:
+  [docs/feature-catalog.md](docs/feature-catalog.md).
+- **Identidad propia**: header FRIDA-STUDIO responsivo, footer FRIDA
+  (marca + modelo + contexto + branch) y `/frida` (versión, theme y
+  cómo actualizar) — extensiones del kit, no de terceros.
+- **Theme `arctic-aurora`** (default): paleta aurora boreal — cian hielo,
+  verdes suaves, fondos azul-glaciar. Del kit de themes MIT
+  [awesome-pi-themes](https://github.com/isashi/awesome-pi-themes).
+  El header FRIDA-STUDIO se colorea con su accent.
+- **3 themes seleccionables** — `frida` (cálida), `aurora-circuit` y
+  `violet-breakwater` — con [galería local de
+  previews](docs/theme-gallery.html) para elegir antes de activar
+  (`--theme <nombre>` o `/settings`).
+- **Header FRIDA-STUDIO**: banner de marca al iniciar. Alterna con el
+  nativo de pi: `/header-frida` ↔ `/header-pi`.
+- **Plantillas de rol**: `/rol-dev`, `/rol-fullstack`, `/rol-datos-ia`,
+  `/rol-seguridad` — punto de partida probado por perfil.
+
+## Después de instalar (one-time, por máquina)
+
+Estos pasos llevan credenciales y **nunca van en el repo**:
+
+1. Proveedor: `pi auth login` (o export de la API key del proveedor).
+2. Telegram (opcional): `/telegram-setup` en la sesión pi a conectar.
+3. devengine (opcional): `export FRIDA_DEV_ENGINE_API_KEY=…`.
+
+## Actualizar
+
+```bash
+pi update --extensions        # sin pin (recommended)
+# o fijar versión:
+pi install git:git@github.com:efuentesp/frida-pi-studio@vX.Y.Z
+```
+
+Cambios por versión: [CHANGELOG.md](CHANGELOG.md).
+
+## Pedir ajustes / reportar bugs
+
+[Abre un issue](https://github.com/efuentesp/frida-pi-studio/issues/new/choose) —
+hay plantillas para alta/baja de extensiones y para bugs. El operador del
+kit los trabaja y salen en el siguiente release.
+
+## Para el operador
+
+Documentación jerárquica (DOX): [AGENTS.md](AGENTS.md) →
+`packages/studio/AGENTS.md` · `packages/setup/AGENTS.md`. Runbook de
+release: [docs/release.md](docs/release.md).

package/assets/logo.svg

@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" width="96" height="96">
+  <!--
+    FRIDA-STUDIO — logo fuente (vector). El raster (logo.png) es un
+    ARTEFACTO regenerado de aquí (patrón omp: nunca se edita el PNG).
+    Paletas del kit: cálida frida (naranja/rosa) + arctic-aurora (cian
+    hielo sobre azul-glaciar), partidos por la diagonal — la "aurora"
+    que cruza el estudio.
+  -->
+  <title>FRIDA-STUDIO</title>
+  <defs>
+    <linearGradient id="warm" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#f97316" />
+      <stop offset="1" stop-color="#ec4899" />
+    </linearGradient>
+    <linearGradient id="aurora" x1="1" y1="1" x2="0" y2="0">
+      <stop offset="0" stop-color="#0891b2" />
+      <stop offset="1" stop-color="#67e8f9" />
+    </linearGradient>
+  </defs>
+  <!-- lienzo: azul-glaciar del theme default -->
+  <rect x="2" y="2" width="92" height="92" rx="20" fill="#0f2027" />
+  <!-- mitad cálida (frida) arriba-izquierda -->
+  <path d="M22 6 h52 a16 16 0 0 1 16 16 v0 L22 90 Z" fill="url(#aurora)" opacity="0" />
+  <path d="M6 74 V22 a16 16 0 0 1 16-16 h52 L6 74 Z" fill="url(#warm)" />
+  <!-- mitad aurora abajo-derecha -->
+  <path d="M90 22 v52 a16 16 0 0 1-16 16 H22 Z" fill="url(#aurora)" />
+  <!-- línea de aurora: trazo claro que parte la casa -->
+  <path d="M74 6 L6 74" stroke="#f8fdff" stroke-width="2.5" opacity="0.9" />
+  <!-- glifo F construido con rects (determinista, sin fuentes) -->
+  <g fill="#0f2027">
+    <rect x="40" y="26" width="9" height="44" rx="2" />
+    <rect x="40" y="26" width="26" height="9" rx="2" />
+    <rect x="40" y="43" width="19" height="7" rx="2" />
+  </g>
+</svg>

package/docs/feature-catalog.md

@@ -0,0 +1,148 @@
+# feature-catalog.md — Catálogo de features del kit
+
+Inventario canónico de lo que instala **frida-pi-studio**, por
+capacidad: qué comando, tool o atajo añade cada pieza. Complemento de
+largo alance del [README](../README.md); mantenerlo al día es parte
+del ciclo de cada issue que añada/cambie/quite funcionalidad.
+
+## Marca y experiencia (propios)
+
+- **Header FRIDA-STUDIO** — banner de marca al arrancar; alterna con
+  el nativo con `/header-frida` y `/header-pi` (`extensions/branding.ts`).
+- **Banner personalizable** — `${PI_CODING_AGENT_DIR:-~/.pi/agent}/frida/
+  banner.txt` reemplaza el arte del header (subtítulo FRIDA y hints se
+  conservan); mismo comportamiento responsivo que el arte default.
+- **Theme `arctic-aurora`** (default) — paleta aurora boreal (cian
+  hielo `#67e8f9`, fondos azul-glaciar); el header toma su accent
+  (`themes/`, de [awesome-pi-themes](https://github.com/isashi/awesome-pi-themes), MIT).
+- **Themes seleccionables** — `frida` (cálida), `aurora-circuit` y
+  `violet-breakwater` (`--theme <nombre>`); **galería local** con
+  swatches de los 4 themes: `docs/theme-gallery.html` (regenerable con
+  `packages/studio/scripts/gen-theme-gallery.mjs`).
+- **Plantillas de rol** — `/rol-dev`, `/rol-fullstack`, `/rol-datos-ia`,
+  `/rol-seguridad`: punto de partida probado por perfil (`prompts/`).
+- **Footer FRIDA** — status bar con marca + modelo + % de contexto +
+  rama git, refresco cada 30s (`extensions/frida-footer.ts`; extensión
+  propia — pi-powerline-footer sale del bundle para no pelear por el
+  slot: quien lo prefiera, `pi install npm:pi-powerline-footer`).
+- **`/frida`** — identidad del kit: versión, theme activo, modelo y
+  cómo actualizar (`extensions/branding.ts`).
+
+## Sesión y productividad
+
+- **Tareas en background** — `/bg` y Ctrl+Shift+B: comandos largos
+  (builds, tests) sin bloquear la sesión; notificación al terminar
+  (`@monopi/background-tasks`).
+- **Todo estructurado** — lista de tareas multi-paso con estados y
+  dependencias (`@juiceshsharp/rpiv-todo`).
+- **Preguntas al usuario** — preguntas estructuradas con opciones en
+  vez de ambigüedad (`@juicesharp/rpiv-ask-user-question`).
+- **Argumentos en skills** — placeholders `$1`/`$ARGUMENTS` y
+  sustitución `` !`cmd` `` al invocar skills (`@juiceshsharp/rpiv-args`).
+- **Suite de procesos** — code review, changelog, commits, handoffs,
+  triage de PRs (`@juiceshsharp/rpiv-pi`).
+- **Workflows multi-agente** — pipelines deterministas con subagents
+  (`@juiceshsharp/rpiv-workflow`, `pi-extensible-workflows`).
+- **Subagents + Agent Hub** — ejecución paralela y orquestación;
+  **FleetView** (`↓` en prompt vacío) con roster de todos los agentes,
+  transcript en vivo, steering inline (`Enter`) y stop sin abortar la
+  sesión padre (`x`); `@mención` para dirigirte a un agente, tipos
+  propios en `.pi/agents/`, aislamiento por worktree y jobs agendados
+  (`@tintinweb/pi-subagents`).
+- **Worktrees** — gestión segura de git worktrees y cambio de
+  workspace (`@narumitw/pi-worktree`).
+
+## Datos y cálculo
+
+- **Kernel JS persistente** — herramienta `eval_js`: lo que se define
+  en una llamada (variables, funciones) vive en la siguiente, por
+  sesión — munging de JSON, cálculos y transformaciones sin salir del
+  chat; aislado por `node:vm` con timeout de 10s y `reset` para
+  empezar de cero (`extensions/frida-eval.ts`).
+
+## Inteligencia de código
+
+- **AST y diagnósticos** — búsqueda estructurada, diagnósticos LSP,
+  reglas tree-sitter/ast-grep, navegación (`pi-lens`).
+- **Búsqueda fuzzy** — find/grep rapidísimos sobre rutas y contenido
+  (`@ff-labs/pi-fff`).
+- **URIs del equipo** — herramienta `read_uri`: `pr://N`, `issue://N` y
+  `diff://N` se leen como archivos — una sola interfaz en vez de
+  aprender flags de gh (`extensions/frida-uris.ts`).
+
+## Contexto, memoria y web
+
+- **Memoria persistente** — recuerda entre sesiones (preferencias,
+  convenciones, lecciones) (`pi-hermes-memory`).
+- **Presión de contexto** — reportes en vivo de uso de tokens
+  (`@mrclrchtr/supi-context`).
+- **Web → Markdown** — páginas públicas a Markdown y docs Context7
+  enfocadas (`@mrclrchtr/supi-web`).
+- **Web tools** — búsqueda y fetch web (`@juiceshsharp/rpiv-web-tools`).
+- **Multi-idioma** — UI e interacción en español/inglés
+  (`@juiceshsharp/rpiv-i18n`).
+- **Navegador real** — automatización de browser/sitios con sesión
+  (`pi-agent-browser-native`).
+
+## Sesiones compartidas
+
+- **Web remote (Tailscale)** — `/remote` publica la sesión live con URL
+  y QR **solo dentro del tailnet del equipo** (decisión de seguridad:
+  nada expuesto a internet, cero relay externo) — pairing sin salir del
+  perímetro (`@monopi/remote-tailscale`; `web-server` es su librería).
+
+## Telemetría del uso
+
+- **Timing por prompt** — duración y diagnóstico por turno
+  (`@monopi/diagnostics`).
+- **Uso en SQLite + dashboard local** — qué extensiones/skills se usan
+  de verdad, evidencia para priorizar el roadmap
+  (`@monopi/analytics-extension`; `analytics-db` es su librería).
+
+## Robustez y gobierno
+
+- **Safe-mode** — el kit degrada y avisa si una extensión crashea, en
+  vez de tumbar la sesión (`@monopi/extension-watchdog`;
+  `@monopi/extension-shared` es su librería interna).
+- **Git guard** — guard rails contra operaciones destructivas de git
+  (`@monopi/extension-git-guard`).
+- **Permisos** — enforcement de permisos por herramienta
+  (`@gotgenes/pi-permission-system`).
+- **Segunda opinión** — un modelo revisor revisa antes de actuar
+  (`@juiceshsharp/rpiv-advisor`).
+
+## Comunicación e integraciones
+
+- **Telegram** — turnos y entrega vía Telegram (`@llblab/pi-telegram`).
+- **Sync de config** — settings de pi sincronizados entre máquinas vía
+  repo privado (`@jachy/pi-git-sync`).
+- **MCP** — adaptador de servidores Model Context Protocol
+  (`pi-mcp-adapter`).
+- **NotebookLM** — notebooks, sources y artifacts de Google
+  (`@bacnh85/pi-notebooklm`).
+- **Generación de imágenes** — vía Antigravity/Gemini (`pi-antigravity`).
+- **Skills referenciables** — `$skill_name` en cualquier prompt
+  (`pi-multi-skills`).
+
+## Aprendizaje del equipo
+
+- **Learn → skill** — `/skill:learn-review` revisa las lecciones
+  recurrentes de la memoria persistente y propone su promoción a
+  skills curadas del kit vía issue (`skills/learn-review`).
+- **gh-quoting** — primera skill nacida de lecciones reales del
+  equipo: bodies de `gh` a prueba de shell (heredoc quoted, jamás
+  backticks en argumentos interpolables) (`skills/gh-quoting`).
+
+## Onboarding
+
+- **Importadores de harness ajenos** — `--scan-imports` detecta rules
+  de Claude Code, Cursor, Cline, Copilot y Windsurf en el proyecto;
+  `--import` las fusiona en `AGENTS.md` (que pi lee nativo) con
+  procedencia, backup e idempotencia (setup CLI, issue #16).
+
+## Tiers
+
+| Tier | Contenido | Estado |
+| --- | --- | --- |
+| **Default** | Todo lo de arriba (bundle único) | Actual |
+| **Lite** | Marca + núcleo: header/footer/themes/roles + búsqueda + todo/ask/args + `/bg` + watchdog + permisos + git guard + timing | `--profile lite` en el setup (Package Filtering de pi) |

package/docs/theme-gallery.html

@@ -0,0 +1,197 @@
+<!doctype html>
+<html lang="es">
+  <head>
+    <meta charset="utf-8" />
+    <title>FRIDA-STUDIO — galería de themes</title>
+    <style>
+      :root {
+        color-scheme: dark;
+      }
+      body {
+        font-family: ui-monospace, "SF Mono", Menlo, monospace;
+        background: #0f2027;
+        color: #f8fdff;
+        margin: 2rem auto;
+        max-width: 56rem;
+        padding: 0 1rem;
+      }
+      h1 {
+        color: #67e8f9;
+      }
+      p.intro {
+        color: #a8c8d5;
+        line-height: 1.5;
+      }
+      .grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(16rem, 1fr));
+        gap: 1rem;
+      }
+      .card {
+        background: #14303a;
+        border: 1px solid #24424b;
+        border-radius: 0.6rem;
+        padding: 1rem;
+      }
+      .card h2 {
+        margin: 0 0 0.75rem;
+        font-size: 1.05rem;
+        color: #cffafe;
+      }
+      .swatches {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 0.4rem;
+      }
+      .chip {
+        display: inline-flex;
+        align-items: center;
+        gap: 0.35rem;
+        background: #0a171d;
+        border-radius: 0.4rem;
+        padding: 0.2rem 0.45rem;
+        font-size: 0.72rem;
+      }
+      .chip i {
+        width: 0.85rem;
+        height: 0.85rem;
+        border-radius: 0.25rem;
+        display: inline-block;
+        border: 1px solid #24424b;
+      }
+      .chip code {
+        color: #6e8995;
+      }
+      pre {
+        background: #0a171d;
+        border-radius: 0.4rem;
+        padding: 0.5rem 0.6rem;
+        font-size: 0.72rem;
+        overflow-x: auto;
+        color: #86efac;
+        margin: 0.8rem 0 0;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>FRIDA-STUDIO — galería de themes</h1>
+    <p class="intro">
+      Vista previa de los 4 themes del kit. Prueba cualquiera sin instalar nada
+      con el comando de cada tarjeta; para hacerlo tu default:
+      <code>settings.json → "theme": "&lt;nombre&gt;"</code> (o
+      <code>--theme</code> por sesión). Página regenerable:
+      <code>node packages/studio/scripts/gen-theme-gallery.mjs</code>
+    </p>
+    <div class="grid">
+      <article class="card">
+        <h2>arctic-aurora</h2>
+        <div class="swatches">
+          <span class="chip" title="accent"
+            ><i style="background: #67e8f9"></i>accent<code>#67e8f9</code></span
+          >
+          <span class="chip" title="success"
+            ><i style="background: #86efac"></i>success<code
+              >#86efac</code
+            ></span
+          >
+          <span class="chip" title="warning"
+            ><i style="background: #fde68a"></i>warning<code
+              >#fde68a</code
+            ></span
+          >
+          <span class="chip" title="error"
+            ><i style="background: #fda4af"></i>error<code>#fda4af</code></span
+          >
+          <span class="chip" title="muted"
+            ><i style="background: #a8c8d5"></i>muted<code>#a8c8d5</code></span
+          >
+          <span class="chip" title="selectedBg"
+            ><i style="background: #1d4652"></i>selectedBg<code
+              >#1d4652</code
+            ></span
+          >
+        </div>
+        <pre>pi --theme ./packages/studio/themes/arctic-aurora.json</pre>
+      </article>
+      <article class="card">
+        <h2>aurora-circuit</h2>
+        <div class="swatches">
+          <span class="chip" title="accent"
+            ><i style="background: #3fe7ff"></i>accent<code>#3fe7ff</code></span
+          >
+          <span class="chip" title="success"
+            ><i style="background: #55f7c2"></i>success<code
+              >#55f7c2</code
+            ></span
+          >
+          <span class="chip" title="warning"
+            ><i style="background: #ffd166"></i>warning<code
+              >#ffd166</code
+            ></span
+          >
+          <span class="chip" title="error"
+            ><i style="background: #ff6f7d"></i>error<code>#ff6f7d</code></span
+          >
+          <span class="chip" title="muted"
+            ><i style="background: #b8ccd5"></i>muted<code>#b8ccd5</code></span
+          >
+          <span class="chip" title="selectedBg"
+            ><i style="background: #1f4350"></i>selectedBg<code
+              >#1f4350</code
+            ></span
+          >
+        </div>
+        <pre>pi --theme ./packages/studio/themes/aurora-circuit.json</pre>
+      </article>
+      <article class="card">
+        <h2>frida</h2>
+        <div class="swatches">
+          <span class="chip" title="accent"
+            ><i style="background: #ff5533"></i>accent<code>#ff5533</code></span
+          >
+          <span class="chip" title="success"
+            ><i style="background: #2ec4b6"></i>success<code
+              >#2ec4b6</code
+            ></span
+          >
+          <span class="chip" title="warning"
+            ><i style="background: #ffd166"></i>warning<code
+              >#ffd166</code
+            ></span
+          >
+        </div>
+        <pre>pi --theme ./packages/studio/themes/frida.json</pre>
+      </article>
+      <article class="card">
+        <h2>violet-breakwater</h2>
+        <div class="swatches">
+          <span class="chip" title="accent"
+            ><i style="background: #b999ff"></i>accent<code>#b999ff</code></span
+          >
+          <span class="chip" title="success"
+            ><i style="background: #8ce4c1"></i>success<code
+              >#8ce4c1</code
+            ></span
+          >
+          <span class="chip" title="warning"
+            ><i style="background: #f0c86d"></i>warning<code
+              >#f0c86d</code
+            ></span
+          >
+          <span class="chip" title="error"
+            ><i style="background: #ff8d9d"></i>error<code>#ff8d9d</code></span
+          >
+          <span class="chip" title="muted"
+            ><i style="background: #b3c2d6"></i>muted<code>#b3c2d6</code></span
+          >
+          <span class="chip" title="selectedBg"
+            ><i style="background: #243449"></i>selectedBg<code
+              >#243449</code
+            ></span
+          >
+        </div>
+        <pre>pi --theme ./packages/studio/themes/violet-breakwater.json</pre>
+      </article>
+    </div>
+  </body>
+</html>