pantheon-opencode 1.6.0 → 1.6.2-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 (115) hide show
  1. package/AGENTS.global.md +11 -11
  2. package/AGENTS.md +2 -2
  3. package/CHANGELOG.md +45 -0
  4. package/README.md +122 -6
  5. package/README.pt-BR.md +14 -9
  6. package/bin/pantheon-init.mjs +255 -39
  7. package/package.json +8 -6
  8. package/plugin.json +1 -1
  9. package/pyproject.toml +1 -1
  10. package/scripts/build-agents-md.mjs +1 -1
  11. package/scripts/doctor.mjs +231 -46
  12. package/scripts/install/agents-md.mjs +2 -1
  13. package/scripts/install/config-migration.mjs +344 -393
  14. package/scripts/install/config-paths.mjs +15 -0
  15. package/scripts/install/interactive.mjs +30 -9
  16. package/scripts/install/interrupt.mjs +78 -0
  17. package/scripts/install/mcp-permissions.mjs +164 -0
  18. package/scripts/install/opencode-state.mjs +91 -0
  19. package/scripts/install/opencode-version.mjs +31 -13
  20. package/scripts/install/opencode-wildcard.mjs +106 -0
  21. package/scripts/install/opencode.mjs +508 -108
  22. package/scripts/install/plan-artifact.mjs +12 -1
  23. package/scripts/install/plugin.mjs +17 -1
  24. package/scripts/install/run-record.mjs +115 -0
  25. package/scripts/install/strings.mjs +35 -6
  26. package/scripts/install/v2-capabilities.mjs +204 -0
  27. package/scripts/package-evidence.mjs +1 -0
  28. package/scripts/release-gates.mjs +7 -2
  29. package/scripts/sandbox-env.sh +174 -0
  30. package/scripts/setup-v2-config.mjs +1703 -0
  31. package/scripts/setup.mjs +415 -0
  32. package/scripts/sync-tui.mjs +9 -1
  33. package/scripts/test-opencode-v2-sandbox.sh +438 -151
  34. package/scripts/update-skills-lock.mjs +30 -0
  35. package/skills-lock.json +10 -10
  36. package/src/agents/aphrodite.md +5 -2
  37. package/src/agents/apollo.md +5 -0
  38. package/src/agents/athena.md +6 -1
  39. package/src/agents/demeter.md +5 -1
  40. package/src/agents/gaia.md +4 -0
  41. package/src/agents/hephaestus.md +6 -1
  42. package/src/agents/hermes.md +6 -3
  43. package/src/agents/iris.md +5 -1
  44. package/src/agents/mnemosyne.md +20 -50
  45. package/src/agents/nyx.md +5 -1
  46. package/src/agents/prometheus.md +4 -0
  47. package/src/agents/talos.md +4 -0
  48. package/src/agents/themis.md +4 -0
  49. package/src/agents/zeus.md +9 -3
  50. package/src/instructions/agent-return-format.instructions.md +1 -1
  51. package/src/instructions/memory-protocol.instructions.md +3 -3
  52. package/src/instructions/test-economy.instructions.md +6 -6
  53. package/src/mcp/pantheon_vision.py +37 -36
  54. package/src/mcp/requirements-mcp.txt +1 -1
  55. package/src/mcp/requirements-vision.txt +1 -1
  56. package/src/pantheon/cost-command.ts +127 -40
  57. package/src/pantheon/delegation-enforce.ts +160 -23
  58. package/src/pantheon/guard-path.ts +162 -0
  59. package/src/pantheon/v2-bounded-read.ts +15 -1
  60. package/src/pantheon/v2-bridge.ts +27 -0
  61. package/src/pantheon/v2-shell-hooks.ts +260 -0
  62. package/src/pantheon/v2-unsupported.mjs +32 -4
  63. package/src/pantheon/v2-vision.ts +34 -29
  64. package/src/pantheon/vision.ts +49 -11
  65. package/src/plugin-v2.ts +413 -60
  66. package/src/plugin.ts +22 -2
  67. package/src/plugins/tui/dist/quota-adapters.d.ts +89 -0
  68. package/src/plugins/tui/dist/quota-adapters.d.ts.map +1 -0
  69. package/src/plugins/tui/dist/quota-adapters.js +1142 -0
  70. package/src/plugins/tui/dist/quota-adapters.js.map +1 -0
  71. package/src/plugins/tui/dist/quota-cli.d.ts +17 -0
  72. package/src/plugins/tui/dist/quota-cli.d.ts.map +1 -0
  73. package/src/plugins/tui/dist/quota-cli.js +184 -0
  74. package/src/plugins/tui/dist/quota-cli.js.map +1 -0
  75. package/src/plugins/tui/dist/quota-rpc-UL2HuFRJ.js +390 -0
  76. package/src/plugins/tui/dist/quota-rpc-UL2HuFRJ.js.map +1 -0
  77. package/src/plugins/tui/dist/server-v2.d.ts +14 -0
  78. package/src/plugins/tui/dist/server-v2.d.ts.map +1 -0
  79. package/src/plugins/tui/dist/server-v2.js +673 -0
  80. package/src/plugins/tui/dist/server-v2.js.map +1 -0
  81. package/src/plugins/tui/dist/tui-v2.d.ts +247 -52
  82. package/src/plugins/tui/dist/tui-v2.d.ts.map +1 -1
  83. package/src/plugins/tui/dist/tui-v2.js +2492 -529
  84. package/src/plugins/tui/dist/tui-v2.js.map +1 -1
  85. package/src/plugins/tui/dist/tui.js +1 -1
  86. package/src/plugins/tui/index-v2.ts +3 -6
  87. package/src/plugins/tui/package-lock.json +11 -11
  88. package/src/plugins/tui/package.json +6 -4
  89. package/src/plugins/tui/src/context-gauge.ts +59 -0
  90. package/src/plugins/tui/src/go-key-diagnostic-ui.ts +100 -0
  91. package/src/plugins/tui/src/go-key-diagnostic.ts +125 -0
  92. package/src/plugins/tui/src/index-v2.tsx +199 -240
  93. package/src/plugins/tui/src/model-usage-limits.ts +4 -0
  94. package/src/plugins/tui/src/quota-adapters.ts +1598 -0
  95. package/src/plugins/tui/src/quota-cli.ts +237 -0
  96. package/src/plugins/tui/src/quota-rpc.ts +209 -0
  97. package/src/plugins/tui/src/quota-v2-model.ts +1032 -0
  98. package/src/plugins/tui/src/quota-v2.tsx +986 -0
  99. package/src/plugins/tui/src/server-v2.ts +841 -0
  100. package/src/plugins/tui/src/sidebar-width.ts +129 -0
  101. package/src/plugins/tui/tsconfig.typecheck.json +1 -1
  102. package/src/plugins/tui/tsdown.config.ts +8 -1
  103. package/src/routing.yml +72 -13
  104. package/src/skills/README.md +4 -0
  105. package/src/skills/agent-coordination/SKILL.md +0 -3
  106. package/src/skills/artifact-management/SKILL.md +0 -3
  107. package/src/skills/auto-continue/SKILL.md +0 -3
  108. package/src/skills/code-review-checklist/SKILL.md +0 -3
  109. package/src/skills/context-compression/SKILL.md +0 -3
  110. package/src/skills/memory-bank/SKILL.md +6 -28
  111. package/src/skills/session-goal/SKILL.md +0 -3
  112. package/src/skills/simplify/SKILL.md +5 -4
  113. package/src/skills/tdd-with-agents/SKILL.md +0 -3
  114. package/src/skills/visual-review-pipeline/SKILL.md +0 -1
  115. package/src/pantheon/memory-context.ts +0 -1017
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-10-22T13:57:53-03:00 sha=ceade5f -->
4
+ <!-- pantheon:agents-md v2 artifact=global generated-at=2026-10-27T08:34:01-03:00 sha=0a6a8e2 -->
5
5
 
6
6
  # Pantheon Agent System — OpenCode
7
7
 
@@ -32,7 +32,7 @@ Shared rules from `src/instructions/*.instructions.md`, identical for OpenCode V
32
32
  <!-- Source: src/instructions/agent-return-format.instructions.md -->
33
33
  ## Agent Return Format
34
34
 
35
- Implementation agents (Hermes, Aphrodite, Demeter, Hephaestus, Prometheus) MUST return results to Zeus in this format:
35
+ All agents check each result against the request and evidence; remove unrelated work, generic filler, unsupported claims, and unnecessary complexity; state uncertainty and preserve safety constraints. Implementation agents (Hermes, Aphrodite, Demeter, Hephaestus, Prometheus) MUST return results to Zeus in this format:
36
36
 
37
37
  ## subtask_summary
38
38
  **files_changed:** [list of file paths, one per line]
@@ -76,21 +76,21 @@ Required: position, reasoning, trade_offs, risks, confidence. Optional `agreemen
76
76
  - Use a targeted query (`top_k=2`) and ignore weak matches; missing or irrelevant results never block current work.
77
77
 
78
78
  ### Persistence
79
- - Use only tools granted in the active session: Zeus has `memory_search` and temporary `context_save`/`context_get` checkpoints but no durable writes; Mnemosyne has `memory_store` and other durable tools.
80
- - Store at most one concise, reusable top-level result; never persist routine child summaries, phase updates, test logs, or temporary state. Confirm a successful write before claiming persistence. Never store secrets, credentials, or tokens; `memory_store` does not guarantee redaction, so omit or redact sensitive content first.
81
- - If no write tool is available or the write did not succeed, say the information was not persisted; never imply automatic storage or recovery. Add ADRs to the memory bank only when explicitly requested.
79
+ - Use only granted tools: Zeus has `memory_search` and temporary `context_save/get` checkpoints, but no durable writes; Mnemosyne has `memory_store` and other durable tools.
80
+ - Let native OpenCode compaction summarize active context. Use `context_save/get` only for cross-session resume; keep the goal, phase, progress, next step, decisions, blockers, and uncertain outcomes — no transcripts or routine logs.
81
+ - Store at most one concise, reusable top-level result only on explicit request. Never persist child summaries, test logs, or temporary state. Never store secrets, credentials, or tokens; confirm writes and state failures. Create ADRs only on request.
82
82
 
83
83
  <!-- Source: src/instructions/test-economy.instructions.md -->
84
84
  ## Test Economy
85
85
 
86
86
 
87
- Write the smallest test that proves the behavior: one behavior → one focused test; never duplicate coverage across suites or files.
87
+ Write one focused test per behavior; do not duplicate coverage.
88
88
 
89
- - No E2E, full-install, or network-dependent tests unless the change alters that end-to-end path; prefer unit or integration tests.
90
- - No assertions on copy/format strings, and none that only restate the implementation ("test the test").
91
- - Heavy or slow suites (real install/E2E) MUST be opt-in via a separate tier, never per edit or phase; respect a per-phase time budget and reserve the full suites for release gates.
92
- - Fixing a bug: one targeted regression test, not a broad new suite.
93
- - This economy rule does NOT weaken stronger gates: auth, security, data-integrity, and required coverage thresholds stay mandatory.
89
+ - Prefer unit/integration checks; use E2E, install, or network tests only when a change affects that path.
90
+ - Avoid assertions on copy/formatting or tests that merely restate the implementation.
91
+ - Default to focused tests; run the full suite only for scope, risk, or CI/release gates. Bug fixes need one regression test unless existing coverage catches them.
92
+ - Keep slow install/E2E suites opt-in, never per edit or phase; reserve them for release gates.
93
+ - Test economy does NOT weaken stronger gates: auth, security, data-integrity, and required coverage.
94
94
 
95
95
  <!-- Source: src/instructions/yagni.instructions.md -->
96
96
  ## YAGNI Anti-overengineering
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-10-22T13:57:53-03:00 sha=ceade5f -->
4
+ <!-- pantheon:agents-md v2 artifact=project generated-at=2026-10-27T08:34:01-03:00 sha=0a6a8e2 -->
5
5
 
6
6
  # Pantheon — Repository Setup
7
7
 
@@ -9,7 +9,7 @@
9
9
 
10
10
  Setup: [INSTALLATION.md](docs/INSTALLATION.md).
11
11
 
12
- - Build/Test: `npm test`
12
+ - Test: focused checks by default; `npm test` for CI/release or broad/high-risk changes
13
13
  - Lint: `npm run lint`
14
14
 
15
15
  ## Teste de Instalação Global (sandbox)
package/CHANGELOG.md CHANGED
@@ -10,6 +10,51 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
10
10
  <!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
11
11
  move this section to a versioned entry and reset the template below. -->
12
12
 
13
+ ## [v1.6.2-beta.1] - 2026-10-27
14
+
15
+ ### Changed
16
+
17
+ - **agents** — V2 compiles declared skills into per-agent allowlists; metadata, routing, and installed skills are checked for drift.
18
+ - **memory** — Recall stays an explicit `memory_search` MCP call, session checkpoints are reserved for cross-session handoff, and native OpenCode compaction owns active-history summarization.
19
+ - **prompts** — Manual prompt templates use named `{{UPPER_SNAKE_CASE}}` inputs; slash commands keep OpenCode's native `$ARGUMENTS` expansion.
20
+ - **install** — V2 MCP entries use the native `disabled` field and migrate legacy `enabled` values.
21
+ - **install** — Existing native V2 permission arrays remain authoritative; legacy defaults are seeded only when no V2 array exists.
22
+
23
+ ### Removed
24
+
25
+ - **plugin** — Removed ambient V2 memory injection and its debug environment variable; the legacy `memory_injection` option is ignored if preserved in an existing config.
26
+
27
+ &lt;!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
28
+ move this section to a versioned entry and reset the template below. --&gt;
29
+ ## [v1.6.1] - 2026-10-24
30
+
31
+ ### Added
32
+
33
+ - **docs** — Corrected code-mode tool signatures and agent grants, polished 1.6.x docs with translations/evidence links, and fixed the docs-site entry point (#270).
34
+
35
+ ### Changed
36
+
37
+ - **plugin** — V2 wires the read guard and bridge and restores supported context, image-history, formatter, and delegation-audit behavior (#264–#267).
38
+ - **plugin** — V2 reports host gaps `idle-todo-enforcer`, `todo-restore`, `tool-ceiling`, and `board-transitions` instead of claiming full parity.
39
+ - **install** — V2 notices report the resolved state path and shared V1/V2 state, not database isolation or a service port; capability output distinguishes the static seed and includes it in `--json`.
40
+ - **install** — SIGINT during blocking `spawnSync` may still be swallowed; cancellation is deterministic during awaited phases.
41
+
42
+ ### Fixed
43
+
44
+ - **plugin** — V1/V2 Zeus read guards normalize paths, resolve symlink targets, deny resolution failures, and align code-root checks with `pantheon_bounded_read` (#282).
45
+ - **plugin** — `pantheon_cost` sums per-model prices for multi-model agents and reconciles partial/unpriced usage with model totals (#260).
46
+ - **install** — Cancel/decline names the stopped step and records the run; Ctrl-C exits 130 during awaited phases (#261, #262).
47
+ - **install** — Fresh V2 installs write options-bearing plugin entries; migration moves only loadable entries and warns about sibling `opencode.jsonc` (#268, #269).
48
+
49
+ ### Security
50
+
51
+ - **deps** — Patched `zod` 4.6.6, `fastmcp` 4.1.2, `undici` 6.29.1/8.12.3, and `fast-uri` 3.1.9 to clear reported advisories (#275; PR #283).
52
+ - The guard does not pin an inode or make check/open atomic, so concurrent workspace writers can race it; it is a policy boundary, not isolation from hostile local processes.
53
+
54
+ ### Deprecated
55
+
56
+ ### Removed
57
+
13
58
  ## [v1.6.0] - 2026-10-22
14
59
 
15
60
  ### Added
package/README.md CHANGED
@@ -28,10 +28,10 @@ charge of every decision and every merge.
28
28
  collaborators.
29
29
  - **You stay in charge:** Pantheon supports your judgment; it does not replace
30
30
  it.
31
- - **Right-sized coordination:** bounded work goes to one specialist; planning,
32
- discovery, parallel work, and review are added when scope and risk call for
33
- them. `/pantheon-deepwork` remains the checkpointed workflow for heavy
34
- multi-phase work.
31
+ - **Right-sized coordination:** bounded work goes to one specialist, who
32
+ gathers the needed context. Planning, separate discovery, parallel work, and
33
+ review are added when scope and risk call for them. `/pantheon-deepwork`
34
+ remains the checkpointed workflow for heavy multi-phase work.
35
35
 
36
36
  ## Start in 2 minutes
37
37
 
@@ -46,6 +46,27 @@ npx pantheon-opencode init
46
46
  opencode
47
47
  ```
48
48
 
49
+ For the optional full setup flow, run `npm run setup`. On detected OpenCode V2,
50
+ it reviews the global config before installer init: legacy permission rules can
51
+ be migrated after explicit review. Verified Pantheon plugin/MCP entries are
52
+ reported; JSONC entries move only when order and overrides stay safe, otherwise
53
+ the user must choose to keep them in place or abort. Config migration and
54
+ installer changes are preflighted before one final authorization; `--yes` alone
55
+ does not authorize writes. Overlapping MCP wildcard policies that could allow
56
+ an action after a denial are blocked, and ineffective MCP `ask` rules matching
57
+ configured or installer-seeded servers require an explicit outcome.
58
+ Existing native V2 `permissions` arrays stay authoritative; Pantheon does not
59
+ append legacy default grants to them.
60
+ Flat third-party MCP entries in `opencode.jsonc` block V2 setup until manually
61
+ converted to `mcp.servers` or removed; nested third-party servers are preserved.
62
+ Headless/CI/non-TTY runs are preview-only and do not invoke writing init (V1
63
+ included). See the [installation guide](docs/INSTALLATION.md) for layer handling,
64
+ conflict choices, backups, and recovery.
65
+
66
+ Global `init` and `setup` use `$XDG_CONFIG_HOME/opencode` when
67
+ `XDG_CONFIG_HOME` is absolute; otherwise they use `~/.config/opencode`.
68
+ Relative `XDG_CONFIG_HOME` values are rejected before writes.
69
+
49
70
  Then describe the outcome you want:
50
71
 
51
72
  ```text
@@ -74,7 +95,57 @@ see [Quick Start](docs/QUICKSTART.md).
74
95
  - **5 local MCP servers** for project memory, persistence, resources, confined
75
96
  script execution, and vision.
76
97
  - **An optional TUI** with a dispatch sidebar block and a full-width
77
- `/dispatch` panel.
98
+ `/dispatch` panel. The V2 TUI also provides a quota overview in the
99
+ sidebar/footer and a `/quota` details panel. Quota display is enabled by
100
+ default; the sidebar keeps Todo and places quota immediately after Dispatch
101
+ (header/version → Session → Context → Git → Todo → Dispatch → quota).
102
+ Status stays in the native sidebar footer. Use `E` to disable quota or `M`
103
+ to switch between remaining and used. Quota windows show a local countdown and
104
+ the provider-reported reset date/time in UTC when valid timing is available;
105
+ missing timing is not inferred. After expiry the UI shows “aguardando
106
+ atualização” until refreshed data arrives. Empty quota gauges use a visible
107
+ track even when no usage is reported.
108
+ When a quota status request fails, the UI preserves the last valid
109
+ snapshot, marks it stale, and shows the failure cause as `Erro: <causa>`
110
+ in the sidebar and `/quota` panel (plus a `Último erro` line) instead
111
+ of a blind "Status indisponível"; the cause is logged as
112
+ `[pantheon-tui quota]`.
113
+ Usage severity uses warning color from 60% consumed and error color above 85%.
114
+ Session costs, provider balances and selected-key usage retain their distinct
115
+ labels and reported periods. Long values and states continue onto additional
116
+ lines within the sidebar's fixed 34-column content budget.
117
+ The installer selects the `plugins` component by default; in interactive setup
118
+ you can change the component selection. A component-scoped install includes
119
+ the TUI only when `plugins` is selected.
120
+ The V2 quota RPC shows providers only when OpenCode lists an active supported
121
+ connection and Pantheon can locally resolve a nonblank credential. This is
122
+ not proof that the provider accepted the credential; failed requests and
123
+ unsupported adapters can remain visible as unavailable. OpenCode Go checks
124
+ the selected Console OAuth login first, then uses an active OpenCode Go API
125
+ key (or its legacy OpenCode key alias) only when the Console request fails; a
126
+ Console 404 or a successful response without an access object reports no Go
127
+ subscription and does not fall back.
128
+ The route contract remains unofficial; see the
129
+ [quota provider coverage table](docs/tui-v2-quota-providers.md) for limits and
130
+ troubleshooting.
131
+ `/quota-go-check` is a separate manual, confirmation-gated diagnostic: one
132
+ GET to `https://opencode.ai/zen/go/v1/usage` with the configured Go API key
133
+ (not OAuth), at most one attempt per plugin runtime. It never refreshes quota,
134
+ follows redirects or retries. Only HTTP 401 bodies are inspected, up to 4096
135
+ bytes, for an own top-level JSON `error` property; its value is never inspected.
136
+ Results contain only a safe category, optional HTTP status, coarse content type,
137
+ and (for 401) whether that structure is present, absent, or unavailable.
138
+ No error code, type, message, body, request ID, or byte count is displayed;
139
+ a 401 rejection's cause remains unknown. `success` means
140
+ HTTP success only—not a stable quota contract or parsed quota correctness.
141
+ Require Themis security review before using this diagnostic.
142
+
143
+ Vision requests to OpenCode Zen require a valid active session and are rejected
144
+ before image fetching or model-catalog lookup when the session is missing or
145
+ invalid. The Python vision MCP keeps its local metadata/OCR fallback when no
146
+ gateway credential is configured. In the V2 plugin, an explicit Vision model
147
+ pin that is unavailable or ineligible returns an actionable error rather than
148
+ silently switching models; remove the pin to use automatic model discovery.
78
149
 
79
150
  Memory is used selectively: the coordinator searches once only when project
80
151
  history could affect a task, then passes relevant results to specialists. Store
@@ -90,6 +161,41 @@ contract and targets OpenCode 2 only.
90
161
  The support policy, the known-broken exception, and the verified-version
91
162
  evidence have exactly one home: [Compatibility](docs/COMPATIBILITY.md).
92
163
 
164
+ ### V2 plugin options
165
+
166
+ The OpenCode V2 host hands a plugin its `options` only from the object form of
167
+ the entry. `init` writes that form for the optional per-request context pruner;
168
+ memory retrieval stays an explicit `memory_search` MCP call.
169
+
170
+ ```json
171
+ {
172
+ "plugins": [
173
+ {
174
+ "package": "/path/to/pantheon-opencode/src/plugin-v2",
175
+ "options": {
176
+ "context_pruner": { "enabled": true }
177
+ }
178
+ }
179
+ ]
180
+ }
181
+ ```
182
+
183
+ Keep the `package` value `init` wrote and add keys inside `options`; custom
184
+ options survive a re-run. The context pruner is off unless `enabled` is
185
+ literally `true`.
186
+
187
+ | Option | Default | Effect |
188
+ |---|---|---|
189
+ | `options.context_pruner.enabled` | `false` | Prune old turns from the request payload and at compaction. Off by default because per-request pruning invalidates the provider prompt cache. |
190
+
191
+ `context_pruner` also accepts `keepTurns`, `purgeAfterTurns`, `protectedTools`,
192
+ `minSavingsTokens` and `charsPerToken`. Unknown keys are ignored with a
193
+ one-time warning in the hook log, so a typo cannot silently change behaviour. Run
194
+ `npx pantheon-opencode doctor` to see whether the installed entry can receive
195
+ options at all. An old `memory_injection` option may remain in an existing
196
+ config because user options are preserved, but the plugin no longer reads it.
197
+ Full rules: [OpenCode V2](docs/opencode-v2.md) and [Memory](docs/MEMORY.md).
198
+
93
199
  ## Delegation
94
200
 
95
201
  Pantheon delegates through the host's native child-session engine: `subagent`
@@ -125,6 +231,12 @@ in [Architecture](docs/ARCHITECTURE.md) and
125
231
  | [Model Routing](docs/reference/model-routing.md) | [Env Vars](docs/reference/env-vars.md) · [Code Mode](docs/reference/code-mode.md) |
126
232
  | [Contributing](CONTRIBUTING.md) | [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) |
127
233
 
234
+ The release install gate's tool canary loads the installed tarball's V2 plugin
235
+ entry under OpenCode 2.0.30 and verifies `hashline_edit` registration, Code Mode
236
+ visibility, and a bounded edit in an isolated project. It does not prove npm
237
+ publication or compatibility with untested host versions; details are in the
238
+ [release process](docs/RELEASING.md).
239
+
128
240
  ## Status
129
241
 
130
242
  The manifests in this checkout express the version being prepared, not a
@@ -136,7 +248,7 @@ latest published changes.
136
248
  ## What's new
137
249
 
138
250
  See the [GitHub release](https://github.com/ils15/pantheon-opencode/releases)
139
- and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.6.0.
251
+ and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.6.1.
140
252
 
141
253
  ## Contribute
142
254
 
@@ -145,6 +257,10 @@ welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening an issue or pull
145
257
  request. That file also defines the documentation rule: one home per fact, with
146
258
  a short list of facts that must not be duplicated.
147
259
 
260
+ For code changes, run the smallest relevant check and expand it to match the
261
+ change's risk. `npm test` is the full repository suite; see
262
+ [CONTRIBUTING.md](CONTRIBUTING.md) for when to use it.
263
+
148
264
  ## Citation and DOI
149
265
 
150
266
  Pantheon is released under the [MIT License](LICENSE). Cite the
package/README.pt-BR.md CHANGED
@@ -1,4 +1,4 @@
1
- <!-- synced-from: README.md @ 7359e4f -->
1
+ <!-- synced-from: README.md @ 0a6a8e2 -->
2
2
  # Pantheon
3
3
 
4
4
  **Uma forma mais clara de trabalhar com OpenCode em projetos de software
@@ -29,10 +29,10 @@ o que importou. Você continua no controle de cada decisão e de cada merge.
29
29
  - **Um ponto de partida repetível:** o mesmo setup entre projetos e
30
30
  colaboradores.
31
31
  - **Você no comando:** o Pantheon apoia seu julgamento; não o substitui.
32
- - **Coordenação na medida:** trabalho limitado vai para um especialista;
33
- planejamento, descoberta, trabalho paralelo e revisão entram quando escopo e
34
- risco pedem. `/pantheon-deepwork` continua sendo o fluxo com checkpoints para
35
- trabalho pesado em várias fases.
32
+ - **Coordenação na medida:** trabalho delimitado vai para um especialista, que
33
+ reúne o contexto necessário. Planejamento, descoberta separada, paralelismo e
34
+ revisão entram quando escopo e risco pedem. `/pantheon-deepwork` continua sendo
35
+ o fluxo com checkpoints para trabalho pesado em várias fases.
36
36
 
37
37
  ## Comece em 2 minutos
38
38
 
@@ -78,10 +78,11 @@ apenas — `init` → reiniciar → `/dispatch` → primeiro resultado — veja
78
78
  - **Uma TUI opcional**, com bloco de dispatch na sidebar e painel `/dispatch`
79
79
  em largura total.
80
80
 
81
- A memória é usada seletivamente: o coordenador busca uma vez apenas quando o
82
- histórico do projeto pode afetar a tarefa e repassa os resultados relevantes aos
83
- especialistas. Grave um resultado conciso e reutilizável ao concluir a tarefa
84
- quando ele for importar depois; resumos rotineiros de filhos ficam no handoff.
81
+ A memória MCP fica disponível para busca explícita: o coordenador consulta o
82
+ histórico uma vez quando ele pode mudar a tarefa e repassa apenas resultados
83
+ úteis. Checkpoints de sessão servem para retomadas entre sessões; memória
84
+ durável só é gravada quando solicitada ou autorizada. A compactação nativa do
85
+ OpenCode resume a conversa atual, sem salvar cada fase em outro MCP.
85
86
  Veja [Memória](docs/MEMORY.md).
86
87
 
87
88
  ## Compatibilidade
@@ -155,6 +156,10 @@ bem-vindos. Leia o [CONTRIBUTING.md](CONTRIBUTING.md) antes de abrir uma issue o
155
156
  pull request. Esse arquivo também define a regra de documentação: um único lar
156
157
  por fato, com uma lista curta de fatos que não devem ser duplicados.
157
158
 
159
+ Em mudanças de código, comece pela verificação relevante mais pequena e amplie
160
+ conforme o risco. `npm test` executa a suíte completa do repositório; veja o
161
+ [CONTRIBUTING.md](CONTRIBUTING.md) para saber quando usá-la.
162
+
158
163
  ## Citação e DOI
159
164
 
160
165
  O Pantheon é distribuído sob a [Licença MIT](LICENSE). Cite o