@oeronteros-1/opencode-orchestra 0.5.3 → 1.0.2

package/CHANGELOG.md

@@ -1,14 +1,68 @@
 # Changelog
 
-## 0.5.3 — 2026-08-19
+All notable changes to OpenCode Orchestra are documented in this file.
 
-- Export both `server` and `default` from the plugin entry so OpenCode 1.18.x (which resolves `PluginModule.server`) and older builds both load it.
-- Write `@oeronteros-1/opencode-orchestra@latest` into `opencode.json` instead of a bare name so users track new releases.
-- Upgrade existing bare/pinned plugin entries to `@latest` on install instead of leaving them stale.
-- Add regression coverage for the `@latest` entry upgrade logic.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project uses [Semantic Versioning](https://semver.org/).
 
-## 0.5.1 — 2026-08-17
+## [1.0.0] — 2026-08-17
 
-- Record all OpenCode assistant responses in local telemetry, including the primary OpenCode mode.
-- Preserve Orchestra-specific counters for free worker calls and judge escalations.
-- Add regression coverage for telemetry updates outside `orch-*` modes.
+### Added
+
+- Production-ready orchestration with a public `orch-lead`, specialist workers, `orch-judge`, dependency-aware task plans, profile classification, and four budget modes: `eco`, `balanced`, `quality`, and `ebobo`.
+- Automatic discovery and capability scoring for models exposed by connected OpenCode providers, while preserving explicit per-agent and manual-pool overrides.
+- Model pricing support with an offline snapshot, optional self-hosted refresh endpoint, explicit per-model price overrides, pre-run cost estimates, and configurable spend warnings.
+- Ordered cheaper fallback metadata for execution layers that support retrying provider calls.
+- Local telemetry dashboard with token, cost, model, agent, activity, monthly projection, anomaly, and MCP status views.
+- Authenticated CSV and JSON exports for activity, models, agents, daily usage, and summary reports.
+- Optional prompt/reply telemetry through `telemetry.storeTexts`; message text remains disabled by default.
+- `opencode-orchestra doctor` for configuration, plugin, MCP, and local toolchain diagnostics, including JSON output.
+- `opencode-orchestra update` for checking the latest published npm version.
+- Shell completion generators for zsh, bash, and PowerShell.
+- Plugin runtime status through `/plugin-status` and the `orchestra_plugin_status` tool.
+- Cross-platform, idempotent installer for the Orchestra plugin, Context7, Codebase Memory, and MemoryGraph.
+- JSON Schema for `orchestra.jsonc`, including pricing and opt-in text telemetry settings.
+- Expanded regression and integration coverage across routing, pricing, telemetry, dashboard, diagnostics, installer, and plugin initialization.
+
+### Changed
+
+- Promoted the package to the stable `1.0.0` API and configuration contract.
+- Hardened dashboard configuration writes with full-schema validation, empty agent-model normalization, JSONC comment preservation, backups, and atomic replacement.
+- Improved paid-model estimation to honor explicit prices and each worker's actual capability.
+- Bounded streaming text buffers and added plugin-disposal cleanup for timers and in-memory telemetry state.
+- Clarified that fallback lists are resolver metadata; OpenCode provider calls are not intercepted or retried automatically by the plugin.
+- Added npm repository, homepage, issue tracker, release keywords, and a pre-publish validation gate.
+
+### Fixed
+
+- Fixed the published JSON Schema so `pricing` is accepted as a configuration section.
+- Fixed prompt telemetry correlation between user and assistant messages.
+- Fixed stale pricing snapshots, concurrent refresh races, and unsafe passthrough of remote price fields.
+- Fixed dashboard saves when optional per-agent model fields are left blank.
+- Fixed invalid export parameters to return HTTP 400 instead of HTTP 500.
+- Fixed monthly pace analytics so current-month projections use a prior-period baseline.
+
+### Compatibility and upgrade notes
+
+- Requires Node.js 22 or newer for Node-based development and runtime tooling.
+- The recommended installer requires Bun 1.2 or newer.
+- Existing bare or pinned plugin entries are upgraded to `@oeronteros-1/opencode-orchestra@latest` by the installer while preserving plugin options.
+- Existing OpenCode and MCP configuration is preserved; use `--force` only when you explicitly want Orchestra's MCP defaults to replace matching entries.
+- Text telemetry remains opt-in. Existing installations continue to record usage metadata without prompt or reply contents.
+
+## [0.5.3] — 2026-08-17
+
+### Fixed
+
+- Exported both `server` and `default` from the plugin entry for OpenCode 1.18.x and older plugin loaders.
+- Wrote `@oeronteros-1/opencode-orchestra@latest` into OpenCode configuration and upgraded existing bare or pinned entries.
+
+## [0.5.1] — 2026-08-17
+
+### Changed
+
+- Recorded all OpenCode assistant responses in local telemetry, including primary OpenCode mode.
+- Preserved Orchestra-specific counters for free worker calls and judge escalations.
+
+[1.0.0]: https://github.com/Oeronteros/opencode-orchestra/compare/v0.5.3...v1.0.0
+[0.5.3]: https://github.com/Oeronteros/opencode-orchestra/compare/v0.5.1...v0.5.3
+[0.5.1]: https://github.com/Oeronteros/opencode-orchestra/releases/tag/v0.5.1

package/GITHUB_RELEASE_1.0.0.md

@@ -0,0 +1,84 @@
+# OpenCode Orchestra 1.0.0
+
+OpenCode Orchestra 1.0.0 is the first stable release of the model-routing and specialist-agent orchestration plugin for OpenCode. It combines automatic model discovery, profile-aware worker planning, budget controls, local diagnostics, usage telemetry, and a token-protected dashboard in one installable package.
+
+## Highlights
+
+### Stable orchestration contract
+
+- One public `orch-lead`, a focused set of hidden specialist workers, and `orch-judge` for arbitration.
+- Dependency-aware task plans and profile classification for architecture, debugging, UI, research, review, security, performance, migration, and operations work.
+- Four distinct budget modes: `eco`, `balanced`, `quality`, and the maximum-throughput `ebobo` mode.
+- Automatic discovery of models from connected OpenCode providers, with manual pools and per-agent overrides always taking precedence.
+
+### Cost-aware routing
+
+- Built-in offline model-price snapshot.
+- Optional self-hosted price endpoint and periodic refresh.
+- Explicit `priceInput` and `priceOutput` overrides for manual model entries.
+- Informational pre-run estimates and configurable spend warnings in `orchestra_route`.
+- Ordered cheaper fallback candidates exposed as resolver metadata for execution layers that implement retries.
+
+> Orchestra does not intercept OpenCode provider requests and does not automatically retry failed provider calls.
+
+### Local dashboard and telemetry
+
+- Token, cost, model, agent, activity, projection, anomaly, and MCP status views.
+- Authenticated CSV/JSON report export.
+- Atomic, schema-validated configuration updates with backups and JSONC comment preservation.
+- Prompt and reply storage is disabled by default and can only be enabled explicitly with `telemetry.storeTexts: true`.
+
+### Operations and diagnostics
+
+- `doctor` checks OpenCode configuration, Orchestra configuration, plugin registration, MCP entries, and local dependency paths.
+- `update` checks npm for a newer release.
+- `completion zsh|bash|pwsh` generates shell completions.
+- `/plugin-status` reports the loaded plugin version, budget, model strategy, and companion MCP status.
+
+## Install or upgrade
+
+```bash
+bunx @oeronteros-1/opencode-orchestra@latest install
+```
+
+The installer is idempotent, preserves existing plugin/MCP configuration, creates backups before changes, and updates bare or pinned Orchestra plugin entries to `@latest`.
+
+To inspect proposed configuration changes without writing files:
+
+```bash
+bunx @oeronteros-1/opencode-orchestra@latest install --dry-run
+```
+
+After installation, restart OpenCode and run:
+
+```text
+/plugin-status
+/orchestra-status
+```
+
+## Requirements
+
+- OpenCode with plugin support compatible with `@opencode-ai/plugin >= 1.18.18`.
+- Bun 1.2+ for the recommended installer command.
+- Node.js 22+ for Node-based development and runtime tooling.
+
+## Upgrade notes
+
+- No configuration migration is required from 0.5.x.
+- Existing OpenCode configuration, plugin options, and MCP entries are preserved.
+- Use `--force` only to replace matching MCP entries with Orchestra defaults.
+- Text telemetry remains opt-in and is disabled by default.
+- The `pricing` section is now correctly represented in the published JSON Schema.
+
+## Validation
+
+This release was validated with:
+
+- TypeScript checks for plugin and dashboard.
+- 67 automated tests covering routing, pricing, telemetry, diagnostics, dashboard, installer, and integration paths.
+- Production builds for the plugin and dashboard.
+- npm package dry-run inspection.
+
+## Full changelog
+
+See [CHANGELOG.md](https://github.com/Oeronteros/opencode-orchestra/blob/v1.0.0/CHANGELOG.md).

package/README.md

@@ -1,6 +1,20 @@
 # OpenCode Orchestra
 
-`@oeronteros-1/opencode-orchestra` — плагин-оркестратор для OpenCode. Он добавляет ведущего агента, небольшую команду скрытых специалистов, арбитра для сложных случаев, автоматический выбор подключённых моделей и готовую интеграцию Context7 + Codebase Memory + MemoryGraph.
+[![npm version](https://img.shields.io/npm/v/@oeronteros-1/opencode-orchestra)](https://www.npmjs.com/package/@oeronteros-1/opencode-orchestra) [![license](https://img.shields.io/npm/l/@oeronteros-1/opencode-orchestra)](LICENSE) [![OpenCode](https://img.shields.io/badge/OpenCode-plugin-4f46e5)](https://opencode.ai/docs/plugins/)
+
+`@oeronteros-1/opencode-orchestra` — стабильный плагин-оркестратор для OpenCode. Он добавляет ведущего агента, команду скрытых специалистов, арбитра для сложных случаев, автоматический выбор подключённых моделей, контроль стоимости, локальную телеметрию и интеграцию Context7 + Codebase Memory + MemoryGraph.
+
+## Возможности 1.0
+
+- автоматическая классификация задач и dependency-aware план выполнения;
+- режимы бюджета `eco`, `balanced`, `quality` и `ebobo`;
+- автоматическое обнаружение моделей с ручными пулами и точными overrides;
+- прогноз стоимости, локальный price snapshot и собственный pricing endpoint;
+- локальный dashboard, аналитика расходов и CSV/JSON export;
+- диагностика `doctor`, проверка обновлений и shell completion;
+- идемпотентная установка без удаления пользовательской OpenCode/MCP-конфигурации.
+
+Стабильный контракт версии 1.0 описан в [CHANGELOG.md](CHANGELOG.md). GitHub release notes находятся в [GITHUB_RELEASE_1.0.0.md](GITHUB_RELEASE_1.0.0.md).
 
 ## Установка одной командой
 
@@ -14,7 +28,7 @@ CLI использует Bun напрямую, поэтому отдельный
 
 Команда:
 
-- добавит `@oeronteros-1/opencode-orchestra` в `~/.config/opencode/opencode.json`;
+- добавит `@oeronteros-1/opencode-orchestra@latest` в OpenCode config (`opencode.json` или `opencode.jsonc`);
 - подключит удалённый Context7 MCP (`https://mcp.context7.com/mcp`);
 - установит статический `codebase-memory-mcp`, включит автоматическую индексацию и подключит его к OpenCode;
 - установит MemoryGraph (`memorygraphMCP`) в изолированное окружение через `uv` и подключит локальную SQLite-память;
@@ -33,6 +47,34 @@ bunx @oeronteros-1/opencode-orchestra@latest install --help
 
 Полезные флаги: `--no-context7`, `--no-codebase-memory`, `--no-memorygraph`, `--no-deps`, `--force`, `--dry-run`, `--config-dir DIR`.
 
+## Диагностика, обновление и автодополнение
+
+Помимо установки и dashboard, CLI предлагает служебные команды:
+
+```bash
+bunx @oeronteros-1/opencode-orchestra@latest doctor
+```
+
+Проверяет конфиг OpenCode и `orchestra.jsonc`, регистрацию плагина, доступность настроенных MCP-серверов, пути и версии `uv`, MemoryGraph и Codebase Memory. Флаг `--config-dir DIR` переопределяет каталог конфигурации, а `--json` выводит результат в машиночитаемом виде.
+
+```bash
+bunx @oeronteros-1/opencode-orchestra@latest update
+```
+
+Сверяет установленную версию плагина с последней опубликованной на npm и подсказывает команду обновления.
+
+```bash
+bunx @oeronteros-1/opencode-orchestra@latest completion zsh
+bunx @oeronteros-1/opencode-orchestra@latest completion bash
+bunx @oeronteros-1/opencode-orchestra@latest completion pwsh
+```
+
+Выводит скрипт автодополнения для zsh, bash или pwsh. Например, для zsh:
+
+```bash
+bunx @oeronteros-1/opencode-orchestra@latest completion zsh > ~/.zsh/completions/_opencode-orchestra
+```
+
 ## Модели без ручной настройки
 
 По умолчанию используется `models.strategy: "auto"`. При запуске плагин получает через OpenCode список реально подключённых провайдеров и моделей, определяет доступные возможности (reasoning, tools, vision, image output, размер контекста) и заполняет только пустые пулы.
@@ -126,6 +168,28 @@ bunx @oeronteros-1/opencode-orchestra@latest install --help
 
 Цена из каталога — сигнал ранжирования, а не гарантия фактического тарифа. Для подписочных моделей можно явно указать `cost: "subscription"` в ручном пуле.
 
+### Прайс-лист и прогноз стоимости
+
+Плагин поставляет встроенный snapshot цен (`{provider}/{model} → input/output USD за 1M токенов`) и использует его как отдельный сигнал ранжирования — при прочих равных дешевле модель выигрывает. Снапшот можно периодически обновлять с собственного эндпоинта:
+
+```jsonc
+{
+  "pricing": {
+    "endpoint": "https://internal.example.com/prices.json",
+    "refreshIntervalHours": 24,
+    "estimate": true,
+    "warnThresholdUSD": 0.5
+  }
+}
+```
+
+- `endpoint` — self-hosted JSON `{ "updatedAt": "...", "prices": { "provider/model": { "input": 0.27, "output": 1.1 } } }`; при недоступности остаётся встроенный snapshot;
+- `refreshIntervalHours` — период опроса (0 отключает);
+- `estimate` — включает прогноз стоимости до запуска в ответе `orchestra_route`;
+- `warnThresholdUSD` — порог, выше которого роутер добавляет предупреждение «эта задача в `quality` обойдётся примерно в $X».
+
+Resolver формирует упорядоченный список более дешёвых fallback-кандидатов для execution-слоёв, которые умеют повторять вызовы. Сам плагин не перехватывает provider-вызовы OpenCode и поэтому не заявляет автоматический retry. Прогноз стоимости — информативное поле: выполнение не блокируется, а предупреждение помогает подтвердить расходы заранее.
+
 ## Агенты и команды
 
 Плагин добавляет один публичный `orch-lead`, скрытых workers и скрытый `orch-judge`. Workers не могут делегировать работу дальше; lead может вызывать только агентов Orchestra.
@@ -135,8 +199,11 @@ bunx @oeronteros-1/opencode-orchestra@latest install --help
 ```text
 /orchestra <задача>
 /orchestra-status
+/plugin-status
 ```
 
+`/orchestra-status` показывает статистику текущей Orchestra-сессии, а `/plugin-status` — версию загруженного плагина, бюджет, стратегию моделей и состояние companion MCP.
+
 Профили: `architecture`, `debug`, `ui`, `research`, `review`, `security`, `performance`, `migration`, `ops`.
 
 ## Context7, Codebase Memory и MemoryGraph
@@ -159,16 +226,18 @@ MemoryGraph отвечает за знания, которых нет непос
 
 Глобальный конфиг: `~/.config/opencode/orchestra.jsonc` (или `$XDG_CONFIG_HOME/opencode/orchestra.jsonc`). Проектный `.opencode/orchestra.jsonc` накладывается поверх глобального. Переменная `OPENCODE_CONFIG_DIR` также поддерживается.
 
-## Разработка
+## Требования и разработка
+
+Для установки рекомендуется Bun 1.2+. Для Node-based tooling и разработки требуется Node.js 22+.
 
 ```bash
-npm install
+npm ci
 npm run check
 npm run build
 npm pack --dry-run
 ```
 
-Перед публикацией пакет автоматически собирается через `prepack`.
+Перед публикацией `prepublishOnly` запускает полный check, а `prepack` пересобирает plugin и dashboard. Рабочая команда релиза: `npm publish --access public`. Перед ней проверьте содержимое tarball и создайте Git tag `v1.0.0`.
 
 ## Документация
 
@@ -194,14 +263,33 @@ bunx @oeronteros-1/opencode-orchestra@latest dashboard
 - input, output, reasoning и cache-токены;
 - фактическую стоимость, которую возвращает провайдер;
 - расходы и нагрузку по моделям и агентам;
-- виртуализированный журнал activity без текстов промптов и ответов;
+- виртуализированный журнал activity; тексты промптов и ответов отключены по умолчанию и сохраняются только при явном `telemetry.storeTexts: true`;
 - статус Context7, Codebase Memory, MemoryGraph и сохранённого пользователем Supermemory;
-- настройку режимов `eco`, `balanced`, `quality`, `ebobo` и моделей отдельных агентов.
+- настройку режимов `eco`, `balanced`, `quality`, `ebobo` и моделей отдельных агентов;
+- месячный прогноз, детектирование аномалий и экспорт activity/models/agents/daily/summary в CSV или JSON.
 
 Настройки сохраняются в `orchestra.jsonc` с резервной копией. Существующие MCP-записи dashboard не удаляет и не перезаписывает.
 
 Полезные параметры: `--directory DIR`, `--config-dir DIR`, `--host HOST`, `--port PORT`, `--no-open`.
 
+## Обновление с 0.5.x
+
+Повторно выполните установщик:
+
+```bash
+bunx @oeronteros-1/opencode-orchestra@latest install
+```
+
+Миграция `orchestra.jsonc` не требуется. Установщик сохранит существующие plugin options и MCP entries, обновит bare/pinned Orchestra entry до `@latest` и создаст backup перед изменением основного OpenCode config. После обновления перезапустите OpenCode и выполните `/plugin-status`.
+
+## Безопасность и приватность
+
+- dashboard по умолчанию слушает только `127.0.0.1` и защищён случайным токеном;
+- telemetry хранится локально в `.orchestra`;
+- тексты сообщений не сохраняются без `telemetry.storeTexts: true`;
+- pricing endpoint настраивается пользователем и не требуется для offline-оценки;
+- перед публикацией или баг-репортом не прикладывайте локальный ledger, если включали сохранение текстов.
+
 ## License
 
 MIT