pantheon-opencode 1.7.0 → 2.0.0-beta.2

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 (173) hide show
  1. package/AGENTS.global.md +2 -2
  2. package/AGENTS.md +3 -3
  3. package/CHANGELOG.md +85 -59
  4. package/README.md +74 -48
  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 +2870 -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 +5612 -2086
  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/decision-router-state.ts +242 -0
  103. package/src/plugins/tui/src/doctor-state.ts +198 -0
  104. package/src/plugins/tui/src/index.tsx +4222 -2822
  105. package/src/plugins/tui/src/j1-gate-status.ts +85 -0
  106. package/src/plugins/tui/src/pantheon-settings-state.ts +245 -0
  107. package/src/plugins/tui/src/pantheon-settings.tsx +442 -0
  108. package/src/plugins/tui/src/preset-state.ts +143 -0
  109. package/src/plugins/tui/src/server.ts +23 -10
  110. package/src/plugins/tui/src/update-notice.ts +90 -0
  111. package/src/plugins/tui/src/update-status.ts +98 -0
  112. package/src/plugins/tui/tsconfig.typecheck.json +9 -2
  113. package/src/plugins/tui/tsdown.config.ts +3 -5
  114. package/src/plugins/tui/tui.ts +1 -2
  115. package/src/routing.yml +36 -0
  116. package/src/skills/README.md +16 -1
  117. package/src/skills/artifact-management/SKILL.md +10 -67
  118. package/src/skills/artifact-management/references/artifact-templates.md +71 -0
  119. package/src/skills/auto-continue/SKILL.md +10 -0
  120. package/src/skills/code-review-checklist/SKILL.md +11 -44
  121. package/src/skills/code-review-checklist/references/review-checklists.md +54 -0
  122. package/src/skills/instruction-forge/SKILL.md +57 -0
  123. package/src/skills/instruction-forge/references/agents-md-doctrine.md +50 -0
  124. package/src/skills/instruction-forge/references/eval-doctrine.md +37 -0
  125. package/src/skills/instruction-forge/references/skill-doctrine.md +62 -0
  126. package/src/skills/memory-bank/SKILL.md +11 -90
  127. package/src/skills/memory-bank/references/anti-patterns.md +33 -0
  128. package/src/skills/memory-bank/references/product-adoption.md +19 -0
  129. package/src/skills/memory-bank/references/storage-model.md +21 -0
  130. package/src/skills/memory-bank/references/structure-and-frequency.md +44 -0
  131. package/src/skills/reflect/SKILL.md +1 -0
  132. package/src/skills/session-goal/SKILL.md +7 -54
  133. package/src/skills/session-goal/references/goal-format.md +26 -0
  134. package/src/skills/session-goal/references/session-reuse.md +44 -0
  135. package/src/skills/tdd-with-agents/SKILL.md +11 -101
  136. package/src/skills/tdd-with-agents/references/advanced-testing-patterns.md +58 -0
  137. package/src/skills/tdd-with-agents/references/testing-by-layer.md +60 -0
  138. package/src/skills/visual-review-pipeline/SKILL.md +11 -120
  139. package/src/skills/visual-review-pipeline/references/findings-schema.md +49 -0
  140. package/src/skills/visual-review-pipeline/references/workflow-steps.md +111 -0
  141. package/scripts/hooks/log-session-start.sh +0 -48
  142. package/scripts/hooks/validate-post-conditions.sh +0 -21
  143. package/scripts/hooks/validate-talos-scope.sh +0 -50
  144. package/scripts/hooks/validate-tool-safety.sh +0 -49
  145. package/src/pantheon/goal-loop.ts +0 -314
  146. package/src/pantheon/idle-continuation.ts +0 -52
  147. package/src/pantheon/todo-preserve.ts +0 -301
  148. package/src/pantheon/tool-ceiling.ts +0 -159
  149. package/src/pantheon/v2-bridge.ts +0 -153
  150. package/src/plugin-v2.ts +0 -2954
  151. package/src/plugins/pantheon-hooks.ts +0 -1433
  152. package/src/plugins/tui/dist/server-v2.d.ts +0 -30
  153. package/src/plugins/tui/dist/server-v2.d.ts.map +0 -1
  154. package/src/plugins/tui/dist/server-v2.js +0 -33
  155. package/src/plugins/tui/dist/server-v2.js.map +0 -1
  156. package/src/plugins/tui/dist/tui-v2.d.ts +0 -1039
  157. package/src/plugins/tui/dist/tui-v2.d.ts.map +0 -1
  158. package/src/plugins/tui/dist/tui-v2.js +0 -4597
  159. package/src/plugins/tui/dist/tui-v2.js.map +0 -1
  160. package/src/plugins/tui/src/index-v2.tsx +0 -4496
  161. package/src/plugins/tui/src/server-v2.ts +0 -28
  162. package/src/plugins/tui/tui-v2.ts +0 -2
  163. /package/src/pantheon/{v2-decision-budget.ts → decision-budget.ts} +0 -0
  164. /package/src/pantheon/{v2-decision-egress.ts → decision-egress.ts} +0 -0
  165. /package/src/pantheon/{v2-decision-events.ts → decision-events.ts} +0 -0
  166. /package/src/pantheon/{v2-decision-heuristic.ts → decision-heuristic.ts} +0 -0
  167. /package/src/pantheon/{v2-decision-premises.ts → decision-premises.ts} +0 -0
  168. /package/src/pantheon/{v2-decision-rank.ts → decision-rank.ts} +0 -0
  169. /package/src/pantheon/{v2-decision-verify.ts → decision-verify.ts} +0 -0
  170. /package/src/pantheon/{v2-delegation-enforce.ts → delegation-policy.ts} +0 -0
  171. /package/src/pantheon/{v2-model-overrides.ts → model-overrides.ts} +0 -0
  172. /package/src/pantheon/{v2-native-decisions.ts → native-decisions.ts} +0 -0
  173. /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,119 @@ 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]
65
+
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. -->
68
+
69
+ ## [v2.0.0-beta.2] - 2026-11-09
70
+
71
+ ### Added
72
+
73
+ - **tui** — the settings window becomes a sectioned window (`tab` cycles sections): Gates & Overrides, Decision Model, Model Preset, J1 Risk Gate, Updates, Doctor, About
74
+ - **tui** — Decision Model section: enable/disable the decision router live — the runtime re-reads the config on every gated call; egress consent stays CLI-owned and enabling remote candidates without it is refused
75
+ - **tui** — Model Preset section: activate any routing.yml preset globally (atomic write, `.bak` backup); `none` deletes the marker; a project marker wins every runtime candidate list and shows read-only
76
+ - **tui** — J1 Risk Gate status section: ladder mode, enforce threshold, effective gate state — the env-only config is displayed, never written (a file surface is a runtime-plugin change, deferred)
77
+ - **tui** — Updates section: channel classification (prerelease suffix → `beta`), last-check state, and a `Check now` action against the registry dist-tag matching the running channel; a stable install is never advertised a beta
78
+ - **tui** — Doctor section: install-version drift (H2), Node floor, overrides-file validation (K), decision-config health — file-derived checks only; process/network checks stay in `pantheon-opencode doctor`
72
79
 
73
80
  ### Changed
74
81
 
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.
82
+ - **tui** — the typecheck gate points at real files: the old includes referenced deleted V2 entries, so nothing had been type-checked since the rewrite; the settings modules typecheck under the repo's strict settings and update-notice's latent violations are fixed
78
83
 
79
- ### Security
84
+ ### Fixed
80
85
 
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.
86
+ - **tui** — the settings window is closable again: `dialog.clear()` inside the host's dismissal path re-entered the dialog stack and left the window permanent (beta.1 field report)
87
+ - **tui** — overrides state guards: a corrupt global overrides file refuses writes instead of silently dropping the other entries on the next toggle; `replace` entries survive disable (content preserved) and restore on re-enable; project-file entries show a `(project)` marker and are not togglable from the window
82
88
 
83
- ### Compatibility
89
+ &lt;!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
90
+ move this section to a versioned entry and reset the template below. --&gt;
91
+ ## [v2.0.0-beta.1] - 2026-11-08
84
92
 
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.
93
+ ### Added
86
94
 
87
- ---
95
+ - **skills** — progressive disclosure across the corpus: `references/` + Routing tables, 120-line core budget, lock pins every reference; instruction-forge doctrine skill
96
+ - **routing** — named-behavior overrides: registry in routing.yml, pure loader, installer skip/replace, doctor validation with --fix quarantine
97
+ - **validate** — structural instruction evals (tests/eval) in the regular node tier; the secret-mask parity pins the single TypeScript copy
98
+ - **install** — native plugin-add happy path (`opencode plugin add pantheon-opencode`); npx init demoted to the 1.x migration path
99
+ - **routing** — Jev choice ceiling 32 with reserved host-skill slots (host skills always ride, field report beta.15)
100
+ - **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
88
101
 
89
- ## [Unreleased]
102
+ ### Changed
90
103
 
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. -->
104
+ - **plugin** — one generation, canonical names: src/plugin.ts, decision-* modules, tui/server TUI, PANTHEON_* env vars
105
+ - **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
106
+ - **doctor** — named-behavior override validation (check K) with --fix quarantine; the report names its source database
93
107
 
108
+ ### Fixed
109
+
110
+ - **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
111
+
112
+ ### Removed
113
+
114
+ - **plugin** — the OpenCode V1 contract (1.19.x hosts): V1 plugin, bridge, hooks, goal-loop lifecycle, tool-ceiling, presets application
115
+ - **validate** — the v1-permission canary proofs and the dual-generation test branches
116
+
117
+ ### Security
118
+
119
+ - 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
120
  ## [v1.7.0-beta.1] - 2026-11-07
95
121
 
96
- ## 🆕 What's New — a linha 1.7 abre
122
+ ## 🆕 What's New
97
123
  - **`mode: "order"`** no Jev: ordenação real de 2-4 candidatos com score por candidato (rank escolhe vencedor; order classifica a shortlist).
98
124
  - **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
125
  - **`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,10 +157,33 @@ 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
158
- selects the `plugins` component by default; in interactive setup you can
159
- change the component selection. A component-scoped install includes the TUI
160
- only when `plugins` is selected. The TUI ships no quota panel: for provider
160
+ [What's new window](docs/reference/whats-new.md). `/pantheon-settings`
161
+ (also `Pantheon: Settings` in the command palette) opens the sectioned
162
+ settings window — `tab` cycles sections, `up`/`down` selects,
163
+ `enter` applies, `esc`/`q` closes:
164
+
165
+ - **Gates & Overrides** — toggle the named behaviors, writing the global
166
+ `pantheon-overrides.json` the installer and doctor consume. A corrupt
167
+ overrides file refuses writes (repair with `doctor --fix`); entries in the
168
+ project `.pantheon/overrides.json` win at runtime and are shown read-only.
169
+ - **Decision Model** — enable/disable the advisory decision router live
170
+ (the runtime re-reads the config per call). Egress consent stays
171
+ CLI-owned (`decision-router setup-model`).
172
+ - **Model Preset** — activate any routing.yml preset globally (atomic
173
+ write with a `.bak` backup); `none` clears the marker. A project
174
+ `.pantheon/active-preset.json` wins and shows read-only.
175
+ - **J1 Risk Gate** — ladder mode/threshold status; env-only config
176
+ (`PANTHEON_J1_*`), read at startup, never written here.
177
+ - **Updates** — channel and a `Check now` registry probe for the running
178
+ channel; adopt with `pantheon-opencode update`.
179
+ - **Doctor** — file-derived health: install-version drift, Node floor,
180
+ overrides and decision-config validation. The full check (MCP smoke,
181
+ venv pins, git) remains `pantheon-opencode doctor`.
182
+
183
+ The installer selects the `plugins` component by default; in interactive
184
+ setup you can change the component selection. A component-scoped install
185
+ includes the TUI only when `plugins` is selected. The TUI ships no quota
186
+ panel: for provider
161
187
  quota and usage inside OpenCode, install the recommended community plugin
162
188
  [`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota) — see
163
189
  [Quota & usage](docs/tui-v2-quota-providers.md). `pantheon_cost` and
@@ -166,7 +192,7 @@ see [Quick Start](docs/QUICKSTART.md).
166
192
  Vision requests to OpenCode Zen require a valid active session and are rejected
167
193
  before image fetching or model-catalog lookup when the session is missing or
168
194
  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
195
+ gateway credential is configured. In the plugin, an explicit Vision model
170
196
  pin that is unavailable or ineligible returns an actionable error rather than
171
197
  silently switching models; remove the pin to use automatic model discovery.
172
198
 
@@ -177,24 +203,24 @@ routine child summaries stay in the handoff. See [Memory](docs/MEMORY.md).
177
203
 
178
204
  ## Compatibility
179
205
 
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.
206
+ OpenCode **2.x** is supported. **OpenCode 2.0.22 is known broken.** **2.0
207
+ removes the OpenCode V1 contract entirely** — 1.7.x was the last line with V1
208
+ support.
183
209
 
184
210
  The support policy, the known-broken exception, and the verified-version
185
211
  evidence have exactly one home: [Compatibility](docs/COMPATIBILITY.md).
186
212
 
187
- ### V2 plugin options
213
+ ### Plugin options
188
214
 
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.
215
+ The host hands a plugin its `options` only from the object form of the entry.
216
+ `init` writes that form for the optional per-request context pruner; memory
217
+ retrieval stays an explicit `memory_search` MCP call.
192
218
 
193
219
  ```json
194
220
  {
195
221
  "plugins": [
196
222
  {
197
- "package": "/path/to/pantheon-opencode/src/plugin-v2",
223
+ "package": "/path/to/pantheon-opencode/src/plugin",
198
224
  "options": {
199
225
  "context_pruner": { "enabled": true }
200
226
  }
@@ -217,7 +243,7 @@ one-time warning in the hook log, so a typo cannot silently change behaviour. Ru
217
243
  `npx pantheon-opencode doctor` to see whether the installed entry can receive
218
244
  options at all. An old `memory_injection` option may remain in an existing
219
245
  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).
246
+ Full rules: [OpenCode 2.x](docs/opencode.md) and [Memory](docs/MEMORY.md).
221
247
 
222
248
  ## Delegation
223
249
 
@@ -252,9 +278,9 @@ historical/inactive, and legacy consent, caps, period, provider selection, or
252
278
  credentials cannot activate it. Native child-session dispatch remains separate.
253
279
 
254
280
  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
281
+ available on hosts that expose the 2.2.5 native Decisions API; its full gate
256
282
  chain, routes, and settlement rules are documented once in
257
- [V2 native Decisions](docs/reference/native-decisions.md). An opt-in second
283
+ [Native Decisions (Jev)](docs/reference/native-decisions.md). An opt-in second
258
284
  consumer of that chain, the J1 risk-score shadow gate, fires one bounded
259
285
  native decision per write/execute tool call behind `PANTHEON_J1_RISK_SCORE`
260
286
  (off by default, zero overhead when off): the request carries no user content
@@ -324,26 +350,26 @@ test-only credential, verifies a local recommendation marker, and verifies zero
324
350
  native Decisions or global `fetch` calls. This is an offline regression check of
325
351
  that hook, not a claim about unexercised network paths or a live-provider test.
326
352
  Measured surface coverage is
327
- reported honestly rather than implied: P7 runs behind `PANTHEON_V2_P7_LOOP` with
353
+ reported honestly rather than implied: P7 runs behind `PANTHEON_P7_LOOP` with
328
354
  an **advisory** execution cap (never described as enforcement), P2 is
329
355
  **advisory-only** (an empirical no-op on the default path), P9 was measured on
330
356
  top-level **and child** sessions with `reason:"overflow"` still unmeasured, and
331
357
  P8 is **advisory: not activatable by measurement** — its declared rules match no
332
358
  delivered permission payload, so it narrows nothing (PROBE-F).
333
359
 
334
- ### The V2 decision layer is declared in full and wired in part
360
+ ### The decision layer is declared in full and wired in part
335
361
 
336
- The V2 decision layer declares eleven integration points (P1–P11) over three
362
+ The decision layer declares eleven integration points (P1–P11) over three
337
363
  decision primitives — `ask`, `rank`, and `verify` — and a deterministic policy
338
364
  that decides which point may run. **Seven of the eleven have a production call
339
365
  site: two behind flags that are off by default, five in shadow.**
340
366
 
341
367
  - **P7 (loop)** is wired to `session.execution.succeeded` behind
342
- `PANTHEON_V2_P7_LOOP`, which is off. It writes each observation to an
368
+ `PANTHEON_P7_LOOP`, which is off. It writes each observation to an
343
369
  in-memory, bounded telemetry collector that the plugin never reads back and
344
370
  exposes only to tests, so "records" here does not mean an operator-visible log.
345
371
  - **P8 (guardrail)** is wired to `permission.evaluate` behind
346
- `PANTHEON_V2_P8_GUARDRAIL`, which is off. C8 is closed **by measurement**, and
372
+ `PANTHEON_P8_GUARDRAIL`, which is off. C8 is closed **by measurement**, and
347
373
  the measurement is negative: PROBE-F delivered 24 real `permission.evaluate`
348
374
  events and every declared rule matched none of them (a valid `action` token and
349
375
  a top-level `sessionID` are always present), the host resolves an unrecognised
@@ -404,7 +430,7 @@ What the layer does **not** do today, stated as measured rather than implied:
404
430
  on the default path, because the host sends `prompt.skills` absent. Effective
405
431
  project-skill filtering was cancelled by measurement, not emulated, and no
406
432
  token reduction is claimed.
407
- - **P7 (loop) is behind `PANTHEON_V2_P7_LOOP`, off by default, and does not
433
+ - **P7 (loop) is behind `PANTHEON_P7_LOOP`, off by default, and does not
408
434
  enforce loop limits.** It counts executions and writes an `effect: none`
409
435
  observation to an in-memory collector that nothing reads back. Its
410
436
  12-execution cap is **advisory**: no measured host surface signals a new user
@@ -434,14 +460,14 @@ What the layer does **not** do today, stated as measured rather than implied:
434
460
  gain or loss in retrieval or tokens is claimed in either direction.
435
461
 
436
462
  Calibration that was run: the offline harness
437
- (`npx tsx tests/pantheon/v2-decision-harness.test.ts`) executed 264 synthetic
463
+ (`npx tsx tests/pantheon/decision-harness.test.ts`) executed 264 synthetic
438
464
  cases — 132 normal, 66 refusal, 66 adversarial — across the eleven points, with
439
465
  24 cases per point and the suite asserting at least 20 cases, 5 refusals and 5
440
466
  adversarial cases per point. All 264 cases passed on 2026-10-31. This harness is
441
467
  the only place all eleven points are exercised in one run, but it imports no
442
468
  adapter module: it iterates the registry and exercises the shared primitives,
443
469
  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
470
+ (`decision-p1.test.ts` … `decision-p11.test.ts`). Passing it says nothing
445
471
  about whether a point is registered in a host.
446
472
  The harness measures contracts (admission, refusal, shadow no-op, telemetry
447
473
  redaction, offline discipline, registry integrity), **not** token use, quality,
@@ -455,10 +481,10 @@ recorded in the [router reference](docs/reference/local-decision-router.md).
455
481
  | [Installation](docs/INSTALLATION.md) | [Architecture](docs/ARCHITECTURE.md) |
456
482
  | [Quick Start](docs/QUICKSTART.md) | [MCP](docs/MCP.md) · [MCP tools](docs/mcp-tools.md) |
457
483
  | [Upgrading](docs/UPGRADING.md) | [Memory](docs/MEMORY.md) |
458
- | [Compatibility](docs/COMPATIBILITY.md) | [OpenCode V2](docs/opencode-v2.md) |
484
+ | [Compatibility](docs/COMPATIBILITY.md) | [OpenCode 2.x](docs/opencode.md) |
459
485
  | [Agents & Skills](docs/agents/README.md) | [Platforms](docs/PLATFORMS.md) |
460
486
  | [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) |
487
+ | [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
488
  | [Contributing](CONTRIBUTING.md) | [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) |
463
489
 
464
490
  Memory writes through `pantheon-memory` are serialized, and failed writes are
@@ -474,7 +500,7 @@ usage (reports stay local — they carry bounded session excerpts), and the
474
500
  agent usage policies derived from it are documented in
475
501
  [MCP tools](docs/mcp-tools.md).
476
502
 
477
- The release install gate's tool canary loads the installed tarball's V2 plugin
503
+ The release install gate's tool canary loads the installed tarball's plugin
478
504
  entry under OpenCode 2.0.30 and verifies `hashline_edit` registration, Code Mode
479
505
  visibility, and a bounded edit in an isolated project. It does not prove npm
480
506
  publication or compatibility with untested host versions; details are in the
@@ -500,7 +526,7 @@ latest published changes.
500
526
  ## What's new
501
527
 
502
528
  See the [GitHub release](https://github.com/ils15/pantheon-opencode/releases)
503
- and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.6.1.
529
+ and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.7.0.
504
530
 
505
531
  ## Contribute
506
532
 
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