# 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.

## Cómo se instala el stack

El paquete npm del kit lleva SOLO sus recursos propios; el bootstrap
instala el resto como paquetes individuales (el hoisting de npm rompe
las rutas de un manifest bundleado — #37). Ventaja: todo se actualiza
con `pi update` desacoplado de los releases del kit. La familia rpiv
en paquetes separados además habilita sus 15 agents (detección de
rpiv-pi). Para el EQUIPO, el setup añade además el monorepo privado
`pi-extensions` (devengine, enterprise, relay, command-guard) cuando
detecta acceso — los externos lo saltan sin notarlo.

## 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 powerline con marca** — status bar powerline completa
  (modelo, thinking, git con conteos, contexto con colores, tokens,
  costo) con el segmento `FRIDA-STUDIO v0.6.5` PRIMERO en la barra:
  `branding.ts` publica el status `frida-version` y el setup lo
  promueve a segmento (customItems + layout; `pi-powerline-footer`, #44).
  El welcome overlay queda off — la marca de arranque vive en el header
  FRIDA. El footer propio (`frida-footer.ts`) se retiró.
- **`/frida`** — identidad del kit: versión, theme activo, modelo y
  cómo actualizar (`extensions/branding.ts`).
- **Welcome overlay FRIDA** — splash centrado al arrancar (patrón del
  welcome de pi-powerline-footer, MIT, con arte y marca propios):
  gradiente FRIDA-STUDIO (o FRIDA en terminal chica), versión,
  modelo · proveedor y hints reales; auto-cierra a los 30s o con
  cualquier tecla. Escape: `frida.welcome: false` en settings
  (`extensions/frida-welcome.ts`, #46).

## Sesión y productividad

- **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`).

- **Utilidades monopi retiradas** (#44) — background tasks, web remote
  (tailscale), timing por prompt, analytics, safe-mode y git guard
  salieron del kit (huérfanas hacia ciclos; `@monopi/diagnostics` comía
  2 líneas de footer). Si se necesitan: `pi install npm:@monopi/<paquete>`.

## 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`).

## Robustez y gobierno

- **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

- **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) |