pantheon-opencode 2.0.0-beta.6 → 2.0.0-rc.1

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.
Files changed (58) hide show
  1. package/AGENTS.global.md +6 -1
  2. package/AGENTS.md +1 -1
  3. package/CHANGELOG.md +45 -0
  4. package/README.md +169 -510
  5. package/README.pt-BR.md +177 -149
  6. package/bin/pantheon-init.mjs +1 -1
  7. package/commands/pantheon-deepwork.md +6 -1
  8. package/commands/pantheon.md +10 -5
  9. package/package.json +1 -1
  10. package/plugin.json +2 -2
  11. package/prompts/orchestrate-with-zeus.prompt.md +82 -290
  12. package/prompts/subtask.prompt.md +1 -1
  13. package/pyproject.toml +1 -1
  14. package/scripts/doctor.mjs +27 -11
  15. package/scripts/hooks/format-multi-language.sh +30 -48
  16. package/scripts/jev-live-probe.mjs +1 -1
  17. package/scripts/release-gates.mjs +19 -5
  18. package/scripts/skill-search.mjs +27 -3
  19. package/scripts/test-opencode-sandbox.sh +44 -15
  20. package/scripts/update.mjs +9 -2
  21. package/skills-lock.json +5 -3
  22. package/src/agents/aphrodite.md +2 -0
  23. package/src/agents/apollo.md +8 -206
  24. package/src/agents/athena.md +25 -29
  25. package/src/agents/hermes.md +3 -1
  26. package/src/agents/mnemosyne.md +1 -1
  27. package/src/agents/nyx.md +1 -1
  28. package/src/agents/prometheus.md +0 -203
  29. package/src/agents/talos.md +2 -0
  30. package/src/agents/themis.md +8 -3
  31. package/src/agents/zeus.md +18 -12
  32. package/src/instructions/memory-protocol.instructions.md +4 -0
  33. package/src/instructions/test-economy.instructions.md +1 -0
  34. package/src/instructions/zeus-council-synthesis.instructions.md +13 -1
  35. package/src/pantheon/pantheon-decision-catalog.ts +8 -0
  36. package/src/pantheon/skill-search-tool.ts +193 -0
  37. package/src/pantheon/tools.ts +2 -0
  38. package/src/plugins/tui/dist/tui.d.ts +12 -2
  39. package/src/plugins/tui/dist/tui.d.ts.map +1 -1
  40. package/src/plugins/tui/dist/tui.js +980 -358
  41. package/src/plugins/tui/dist/tui.js.map +1 -1
  42. package/src/plugins/tui/package-lock.json +2 -2
  43. package/src/plugins/tui/package.json +1 -1
  44. package/src/plugins/tui/src/autonomy-state.ts +1 -1
  45. package/src/plugins/tui/src/context-gauge.ts +64 -5
  46. package/src/plugins/tui/src/decision-router-state.ts +49 -2
  47. package/src/plugins/tui/src/index.tsx +25 -3
  48. package/src/plugins/tui/src/pantheon-settings-state.ts +99 -0
  49. package/src/plugins/tui/src/pantheon-settings.tsx +391 -101
  50. package/src/plugins/tui/src/tui-prefs.ts +161 -9
  51. package/src/plugins/tui/src/update-status.ts +27 -8
  52. package/src/routing.yml +9 -0
  53. package/src/skills/README.md +35 -25
  54. package/src/skills/fast-path-execution/SKILL.md +54 -0
  55. package/src/skills/prompt-refinery/SKILL.md +51 -65
  56. package/src/skills/tdd-with-agents/SKILL.md +22 -10
  57. package/src/skills/test-slicing/SKILL.md +56 -0
  58. package/src/skills/verification-planning/SKILL.md +4 -3
package/README.pt-BR.md CHANGED
@@ -1,11 +1,8 @@
1
- <!-- synced-from: README.md @ 0a6a8e2 -->
1
+ <!-- synced-from: README.md -->
2
2
  # Pantheon
3
3
 
4
- **Uma forma mais clara de trabalhar com OpenCode em projetos de software
5
- reais.** O Pantheon reúne planejamento, implementação, revisão e documentação
6
- numa experiência guiada. É um plugin e instalador para OpenCode, feito para
7
- desenvolvedores e equipes que querem estrutura útil sem abrir mão do controle
8
- sobre o próprio código.
4
+ **Uma forma mais clara, rápida e eficiente de trabalhar com OpenCode em projetos de software reais.**
5
+ O Pantheon reúne planejamento, implementação, revisão e documentação numa experiência guiada e otimizada para tokens. É um plugin e instalador para OpenCode feito para desenvolvedores e equipes que querem estrutura útil sem abrir mão de velocidade ou do controle sobre seu código.
9
6
 
10
7
  [English](README.md) ·
11
8
  [Repositório](https://github.com/ils15/pantheon-opencode) · [Licença MIT](LICENSE)
@@ -16,178 +13,209 @@ sobre o próprio código.
16
13
 
17
14
  ## O que é?
18
15
 
19
- O Pantheon é um companheiro do [OpenCode](https://opencode.ai/) que ajuda a ir
20
- de uma ideia a uma mudança revisada. Quatorze agentes especializados
21
- compartilham um único fluxo: planejar, implementar, checar, revisar e registrar
22
- o que importou. Você continua no controle de cada decisão e de cada merge.
16
+ 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.
17
+
18
+ ```mermaid
19
+ flowchart LR
20
+ U["Você"] --> Z["Zeus<br/>orquestrador"]
21
+ Z -->|"delega"| S["14 especialistas<br/>hermes · aphrodite · demeter · themis …"]
22
+ Z -->|"rota ambígua"| J["Jev decision router<br/>tipado · com budget · reversível"]
23
+ J -->|"ordena · classifica · verifica"| S
24
+ S -->|"último recurso"| M["MCP nativo<br/>memória · persistência · visão<br/>code-mode · recursos"]
25
+ Z --> G["J1 risk gate<br/>off / shadow / warn / enforce"]
26
+ G -->|"alto risco"| H["Aprovação humana"]
27
+ ```
28
+
29
+ **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.
30
+
31
+ ```mermaid
32
+ flowchart LR
33
+ R["pedido inicial"] --> T0{"claro e<br/>delimitado?"}
34
+ T0 -->|sim| X["executar diretamente"]
35
+ T0 -->|"vago /<br/>múltiplos tópicos"| T1["Tier 1 — interno<br/>ajuste mínimo ≤15 linhas<br/>(silencioso, sem aprovação)"]
36
+ T1 --> T2q{">> fornecido?"}
37
+ T2q -->|sim| T2["Tier 2 — contrato completo<br/>6 seções, confirmar-ou-ajustar"]
38
+ T2q -->|não| X
39
+ ```
40
+
41
+ **A descoberta de skills segue uma cascata de confiança** — canônicas primeiro, popularidade nunca compensa proveniência:
42
+
43
+ ```mermaid
44
+ flowchart LR
45
+ L["pool instalado<br/>(sempre primeiro)"] -->|"lacuna"| C1["anthropics/skills<br/>canônica"]
46
+ C1 -->|"sem ajuste"| C2["skills.sh<br/>sinal por instalações"]
47
+ C2 -->|"sem ajuste"| C3["GitHub raw<br/>mais ampla, menor confiança"]
48
+ C3 --> J["Jev ordena<br/>os candidatos"]
49
+ J --> P["VOCÊ revisa<br/>e roda o install"]
50
+ ```
23
51
 
24
52
  ## Por que usar?
25
53
 
26
- - **Menos troca de contexto:** planejamento e construção no mesmo fluxo.
27
- - **Mudanças mais deliberadas:** peça revisões e checagens antes de considerar
28
- o trabalho concluído.
29
- - **Um ponto de partida repetível:** o mesmo setup entre projetos e
30
- colaboradores.
31
- - **Você no comando:** o Pantheon apoia seu julgamento; não o substitui.
32
- - **Coordenação na medida:** trabalho delimitado vai para um especialista, que
33
- reúne o contexto necessário. Planejamento, descoberta separada, paralelismo e
34
- revisão entram quando escopo e risco pedem. `/pantheon-deepwork` continua sendo
35
- o fluxo com checkpoints para trabalho pesado em várias fases.
54
+ - **Execução Fast-Track:** Micro-edições delimitadas (<= 2 arquivos, <= 50 linhas) pulam cerimônias pesadas e validam em < 10 segundos.
55
+ - **Fatiamento mandatório de testes (test slicing):** Execução direcionada em submissegundos em vez de rodar suites lentas do repositório inteiro durante loops de desenvolvimento.
56
+ - **Conselho assertivo (`/pantheon`):** Consultas paralelas entre especialistas resolvidas decisivamente via autoridade de domínio e decisões multi-critério JEV sem loops infinitos de debate.
57
+ - **Você no comando:** O Pantheon apoia seu julgamento; ele nunca altera permissões silenciosamente nem executa ações destrutivas sem aprovação.
58
+ - **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`.
36
59
 
37
60
  ## Comece em 2 minutos
38
61
 
39
- Requisitos: [OpenCode](https://opencode.ai/docs/) **2.x** e Node.js
40
- **>=26.4.0** para a CLI e as ferramentas. **OpenCode 2.0.22 tem falha
41
- conhecida**; veja [Compatibilidade](docs/COMPATIBILITY.md).
62
+ Requisitos: [OpenCode](https://opencode.ai/docs/) **2.x** e Node.js **>=26.4.0**. (Veja [Compatibilidade](docs/COMPATIBILITY.md)).
42
63
 
43
- Em qualquer lugar (global, todos os projetos) ou dentro de um projeto:
64
+ ### 1. Instalação
44
65
 
66
+ **Opção A — Adição Rápida de Plugin (Global ou no Projeto):**
45
67
  ```bash
46
68
  opencode plugin add pantheon-opencode
47
- # ou fixe a versão: opencode plugin add pantheon-opencode@<versão>
48
- opencode
69
+ # Ou fixe uma versão específica:
70
+ opencode plugin add pantheon-opencode@2.0.0-rc.1
49
71
  ```
50
72
 
51
- Reinicie o OpenCode quando solicitado. O `npx pantheon-opencode init`
52
- sobrevive apenas como caminho de migração do OpenCode 1.x e ferramenta
53
- opcional de scaffolding de projeto.
73
+ **Opção B — Instalação Global via CLI com Tooling MCP Completo:**
74
+ ```bash
75
+ npm install -g pantheon-opencode@beta
76
+ pantheon-opencode init --yes
77
+ ```
54
78
 
55
- Depois descreva o resultado desejado:
79
+ ### 2. Verificação de Saúde
80
+ ```bash
81
+ pantheon-opencode doctor
82
+ ```
83
+ 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.
56
84
 
57
- ```text
58
- /pantheon Add CSV export to the reports page, including tests and a review.
85
+ ### 3. Atualizando o Pantheon sem Sobrescrever Configurações
86
+ Quando uma nova versão for lançada:
87
+ ```bash
88
+ pantheon-opencode update
59
89
  ```
90
+ 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.**
60
91
 
61
- Quando você pede um plano, Athena devolve o plano a Zeus, que o exibe na
62
- conversa principal antes de pedir aprovação — nunca como um plano escondido na
63
- conversa de um agente filho.
64
-
65
- Reinicie o OpenCode depois de instalar ou trocar o plugin. O Pantheon registra
66
- um único plugin; o host nunca carrega dois plugins Pantheon.
67
-
68
- Flags do instalador, códigos de saída, planos salvos, backup e restore,
69
- desinstalação, reconcile e pins de MCP estão no
70
- [guia de instalação](docs/INSTALLATION.md). Para os primeiros dez minutos
71
- apenas — `init` → reiniciar → `/dispatch` → primeiro resultado — veja o
72
- [Início rápido](docs/QUICKSTART.md).
73
-
74
- ## O que está incluído?
75
-
76
- - **14 agentes especializados**, com um orquestrador, especialistas de
77
- implementação, um gate de qualidade e papéis de apoio.
78
- - **23 skills** e instruções reutilizáveis para planejar, construir, revisar e
79
- documentar.
80
- - **5 servidores MCP locais** para memória de projeto, persistência, recursos,
81
- execução confinada de scripts e visão.
82
- - **Um roteador de decisão seletivo e consultivo**, com resultados locais
83
- estruturados e recomendações por turno quando habilitado. O egress direto
84
- pertencente ao Pantheon é inativo; o egress nativo existe apenas na tool
85
- explícita `pantheon_jev_decide` (só para o Zeus), que chama a API nativa de
86
- Decisions do host (Jev/TypeSafe via OpenCode Console ou modelo configurado)
87
- atrás do consentimento e dos limites de orçamento do usuário — ela nunca
88
- despacha agentes, executa skills ou altera permissões. Veja a
89
- [referência do roteador](docs/reference/local-decision-router.md) e o
90
- [Decisions nativas (Jev)](docs/reference/native-decisions.md).
91
- - **Uma TUI opcional**, com bloco de dispatch na sidebar e painel `/dispatch`
92
- em largura total. A sidebar mantém a versão do Pantheon, o preset/fonte
93
- ativos, o estado do git e um bloco `Context` (tokens, medidor de percentual,
94
- `$<gasto> gastos` e uma linha mutada `cache <n>% · <n.n> tok/s`); o rodapé
95
- nativo do prompt segue intacto, e o Pantheon só acrescenta
96
- `▸<preset> · ✦<n> ativos` enquanto há delegações rodando. A TUI não traz mais
97
- painel de quota: para ver quota e uso de provedores dentro do OpenCode,
98
- instale o plugin comunitário recomendado
99
- [`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota) — veja
100
- [Quota & uso](docs/tui-v2-quota-providers.md). As tools `pantheon_cost` e
101
- `pantheon_model` seguem funcionando sem alterações.
102
-
103
- A memória MCP fica disponível para busca explícita: o coordenador consulta o
104
- histórico uma vez quando ele pode mudar a tarefa e repassa apenas resultados
105
- úteis. Checkpoints de sessão servem para retomadas entre sessões; memória
106
- durável só é gravada quando solicitada ou autorizada. A compactação nativa do
107
- OpenCode resume a conversa atual, sem salvar cada fase em outro MCP.
108
- Veja [Memória](docs/MEMORY.md).
109
-
110
- ## Compatibilidade
111
-
112
- OpenCode **2.x** é suportado. **OpenCode 2.0.22 tem falha conhecida.** A 2.0
113
- remove o contrato V1 do OpenCode por completo — a 1.7.x foi a última linha com
114
- suporte V1.
115
-
116
- A política de suporte, a exceção conhecida e a evidência de versões verificadas
117
- têm um único lar: [Compatibilidade](docs/COMPATIBILITY.md).
118
-
119
- ## Delegação
120
-
121
- O Pantheon delega pelo motor nativo de sessões filhas do host: `subagent` no
122
- runtime raiz relatado pelo usuário, chamado de `task()` na documentação de
123
- host/API. Disponibilidade de ferramenta, suporte a background e observabilidade
124
- de conclusão dependem do runtime; quando a conclusão não é observável, use
125
- dispatch síncrono ou aguarde uma notificação do host.
126
-
127
- Todo dispatch raiz leva um briefing conciso — objetivo, escopo limitado,
128
- entradas relevantes, restrições, formato de retorno esperado e verificação. Os
129
- contratos de retorno são específicos por papel: implementação usa
130
- `## subtask_summary`, investigação devolve achados estruturados, Athena devolve
131
- o plano completo e respostas de conselho usam `## specialist_response`.
132
- Trabalho delegado tem no máximo uma retentativa após falha transitória, e o
133
- Pantheon nunca alega fan-in determinístico ou recuperação de job sem um
134
- mecanismo exposto.
135
-
136
- O modelo de delegação, a matriz chamador/alvo e os gates de aprovação estão em
137
- [Arquitetura](docs/ARCHITECTURE.md) e
138
- [Permissões, Gates e Delegação](docs/PERMISSIONS-QUALITY-DELEGATION.md).
92
+ ---
139
93
 
140
- ## Documentação
94
+ ## Modos de Execução & Fluxo Ótimo
95
+
96
+ O Pantheon equilibra velocidade e rigor através de três modos de execução:
97
+
98
+ ```mermaid
99
+ flowchart TD
100
+ Req["Pedido do Usuário"] --> Size{"Escopo / Risco"}
101
+ Size -->|"≤ 2 arquivos · ≤ 50 linhas<br/>correção / typo / CSS"| Fast["Fast-Track<br/>(Sub-10s · Test Slicing Inline)"]
102
+ 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)"]
103
+ Size -->|"Feature multi-fases<br/>Refatoração pesada · Breaking change"| Deep["Deepwork (/pantheon-deepwork)<br/>(Plano da Athena · Gates de Fase · Checkpoints)"]
104
+ ```
105
+
106
+ ### 1. Fast-Track & Test Slicing (Micro-Edições < 10s)
107
+ Para correções de bugs pontuais, ajustes de estilo ou refatorações localizadas:
108
+ - **Sem cerimônia de planejamento:** Executa diretamente as alterações delimitadas.
109
+ - **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.
110
+ - **Entrega em turno único:** Valida e finaliza em menos de 10 segundos.
141
111
 
142
- | Comece aqui | Aprofunde |
143
- |---|---|
144
- | [Instalação](docs/INSTALLATION.md) | [Arquitetura](docs/ARCHITECTURE.md) |
145
- | [Início rápido](docs/QUICKSTART.md) | [MCP](docs/MCP.md) · [Ferramentas MCP](docs/mcp-tools.md) |
146
- | [Atualização](docs/UPGRADING.pt-BR.md) | [Memória](docs/MEMORY.md) |
147
- | [Compatibilidade](docs/COMPATIBILITY.md) | [OpenCode 2.x](docs/opencode.md) |
148
- | [Agentes e Skills](docs/agents/README.md) | [Plataformas](docs/PLATFORMS.md) |
149
- | [Processo de release](docs/RELEASING.md) | [Proteção de branch](docs/BRANCH-PROTECTION.md) |
150
- | [Roteamento de modelos](docs/reference/model-routing.md) | [Variáveis de ambiente](docs/reference/env-vars.md) · [Code Mode](docs/reference/code-mode.md) |
151
- | [Contribuição](CONTRIBUTING.md) | [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) |
112
+ ### 2. Síntese Assertiva do Conselho (`/pantheon`)
113
+ Ao enfrentar encruzilhadas arquiteturais, avaliações tecnológicas ou trade-offs de segurança:
114
+ ```text
115
+ /pantheon Devemos usar WebSockets ou Server-Sent Events para notificações push em tempo real?
116
+ ```
117
+ - **Despacho Paralelo:** Dispara 2 a 3 especialistas simultaneamente com prompts independentes.
118
+ - **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**:
119
+ - **Segurança / Auth:** `@themis` tem poder de veto sobre propostas vulneráveis.
120
+ - **Banco de Dados / Schema:** `@demeter` tem autoridade técnica sobre consultas e integridade transacional.
121
+ - **Frontend / UX / A11y:** `@aphrodite` rege acessibilidade e ergonomia visual.
122
+ - **Infraestrutura / CI:** `@prometheus` rege limites de runtime, containers e pipelines.
123
+ - **API / Protocolos:** `@hermes` rege conformidade contratual e esquemas de transporte.
124
+ - **Arquitetura / Modularidade:** `@athena` rege desacoplamento e manutenibilidade a longo prazo.
125
+ - **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.
126
+
127
+ ### 3. Deepwork com Checkpoints (`/pantheon-deepwork`)
128
+ Para tarefas complexas com mais de 10 turnos ou distribuídas em várias sessões:
129
+ ```text
130
+ /pantheon-deepwork "Implementar autenticação OAuth2 PKCE"
131
+ ```
132
+ - **Fase 0 (Plano):** Athena mapeia os módulos e devolve o plano completo em Markdown exibido diretamente na conversa principal.
133
+ - **Fase 1 (Descoberta):** Apollo realiza exploração estruturada.
134
+ - **Fases 2–N (Implementação):** Especialistas implementam os módulos em fases paralelas.
135
+ - **Gates de Revisão:** Themis audita cada fase (`PASS` ou `FAIL`).
136
+ - **Resumibilidade:** Progresso salvo em `.pantheon/deepwork/<slug>/`. Retome a qualquer momento com `/pantheon-deepwork --resume <slug>`.
152
137
 
153
- > Os demais documentos são publicados apenas em inglês, que é a fonte canônica.
154
- > Este README e o [guia de atualização](docs/UPGRADING.pt-BR.md) são as duas
155
- > páginas mantidas em português.
138
+ ---
156
139
 
157
- ## Status
140
+ ## Os 14 Agentes Especializados
141
+
142
+ 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`.
143
+
144
+ | Agente | Autoridade de Domínio | Responsabilidades Principais |
145
+ |---|---|---|
146
+ | **@zeus** | Orquestrador Central | Direciona o fluxo, delega tarefas, arbitra decisões do conselho e garante economia de tokens. Nunca implementa código diretamente. |
147
+ | **@athena** | Arquitetura e Planejamento | Planejamento research-first, fronteiras de sistema, LTS e análise de dependências. Plan-only; nunca implementa. |
148
+ | **@hermes** | Backend e APIs | FastAPI, Python assíncrono, backends Node/TypeScript, contratos de API e conformidade de protocolos. |
149
+ | **@aphrodite** | Frontend e UX | React 19, TypeScript estrito, design responsivo, acessibilidade WCAG e CSS moderno. |
150
+ | **@demeter** | Banco de Dados e Persistência | Migrações de schema, otimização de queries, prevenção de queries N+1 e integridade transacional. |
151
+ | **@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. |
152
+ | **@prometheus** | DevOps e Infraestrutura | Docker, pipelines CI/CD, configuração de runtime, abstração de provedores e infra de telemetria. |
153
+ | **@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. |
154
+ | **@apollo** | Batedor de Investigação | Descoberta somente-leitura: buscas paralelas no código e na documentação. Retorna achados estruturados. |
155
+ | **@hephaestus**| Pipelines de IA e RAG | Embeddings, vector stores, engenharia de prompt e pipelines de agentes. |
156
+ | **@gaia** | Sensoriamento e Geoespacial | Sensoriamento remoto, SAR, análise geoespacial e classificação raster ML/DL (somente-leitura). |
157
+ | **@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. |
158
+ | **@mnemosyne** | Banco de Memória do Projeto | Mantém o `.pantheon/memory-bank/` e registra ADRs quando explicitamente solicitado. |
159
+ | **@nyx** | Observabilidade e Telemetria| Rastreamento OpenTelemetry, monitoramento de tokens/custos e profiling de execução. |
158
160
 
159
- Os manifests neste checkout expressam a versão em preparação, não uma publicação
160
- confirmada. Consulte a dist-tag `beta` do npm para saber o que está realmente
161
- publicado. Veja [Compatibilidade](docs/COMPATIBILITY.md) para os hosts
162
- suportados e as [releases](https://github.com/ils15/pantheon-opencode/releases)
163
- para as mudanças publicadas mais recentes.
161
+ ---
164
162
 
165
- ## Novidades
163
+ ## Skills & Ferramental MCP
166
164
 
167
- Veja a [release no GitHub](https://github.com/ils15/pantheon-opencode/releases)
168
- e o [CHANGELOG.md](CHANGELOG.md) para as mudanças da 1.7.0.
165
+ - **Busca de Skills In-Process (`pantheon_skill_search`):** Encontra rapidamente skills locais e do ecossistema aberto sem depender de permissões de shell.
166
+ - **25 Skills de Produção:** Inclui `test-slicing`, `fast-path-execution`, `tdd-with-agents`, `instruction-forge` e `incremental-implementation`.
167
+ - **5 Servidores MCP Locais:**
168
+ - `pantheon-memory`: Memória compartilhada com travas atômicas SQLite.
169
+ - `pantheon-persistence`: Persistência de contexto e arquivos de projeto.
170
+ - `pantheon-resources`: Disponibilização de documentação e recursos locais.
171
+ - `pantheon-code-mode`: Execução confinada de scripts Python.
172
+ - `pantheon-vision`: Análise e inspeção visual diagnóstica de imagens.
173
+ - **Roteador Consultivo de Decisões JEV:** Avalia candidatos (`pantheon_jev_decide`), ordena trade-offs e fornece suporte a decisões multi-critério sem modificar permissões.
169
174
 
170
- ## Contribua
175
+ ---
171
176
 
172
- Ideias, relatos de bugs, melhorias de documentação e contribuições de código são
173
- bem-vindos. Leia o [CONTRIBUTING.md](CONTRIBUTING.md) antes de abrir uma issue ou
174
- pull request. Esse arquivo também define a regra de documentação: um único lar
175
- por fato, com uma lista curta de fatos que não devem ser duplicados.
177
+ ## Configurações & Janela TUI (`/pantheon-settings`)
176
178
 
177
- Em mudanças de código, comece pela verificação relevante mais pequena e amplie
178
- conforme o risco. `npm test` executa a suíte completa do repositório; veja o
179
- [CONTRIBUTING.md](CONTRIBUTING.md) para saber quando usá-la.
179
+ Execute `/pantheon-settings` (ou `Pantheon: Settings` na paleta de comandos) para abrir o painel de configurações:
180
180
 
181
- ## Citação e DOI
181
+ - **Gates & Overrides:** Habilite ou desabilite comportamentos nomeados em tempo real (salvo em `pantheon-overrides.json`).
182
+ - **Presets de Modelos:** Alterne o tier de modelos ativo globalmente ou no projeto.
183
+ - **Modelo de Decisão:** Configure o roteamento local e remoto das decisões JEV.
184
+ - **Atualizações:** Verifique o canal do registro (`beta` / `stable`) e dispare upgrades.
185
+ - **Doctor:** Execute o diagnóstico de saúde do sistema diretamente na interface.
186
+ - **Personalização da TUI:** Ajuste espaçamento (`comfortable` vs `compact`), separadores, estilo das barras de progresso e linhas de contexto.
182
187
 
183
- O Pantheon é distribuído sob a [Licença MIT](LICENSE). Cite o
184
- [DOI de conceito do Zenodo](https://doi.org/10.5281/zenodo.22650136), que sempre
185
- resolve para a release arquivada mais recente; cada release também tem seu
186
- próprio DOI de versão. Os metadados de citação estão em
187
- [CITATION.cff](CITATION.cff).
188
+ ---
188
189
 
189
- Repositório canônico: <https://github.com/ils15/pantheon-opencode>
190
+ ## Documentação
191
+
192
+ | Comece por aqui | Arquitetura e Aprofundamento | Referência e Operações |
193
+ |---|---|---|
194
+ | [Início Rápido](docs/QUICKSTART.md) | [Arquitetura](docs/ARCHITECTURE.md) | [Ferramentas MCP](docs/mcp-tools.md) |
195
+ | [Guia de Instalação](docs/INSTALLATION.md) | [Delegação & Gates](docs/PERMISSIONS-QUALITY-DELEGATION.md) | [Decisões Nativas (Jev)](docs/reference/native-decisions.md) |
196
+ | [Compatibilidade](docs/COMPATIBILITY.md) | [Sistema de Memória](docs/MEMORY.md) | [Roteamento de Modelos](docs/reference/model-routing.md) |
197
+ | [Atualização](docs/UPGRADING.md) | [Integração OpenCode 2.x](docs/opencode.md) | [Changelog](CHANGELOG.md) |
190
198
 
191
199
  ---
192
200
 
193
- [Read in English](README.md)
201
+ ## O Que Há de Novo na v2.0.0-rc.1
202
+
203
+ - **Inauguração da Série Release Candidate:** Orquestração multi-agente pronta para produção no OpenCode 2.x.
204
+ - **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).
205
+ - **Diretiva de Pragmatismo e Anti-Pedantismo:** Diagnósticos seguros autorizados sem burocracia excessiva, eliminando lentidão e morosidade.
206
+ - **TDD em Lote (Batched Suite) e Test-Slicing:** Implementação coesa de módulos completos e execução de testes em menos de 100ms.
207
+ - **Descoberta Proativa de Skills com Cache:** Buscas de skills cacheadas (TTL 24h) e recomendação proativa de ferramentas pelo Zeus.
208
+ - **Scorecard JEV ao Vivo e App Web no Sandbox:** 16/16 cenários aprovados ($0,0000238/decisão) validados com app real no sandbox.
209
+
210
+ Consulte o [CHANGELOG.md](CHANGELOG.md) para o histórico completo de lançamentos.
211
+
212
+ ## Contribuição
213
+
214
+ Ideias, relatórios de bugs e contribuições de código são muito bem-vindos! Por favor, leia [CONTRIBUTING.md](CONTRIBUTING.md) antes de abrir um PR.
215
+
216
+ ## Citação e Licença
217
+
218
+ O Pantheon é software de código aberto sob a [Licença MIT](LICENSE).
219
+ 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).
220
+
221
+ Repositório canônico: <https://github.com/ils15/pantheon-opencode>
@@ -105,7 +105,7 @@ function printUsage() {
105
105
  console.log(
106
106
  ' npx pantheon-opencode decision-router select|enable|consent|caps|period # explicit actions',
107
107
  )
108
- console.log(' npx pantheon-opencode update [--stable] [--allow-prerelease]')
108
+ console.log(' npx pantheon-opencode update [--stable] [--allow-prerelease] [--project]')
109
109
  console.log(
110
110
  ' # Update + re-run init. Default channel is beta; a stable install never jumps to a beta without --allow-prerelease.',
111
111
  )
@@ -30,10 +30,15 @@ Phase 1: DISCOVERY
30
30
 
31
31
  Phase 2-N: IMPLEMENTATION (parallel per phase)
32
32
  └─ @hermes, @aphrodite, @demeter, @hephaestus, @prometheus
33
+ └─ Concurrent Isolation: For 2+ specialists running in parallel, allocate isolated git worktrees via `worktrees` skill:
34
+ `<project-parent>/.pantheon-worktrees/<repo>/deepwork-<slug>-<agent>`
35
+ (prevents file collisions, race conditions, and test runner port conflicts)
33
36
  └─ Output: IMPL-phase-<N>-<agent>.md
34
37
 
35
38
  GATE after each phase:
36
- └─ @themis reviews output → FAIL (fix + resubmit) or PASS (continue)
39
+ └─ @themis reviews output:
40
+ • PASS: Merge worktree/branch, update STATUS.md, advance to next phase.
41
+ • FAIL: Halt advancement. Revert broken edits to phase boundary or dispatch targeted fix subtask to responsible specialist. Never advance on FAIL.
37
42
 
38
43
  Phase FINAL: VERIFICATION
39
44
  └─ @themis full integration review → REVIEW.md
@@ -4,12 +4,17 @@ agent: zeus
4
4
  ---
5
5
  # /pantheon — Council Synthesis
6
6
 
7
- **What:** Dispatches the question to 2-3 specialist agents **in parallel** via `task()`, then synthesizes their responses into a single recommendation with resolved divergences.
8
- **Usage:** `/pantheon <question>`
9
- **When:** Architecture trade-offs, technology selection, security assessments, multi-stakeholder concerns
10
- **Returns:** Structured synthesis with recommendation, confidence level, resolved divergences
7
+ **What:** Dispatches an architectural or high-impact question to 2-3 specialist agents **in parallel**, then synthesizes their perspectives into an assertive, actionable decision with resolved divergences.
8
+ **Usage:** `/pantheon <question>` (add `--research` for a 30s Apollo pre-scan)
9
+ **When:** Architecture trade-offs, technology selection, security reviews, multi-stakeholder decisions. (Never for routine fixes or single-file edits — use Fast-Track instead).
10
+ **Returns:** Structured synthesis with decisive recommendation, confidence level, and clear arbitration.
11
11
 
12
- Dispatch, specialist selection, and synthesis follow the canonical `## Zeus Council Synthesis` protocol (Steps 0–9: precedent fast-path, dispatch, confidence cross-validation, rebuttal, tie-break, Themis audit, persist). Send ALL `task()` calls in a single message; each specialist returns the `## specialist_response` structure from `## Agent Return Format`.
12
+ ### Execution & Arbitration:
13
+ - **Parallel Dispatch:** Dispatches 2-3 specialists in a single turn with independent briefs.
14
+ - **Assertive Arbitration:** Divergences are resolved via **Domain Authority Precedence** (Themis for Security/Auth vetoes, Demeter for DB/Persistence, Aphrodite for UI/A11y, Prometheus for Infra/CI, Hermes for APIs, Athena for Modularity) or **JEV Multi-Criteria Decision** (`pantheon_jev_decide`).
15
+ - **Autonomous & Low-Latency:** Multi-turn debates and rebuttals are avoided unless an unverified factual contradiction exists. Zeus concludes decisively.
16
+
17
+ Dispatch, specialist selection, and synthesis follow the canonical `## Zeus Council Synthesis` protocol. Send ALL specialist calls in a single message; each specialist returns the `## specialist_response` structure from `## Agent Return Format`.
13
18
 
14
19
  ## Question:
15
20
  $ARGUMENTS
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pantheon-opencode",
3
- "version": "2.0.0-beta.6",
3
+ "version": "2.0.0-rc.1",
4
4
  "description": "Multi-agent orchestration for OpenCode \u2014 14 specialized agents, TDD, Themis review gates.",
5
5
  "type": "module",
6
6
  "workspaces": [
package/plugin.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "pantheon",
3
3
  "publisher": "ils15",
4
- "version": "2.0.0-beta.6",
4
+ "version": "2.0.0-rc.1",
5
5
  "displayName": "Pantheon",
6
- "description": "Conductor-Delegate orchestration platform with 14 specialized agents, 23 skills, and OpenCode support.",
6
+ "description": "Conductor-Delegate orchestration platform with 14 specialized agents, 25 skills, and OpenCode support.",
7
7
  "agents": "./src/agents",
8
8
  "skills": "./src/skills",
9
9
  "instructions": "./src/instructions",