pantheon-opencode 1.6.0-beta.2 → 1.6.0-beta.3

package/CHANGELOG.md

@@ -18,6 +18,96 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## ✅ Closed Issues
 
+## [v1.6.0-beta.3] - 2026-10-03
+
+<!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
+     move this section to a versioned entry and reset the template below. -->
+
+## 🆕 What's New
+- **Três ferramentas V2 agora executam de verdade**: `hashline_edit`,
+  `pantheon_cost` e `pantheon_model` rodam no host `opencode v2.0.x`. Antes
+  eram placeholders que declaravam sucesso sem fazer nada.
+- **Enforcement de sessão read-only no caminho V2**: `apollo` e `gaia` voltam
+  a ter escrita bloqueada, com o guard registrado no próprio plugin V2 — sem
+  depender de uma ponte que a instalação V2 não monta.
+- **Varredura de segredos de alta confiança no caminho V2**: o único hard block
+  de segurança que a V1 tinha, e que estava inerte por viver num plugin que a
+  instalação V2 não carrega, passa a rodar.
+
+## 🐞 Fixed
+- **As 6 ferramentas de plugin do V2 falhavam em 100% das chamadas**:
+  `hashline_edit`, `pantheon_cost` e `pantheon_model` lançavam
+  `Tool result declared output without an output schema` em toda invocação. A
+  causa era assimetria local — `draft.add()` não declarava `output` enquanto o
+  `execute` resolvia `{ output: string }`. O host exige simetria nos dois
+  sentidos: resultado com `output` e nenhuma declaração lança, assim como
+  declaração sem `output` no resultado. `output` passou a ser **obrigatório** na
+  interface `V2ToolDef`, então o compilador exige a declaração daqui em diante.
+- **A suíte exigia o defeito**: `tests/pantheon/plugin-v2-contract.test.ts`
+  afirmava que o resultado carregava `.output` string — literalmente a condição
+  de falha, contra um mock que não reproduzia a exigência do host. O teste foi
+  reescrito para o invariante de simetria, contra um mock que constrói o
+  `outputSchema` a partir de `def.output` como o host faz
+  (`output: I.outputSchema ?? {}`), cobrindo as duas direções do bicondicional.
+- **A imposição read-only não existia na superfície V2**: `createEnforcementGuard`
+  só era instanciado em `src/plugin.ts`, que o `opencode.json` da release não
+  declara — V2 nunca carrega V1. Com `hashline_edit` funcional, uma sessão
+  somente-leitura podia escrever arquivos. O guard passou a ser registrado no
+  hook `execute.before` do V2, e `pantheon_model` — que escreve
+  `active-preset.json` em escopo project e global — foi acrescentado a
+  `DEFAULT_BLOCKED_TOOLS`, o que corrige também a V1. `pantheon_cost` ficou de
+  fora de propósito: só lê `opencode.db`.
+- **O único hard block de segurança da V1 estava inerte**: o scan de segredos de
+  alta confiança vivia em `src/plugins/pantheon-hooks.ts`, um plugin que a
+  instalação V2 não carrega — inerte por construção, não por má configuração.
+  Passou a rodar dentro do `execute.before` do V2
+  (`scripts/hooks/scan-secrets.sh`; exit 2 bloqueia, exit 1 é advisory e só
+  registra). O caminho do script foi verificado a partir do tarball instalado,
+  não só do repo.
+- **Cinco comentários afirmavam cobertura que não existe** ("wired through the
+  V1…"). Corrigidos — é o defeito "anunciado como vivo, morto no caminho", a
+  mesma classe do bug original, transferida do tool para o controle de segurança.
+
+## ⚠️ Known Issues
+- **A release entrega 3 ferramentas V2 funcionais, não 6**:
+  `pantheon_goal_create`, `pantheon_goal_get` e `pantheon_goal_update` foram
+  **removidos** da superfície V2. `GoalLoopDeps` exige `store`, `client` e
+  `board`, que não existem no `PluginContext` V2, e a bridge V1 resolve para
+  `null` fora da V1. Registrá-las como placeholders não funcionais seria pior
+  que a ausência: anunciá-las seria mentira silenciosa. Marcador `goal-tools`
+  em `V2_UNSUPPORTED_FEATURES`. **Breaking** para quem usava esses tools no
+  host V2 — o contrato V1 permanece disponível para o goal loop.
+- **A matriz de delegação nativa da V1 não é replicada na V2**: o guard V2 cobre
+  a lista de ferramentas bloqueadas, mas não a matriz caller→target nem a negação
+  de `task` em sessão filha. A matriz precisa de uma hierarquia de sessões
+  semeada a partir dos metadados de sessão, e o V2 não expõe esse caminho de
+  semeadura — `SessionHierarchyRegistry.isRoot` reporta `true` para sessões
+  desconhecidas enquanto não semeada, então semeá-la pela metade negaria todo
+  `task()`. O branch é pulado em vez de negado indiscriminadamente. Marcador
+  `delegation-matrix`. `task` continua negada em sessão somente-leitura pela
+  lista de ferramentas bloqueadas, então a profundidade 2 se sustenta; o que
+  não existe é a matriz. Coberto por `experimental.subagent_depth` nesta
+  configuração, mas a garantia do plugin não existe.
+- **O log do scan de segredos escreve só em `.pantheon/logs/hooks.log`**: o
+  `PluginContext` V2 não expõe `client` nem `directory`, então os canais de log
+  estruturado e de toast da V1 não existem nessa superfície. É menos
+  observabilidade, não menos bloqueio.
+- **Falha de infraestrutura do scanner é fail-open por decisão**: script ausente
+  ou timeout não bloqueiam. `runHook` nunca rejeita e um erro de infraestrutura
+  não deve negar chamadas não relacionadas. Ausência do script não bloqueia.
+
+## ✅ Closed Issues
+- **Drift de documentação no `README.pt-BR.md`**: a tabela de contrato de
+  runtime e o parágrafo de superfície listavam 6 ferramentas V2 e as 3 de goal,
+  que não estão registradas. Corrigido para 3 ferramentas, com a razão da
+  ausência e o ponto de imposição read-only.
+- **Cinco comentários de falsa cobertura** sobre a imposição read-only e o scan
+  de segredos.
+- **Shim do loader JSON do ajv elevado a bootstrap de módulo**: o patch de
+  `Module._extensions['.json']` era aplicado de dentro de `loadAjv()` e ficava
+  vivo durante todo o run, podendo vazar entre arquivos de teste e se manifestar
+  longe da causa. Agora instala, carrega e restaura em nível de módulo, antes de
+  qualquer corpo de teste, com `finally`.
 ## [v1.6.0-beta.2] - 2026-10-02
 
 ## 🆕 What's New

package/README.md

@@ -186,16 +186,36 @@ per installation; V1 and V2 Pantheon plugins must never be registered together.
 |---|---|---|
 | OpenCode config key | singular `plugin` | plural `plugins` |
 | Pantheon registration | `src/plugin.ts` plus `src/plugins/pantheon-hooks.ts` | `<installed>/src/plugin-v2` directory (`index.ts` re-exports `src/plugin-v2.ts`) |
-| Runtime contract | Pantheon V1 plugin: 6 tools (`hashline_edit`, the 3 goal tools, `pantheon_cost`, `pantheon_model`), event/tool hooks and V1 compaction handling | Full V2 plugin: 6 orchestration tools, 4 event subscriptions, session hooks (`prompt`, `context`), tool hooks (`execute.before`/`after`), plus configuration transforms |
+| Runtime contract | Pantheon V1 plugin: 6 tools (`hashline_edit`, the 3 goal tools, `pantheon_cost`, `pantheon_model`), event/tool hooks and V1 compaction handling | Full V2 plugin: 3 tools (`hashline_edit`, `pantheon_cost`, `pantheon_model`), 4 event subscriptions, session hooks (`prompt`, `context`), a read-only-enforcing tool `execute.before` hook, plus configuration transforms |
 | V1 APIs | Registered | Own tool definitions via `ctx.tool.transform()` — not the V1 plugin path |
 
-The V2 plugin provides 6 orchestration tools (`hashline_edit`,
-`pantheon_goal_create`, `pantheon_goal_get`, `pantheon_goal_update`,
-`pantheon_cost`, `pantheon_model`), 4 event subscriptions (`session.created`,
-`session.idle`, `session.error`, `session.compacted`), session hooks (`prompt`,
-`context`), and tool hooks (`execute.before`, `execute.after`). Unsupported V2
-features are `legacy-hooks` (the V1-specific hook surface), `catalog-transform`,
-`integration-transform`, and `skill-transform`.
+The V2 plugin provides 3 orchestration tools (`hashline_edit`, `pantheon_cost`,
+`pantheon_model`), 4 event subscriptions (`session.created`, `session.idle`,
+`session.error`, `session.compacted`), session hooks (`prompt`, `context`),
+and a tool `execute.before` hook that enforces read-only sessions. The 3 goal
+tools are **not**
+registered on V2: the goal loop needs a `GoalStore`, a `GoalLoopClient` and a
+`BackgroundJobBoard`, none of which the V2 `PluginContext` exposes, so the gap
+is reported as the `goal-tools` unsupported-feature marker. Use the V1
+contract if you need the goal loop.
+
+The V2 `execute.before` hook is the read-only enforcement point for that
+surface: the host includes the active agent on the event, a read-only agent
+(`apollo`, `gaia`) registers its session, and the shared
+`createEnforcementGuard` throws to deny `edit`, `write`, `bash`, `task`,
+`hashline_edit` and `pantheon_model`. It does **not** rely on the V1
+`tool.execute.before` hook, which lives in `src/plugin.ts` and is not loaded
+when only `plugin-v2` is configured. The companion `execute.after` hook and the
+`permission.evaluate` hook are registration points with no V2-side behaviour,
+and the V1 caller/target delegation matrix for native `task()` is not enforced
+on V2.
+
+Every V2 tool declares an `output` schema. OpenCode 2.0.x requires the
+declaration and the resolved result to agree in both directions, so an
+undeclared tool — or one that returns `output` without declaring it — fails on
+every call. Unsupported V2 features are `legacy-hooks` (the V1-specific hook
+surface), `catalog-transform`, `integration-transform`, `skill-transform` and
+`goal-tools`.
 
 The package exposes both contracts as importable exports: `pantheon-opencode/plugin`
 (V1), `pantheon-opencode/plugin-v2` (V2) and `pantheon-opencode/v2-bridge`

package/README.pt-BR.md

@@ -122,16 +122,36 @@ registrados juntos.
 |---|---|---|
 | Chave de config do OpenCode | `plugin` singular | `plugins` plural |
 | Registro Pantheon | `src/plugin.ts` mais `src/plugins/pantheon-hooks.ts` | `pantheon-opencode/plugin-v2` (`src/plugin-v2.ts`) |
-| Contrato de runtime | Plugin Pantheon V1: 6 ferramentas (`hashline_edit`, as 3 ferramentas de goal, `pantheon_cost`, `pantheon_model`), hooks de evento/ferramenta e tratamento de compactação V1 | Plugin V2 completo: 6 ferramentas de orquestração, 4 assinaturas de eventos, session hooks (`prompt`, `context`), tool hooks (`execute.before`/`after`), além de transforms de configuração |
+| Contrato de runtime | Plugin Pantheon V1: 6 ferramentas (`hashline_edit`, as 3 ferramentas de goal, `pantheon_cost`, `pantheon_model`), hooks de evento/ferramenta e tratamento de compactação V1 | Plugin V2 completo: 3 ferramentas (`hashline_edit`, `pantheon_cost`, `pantheon_model`), 4 assinaturas de eventos, session hooks (`prompt`, `context`), um hook de ferramenta `execute.before` que impõe sessões somente-leitura, além de transforms de configuração |
 | APIs V1 | Registradas | Definições próprias de ferramentas via `ctx.tool.transform()` — não pelo caminho do plugin V1 |
 
-O plugin V2 fornece 6 ferramentas de orquestração (`hashline_edit`,
-`pantheon_goal_create`, `pantheon_goal_get`, `pantheon_goal_update`,
+O plugin V2 fornece 3 ferramentas de orquestração (`hashline_edit`,
 `pantheon_cost`, `pantheon_model`), 4 assinaturas de eventos (`session.created`,
 `session.idle`, `session.error`, `session.compacted`), session hooks (`prompt`,
-`context`) e tool hooks (`execute.before`, `execute.after`). Os recursos V2 sem
-suporte são `legacy-hooks` (a superfície de hooks específica do V1),
-`catalog-transform`, `integration-transform` e `skill-transform`.
+`context`) e um hook de ferramenta `execute.before` que impõe sessões
+somente-leitura. As 3 ferramentas de goal **não** são
+registradas no V2: o goal loop precisa de um `GoalStore`, de um
+`GoalLoopClient` e de um `BackgroundJobBoard`, nenhum dos quais o
+`PluginContext` do V2 expõe, então a lacuna é reportada como o marcador de
+recurso sem suporte `goal-tools`. Use o contrato V1 se precisar do goal loop.
+
+O hook `execute.before` do V2 é o ponto de imposição de sessões somente-leitura
+dessa superfície: o host inclui o agente ativo no evento, um agente somente-leitura
+(`apollo`, `gaia`) registra sua sessão, e o `createEnforcementGuard`
+compartilhado lança para negar `edit`, `write`, `bash`, `task`,
+`hashline_edit` e `pantheon_model`. Ele **não** depende do hook
+`tool.execute.before` do V1, que vive em `src/plugin.ts` e não é carregado
+quando apenas `plugin-v2` está configurado. Os hooks companheiros
+`execute.after` e `permission.evaluate` são pontos de registro sem comportamento
+do lado V2, e a matriz de delegação caller/target da V1 para o `task()` nativo
+não é imposta no V2.
+
+Toda ferramenta V2 declara um schema `output`. O OpenCode 2.0.x exige que a
+declaração e o resultado resolvido concordem nos dois sentidos, então uma
+ferramenta sem declaração — ou que retorne `output` sem declará-lo — falha em
+toda chamada. Os recursos V2 sem suporte são `legacy-hooks` (a superfície de
+hooks específica do V1), `catalog-transform`, `integration-transform`,
+`skill-transform` e `goal-tools`.
 
 O pacote expõe os dois contratos como exports importáveis:
 `pantheon-opencode/plugin` (V1), `pantheon-opencode/plugin-v2` (V2) e

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pantheon-opencode",
-  "version": "1.6.0-beta.2",
+  "version": "1.6.0-beta.3",
   "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
   "type": "module",
   "workspaces": [
@@ -105,6 +105,7 @@
     "@biomejs/biome": "2.5.13",
     "@commitlint/cli": "21.2.2",
     "@commitlint/config-conventional": "21.2.2",
+    "ajv": "8.20.0",
     "husky": "^9.1.7",
     "tsx": "4.23.13",
     "typescript": "6.0.3"

package/plugin.json

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

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.backends._legacy:_Backend"
 
 [project]
 name = "pantheon"
-version = "1.6.0-beta.2"
+version = "1.6.0-beta.3"
 description = "Multi-agent orchestration framework"
 requires-python = ">=3.11"
 dependencies = []

package/src/pantheon/delegation-enforce.ts

@@ -9,12 +9,14 @@
  * module never needs the opencode SDK — the handler is a structural closure
  * wired from plugin.ts.
  *
- * Blocked tools (edit, write, bash, task, hashline_edit):
+ * Blocked tools (edit, write, bash, task, hashline_edit, pantheon_model):
  *   - edit/write/bash are the mutating surface — read-only agents (apollo,
  *     gaia) must stay investigation-only.
  *   - `hashline_edit` is the Wave 2 (PR #46) tag-anchored edit tool — it is a
  *     write surface too, so read-only agents must not bypass enforcement via
  *     it.
+ *   - `pantheon_model` writes active-preset.json in project and global scope —
+ *     a config write a read-only session must not perform.
  *   - `task` is blocked too, which hard-enforces depth-2: a read-only agent
  *     cannot spawn its own subagents.
  *
@@ -182,6 +184,13 @@ export const DEFAULT_BLOCKED_TOOLS: ReadonlySet<string> = new Set([
   'bash',
   'task',
   'hashline_edit',
+  // `pantheon_model` writes active-preset.json in BOTH the project and the
+  // global scope, so it is a write surface with the same blast radius as
+  // `write`. Read-only agents have no reason to change agent models, and a
+  // global override from an investigation-only session is unrecoverable from
+  // inside that session. `pantheon_cost` is deliberately absent: it only reads
+  // opencode.db.
+  'pantheon_model',
 ])
 
 // ─── Zeus Read Guard ──────────────────────────────────────────────────