Files
PiAgentUI/docs/superpowers/plans/2026-05-30-roadmap-contexto-skills-mcp.md
T
Evandro b3489e1ede
Build & Push Frontend Docker Image / build-and-push (push) Canceled after 0s
Build Validation / validate (push) Canceled after 6s
Build & Push Backend Docker Image / build-and-push (push) Failing after 10m10s
Build & Push Gateway Docker Image / build-and-push (push) Failing after 10m9s
🎉 Initial commit: PiAgentUI — AI Agent Desktop & Web UI
A professional workspace for AI coding agents with:
- Real-time streaming chat with SSE
- Session management (fork, clone, tree navigation)
- MCP tools browser & metadata panel
- Skills browser (global, project, package sources)
- Voice input & STT provider configuration
- Integrated terminal & file explorer
- Model selector with capability metadata
- Keyboard-first UI with command palette
- 8 languages (en, pt-BR, es, ja, zh-CN, ar, bn, hi)
- Tauri 2 desktop app
- React 19 + TypeScript + Vite 8 + Tailwind CSS 4
- Pi Agent extension runtime

Originally forked from OpenCodeUI, now an independent project.
License: GPL-3.0-only
2026-06-01 00:50:06 -03:00

82 lines
3.0 KiB
Markdown

# Roadmap Contexto, Skills e MCP Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** concluir a integração de contexto real, skills reais, avisos de compaction/overflow e MCP nativo no PiAgentUI.
**Architecture:** O backend da extensão PiAgentUI deve ser a fonte de verdade para dados do runtime Pi. A UI deve consumir endpoints pequenos e tipados, preservando fallback seguro quando dados runtime não existirem.
**Tech Stack:** TypeScript, React, Vite, Vitest, extensão PiAgentUI HTTP/SSE, Pi runtime APIs.
---
## Task 1: Context metadata e uso real
**Status:** concluído em `f5a3fa5 feat: enrich context details with model metadata`.
## Task 2: Tool results somente em tool cards
**Status:** concluído em `41adf23 fix: keep tool results in tool cards`.
## Task 3: Skills reais por origem
**Status:** concluído em `257d63c feat: show real skills by source`.
## Task 4: Avisos de overflow e compaction
**Files:**
- Modify: `src/hooks/useSessionStats.ts`
- Modify: `src/features/chat/sidebar/SidebarFooter.tsx`
- Modify: `src/features/chat/sidebar/ContextDetailsDialog.tsx`
- Test: `src/hooks/useSessionStats.test.tsx`
- [ ] Adicionar estado derivado para `contextStatus`: `unknown`, `normal`, `warning`, `danger`.
- [ ] Mostrar fonte do dado: runtime, tokens ou estimativa.
- [ ] Mostrar aviso quando `contextKnown=false` após compaction.
- [ ] Mostrar aviso quando uso >= 70% e >= 90%.
- [ ] Rodar testes focados e build.
- [ ] Commit: `feat: surface context overflow notices`.
## Task 5: MCP backend real
**Files:**
- Modify/Create: `extensions/piagentui-server.ts`
- Modify/Create: `src/api/mcp.ts`
- Test: `extensions/piagentui-server.test.ts`
- [ ] Ler configuração MCP do Pi/agent config quando disponível.
- [ ] Expor `/api/mcp/servers` com servidores, status e origem.
- [ ] Preservar fallback vazio seguro.
- [ ] Testar config válida, ausente e inválida.
- [ ] Commit: `feat: expose real mcp servers`.
## Task 6: MCP UI real
**Files:**
- Modify: `src/components/McpPanel.tsx`
- Modify: `src/types/api/mcp.ts`
- Test: `src/components/McpPanel.test.tsx` se existir; caso contrário criar.
- [ ] Agrupar servidores por status/origem.
- [ ] Mostrar tools quando disponíveis.
- [ ] Mostrar erro de inicialização/config.
- [ ] Commit: `feat: render real mcp server status`.
## Task 7: Skills avançado
**Files:**
- Modify: `extensions/piagentui-server.ts`
- Modify: `src/components/SkillPanel.tsx`
- [ ] Expor diagnósticos/collisions quando Pi disponibilizar.
- [ ] Mostrar `disableModelInvocation` quando disponível.
- [ ] Melhorar origem com package/source quando disponível.
- [ ] Commit: `feat: add skill diagnostics metadata`.
## Task 8: Hardening e docs
- [ ] Extrair parsers grandes de `extensions/piagentui-server.ts` se necessário.
- [ ] Atualizar Obsidian/task list.
- [ ] Rodar full test/build.
- [ ] Fazer checkpoint commit/tag local se solicitado.