@kisev/skills-opencode 1.2.0 → 2.0.0

package/README.md

@@ -1,70 +1,101 @@
-# Интеграция OpenCode
+# OpenCode Integration
 
-`@kisev/skills-opencode` - npm package с capability router, OpenCode runtime,
-управлением agent profiles и opt-in installer для agents, commands и plugins. Он
-не включает portable skills и не меняет конфигурацию при import, plugin load или
-npm lifecycle. Package требует Node.js 22+ и OpenCode 1.18.29+.
+[Русский](README.ru.md)
 
-## Установка skills
+`@kisev/skills-opencode` is the optional npm integration. It does not include
+portable skills or mutate configuration on import.
+Managed files use exact SHA-256 ownership checks.
+It provides the capability router, OpenCode runtime, agent-profile management,
+and an opt-in installer for agents, commands, and plugins. It requires Node.js
+22+ and OpenCode 1.18.29+; import, plugin loading, and npm lifecycle do not
+write configuration.
 
-Сначала установите нужные portable skills через `npx skills` из публичного
-репозитория:
+## Install Skills
+
+Install portable skills first:
 
 ```shell
 npx --yes skills add kisev/skills --agent opencode --skill '*' --copy --yes
 ```
 
-Для одного skill укажите `--skill <name>`. Для воспроизводимой установки можно
-передать URL GitHub tag, например
-`https://github.com/kisev/skills/tree/v1.1.1`. Package никогда не устанавливает
-и не обновляет skills. Если команда не нашла skill, она сообщает точную команду
-`npx skills add` для его установки.
-
-## Установка integration
+Use `--skill <name>` for one skill. `npx skills` accepts a reproducible tag URL,
+for example `https://github.com/kisev/skills/tree/v2.0.0`; the package never
+installs or updates skills and reports the exact `npx skills add` command when a
+skill is missing.
 
-Установите npm package там, где OpenCode сможет разрешить plugin:
+## Install Integration
 
 ```shell
-npm install @kisev/skills-opencode@1.1.1
+npm install @kisev/skills-opencode@2.0.0
 ```
 
-Сначала покажите план installer. По умолчанию CLI выводит короткую сводку:
-счётчики по группам, только изменяемые paths, conflicts, restart flag, digest и
-готовую confirm-команду. Эта команда не меняет deployment:
+Interactive selection is available only in a TTY. Non-TTY installs require
+explicit `--commands`, `--agents`, and `--plugins` flags; selectable plugins
+default to an empty set. The wizard shows skill commands, package commands,
+fixed agents, and `rules-injector`, `rtk`, `zed-bell`.
+
+Preview before any write:
 
 ```shell
 npm exec -- skills-opencode install --scope global --dry-run
 ```
 
-Проверьте сводку и примените только показанный digest:
+Apply the shown digest only:
 
 ```shell
 npm exec -- skills-opencode install --scope global --confirm <digest>
 ```
 
-`global` устанавливает assets в `~/.config/opencode/agents`,
-`~/.config/opencode/commands` и `~/.config/opencode/plugins`. Для текущего
-repository используйте `project`:
+Use `--json` for automation.
+The machine-readable plan includes `requires_restart`; a preview uses `--dry-run`
+and an apply uses `--confirm <digest>` with identical arguments.
+
+`global` manages `.config/opencode/agents`, `.config/opencode/commands`, and
+`.config/opencode/plugins`. Project scope manages `.opencode/agents`,
+`.opencode/commands`, and `.opencode/plugins`. Profile configuration is kept in
+`.config/opencode/.skills-opencode/agent-profiles.json` globally or under
+`.opencode/.skills-opencode` for a project.
+Project assets are limited to the current working directory. Scope is required;
+the installer never changes `opencode.json`, overwrites unknown or modified
+files, or records ownership manifests before confirmed apply. The short preview
+reports changed paths, conflicts, restart status, digest, and its confirm command.
+
+## Read-only Doctor
+
+`doctor` reports facts without writing:
 
 ```shell
-npm exec -- skills-opencode install --scope project --dry-run
-npm exec -- skills-opencode install --scope project --confirm <digest>
+npm exec -- skills-opencode doctor --scope project
+npm exec -- skills-opencode doctor --scope global --json
 ```
 
-Project assets находятся в `.opencode/agents`, `.opencode/commands` и
-`.opencode/plugins` текущего working directory. Scope обязателен. Installer не изменяет `opencode.json`, не
-перезаписывает неизвестные или изменённые files и сохраняет ownership manifests
-только после confirmed apply.
+It never creates lifecycle state, consumes receipts, recovers journals, starts
+plugins, or starts LSP servers. Its versioned JSON report contains stable check
+IDs, catalog and installed-manifest versions, ownership/drift/collision classes,
+inventory findings, runtime summaries, redacted configuration projections, and
+LSP facts. It never serializes secrets, raw configuration, environment values,
+receipts, or credentials. Exit status `0` is clean, `1` reports findings, and
+`2` means invalid input or an incomplete probe failure.
 
-Для automation добавьте `--json`. Этот режим сохраняет полный стабильный
-machine-readable plan, включая `operations` и `requires_restart`:
+## Reconcile Retired Assets
+
+`reconcile` previews retirement and preserves conflicts:
 
 ```shell
-npm exec -- skills-opencode install --scope global --dry-run --json
-npm exec -- skills-opencode agent list --scope global --json
+npm exec -- skills-opencode reconcile --scope project --dry-run
+npm exec -- skills-opencode reconcile --scope project --confirm <digest>
+npm exec -- skills-opencode reconcile --scope global --dry-run --json
 ```
 
-Добавьте plugin в `opencode.json` вручную:
+It considers only public portable skills, package commands, plugins, agents, and
+installation metadata for the selected scope. Retired exact-owned files move to
+a private content-addressed XDG archive with an index, never disappear.
+Modified-managed, user-owned, unknown, symlink, unsafe-path, worktree, and
+ambiguous-source entries remain byte-for-byte conflicts. The journaled target and
+archive transaction provides rollback, recovery, and repeatable no-op operation.
+Doctor reports archive entries and conflicts read-only.
+
+Add the plugin manually:
 
 ```json
 {
@@ -73,15 +104,9 @@ npm exec -- skills-opencode agent list --scope global --json
 }
 ```
 
-Полностью перезапустите OpenCode после install, upgrade или uninstall: registry
-agents и commands строится до plugin hooks.
+## Manage Agents
 
-## Управление agents
-
-Рекомендуемый интерфейс - прямой terminal CLI: он не вызывает LLM и не расходует
-токены. Fixed roles `manager`, `architect`, `mapper`, `worker`, `review` и
-стандартный `critic` всегда сохраняют имена и canonical prompts/permissions.
-Меняются только `model` и `variant`:
+The direct CLI manages models without LLM calls:
 
 ```shell
 npm exec -- skills-opencode agent list --scope global
@@ -91,17 +116,17 @@ npm exec -- skills-opencode agent model-set worker --scope global \
 npm exec -- skills-opencode agent reconcile --scope global --dry-run
 ```
 
-`agent configure` предлагает настоящий terminal wizard: стрелками выбираются
-agent из inventory, затем provider, только его models и, если metadata выбранной
-модели публикует variants, variant. Текущие model/variant и target показываются
-перед выбором; доступны `keep`, `change`, `clear variant`, `back` и `cancel`.
-Wizard не вызывает LLM, OpenCode Question или refresh catalog. Если catalog
-недоступен, он завершается без записи и печатает инструкцию для exact
-`--model <provider/model>` с optional `--variant`. Для модели без variants
-дополнительный selector не показывается.
+Fixed roles preserve their names and canonical prompts and permissions; only
+model and variant change. The interactive configuration wizard selects an agent,
+provider, its models, and published variants, showing the current target and
+offering keep, change, clear variant, back, and cancel. It does not invoke an
+LLM, OpenCode Question, or catalog refresh. If the catalog is unavailable it
+does not write and prints the exact model instruction.
 
-Additional critic имеет имя `critic-<safe-suffix>`. Стандартный `critic` и fixed
-roles нельзя удалить или переименовать:
+When the catalog is unavailable, use exact `--model <provider/model>` and an
+optional `--variant`; `provider/model` identifies the selected model. The
+optional `agent_profiles` tool and slash commands adapt the same direct-CLI
+plan/apply contract.
 
 ```shell
 npm exec -- skills-opencode critic add security --scope global \
@@ -109,77 +134,74 @@ npm exec -- skills-opencode critic add security --scope global \
 npm exec -- skills-opencode critic remove security --scope global --dry-run
 ```
 
-Для любой mutation используйте готовую confirm-команду из preview либо замените
-`--dry-run` на `--confirm <digest>` и повторите те же аргументы. Человекочитаемый
-plan не печатает полный JSON и сворачивает длинные группы paths. Digest связан с
-одноразовым private receipt, действует 10 минут и повторно не применяется. Для
-machine-readable result добавьте `--json`; поле `requires_restart` сообщает о
-необходимости полностью перезапустить OpenCode.
-
-В global scope profile configuration хранится в
-`~/.config/opencode/.skills-opencode/agent-profiles.json`, а semantic deployment
-manifest - рядом в `agent-profiles.manifest.json`. Для project scope те же файлы
-находятся под `.opencode/.skills-opencode/`. Configuration хранит выбранные
-model/variant и additional critics; package update её не сбрасывает. Manifest
-хранит package version, exact critic pool и hashes canonical configuration и
-rendered files.
-
-Inventory различает `package-owned`, `managed`, `user-owned`, `drift` и exact-name
-`collision`. User-owned и неизвестные agents не изменяются. Collision блокирует
-apply; drift исправляется только явным `agent reconcile`. Все mutations проходят
-под lifecycle lock, повторно проверяют inventory, используют journaled
-all-or-rollback transaction и выполняют final validation. После прерывания
-следующая mutation безопасно восстанавливает before-images и требует свежий plan.
-
-## Upgrade и uninstall
-
-После обновления npm package снова выполните dry-run и подтвердите новый digest.
-Installer обновляет только files с совпадающим managed SHA-256.
-
-При первом upgrade с `1.0.0` installer передаёт ownership шести fixed agents из
-generic manifest в profile domain только при точном совпадении package/version,
-manifest records и SHA-256 каждого файла. Любое отличие остаётся конфликтом.
-Commands и plugins продолжают принадлежать generic installer. Uninstall удаляет
-неизменённые deployments, но сохраняет profile configuration для последующей
-установки.
+Additional critics use `critic-<safe-suffix>`; fixed roles and the standard
+critic cannot be renamed or removed. Every mutation uses a one-time private
+receipt valid for 10 minutes, a lifecycle lock, inventory recheck, journaled
+all-or-rollback transaction, and final validation. Interrupted mutations recover
+before requiring a fresh plan. Global profile configuration and its semantic
+deployment manifest are kept together; project scope keeps corresponding files
+under its `.opencode` directory. Package updates do not reset selected models,
+variants, or additional critics.
+
+## Upgrade and Uninstall
 
 ```shell
 npm exec -- skills-opencode uninstall --scope global --dry-run
 npm exec -- skills-opencode uninstall --scope global --confirm <digest>
 ```
 
-Uninstall удаляет только files из ownership manifest, если их SHA-256 не
-изменился. Изменённые пользователем files остаются как `conflict`.
+The full JSON install preview is:
 
-## Runtime options
+```shell
+npm exec -- skills-opencode install --scope global --dry-run --json
+```
 
-Package экспортирует independent plugin factories `background-attempts`,
-`goal-loop`, `schedule`, `autonomy-policy`, `rules-injector`, `rtk`, `zed-bell`
-и `zed-clickable-paths`. Stateful plugins Background Attempts, Goal Loop,
-Scheduler и Autonomy Policy отключены по умолчанию. Zed integrations также
-optional. Включайте subsystem только в собственном user-owned plugin wrapper:
+On upgrade, the installer updates only managed files whose SHA-256 still matches.
+The one-time `1.0.0` migration transfers the six fixed-agent ownership records
+only when package/version, manifest records, and every file hash match exactly.
+Uninstall removes only unchanged manifest-owned files; modified files remain
+conflicts and profile configuration is retained for a later installation.
 
-```js
-import goalLoop from "@kisev/skills-opencode/plugins/goal-loop";
+## Runtime Options
 
-export default (input) => goalLoop(input, { enabled: true });
+Plugins are independent and selectable ones are opt-in.
+
+```shell
+npm exec -- skills-opencode agent list --scope global --json
 ```
 
-`rules-injector` fail-soft применяет ограниченный budget и пропускает native
-project/global rules. `rtk` fail-open сжимает большой bash output и добавляет
-подсказку для edit error, но не содержит ownership guard.
+The package exports the core OpenCode plugin and independent factories for
+`rules-injector`, `rtk`, and `zed-bell`. Retired plugin APIs and internal lifecycle
+implementations are not public. Rules injection fails soft within a bounded
+budget; RTK fails open.
+
+## Stage 18 Routing
+
+`doit` owns the complete evidence -> plan -> confirmation -> execution -> checks
+-> report lifecycle; `manager` only adapts it to OpenCode. The route tool has four
+destinations: exploration to `mapper`, architecture to `architect`, implementation
+to `worker`, and review to `review` or one selected `critic`. Documentation and
+quick work remain in `doit`.
 
-## Границы
+The route inventory comes only from resolved host configuration. Callers cannot
+inject agents, capabilities, tools, models, or availability. Versioned receipts,
+cards, and mapper/worker/review/critic reports are checked at real Task dispatch
+and result hooks. Cards bind paths, checks, explicit VCS operations, and separate
+execution, publication, and history-rewrite confirmations.
+
+## Boundaries
+
+Portable skills and package assets install independently.
+
+```shell
+npm exec -- skills-opencode install --scope project --dry-run
+npm exec -- skills-opencode install --scope project --confirm <digest>
+```
 
-Portable skills в корне `skills/` универсальны и устанавливаются только через
-`npx skills`. Этот package поставляет только OpenCode-specific assets и runtime
-router. Команды - тонкие adapters: передают `$ARGUMENTS` как недоверенный ввод
-в native Skill tool, а target validation, confirmation, batch/review rules и
-формат результата остаются ответственностью skill или runner.
-`capabilities`, `route` и `doctor` - package tools/commands для catalog, routing и
-health. Tool `agent_profiles` и четыре slash-команды `agent-list`,
-`agent-model-set`, `critic-add`, `critic-remove` - optional thin UX над теми же
-plan/apply contracts. Отдельного skill `agent-profiles` нет.
+Commands are thin adapters that pass untrusted arguments to the native Skill
+tool; validation, confirmation, batch/review rules, and result format remain the
+skill or runner responsibility. `capabilities`, `route`, and `doctor` are package
+tools and commands for catalog, routing, and health. `agent_profiles` and the
+four agent slash commands are optional UX adapters, not a separate skill.
 
-Package распространяется по лицензии MIT. Полные инструкции по portable skills,
-upgrade и security boundaries находятся в корневом README репозитория.
+The package is MIT-licensed; the repository root README has full instructions.

package/README.ru.md

@@ -0,0 +1,242 @@
+# Интеграция OpenCode
+
+[English](README.md) | [Русский](README.ru.md)
+
+`@kisev/skills-opencode` - npm package с capability router, OpenCode runtime,
+управлением agent profiles и opt-in installer для agents, commands и plugins. Он
+не включает portable skills и не меняет конфигурацию при import, plugin load или
+npm lifecycle. Package требует Node.js 22+ и OpenCode 1.18.29+.
+
+## Установка skills
+
+Сначала установите нужные portable skills через `npx skills` из публичного
+репозитория:
+
+```shell
+npx --yes skills add kisev/skills --agent opencode --skill '*' --copy --yes
+```
+
+Для одного skill укажите `--skill <name>`. Для воспроизводимой установки можно
+передать URL GitHub tag, например
+`https://github.com/kisev/skills/tree/v2.0.0`. Package никогда не устанавливает
+и не обновляет skills. Если команда не нашла skill, она сообщает точную команду
+`npx skills add` для его установки.
+
+## Установка integration
+
+Установите npm package там, где OpenCode сможет разрешить plugin:
+
+```shell
+npm install @kisev/skills-opencode@2.0.0
+```
+
+Interactive selection доступен только в TTY. В non-TTY install нужно явно передать
+`--commands`, `--agents` и `--plugins`; selectable plugins по умолчанию пусты.
+Wizard показывает skill commands, package commands, fixed agents и
+`rules-injector`, `rtk`, `zed-bell`. Сначала покажите план installer. CLI выводит короткую сводку:
+счётчики по группам, только изменяемые paths, conflicts, restart flag, digest и
+готовую confirm-команду. Эта команда не меняет deployment:
+
+```shell
+npm exec -- skills-opencode install --scope global --dry-run
+```
+
+Проверьте сводку и примените только показанный digest:
+
+```shell
+npm exec -- skills-opencode install --scope global --confirm <digest>
+```
+
+`global` устанавливает assets в `~/.config/opencode/agents`,
+`~/.config/opencode/commands` и `~/.config/opencode/plugins`. Для текущего
+repository используйте `project`:
+
+```shell
+npm exec -- skills-opencode install --scope project --dry-run
+npm exec -- skills-opencode install --scope project --confirm <digest>
+```
+
+Project assets находятся в `.opencode/agents`, `.opencode/commands` и
+`.opencode/plugins` текущего working directory. Scope обязателен. Installer не изменяет `opencode.json`, не
+перезаписывает неизвестные или изменённые files и сохраняет ownership manifests
+только после confirmed apply.
+
+Для automation добавьте `--json`. Этот режим сохраняет полный стабильный
+machine-readable plan, включая `operations` и `requires_restart`:
+
+```shell
+npm exec -- skills-opencode install --scope global --dry-run --json
+npm exec -- skills-opencode agent list --scope global --json
+```
+
+## Read-only doctor
+
+`doctor` is a read-only installer health report. It never creates lifecycle
+state, consumes receipts, recovers journals, starts plugins or starts LSP
+servers. `project` and `global` are isolated scopes; unavailable OpenCode host
+facts are reported as incomplete rather than inferred.
+
+```shell
+npm exec -- skills-opencode doctor --scope project
+npm exec -- skills-opencode doctor --scope global --json
+```
+
+The JSON report is versioned and contains stable check IDs, package/catalog and
+installed-manifest versions, ownership/drift/collision classifications, stage-8
+inventory findings, lifecycle/runtime state summaries, redacted config
+projections and LSP facts. Secrets, raw config, environment values, receipts
+and credentials are never serialized. Exit code `0` is clean, `1` reports
+findings, and `2` means invalid input or an incomplete probe failure.
+
+## Reconcile retired assets
+
+`reconcile` проверяет только public portable skills, package commands, plugins,
+agents и installation metadata выбранного scope. XDG runtime state не читается и
+не изменяется. Preview сохраняет private receipt с TTL и печатает digest:
+
+```shell
+npm exec -- skills-opencode reconcile --scope project --dry-run
+npm exec -- skills-opencode reconcile --scope project --confirm <digest>
+npm exec -- skills-opencode reconcile --scope global --dry-run --json
+```
+
+Retired files с доказанным inventory ownership и exact SHA-256 перемещаются в
+private content-addressed XDG archive с index, а не удаляются. Modified-managed,
+user-owned, unknown, symlink, unsafe-path, worktree и ambiguous-source entries
+остаются conflicts без изменения bytes. Journal target и archive обеспечивает
+rollback, recovery и повторный no-op reconcile. Doctor показывает archive и
+conflicts read-only.
+
+Добавьте plugin в `opencode.json` вручную:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@kisev/skills-opencode"]
+}
+```
+
+Полностью перезапустите OpenCode после install, upgrade или uninstall: registry
+agents и commands строится до plugin hooks.
+
+## Управление agents
+
+Рекомендуемый интерфейс - прямой terminal CLI: он не вызывает LLM и не расходует
+токены. Fixed roles `manager`, `architect`, `mapper`, `worker`, `review` и
+стандартный `critic` всегда сохраняют имена и canonical prompts/permissions.
+Меняются только `model` и `variant`:
+
+```shell
+npm exec -- skills-opencode agent list --scope global
+npm exec -- skills-opencode agent configure manager --scope global --dry-run
+npm exec -- skills-opencode agent model-set worker --scope global \
+  --model openai/gpt-5 --variant high --dry-run
+npm exec -- skills-opencode agent reconcile --scope global --dry-run
+```
+
+`agent configure` предлагает настоящий terminal wizard: стрелками выбираются
+agent из inventory, затем provider, только его models и, если metadata выбранной
+модели публикует variants, variant. Текущие model/variant и target показываются
+перед выбором; доступны `keep`, `change`, `clear variant`, `back` и `cancel`.
+Wizard не вызывает LLM, OpenCode Question или refresh catalog. Если catalog
+недоступен, он завершается без записи и печатает инструкцию для exact
+`--model <provider/model>` с optional `--variant`. Для модели без variants
+дополнительный selector не показывается.
+
+Additional critic имеет имя `critic-<safe-suffix>`. Стандартный `critic` и fixed
+roles нельзя удалить или переименовать:
+
+```shell
+npm exec -- skills-opencode critic add security --scope global \
+  --model anthropic/claude-sonnet-4-6 --dry-run
+npm exec -- skills-opencode critic remove security --scope global --dry-run
+```
+
+Для любой mutation используйте готовую confirm-команду из preview либо замените
+`--dry-run` на `--confirm <digest>` и повторите те же аргументы. Человекочитаемый
+plan не печатает полный JSON и сворачивает длинные группы paths. Digest связан с
+одноразовым private receipt, действует 10 минут и повторно не применяется. Для
+machine-readable result добавьте `--json`; поле `requires_restart` сообщает о
+необходимости полностью перезапустить OpenCode.
+
+В global scope profile configuration хранится в
+`~/.config/opencode/.skills-opencode/agent-profiles.json`, а semantic deployment
+manifest - рядом в `agent-profiles.manifest.json`. Для project scope те же файлы
+находятся под `.opencode/.skills-opencode/`. Configuration хранит выбранные
+model/variant и additional critics; package update её не сбрасывает. Manifest
+хранит package version, exact critic pool и hashes canonical configuration и
+rendered files.
+
+Inventory различает `package-owned`, `managed`, `user-owned`, `drift` и exact-name
+`collision`. User-owned и неизвестные agents не изменяются. Collision блокирует
+apply; drift исправляется только явным `agent reconcile`. Все mutations проходят
+под lifecycle lock, повторно проверяют inventory, используют journaled
+all-or-rollback transaction и выполняют final validation. После прерывания
+следующая mutation безопасно восстанавливает before-images и требует свежий plan.
+
+## Upgrade и uninstall
+
+После обновления npm package снова выполните dry-run и подтвердите новый digest.
+Installer обновляет только files с совпадающим managed SHA-256.
+
+При первом upgrade с `1.0.0` installer передаёт ownership шести fixed agents из
+generic manifest в profile domain только при точном совпадении package/version,
+manifest records и SHA-256 каждого файла. Любое отличие остаётся конфликтом.
+Commands и plugins продолжают принадлежать generic installer. Uninstall удаляет
+неизменённые deployments, но сохраняет profile configuration для последующей
+установки.
+
+```shell
+npm exec -- skills-opencode uninstall --scope global --dry-run
+npm exec -- skills-opencode uninstall --scope global --confirm <digest>
+```
+
+Uninstall удаляет только files из ownership manifest, если их SHA-256 не
+изменился. Изменённые пользователем files остаются как `conflict`.
+
+## Runtime options
+
+Package экспортирует core OpenCode plugin и independent plugin factories
+`rules-injector`, `rtk`, `zed-bell`. Retired plugin APIs и internal lifecycle
+implementations public surface не входят:
+
+Background Attempts создают workspace только через единый managed worktree
+owner. Records используют private current-only state, marker и repository
+fingerprint; release перепроверяет регистрацию, fingerprint и чистый status и
+возвращает `blocked` без удаления при расхождении. Scheduler принимает строгий
+five-field cron, не воспроизводит missed slots и пишет receipts `started`,
+`completed`, `failed` или `overrun`.
+
+`rules-injector` fail-soft применяет ограниченный budget и пропускает native
+project/global rules. `rtk` fail-open сжимает большой bash output и добавляет
+подсказку для edit error, но не содержит ownership guard.
+
+## Routing этапа 18
+
+`doit` владеет полным lifecycle evidence -> plan -> confirmation -> execution ->
+checks -> report; `manager` только адаптирует его к OpenCode. Tool `route` имеет
+четыре назначения: exploration -> `mapper`, architecture -> `architect`,
+implementation -> `worker`, review -> `review` или один `critic`. Documentation и
+quick остаются у `doit`.
+
+Inventory берётся только из resolved host config. Caller не может подменить agents,
+capabilities, tools, models или availability. Versioned receipts, cards и
+mapper/worker/review/critic reports проверяются на реальных Task dispatch/result
+hooks. Card связывает paths, checks, явные VCS operations и отдельные confirmations
+для execution, publication и history rewrite.
+
+## Границы
+
+Portable skills в корне `skills/` универсальны и устанавливаются только через
+`npx skills`. Этот package поставляет только OpenCode-specific assets и runtime
+router. Команды - тонкие adapters: передают `$ARGUMENTS` как недоверенный ввод
+в native Skill tool, а target validation, confirmation, batch/review rules и
+формат результата остаются ответственностью skill или runner.
+`capabilities`, `route` и `doctor` - package tools/commands для catalog, routing и
+health. Tool `doctor` and direct CLI share one read-only facts API; `/doctor` is
+only a thin adapter. Tool `agent_profiles` и четыре slash-команды `agent-list`,
+`agent-model-set`, `critic-add`, `critic-remove` - optional thin UX над теми же
+plan/apply contracts. Отдельного skill `agent-profiles` нет.
+
+Package распространяется по лицензии MIT. Полные инструкции по portable skills,
+upgrade и security boundaries находятся в корневом README репозитория.

package/dist/agent-profiles.d.ts

@@ -109,7 +109,7 @@ export declare function validateAgentName(name: string): string;
 export declare function validateModel(model: string): string;
 export declare function validateVariant(variant: string | null | undefined): string | undefined;
 export declare function renderAgentProfile(name: string, config: AgentProfileConfig, canonical: Record<FixedAgentRole, Buffer>): Buffer;
-export declare function buildAgentProfilePlan(request: AgentProfileRequest, scope: Scope, cwd?: string, home?: string, legacy?: LegacyAgentOwnership): Promise<BuiltPlan>;
+export declare function buildAgentProfilePlan(request: AgentProfileRequest, scope: Scope, cwd?: string, home?: string, legacy?: LegacyAgentOwnership, selectedAgents?: readonly FixedAgentRole[]): Promise<BuiltPlan>;
 export declare function validateBuiltAgentProfilePlan(built: BuiltPlan): Promise<void>;
 export declare function listAgentProfiles(scope: Scope, cwd?: string, home?: string): Promise<AgentInventory>;
 export declare function previewAgentProfileChange(request: AgentProfileRequest, scope: Scope, cwd?: string, home?: string): Promise<AgentProfilePlan>;