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.
- package/AGENTS.global.md +11 -11
- package/AGENTS.md +2 -2
- package/CHANGELOG.md +45 -0
- package/README.md +122 -6
- package/README.pt-BR.md +14 -9
- package/bin/pantheon-init.mjs +255 -39
- package/package.json +8 -6
- package/plugin.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/build-agents-md.mjs +1 -1
- package/scripts/doctor.mjs +231 -46
- package/scripts/install/agents-md.mjs +2 -1
- package/scripts/install/config-migration.mjs +344 -393
- package/scripts/install/config-paths.mjs +15 -0
- package/scripts/install/interactive.mjs +30 -9
- package/scripts/install/interrupt.mjs +78 -0
- package/scripts/install/mcp-permissions.mjs +164 -0
- package/scripts/install/opencode-state.mjs +91 -0
- package/scripts/install/opencode-version.mjs +31 -13
- package/scripts/install/opencode-wildcard.mjs +106 -0
- package/scripts/install/opencode.mjs +508 -108
- package/scripts/install/plan-artifact.mjs +12 -1
- package/scripts/install/plugin.mjs +17 -1
- package/scripts/install/run-record.mjs +115 -0
- package/scripts/install/strings.mjs +35 -6
- package/scripts/install/v2-capabilities.mjs +204 -0
- package/scripts/package-evidence.mjs +1 -0
- package/scripts/release-gates.mjs +7 -2
- package/scripts/sandbox-env.sh +174 -0
- package/scripts/setup-v2-config.mjs +1703 -0
- package/scripts/setup.mjs +415 -0
- package/scripts/sync-tui.mjs +9 -1
- package/scripts/test-opencode-v2-sandbox.sh +438 -151
- package/scripts/update-skills-lock.mjs +30 -0
- package/skills-lock.json +10 -10
- package/src/agents/aphrodite.md +5 -2
- package/src/agents/apollo.md +5 -0
- package/src/agents/athena.md +6 -1
- package/src/agents/demeter.md +5 -1
- package/src/agents/gaia.md +4 -0
- package/src/agents/hephaestus.md +6 -1
- package/src/agents/hermes.md +6 -3
- package/src/agents/iris.md +5 -1
- package/src/agents/mnemosyne.md +20 -50
- package/src/agents/nyx.md +5 -1
- package/src/agents/prometheus.md +4 -0
- package/src/agents/talos.md +4 -0
- package/src/agents/themis.md +4 -0
- package/src/agents/zeus.md +9 -3
- package/src/instructions/agent-return-format.instructions.md +1 -1
- package/src/instructions/memory-protocol.instructions.md +3 -3
- package/src/instructions/test-economy.instructions.md +6 -6
- package/src/mcp/pantheon_vision.py +37 -36
- package/src/mcp/requirements-mcp.txt +1 -1
- package/src/mcp/requirements-vision.txt +1 -1
- package/src/pantheon/cost-command.ts +127 -40
- package/src/pantheon/delegation-enforce.ts +160 -23
- package/src/pantheon/guard-path.ts +162 -0
- package/src/pantheon/v2-bounded-read.ts +15 -1
- package/src/pantheon/v2-bridge.ts +27 -0
- package/src/pantheon/v2-shell-hooks.ts +260 -0
- package/src/pantheon/v2-unsupported.mjs +32 -4
- package/src/pantheon/v2-vision.ts +34 -29
- package/src/pantheon/vision.ts +49 -11
- package/src/plugin-v2.ts +413 -60
- package/src/plugin.ts +22 -2
- package/src/plugins/tui/dist/quota-adapters.d.ts +89 -0
- package/src/plugins/tui/dist/quota-adapters.d.ts.map +1 -0
- package/src/plugins/tui/dist/quota-adapters.js +1142 -0
- package/src/plugins/tui/dist/quota-adapters.js.map +1 -0
- package/src/plugins/tui/dist/quota-cli.d.ts +17 -0
- package/src/plugins/tui/dist/quota-cli.d.ts.map +1 -0
- package/src/plugins/tui/dist/quota-cli.js +184 -0
- package/src/plugins/tui/dist/quota-cli.js.map +1 -0
- package/src/plugins/tui/dist/quota-rpc-UL2HuFRJ.js +390 -0
- package/src/plugins/tui/dist/quota-rpc-UL2HuFRJ.js.map +1 -0
- package/src/plugins/tui/dist/server-v2.d.ts +14 -0
- package/src/plugins/tui/dist/server-v2.d.ts.map +1 -0
- package/src/plugins/tui/dist/server-v2.js +673 -0
- package/src/plugins/tui/dist/server-v2.js.map +1 -0
- package/src/plugins/tui/dist/tui-v2.d.ts +247 -52
- package/src/plugins/tui/dist/tui-v2.d.ts.map +1 -1
- package/src/plugins/tui/dist/tui-v2.js +2492 -529
- package/src/plugins/tui/dist/tui-v2.js.map +1 -1
- package/src/plugins/tui/dist/tui.js +1 -1
- package/src/plugins/tui/index-v2.ts +3 -6
- package/src/plugins/tui/package-lock.json +11 -11
- package/src/plugins/tui/package.json +6 -4
- package/src/plugins/tui/src/context-gauge.ts +59 -0
- package/src/plugins/tui/src/go-key-diagnostic-ui.ts +100 -0
- package/src/plugins/tui/src/go-key-diagnostic.ts +125 -0
- package/src/plugins/tui/src/index-v2.tsx +199 -240
- package/src/plugins/tui/src/model-usage-limits.ts +4 -0
- package/src/plugins/tui/src/quota-adapters.ts +1598 -0
- package/src/plugins/tui/src/quota-cli.ts +237 -0
- package/src/plugins/tui/src/quota-rpc.ts +209 -0
- package/src/plugins/tui/src/quota-v2-model.ts +1032 -0
- package/src/plugins/tui/src/quota-v2.tsx +986 -0
- package/src/plugins/tui/src/server-v2.ts +841 -0
- package/src/plugins/tui/src/sidebar-width.ts +129 -0
- package/src/plugins/tui/tsconfig.typecheck.json +1 -1
- package/src/plugins/tui/tsdown.config.ts +8 -1
- package/src/routing.yml +72 -13
- package/src/skills/README.md +4 -0
- package/src/skills/agent-coordination/SKILL.md +0 -3
- package/src/skills/artifact-management/SKILL.md +0 -3
- package/src/skills/auto-continue/SKILL.md +0 -3
- package/src/skills/code-review-checklist/SKILL.md +0 -3
- package/src/skills/context-compression/SKILL.md +0 -3
- package/src/skills/memory-bank/SKILL.md +6 -28
- package/src/skills/session-goal/SKILL.md +0 -3
- package/src/skills/simplify/SKILL.md +5 -4
- package/src/skills/tdd-with-agents/SKILL.md +0 -3
- package/src/skills/visual-review-pipeline/SKILL.md +0 -1
- 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-
|
|
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
|
|
80
|
-
-
|
|
81
|
-
-
|
|
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
|
|
87
|
+
Write one focused test per behavior; do not duplicate coverage.
|
|
88
88
|
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
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-
|
|
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
|
-
-
|
|
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
|
+
<!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
|
|
28
|
+
move this section to a versioned entry and reset the template below. -->
|
|
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
|
|
32
|
-
|
|
33
|
-
them. `/pantheon-deepwork`
|
|
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.
|
|
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 @
|
|
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
|
|
33
|
-
|
|
34
|
-
risco pedem. `/pantheon-deepwork` continua sendo
|
|
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
|
|
82
|
-
histórico
|
|
83
|
-
|
|
84
|
-
|
|
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
|