pantheon-opencode 1.7.0-beta.1 → 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 +86 -1
  4. package/README.md +90 -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 +9 -2
  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 +38 -58
  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
@@ -5,14 +5,99 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
6
6
 
7
7
 
8
+ ## [v1.7.0] - 2026-11-07
9
+
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.
15
+ - **Last version supporting the OpenCode V1 contract (1.19.x)** — the next minor targets OpenCode 2.x only.
16
+
17
+ ### Added
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.
28
+
29
+ ### Changed
30
+
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.
39
+
40
+ ### Deprecated
41
+
42
+ - **OpenCode V1 contract (1.19.x)** — supported through this release, deprecated afterward: the next minor targets OpenCode 2.x only.
43
+
44
+ ### Removed
45
+
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.
48
+
49
+ ### Fixed
50
+
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 }`).
57
+
58
+ ### Security
59
+
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.
61
+
62
+ ---
63
+
8
64
  ## [Unreleased]
9
65
 
10
66
  <!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
11
67
  move this section to a versioned entry and reset the template below. -->
12
68
 
69
+ ## [v2.0.0-beta.1] - 2026-11-08
70
+
71
+ ### Added
72
+
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
79
+
80
+ ### Changed
81
+
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
85
+
86
+ ### Fixed
87
+
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
89
+
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
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
13
98
  ## [v1.7.0-beta.1] - 2026-11-07
14
99
 
15
- ## 🆕 What's New — a linha 1.7 abre
100
+ ## 🆕 What's New
16
101
  - **`mode: "order"`** no Jev: ordenação real de 2-4 candidatos com score por candidato (rank escolhe vencedor; order classifica a shortlist).
17
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.
18
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
@@ -19,6 +19,44 @@ from an idea to a reviewed change. Fourteen specialized agents share one
19
19
  workflow: plan, implement, check, review, and record what mattered. You stay in
20
20
  charge of every decision and every merge.
21
21
 
22
+ ```mermaid
23
+ flowchart LR
24
+ U["👤 You"] --> Z["⚡ Zeus<br/>orchestrator"]
25
+ Z -->|"delegates"| S["14 specialists<br/>hermes · aphrodite · demeter · themis …"]
26
+ Z -->|"ambiguous route"| J["🎲 Jev decision router<br/>typed · budgeted · reversible"]
27
+ J -->|"orders · ranks · verifies"| S
28
+ S -->|"last resort"| M["🔌 Native MCP<br/>memory · persistence · vision<br/>code-mode · resources"]
29
+ Z --> G["🛡️ J1 risk gate<br/>off / shadow / warn / enforce"]
30
+ G -->|"high risk"| H["👤 Human approval"]
31
+ ```
32
+
33
+ **The escalation ladder every agent follows** (the same block lives in all 14
34
+ agent files): session context first → the free local selector → one typed Jev
35
+ question when genuinely ambiguous → a native MCP call only as the LAST resort
36
+ for state the session cannot reconstruct.
37
+
38
+ ```mermaid
39
+ flowchart LR
40
+ R["📝 rough request"] --> T0{"clear &<br/>bounded?"}
41
+ T0 -->|yes| X["⚡ execute directly"]
42
+ T0 -->|"vague /<br/>multi-concern"| T1["🔍 Tier 1 — internal<br/>minimal adjust ≤15 lines<br/>(silent, no approval)"]
43
+ T1 --> T2q{">> given?"}
44
+ T2q -->|yes| T2["📜 Tier 2 — full contract<br/>6 sections, confirm-or-adjust"]
45
+ T2q -->|no| X
46
+ ```
47
+
48
+ **Skill discovery runs a trust cascade** — canonical first, popularity never
49
+ compensates for provenance:
50
+
51
+ ```mermaid
52
+ flowchart LR
53
+ L["📚 installed pool<br/>(always first)"] -->|"gap"| C1["🟢 anthropics/skills<br/>canonical"]
54
+ C1 -->|"no fit"| C2["🔵 skills.sh<br/>install-count signal"]
55
+ C2 -->|"no fit"| C3["🟠 GitHub raw<br/>widest, weakest"]
56
+ C3 --> J["🎲 Jev orders<br/>the candidates"]
57
+ J --> P["👤 YOU review<br/>and run the install"]
58
+ ```
59
+
22
60
  ## Why use it?
23
61
 
24
62
  - **Less context switching:** keep planning and building in the same workflow.
@@ -35,17 +73,21 @@ charge of every decision and every merge.
35
73
 
36
74
  ## Start in 2 minutes
37
75
 
38
- Requirements: [OpenCode](https://opencode.ai/docs/) **1.19.x** (V1) or **OpenCode
39
- 2.x** (V2), and Node.js **>=26.4.0** for the CLI and tooling. **OpenCode 2.0.22
40
- 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).
41
79
 
42
- From the project where you want to use Pantheon:
80
+ From anywhere (global, all projects) or inside a project:
43
81
 
44
82
  ```bash
45
- npx pantheon-opencode init
83
+ opencode plugin add pantheon-opencode
84
+ # or pin it: opencode plugin add pantheon-opencode@<version>
46
85
  opencode
47
86
  ```
48
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
+
49
91
  Direct `init` uses the same component defaults in TTY and headless runs:
50
92
  `agents`, `skills`, `instructions`, `commands`, and `plugins`. `runtime` and
51
93
  `prompts` are opt-in. A TTY run selects components and target, shows a preview,
@@ -53,18 +95,18 @@ then asks once for final authorization (default **no**). Without a TTY, `init`
53
95
  is preview-only unless `--yes` explicitly authorizes the apply; `--yes` skips
54
96
  prompts but still prints the preview and checks for drift.
55
97
 
56
- `npm run setup` is a separate repository setup wrapper. On detected OpenCode V2
57
- it reviews the global config before installer init: legacy permission rules can
58
- be migrated after explicit review. Config migration and installer changes are
59
- preflighted before one final authorization; `--yes` alone does not authorize
60
- setup writes, and headless/CI setup remains preview-only. Direct
61
- `npx pantheon-opencode init` does not run that V2 config-migration review. See
62
- the [installation guide](docs/INSTALLATION.md) for layer handling, conflict
63
- choices, backups, and recovery.
64
- 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
65
107
  wildcard policies and ineffective `ask` rules require explicit resolution;
66
108
  third-party flat MCP entries in `opencode.jsonc` must be converted to
67
- `mcp.servers` or removed before V2 setup.
109
+ `mcp.servers` or removed before setup.
68
110
 
69
111
  Global `init` and `setup` use `$XDG_CONFIG_HOME/opencode` when
70
112
  `XDG_CONFIG_HOME` is absolute; otherwise they use `~/.config/opencode`.
@@ -80,9 +122,8 @@ When you ask for a plan, Athena returns it to Zeus, who displays it in the main
80
122
  conversation before asking for approval — never as a plan hidden in a child
81
123
  agent's conversation.
82
124
 
83
- Restart OpenCode after installing or changing the plugin generation. The
84
- installer selects one generation per installation; V1 and V2 plugins are never
85
- registered together.
125
+ Restart OpenCode after installing or changing the plugin. Pantheon registers a
126
+ single plugin; a host never loads two Pantheon plugins.
86
127
 
87
128
  Installer flags, exit codes, saved plans, backup and restore, uninstall,
88
129
  reconcile, and MCP pins are in the [installation guide](docs/INSTALLATION.md).
@@ -93,7 +134,7 @@ see [Quick Start](docs/QUICKSTART.md).
93
134
 
94
135
  - **14 specialized agents** with one orchestrator, implementation specialists,
95
136
  a quality gate, and supporting roles.
96
- - **22 skills** and reusable instructions for planning, building, reviewing,
137
+ - **23 skills** and reusable instructions for planning, building, reviewing,
97
138
  and documenting work.
98
139
  - **5 local MCP servers** for project memory, persistence, resources, confined
99
140
  script execution, and vision.
@@ -108,7 +149,7 @@ see [Quick Start](docs/QUICKSTART.md).
108
149
  [router reference](docs/reference/local-decision-router.md) and the
109
150
  [Native Decisions (Jev)](docs/reference/native-decisions.md).
110
151
  - **An optional TUI** with a dispatch sidebar block and a full-width
111
- `/dispatch` panel. The V2 sidebar keeps the Pantheon version, the active
152
+ `/dispatch` panel. The sidebar keeps the Pantheon version, the active
112
153
  preset/source, git state, and a `Context` block (tokens, a percent gauge,
113
154
  `$<spent> spent`, and a muted `cache <n>% · <n.n> tok/s` line); the native
114
155
  prompt footer keeps its own line, and Pantheon only appends
@@ -116,7 +157,11 @@ see [Quick Start](docs/QUICKSTART.md).
116
157
  version changes since the last TUI start, a one-time dismissable
117
158
  "What's new" dialog lists that version's highlights from the shipped
118
159
  changelog — once per version, `esc`/`q` dismisses; see
119
- [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
120
165
  selects the `plugins` component by default; in interactive setup you can
121
166
  change the component selection. A component-scoped install includes the TUI
122
167
  only when `plugins` is selected. The TUI ships no quota panel: for provider
@@ -128,7 +173,7 @@ see [Quick Start](docs/QUICKSTART.md).
128
173
  Vision requests to OpenCode Zen require a valid active session and are rejected
129
174
  before image fetching or model-catalog lookup when the session is missing or
130
175
  invalid. The Python vision MCP keeps its local metadata/OCR fallback when no
131
- gateway credential is configured. In the V2 plugin, an explicit Vision model
176
+ gateway credential is configured. In the plugin, an explicit Vision model
132
177
  pin that is unavailable or ineligible returns an actionable error rather than
133
178
  silently switching models; remove the pin to use automatic model discovery.
134
179
 
@@ -139,24 +184,24 @@ routine child summaries stay in the handoff. See [Memory](docs/MEMORY.md).
139
184
 
140
185
  ## Compatibility
141
186
 
142
- OpenCode **1.19.x** (V1 plugin) and **OpenCode 2.x** (V2 plugin) are supported.
143
- **OpenCode 2.0.22 is known broken.** From 1.7 onward the line drops the V1
144
- contract and 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.
145
190
 
146
191
  The support policy, the known-broken exception, and the verified-version
147
192
  evidence have exactly one home: [Compatibility](docs/COMPATIBILITY.md).
148
193
 
149
- ### V2 plugin options
194
+ ### Plugin options
150
195
 
151
- The OpenCode V2 host hands a plugin its `options` only from the object form of
152
- the entry. `init` writes that form for the optional per-request context pruner;
153
- 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.
154
199
 
155
200
  ```json
156
201
  {
157
202
  "plugins": [
158
203
  {
159
- "package": "/path/to/pantheon-opencode/src/plugin-v2",
204
+ "package": "/path/to/pantheon-opencode/src/plugin",
160
205
  "options": {
161
206
  "context_pruner": { "enabled": true }
162
207
  }
@@ -179,7 +224,7 @@ one-time warning in the hook log, so a typo cannot silently change behaviour. Ru
179
224
  `npx pantheon-opencode doctor` to see whether the installed entry can receive
180
225
  options at all. An old `memory_injection` option may remain in an existing
181
226
  config because user options are preserved, but the plugin no longer reads it.
182
- 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).
183
228
 
184
229
  ## Delegation
185
230
 
@@ -214,9 +259,9 @@ historical/inactive, and legacy consent, caps, period, provider selection, or
214
259
  credentials cannot activate it. Native child-session dispatch remains separate.
215
260
 
216
261
  The one native egress surface is the Zeus-only `pantheon_jev_decide` tool,
217
- 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
218
263
  chain, routes, and settlement rules are documented once in
219
- [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
220
265
  consumer of that chain, the J1 risk-score shadow gate, fires one bounded
221
266
  native decision per write/execute tool call behind `PANTHEON_J1_RISK_SCORE`
222
267
  (off by default, zero overhead when off): the request carries no user content
@@ -286,26 +331,26 @@ test-only credential, verifies a local recommendation marker, and verifies zero
286
331
  native Decisions or global `fetch` calls. This is an offline regression check of
287
332
  that hook, not a claim about unexercised network paths or a live-provider test.
288
333
  Measured surface coverage is
289
- 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
290
335
  an **advisory** execution cap (never described as enforcement), P2 is
291
336
  **advisory-only** (an empirical no-op on the default path), P9 was measured on
292
337
  top-level **and child** sessions with `reason:"overflow"` still unmeasured, and
293
338
  P8 is **advisory: not activatable by measurement** — its declared rules match no
294
339
  delivered permission payload, so it narrows nothing (PROBE-F).
295
340
 
296
- ### The V2 decision layer is declared in full and wired in part
341
+ ### The decision layer is declared in full and wired in part
297
342
 
298
- The V2 decision layer declares eleven integration points (P1–P11) over three
343
+ The decision layer declares eleven integration points (P1–P11) over three
299
344
  decision primitives — `ask`, `rank`, and `verify` — and a deterministic policy
300
345
  that decides which point may run. **Seven of the eleven have a production call
301
346
  site: two behind flags that are off by default, five in shadow.**
302
347
 
303
348
  - **P7 (loop)** is wired to `session.execution.succeeded` behind
304
- `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
305
350
  in-memory, bounded telemetry collector that the plugin never reads back and
306
351
  exposes only to tests, so "records" here does not mean an operator-visible log.
307
352
  - **P8 (guardrail)** is wired to `permission.evaluate` behind
308
- `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
309
354
  the measurement is negative: PROBE-F delivered 24 real `permission.evaluate`
310
355
  events and every declared rule matched none of them (a valid `action` token and
311
356
  a top-level `sessionID` are always present), the host resolves an unrecognised
@@ -366,7 +411,7 @@ What the layer does **not** do today, stated as measured rather than implied:
366
411
  on the default path, because the host sends `prompt.skills` absent. Effective
367
412
  project-skill filtering was cancelled by measurement, not emulated, and no
368
413
  token reduction is claimed.
369
- - **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
370
415
  enforce loop limits.** It counts executions and writes an `effect: none`
371
416
  observation to an in-memory collector that nothing reads back. Its
372
417
  12-execution cap is **advisory**: no measured host surface signals a new user
@@ -396,14 +441,14 @@ What the layer does **not** do today, stated as measured rather than implied:
396
441
  gain or loss in retrieval or tokens is claimed in either direction.
397
442
 
398
443
  Calibration that was run: the offline harness
399
- (`npx tsx tests/pantheon/v2-decision-harness.test.ts`) executed 264 synthetic
444
+ (`npx tsx tests/pantheon/decision-harness.test.ts`) executed 264 synthetic
400
445
  cases — 132 normal, 66 refusal, 66 adversarial — across the eleven points, with
401
446
  24 cases per point and the suite asserting at least 20 cases, 5 refusals and 5
402
447
  adversarial cases per point. All 264 cases passed on 2026-10-31. This harness is
403
448
  the only place all eleven points are exercised in one run, but it imports no
404
449
  adapter module: it iterates the registry and exercises the shared primitives,
405
450
  while the adapters are covered by their per-point suites
406
- (`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
407
452
  about whether a point is registered in a host.
408
453
  The harness measures contracts (admission, refusal, shadow no-op, telemetry
409
454
  redaction, offline discipline, registry integrity), **not** token use, quality,
@@ -417,10 +462,10 @@ recorded in the [router reference](docs/reference/local-decision-router.md).
417
462
  | [Installation](docs/INSTALLATION.md) | [Architecture](docs/ARCHITECTURE.md) |
418
463
  | [Quick Start](docs/QUICKSTART.md) | [MCP](docs/MCP.md) · [MCP tools](docs/mcp-tools.md) |
419
464
  | [Upgrading](docs/UPGRADING.md) | [Memory](docs/MEMORY.md) |
420
- | [Compatibility](docs/COMPATIBILITY.md) | [OpenCode V2](docs/opencode-v2.md) |
465
+ | [Compatibility](docs/COMPATIBILITY.md) | [OpenCode 2.x](docs/opencode.md) |
421
466
  | [Agents & Skills](docs/agents/README.md) | [Platforms](docs/PLATFORMS.md) |
422
467
  | [Release Process](docs/RELEASING.md) | [Branch Protection](docs/BRANCH-PROTECTION.md) |
423
- | [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) |
424
469
  | [Contributing](CONTRIBUTING.md) | [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) |
425
470
 
426
471
  Memory writes through `pantheon-memory` are serialized, and failed writes are
@@ -436,7 +481,7 @@ usage (reports stay local — they carry bounded session excerpts), and the
436
481
  agent usage policies derived from it are documented in
437
482
  [MCP tools](docs/mcp-tools.md).
438
483
 
439
- 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
440
485
  entry under OpenCode 2.0.30 and verifies `hashline_edit` registration, Code Mode
441
486
  visibility, and a bounded edit in an isolated project. It does not prove npm
442
487
  publication or compatibility with untested host versions; details are in the
@@ -462,7 +507,7 @@ latest published changes.
462
507
  ## What's new
463
508
 
464
509
  See the [GitHub release](https://github.com/ils15/pantheon-opencode/releases)
465
- 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.
466
511
 
467
512
  ## Contribute
468
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