@kisev/agentomatic 11.0.0-dev.46.gfbe1e4c6992e

package/README.md

@@ -0,0 +1,95 @@
+# OpenCode Integration
+
+[Русский](README.ru.md)
+
+`@kisev/agentomatic` is the first-class OpenCode-specific component of
+Agent Skills. It complements the portable skills but has its own installation,
+update, and removal lifecycle.
+
+## What It Adds
+
+- OpenCode slash-command adapters for installed portable skills.
+- Six fixed agents: `manager`, `architect`, `mapper`, `worker`, `review`, and
+  `critic`.
+- Capability routing plus direct CLI diagnostics, reconciliation, and profiles.
+- A confirmed `config` command that connects the package and recommended
+  fragments into `opencode.json(c)`, `tui.json`, `kilo.json(c)`, and
+  `mimocode.json(c)` while preserving existing entries and comments.
+- Optional plugin wrappers: `rules-injector`, `zed-bell`, and `memomatic`
+  personal learning memory; the `rtk` compression wrapper is deployed by
+  default and observable through `/rtk-stats` and `doctor`.
+
+The package does not contain, install, update, inspect, or remove portable skills.
+Their lifecycle is owned by the `skills` CLI.
+
+## Memomatic
+
+Memomatic is personal learning memory inspired by the OpenClaw architecture:
+tiered Markdown (`MEMORY.md`, `USER.md`, daily notes, `DREAMS.md`), a rebuildable
+SQLite index with FTS5 keyword search and optional local embeddings, and a
+nightly dream sweep that ingests session transcripts, promotes repeatedly useful
+entries through deterministic gates and one bounded model turn, supersedes
+outdated facts by key, and archives every pre-image.
+
+- State: `$XDG_STATE_HOME/memomatic/` (corpus, index, history, archive).
+- Config: `$XDG_CONFIG_HOME/memomatic/settings.json` (embedding endpoint, dream
+  model and variant, thresholds) and `MEMORY_RULES.md` with manual directives:
+  `- never-save: <topic>` and opt-in `- auto-clean: older-than=90d scope=episodic`.
+- Tools: `memory_search`, `memory_get`, `memory_write`, `memory_forget`, exposed
+  by the plugin, by the MCP stdio server (`memomatic mcp-serve`),
+  and by the CLI (`search`, `status`, `index`, `dream --dry-run`).
+- Scheduling: copy `memomatic-dream.service` and `memomatic-dream.timer` from the
+  package `assets/systemd/` into `~/.config/systemd/user/` and run
+  `systemctl --user enable --now memomatic-dream.timer`; run the sweep another
+  way by invoking `memomatic dream` yourself.
+- Forgetting is explicit or rule-gated: nothing is deleted without
+  `memory_forget` or an `auto-clean` directive; pinned entries never decay.
+
+## Requirements
+
+- Node.js 22 or later.
+- OpenCode `>=1.18.29 <1.19.0`.
+- A persistent npm project that owns the dependency.
+
+## Project Install
+
+Install the package in the repository's npm project and preview the managed
+assets:
+
+```shell
+npm install --save-exact @kisev/agentomatic
+npx --yes @kisev/agentomatic@latest install --dry-run
+```
+
+Run the exact confirmation command printed by the preview. If the selected
+assets need core integration, connect the package into the user-owned OpenCode
+configuration yourself or through the confirmed `config` command, which merges
+the `plugin` entry while preserving existing entries:
+
+```shell
+npx --yes @kisev/agentomatic@latest config --global --dry-run
+```
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@kisev/agentomatic"]
+}
+```
+
+Restart OpenCode after activation or asset changes. The `install` and
+`uninstall` commands never edit `opencode.json`; `config` is the only confirmed
+path for configuration fragments, and command adapter selections do not install
+portable skills.
+
+## Documentation
+
+The canonical documentation lives in `docs/`, not in the package source:
+
+- [Complete OpenCode integration guide](https://github.com/kisev/skills/blob/main/docs/how-to/opencode-integration.md)
+- [Portable skills guide](https://github.com/kisev/skills/blob/main/docs/how-to/portable-skills.md)
+- [Documentation index](https://github.com/kisev/skills/blob/main/docs/README.md)
+
+The complete guide covers global installation, asset selection, confirmation,
+activation, `config` fragments, `doctor`, update, `reconcile`, agent profiles,
+ownership, and uninstall.

package/README.ru.md

@@ -0,0 +1,98 @@
+# Интеграция с OpenCode
+
+[English](README.md)
+
+`@kisev/agentomatic` - полноценный компонент Agent Skills для OpenCode. Он
+дополняет переносимые навыки, но имеет собственный жизненный цикл установки,
+обновления и удаления.
+
+## Что добавляет пакет
+
+- Адаптеры слеш-команд OpenCode для установленных переносимых навыков.
+- Шесть агентов с фиксированными ролями: `manager`, `architect`, `mapper`, `worker`,
+  `review` и `critic`.
+- Маршрутизация по возможностям и прямой CLI для `doctor`, `reconcile` и
+  управления профилями агентов.
+- Команда `config` с подтверждением: подключает пакет и рекомендованные
+  фрагменты в `opencode.json(c)`, `tui.json`, `kilo.json(c)` и
+  `mimocode.json(c)`, сохраняя существующие записи и комментарии.
+- Необязательные обертки плагинов `rules-injector`, `zed-bell` и персональная
+  обучающая память `memomatic`; обертка сжатия `rtk` развертывается по умолчанию
+  и наблюдаема через `/rtk-stats` и `doctor`.
+
+Пакет не содержит, не устанавливает, не обновляет, не проверяет и не удаляет
+переносимые навыки. Их жизненным циклом управляет CLI `skills`.
+
+## Memomatic
+
+Memomatic - персональная обучающая память по мотивам архитектуры OpenClaw:
+ярусный Markdown (`MEMORY.md`, `USER.md`, ежедневные записи, `DREAMS.md`),
+пересобираемый SQLite-индекс с полнотекстовым поиском FTS5 и опциональными
+локальными эмбеддингами, а также ночной проход сновидений, который инжестит
+транскрипты сессий, продвигает стабильно полезные записи детерминированными
+воротами и одной ограниченной модельной фазой, замещает устаревшие факты по
+ключу и сохраняет все предобразы.
+
+- Состояние: `$XDG_STATE_HOME/memomatic/` (корпус, индекс, история, архив).
+- Настройки: `$XDG_CONFIG_HOME/memomatic/settings.json` (эндпоинт эмбеддера,
+  модель и вариант мышления для сновидений, пороги) и `MEMORY_RULES.md` с
+  ручными директивами: `- never-save: <тема>` и опциональная
+  `- auto-clean: older-than=90d scope=episodic`.
+- Инструменты: `memory_search`, `memory_get`, `memory_write`, `memory_forget` -
+  через плагин, MCP-сервер stdio (`memomatic mcp-serve`) и CLI
+  (`search`, `status`, `index`, `dream --dry-run`).
+- Расписание: скопируйте `memomatic-dream.service` и `memomatic-dream.timer` из
+  `assets/systemd/` пакета в `~/.config/systemd/user/` и выполните
+  `systemctl --user enable --now memomatic-dream.timer`; альтернативный запуск -
+  командой `memomatic dream`.
+- Забывание явно или по правилу: ничего не удаляется без `memory_forget` или
+  директивы `auto-clean`; закрепленные записи не затухают.
+
+## Требования
+
+- Node.js 22 или новее.
+- OpenCode `>=1.18.29 <1.19.0`.
+- Постоянный npm-проект, которому принадлежит зависимость.
+
+## Установка в проект
+
+Установите пакет в npm-проект репозитория и предварительно просмотрите
+управляемые файлы:
+
+```shell
+npm install --save-exact @kisev/agentomatic
+npx --yes @kisev/agentomatic@latest install --dry-run
+```
+
+Выполните точную команду подтверждения, которую выведет предварительный просмотр.
+Если для выбранных файлов нужна основная интеграция, подключите пакет в
+пользовательскую конфигурацию OpenCode вручную или подтвержденной командой
+`config`, которая добавляет запись `plugin` с сохранением существующих записей:
+
+```shell
+npx --yes @kisev/agentomatic@latest config --global --dry-run
+```
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@kisev/agentomatic"]
+}
+```
+
+Перезапустите OpenCode после активации или изменения файлов. Команды `install` и
+`uninstall` не редактируют `opencode.json`; `config` - единственный
+подтвержденный путь для фрагментов конфигурации, а выбор адаптеров команд не
+устанавливает переносимые навыки.
+
+## Документация
+
+Каноническая документация находится в `docs/`, а не в исходном коде пакета:
+
+- [Полная инструкция по интеграции OpenCode](https://github.com/kisev/skills/blob/main/docs/ru/how-to/opencode-integration.md)
+- [Инструкция по переносимым навыкам](https://github.com/kisev/skills/blob/main/docs/ru/how-to/portable-skills.md)
+- [Индекс документации](https://github.com/kisev/skills/blob/main/docs/ru/README.md)
+
+Полная инструкция описывает глобальную установку, выбор файлов, подтверждение,
+активацию, фрагменты `config`, `doctor`, обновление, `reconcile`, профили
+агентов, владение файлами и удаление.

package/dist/agent-profiles.d.ts

@@ -0,0 +1,125 @@
+import { LifecycleError, type SupersededPlan, type FileMutation, type Scope, type TransactionOptions } from "./lifecycle.js";
+export { type Scope as AgentProfileScope } from "./lifecycle.js";
+export declare const FIXED_AGENT_ROLES: readonly ["manager", "architect", "mapper", "worker", "review", "critic"];
+export type FixedAgentRole = (typeof FIXED_AGENT_ROLES)[number];
+export type AgentModelSelection = {
+    model: string;
+    variant?: string;
+};
+export type AgentProfileConfig = {
+    schema_version: 1;
+    fixed: Record<FixedAgentRole, AgentModelSelection | Record<string, never>>;
+    additional_critics: Record<string, AgentModelSelection>;
+};
+export type DeploymentRecord = {
+    kind: "fixed" | "additional-critic";
+    template: FixedAgentRole;
+    canonical_sha256: string;
+    configuration_sha256: string;
+    rendered_sha256: string;
+};
+export type DeploymentManifest = {
+    schema_version: 1;
+    package: "@kisev/agentomatic";
+    package_version: string;
+    scope: Scope;
+    critic_pool: string[];
+    profiles: Record<string, DeploymentRecord>;
+};
+export type AgentOwnership = "package-owned" | "managed" | "user-owned";
+export type AgentState = "current" | "missing" | "drift" | "collision";
+export type AgentProfileRecord = {
+    name: string;
+    ownership: AgentOwnership;
+    state: AgentState;
+    model?: string;
+    variant?: string;
+    rendered_sha256?: string;
+};
+export type AgentInventory = {
+    schema_version: 1;
+    scope: Scope;
+    root: string;
+    package_version: string;
+    critic_pool: string[];
+    profiles: AgentProfileRecord[];
+    user_owned: string[];
+    collisions: string[];
+    drift: string[];
+    requires_restart: false;
+    digest: string;
+};
+export type AgentProfileAction = "install" | "model-set" | "critic-add" | "critic-remove" | "reconcile" | "uninstall";
+export type AgentProfileRequest = {
+    action: AgentProfileAction;
+    name?: string;
+    model?: string;
+    variant?: string | null;
+};
+export type AgentProfileOperation = {
+    path: string;
+    operation: "create" | "update" | "remove" | "unchanged" | "conflict";
+    reason: string;
+    sha256?: string;
+};
+export type AgentProfilePlan = {
+    schema_version: 1;
+    domain: "agent-profiles";
+    action: AgentProfileAction;
+    scope: Scope;
+    root: string;
+    operations: AgentProfileOperation[];
+    critic_pool: string[];
+    plan_digest: string;
+    confirmation_digest?: string;
+    superseded_plan?: SupersededPlan;
+    digest: string;
+    receipt_expires_at?: string;
+    requires_restart: boolean;
+};
+export type AgentProfileResult = {
+    status: "ok";
+    applied: boolean;
+    requires_restart: boolean;
+    plan: AgentProfilePlan;
+};
+export declare class AgentProfileError extends LifecycleError {
+}
+type LegacyManifest = {
+    schema_version: 1;
+    package: string;
+    version: string;
+    files: Record<string, {
+        sha256: string;
+    }>;
+};
+export type LegacyAgentOwnership = {
+    manifest: LegacyManifest;
+    manifestPath: string;
+    manifestSha256: string;
+};
+type BuiltPlan = {
+    plan: AgentProfilePlan;
+    mutations: FileMutation[];
+    inventoryDigest: string;
+    config: AgentProfileConfig;
+    manifest?: DeploymentManifest;
+    expectedConfig?: Buffer;
+    expectedManifest?: Buffer;
+    legacyTransferred: string[];
+};
+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, 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>;
+export declare function applyAgentProfileChange(request: AgentProfileRequest, scope: Scope, confirmationDigest: string, cwd?: string, home?: string, options?: TransactionOptions): Promise<AgentProfileResult>;
+export declare function availableModels(): Promise<string[]>;
+export declare function availableModelVariants(model: string): Promise<string[]>;
+export declare function inspectFileMode(path: string): Promise<number | undefined>;
+export declare function readLegacyManifest(root: string): Promise<LegacyAgentOwnership | undefined>;
+export declare function applyBuiltAgentPlan(built: BuiltPlan, stateRoot: string, options?: TransactionOptions): Promise<void>;
+export type { BuiltPlan as InternalAgentProfilePlan, LegacyManifest as LegacyInstallerManifest };