pantheon-opencode 2.1.4 → 2.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.global.md +6 -6
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +52 -0
- package/README.md +60 -233
- package/README.pt-BR.md +64 -220
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/install/opencode.mjs +12 -0
- package/scripts/test-slice.mjs +34 -2
- package/skills-lock.json +1 -1
- package/src/agents/aphrodite.md +3 -1
- package/src/agents/apollo.md +1 -0
- package/src/agents/athena.md +1 -0
- package/src/agents/demeter.md +2 -0
- package/src/agents/gaia.md +1 -0
- package/src/agents/hephaestus.md +1 -0
- package/src/agents/hermes.md +2 -1
- package/src/agents/iris.md +1 -0
- package/src/agents/mnemosyne.md +1 -0
- package/src/agents/nyx.md +1 -0
- package/src/agents/prometheus.md +1 -0
- package/src/agents/talos.md +1 -0
- package/src/agents/themis.md +1 -0
- package/src/agents/zeus.md +8 -2
- package/src/instructions/backend-standards.instructions.md +5 -0
- package/src/instructions/test-economy.instructions.md +6 -6
- package/src/mcp/pantheon_vision.py +4 -1
- package/src/pantheon/auto-permissions.ts +4 -3
- package/src/pantheon/deepwork/deepwork-tool.ts +23 -75
- package/src/pantheon/deepwork/plan-schema.ts +4 -2
- package/src/pantheon/deepwork/plan-tracker.ts +380 -90
- package/src/pantheon/jev-decision-tool.ts +1 -7
- package/src/pantheon/local-decision-tool.ts +1 -1
- package/src/pantheon/native-vision.ts +1 -1
- package/src/pantheon/skill-search-tool.ts +241 -47
- package/src/pantheon/tool-context.ts +23 -0
- package/src/pantheon/tools.ts +46 -41
- package/src/plugin/index.js +521 -222
- package/src/plugin.ts +1 -0
- package/src/plugins/tui/dist/tui.d.ts +7 -6
- package/src/plugins/tui/dist/tui.d.ts.map +1 -1
- package/src/plugins/tui/dist/tui.js +198 -269
- package/src/plugins/tui/dist/tui.js.map +1 -1
- package/src/plugins/tui/package-lock.json +2 -2
- package/src/plugins/tui/package.json +1 -1
- package/src/plugins/tui/src/index.tsx +7 -45
- package/src/plugins/tui/src/tui-prefs.ts +3 -9
- package/src/skills/test-slicing/SKILL.md +14 -8
package/README.pt-BR.md
CHANGED
|
@@ -1,254 +1,98 @@
|
|
|
1
1
|
<!-- synced-from: README.md -->
|
|
2
2
|
# Pantheon
|
|
3
3
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
[Repositório](https://github.com/ils15/pantheon-opencode) · [Licença MIT](LICENSE)
|
|
9
|
-
|
|
10
|
-
[](https://github.com/ils15/pantheon-opencode/releases/latest)
|
|
11
|
-
[](https://ils15.github.io/pantheon-opencode/)
|
|
12
|
-
[](https://github.com/ils15/pantheon-opencode/actions)
|
|
13
|
-
[](https://doi.org/10.5281/zenodo.22650136)
|
|
14
|
-
|
|
15
|
-
## O que é?
|
|
16
|
-
|
|
17
|
-
O Pantheon é um companheiro do [OpenCode](https://opencode.ai/) que ajuda você a ir de uma ideia até uma alteração revisada e verificada. Quatorze agentes especializados compartilham um fluxo direto e consistente: planejar, implementar, checar, revisar e registrar o que foi importante. Você permanece no controle de cada decisão e de cada merge.
|
|
18
|
-
|
|
19
|
-
```mermaid
|
|
20
|
-
flowchart LR
|
|
21
|
-
U["Você"] --> Z["Zeus<br/>orquestrador"]
|
|
22
|
-
Z -->|"delega"| S["14 especialistas<br/>hermes · aphrodite · demeter · themis …"]
|
|
23
|
-
Z -->|"rota ambígua"| J["Jev decision router<br/>tipado · com budget · reversível"]
|
|
24
|
-
J -->|"ordena · classifica · verifica"| S
|
|
25
|
-
S -->|"último recurso"| M["MCP nativo<br/>memória · persistência · visão<br/>code-mode · recursos"]
|
|
26
|
-
Z --> G["J1 risk gate<br/>off / shadow / warn / enforce"]
|
|
27
|
-
G -->|"alto risco"| H["Aprovação humana"]
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
**A escada de escalonamento que todo agente segue**: contexto da sessão primeiro → seletor local gratuito → uma decisão Jev tipada quando genuinamente ambíguo → chamada a MCP nativo apenas como último recurso para estado que a sessão não puder reconstruir.
|
|
31
|
-
|
|
32
|
-
```mermaid
|
|
33
|
-
flowchart LR
|
|
34
|
-
R["pedido inicial"] --> T0{"claro e<br/>delimitado?"}
|
|
35
|
-
T0 -->|sim| X["executar diretamente"]
|
|
36
|
-
T0 -->|"vago /<br/>múltiplos tópicos"| T1["Tier 1 — interno<br/>ajuste mínimo ≤15 linhas<br/>(silencioso, sem aprovação)"]
|
|
37
|
-
T1 --> T2q{">> fornecido?"}
|
|
38
|
-
T2q -->|sim| T2["Tier 2 — contrato completo<br/>6 seções, confirmar-ou-ajustar"]
|
|
39
|
-
T2q -->|não| X
|
|
40
|
-
```
|
|
4
|
+
Plugin de orquestração multiagente para o OpenCode que leva um pedido do plano até a
|
|
5
|
+
alteração revisada com 14 agentes especializados, TDD obrigatório e gates de aprovação
|
|
6
|
+
humana — para desenvolvedores e equipes que querem estrutura sem abrir mão do controle
|
|
7
|
+
do código.
|
|
41
8
|
|
|
42
|
-
|
|
9
|
+
[English](README.md) · [Repositório](https://github.com/ils15/pantheon-opencode) · [Licença MIT](LICENSE)
|
|
43
10
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
C2 -->|"sem ajuste"| C3["GitHub raw<br/>mais ampla, menor confiança"]
|
|
49
|
-
C3 --> J["Jev ordena<br/>os candidatos"]
|
|
50
|
-
J --> P["VOCÊ revisa<br/>e roda o install"]
|
|
51
|
-
```
|
|
11
|
+
[](LICENSE)
|
|
12
|
+
[](package.json)
|
|
13
|
+
[](https://opencode.ai/)
|
|
14
|
+
[](https://ils15.github.io/pantheon-opencode/pt-BR/)
|
|
52
15
|
|
|
53
|
-
##
|
|
16
|
+
## O que é
|
|
54
17
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
- **Atualizações não-destrutivas:** Atualizar o Pantheon (`pantheon-opencode update`) renova skills, MCPs e instruções preservando rigorosamente todos os modelos do usuário, presets ativos, permissões e regras customizadas no `AGENTS.md`.
|
|
18
|
+
Um agente único planejando, escrevendo, testando, revisando e documentando ao mesmo tempo
|
|
19
|
+
produz contexto fragmentado e testes pulados. O Pantheon divide esse trabalho entre
|
|
20
|
+
especialistas que compartilham um fluxo único: Zeus orquestra, Athena planeja, os agentes
|
|
21
|
+
de implementação escrevem, Themis revisa, e cada fase para esperando sua aprovação.
|
|
22
|
+
Micro-edições limitadas pulam a cerimônia e verificam em segundos; trabalho pesado de
|
|
23
|
+
várias fases roda como plano com checkpoints, retomável entre sessões. É um plugin do
|
|
24
|
+
OpenCode mais um instalador — sem runtime separado, sem auto-merge, sem mudança silenciosa
|
|
25
|
+
de permissões.
|
|
64
26
|
|
|
65
|
-
|
|
27
|
+
Cada despacho carrega um handoff brief conciso — objetivo, escopo limitado, entradas
|
|
28
|
+
relevantes, restrições, formato de retorno esperado e verificação — e o trabalho é roteado
|
|
29
|
+
**qualitativamente**, por incerteza, domínio, dependências, risco e verificação, não por
|
|
30
|
+
limites fixos de arquivos ou linhas.
|
|
66
31
|
|
|
67
|
-
|
|
32
|
+
## Instalação
|
|
68
33
|
|
|
69
|
-
|
|
34
|
+
Requisitos: [OpenCode](https://opencode.ai/docs/) **2.x** e Node.js **≥ 26.4.0**
|
|
35
|
+
([compatibilidade](docs/COMPATIBILITY.md)).
|
|
70
36
|
|
|
71
|
-
**Opção A — Adição Rápida de Plugin (Global ou no Projeto):**
|
|
72
37
|
```bash
|
|
38
|
+
# Opção A — como plugin do OpenCode (global ou do projeto)
|
|
73
39
|
opencode plugin add pantheon-opencode
|
|
74
|
-
# Ou fixe uma versão específica:
|
|
75
|
-
opencode plugin add pantheon-opencode@2.0.0-rc.1
|
|
76
|
-
```
|
|
77
40
|
|
|
78
|
-
|
|
79
|
-
```bash
|
|
41
|
+
# Opção B — instalação global via CLI com todo o ferramental MCP
|
|
80
42
|
npm install -g pantheon-opencode@beta
|
|
81
43
|
pantheon-opencode init --yes
|
|
82
|
-
```
|
|
83
44
|
|
|
84
|
-
|
|
85
|
-
```bash
|
|
45
|
+
# Verificar a instalação
|
|
86
46
|
pantheon-opencode doctor
|
|
87
|
-
```
|
|
88
|
-
Executa um diagnóstico de 28 pontos checando inicialização de MCPs, ambientes virtuais Python, versão do Node, permissões e integridade de configuração.
|
|
89
47
|
|
|
90
|
-
|
|
91
|
-
Quando uma nova versão for lançada:
|
|
92
|
-
```bash
|
|
48
|
+
# Depois: atualizar sem perder modelos, presets ou permissões
|
|
93
49
|
pantheon-opencode update
|
|
94
50
|
```
|
|
95
|
-
O atualizador valida a identidade do pacote, baixa a versão mais recente e executa uma atualização de configuração totalmente não-destrutiva. **Seus modelos personalizados, preset ativo, permissões customizadas, opções de plugins e seções próprias no AGENTS.md são preservados sem alterações.**
|
|
96
51
|
|
|
97
|
-
|
|
52
|
+
## Uso
|
|
98
53
|
|
|
99
|
-
|
|
54
|
+
Dentro do OpenCode, acione o orquestrador ou um fluxo:
|
|
100
55
|
|
|
101
|
-
O Pantheon equilibra velocidade e rigor através de três modos de execução:
|
|
102
|
-
|
|
103
|
-
```mermaid
|
|
104
|
-
flowchart TD
|
|
105
|
-
Req["Pedido do Usuário"] --> Size{"Escopo / Risco"}
|
|
106
|
-
Size -->|"≤ 2 arquivos · ≤ 50 linhas<br/>correção / typo / CSS"| Fast["Fast-Track<br/>(Sub-10s · Test Slicing Inline)"]
|
|
107
|
-
Size -->|"Arquitetura / Escolha técnica<br/>Segurança / Multi-stakeholders"| Council["Síntese do Conselho (/pantheon)<br/>(2-3 Especialistas em Paralelo · Autoridade de Domínio)"]
|
|
108
|
-
Size -->|"Feature multi-fases<br/>Refatoração pesada · Breaking change"| Deep["Deepwork (/pantheon-deepwork)<br/>(Plano da Athena · Gates de Fase · Checkpoints)"]
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
### 1. Fast-Track & Test Slicing (Micro-Edições < 10s)
|
|
112
|
-
Para correções de bugs pontuais, ajustes de estilo ou refatorações localizadas:
|
|
113
|
-
- **Sem cerimônia de planejamento:** Executa diretamente as alterações delimitadas.
|
|
114
|
-
- **Fatiamento direcionado de testes:** Executa APENAS a fatia de testes correspondente ao arquivo modificado (ex: `node --test tests/foo.test.mjs` ou `pytest -k <func>`). Suites completas são reservadas para CI e release gates.
|
|
115
|
-
- **Entrega em turno único:** Valida e finaliza em menos de 10 segundos.
|
|
116
|
-
|
|
117
|
-
### 2. Síntese Assertiva do Conselho (`/pantheon`)
|
|
118
|
-
Ao enfrentar encruzilhadas arquiteturais, avaliações tecnológicas ou trade-offs de segurança:
|
|
119
|
-
```text
|
|
120
|
-
/pantheon Devemos usar WebSockets ou Server-Sent Events para notificações push em tempo real?
|
|
121
|
-
```
|
|
122
|
-
- **Despacho Paralelo:** Dispara 2 a 3 especialistas simultaneamente com prompts independentes.
|
|
123
|
-
- **Arbitragem Assertiva:** Em vez de travar em rodadas repetitivas de debate, divergências são resolvidas de imediato via **Precedência de Autoridade de Domínio**:
|
|
124
|
-
- **Segurança / Auth:** `@themis` tem poder de veto sobre propostas vulneráveis.
|
|
125
|
-
- **Banco de Dados / Schema:** `@demeter` tem autoridade técnica sobre consultas e integridade transacional.
|
|
126
|
-
- **Frontend / UX / A11y:** `@aphrodite` rege acessibilidade e ergonomia visual.
|
|
127
|
-
- **Infraestrutura / CI:** `@prometheus` rege limites de runtime, containers e pipelines.
|
|
128
|
-
- **API / Protocolos:** `@hermes` rege conformidade contratual e esquemas de transporte.
|
|
129
|
-
- **Arquitetura / Modularidade:** `@athena` rege desacoplamento e manutenibilidade a longo prazo.
|
|
130
|
-
- **Decisões Multi-Critério JEV:** Se os trade-offs equilibrarem demandas concorrentes de mesmo peso, Zeus invoca `pantheon_jev_decide` (ou a matriz de decisão local) para ordenar as opções deterministicamente em uma única chamada.
|
|
131
|
-
|
|
132
|
-
### 3. Deepwork com Checkpoints (`/pantheon-deepwork`)
|
|
133
|
-
Para tarefas complexas com mais de 10 turnos ou distribuídas em várias sessões:
|
|
134
56
|
```text
|
|
135
|
-
|
|
57
|
+
@zeus: Adicione exportação CSV na página de relatórios
|
|
58
|
+
/pantheon-deepwork "Implemente o fluxo de autenticação OAuth2 PKCE"
|
|
136
59
|
```
|
|
137
|
-
- **O Plano é o Artefato:** O estado canônico é salvo em `.pantheon/deepwork/<slug>/plan.json` acompanhado do log append-only de eventos (`journal.ndjson`) para recuperação resiliente contra falhas.
|
|
138
|
-
- **Gates Nativos do OpenCode (Sem HTML):** Aprovações (Portão 1) e resoluções de decisão utilizam a ferramenta interativa nativa `question` do OpenCode diretamente no chat.
|
|
139
|
-
- **Grafo de Dependências (DAG):** Projeção automática das tarefas em diagrama Mermaid vivo (`flowchart LR`) dentro do `PLAN.md` e nos resumos de status do chat.
|
|
140
|
-
- **Critérios de Aceite Fail-First:** Cada tarefa define verificações concretas (`kind: test|command|file|manual`, `fails_now: true`) validadas com recibos criptográficos de execução.
|
|
141
|
-
- **Automação via Ferramenta (`pantheon_deepwork`):** Ferramenta estruturada para `init`, `status`, `update_task`, `verify_acceptance` e `resolve_decision`.
|
|
142
|
-
- **Resumibilidade:** Progresso salvo em `.pantheon/deepwork/<slug>/`. Retome a qualquer momento com `/pantheon-deepwork --resume <slug>`.
|
|
143
|
-
|
|
144
|
-
---
|
|
145
|
-
|
|
146
|
-
## Os 14 Agentes Especializados
|
|
147
|
-
|
|
148
|
-
Para uma matriz detalhada de permissões, ferramentas, acesso a MCPs e restrições absolutas de cada agente, consulte a [Matriz de Capacidades dos Agentes](docs/AGENT-CAPABILITY-MATRIX.md).
|
|
149
|
-
|
|
150
|
-
Toda delegação raiz carrega um brief conciso — objetivo, escopo delimitado, entradas relevantes, restrições, formato de retorno esperado e critérios de verificação. O trabalho é roteado de forma qualitativa — incerteza, especialidade de domínio, dependências, risco e verificação — nunca por limites arbitrários de linhas. Os contratos de retorno são específicos por papel: implementação usa `## subtask_summary`, investigações retornam achados estruturados, Athena entrega o plano completo e respostas ao conselho usam `## specialist_response`.
|
|
151
|
-
|
|
152
|
-
| Agente | Autoridade de Domínio | Responsabilidades Principais |
|
|
153
|
-
|---|---|---|
|
|
154
|
-
| **@zeus** | Orquestrador Central | Direciona o fluxo, delega tarefas, arbitra decisões do conselho e garante economia de tokens. Nunca implementa código diretamente. |
|
|
155
|
-
| **@athena** | Arquitetura e Planejamento | Planejamento research-first, fronteiras de sistema, LTS e análise de dependências. Plan-only; nunca implementa. |
|
|
156
|
-
| **@hermes** | Backend e APIs | FastAPI, Python assíncrono, backends Node/TypeScript, contratos de API e conformidade de protocolos. |
|
|
157
|
-
| **@aphrodite** | Frontend e UX | React 19, TypeScript estrito, design responsivo, acessibilidade WCAG e CSS moderno. |
|
|
158
|
-
| **@demeter** | Banco de Dados e Persistência | Migrações de schema, otimização de queries, prevenção de queries N+1 e integridade transacional. |
|
|
159
|
-
| **@themis** | Gate de Qualidade e Segurança | Auditorias OWASP, análise estática (Biome/ruff), autorização e limpeza de código legado. Revisa mudanças materiais. |
|
|
160
|
-
| **@prometheus** | DevOps e Infraestrutura | Docker, pipelines CI/CD, configuração de runtime, abstração de provedores e infra de telemetria. |
|
|
161
|
-
| **@talos** | Linha Rápida de Hotfixes | Correções rápidas e autônomas para bugs pequenos, typos e lógica simples sem sobrecarga de subagentes. |
|
|
162
|
-
| **@apollo** | Batedor de Investigação | Descoberta somente-leitura: buscas paralelas no código e na documentação. Retorna achados estruturados. |
|
|
163
|
-
| **@hephaestus**| Pipelines de IA e RAG | Embeddings, vector stores, engenharia de prompt e pipelines de agentes. |
|
|
164
|
-
| **@gaia** | Sensoriamento e Geoespacial | Sensoriamento remoto, SAR, análise geoespacial e classificação raster ML/DL (somente-leitura). |
|
|
165
|
-
| **@iris** | Operações Git e Release | Branches, PRs, triagem de issues e notas de lançamento. Nunca faz push ou merge sem aprovação humana explícita. |
|
|
166
|
-
| **@mnemosyne** | Banco de Memória do Projeto | Mantém o `.pantheon/memory-bank/` e registra ADRs quando explicitamente solicitado. |
|
|
167
|
-
| **@nyx** | Observabilidade e Telemetria| Rastreamento OpenTelemetry, monitoramento de tokens/custos e profiling de execução. |
|
|
168
60
|
|
|
169
|
-
|
|
61
|
+
`@zeus` roteia para os especialistas; `/pantheon` arbitra escolhas de arquitetura entre
|
|
62
|
+
especialistas; `/pantheon-deepwork` executa um plano multifase com checkpoints e gates.
|
|
63
|
+
Você aprova cada gate e executa cada commit.
|
|
170
64
|
|
|
171
|
-
##
|
|
65
|
+
## Estrutura
|
|
172
66
|
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
## Configurações & Janela TUI (`/pantheon-settings`)
|
|
186
|
-
|
|
187
|
-
Execute `/pantheon-settings` (ou `Pantheon: Settings` na paleta de comandos) para abrir o painel de configurações:
|
|
188
|
-
|
|
189
|
-
- **Gates & Overrides:** Habilite ou desabilite comportamentos nomeados em tempo real (salvo em `pantheon-overrides.json`).
|
|
190
|
-
- **Presets de Modelos:** Alterne o tier de modelos ativo globalmente ou no projeto.
|
|
191
|
-
- **Seletor de Modelo de Decisão:** Alterne interativamente entre os modelos remotos de decisão (`openrouter-jev`, `typesafe-jev`, `openai-decisions`, etc.) diretamente na interface.
|
|
192
|
-
- **Suporte Multilíngue (PT-BR / EN):** Tradução visual completa das abas Decisões, Autonomia e Segurança, com detecção automática da linguagem do sistema e troca manual na aba TUI.
|
|
193
|
-
- **Atualizações:** Verifique o canal do registro (`beta` / `stable`) e dispare upgrades.
|
|
194
|
-
- **Doctor:** Execute o diagnóstico de saúde do sistema diretamente na interface.
|
|
195
|
-
- **Personalização da TUI:** Ajuste espaçamento (`comfortable` vs `compact`), separadores, estilo das barras de progresso, linhas de contexto e idioma.
|
|
196
|
-
- **Overlay Não-Destrutivo e Navegação por Clique:** Abre como diálogo flutuante sobre a sessão ativa mantendo a TUI visível (configurável entre `dialog` e `fullscreen`), com suporte completo a cliques de mouse em abas, menu lateral, linhas, seletores e botões de ação.
|
|
197
|
-
- **Janela de Novidades Modernizada:** Layout em card com bordas arredondadas, paginação visual e botão dedicado `[OK, Entendido]` com confirmação via mouse ou teclado (`Enter`/`Esc`/`Q`).
|
|
198
|
-
|
|
199
|
-
---
|
|
200
|
-
|
|
201
|
-
## Documentação & Tutoriais
|
|
202
|
-
|
|
203
|
-
> 📖 **Portal Oficial de Documentação:** Explore guias completos com pesquisa instantânea, diagramas interativos em Mermaid e histórico de versões em **[https://ils15.github.io/pantheon-opencode/](https://ils15.github.io/pantheon-opencode/)**.
|
|
204
|
-
|
|
205
|
-
| Guias & Tutoriais | Arquitetura e Aprofundamento | Referência e Operações |
|
|
206
|
-
|---|---|---|
|
|
207
|
-
| [Primeiro Projeto (End-to-End)](docs/guides/first-project.md) | [Arquitetura](docs/ARCHITECTURE.md) | [Ferramentas MCP](docs/mcp-tools.md) |
|
|
208
|
-
| [Matriz de Agentes](docs/AGENT-CAPABILITY-MATRIX.md) | [Delegação & Gates](docs/PERMISSIONS-QUALITY-DELEGATION.md) | [Decisões Nativas (Jev)](docs/reference/native-decisions.md) |
|
|
209
|
-
| [Guia do Deepwork](docs/guides/deepwork.md) | [Sistema de Memória](docs/MEMORY.md) | [Roteamento de Modelos](docs/reference/model-routing.md) |
|
|
210
|
-
| [Pantheon Vision](docs/guides/vision.md) | [Integração OpenCode](docs/opencode.md) | [Changelog](CHANGELOG.md) |
|
|
211
|
-
| [Cookbook de Receitas](docs/guides/cookbook.md) | [Compatibilidade](docs/COMPATIBILITY.md) | [Wiki](wiki/Home.md) |
|
|
212
|
-
|
|
213
|
-
---
|
|
214
|
-
|
|
215
|
-
## Exemplos Práticos do Mundo Real
|
|
216
|
-
|
|
217
|
-
Projetos funcionais demonstrando a orquestração do Pantheon na prática:
|
|
218
|
-
|
|
219
|
-
* **[SaaS Performance Dashboard](examples/saas-dashboard/) (`examples/saas-dashboard`):** Aplicação fullstack completa com React 19, backend Fastify, streaming de CSV, testes automatizados e plano Deepwork real com evidências (`plan.json`, `journal.ndjson`, `PLAN.md`).
|
|
220
|
-
* **[Repo Health CLI](examples/cli-tool/) (`examples/cli-tool`):** Ferramenta de linha de comando para diagnóstico de repositórios em menos de 1 segundo, demonstrando o fluxo fast-path do `@talos` e `@hermes`.
|
|
221
|
-
|
|
222
|
-
---
|
|
223
|
-
|
|
224
|
-
## O Que Há de Novo na v2.0.1
|
|
225
|
-
|
|
226
|
-
- **Configurações TUI Bilíngues (PT-BR / EN):** Localização visual para o Assistente de Decisão Jev, Autonomia & Orçamentos e Portão de Segurança J1, com detecção inteligente da linguagem do ambiente (`LANG` / `LC_ALL`) e seleção manual (`auto`, `pt-BR`, `en`).
|
|
227
|
-
- **Seletor Interativo de Modelos Jev:** Linha de seleção sempre visível em `/pantheon-settings` para alternar entre os 6 modelos remotos suportados sem editar arquivos JSON manualmente.
|
|
228
|
-
- **Síntese do Conselho Modernizada (`/pantheon`):** Artefatos com Autoridade por Domínio, diagrama visual de arbitragem em Mermaid e checklist de ações imediatas.
|
|
229
|
-
- **Planejamento Estratégico Modernizado (`/pantheon-deepwork`):** Planos da Athena com fluxo visual em Mermaid, fatiamento rigoroso de testes (< 10s), análise de raio de impacto e plano de rollback.
|
|
230
|
-
- **Desmistificação da Escala de Segurança J1:** Descrições claras dos modos de execução (`shadow`, `enforce`, `off`), eliminando ambiguidades sobre bloqueio e telemetria.
|
|
231
|
-
|
|
232
|
-
---
|
|
233
|
-
|
|
234
|
-
## O Que Há de Novo na v2.0.0-rc.1
|
|
235
|
-
|
|
236
|
-
- **Inauguração da Série Release Candidate:** Orquestração multi-agente pronta para produção no OpenCode 2.x.
|
|
237
|
-
- **Compactação de Tokens dos Agentes (-44.3%):** Remoção de código duplicado no Apollo/Prometheus, economizando 8.150 tokens por turno (~29,3M tokens/mês).
|
|
238
|
-
- **Diretiva de Pragmatismo e Anti-Pedantismo:** Diagnósticos seguros autorizados sem burocracia excessiva, eliminando lentidão e morosidade.
|
|
239
|
-
- **TDD em Lote (Batched Suite) e Test-Slicing:** Implementação coesa de módulos completos e execução de testes em menos de 100ms.
|
|
240
|
-
- **Descoberta Proativa de Skills com Cache:** Buscas de skills cacheadas (TTL 24h) e recomendação proativa de ferramentas pelo Zeus.
|
|
241
|
-
- **Scorecard JEV ao Vivo e App Web no Sandbox:** 16/16 cenários aprovados ($0,0000238/decisão) validados com app real no sandbox.
|
|
242
|
-
|
|
243
|
-
Consulte o [CHANGELOG.md](CHANGELOG.md) para o histórico completo de lançamentos.
|
|
67
|
+
```
|
|
68
|
+
src/agents/ 14 definições canônicas de agentes
|
|
69
|
+
src/skills/ skills carregadas sob demanda
|
|
70
|
+
src/mcp/ servidores MCP locais (memory, persistence, resources, code-mode, vision)
|
|
71
|
+
src/plugins/ plugin do OpenCode + TUI
|
|
72
|
+
scripts/ instalador, doctor, test-slice, ferramental de release
|
|
73
|
+
bin/ CLI pantheon-opencode
|
|
74
|
+
docs/ documentação (também publicada como portal de docs)
|
|
75
|
+
examples/ projetos de referência executáveis
|
|
76
|
+
tests/ suítes de teste em Node e TypeScript
|
|
77
|
+
```
|
|
244
78
|
|
|
245
|
-
##
|
|
79
|
+
## Documentação
|
|
246
80
|
|
|
247
|
-
|
|
81
|
+
| Comece por | Aprofunde |
|
|
82
|
+
|---|---|
|
|
83
|
+
| [Portal de docs](https://ils15.github.io/pantheon-opencode/pt-BR/) | [Arquitetura](docs/pt-BR/ARCHITECTURE.md) |
|
|
84
|
+
| [Início rápido](docs/pt-BR/QUICKSTART.md) | [Visão geral e escadas de roteamento](docs/OVERVIEW.md) |
|
|
85
|
+
| [Instalação](docs/pt-BR/INSTALLATION.md) | [Modos de execução](docs/guides/execution-modes.md) |
|
|
86
|
+
| [Primeiro projeto ponta a ponta](docs/pt-BR/guides/first-project.md) | [Matriz de capacidade dos agentes](docs/pt-BR/AGENT-CAPABILITY-MATRIX.md) |
|
|
87
|
+
| [Configurações e janela TUI](docs/SETTINGS.md) | [Permissões, gates e delegação](docs/PERMISSIONS-QUALITY-DELEGATION.md) |
|
|
88
|
+
| [Novidades da v2.x](docs/releases/v2-highlights.md) | [CHANGELOG](CHANGELOG.md) |
|
|
248
89
|
|
|
249
|
-
|
|
90
|
+
Exemplos executáveis: [dashboard SaaS](examples/saas-dashboard/) e
|
|
91
|
+
[CLI de saúde do repositório](examples/cli-tool/). Contribuição:
|
|
92
|
+
[CONTRIBUTING.md](CONTRIBUTING.md).
|
|
250
93
|
|
|
251
|
-
|
|
252
|
-
Cite via Zenodo concept DOI: [10.5281/zenodo.22650136](https://doi.org/10.5281/zenodo.22650136). Metadados de citação disponíveis em [CITATION.cff](CITATION.cff).
|
|
94
|
+
## Licença
|
|
253
95
|
|
|
254
|
-
|
|
96
|
+
MIT — veja [LICENSE](LICENSE). Citação via DOI de conceito Zenodo
|
|
97
|
+
[10.5281/zenodo.22650136](https://doi.org/10.5281/zenodo.22650136)
|
|
98
|
+
([CITATION.cff](CITATION.cff)).
|
package/package.json
CHANGED
package/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pantheon",
|
|
3
3
|
"publisher": "ils15",
|
|
4
|
-
"version": "2.1.
|
|
4
|
+
"version": "2.1.6",
|
|
5
5
|
"displayName": "Pantheon",
|
|
6
6
|
"description": "Conductor-Delegate orchestration platform with 14 specialized agents, 25 skills, and OpenCode support.",
|
|
7
7
|
"agents": "./src/agents",
|
package/pyproject.toml
CHANGED
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.backends._legacy:_Backend"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "pantheon"
|
|
7
|
-
version = "2.1.
|
|
7
|
+
version = "2.1.6"
|
|
8
8
|
description = "Multi-agent orchestration framework"
|
|
9
9
|
requires-python = ">=3.11"
|
|
10
10
|
# Python sources under src/mcp/ import fastmcp/pydantic at runtime, but those
|
|
@@ -3290,6 +3290,18 @@ async function installPass(
|
|
|
3290
3290
|
markAppliedWrite()
|
|
3291
3291
|
stateStep(true)
|
|
3292
3292
|
advancePhase()
|
|
3293
|
+
|
|
3294
|
+
if (opts.isProject && !existsSync(join(target, '.git'))) {
|
|
3295
|
+
try {
|
|
3296
|
+
const { spawnSync } = await import('node:child_process')
|
|
3297
|
+
const gitProbe = spawnSync('git', ['--version'], { stdio: 'ignore' })
|
|
3298
|
+
if (gitProbe.status === 0) {
|
|
3299
|
+
spawnSync('git', ['init', '-q'], { cwd: target, stdio: 'ignore' })
|
|
3300
|
+
}
|
|
3301
|
+
} catch {
|
|
3302
|
+
// git probe or initialization failed; harmless
|
|
3303
|
+
}
|
|
3304
|
+
}
|
|
3293
3305
|
}
|
|
3294
3306
|
|
|
3295
3307
|
// Fail closed only after the degraded state is persisted. The caller records
|
package/scripts/test-slice.mjs
CHANGED
|
@@ -200,6 +200,15 @@ export function mapFileToSlice(filePath, cwd = process.cwd()) {
|
|
|
200
200
|
export function resolveTestSlice(files = [], options = {}) {
|
|
201
201
|
const cwd = options.cwd || process.cwd()
|
|
202
202
|
const failedOnly = options.failedOnly
|
|
203
|
+
const trigger =
|
|
204
|
+
options.trigger ||
|
|
205
|
+
(options.crossModule
|
|
206
|
+
? 'cross-module'
|
|
207
|
+
: options.security
|
|
208
|
+
? 'security-boundary'
|
|
209
|
+
: options.migration
|
|
210
|
+
? 'schema-migration'
|
|
211
|
+
: undefined)
|
|
203
212
|
|
|
204
213
|
// Filter for relevant source or test files
|
|
205
214
|
const relevantFiles = files.filter((f) => {
|
|
@@ -207,8 +216,19 @@ export function resolveTestSlice(files = [], options = {}) {
|
|
|
207
216
|
return SOURCE_EXTENSIONS.has(ext) || TEST_EXTENSIONS.has(ext) || f.includes('.test.')
|
|
208
217
|
})
|
|
209
218
|
|
|
210
|
-
// 1. If
|
|
219
|
+
// 1. If an explicit escalation trigger is present and repo has a suite selector, escalate (Issue #444)
|
|
211
220
|
const repoScript = findRepoSliceScript(cwd)
|
|
221
|
+
if (trigger && repoScript) {
|
|
222
|
+
return {
|
|
223
|
+
command: repoScript.command,
|
|
224
|
+
type: 'package-suite-escalation',
|
|
225
|
+
selection: `package suite (escalation trigger: ${trigger})`,
|
|
226
|
+
files: relevantFiles,
|
|
227
|
+
scopeJustification: `Escalated from local slice due to ${trigger}`,
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
// 2. If repo has a predefined focused script and multiple files changed, prefer it
|
|
212
232
|
if (repoScript && (relevantFiles.length === 0 || relevantFiles.length > 2)) {
|
|
213
233
|
return {
|
|
214
234
|
command: repoScript.command,
|
|
@@ -299,6 +319,16 @@ export function executeTestSlice(slicePlan, options = {}) {
|
|
|
299
319
|
const passLines = output.split('\n').filter((line) => /✔|PASS|passed/i.test(line))
|
|
300
320
|
const targets = Math.max(1, passLines.length)
|
|
301
321
|
|
|
322
|
+
const validationScope =
|
|
323
|
+
options.validationScope ||
|
|
324
|
+
(slicePlan.type === 'package-suite-escalation'
|
|
325
|
+
? 'package_suite'
|
|
326
|
+
: slicePlan.type === 'repo-selector'
|
|
327
|
+
? 'package_suite'
|
|
328
|
+
: 'focused_slice')
|
|
329
|
+
const pendingValidation =
|
|
330
|
+
options.pendingValidation || 'none (CI gates deferred to repository pipeline)'
|
|
331
|
+
|
|
302
332
|
const receipt = {
|
|
303
333
|
status: isPass ? 'PASS' : 'FAIL',
|
|
304
334
|
command: slicePlan.command,
|
|
@@ -306,11 +336,13 @@ export function executeTestSlice(slicePlan, options = {}) {
|
|
|
306
336
|
durationSec,
|
|
307
337
|
durationMs,
|
|
308
338
|
selection: slicePlan.selection,
|
|
339
|
+
validationScope,
|
|
340
|
+
pendingValidation,
|
|
309
341
|
exitCode: result.status,
|
|
310
342
|
output: isPass ? output.trim().split('\n').slice(-5).join('\n') : output,
|
|
311
343
|
}
|
|
312
344
|
|
|
313
|
-
const summaryLine = `**tests:** [${receipt.status}] \`${receipt.command}\` (targets: ${receipt.targets}, duration: ${receipt.durationSec}s, selection: ${receipt.selection})`
|
|
345
|
+
const summaryLine = `**tests:** [${receipt.status}] \`${receipt.command}\` (targets: ${receipt.targets}, duration: ${receipt.durationSec}s, selection: ${receipt.selection})\n**validation_scope:** ${validationScope}\n**pending_validation:** ${pendingValidation}`
|
|
314
346
|
|
|
315
347
|
return { ...receipt, summaryLine }
|
|
316
348
|
}
|
package/skills-lock.json
CHANGED
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"src/skills/tdd-with-agents/references/advanced-testing-patterns.md": "4aac82748bb670a61d67732168f8a265d5e66895a9183029e3da03de8e024788",
|
|
35
35
|
"src/skills/tdd-with-agents/references/testing-by-layer.md": "545291301661e57d846b2db2acca1edb1219a102dce4aad7e0c3cc1a250b570a",
|
|
36
36
|
"src/skills/tdd-with-agents/SKILL.md": "107495b0473a561dd570d2c25420329d68712776524a736ccc415171f7aa6c00",
|
|
37
|
-
"src/skills/test-slicing/SKILL.md": "
|
|
37
|
+
"src/skills/test-slicing/SKILL.md": "3d6f78719ee7d426f8082fd703c26a0433804c60fd3cd181d3a6886c4e94075b",
|
|
38
38
|
"src/skills/verification-planning/SKILL.md": "6a3c6cb5bd5076862d369885bf0b3ba086b625495fe7a42f3f5116d07b470f3e",
|
|
39
39
|
"src/skills/visual-review-pipeline/references/findings-schema.md": "776511757c0d8387fab232fced8ac9ce031a03f62b6ca539e3c38b0d45035c8e",
|
|
40
40
|
"src/skills/visual-review-pipeline/references/workflow-steps.md": "13796a32076dd4d04d37a50927169929ba44a332302bd98f72ec61482ceedc09",
|
package/src/agents/aphrodite.md
CHANGED
|
@@ -18,6 +18,7 @@ permission:
|
|
|
18
18
|
"*": deny
|
|
19
19
|
todowrite: allow
|
|
20
20
|
todoread: allow
|
|
21
|
+
execute: allow
|
|
21
22
|
mcp_tools:
|
|
22
23
|
pantheon-resources: all
|
|
23
24
|
pantheon-memory: [memory_search]
|
|
@@ -90,7 +91,8 @@ You are a frontend implementation specialist. You BUILD UI. You do NOT design ar
|
|
|
90
91
|
|
|
91
92
|
### Before Implementation
|
|
92
93
|
1. Inspect relevant component/test/API files directly using `grep`, `glob`, and `read`; when broad or unfamiliar discovery materially reduces risk, send the discovery need to Zeus for routing
|
|
93
|
-
2. Read relevant frontend standards; load `skill: visual-review-pipeline`
|
|
94
|
+
2. Read relevant frontend standards; load `skill: visual-review-pipeline`
|
|
95
|
+
3. When the handoff brief names an installed skill (or relevant project skill exists in `.opencode/skills/` or `.agents/skills/`), read its `SKILL.md` before writing code only when visual behavior changed
|
|
94
96
|
3. Plan component/data flow when scope or risk warrants it; do not require a design phase for a bounded fix
|
|
95
97
|
4. For a supplied image/screenshot, use the original reference and Zeus's visual notes as acceptance context; call `vision_describe` if the image is addressable but not directly visible. One pass per image: `vision_describe` for visual review, `vision_ocr` only when text extraction is the goal — never two vision calls on the same screenshot (each call is real gateway spend). Inspect the current state first and preserve unrelated existing work—do not delete or revert it just to match the reference unless that replacement is explicitly in scope.
|
|
96
98
|
- Investigate beyond the assigned context only when necessary to resolve the task or when broader discovery materially reduces risk; verify changed behavior proportionally to its scope and risk, using focused checks for bounded changes and broader checks only when integration boundaries or risk warrant them.
|
package/src/agents/apollo.md
CHANGED
package/src/agents/athena.md
CHANGED
package/src/agents/demeter.md
CHANGED
|
@@ -16,6 +16,7 @@ permission:
|
|
|
16
16
|
"*": deny
|
|
17
17
|
todowrite: allow
|
|
18
18
|
todoread: allow
|
|
19
|
+
execute: allow
|
|
19
20
|
mcp_tools:
|
|
20
21
|
pantheon-resources: all
|
|
21
22
|
pantheon-memory: [memory_search]
|
|
@@ -81,6 +82,7 @@ A child session has a parent and must not dispatch another Pantheon agent. Inspe
|
|
|
81
82
|
### Before Migration
|
|
82
83
|
1. Inspect relevant schema/migrations directly; ask Zeus to route any needed broad discovery to @apollo when the schema is broad or unfamiliar enough that parallel discovery reduces risk
|
|
83
84
|
2. Read the relevant model/migration context to understand relationships
|
|
85
|
+
3. When a skill is specified in the brief or exists in `.opencode/skills/` (e.g. database/ORM conventions), read its `SKILL.md` before generating migrations
|
|
84
86
|
3. Plan migration: what changes, impact on existing data, rollback strategy
|
|
85
87
|
|
|
86
88
|
### Migration Development (TDD)
|
package/src/agents/gaia.md
CHANGED
package/src/agents/hephaestus.md
CHANGED
package/src/agents/hermes.md
CHANGED
|
@@ -17,6 +17,7 @@ permission:
|
|
|
17
17
|
apollo: allow
|
|
18
18
|
todowrite: allow
|
|
19
19
|
todoread: allow
|
|
20
|
+
execute: allow
|
|
20
21
|
mcp_tools:
|
|
21
22
|
pantheon-resources: all
|
|
22
23
|
pantheon-memory: [memory_search]
|
|
@@ -163,7 +164,7 @@ See `skill: tdd-with-agents` for the full TDD cycle.
|
|
|
163
164
|
|
|
164
165
|
## Implementation & Verification Workflow
|
|
165
166
|
|
|
166
|
-
1. **Focused Context**: Inspect targeted files directly using `grep`, `glob`, and `read`.
|
|
167
|
+
1. **Focused Context**: Inspect targeted files directly using `grep`, `glob`, and `read`. When the brief specifies a skill (or a relevant project skill exists in `.opencode/skills/`), **read its `SKILL.md` first** before implementing.
|
|
167
168
|
2. **Implementation**: Implement clean async endpoints and services using Pydantic schemas, dependency injection, and parameterized queries.
|
|
168
169
|
3. **Verification**: Run focused unit tests via `bash` using test slicing (e.g. `pytest tests/test_item.py -k test_create -q --tb=short`). Never run full unbounded repository suites during implementation loops.
|
|
169
170
|
4. **Dependencies**: Use modern stdlib equivalents (`zoneinfo`, `tomllib`) where applicable; pin stable LTS versions.
|
package/src/agents/iris.md
CHANGED
package/src/agents/mnemosyne.md
CHANGED
package/src/agents/nyx.md
CHANGED
package/src/agents/prometheus.md
CHANGED
package/src/agents/talos.md
CHANGED