@jmanuelcorral/openteam 0.1.38 → 0.1.41

package/.opencode/command/openteam.md

@@ -1,12 +1,12 @@
 ---
-description: Comandos runtime de openteam (baseline show|set|auto, doctor, agents, console, report)
+description: openteam runtime commands (baseline show|set|auto, doctor, agents, console, report)
 ---
 
-Usa la herramienta `openteam` para ejecutar el comando indicado por el usuario: $ARGUMENTS
+Use the `openteam` tool to execute the command indicated by the user: $ARGUMENTS
 
-Interpreta los argumentos así y llama a la herramienta `openteam` una sola vez:
+Interpret the arguments like this and call the `openteam` tool exactly once:
 
-- `baseline show` (o vacío) → `action: "show"`
+- `baseline show` (or empty) → `action: "show"`
 - `baseline set <provider/model>` → `action: "set"`, `model: "<provider/model>"`
 - `baseline auto` → `action: "auto"`
 - `doctor` → `action: "doctor"`
@@ -14,4 +14,4 @@ Interpreta los argumentos así y llama a la herramienta `openteam` una sola vez:
 - `console` → `action: "console"`
 - `report` → `action: "report"`
 
-Devuelve la salida de la herramienta tal cual, sin reinterpretarla.
+Return the tool output as-is, without reinterpreting it.

package/AGENTS.md

@@ -1,41 +1,56 @@
-# openteam — instrucciones para opencode
+# openteam — instructions for opencode
 
-openteam es un plugin de opencode en **TypeScript + Bun** con routing **local-first** y fallback **FRONTIER cheapest-capable**. La meta es ahorrar coste/tokens frontier sin perder calidad, privacidad ni capacidad en tareas difíciles.
+openteam is an opencode plugin built with **TypeScript + Bun** with **local-first** routing and a **FRONTIER cheapest-capable** fallback. The goal is to save frontier cost/tokens without losing quality, privacy, or capability on hard tasks.
 
-## Comandos de verificación
+## Verification commands
 
 - Tests: `bun test`
 - Typecheck: `bun run typecheck`
 - Lint+format: `biome check .`
-- Coverage requerido: global lines >= 85% y branches >= 80%; `src/router/**` al 100%.
-- Determinismo: ejecutar el test específico de router cuando exista (`bun test tests/router/determinism.test.ts` o selector equivalente).
-
-## Reglas de arquitectura
-
-- Lee `docs/architecture.md`, `docs/testing-and-quality.md` y `PLAN.md` antes de cambios grandes.
-- `router/` es puro: sin I/O, reloj, random, env vars ni logs.
-- `plugin/` contiene hooks opencode; cualquier uso de superficie no documentada necesita test de contrato.
-- `local/` aísla Ollama, LM Studio y Foundry Local.
-- `config/` valida y persiste `.opencode/openteam.json`.
-- `telemetry/` no guarda prompts completos; usa hash y metadatos redactados.
-
-## Config y agentes opencode
-
-- Config runtime canónica: `.opencode/openteam.json`.
-- Reconciliación: `.openteam/config.json` queda obsoleto frente a la decisión de Rusty.
-- Las definiciones Markdown de agents viven en `.opencode/agent/` en este repo. La documentación pública menciona `.opencode/agents/`; la investigación local verificó que el source soporta ambos.
-- opencode lee este `AGENTS.md` como instrucciones de proyecto (verificado en docs/rules el 2026-07-06).
-
-## Convenciones
-
-- Documentación y prosa: español.
-- Código, rutas, tipos e identificadores: English.
-- TypeScript strict, ESM only, Zod en boundaries.
-- Biome gobierna lint/format; no introduzcas ESLint/Prettier salvo decisión nueva.
-
-## No negociables
-
-- No merge sin tests, coverage, typecheck, lint/format y determinismo verdes.
-- No enviar datos `privacySensitive` a frontier con `forceLocalOnSensitive`.
-- No hardcodear un frontier premium como baseline: usar cheapest-capable configurable.
-- No depender de runtimes locales reales, red o secretos en CI.
+- Required coverage: global lines >= 85% and branches >= 80%; `src/router/**` at 100%.
+- Determinism: run the specific router test when it exists (`bun test tests/router/determinism.test.ts` or an equivalent selector).
+
+## Architecture rules
+
+- Read `docs/architecture.md`, `docs/testing-and-quality.md`, and `PLAN.md` before large changes.
+- `router/` is pure: no I/O, clock, random, env vars, or logs.
+- `plugin/` contains opencode hooks; any use of an undocumented surface needs a contract test.
+- `local/` isolates Ollama, LM Studio, and Foundry Local.
+- `config/` validates and persists `.opencode/openteam.json`.
+- `telemetry/` does not store full prompts; it uses a hash and redacted metadata.
+
+## opencode config and agents
+
+- Canonical runtime config: `.opencode/openteam.json`.
+- Reconciliation: `.openteam/config.json` is obsolete relative to the current decision.
+- Agent Markdown definitions live in `.opencode/agent/` in this repo. Public documentation mentions `.opencode/agents/`; local research verified the source supports both.
+- opencode reads this `AGENTS.md` as project instructions (verified in docs/rules on 2026-07-06).
+
+## Conventions
+
+- Documentation and prose: English (a Spanish README localization is maintained as `README.es.md`).
+- Code, paths, types, and identifiers: English.
+- TypeScript strict, ESM only, Zod at boundaries.
+- Biome governs lint/format; do not introduce ESLint/Prettier unless a new decision is made.
+
+## Test-first with Gherkin
+
+- **Default workflow for behavioral work is Test-First with Gherkin.** Before implementing a
+  story in `src/graph/**`, `src/context/**`, `src/storage/graph/**`, or `src/orchestrator/**`,
+  first write the `.feature` scenarios derived from the story's "Testable acceptance", watch
+  them fail, then implement until green.
+- Functional tests run on the in-repo, **dependency-free** Gherkin harness at
+  `tests/functional/gherkin/` (parser + runner). Do not add Cucumber or any BDD dependency:
+  it would violate the supply-chain policy.
+- Feature files live under `tests/functional/features/**`; step definitions are inlined in the
+  matching `tests/functional/*.test.ts` so they do not drag coverage. Steps drive the **real**
+  modules; only injected I/O ports (filesystem, clock, session client) may be deterministic fakes.
+- Backfill is incremental: as we touch or extend an area, add the missing Gherkin coverage and
+  pay down technical debt rather than leaving gaps.
+
+## Non-negotiables
+
+- No merge without tests, coverage, typecheck, lint/format, and determinism green.
+- Do not send `privacySensitive` data to frontier with `forceLocalOnSensitive`.
+- Do not hardcode a premium frontier as the baseline: use a configurable cheapest-capable one.
+- Do not depend on real local runtimes, network, or secrets in CI.