pantheon-opencode 1.7.0 → 2.0.0-beta.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 (168) hide show
  1. package/AGENTS.global.md +2 -2
  2. package/AGENTS.md +3 -3
  3. package/CHANGELOG.md +64 -60
  4. package/README.md +52 -45
  5. package/README.pt-BR.md +19 -19
  6. package/bin/pantheon-init.mjs +11 -48
  7. package/package.json +9 -13
  8. package/plugin.json +2 -2
  9. package/pyproject.toml +1 -1
  10. package/scripts/build-agents-md.mjs +7 -6
  11. package/scripts/{check-plugin-v2-coverage.mjs → check-plugin-coverage.mjs} +7 -7
  12. package/scripts/{decision-router-v2-budget.mjs → decision-router-budget-gates.mjs} +1 -1
  13. package/scripts/{decision-router-v2-egress.mjs → decision-router-egress.mjs} +1 -1
  14. package/scripts/decision-router.mjs +2 -2
  15. package/scripts/docs-media.mjs +1 -1
  16. package/scripts/doctor.mjs +225 -136
  17. package/scripts/install/behavior-overrides.bundle.mjs +123 -0
  18. package/scripts/install/{v2-capabilities.mjs → capabilities.mjs} +7 -7
  19. package/scripts/install/config-migration.mjs +60 -253
  20. package/scripts/install/file-inventory.mjs +6 -4
  21. package/scripts/install/interactive.mjs +1 -1
  22. package/scripts/install/opencode-state.mjs +13 -12
  23. package/scripts/install/opencode-version.mjs +97 -162
  24. package/scripts/install/opencode.mjs +271 -428
  25. package/scripts/install/plan.mjs +1 -9
  26. package/scripts/install/plugin.mjs +19 -35
  27. package/scripts/install/shared.mjs +40 -1
  28. package/scripts/package-evidence.mjs +1 -4
  29. package/scripts/probe-pantheon-cost.mjs +1 -1
  30. package/scripts/reconcile.mjs +5 -7
  31. package/scripts/release-gates.mjs +22 -61
  32. package/scripts/setup-v2-config.mjs +10 -8
  33. package/scripts/setup.mjs +12 -22
  34. package/scripts/sync-tui.mjs +9 -17
  35. package/scripts/{test-opencode-v2-sandbox.sh → test-opencode-sandbox.sh} +9 -9
  36. package/scripts/update-skills-lock.mjs +24 -12
  37. package/scripts/update.mjs +17 -1
  38. package/scripts/validate-routing.mjs +79 -4
  39. package/scripts/validate-sandbox-install.mjs +3 -3
  40. package/skills-lock.json +25 -8
  41. package/src/agents/zeus.md +1 -0
  42. package/src/pantheon/behavior-overrides.ts +191 -0
  43. package/src/pantheon/{v2-bounded-read.ts → bounded-read.ts} +1 -1
  44. package/src/pantheon/cost-command.ts +1 -1
  45. package/src/pantheon/{v2-decision-contracts.ts → decision-contracts.ts} +3 -3
  46. package/src/pantheon/{v2-decision-points → decision-points}/p1-agent.ts +3 -3
  47. package/src/pantheon/{v2-decision-points → decision-points}/p10-claims.ts +2 -2
  48. package/src/pantheon/{v2-decision-points → decision-points}/p11-catalog.ts +2 -2
  49. package/src/pantheon/{v2-decision-points → decision-points}/p2-skill.ts +3 -3
  50. package/src/pantheon/{v2-decision-points → decision-points}/p3-complexity.ts +6 -6
  51. package/src/pantheon/{v2-decision-points → decision-points}/p4-memory.ts +2 -2
  52. package/src/pantheon/{v2-decision-points → decision-points}/p5-themis-verify.ts +2 -2
  53. package/src/pantheon/{v2-decision-points → decision-points}/p6-council.ts +3 -3
  54. package/src/pantheon/{v2-decision-points → decision-points}/p7-loop.ts +5 -5
  55. package/src/pantheon/{v2-decision-points → decision-points}/p8-guardrail.ts +2 -2
  56. package/src/pantheon/{v2-decision-points → decision-points}/p9-memory-compaction.ts +2 -2
  57. package/src/pantheon/{v2-decision-points.ts → decision-points.ts} +5 -5
  58. package/src/pantheon/{v2-decision-policy.ts → decision-policy.ts} +2 -2
  59. package/src/pantheon/{v2-decision-prompt-surface.ts → decision-prompt-surface.ts} +3 -3
  60. package/src/pantheon/{v2-decision-registry.ts → decision-registry.ts} +10 -13
  61. package/src/pantheon/{v2-decision-resource-ids.ts → decision-resource-ids.ts} +1 -1
  62. package/src/pantheon/{v2-decision-shadow.ts → decision-shadow.ts} +1 -1
  63. package/src/pantheon/{v2-decision-telemetry.ts → decision-telemetry.ts} +1 -1
  64. package/src/pantheon/{v2-execute-after.ts → execute-after.ts} +4 -4
  65. package/src/pantheon/goal-store.ts +7 -0
  66. package/src/pantheon/{v2-hook-engine.ts → hook-engine.ts} +3 -3
  67. package/src/pantheon/jev-decision-tool.ts +3 -3
  68. package/src/pantheon/jev-decisions.ts +12 -6
  69. package/src/pantheon/jev-escalation.ts +6 -6
  70. package/src/pantheon/jev-quality-score.ts +2 -2
  71. package/src/pantheon/jev-rank-verify.ts +2 -2
  72. package/src/pantheon/jev-risk-gate.ts +4 -4
  73. package/src/pantheon/local-decision-agents.ts +1 -1
  74. package/src/pantheon/local-decision-router.ts +1 -1
  75. package/src/pantheon/local-decision-tool.ts +2 -2
  76. package/src/pantheon/local-orchestration.ts +1 -1
  77. package/src/pantheon/model-command.ts +1 -1
  78. package/src/pantheon/{v2-vision.ts → native-vision.ts} +12 -15
  79. package/src/pantheon/pantheon-decision-catalog.ts +12 -0
  80. package/src/pantheon/{v2-shell-hooks.ts → shell-hooks.ts} +4 -4
  81. package/src/pantheon/{v2-tools.ts → tools.ts} +4 -4
  82. package/src/pantheon/{v2-unsupported.d.mts → unsupported.d.mts} +3 -3
  83. package/src/pantheon/{v2-unsupported.mjs → unsupported.mjs} +8 -8
  84. package/src/pantheon/update-notifier.ts +101 -0
  85. package/src/pantheon/vision-local.ts +12 -3
  86. package/src/pantheon/vision.ts +120 -2
  87. package/src/{plugin-v2 → plugin}/index.ts +7 -7
  88. package/src/plugin.ts +2875 -500
  89. package/src/plugins/hook-runner.ts +3 -3
  90. package/src/plugins/tui/dist/server.d.ts +23 -9
  91. package/src/plugins/tui/dist/server.d.ts.map +1 -1
  92. package/src/plugins/tui/dist/server.js +25 -12
  93. package/src/plugins/tui/dist/server.js.map +1 -1
  94. package/src/plugins/tui/dist/tui.d.ts +1023 -494
  95. package/src/plugins/tui/dist/tui.d.ts.map +1 -1
  96. package/src/plugins/tui/dist/tui.js +4841 -2066
  97. package/src/plugins/tui/dist/tui.js.map +1 -1
  98. package/src/plugins/tui/{index-v2.ts → index.ts} +1 -1
  99. package/src/plugins/tui/package-lock.json +2 -42
  100. package/src/plugins/tui/package.json +4 -10
  101. package/src/plugins/tui/src/cost-data.ts +1 -1
  102. package/src/plugins/tui/src/index.tsx +4222 -2822
  103. package/src/plugins/tui/src/pantheon-settings-state.ts +111 -0
  104. package/src/plugins/tui/src/pantheon-settings.tsx +236 -0
  105. package/src/plugins/tui/src/server.ts +23 -10
  106. package/src/plugins/tui/src/update-notice.ts +86 -0
  107. package/src/plugins/tui/tsconfig.typecheck.json +1 -1
  108. package/src/plugins/tui/tsdown.config.ts +3 -5
  109. package/src/plugins/tui/tui.ts +1 -2
  110. package/src/routing.yml +36 -0
  111. package/src/skills/README.md +16 -1
  112. package/src/skills/artifact-management/SKILL.md +10 -67
  113. package/src/skills/artifact-management/references/artifact-templates.md +71 -0
  114. package/src/skills/auto-continue/SKILL.md +10 -0
  115. package/src/skills/code-review-checklist/SKILL.md +11 -44
  116. package/src/skills/code-review-checklist/references/review-checklists.md +54 -0
  117. package/src/skills/instruction-forge/SKILL.md +57 -0
  118. package/src/skills/instruction-forge/references/agents-md-doctrine.md +50 -0
  119. package/src/skills/instruction-forge/references/eval-doctrine.md +37 -0
  120. package/src/skills/instruction-forge/references/skill-doctrine.md +62 -0
  121. package/src/skills/memory-bank/SKILL.md +11 -90
  122. package/src/skills/memory-bank/references/anti-patterns.md +33 -0
  123. package/src/skills/memory-bank/references/product-adoption.md +19 -0
  124. package/src/skills/memory-bank/references/storage-model.md +21 -0
  125. package/src/skills/memory-bank/references/structure-and-frequency.md +44 -0
  126. package/src/skills/reflect/SKILL.md +1 -0
  127. package/src/skills/session-goal/SKILL.md +7 -54
  128. package/src/skills/session-goal/references/goal-format.md +26 -0
  129. package/src/skills/session-goal/references/session-reuse.md +44 -0
  130. package/src/skills/tdd-with-agents/SKILL.md +11 -101
  131. package/src/skills/tdd-with-agents/references/advanced-testing-patterns.md +58 -0
  132. package/src/skills/tdd-with-agents/references/testing-by-layer.md +60 -0
  133. package/src/skills/visual-review-pipeline/SKILL.md +11 -120
  134. package/src/skills/visual-review-pipeline/references/findings-schema.md +49 -0
  135. package/src/skills/visual-review-pipeline/references/workflow-steps.md +111 -0
  136. package/scripts/hooks/log-session-start.sh +0 -48
  137. package/scripts/hooks/validate-post-conditions.sh +0 -21
  138. package/scripts/hooks/validate-talos-scope.sh +0 -50
  139. package/scripts/hooks/validate-tool-safety.sh +0 -49
  140. package/src/pantheon/goal-loop.ts +0 -314
  141. package/src/pantheon/idle-continuation.ts +0 -52
  142. package/src/pantheon/todo-preserve.ts +0 -301
  143. package/src/pantheon/tool-ceiling.ts +0 -159
  144. package/src/pantheon/v2-bridge.ts +0 -153
  145. package/src/plugin-v2.ts +0 -2954
  146. package/src/plugins/pantheon-hooks.ts +0 -1433
  147. package/src/plugins/tui/dist/server-v2.d.ts +0 -30
  148. package/src/plugins/tui/dist/server-v2.d.ts.map +0 -1
  149. package/src/plugins/tui/dist/server-v2.js +0 -33
  150. package/src/plugins/tui/dist/server-v2.js.map +0 -1
  151. package/src/plugins/tui/dist/tui-v2.d.ts +0 -1039
  152. package/src/plugins/tui/dist/tui-v2.d.ts.map +0 -1
  153. package/src/plugins/tui/dist/tui-v2.js +0 -4597
  154. package/src/plugins/tui/dist/tui-v2.js.map +0 -1
  155. package/src/plugins/tui/src/index-v2.tsx +0 -4496
  156. package/src/plugins/tui/src/server-v2.ts +0 -28
  157. package/src/plugins/tui/tui-v2.ts +0 -2
  158. /package/src/pantheon/{v2-decision-budget.ts → decision-budget.ts} +0 -0
  159. /package/src/pantheon/{v2-decision-egress.ts → decision-egress.ts} +0 -0
  160. /package/src/pantheon/{v2-decision-events.ts → decision-events.ts} +0 -0
  161. /package/src/pantheon/{v2-decision-heuristic.ts → decision-heuristic.ts} +0 -0
  162. /package/src/pantheon/{v2-decision-premises.ts → decision-premises.ts} +0 -0
  163. /package/src/pantheon/{v2-decision-rank.ts → decision-rank.ts} +0 -0
  164. /package/src/pantheon/{v2-decision-verify.ts → decision-verify.ts} +0 -0
  165. /package/src/pantheon/{v2-delegation-enforce.ts → delegation-policy.ts} +0 -0
  166. /package/src/pantheon/{v2-model-overrides.ts → model-overrides.ts} +0 -0
  167. /package/src/pantheon/{v2-native-decisions.ts → native-decisions.ts} +0 -0
  168. /package/src/plugins/tui/src/{opencode-v2.d.ts → opencode.d.ts} +0 -0
package/AGENTS.global.md CHANGED
@@ -1,7 +1,7 @@
1
1
  <!-- pantheon:generated:begin — Pantheon-managed region; regenerated on install/upgrade, never edit inside -->
2
2
  <!-- Generated by scripts/build-agents-md.mjs — do not edit directly. -->
3
3
  <!-- Source of truth: src/instructions/*.instructions.md + the static sections in this script. -->
4
- <!-- pantheon:agents-md v2 artifact=global generated-at=2026-11-04T19:23:07-03:00 sha=ad9f855 -->
4
+ <!-- pantheon:agents-md v2 artifact=global generated-at=2026-11-08T08:28:27-03:00 sha=7a311be -->
5
5
 
6
6
  # Pantheon Agent System — OpenCode
7
7
 
@@ -27,7 +27,7 @@
27
27
 
28
28
  # Agent Instructions
29
29
 
30
- Shared rules from `src/instructions/*.instructions.md`, identical for OpenCode V1 and V2 (V2 ignores `instructions`). Repo-specific setup stays in that project's AGENTS.md, so no rule loads twice; agent-scoped rules live only in the matching prompt.
30
+ Shared rules from `src/instructions/*.instructions.md`, embedded here because the OpenCode 2.x host ignores the `instructions` config key. Repo-specific setup stays in that project's AGENTS.md, so no rule loads twice; agent-scoped rules live only in the matching prompt.
31
31
 
32
32
  <!-- Source: src/instructions/agent-return-format.instructions.md -->
33
33
  ## Agent Return Format
package/AGENTS.md CHANGED
@@ -1,7 +1,7 @@
1
1
  <!-- pantheon:generated:begin — Pantheon-managed region; regenerated on install/upgrade, never edit inside -->
2
2
  <!-- Generated by scripts/build-agents-md.mjs — do not edit directly. -->
3
3
  <!-- Source of truth: project sections in scripts/build-agents-md.mjs. -->
4
- <!-- pantheon:agents-md v2 artifact=project generated-at=2026-11-04T19:23:07-03:00 sha=ad9f855 -->
4
+ <!-- pantheon:agents-md v2 artifact=project generated-at=2026-11-08T08:28:27-03:00 sha=7a311be -->
5
5
 
6
6
  # Pantheon — Repository Setup
7
7
 
@@ -9,6 +9,7 @@
9
9
 
10
10
  Setup: [INSTALLATION.md](docs/INSTALLATION.md).
11
11
 
12
+ - Requires a supported host: OpenCode 2.x (the V1 contract was removed in 2.0).
12
13
  - Test: focused checks by default; `npm test` for CI/release or broad/high-risk changes
13
14
  - Lint: `npm run lint`
14
15
 
@@ -19,12 +20,11 @@ Valide a instalação global COMO UM USUÁRIO REAL no sandbox `~/pantheon-sandbo
19
20
  - Rodar: `bash ~/pantheon-sandbox/run-test.sh` (MCPs, doctor, TUI)
20
21
  - Regra para agentes: valide instalação global (npm pack, `init`, MCPs, hooks) no sandbox — NUNCA no ambiente de dev
21
22
  - Descarte: `rm -rf ~/pantheon-sandbox`
22
- - Detalhes: `~/pantheon-sandbox/README.md`
23
23
 
24
24
  ## Worktrees
25
25
 
26
26
  - Nunca crie worktrees dentro do projeto principal; use `<project-parent>/.pantheon-worktrees/<basename-do-repo>/<task>`.
27
- - `.pantheon/workflows/` e `.pantheon/worktrees/` não são o padrão para worktrees.
27
+ - worktrees não vivem dentro de `.pantheon/`.
28
28
 
29
29
  ## Conventions
30
30
 
package/CHANGELOG.md CHANGED
@@ -7,93 +7,97 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
7
7
 
8
8
  ## [v1.7.0] - 2026-11-07
9
9
 
10
- ## 🆕 What's New
11
- - **Typed decision router with a real budget**: delegation, skills, ORDER (top-K), rank (≤20), verify (evidence + UNVERIFIABLE band) and review modes — every call budgeted, reconciled, and ~$0.000025 apiece.
12
- - **J1 risk gate with a ladder**: off / shadow / warn / enforce — high-risk tool calls demand EXPLICIT human approval (hash-pinned, 15-min TTL), never silently executed or bypassed.
13
- - **agent-forge**: forge a new OpenCode agent on demand — interview, canonical draft, confirm, project/user scope.
14
- - **Skill discovery with a trust cascade**: canonical Anthropic catalog → skills.sh → raw GitHub, ranked by Jev order; installation stays in YOUR hands.
15
- - **prompt-refinery in three tiers**: clear requests pass intact; vague ones get a silent internal adjust (≤15 lines); the full contract is `>>`-gated.
16
- - **The roster modernized**: nyx/chaos restored, agent descriptions aligned to the catalog, PT-BR delegations fed by the agent-scoped fallback.
17
- - **Local router debt paid**: gate influence (GATE_OPEN), artifact-management reachable, dimension polarity documented.
18
- - **Setup**: decision-layer extras ship pre-checked; the installer heals the stale agent-source poison in BOTH configs (.json + .jsonc).
10
+ - **Typed decision router with a real budget**: delegation, skills, ORDER, rank, verify and review modes — budgeted, reconciled, ~$0.000025 per call.
11
+ - **J1 risk gate with a ladder**: off / shadow / warn / enforce — high-risk calls demand explicit human approval, never bypassed.
12
+ - **agent-forge**: forge an OpenCode agent on demand — interview, draft, confirm, write to project or user scope.
13
+ - **Skill discovery with a trust cascade**: Anthropic catalog → skills.sh → raw GitHub; Jev ranks; you install.
14
+ - **prompt-refinery in three tiers**: clear requests pass; vague ones get a silent internal adjust; full contract is `>>`-gated.
19
15
  - **Last version supporting the OpenCode V1 contract (1.19.x)** — the next minor targets OpenCode 2.x only.
20
16
 
21
- ### 🐞 Field bugs dead
22
- - "Agent not found: zeus" (cwd-relative source poison, both configs healed)
23
- - N4 USAGE_UNRECONCILED 100% (dead — field-verified reconcile)
24
- - The dead-route holds freezing budgets (released with schema v4 archive)
25
- - The TUI footer version drift (release gate now enforces the dist stamp)
17
+ ### Added
26
18
 
19
+ - **routing** — `mode: "order"` on `pantheon_jev_decide`: real top-K ordering of 2-4 candidates with a per-candidate fit score (an ordinal on the 2..10 rubric, never a probability).
20
+ - **routing** — `mode: "verify"` accepts optional `state` evidence the claims are judged against; verdicts PASS / UNVERIFIABLE / FAIL with BLOCK fail-closed on missing or refused answers.
21
+ - **routing** — rank accepts up to 20 candidates (typesafe_rank contract) and `CANDIDATE_INVALID` names the accepted range.
22
+ - **routing** — the input envelope is enforced on EVERY path (explicit, presets, review, rank, verify): schemaVersion required, unknown keys rejected with the exact cause.
23
+ - **routing** — review accepts criteria objects (`{id, description}`) alongside strings; refusals carry the `CRITERIA_SHAPE` detail.
24
+ - **routing** — `CALLER_NOT_ALLOWED` names the remedy: allowlist via `PANTHEON_JEV_SPECIALIST_CALLERS` or route through Zeus.
25
+ - **skills** — `agent-forge`: forge an OpenCode agent on demand — interview, canonical draft, confirm, write to project or user scope; never overwrites.
26
+ - **skills** — prompt-refinery in three tiers with the trust-cascade discovery ranking.
27
+ - **install** — decision-layer extras (J1/J3 shadow gates, specialist callers) ship pre-checked in the interactive setup.
27
28
 
28
- ### 🆕 O que é a 1.7.0
29
+ ### Changed
29
30
 
30
- Primeira minor da linha 1.7: orquestração completa com decisão tipada, gates de
31
- segurança com aprovação humana, e ecossistema de skills com descoberta
32
- consciente de custo. **Esta é a ÚLTIMA versão compatível com o contrato
33
- OpenCode V1 (1.19.x)** — a partir da próxima minor, a linha alvo é OpenCode 2.x.
31
+ - **routing** — the J1 escalation ladder: off / shadow / warn / enforce via `PANTHEON_J1_RISK_SCORE`, with `PANTHEON_J1_ENFORCE_THRESHOLD` (default 0.8).
32
+ - **routing** — enforce denies a high-risk call with the HANDOFF CONTRACT: the agent presents the refused call for your manual decision; your approval mints a hash-pinned, TTL-bounded pass.
33
+ - **routing** — `CALLER_NOT_ALLOWED` names the remedy (allowlist via `PANTHEON_JEV_SPECIALIST_CALLERS` or route through Zeus).
34
+ - **skills** — the discovery ladder ranks candidates with Jev `mode: "order"` and documents the trust tiers; `mattpocock/skills` referenced for the GitHub tier.
35
+ - **agents** — nyx back to observability & cost analytics (chaos/fuzz secondary); prometheus without the observability words; mnemosyne and talos descriptions aligned to the catalog.
36
+ - **agents** — plan-persistence contract: Athena returns the plan, Zeus persists PLAN.md.
37
+ - **install** — decision-layer extras ship pre-checked; the installer heals the stale agent-source poison in BOTH configs (.json + .jsonc), repairing orphan commas.
38
+ - **docs** — README with mermaid diagrams (escalation ladder, refine tiers, trust cascade); COMPATIBILITY table updated for the 1.7.x line.
34
39
 
35
- ### Added — Jev (roteador de decisão)
40
+ ### Deprecated
36
41
 
37
- - **`mode: "order"`**: ordenação real de 2-4 candidatos com score por candidato (o rank escolhe vencedor; o order classifica a shortlist; score é ORDINAL na rubrica 2..10, nunca probabilidade).
38
- - **`mode: "verify"` com evidência**: envelope aceita `state` opcional que vira o texto-base do julgamento; vereditos PASS (>0.65) / UNVERIFIABLE (0.35-0.65) / FAIL (<0.35); ausente/recusado = BLOCK fail-closed.
39
- - **Rank até 20 candidatos** (contrato typesafe_rank) com o range nomeado na recusa (`RANK_CANDIDATE_COUNT_RANGE`).
40
- - **Envelope enforced em TODOS os caminhos** (explícito, presets, review, rank, verify): schemaVersion exigido, chaves desconhecidas rejeitadas, com `detail` exato por causa.
41
- - **Review aceita critérios-objeto** (`{id, description}`) além de strings; recusa com `CRITERIA_SHAPE` detalhado.
42
- - **`CALLER_NOT_ALLOWED` ensina o remédio**: `PANTHEON_JEV_SPECIALIST_CALLERS` ou rotear via Zeus.
43
- - Descrições de agentes nas choices do delegation (o viés "none com confiança alta" em tarefa clara morreu: live 5/5).
42
+ - **OpenCode V1 contract (1.19.x)** — supported through this release, deprecated afterward: the next minor targets OpenCode 2.x only.
44
43
 
45
- ### Added — J1 (gate de risco) com escada de escalada
44
+ ### Removed
46
45
 
47
- - **off / shadow / warn / enforce** via `PANTHEON_J1_RISK_SCORE` (on = shadow, retrocompatível).
48
- - **enforce**: chamada de risco alto (≥ threshold configurável) é NEGADA com o **contrato de handoff**: o agente apresenta a chamada ao usuário para decisão MANUAL — sem executar, sem contornar; aprovações positivas via tool question mintam passe hash-pinned com TTL.
49
- - Gate indisponível nunca bloqueia (fail-open documentado: budget morto não bricka shells).
46
+ - **The lexical skills prefilter** — replaced by the full-catalog offer (the filter dropped the exact skill the state described).
47
+ - **The Console Jev free-variant route** and the legacy PR+SHA beta-version scheme.
50
48
 
51
- ### Added — skills e ecossistema
49
+ ### Fixed
52
50
 
53
- - **`agent-forge`**: cria agentes OpenCode sob demanda — entrevista, rascunho canônico, confirmação, gravação em escopo projeto/global, nunca sobrescreve.
54
- - **prompt-refinery em 3 níveis**: pedido claro passa intacto; o sinal determinístico dispara o AJUSTE MÍNIMO interno (≤15 linhas, silencioso); o contrato completo de 6 seções é EXCLUSIVO do prefixo `>>`. Perguntas de bloqueio pela tool `question` nativa.
55
- - **Descoberta de skills com cascata de confiança**: catálogo canônico Anthropic → skills.sh (parser K/M corrigido) → GitHub cru; ranking por Jev `mode: "order"`; instalação SEMPRE pelo usuário.
51
+ - **routing** — "Agent not found: zeus": the installer heals the stale cwd-relative agent-source field in both configs (root cause of the vanished roster).
52
+ - **routing** — N4 USAGE_UNRECONCILED 100%: dead — field-verified reconcile on the OpenRouter route.
53
+ - **routing** — the dead-route holds freezing budgets: released with the schema v4 archive.
54
+ - **routing** — D1/D2 of the local router: gateStatus influences the decision (GATE_OPEN); artifact-management reachable via material-requirement.
55
+ - **tui** — the version embed ships at the release version (the package gate now fails a stale TUI dist).
56
+ - **doctor** — recognizes the installer's own V2 shape (`{ package, options }`).
56
57
 
57
- ### Added — governança e setup
58
+ ### Security
58
59
 
59
- - **Setup com decision layer ligada por padrão**: J1/J3 shadow + chamadores especialistas pré-marcados (desmarcáveis).
60
- - **Heal do campo `source` cwd-relativo** nos dois configs (`.json` e `.jsonc`) — a causa raiz do "Agent not found".
61
- - **`test:ci` prefere o venv do repo** — o tier Python roda os pins, não o sistema.
62
- - **Gate de release**: o dist da TUI precisa carregar a versão da release — rodapé mentiroso não publica mais.
60
+ - The input envelope is closed on every path; hostile-prose scans cover criteria, claims and candidates; gate messages never echo tool input; approvals are hash-pinned to the exact refused call.
63
61
 
64
- ### Fixed
62
+ ---
65
63
 
66
- - **N4 (`USAGE_UNRECONCILED 100%`)**: morto — reconciliação verificada em campo na rota OpenRouter.
67
- - **"Agent not found: zeus"**: causa raiz curada (campo `source` cwd-relativo no config) + repair de vírgulas órfãs no heal do jsonc.
68
- - **D1/D2 do roteador local**: gateStatus influencia a decisão (`GATE_OPEN`); artifact-management alcançável via material-requirement.
69
- - **TUI**: dist rebuilt — o carimbo de versão acompanha a release (gate novo no workflow).
70
- - Doctor reconhece o shape V2 do installer (`{ package, options }`).
71
- - Verify: PASS com evidência no state (0.96) — o defeito "palpite sem lastro" da beta.13 fechado com evidência.
64
+ ## [Unreleased]
72
65
 
73
- ### Changed
66
+ <!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
67
+ move this section to a versioned entry and reset the template below. -->
74
68
 
75
- - **Refino determinístico**: o roteador local marca `refineRecommended` por regras de texto puro (multi-concern sem critérios; PT+EN; one-liners nunca) — zero Jev, zero custo de modelo na decisão de refinar.
76
- - **nyx de volta à identidade observabilidade/custo** (chaos/fuzz como secundário); prometheus sem as palavras de observabilidade; TUI dist no carimbo da release.
77
- - **full-catalog no skills mode** — o prefilter lexical não derruba mais a skill exata que o estado descreve.
69
+ ## [v2.0.0-beta.1] - 2026-11-08
78
70
 
79
- ### Security
71
+ ### Added
80
72
 
81
- - Envelope fechado em todos os caminhos; hostile-scan no criteria/claims/candidates; never echo de input nas mensagens de gate; aprovação hash-pinned por chamada exata.
73
+ - **skills** — progressive disclosure across the corpus: `references/` + Routing tables, 120-line core budget, lock pins every reference; instruction-forge doctrine skill
74
+ - **routing** — named-behavior overrides: registry in routing.yml, pure loader, installer skip/replace, doctor validation with --fix quarantine
75
+ - **validate** — structural instruction evals (tests/eval) in the regular node tier; the secret-mask parity pins the single TypeScript copy
76
+ - **install** — native plugin-add happy path (`opencode plugin add pantheon-opencode`); npx init demoted to the 1.x migration path
77
+ - **routing** — Jev choice ceiling 32 with reserved host-skill slots (host skills always ride, field report beta.15)
78
+ - **tui** — `/pantheon-settings` window (palette: `Pantheon: Settings`): keyboard-first toggles for the runtime gates, writing the global `pantheon-overrides.json` the installer and doctor consume
82
79
 
83
- ### Compatibility
80
+ ### Changed
84
81
 
85
- - **Última versão com suporte ao contrato OpenCode V1 (1.19.x)** — a próxima minor alvo é OpenCode 2.x apenas. V2 continua o alvo principal desta linha.
82
+ - **plugin** — one generation, canonical names: src/plugin.ts, decision-* modules, tui/server TUI, PANTHEON_* env vars
83
+ - **installer** — the probe must confirm OpenCode 2.x before any write; the singular plugin key is legacy cleanup; version-gate tests speak the refusal contract
84
+ - **doctor** — named-behavior override validation (check K) with --fix quarantine; the report names its source database
86
85
 
87
- ---
86
+ ### Fixed
88
87
 
89
- ## [Unreleased]
88
+ - **vision** — temp-dir reconciliation: restart orphans in `pantheon-vision` become visible to the LRU disk cap again, and crash strays (`.tmp-<pid>`) are swept age-guarded
90
89
 
91
- <!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
92
- move this section to a versioned entry and reset the template below. -->
90
+ ### Removed
91
+
92
+ - **plugin** — the OpenCode V1 contract (1.19.x hosts): V1 plugin, bridge, hooks, goal-loop lifecycle, tool-ceiling, presets application
93
+ - **validate** — the v1-permission canary proofs and the dual-generation test branches
93
94
 
95
+ ### Security
96
+
97
+ - vision-local mime detection linearized (js/polynomial-redos); budget child scripts pass data via argv (js/bad-code-sanitization); the egress endpoint assertion parses URLs
94
98
  ## [v1.7.0-beta.1] - 2026-11-07
95
99
 
96
- ## 🆕 What's New — a linha 1.7 abre
100
+ ## 🆕 What's New
97
101
  - **`mode: "order"`** no Jev: ordenação real de 2-4 candidatos com score por candidato (rank escolhe vencedor; order classifica a shortlist).
98
102
  - **J1 approval gate** com escada off/shadow/warn/enforce: chamada de risco alto exige APROVAÇÃO EXPLÍCITA do usuário (hash-pinned, TTL 15min) — nunca contorno.
99
103
  - **`agent-forge`**: cria um agente OpenCode sob demanda — entrevista, rascunho canônico, confirmação, gravação em escopo projeto/global.
package/README.md CHANGED
@@ -73,17 +73,21 @@ flowchart LR
73
73
 
74
74
  ## Start in 2 minutes
75
75
 
76
- Requirements: [OpenCode](https://opencode.ai/docs/) **1.19.x** (V1) or **OpenCode
77
- 2.x** (V2), and Node.js **>=26.4.0** for the CLI and tooling. **OpenCode 2.0.22
78
- is known broken**; see [Compatibility](docs/COMPATIBILITY.md).
76
+ Requirements: [OpenCode](https://opencode.ai/docs/) **2.x** and Node.js
77
+ **>=26.4.0** for the CLI and tooling. **OpenCode 2.0.22 is known broken**; see
78
+ [Compatibility](docs/COMPATIBILITY.md).
79
79
 
80
- From the project where you want to use Pantheon:
80
+ From anywhere (global, all projects) or inside a project:
81
81
 
82
82
  ```bash
83
- npx pantheon-opencode init
83
+ opencode plugin add pantheon-opencode
84
+ # or pin it: opencode plugin add pantheon-opencode@<version>
84
85
  opencode
85
86
  ```
86
87
 
88
+ Restart OpenCode when prompted. `npx pantheon-opencode init` remains only
89
+ as the OpenCode 1.x migration path and an opt-in project scaffolding tool.
90
+
87
91
  Direct `init` uses the same component defaults in TTY and headless runs:
88
92
  `agents`, `skills`, `instructions`, `commands`, and `plugins`. `runtime` and
89
93
  `prompts` are opt-in. A TTY run selects components and target, shows a preview,
@@ -91,18 +95,18 @@ then asks once for final authorization (default **no**). Without a TTY, `init`
91
95
  is preview-only unless `--yes` explicitly authorizes the apply; `--yes` skips
92
96
  prompts but still prints the preview and checks for drift.
93
97
 
94
- `npm run setup` is a separate repository setup wrapper. On detected OpenCode V2
95
- it reviews the global config before installer init: legacy permission rules can
96
- be migrated after explicit review. Config migration and installer changes are
97
- preflighted before one final authorization; `--yes` alone does not authorize
98
- setup writes, and headless/CI setup remains preview-only. Direct
99
- `npx pantheon-opencode init` does not run that V2 config-migration review. See
100
- the [installation guide](docs/INSTALLATION.md) for layer handling, conflict
101
- choices, backups, and recovery.
102
- Existing native V2 `permissions` arrays remain authoritative. Unsafe MCP
98
+ `npm run setup` is a separate repository setup wrapper. On a detected
99
+ OpenCode 2.x host it reviews the global config before installer init: legacy
100
+ permission rules can be migrated after explicit review. Config migration and
101
+ installer changes are preflighted before one final authorization; `--yes`
102
+ alone does not authorize setup writes, and headless/CI setup remains
103
+ preview-only. Direct `npx pantheon-opencode init` does not run that
104
+ config-migration review. See the [installation guide](docs/INSTALLATION.md)
105
+ for layer handling, conflict choices, backups, and recovery.
106
+ Existing native `permissions` arrays remain authoritative. Unsafe MCP
103
107
  wildcard policies and ineffective `ask` rules require explicit resolution;
104
108
  third-party flat MCP entries in `opencode.jsonc` must be converted to
105
- `mcp.servers` or removed before V2 setup.
109
+ `mcp.servers` or removed before setup.
106
110
 
107
111
  Global `init` and `setup` use `$XDG_CONFIG_HOME/opencode` when
108
112
  `XDG_CONFIG_HOME` is absolute; otherwise they use `~/.config/opencode`.
@@ -118,9 +122,8 @@ When you ask for a plan, Athena returns it to Zeus, who displays it in the main
118
122
  conversation before asking for approval — never as a plan hidden in a child
119
123
  agent's conversation.
120
124
 
121
- Restart OpenCode after installing or changing the plugin generation. The
122
- installer selects one generation per installation; V1 and V2 plugins are never
123
- registered together.
125
+ Restart OpenCode after installing or changing the plugin. Pantheon registers a
126
+ single plugin; a host never loads two Pantheon plugins.
124
127
 
125
128
  Installer flags, exit codes, saved plans, backup and restore, uninstall,
126
129
  reconcile, and MCP pins are in the [installation guide](docs/INSTALLATION.md).
@@ -131,7 +134,7 @@ see [Quick Start](docs/QUICKSTART.md).
131
134
 
132
135
  - **14 specialized agents** with one orchestrator, implementation specialists,
133
136
  a quality gate, and supporting roles.
134
- - **22 skills** and reusable instructions for planning, building, reviewing,
137
+ - **23 skills** and reusable instructions for planning, building, reviewing,
135
138
  and documenting work.
136
139
  - **5 local MCP servers** for project memory, persistence, resources, confined
137
140
  script execution, and vision.
@@ -146,7 +149,7 @@ see [Quick Start](docs/QUICKSTART.md).
146
149
  [router reference](docs/reference/local-decision-router.md) and the
147
150
  [Native Decisions (Jev)](docs/reference/native-decisions.md).
148
151
  - **An optional TUI** with a dispatch sidebar block and a full-width
149
- `/dispatch` panel. The V2 sidebar keeps the Pantheon version, the active
152
+ `/dispatch` panel. The sidebar keeps the Pantheon version, the active
150
153
  preset/source, git state, and a `Context` block (tokens, a percent gauge,
151
154
  `$<spent> spent`, and a muted `cache <n>% · <n.n> tok/s` line); the native
152
155
  prompt footer keeps its own line, and Pantheon only appends
@@ -154,7 +157,11 @@ see [Quick Start](docs/QUICKSTART.md).
154
157
  version changes since the last TUI start, a one-time dismissable
155
158
  "What's new" dialog lists that version's highlights from the shipped
156
159
  changelog — once per version, `esc`/`q` dismisses; see
157
- [What's new window](docs/reference/whats-new.md). The installer
160
+ [What's new window](docs/reference/whats-new.md). `/pantheon-settings`
161
+ (also `Pantheon: Settings` in the command palette) opens the settings
162
+ window: `up`/`down` selects a Pantheon runtime gate, `enter` toggles it —
163
+ writing the global `pantheon-overrides.json` the installer and doctor
164
+ consume — `tab` flips to the About page, `esc`/`q` closes. The installer
158
165
  selects the `plugins` component by default; in interactive setup you can
159
166
  change the component selection. A component-scoped install includes the TUI
160
167
  only when `plugins` is selected. The TUI ships no quota panel: for provider
@@ -166,7 +173,7 @@ see [Quick Start](docs/QUICKSTART.md).
166
173
  Vision requests to OpenCode Zen require a valid active session and are rejected
167
174
  before image fetching or model-catalog lookup when the session is missing or
168
175
  invalid. The Python vision MCP keeps its local metadata/OCR fallback when no
169
- gateway credential is configured. In the V2 plugin, an explicit Vision model
176
+ gateway credential is configured. In the plugin, an explicit Vision model
170
177
  pin that is unavailable or ineligible returns an actionable error rather than
171
178
  silently switching models; remove the pin to use automatic model discovery.
172
179
 
@@ -177,24 +184,24 @@ routine child summaries stay in the handoff. See [Memory](docs/MEMORY.md).
177
184
 
178
185
  ## Compatibility
179
186
 
180
- OpenCode **1.19.x** (V1 plugin) and **OpenCode 2.x** (V2 plugin) are supported.
181
- **OpenCode 2.0.22 is known broken.** **1.7.0 is the LAST version supporting the
182
- OpenCode V1 contract** — the next minor line targets OpenCode 2 only.
187
+ OpenCode **2.x** is supported. **OpenCode 2.0.22 is known broken.** **2.0
188
+ removes the OpenCode V1 contract entirely** — 1.7.x was the last line with V1
189
+ support.
183
190
 
184
191
  The support policy, the known-broken exception, and the verified-version
185
192
  evidence have exactly one home: [Compatibility](docs/COMPATIBILITY.md).
186
193
 
187
- ### V2 plugin options
194
+ ### Plugin options
188
195
 
189
- The OpenCode V2 host hands a plugin its `options` only from the object form of
190
- the entry. `init` writes that form for the optional per-request context pruner;
191
- memory retrieval stays an explicit `memory_search` MCP call.
196
+ The host hands a plugin its `options` only from the object form of the entry.
197
+ `init` writes that form for the optional per-request context pruner; memory
198
+ retrieval stays an explicit `memory_search` MCP call.
192
199
 
193
200
  ```json
194
201
  {
195
202
  "plugins": [
196
203
  {
197
- "package": "/path/to/pantheon-opencode/src/plugin-v2",
204
+ "package": "/path/to/pantheon-opencode/src/plugin",
198
205
  "options": {
199
206
  "context_pruner": { "enabled": true }
200
207
  }
@@ -217,7 +224,7 @@ one-time warning in the hook log, so a typo cannot silently change behaviour. Ru
217
224
  `npx pantheon-opencode doctor` to see whether the installed entry can receive
218
225
  options at all. An old `memory_injection` option may remain in an existing
219
226
  config because user options are preserved, but the plugin no longer reads it.
220
- Full rules: [OpenCode V2](docs/opencode-v2.md) and [Memory](docs/MEMORY.md).
227
+ Full rules: [OpenCode 2.x](docs/opencode.md) and [Memory](docs/MEMORY.md).
221
228
 
222
229
  ## Delegation
223
230
 
@@ -252,9 +259,9 @@ historical/inactive, and legacy consent, caps, period, provider selection, or
252
259
  credentials cannot activate it. Native child-session dispatch remains separate.
253
260
 
254
261
  The one native egress surface is the Zeus-only `pantheon_jev_decide` tool,
255
- available on hosts that expose the V2.2.5 native Decisions API; its full gate
262
+ available on hosts that expose the 2.2.5 native Decisions API; its full gate
256
263
  chain, routes, and settlement rules are documented once in
257
- [V2 native Decisions](docs/reference/native-decisions.md). An opt-in second
264
+ [Native Decisions (Jev)](docs/reference/native-decisions.md). An opt-in second
258
265
  consumer of that chain, the J1 risk-score shadow gate, fires one bounded
259
266
  native decision per write/execute tool call behind `PANTHEON_J1_RISK_SCORE`
260
267
  (off by default, zero overhead when off): the request carries no user content
@@ -324,26 +331,26 @@ test-only credential, verifies a local recommendation marker, and verifies zero
324
331
  native Decisions or global `fetch` calls. This is an offline regression check of
325
332
  that hook, not a claim about unexercised network paths or a live-provider test.
326
333
  Measured surface coverage is
327
- reported honestly rather than implied: P7 runs behind `PANTHEON_V2_P7_LOOP` with
334
+ reported honestly rather than implied: P7 runs behind `PANTHEON_P7_LOOP` with
328
335
  an **advisory** execution cap (never described as enforcement), P2 is
329
336
  **advisory-only** (an empirical no-op on the default path), P9 was measured on
330
337
  top-level **and child** sessions with `reason:"overflow"` still unmeasured, and
331
338
  P8 is **advisory: not activatable by measurement** — its declared rules match no
332
339
  delivered permission payload, so it narrows nothing (PROBE-F).
333
340
 
334
- ### The V2 decision layer is declared in full and wired in part
341
+ ### The decision layer is declared in full and wired in part
335
342
 
336
- The V2 decision layer declares eleven integration points (P1–P11) over three
343
+ The decision layer declares eleven integration points (P1–P11) over three
337
344
  decision primitives — `ask`, `rank`, and `verify` — and a deterministic policy
338
345
  that decides which point may run. **Seven of the eleven have a production call
339
346
  site: two behind flags that are off by default, five in shadow.**
340
347
 
341
348
  - **P7 (loop)** is wired to `session.execution.succeeded` behind
342
- `PANTHEON_V2_P7_LOOP`, which is off. It writes each observation to an
349
+ `PANTHEON_P7_LOOP`, which is off. It writes each observation to an
343
350
  in-memory, bounded telemetry collector that the plugin never reads back and
344
351
  exposes only to tests, so "records" here does not mean an operator-visible log.
345
352
  - **P8 (guardrail)** is wired to `permission.evaluate` behind
346
- `PANTHEON_V2_P8_GUARDRAIL`, which is off. C8 is closed **by measurement**, and
353
+ `PANTHEON_P8_GUARDRAIL`, which is off. C8 is closed **by measurement**, and
347
354
  the measurement is negative: PROBE-F delivered 24 real `permission.evaluate`
348
355
  events and every declared rule matched none of them (a valid `action` token and
349
356
  a top-level `sessionID` are always present), the host resolves an unrecognised
@@ -404,7 +411,7 @@ What the layer does **not** do today, stated as measured rather than implied:
404
411
  on the default path, because the host sends `prompt.skills` absent. Effective
405
412
  project-skill filtering was cancelled by measurement, not emulated, and no
406
413
  token reduction is claimed.
407
- - **P7 (loop) is behind `PANTHEON_V2_P7_LOOP`, off by default, and does not
414
+ - **P7 (loop) is behind `PANTHEON_P7_LOOP`, off by default, and does not
408
415
  enforce loop limits.** It counts executions and writes an `effect: none`
409
416
  observation to an in-memory collector that nothing reads back. Its
410
417
  12-execution cap is **advisory**: no measured host surface signals a new user
@@ -434,14 +441,14 @@ What the layer does **not** do today, stated as measured rather than implied:
434
441
  gain or loss in retrieval or tokens is claimed in either direction.
435
442
 
436
443
  Calibration that was run: the offline harness
437
- (`npx tsx tests/pantheon/v2-decision-harness.test.ts`) executed 264 synthetic
444
+ (`npx tsx tests/pantheon/decision-harness.test.ts`) executed 264 synthetic
438
445
  cases — 132 normal, 66 refusal, 66 adversarial — across the eleven points, with
439
446
  24 cases per point and the suite asserting at least 20 cases, 5 refusals and 5
440
447
  adversarial cases per point. All 264 cases passed on 2026-10-31. This harness is
441
448
  the only place all eleven points are exercised in one run, but it imports no
442
449
  adapter module: it iterates the registry and exercises the shared primitives,
443
450
  while the adapters are covered by their per-point suites
444
- (`v2-decision-p1.test.ts` … `v2-decision-p11.test.ts`). Passing it says nothing
451
+ (`decision-p1.test.ts` … `decision-p11.test.ts`). Passing it says nothing
445
452
  about whether a point is registered in a host.
446
453
  The harness measures contracts (admission, refusal, shadow no-op, telemetry
447
454
  redaction, offline discipline, registry integrity), **not** token use, quality,
@@ -455,10 +462,10 @@ recorded in the [router reference](docs/reference/local-decision-router.md).
455
462
  | [Installation](docs/INSTALLATION.md) | [Architecture](docs/ARCHITECTURE.md) |
456
463
  | [Quick Start](docs/QUICKSTART.md) | [MCP](docs/MCP.md) · [MCP tools](docs/mcp-tools.md) |
457
464
  | [Upgrading](docs/UPGRADING.md) | [Memory](docs/MEMORY.md) |
458
- | [Compatibility](docs/COMPATIBILITY.md) | [OpenCode V2](docs/opencode-v2.md) |
465
+ | [Compatibility](docs/COMPATIBILITY.md) | [OpenCode 2.x](docs/opencode.md) |
459
466
  | [Agents & Skills](docs/agents/README.md) | [Platforms](docs/PLATFORMS.md) |
460
467
  | [Release Process](docs/RELEASING.md) | [Branch Protection](docs/BRANCH-PROTECTION.md) |
461
- | [Model Routing](docs/reference/model-routing.md) | [Local Decision Router](docs/reference/local-decision-router.md) · [V2 Native Decisions](docs/reference/native-decisions.md) · [Offline Evaluation Protocol](docs/reference/offline-evaluation.md) · [Env Vars](docs/reference/env-vars.md) · [Code Mode](docs/reference/code-mode.md) |
468
+ | [Model Routing](docs/reference/model-routing.md) | [Local Decision Router](docs/reference/local-decision-router.md) · [Native Decisions (Jev)](docs/reference/native-decisions.md) · [Offline Evaluation Protocol](docs/reference/offline-evaluation.md) · [Env Vars](docs/reference/env-vars.md) · [Code Mode](docs/reference/code-mode.md) |
462
469
  | [Contributing](CONTRIBUTING.md) | [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) |
463
470
 
464
471
  Memory writes through `pantheon-memory` are serialized, and failed writes are
@@ -474,7 +481,7 @@ usage (reports stay local — they carry bounded session excerpts), and the
474
481
  agent usage policies derived from it are documented in
475
482
  [MCP tools](docs/mcp-tools.md).
476
483
 
477
- The release install gate's tool canary loads the installed tarball's V2 plugin
484
+ The release install gate's tool canary loads the installed tarball's plugin
478
485
  entry under OpenCode 2.0.30 and verifies `hashline_edit` registration, Code Mode
479
486
  visibility, and a bounded edit in an isolated project. It does not prove npm
480
487
  publication or compatibility with untested host versions; details are in the
@@ -500,7 +507,7 @@ latest published changes.
500
507
  ## What's new
501
508
 
502
509
  See the [GitHub release](https://github.com/ils15/pantheon-opencode/releases)
503
- and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.6.1.
510
+ and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.7.0.
504
511
 
505
512
  ## Contribute
506
513
 
package/README.pt-BR.md CHANGED
@@ -36,17 +36,22 @@ o que importou. Você continua no controle de cada decisão e de cada merge.
36
36
 
37
37
  ## Comece em 2 minutos
38
38
 
39
- Requisitos: [OpenCode](https://opencode.ai/docs/) **1.19.x** (V1) ou **OpenCode
40
- 2.x** (V2), e Node.js **>=26.4.0** para a CLI e as ferramentas. **OpenCode 2.0.22
41
- tem falha conhecida**; veja [Compatibilidade](docs/COMPATIBILITY.md).
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).
42
42
 
43
- No projeto onde você quer usar o Pantheon:
43
+ Em qualquer lugar (global, todos os projetos) ou dentro de um projeto:
44
44
 
45
45
  ```bash
46
- npx pantheon-opencode init
46
+ opencode plugin add pantheon-opencode
47
+ # ou fixe a versão: opencode plugin add pantheon-opencode@<versão>
47
48
  opencode
48
49
  ```
49
50
 
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.
54
+
50
55
  Depois descreva o resultado desejado:
51
56
 
52
57
  ```text
@@ -57,9 +62,8 @@ Quando você pede um plano, Athena devolve o plano a Zeus, que o exibe na
57
62
  conversa principal antes de pedir aprovação — nunca como um plano escondido na
58
63
  conversa de um agente filho.
59
64
 
60
- Reinicie o OpenCode depois de instalar ou trocar a geração do plugin. O
61
- instalador seleciona uma geração por instalação; plugins V1 e V2 nunca são
62
- registrados juntos.
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.
63
67
 
64
68
  Flags do instalador, códigos de saída, planos salvos, backup e restore,
65
69
  desinstalação, reconcile e pins de MCP estão no
@@ -71,7 +75,7 @@ apenas — `init` → reiniciar → `/dispatch` → primeiro resultado — veja
71
75
 
72
76
  - **14 agentes especializados**, com um orquestrador, especialistas de
73
77
  implementação, um gate de qualidade e papéis de apoio.
74
- - **22 skills** e instruções reutilizáveis para planejar, construir, revisar e
78
+ - **23 skills** e instruções reutilizáveis para planejar, construir, revisar e
75
79
  documentar.
76
80
  - **5 servidores MCP locais** para memória de projeto, persistência, recursos,
77
81
  execução confinada de scripts e visão.
@@ -85,7 +89,7 @@ apenas — `init` → reiniciar → `/dispatch` → primeiro resultado — veja
85
89
  [referência do roteador](docs/reference/local-decision-router.md) e o
86
90
  [Decisions nativas (Jev)](docs/reference/native-decisions.md).
87
91
  - **Uma TUI opcional**, com bloco de dispatch na sidebar e painel `/dispatch`
88
- em largura total. A sidebar V2 mantém a versão do Pantheon, o preset/fonte
92
+ em largura total. A sidebar mantém a versão do Pantheon, o preset/fonte
89
93
  ativos, o estado do git e um bloco `Context` (tokens, medidor de percentual,
90
94
  `$<gasto> gastos` e uma linha mutada `cache <n>% · <n.n> tok/s`); o rodapé
91
95
  nativo do prompt segue intacto, e o Pantheon só acrescenta
@@ -105,17 +109,13 @@ Veja [Memória](docs/MEMORY.md).
105
109
 
106
110
  ## Compatibilidade
107
111
 
108
- OpenCode **1.19.x** (plugin V1) e **OpenCode 2.x** (plugin V2) são suportados.
109
- **OpenCode 2.0.22 tem falha conhecida.** A partir da 1.7, a linha abandona o
110
- contrato V1 e mira apenas o OpenCode 2.
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.
111
115
 
112
116
  A política de suporte, a exceção conhecida e a evidência de versões verificadas
113
117
  têm um único lar: [Compatibilidade](docs/COMPATIBILITY.md).
114
118
 
115
- A matriz de suporte, o piso de Node e as notas de host/build, as regras de
116
- geração OpenCode 1.x/2.x, a posição de fim de vida e os problemas conhecidos têm
117
- um único lar: [Compatibilidade](docs/COMPATIBILITY.md).
118
-
119
119
  ## Delegação
120
120
 
121
121
  O Pantheon delega pelo motor nativo de sessões filhas do host: `subagent` no
@@ -144,7 +144,7 @@ O modelo de delegação, a matriz chamador/alvo e os gates de aprovação estão
144
144
  | [Instalação](docs/INSTALLATION.md) | [Arquitetura](docs/ARCHITECTURE.md) |
145
145
  | [Início rápido](docs/QUICKSTART.md) | [MCP](docs/MCP.md) · [Ferramentas MCP](docs/mcp-tools.md) |
146
146
  | [Atualização](docs/UPGRADING.pt-BR.md) | [Memória](docs/MEMORY.md) |
147
- | [Compatibilidade](docs/COMPATIBILITY.md) | [OpenCode V2](docs/opencode-v2.md) |
147
+ | [Compatibilidade](docs/COMPATIBILITY.md) | [OpenCode 2.x](docs/opencode.md) |
148
148
  | [Agentes e Skills](docs/agents/README.md) | [Plataformas](docs/PLATFORMS.md) |
149
149
  | [Processo de release](docs/RELEASING.md) | [Proteção de branch](docs/BRANCH-PROTECTION.md) |
150
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) |
@@ -165,7 +165,7 @@ para as mudanças publicadas mais recentes.
165
165
  ## Novidades
166
166
 
167
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.6.0.
168
+ e o [CHANGELOG.md](CHANGELOG.md) para as mudanças da 1.7.0.
169
169
 
170
170
  ## Contribua
171
171