pantheon-opencode 1.5.0-beta.2 → 1.5.0-beta.4

package/README.md

@@ -8,7 +8,7 @@ want useful structure without giving up control of their code.
 [Português (Brasil)](README.pt-BR.md) ·
 [Repository](https://github.com/ils15/pantheon-opencode) · [MIT License](LICENSE)
 
-[![Version](https://img.shields.io/github/v/release/ils15/pantheon-opencode?label=version)](https://github.com/ils15/pantheon-opencode/releases/tag/v1.5.0)
+[![Version](https://img.shields.io/github/v/release/ils15/pantheon-opencode?label=version)](https://github.com/ils15/pantheon-opencode/releases/latest)
 [![CI](https://img.shields.io/github/actions/workflow/status/ils15/pantheon-opencode/ci.yml?branch=main&label=CI)](https://github.com/ils15/pantheon-opencode/actions)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.22306637.svg)](https://doi.org/10.5281/zenodo.22306637)
 
@@ -70,13 +70,65 @@ clear handoff between stages of work.
 
 ## Status
 
-Current release: **v1.5.0**. Pantheon is designed for OpenCode and depends on
-the availability and configuration of OpenCode and any optional services you
-choose to use. Check the [releases](https://github.com/ils15/pantheon-opencode/releases)
-and [changelog](CHANGELOG.md) for the latest changes.
+Operational checkout version: **v1.5.0-beta.2** (candidate; publication is not
+asserted here). Pantheon is designed for OpenCode and depends on the
+availability and configuration of OpenCode and any optional services you choose
+to use. Check the [releases](https://github.com/ils15/pantheon-opencode/releases)
+and [changelog](CHANGELOG.md) for the latest published changes.
 
+## Native delegation mode
 
-## What's new in 1.5.0
+Set `PANTHEON_DELEGATE_MODE=native` to use OpenCode's native child-session
+delegation. Native mode is strict: it does not use foreground fallback, model
+failover, or retry; it performs a lazy capability probe on the first dispatch,
+and includes the resulting status in the delegation receipt.
+
+## Cost tool backend
+
+`pantheon_cost` has one backend: read-only `node:sqlite` against the selected
+`opencode.db`. On Node versions without `node:sqlite` (Node < 22.5), the tool
+returns `status: UNSUPPORTED`; it has no CLI fallback. Database failures return
+a contract status such as `UNAVAILABLE` or
+`CORRUPT_DATA` and include diagnostic detail, including captured stderr when
+available.
+
+
+## Code-mode execution (explicit opt-in)
+
+Scripts run through the `pantheon-code-mode` MCP server (`execute_code_script`)
+only when they are explicitly approved. Approval is recorded in
+`.pantheon/code-mode/manifest.json` with the SHA-256 of each script:
+
+```json
+{
+  "version": 1,
+  "scripts": {
+    "example-sync.sh": "<sha256>"
+  }
+}
+```
+
+- **No manifest → nothing executes.** A missing manifest returns
+  `INVALID_STATE`; scripts are never run implicitly.
+- **Not listed → `CONFLICT`.** The script must be approved first.
+- **Hash mismatch → `CORRUPT_DATA`.** The SHA-256 of the file on disk must
+  match the manifest entry, so edits after approval are detected.
+
+Approve or re-approve a script with the `approve_code_script` MCP tool:
+
+```
+approve_code_script("checkpoint-session.sh")
+```
+
+The installer seeds the manifest with the SHA-256 of every bundled script, so
+shipped scripts stay approved across installs. Re-run `approve_code_script`
+after intentionally editing a script. Status codes follow the shared nine-code
+contract (`OK`, `UNSUPPORTED`, `UNAVAILABLE`, `INVALID_INPUT`, `INVALID_STATE`,
+`CONFLICT`, `CORRUPT_DATA`, `TIMEOUT`, `ESCALATE`); with `json_output=true`,
+results carry a `status` field.
+
+
+## What's new in 1.5.0-beta.2
 
 - OpenCode-only installer: platform guides consolidated into a single
   [OpenCode guide](docs/platforms/opencode.md).
@@ -95,7 +147,7 @@ and [changelog](CHANGELOG.md) for the latest changes.
   [Beta2 agent economy policy](docs/ws3-token-opt-measurements.md#beta2-agent-economy-policy).
 - A `--prompts` installer flag is planned for a future release.
 
-## OpenCode V1/V2 — Dual Version (1.5.0)
+## OpenCode V1/V2 — Dual Version (1.5.0-beta.2)
 
 Pantheon has two **exclusive** OpenCode plugin contracts. Ordinary OpenCode
 configuration may be shared, but the Pantheon plugin registration is selected
@@ -153,9 +205,21 @@ The installer still writes the compatibility settings required by the selected
 OpenCode host, such as `experimental.subagent_depth`; this does not convert a
 V1 plugin into V2 or provide V2 with V1 hooks.
 
-## Beta releases
+## Releases
+
+Publication is authorized **only** by an explicit `workflow_dispatch` of the
+`Release` workflow (`release_channel` input selects beta or stable). PR labels,
+pushes, merges, and tags never publish anything, and every validation gate is
+fail-closed: only an explicit PASS authorizes release evidence. See
+[docs/RELEASING.md](docs/RELEASING.md) for validation and recovery details.
 
-A pull request labeled exactly `release:beta` triggers the beta release path. See [docs/RELEASING.md](docs/RELEASING.md) for validation and recovery details.
+Release validation keeps each manifest with its lockfile: the root
+`package.json` + `package-lock.json` and the TUI
+`src/plugins/tui/package.json` + `src/plugins/tui/package-lock.json`. Both use
+`npm ci --ignore-scripts`; an `npm ci` failure blocks the run and there is no
+`npm install` fallback. A release carries one `.tgz` tarball, computes the
+SHA-256 of that same artifact, and binds the tarball and GitHub release to the
+full `TARGET_SHA`; a second pack is not interchangeable.
 
 ## Sandbox validation (V1/V2)
 
@@ -164,9 +228,9 @@ package as a real user inside an isolated sandbox (own `HOME`, npm prefix and
 venv) — never the dev environment. It checks OpenCode V1 (`opencode`) and V2
 (`opencode2`) side by side: binaries, MCP connectivity, `doctor`, and — with
 `--prompts` — a prompt battery covering the `pantheon://agents` resource,
-memory store/recall, filesystem writes and agent delegation. Environmental
-failures (network, provider auth, Docker) are classified as `AMBIENTAL` and
-never fail the run; only real failures do.
+memory store/recall, filesystem writes and agent delegation. The gate is
+fail-closed: every required check must return an explicit PASS; timeouts,
+auth/network/provider failures and missing prerequisites block the run.
 
 ```bash
 scripts/test-opencode-v1-v2-sandbox.sh --prepare          # tarball + install + init in the sandbox
@@ -180,6 +244,9 @@ Modes are combinable (e.g. `--prepare --run v1 --prompts`). Binaries are
 resolved strictly inside the sandbox npm prefix — a non-prepared sandbox fails
 fast instead of silently testing the host installation.
 
+This validates the prepared isolated sandbox only. A PASS is not proof of
+support for every real host or for host configurations that were not exercised.
+
 Env overrides:
 
 | Variable | Default | Purpose |
@@ -193,6 +260,26 @@ Env overrides:
 Exit codes: `0` no real failures · `1` real failure (see `prompts-report.md`
 in the sandbox root) · `2` usage error · `3` sandbox not prepared.
 
+### Intentional memory MCP divergence
+
+`scripts/memory_mcp_server.py` and `src/mcp/memory_mcp_server.py` are
+intentionally different. The standalone `scripts/` copy keeps the lightweight
+`memory_*` contract; the installed `src/mcp/` copy additionally exposes the
+optional codemap schema and `code_index`, `code_query`, and `code_neighbors`.
+The other shared MCP copies remain identical. Do not overwrite one memory copy
+with the other.
+
+### Task-result guard
+
+A `task-result-guard` intercepts calls to the native `task()` tool where the
+child session returns an empty or missing result. Instead of surfacing a silent
+`completed` with no payload (which confuses the orchestrator), the guard now
+raises an explicit error. This catches the common free-tier failure mode where a
+child session exceeds the uncached-prefill token budget (`BackendAdmissionRejected`)
+and returns nothing. For large payloads, prefer `pantheon_delegate` over native
+`task()` — the delegation layer has better timeout and error handling.
+
+
 ## Documentation
 
 - [Installation](docs/INSTALLATION.md) · [Quick start](docs/QUICKSTART.md)
@@ -210,9 +297,10 @@ or pull request.
 
 ## Citation and DOI
 
-Pantheon is released under the [MIT License](LICENSE). For the published v1.4.3
-record, use the [Zenodo DOI](https://doi.org/10.5281/zenodo.22306637); citation
-metadata is also available in [CITATION.cff](CITATION.cff).
+Pantheon is released under the [MIT License](LICENSE). For the historical
+published v1.4.3 record only, use the [Zenodo DOI](https://doi.org/10.5281/zenodo.22306637);
+it is not the current operational version. Citation metadata is also available
+in [CITATION.cff](CITATION.cff).
 
 Canonical repository: <https://github.com/ils15/pantheon-opencode>
 

package/README.pt-BR.md

@@ -8,7 +8,7 @@ e equipes que querem mais estrutura sem perder o controle do próprio código.
 [English](README.md) ·
 [Repositório](https://github.com/ils15/pantheon-opencode) · [Licença MIT](LICENSE)
 
-[![Versão](https://img.shields.io/github/v/release/ils15/pantheon-opencode?label=versão)](https://github.com/ils15/pantheon-opencode/releases/tag/v1.5.0)
+[![Versão](https://img.shields.io/github/v/release/ils15/pantheon-opencode?label=versão)](https://github.com/ils15/pantheon-opencode/releases/latest)
 [![CI](https://img.shields.io/github/actions/workflow/status/ils15/pantheon-opencode/ci.yml?branch=main&label=CI)](https://github.com/ils15/pantheon-opencode/actions)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.22306637.svg)](https://doi.org/10.5281/zenodo.22306637)
 
@@ -71,13 +71,31 @@ verificações repetíveis e passagens claras entre etapas do trabalho.
 
 ## Status
 
-Versão atual: **v1.5.0**. O Pantheon foi feito para OpenCode e depende da
+Versão operacional neste checkout: **v1.5.0-beta.2** (candidata; esta página
+não afirma publicação). O Pantheon foi feito para OpenCode e depende da
 disponibilidade e da configuração do OpenCode e dos serviços opcionais que você
 escolher. Veja as [releases](https://github.com/ils15/pantheon-opencode/releases)
-e o [changelog](CHANGELOG.md) para acompanhar as mudanças.
+e o [changelog](CHANGELOG.md) para acompanhar as mudanças publicadas.
 
 
-## Novidades da 1.5.0
+## Execução code-mode (opt-in explícito)
+
+Scripts executados pelo MCP server `pantheon-code-mode` (`execute_code_script`)
+só rodam quando aprovados explicitamente. A aprovação fica em
+`.pantheon/code-mode/manifest.json` com o SHA-256 de cada script.
+
+- **Sem manifest → nada executa** (`INVALID_STATE`); nunca há execução implícita.
+- **Script fora do manifest → `CONFLICT`**; é preciso aprovar antes.
+- **Hash divergente → `CORRUPT_DATA`**; edições após a aprovação são detectadas.
+
+Aprove (ou reaprove) um script com a tool `approve_code_script`. O instalador
+semeia o manifest com o hash de todos os scripts empacotados. Os resultados
+seguem o contrato de nove códigos (`OK`, `UNSUPPORTED`, `UNAVAILABLE`,
+`INVALID_INPUT`, `INVALID_STATE`, `CONFLICT`, `CORRUPT_DATA`, `TIMEOUT`,
+`ESCALATE`) e, com `json_output=true`, incluem o campo `status`.
+
+
+## Novidades da 1.5.0-beta.2
 
 - Instalador exclusivo para OpenCode: guias de plataformas consolidados em um
   único [guia OpenCode](docs/platforms/opencode.md).
@@ -93,7 +111,7 @@ e o [changelog](CHANGELOG.md) para acompanhar as mudanças.
   lado — veja [Validação em sandbox](#validação-em-sandbox-v1v2).
 - A flag `--prompts` do instalador está planejada para uma release futura.
 
-## OpenCode V1/V2 — Versão dupla (1.5.0)
+## OpenCode V1/V2 — Versão dupla (1.5.0-beta.2)
 
 O Pantheon tem dois contratos de plugin OpenCode **exclusivos**. A configuração
 comum do OpenCode pode ser compartilhada, mas o registro do plugin Pantheon é
@@ -141,7 +159,7 @@ instalador remove referências Pantheon das duas formas de config antes de
 gravar apenas o registro Pantheon selecionado. Entradas de terceiros não são
 convertidas nem reivindicadas por essa regra.
 
-O relatório `pantheon_cost` (apenas V1) pode selecionar o banco com
+O relatório `pantheon_cost`, disponível nos plugins V1 e V2, pode selecionar o banco com
 `PANTHEON_OPENCODE_VERSION=v1` ou `v2` (`opencode.db` ou `opencode-v2.db`).
 `PANTHEON_COST_DB=/caminho/absoluto/para/opencode.db` tem precedência sobre o
 seletor de versão, e um `dbPath` explícito fornecido pelo chamador da
@@ -153,9 +171,21 @@ O instalador continua gravando as configurações de compatibilidade exigidas
 pelo host OpenCode selecionado, como `experimental.subagent_depth`; isso não
 converte um plugin V1 em V2 nem dá hooks V1 ao V2.
 
-## Releases beta
+## Releases
 
-Um pull request com o label exato `release:beta` aciona o fluxo de release beta. Consulte [docs/RELEASING.md](docs/RELEASING.md) para detalhes de validação e recuperação.
+A publicação é autorizada **somente** por um `workflow_dispatch` explícito do
+workflow `Release` (o input `release_channel` escolhe beta ou stable). Labels
+de PR, push, merge e tag nunca publicam nada, e todos os gates de validação são
+fail-closed: somente um PASS explícito autoriza release evidence. Consulte
+[docs/RELEASING.md](docs/RELEASING.md) para detalhes de validação e recuperação.
+
+A validação mantém cada manifest junto do seu lockfile: o root
+`package.json` + `package-lock.json` e o TUI
+`src/plugins/tui/package.json` + `src/plugins/tui/package-lock.json`. Ambos usam
+`npm ci --ignore-scripts`; uma falha em `npm ci` bloqueia a execução e não há
+fallback para `npm install`. Uma release carrega um único tarball `.tgz`, calcula
+o SHA-256 desse mesmo artefato e vincula o tarball e o GitHub Release ao
+`TARGET_SHA` completo; um segundo pack não é intercambiável.
 
 ## Validação em sandbox (V1/V2)
 
@@ -165,8 +195,9 @@ prefix npm e venv próprios) — nunca o ambiente de desenvolvimento. Ele verifi
 OpenCode V1 (`opencode`) e V2 (`opencode2`) lado a lado: binários, conectividade
 MCP, `doctor` e — com `--prompts` — uma bateria de prompts cobrindo o recurso
 `pantheon://agents`, memory store/recall, escrita no filesystem e delegação de
-agente. Falhas ambientais (rede, auth de provider, Docker) são classificadas
-como `AMBIENTAL` e nunca falham a execução; apenas falhas reais falham.
+agente. O gate é fail-closed: todo check obrigatório precisa terminar em PASS
+explícito; timeout, falha de auth/rede/provider e pré-requisitos ausentes
+bloqueiam a execução.
 
 ```bash
 scripts/test-opencode-v1-v2-sandbox.sh --prepare          # tarball + install + init no sandbox
@@ -180,6 +211,9 @@ Os modos são combináveis (ex.: `--prepare --run v1 --prompts`). Os binários s
 resolvidos estritamente dentro do prefix npm do sandbox — um sandbox não
 preparado falha rápido em vez de testar silenciosamente a instalação do host.
 
+Isso valida somente o sandbox isolado e preparado. Um PASS não prova suporte
+para todo host real nem para configurações de host que não foram exercitadas.
+
 Variáveis de ambiente:
 
 | Variável | Padrão | Finalidade |
@@ -194,6 +228,15 @@ Códigos de saída: `0` sem falhas reais · `1` falha real (veja
 `prompts-report.md` na raiz do sandbox) · `2` erro de uso · `3` sandbox não
 preparado.
 
+### Divergência intencional do memory MCP
+
+`scripts/memory_mcp_server.py` e `src/mcp/memory_mcp_server.py` são
+intencionalmente diferentes. A cópia independente em `scripts/` mantém o
+contrato leve de `memory_*`; a cópia instalada em `src/mcp/` também expõe o
+schema opcional de codemap e `code_index`, `code_query` e `code_neighbors`. As
+outras cópias compartilhadas permanecem idênticas. Não sobrescreva uma cópia de
+memória com a outra.
+
 ## Documentação
 
 - [Instalação](docs/INSTALLATION.md) · [Início rápido](docs/QUICKSTART.md)
@@ -211,9 +254,10 @@ uma issue ou pull request.
 
 ## Citação e DOI
 
-O Pantheon é distribuído sob a [Licença MIT](LICENSE). Para o registro publicado
-da v1.4.3, use o [DOI do Zenodo](https://doi.org/10.5281/zenodo.22306637); os
-metadados de citação também estão em [CITATION.cff](CITATION.cff).
+O Pantheon é distribuído sob a [Licença MIT](LICENSE). Para o registro histórico
+publicado da v1.4.3 apenas, use o [DOI do Zenodo](https://doi.org/10.5281/zenodo.22306637);
+essa não é a versão operacional atual. Os metadados de citação também estão em
+[CITATION.cff](CITATION.cff).
 
 Repositório canônico: <https://github.com/ils15/pantheon-opencode>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pantheon-opencode",
-  "version": "1.5.0-beta.2",
+  "version": "1.5.0-beta.4",
   "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
   "type": "module",
   "publishConfig": {
@@ -28,7 +28,9 @@
     "version:status": "node scripts/versioning.mjs status",
     "version:apply": "node scripts/versioning.mjs apply",
     "version:check": "node scripts/version-check.mjs",
-    "release:dry-run": "node scripts/versioning.mjs status && node scripts/release-notes.mjs && npm pack --dry-run",
+    "release:dry-run": "node scripts/versioning.mjs status && node scripts/release-notes.mjs && node scripts/package-evidence.mjs",
+    "package:evidence": "node scripts/package-evidence.mjs",
+    "package:validate": "node scripts/validate-package.mjs",
     "publish:next": "npm publish --tag next --access public",
     "lint": "npx biome ci .",
     "typecheck": "npx tsc --noEmit",
@@ -47,7 +49,9 @@
   },
   "files": [
     "LICENSE",
+    "package-lock.json",
     "plugin.json",
+    "pyproject.toml",
     "scripts/install/*.mjs",
     "scripts/*.py",
     "src/plugin.ts",
@@ -64,6 +68,7 @@
     "!src/agents/README.md",
     "bin/*.mjs",
     "AGENTS.md",
+    "CHANGELOG.md",
     "opencode.json",
     "src/mcp/*.py",
     "src/instructions/*.instructions.md",
@@ -84,7 +89,7 @@
   ],
   "dependencies": {
     "@opencode-ai/plugin": "1.18.18",
-    "js-yaml": "^4.3.0",
+    "js-yaml": "^4.3.2",
     "zod": "4.1.8"
   },
   "devDependencies": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pantheon",
   "publisher": "ils15",
-  "version": "1.5.0",
+  "version": "1.5.0-beta.4",
   "displayName": "Pantheon",
   "description": "Conductor-Delegate orchestration platform with 14 specialized agents, 21 skills, and OpenCode support.",
   "agents": "./src/agents",

package/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.backends._legacy:_Backend"
+
+[project]
+name = "pantheon"
+version = "1.5.0-beta.4"
+description = "Multi-agent orchestration framework"
+requires-python = ">=3.11"
+dependencies = []
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = "-v --tb=short"
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "PL", "RUF", "C901"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]
+# Legacy command-line scripts intentionally use hyphenated filenames.
+"scripts/ci-validate-yaml.py" = ["N999"]
+"scripts/scrub-secrets.py" = ["N999"]
+# These modules defer optional/heavy imports until the corresponding command is used.
+"scripts/vector_memory/*.py" = ["PLC0415"]
+"tests/test_code_mode_args.py" = ["PLC0415"]
+"tests/test_code_mode_sandbox.py" = ["PLC0415", "N806"]
+"tests/test_code_mode_server.py" = ["PLC0415"]
+"tests/test_eval_store.py" = ["PLC0415", "PLR2004"]
+"tests/test_memory_mcp_server.py" = ["PLC0415", "PLR2004"]
+# Existing public APIs and test fixtures are intentionally broad/simple; refactoring
+# them would be behavior-affecting rather than a mechanical lint correction.
+"scripts/code_mode_server.py" = ["PLR0913"]
+"src/mcp/code_mode_server.py" = ["PLR0913"]
+"scripts/mcp_persistence_server.py" = ["PLR0913"]
+"src/mcp/mcp_persistence_server.py" = ["PLR0913"]
+"scripts/memory_mcp_server.py" = ["C901"]
+"scripts/vector_memory/index.py" = ["C901", "PLR0913", "PLR2004", "PLW0603", "PLW2901"]
+"scripts/vector_memory/cli.py" = ["PLR2004"]
+"scripts/vector_memory/query.py" = ["PLR0913"]
+"src/mcp/eval_store.py" = ["PLR2004"]
+"tests/test_code_mode_frontmatter.py" = ["PLR2004"]
+"tests/test_eval_judge.py" = ["PLR2004"]
+"tests/test_eval_static.py" = ["PLR2004"]
+"tests/test_mcp_persistence_server.py" = ["PLR2004"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+ignore_missing_imports = true
+disallow_untyped_defs = true