pantheon-opencode 1.7.0 → 2.0.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.global.md +2 -2
- package/AGENTS.md +3 -3
- package/CHANGELOG.md +85 -59
- package/README.md +74 -48
- package/README.pt-BR.md +19 -19
- package/bin/pantheon-init.mjs +11 -48
- package/package.json +9 -13
- package/plugin.json +2 -2
- package/pyproject.toml +1 -1
- package/scripts/build-agents-md.mjs +7 -6
- package/scripts/{check-plugin-v2-coverage.mjs → check-plugin-coverage.mjs} +7 -7
- package/scripts/{decision-router-v2-budget.mjs → decision-router-budget-gates.mjs} +1 -1
- package/scripts/{decision-router-v2-egress.mjs → decision-router-egress.mjs} +1 -1
- package/scripts/decision-router.mjs +2 -2
- package/scripts/docs-media.mjs +1 -1
- package/scripts/doctor.mjs +225 -136
- package/scripts/install/behavior-overrides.bundle.mjs +123 -0
- package/scripts/install/{v2-capabilities.mjs → capabilities.mjs} +7 -7
- package/scripts/install/config-migration.mjs +60 -253
- package/scripts/install/file-inventory.mjs +6 -4
- package/scripts/install/interactive.mjs +1 -1
- package/scripts/install/opencode-state.mjs +13 -12
- package/scripts/install/opencode-version.mjs +97 -162
- package/scripts/install/opencode.mjs +271 -428
- package/scripts/install/plan.mjs +1 -9
- package/scripts/install/plugin.mjs +19 -35
- package/scripts/install/shared.mjs +40 -1
- package/scripts/package-evidence.mjs +1 -4
- package/scripts/probe-pantheon-cost.mjs +1 -1
- package/scripts/reconcile.mjs +5 -7
- package/scripts/release-gates.mjs +22 -61
- package/scripts/setup-v2-config.mjs +10 -8
- package/scripts/setup.mjs +12 -22
- package/scripts/sync-tui.mjs +9 -17
- package/scripts/{test-opencode-v2-sandbox.sh → test-opencode-sandbox.sh} +9 -9
- package/scripts/update-skills-lock.mjs +24 -12
- package/scripts/update.mjs +17 -1
- package/scripts/validate-routing.mjs +79 -4
- package/scripts/validate-sandbox-install.mjs +3 -3
- package/skills-lock.json +25 -8
- package/src/agents/zeus.md +1 -0
- package/src/pantheon/behavior-overrides.ts +191 -0
- package/src/pantheon/{v2-bounded-read.ts → bounded-read.ts} +1 -1
- package/src/pantheon/cost-command.ts +1 -1
- package/src/pantheon/{v2-decision-contracts.ts → decision-contracts.ts} +3 -3
- package/src/pantheon/{v2-decision-points → decision-points}/p1-agent.ts +3 -3
- package/src/pantheon/{v2-decision-points → decision-points}/p10-claims.ts +2 -2
- package/src/pantheon/{v2-decision-points → decision-points}/p11-catalog.ts +2 -2
- package/src/pantheon/{v2-decision-points → decision-points}/p2-skill.ts +3 -3
- package/src/pantheon/{v2-decision-points → decision-points}/p3-complexity.ts +6 -6
- package/src/pantheon/{v2-decision-points → decision-points}/p4-memory.ts +2 -2
- package/src/pantheon/{v2-decision-points → decision-points}/p5-themis-verify.ts +2 -2
- package/src/pantheon/{v2-decision-points → decision-points}/p6-council.ts +3 -3
- package/src/pantheon/{v2-decision-points → decision-points}/p7-loop.ts +5 -5
- package/src/pantheon/{v2-decision-points → decision-points}/p8-guardrail.ts +2 -2
- package/src/pantheon/{v2-decision-points → decision-points}/p9-memory-compaction.ts +2 -2
- package/src/pantheon/{v2-decision-points.ts → decision-points.ts} +5 -5
- package/src/pantheon/{v2-decision-policy.ts → decision-policy.ts} +2 -2
- package/src/pantheon/{v2-decision-prompt-surface.ts → decision-prompt-surface.ts} +3 -3
- package/src/pantheon/{v2-decision-registry.ts → decision-registry.ts} +10 -13
- package/src/pantheon/{v2-decision-resource-ids.ts → decision-resource-ids.ts} +1 -1
- package/src/pantheon/{v2-decision-shadow.ts → decision-shadow.ts} +1 -1
- package/src/pantheon/{v2-decision-telemetry.ts → decision-telemetry.ts} +1 -1
- package/src/pantheon/{v2-execute-after.ts → execute-after.ts} +4 -4
- package/src/pantheon/goal-store.ts +7 -0
- package/src/pantheon/{v2-hook-engine.ts → hook-engine.ts} +3 -3
- package/src/pantheon/jev-decision-tool.ts +3 -3
- package/src/pantheon/jev-decisions.ts +12 -6
- package/src/pantheon/jev-escalation.ts +6 -6
- package/src/pantheon/jev-quality-score.ts +2 -2
- package/src/pantheon/jev-rank-verify.ts +2 -2
- package/src/pantheon/jev-risk-gate.ts +4 -4
- package/src/pantheon/local-decision-agents.ts +1 -1
- package/src/pantheon/local-decision-router.ts +1 -1
- package/src/pantheon/local-decision-tool.ts +2 -2
- package/src/pantheon/local-orchestration.ts +1 -1
- package/src/pantheon/model-command.ts +1 -1
- package/src/pantheon/{v2-vision.ts → native-vision.ts} +12 -15
- package/src/pantheon/pantheon-decision-catalog.ts +12 -0
- package/src/pantheon/{v2-shell-hooks.ts → shell-hooks.ts} +4 -4
- package/src/pantheon/{v2-tools.ts → tools.ts} +4 -4
- package/src/pantheon/{v2-unsupported.d.mts → unsupported.d.mts} +3 -3
- package/src/pantheon/{v2-unsupported.mjs → unsupported.mjs} +8 -8
- package/src/pantheon/update-notifier.ts +101 -0
- package/src/pantheon/vision-local.ts +12 -3
- package/src/pantheon/vision.ts +120 -2
- package/src/{plugin-v2 → plugin}/index.ts +7 -7
- package/src/plugin.ts +2870 -500
- package/src/plugins/hook-runner.ts +3 -3
- package/src/plugins/tui/dist/server.d.ts +23 -9
- package/src/plugins/tui/dist/server.d.ts.map +1 -1
- package/src/plugins/tui/dist/server.js +25 -12
- package/src/plugins/tui/dist/server.js.map +1 -1
- package/src/plugins/tui/dist/tui.d.ts +1023 -494
- package/src/plugins/tui/dist/tui.d.ts.map +1 -1
- package/src/plugins/tui/dist/tui.js +5612 -2086
- package/src/plugins/tui/dist/tui.js.map +1 -1
- package/src/plugins/tui/{index-v2.ts → index.ts} +1 -1
- package/src/plugins/tui/package-lock.json +2 -42
- package/src/plugins/tui/package.json +4 -10
- package/src/plugins/tui/src/cost-data.ts +1 -1
- package/src/plugins/tui/src/decision-router-state.ts +242 -0
- package/src/plugins/tui/src/doctor-state.ts +198 -0
- package/src/plugins/tui/src/index.tsx +4222 -2822
- package/src/plugins/tui/src/j1-gate-status.ts +85 -0
- package/src/plugins/tui/src/pantheon-settings-state.ts +245 -0
- package/src/plugins/tui/src/pantheon-settings.tsx +442 -0
- package/src/plugins/tui/src/preset-state.ts +143 -0
- package/src/plugins/tui/src/server.ts +23 -10
- package/src/plugins/tui/src/update-notice.ts +90 -0
- package/src/plugins/tui/src/update-status.ts +98 -0
- package/src/plugins/tui/tsconfig.typecheck.json +9 -2
- package/src/plugins/tui/tsdown.config.ts +3 -5
- package/src/plugins/tui/tui.ts +1 -2
- package/src/routing.yml +36 -0
- package/src/skills/README.md +16 -1
- package/src/skills/artifact-management/SKILL.md +10 -67
- package/src/skills/artifact-management/references/artifact-templates.md +71 -0
- package/src/skills/auto-continue/SKILL.md +10 -0
- package/src/skills/code-review-checklist/SKILL.md +11 -44
- package/src/skills/code-review-checklist/references/review-checklists.md +54 -0
- package/src/skills/instruction-forge/SKILL.md +57 -0
- package/src/skills/instruction-forge/references/agents-md-doctrine.md +50 -0
- package/src/skills/instruction-forge/references/eval-doctrine.md +37 -0
- package/src/skills/instruction-forge/references/skill-doctrine.md +62 -0
- package/src/skills/memory-bank/SKILL.md +11 -90
- package/src/skills/memory-bank/references/anti-patterns.md +33 -0
- package/src/skills/memory-bank/references/product-adoption.md +19 -0
- package/src/skills/memory-bank/references/storage-model.md +21 -0
- package/src/skills/memory-bank/references/structure-and-frequency.md +44 -0
- package/src/skills/reflect/SKILL.md +1 -0
- package/src/skills/session-goal/SKILL.md +7 -54
- package/src/skills/session-goal/references/goal-format.md +26 -0
- package/src/skills/session-goal/references/session-reuse.md +44 -0
- package/src/skills/tdd-with-agents/SKILL.md +11 -101
- package/src/skills/tdd-with-agents/references/advanced-testing-patterns.md +58 -0
- package/src/skills/tdd-with-agents/references/testing-by-layer.md +60 -0
- package/src/skills/visual-review-pipeline/SKILL.md +11 -120
- package/src/skills/visual-review-pipeline/references/findings-schema.md +49 -0
- package/src/skills/visual-review-pipeline/references/workflow-steps.md +111 -0
- package/scripts/hooks/log-session-start.sh +0 -48
- package/scripts/hooks/validate-post-conditions.sh +0 -21
- package/scripts/hooks/validate-talos-scope.sh +0 -50
- package/scripts/hooks/validate-tool-safety.sh +0 -49
- package/src/pantheon/goal-loop.ts +0 -314
- package/src/pantheon/idle-continuation.ts +0 -52
- package/src/pantheon/todo-preserve.ts +0 -301
- package/src/pantheon/tool-ceiling.ts +0 -159
- package/src/pantheon/v2-bridge.ts +0 -153
- package/src/plugin-v2.ts +0 -2954
- package/src/plugins/pantheon-hooks.ts +0 -1433
- package/src/plugins/tui/dist/server-v2.d.ts +0 -30
- package/src/plugins/tui/dist/server-v2.d.ts.map +0 -1
- package/src/plugins/tui/dist/server-v2.js +0 -33
- package/src/plugins/tui/dist/server-v2.js.map +0 -1
- package/src/plugins/tui/dist/tui-v2.d.ts +0 -1039
- package/src/plugins/tui/dist/tui-v2.d.ts.map +0 -1
- package/src/plugins/tui/dist/tui-v2.js +0 -4597
- package/src/plugins/tui/dist/tui-v2.js.map +0 -1
- package/src/plugins/tui/src/index-v2.tsx +0 -4496
- package/src/plugins/tui/src/server-v2.ts +0 -28
- package/src/plugins/tui/tui-v2.ts +0 -2
- /package/src/pantheon/{v2-decision-budget.ts → decision-budget.ts} +0 -0
- /package/src/pantheon/{v2-decision-egress.ts → decision-egress.ts} +0 -0
- /package/src/pantheon/{v2-decision-events.ts → decision-events.ts} +0 -0
- /package/src/pantheon/{v2-decision-heuristic.ts → decision-heuristic.ts} +0 -0
- /package/src/pantheon/{v2-decision-premises.ts → decision-premises.ts} +0 -0
- /package/src/pantheon/{v2-decision-rank.ts → decision-rank.ts} +0 -0
- /package/src/pantheon/{v2-decision-verify.ts → decision-verify.ts} +0 -0
- /package/src/pantheon/{v2-delegation-enforce.ts → delegation-policy.ts} +0 -0
- /package/src/pantheon/{v2-model-overrides.ts → model-overrides.ts} +0 -0
- /package/src/pantheon/{v2-native-decisions.ts → native-decisions.ts} +0 -0
- /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-
|
|
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`,
|
|
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-
|
|
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
|
-
-
|
|
27
|
+
- worktrees não vivem dentro de `.pantheon/`.
|
|
28
28
|
|
|
29
29
|
## Conventions
|
|
30
30
|
|
package/CHANGELOG.md
CHANGED
|
@@ -7,93 +7,119 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
|
7
7
|
|
|
8
8
|
## [v1.7.0] - 2026-11-07
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
- **
|
|
12
|
-
- **
|
|
13
|
-
- **
|
|
14
|
-
- **
|
|
15
|
-
- **prompt-refinery in three tiers**: clear requests pass intact; vague ones get a silent internal adjust (≤15 lines); the full contract is `>>`-gated.
|
|
16
|
-
- **The roster modernized**: nyx/chaos restored, agent descriptions aligned to the catalog, PT-BR delegations fed by the agent-scoped fallback.
|
|
17
|
-
- **Local router debt paid**: gate influence (GATE_OPEN), artifact-management reachable, dimension polarity documented.
|
|
18
|
-
- **Setup**: decision-layer extras ship pre-checked; the installer heals the stale agent-source poison in BOTH configs (.json + .jsonc).
|
|
10
|
+
- **Typed decision router with a real budget**: delegation, skills, ORDER, rank, verify and review modes — budgeted, reconciled, ~$0.000025 per call.
|
|
11
|
+
- **J1 risk gate with a ladder**: off / shadow / warn / enforce — high-risk calls demand explicit human approval, never bypassed.
|
|
12
|
+
- **agent-forge**: forge an OpenCode agent on demand — interview, draft, confirm, write to project or user scope.
|
|
13
|
+
- **Skill discovery with a trust cascade**: Anthropic catalog → skills.sh → raw GitHub; Jev ranks; you install.
|
|
14
|
+
- **prompt-refinery in three tiers**: clear requests pass; vague ones get a silent internal adjust; full contract is `>>`-gated.
|
|
19
15
|
- **Last version supporting the OpenCode V1 contract (1.19.x)** — the next minor targets OpenCode 2.x only.
|
|
20
16
|
|
|
21
|
-
###
|
|
22
|
-
- "Agent not found: zeus" (cwd-relative source poison, both configs healed)
|
|
23
|
-
- N4 USAGE_UNRECONCILED 100% (dead — field-verified reconcile)
|
|
24
|
-
- The dead-route holds freezing budgets (released with schema v4 archive)
|
|
25
|
-
- The TUI footer version drift (release gate now enforces the dist stamp)
|
|
17
|
+
### Added
|
|
26
18
|
|
|
19
|
+
- **routing** — `mode: "order"` on `pantheon_jev_decide`: real top-K ordering of 2-4 candidates with a per-candidate fit score (an ordinal on the 2..10 rubric, never a probability).
|
|
20
|
+
- **routing** — `mode: "verify"` accepts optional `state` evidence the claims are judged against; verdicts PASS / UNVERIFIABLE / FAIL with BLOCK fail-closed on missing or refused answers.
|
|
21
|
+
- **routing** — rank accepts up to 20 candidates (typesafe_rank contract) and `CANDIDATE_INVALID` names the accepted range.
|
|
22
|
+
- **routing** — the input envelope is enforced on EVERY path (explicit, presets, review, rank, verify): schemaVersion required, unknown keys rejected with the exact cause.
|
|
23
|
+
- **routing** — review accepts criteria objects (`{id, description}`) alongside strings; refusals carry the `CRITERIA_SHAPE` detail.
|
|
24
|
+
- **routing** — `CALLER_NOT_ALLOWED` names the remedy: allowlist via `PANTHEON_JEV_SPECIALIST_CALLERS` or route through Zeus.
|
|
25
|
+
- **skills** — `agent-forge`: forge an OpenCode agent on demand — interview, canonical draft, confirm, write to project or user scope; never overwrites.
|
|
26
|
+
- **skills** — prompt-refinery in three tiers with the trust-cascade discovery ranking.
|
|
27
|
+
- **install** — decision-layer extras (J1/J3 shadow gates, specialist callers) ship pre-checked in the interactive setup.
|
|
27
28
|
|
|
28
|
-
###
|
|
29
|
+
### Changed
|
|
29
30
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
31
|
+
- **routing** — the J1 escalation ladder: off / shadow / warn / enforce via `PANTHEON_J1_RISK_SCORE`, with `PANTHEON_J1_ENFORCE_THRESHOLD` (default 0.8).
|
|
32
|
+
- **routing** — enforce denies a high-risk call with the HANDOFF CONTRACT: the agent presents the refused call for your manual decision; your approval mints a hash-pinned, TTL-bounded pass.
|
|
33
|
+
- **routing** — `CALLER_NOT_ALLOWED` names the remedy (allowlist via `PANTHEON_JEV_SPECIALIST_CALLERS` or route through Zeus).
|
|
34
|
+
- **skills** — the discovery ladder ranks candidates with Jev `mode: "order"` and documents the trust tiers; `mattpocock/skills` referenced for the GitHub tier.
|
|
35
|
+
- **agents** — nyx back to observability & cost analytics (chaos/fuzz secondary); prometheus without the observability words; mnemosyne and talos descriptions aligned to the catalog.
|
|
36
|
+
- **agents** — plan-persistence contract: Athena returns the plan, Zeus persists PLAN.md.
|
|
37
|
+
- **install** — decision-layer extras ship pre-checked; the installer heals the stale agent-source poison in BOTH configs (.json + .jsonc), repairing orphan commas.
|
|
38
|
+
- **docs** — README with mermaid diagrams (escalation ladder, refine tiers, trust cascade); COMPATIBILITY table updated for the 1.7.x line.
|
|
34
39
|
|
|
35
|
-
###
|
|
40
|
+
### Deprecated
|
|
36
41
|
|
|
37
|
-
-
|
|
38
|
-
- **`mode: "verify"` com evidência**: envelope aceita `state` opcional que vira o texto-base do julgamento; vereditos PASS (>0.65) / UNVERIFIABLE (0.35-0.65) / FAIL (<0.35); ausente/recusado = BLOCK fail-closed.
|
|
39
|
-
- **Rank até 20 candidatos** (contrato typesafe_rank) com o range nomeado na recusa (`RANK_CANDIDATE_COUNT_RANGE`).
|
|
40
|
-
- **Envelope enforced em TODOS os caminhos** (explícito, presets, review, rank, verify): schemaVersion exigido, chaves desconhecidas rejeitadas, com `detail` exato por causa.
|
|
41
|
-
- **Review aceita critérios-objeto** (`{id, description}`) além de strings; recusa com `CRITERIA_SHAPE` detalhado.
|
|
42
|
-
- **`CALLER_NOT_ALLOWED` ensina o remédio**: `PANTHEON_JEV_SPECIALIST_CALLERS` ou rotear via Zeus.
|
|
43
|
-
- Descrições de agentes nas choices do delegation (o viés "none com confiança alta" em tarefa clara morreu: live 5/5).
|
|
42
|
+
- **OpenCode V1 contract (1.19.x)** — supported through this release, deprecated afterward: the next minor targets OpenCode 2.x only.
|
|
44
43
|
|
|
45
|
-
###
|
|
44
|
+
### Removed
|
|
46
45
|
|
|
47
|
-
- **
|
|
48
|
-
- **
|
|
49
|
-
- Gate indisponível nunca bloqueia (fail-open documentado: budget morto não bricka shells).
|
|
46
|
+
- **The lexical skills prefilter** — replaced by the full-catalog offer (the filter dropped the exact skill the state described).
|
|
47
|
+
- **The Console Jev free-variant route** and the legacy PR+SHA beta-version scheme.
|
|
50
48
|
|
|
51
|
-
###
|
|
49
|
+
### Fixed
|
|
52
50
|
|
|
53
|
-
-
|
|
54
|
-
- **
|
|
55
|
-
- **
|
|
51
|
+
- **routing** — "Agent not found: zeus": the installer heals the stale cwd-relative agent-source field in both configs (root cause of the vanished roster).
|
|
52
|
+
- **routing** — N4 USAGE_UNRECONCILED 100%: dead — field-verified reconcile on the OpenRouter route.
|
|
53
|
+
- **routing** — the dead-route holds freezing budgets: released with the schema v4 archive.
|
|
54
|
+
- **routing** — D1/D2 of the local router: gateStatus influences the decision (GATE_OPEN); artifact-management reachable via material-requirement.
|
|
55
|
+
- **tui** — the version embed ships at the release version (the package gate now fails a stale TUI dist).
|
|
56
|
+
- **doctor** — recognizes the installer's own V2 shape (`{ package, options }`).
|
|
56
57
|
|
|
57
|
-
###
|
|
58
|
+
### Security
|
|
58
59
|
|
|
59
|
-
-
|
|
60
|
-
- **Heal do campo `source` cwd-relativo** nos dois configs (`.json` e `.jsonc`) — a causa raiz do "Agent not found".
|
|
61
|
-
- **`test:ci` prefere o venv do repo** — o tier Python roda os pins, não o sistema.
|
|
62
|
-
- **Gate de release**: o dist da TUI precisa carregar a versão da release — rodapé mentiroso não publica mais.
|
|
60
|
+
- The input envelope is closed on every path; hostile-prose scans cover criteria, claims and candidates; gate messages never echo tool input; approvals are hash-pinned to the exact refused call.
|
|
63
61
|
|
|
64
|
-
|
|
62
|
+
---
|
|
65
63
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
64
|
+
## [Unreleased]
|
|
65
|
+
|
|
66
|
+
<!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
|
|
67
|
+
move this section to a versioned entry and reset the template below. -->
|
|
68
|
+
|
|
69
|
+
## [v2.0.0-beta.2] - 2026-11-09
|
|
70
|
+
|
|
71
|
+
### Added
|
|
72
|
+
|
|
73
|
+
- **tui** — the settings window becomes a sectioned window (`tab` cycles sections): Gates & Overrides, Decision Model, Model Preset, J1 Risk Gate, Updates, Doctor, About
|
|
74
|
+
- **tui** — Decision Model section: enable/disable the decision router live — the runtime re-reads the config on every gated call; egress consent stays CLI-owned and enabling remote candidates without it is refused
|
|
75
|
+
- **tui** — Model Preset section: activate any routing.yml preset globally (atomic write, `.bak` backup); `none` deletes the marker; a project marker wins every runtime candidate list and shows read-only
|
|
76
|
+
- **tui** — J1 Risk Gate status section: ladder mode, enforce threshold, effective gate state — the env-only config is displayed, never written (a file surface is a runtime-plugin change, deferred)
|
|
77
|
+
- **tui** — Updates section: channel classification (prerelease suffix → `beta`), last-check state, and a `Check now` action against the registry dist-tag matching the running channel; a stable install is never advertised a beta
|
|
78
|
+
- **tui** — Doctor section: install-version drift (H2), Node floor, overrides-file validation (K), decision-config health — file-derived checks only; process/network checks stay in `pantheon-opencode doctor`
|
|
72
79
|
|
|
73
80
|
### Changed
|
|
74
81
|
|
|
75
|
-
- **
|
|
76
|
-
- **nyx de volta à identidade observabilidade/custo** (chaos/fuzz como secundário); prometheus sem as palavras de observabilidade; TUI dist no carimbo da release.
|
|
77
|
-
- **full-catalog no skills mode** — o prefilter lexical não derruba mais a skill exata que o estado descreve.
|
|
82
|
+
- **tui** — the typecheck gate points at real files: the old includes referenced deleted V2 entries, so nothing had been type-checked since the rewrite; the settings modules typecheck under the repo's strict settings and update-notice's latent violations are fixed
|
|
78
83
|
|
|
79
|
-
###
|
|
84
|
+
### Fixed
|
|
80
85
|
|
|
81
|
-
-
|
|
86
|
+
- **tui** — the settings window is closable again: `dialog.clear()` inside the host's dismissal path re-entered the dialog stack and left the window permanent (beta.1 field report)
|
|
87
|
+
- **tui** — overrides state guards: a corrupt global overrides file refuses writes instead of silently dropping the other entries on the next toggle; `replace` entries survive disable (content preserved) and restore on re-enable; project-file entries show a `(project)` marker and are not togglable from the window
|
|
82
88
|
|
|
83
|
-
|
|
89
|
+
<!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
|
|
90
|
+
move this section to a versioned entry and reset the template below. -->
|
|
91
|
+
## [v2.0.0-beta.1] - 2026-11-08
|
|
84
92
|
|
|
85
|
-
|
|
93
|
+
### Added
|
|
86
94
|
|
|
87
|
-
|
|
95
|
+
- **skills** — progressive disclosure across the corpus: `references/` + Routing tables, 120-line core budget, lock pins every reference; instruction-forge doctrine skill
|
|
96
|
+
- **routing** — named-behavior overrides: registry in routing.yml, pure loader, installer skip/replace, doctor validation with --fix quarantine
|
|
97
|
+
- **validate** — structural instruction evals (tests/eval) in the regular node tier; the secret-mask parity pins the single TypeScript copy
|
|
98
|
+
- **install** — native plugin-add happy path (`opencode plugin add pantheon-opencode`); npx init demoted to the 1.x migration path
|
|
99
|
+
- **routing** — Jev choice ceiling 32 with reserved host-skill slots (host skills always ride, field report beta.15)
|
|
100
|
+
- **tui** — `/pantheon-settings` window (palette: `Pantheon: Settings`): keyboard-first toggles for the runtime gates, writing the global `pantheon-overrides.json` the installer and doctor consume
|
|
88
101
|
|
|
89
|
-
|
|
102
|
+
### Changed
|
|
90
103
|
|
|
91
|
-
|
|
92
|
-
|
|
104
|
+
- **plugin** — one generation, canonical names: src/plugin.ts, decision-* modules, tui/server TUI, PANTHEON_* env vars
|
|
105
|
+
- **installer** — the probe must confirm OpenCode 2.x before any write; the singular plugin key is legacy cleanup; version-gate tests speak the refusal contract
|
|
106
|
+
- **doctor** — named-behavior override validation (check K) with --fix quarantine; the report names its source database
|
|
93
107
|
|
|
108
|
+
### Fixed
|
|
109
|
+
|
|
110
|
+
- **vision** — temp-dir reconciliation: restart orphans in `pantheon-vision` become visible to the LRU disk cap again, and crash strays (`.tmp-<pid>`) are swept age-guarded
|
|
111
|
+
|
|
112
|
+
### Removed
|
|
113
|
+
|
|
114
|
+
- **plugin** — the OpenCode V1 contract (1.19.x hosts): V1 plugin, bridge, hooks, goal-loop lifecycle, tool-ceiling, presets application
|
|
115
|
+
- **validate** — the v1-permission canary proofs and the dual-generation test branches
|
|
116
|
+
|
|
117
|
+
### Security
|
|
118
|
+
|
|
119
|
+
- vision-local mime detection linearized (js/polynomial-redos); budget child scripts pass data via argv (js/bad-code-sanitization); the egress endpoint assertion parses URLs
|
|
94
120
|
## [v1.7.0-beta.1] - 2026-11-07
|
|
95
121
|
|
|
96
|
-
## 🆕 What's New
|
|
122
|
+
## 🆕 What's New
|
|
97
123
|
- **`mode: "order"`** no Jev: ordenação real de 2-4 candidatos com score por candidato (rank escolhe vencedor; order classifica a shortlist).
|
|
98
124
|
- **J1 approval gate** com escada off/shadow/warn/enforce: chamada de risco alto exige APROVAÇÃO EXPLÍCITA do usuário (hash-pinned, TTL 15min) — nunca contorno.
|
|
99
125
|
- **`agent-forge`**: cria um agente OpenCode sob demanda — entrevista, rascunho canônico, confirmação, gravação em escopo projeto/global.
|
package/README.md
CHANGED
|
@@ -73,17 +73,21 @@ flowchart LR
|
|
|
73
73
|
|
|
74
74
|
## Start in 2 minutes
|
|
75
75
|
|
|
76
|
-
Requirements: [OpenCode](https://opencode.ai/docs/) **
|
|
77
|
-
|
|
78
|
-
|
|
76
|
+
Requirements: [OpenCode](https://opencode.ai/docs/) **2.x** and Node.js
|
|
77
|
+
**>=26.4.0** for the CLI and tooling. **OpenCode 2.0.22 is known broken**; see
|
|
78
|
+
[Compatibility](docs/COMPATIBILITY.md).
|
|
79
79
|
|
|
80
|
-
From
|
|
80
|
+
From anywhere (global, all projects) or inside a project:
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
|
-
|
|
83
|
+
opencode plugin add pantheon-opencode
|
|
84
|
+
# or pin it: opencode plugin add pantheon-opencode@<version>
|
|
84
85
|
opencode
|
|
85
86
|
```
|
|
86
87
|
|
|
88
|
+
Restart OpenCode when prompted. `npx pantheon-opencode init` remains only
|
|
89
|
+
as the OpenCode 1.x migration path and an opt-in project scaffolding tool.
|
|
90
|
+
|
|
87
91
|
Direct `init` uses the same component defaults in TTY and headless runs:
|
|
88
92
|
`agents`, `skills`, `instructions`, `commands`, and `plugins`. `runtime` and
|
|
89
93
|
`prompts` are opt-in. A TTY run selects components and target, shows a preview,
|
|
@@ -91,18 +95,18 @@ then asks once for final authorization (default **no**). Without a TTY, `init`
|
|
|
91
95
|
is preview-only unless `--yes` explicitly authorizes the apply; `--yes` skips
|
|
92
96
|
prompts but still prints the preview and checks for drift.
|
|
93
97
|
|
|
94
|
-
`npm run setup` is a separate repository setup wrapper. On detected
|
|
95
|
-
it reviews the global config before installer init: legacy
|
|
96
|
-
be migrated after explicit review. Config migration and
|
|
97
|
-
preflighted before one final authorization; `--yes`
|
|
98
|
-
setup writes, and headless/CI setup remains
|
|
99
|
-
`npx pantheon-opencode init` does not run that
|
|
100
|
-
the [installation guide](docs/INSTALLATION.md)
|
|
101
|
-
choices, backups, and recovery.
|
|
102
|
-
Existing native
|
|
98
|
+
`npm run setup` is a separate repository setup wrapper. On a detected
|
|
99
|
+
OpenCode 2.x host it reviews the global config before installer init: legacy
|
|
100
|
+
permission rules can be migrated after explicit review. Config migration and
|
|
101
|
+
installer changes are preflighted before one final authorization; `--yes`
|
|
102
|
+
alone does not authorize setup writes, and headless/CI setup remains
|
|
103
|
+
preview-only. Direct `npx pantheon-opencode init` does not run that
|
|
104
|
+
config-migration review. See the [installation guide](docs/INSTALLATION.md)
|
|
105
|
+
for layer handling, conflict choices, backups, and recovery.
|
|
106
|
+
Existing native `permissions` arrays remain authoritative. Unsafe MCP
|
|
103
107
|
wildcard policies and ineffective `ask` rules require explicit resolution;
|
|
104
108
|
third-party flat MCP entries in `opencode.jsonc` must be converted to
|
|
105
|
-
`mcp.servers` or removed before
|
|
109
|
+
`mcp.servers` or removed before setup.
|
|
106
110
|
|
|
107
111
|
Global `init` and `setup` use `$XDG_CONFIG_HOME/opencode` when
|
|
108
112
|
`XDG_CONFIG_HOME` is absolute; otherwise they use `~/.config/opencode`.
|
|
@@ -118,9 +122,8 @@ When you ask for a plan, Athena returns it to Zeus, who displays it in the main
|
|
|
118
122
|
conversation before asking for approval — never as a plan hidden in a child
|
|
119
123
|
agent's conversation.
|
|
120
124
|
|
|
121
|
-
Restart OpenCode after installing or changing the plugin
|
|
122
|
-
|
|
123
|
-
registered together.
|
|
125
|
+
Restart OpenCode after installing or changing the plugin. Pantheon registers a
|
|
126
|
+
single plugin; a host never loads two Pantheon plugins.
|
|
124
127
|
|
|
125
128
|
Installer flags, exit codes, saved plans, backup and restore, uninstall,
|
|
126
129
|
reconcile, and MCP pins are in the [installation guide](docs/INSTALLATION.md).
|
|
@@ -131,7 +134,7 @@ see [Quick Start](docs/QUICKSTART.md).
|
|
|
131
134
|
|
|
132
135
|
- **14 specialized agents** with one orchestrator, implementation specialists,
|
|
133
136
|
a quality gate, and supporting roles.
|
|
134
|
-
- **
|
|
137
|
+
- **23 skills** and reusable instructions for planning, building, reviewing,
|
|
135
138
|
and documenting work.
|
|
136
139
|
- **5 local MCP servers** for project memory, persistence, resources, confined
|
|
137
140
|
script execution, and vision.
|
|
@@ -146,7 +149,7 @@ see [Quick Start](docs/QUICKSTART.md).
|
|
|
146
149
|
[router reference](docs/reference/local-decision-router.md) and the
|
|
147
150
|
[Native Decisions (Jev)](docs/reference/native-decisions.md).
|
|
148
151
|
- **An optional TUI** with a dispatch sidebar block and a full-width
|
|
149
|
-
`/dispatch` panel. The
|
|
152
|
+
`/dispatch` panel. The sidebar keeps the Pantheon version, the active
|
|
150
153
|
preset/source, git state, and a `Context` block (tokens, a percent gauge,
|
|
151
154
|
`$<spent> spent`, and a muted `cache <n>% · <n.n> tok/s` line); the native
|
|
152
155
|
prompt footer keeps its own line, and Pantheon only appends
|
|
@@ -154,10 +157,33 @@ see [Quick Start](docs/QUICKSTART.md).
|
|
|
154
157
|
version changes since the last TUI start, a one-time dismissable
|
|
155
158
|
"What's new" dialog lists that version's highlights from the shipped
|
|
156
159
|
changelog — once per version, `esc`/`q` dismisses; see
|
|
157
|
-
[What's new window](docs/reference/whats-new.md).
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
160
|
+
[What's new window](docs/reference/whats-new.md). `/pantheon-settings`
|
|
161
|
+
(also `Pantheon: Settings` in the command palette) opens the sectioned
|
|
162
|
+
settings window — `tab` cycles sections, `up`/`down` selects,
|
|
163
|
+
`enter` applies, `esc`/`q` closes:
|
|
164
|
+
|
|
165
|
+
- **Gates & Overrides** — toggle the named behaviors, writing the global
|
|
166
|
+
`pantheon-overrides.json` the installer and doctor consume. A corrupt
|
|
167
|
+
overrides file refuses writes (repair with `doctor --fix`); entries in the
|
|
168
|
+
project `.pantheon/overrides.json` win at runtime and are shown read-only.
|
|
169
|
+
- **Decision Model** — enable/disable the advisory decision router live
|
|
170
|
+
(the runtime re-reads the config per call). Egress consent stays
|
|
171
|
+
CLI-owned (`decision-router setup-model`).
|
|
172
|
+
- **Model Preset** — activate any routing.yml preset globally (atomic
|
|
173
|
+
write with a `.bak` backup); `none` clears the marker. A project
|
|
174
|
+
`.pantheon/active-preset.json` wins and shows read-only.
|
|
175
|
+
- **J1 Risk Gate** — ladder mode/threshold status; env-only config
|
|
176
|
+
(`PANTHEON_J1_*`), read at startup, never written here.
|
|
177
|
+
- **Updates** — channel and a `Check now` registry probe for the running
|
|
178
|
+
channel; adopt with `pantheon-opencode update`.
|
|
179
|
+
- **Doctor** — file-derived health: install-version drift, Node floor,
|
|
180
|
+
overrides and decision-config validation. The full check (MCP smoke,
|
|
181
|
+
venv pins, git) remains `pantheon-opencode doctor`.
|
|
182
|
+
|
|
183
|
+
The installer selects the `plugins` component by default; in interactive
|
|
184
|
+
setup you can change the component selection. A component-scoped install
|
|
185
|
+
includes the TUI only when `plugins` is selected. The TUI ships no quota
|
|
186
|
+
panel: for provider
|
|
161
187
|
quota and usage inside OpenCode, install the recommended community plugin
|
|
162
188
|
[`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota) — see
|
|
163
189
|
[Quota & usage](docs/tui-v2-quota-providers.md). `pantheon_cost` and
|
|
@@ -166,7 +192,7 @@ see [Quick Start](docs/QUICKSTART.md).
|
|
|
166
192
|
Vision requests to OpenCode Zen require a valid active session and are rejected
|
|
167
193
|
before image fetching or model-catalog lookup when the session is missing or
|
|
168
194
|
invalid. The Python vision MCP keeps its local metadata/OCR fallback when no
|
|
169
|
-
gateway credential is configured. In the
|
|
195
|
+
gateway credential is configured. In the plugin, an explicit Vision model
|
|
170
196
|
pin that is unavailable or ineligible returns an actionable error rather than
|
|
171
197
|
silently switching models; remove the pin to use automatic model discovery.
|
|
172
198
|
|
|
@@ -177,24 +203,24 @@ routine child summaries stay in the handoff. See [Memory](docs/MEMORY.md).
|
|
|
177
203
|
|
|
178
204
|
## Compatibility
|
|
179
205
|
|
|
180
|
-
OpenCode **
|
|
181
|
-
|
|
182
|
-
|
|
206
|
+
OpenCode **2.x** is supported. **OpenCode 2.0.22 is known broken.** **2.0
|
|
207
|
+
removes the OpenCode V1 contract entirely** — 1.7.x was the last line with V1
|
|
208
|
+
support.
|
|
183
209
|
|
|
184
210
|
The support policy, the known-broken exception, and the verified-version
|
|
185
211
|
evidence have exactly one home: [Compatibility](docs/COMPATIBILITY.md).
|
|
186
212
|
|
|
187
|
-
###
|
|
213
|
+
### Plugin options
|
|
188
214
|
|
|
189
|
-
The
|
|
190
|
-
|
|
191
|
-
|
|
215
|
+
The host hands a plugin its `options` only from the object form of the entry.
|
|
216
|
+
`init` writes that form for the optional per-request context pruner; memory
|
|
217
|
+
retrieval stays an explicit `memory_search` MCP call.
|
|
192
218
|
|
|
193
219
|
```json
|
|
194
220
|
{
|
|
195
221
|
"plugins": [
|
|
196
222
|
{
|
|
197
|
-
"package": "/path/to/pantheon-opencode/src/plugin
|
|
223
|
+
"package": "/path/to/pantheon-opencode/src/plugin",
|
|
198
224
|
"options": {
|
|
199
225
|
"context_pruner": { "enabled": true }
|
|
200
226
|
}
|
|
@@ -217,7 +243,7 @@ one-time warning in the hook log, so a typo cannot silently change behaviour. Ru
|
|
|
217
243
|
`npx pantheon-opencode doctor` to see whether the installed entry can receive
|
|
218
244
|
options at all. An old `memory_injection` option may remain in an existing
|
|
219
245
|
config because user options are preserved, but the plugin no longer reads it.
|
|
220
|
-
Full rules: [OpenCode
|
|
246
|
+
Full rules: [OpenCode 2.x](docs/opencode.md) and [Memory](docs/MEMORY.md).
|
|
221
247
|
|
|
222
248
|
## Delegation
|
|
223
249
|
|
|
@@ -252,9 +278,9 @@ historical/inactive, and legacy consent, caps, period, provider selection, or
|
|
|
252
278
|
credentials cannot activate it. Native child-session dispatch remains separate.
|
|
253
279
|
|
|
254
280
|
The one native egress surface is the Zeus-only `pantheon_jev_decide` tool,
|
|
255
|
-
available on hosts that expose the
|
|
281
|
+
available on hosts that expose the 2.2.5 native Decisions API; its full gate
|
|
256
282
|
chain, routes, and settlement rules are documented once in
|
|
257
|
-
[
|
|
283
|
+
[Native Decisions (Jev)](docs/reference/native-decisions.md). An opt-in second
|
|
258
284
|
consumer of that chain, the J1 risk-score shadow gate, fires one bounded
|
|
259
285
|
native decision per write/execute tool call behind `PANTHEON_J1_RISK_SCORE`
|
|
260
286
|
(off by default, zero overhead when off): the request carries no user content
|
|
@@ -324,26 +350,26 @@ test-only credential, verifies a local recommendation marker, and verifies zero
|
|
|
324
350
|
native Decisions or global `fetch` calls. This is an offline regression check of
|
|
325
351
|
that hook, not a claim about unexercised network paths or a live-provider test.
|
|
326
352
|
Measured surface coverage is
|
|
327
|
-
reported honestly rather than implied: P7 runs behind `
|
|
353
|
+
reported honestly rather than implied: P7 runs behind `PANTHEON_P7_LOOP` with
|
|
328
354
|
an **advisory** execution cap (never described as enforcement), P2 is
|
|
329
355
|
**advisory-only** (an empirical no-op on the default path), P9 was measured on
|
|
330
356
|
top-level **and child** sessions with `reason:"overflow"` still unmeasured, and
|
|
331
357
|
P8 is **advisory: not activatable by measurement** — its declared rules match no
|
|
332
358
|
delivered permission payload, so it narrows nothing (PROBE-F).
|
|
333
359
|
|
|
334
|
-
### The
|
|
360
|
+
### The decision layer is declared in full and wired in part
|
|
335
361
|
|
|
336
|
-
The
|
|
362
|
+
The decision layer declares eleven integration points (P1–P11) over three
|
|
337
363
|
decision primitives — `ask`, `rank`, and `verify` — and a deterministic policy
|
|
338
364
|
that decides which point may run. **Seven of the eleven have a production call
|
|
339
365
|
site: two behind flags that are off by default, five in shadow.**
|
|
340
366
|
|
|
341
367
|
- **P7 (loop)** is wired to `session.execution.succeeded` behind
|
|
342
|
-
`
|
|
368
|
+
`PANTHEON_P7_LOOP`, which is off. It writes each observation to an
|
|
343
369
|
in-memory, bounded telemetry collector that the plugin never reads back and
|
|
344
370
|
exposes only to tests, so "records" here does not mean an operator-visible log.
|
|
345
371
|
- **P8 (guardrail)** is wired to `permission.evaluate` behind
|
|
346
|
-
`
|
|
372
|
+
`PANTHEON_P8_GUARDRAIL`, which is off. C8 is closed **by measurement**, and
|
|
347
373
|
the measurement is negative: PROBE-F delivered 24 real `permission.evaluate`
|
|
348
374
|
events and every declared rule matched none of them (a valid `action` token and
|
|
349
375
|
a top-level `sessionID` are always present), the host resolves an unrecognised
|
|
@@ -404,7 +430,7 @@ What the layer does **not** do today, stated as measured rather than implied:
|
|
|
404
430
|
on the default path, because the host sends `prompt.skills` absent. Effective
|
|
405
431
|
project-skill filtering was cancelled by measurement, not emulated, and no
|
|
406
432
|
token reduction is claimed.
|
|
407
|
-
- **P7 (loop) is behind `
|
|
433
|
+
- **P7 (loop) is behind `PANTHEON_P7_LOOP`, off by default, and does not
|
|
408
434
|
enforce loop limits.** It counts executions and writes an `effect: none`
|
|
409
435
|
observation to an in-memory collector that nothing reads back. Its
|
|
410
436
|
12-execution cap is **advisory**: no measured host surface signals a new user
|
|
@@ -434,14 +460,14 @@ What the layer does **not** do today, stated as measured rather than implied:
|
|
|
434
460
|
gain or loss in retrieval or tokens is claimed in either direction.
|
|
435
461
|
|
|
436
462
|
Calibration that was run: the offline harness
|
|
437
|
-
(`npx tsx tests/pantheon/
|
|
463
|
+
(`npx tsx tests/pantheon/decision-harness.test.ts`) executed 264 synthetic
|
|
438
464
|
cases — 132 normal, 66 refusal, 66 adversarial — across the eleven points, with
|
|
439
465
|
24 cases per point and the suite asserting at least 20 cases, 5 refusals and 5
|
|
440
466
|
adversarial cases per point. All 264 cases passed on 2026-10-31. This harness is
|
|
441
467
|
the only place all eleven points are exercised in one run, but it imports no
|
|
442
468
|
adapter module: it iterates the registry and exercises the shared primitives,
|
|
443
469
|
while the adapters are covered by their per-point suites
|
|
444
|
-
(`
|
|
470
|
+
(`decision-p1.test.ts` … `decision-p11.test.ts`). Passing it says nothing
|
|
445
471
|
about whether a point is registered in a host.
|
|
446
472
|
The harness measures contracts (admission, refusal, shadow no-op, telemetry
|
|
447
473
|
redaction, offline discipline, registry integrity), **not** token use, quality,
|
|
@@ -455,10 +481,10 @@ recorded in the [router reference](docs/reference/local-decision-router.md).
|
|
|
455
481
|
| [Installation](docs/INSTALLATION.md) | [Architecture](docs/ARCHITECTURE.md) |
|
|
456
482
|
| [Quick Start](docs/QUICKSTART.md) | [MCP](docs/MCP.md) · [MCP tools](docs/mcp-tools.md) |
|
|
457
483
|
| [Upgrading](docs/UPGRADING.md) | [Memory](docs/MEMORY.md) |
|
|
458
|
-
| [Compatibility](docs/COMPATIBILITY.md) | [OpenCode
|
|
484
|
+
| [Compatibility](docs/COMPATIBILITY.md) | [OpenCode 2.x](docs/opencode.md) |
|
|
459
485
|
| [Agents & Skills](docs/agents/README.md) | [Platforms](docs/PLATFORMS.md) |
|
|
460
486
|
| [Release Process](docs/RELEASING.md) | [Branch Protection](docs/BRANCH-PROTECTION.md) |
|
|
461
|
-
| [Model Routing](docs/reference/model-routing.md) | [Local Decision Router](docs/reference/local-decision-router.md) · [
|
|
487
|
+
| [Model Routing](docs/reference/model-routing.md) | [Local Decision Router](docs/reference/local-decision-router.md) · [Native Decisions (Jev)](docs/reference/native-decisions.md) · [Offline Evaluation Protocol](docs/reference/offline-evaluation.md) · [Env Vars](docs/reference/env-vars.md) · [Code Mode](docs/reference/code-mode.md) |
|
|
462
488
|
| [Contributing](CONTRIBUTING.md) | [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) |
|
|
463
489
|
|
|
464
490
|
Memory writes through `pantheon-memory` are serialized, and failed writes are
|
|
@@ -474,7 +500,7 @@ usage (reports stay local — they carry bounded session excerpts), and the
|
|
|
474
500
|
agent usage policies derived from it are documented in
|
|
475
501
|
[MCP tools](docs/mcp-tools.md).
|
|
476
502
|
|
|
477
|
-
The release install gate's tool canary loads the installed tarball's
|
|
503
|
+
The release install gate's tool canary loads the installed tarball's plugin
|
|
478
504
|
entry under OpenCode 2.0.30 and verifies `hashline_edit` registration, Code Mode
|
|
479
505
|
visibility, and a bounded edit in an isolated project. It does not prove npm
|
|
480
506
|
publication or compatibility with untested host versions; details are in the
|
|
@@ -500,7 +526,7 @@ latest published changes.
|
|
|
500
526
|
## What's new
|
|
501
527
|
|
|
502
528
|
See the [GitHub release](https://github.com/ils15/pantheon-opencode/releases)
|
|
503
|
-
and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.
|
|
529
|
+
and [CHANGELOG.md](CHANGELOG.md) for the changes in 1.7.0.
|
|
504
530
|
|
|
505
531
|
## Contribute
|
|
506
532
|
|
package/README.pt-BR.md
CHANGED
|
@@ -36,17 +36,22 @@ o que importou. Você continua no controle de cada decisão e de cada merge.
|
|
|
36
36
|
|
|
37
37
|
## Comece em 2 minutos
|
|
38
38
|
|
|
39
|
-
Requisitos: [OpenCode](https://opencode.ai/docs/) **
|
|
40
|
-
|
|
41
|
-
|
|
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
|
-
|
|
43
|
+
Em qualquer lugar (global, todos os projetos) ou dentro de um projeto:
|
|
44
44
|
|
|
45
45
|
```bash
|
|
46
|
-
|
|
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
|
|
61
|
-
|
|
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
|
-
- **
|
|
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
|
|
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 **
|
|
109
|
-
|
|
110
|
-
|
|
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
|
|
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.
|
|
168
|
+
e o [CHANGELOG.md](CHANGELOG.md) para as mudanças da 1.7.0.
|
|
169
169
|
|
|
170
170
|
## Contribua
|
|
171
171
|
|