gennady 0.6.1 → 0.7.0

package/dist/shared/backend/rc/rc-config.d.ts

@@ -1,51 +1,63 @@
 /**
- * @purpose Описать конфигурацию одной AI-модели в rc-файле (имя, URL, опциональный ключ).
+ * @purpose Describe AI model configuration in rc-file (name, URL, optional key).
  * @consumer GennadyRc, ai-legacy
  */
 export type RcModel = {
+    /** @purpose Model identifier string (e.g. 'deepseek-v4-pro'). */
     model: string;
+    /** @purpose Base URL of the model API endpoint. */
     url: string;
+    /** @purpose Optional API key for authenticated requests. */
     key?: string;
 };
 /**
- * @purpose Корневая структура данных конфигурации Gennady RC (список моделей).
+ * @purpose Root configuration data structure for Gennady RC (model list).
  * @consumer GennadyRc
  */
 export type GennadyRcData = {
+    /** @purpose List of configured AI models. */
     models: RcModel[];
 };
 /**
- * @purpose Загрузить и парсить конфигурацию Gennady из rc-файла в заданной директории.
+ * @purpose Load and parse Gennady configuration from rc-file in a given directory.
+ * @invariant On read/parse error _error is populated; getModels() returns an empty array.
+ * @sideEffect IO: file read at constructor.
  * @consumer ai-legacy, CLI agent
- * @invariant При ошибке чтения/парсинга _error заполняется; getModels() возвращает пустой массив.
- * @sideEffect IO: чтение файла при конструкторе.
  */
 export declare class GennadyRc {
-    /** @purpose Имя файла конфигурации по умолчанию. */
+    /** @purpose Default configuration filename. */
     static DEFAULT_FILENAME: string;
     /**
-     * @purpose Создать экземпляры GennadyRc для текущей директории и HOME (приоритет поиска).
-     * @returns Массив из двух экземпляров: [cwd, HOME].
-     * @sideEffect IO: чтение файлов при конструкторе.
+     * @purpose Create GennadyRc instances for current directory and HOME (lookup priority).
+     * @returns Array of two instances: [cwd, HOME].
+     * @sideEffect IO: file read at constructor.
      */
     static getDefaults(): GennadyRc[];
+    /** @purpose Full path to the loaded rc config file. */
     protected _filename: string;
+    /** @purpose Parsed configuration data with model list. */
     protected _data: GennadyRcData;
+    /** @purpose Load/parse error if config is invalid, null otherwise. */
     protected _error: Error | null;
+    /**
+     * @purpose Load and parse Gennady RC config file from a directory.
+     * @param [dir] Directory to look for the rc file in (defaults to cwd).
+     * @param [name] Config filename (defaults to .gennadyrc).
+     */
     constructor(dir?: string, name?: string);
     /**
-     * @purpose Проверить, что конфигурация была успешно загружена и распознана.
-     * @returns true, если ошибки нет; false при ошибке парсинга или невалидных данных.
+     * @purpose Check that configuration was successfully loaded and recognized.
+     * @returns true if no error; false on parse error or invalid data.
      */
     isValid(): boolean;
     /**
-     * @purpose Получить список моделей из загруженного rc.
-     * @returns Массив RcModel (пустой при ошибке или отсутствии файла).
+     * @purpose Get list of models from loaded rc.
+     * @returns Array of RcModel (empty on error or missing file).
      */
     getModels(): RcModel[];
     /**
-     * @purpose Получить ошибку загрузки/парсинга, если она произошла.
-     * @returns Error или null при успешной загрузке.
+     * @purpose Get load/parse error if one occurred.
+     * @returns Error or null on successful load.
      */
     getError(): Error | null;
 }

package/dist/shared/common/exec.d.ts

@@ -1,9 +1,7 @@
 /**
- * @purpose Выполнить системную команду синхронно с безопасной обработкой ошибок.
- * @consumer git/git-core, другие домены через utils
- * @pre Команда и бинарь доступны в PATH; запуск в корректном окружении.
- * @param cmd Строка команды для выполнения в подпроцессе.
- * @returns Стандартный вывод (stdout) как строка; пустая строка при ошибке.
- * @sideEffect Process: запуск внешнего процесса; Logs: error при сбое.
+ * @purpose Execute system command synchronously with safe error handling.
+ * @pre Command and binary available in PATH; run in correct environment.
+ * @sideEffect Process: launch external process; Logs: error on failure.
+ * @consumer git/git-core, other domains via utils
  */
 export declare const execSyncSafe: (cmd: string) => string;

package/dist/shared/common/files.d.ts

@@ -1,7 +1,5 @@
 /**
- * @purpose Определить, является ли файл тестовым по соглашениям имени.
+ * @purpose Determine whether a file is a test file by naming conventions.
  * @consumer core/utils
- * @param filename Имя или путь файла для проверки.
- * @returns true, если имя соответствует *.test.* или *.spec.* (с optional 's'); иначе false.
  */
 export declare const isTestFile: (filename: string) => boolean;

package/dist/shared/common/language.d.ts

@@ -1,14 +1,11 @@
 /**
- * @purpose Определить язык программирования по расширению файла.
+ * @purpose Determine programming language by file extension.
  * @consumer review-gen, cat-gen
- * @param ext Расширение без точки (например 'ts', 'js').
- * @returns Человекочитаемое имя языка или undefined, если расширение неизвестно.
  */
 export declare const getProgrammingLanguage: (ext: string) => string | undefined;
 /**
- * @purpose Получить системный язык пользователя (locale) для локализации вывода.
+ * @purpose Get system user language (locale) for output localization.
+ * @sideEffect Process: call osascript to read system info.
  * @consumer ai-legacy, prompts
- * @sideEffect Process: вызов osascript для чтения system info.
- * @returns Код языка (например 'ru', 'en') или 'en' при ошибке.
  */
 export declare const getSysLang: () => string;

package/dist/shared/common/parse-args.d.ts

@@ -1,9 +1,6 @@
 /**
- * @purpose Распарсить аргументы командной строки по схеме опций и алиасов.
+ * @purpose Parse command-line arguments by options schema and aliases.
  * @consumer CLI (gennady, cmd/*)
- * @param argv Массив аргументов (обычно process.argv).
- * @param [schema] Схема: ключ — имя опции в результате, значение — массив алиасов (например --opt, -o).
- * @returns Объект: ключи из schema с значениями или true; _ — массив позиционных аргументов.
  */
 export declare const parseArgs: <T extends Record<string, string[]>>(argv: string[], schema?: T) => Record<keyof T | "_", unknown> & {
     _: string[];

package/dist/shared/common/style.d.ts

@@ -2,10 +2,10 @@ type Styler = ((text: string) => string) & {
     [key: string]: Styler;
 };
 /**
- * @purpose Предоставить цепочку стилей для раскраски текста в терминале (ANSI).
+ * @purpose Provide style chain for terminal text coloring (ANSI).
+ * @invariant With NO_COLOR flag (plain, nocolor, --color=no etc.) returns text without codes; otherwise — with ANSI codes.
+ * @sideEffect Read process.argv at module initialization.
  * @consumer CLI, review-gen, commit-gen, cat-gen
- * @invariant При флаге NO_COLOR (plain, nocolor, --color=no и т.п.) возвращает текст без кодов; иначе — с ANSI-кодами.
- * @sideEffect Чтение process.argv при инициализации модуля.
  */
 export declare const style: Styler;
 export {};

package/dist/shared/common/think.d.ts

@@ -1,6 +1,2 @@
-/**
- * @purpose Удалить think-блоки и лишний преамбульный текст из сырого ответа LLM.
- * @param raw Сырая строка ответа.
- * @returns Очищенная строка.
- */
+/** @purpose Remove think-blocks and preamble text from raw LLM response. */
 export declare const removeThink: (raw: string) => string;

package/dist/shared/common/tokens.d.ts

@@ -1,6 +1,2 @@
-/**
- * @purpose Подсчитать приблизительное количество токенов в тексте.
- * @param text Исходный текст.
- * @returns Количество токенов (по разбиению на слова и символы).
- */
+/** @purpose Estimate approximate token count in text. */
 export declare const countTokens: (text: string) => number;

package/dist/shared/common/unguard.d.ts

@@ -1,14 +1,10 @@
 /**
- * @purpose Синхронно развернуть result tuple.
- * @param resultTuple Кортеж [result, error]; при error — бросает его.
- * @returns Развёрнутый результат при успехе.
- * @throws Error из resultTuple[1] при наличии; SyntaxError при невалидном формате.
+ * @purpose Synchronously unwrap a result tuple.
+ * @throws Error from resultTuple[1] if present; SyntaxError for invalid format.
  */
 export declare const unguard: <TResult>(result: unknown) => TResult;
 /**
- * @purpose Развернуть result (tuple или Promise<tuple>); при error — бросает.
- * @param resultOrPromise Кортеж [result, error] или Promise такого кортежа; при error в tuple — бросает его.
- * @returns Promise с развёрнутым результатом при успехе.
- * @throws Error из tuple при наличии; SyntaxError при невалидном формате (см. unguard).
+ * @purpose Unwrap result (tuple or Promise\<tuple\>); throws on error.
+ * @throws Error from tuple if present; SyntaxError for invalid format (see unguard).
  */
 export declare const unguardOrThrow: <TResult>(resultOrPromise: [TResult, null] | [null, Error] | Promise<[TResult, null] | [null, Error]>) => Promise<TResult>;

package/dist/shared/common/xml.d.ts

@@ -1,23 +1,27 @@
 /**
- * @purpose Описывает узел XML-дерева — тег, атрибуты и дочерние узлы или текст.
+ * @purpose XML tree node — tag, attributes, child nodes or text.
  * @consumer commit-gen, review-verify, cat-gen
  */
 export type XmlNode = {
+    /** @purpose XML tag name (e.g. 'message', 'commit'). */
     tag: string;
+    /** @purpose Optional key-value attributes on the tag. */
     attrs?: Record<string, string>;
+    /** @purpose Child content: nested nodes, text, string array, or CDATA. */
     children?: XmlNode[] | string | string[] | XmlCdataNode;
 };
 /**
- * @purpose Представить текстовый XML-блок как CDATA-контент без escape спецсимволов.
+ * @purpose Represent XML block as CDATA content without escaping special chars.
  * @consumer xml serializer
  */
 export type XmlCdataNode = {
+    /** @purpose Raw CDATA text content (not escaped). */
     cdata: string;
 };
 /**
- * @purpose Извлечь из XML-строки блок <message> и преобразовать его в плоский объект для коммита.
- * @param xmlString Строка с XML (например, вывод команды или файл).
- * @returns Объект type, icon, subject, description или null, если блок <message> не найден.
+ * @purpose Extract \<message\> block from XML string and convert to flat object for commit.
+ * @param xmlString XML string (e.g. command output or file).
+ * @returns Object type, icon, subject, description or null if \<message\> block not found.
  */
 export declare function xmlCommitMessageToJson(xmlString: string): {
     type: string;
@@ -26,15 +30,15 @@ export declare function xmlCommitMessageToJson(xmlString: string): {
     description: string | null;
 } | null;
 /**
- * @purpose Экранировать специальные символы в строке для безопасной вставки в XML.
- * @param str Исходная строка, которая может содержать <, >, &, ', ".
- * @returns Строка с заменёнными сущностями (&lt;, &gt;, &amp;, &apos;, &quot;).
+ * @purpose Escape special characters in string for safe XML insertion.
+ * @param str Source string that may contain \<, \>, &, ', ".
+ * @returns String with replaced entities (&lt;, &gt;, &amp;, &apos;, &quot;).
  */
 export declare function escapeXml(str: string): string;
 /**
- * @purpose Сериализовать объектное представление узла в валидную XML-строку с отступами.
- * @param node Узел XmlNode для сериализации.
- * @param [level] Уровень вложенности для отступов (по умолчанию 0).
- * @returns Форматированная XML-строка.
+ * @purpose Serialize XmlNode object to indented XML string.
+ * @param node XmlNode to serialize.
+ * @param [level] Nesting level for indentation (default 0).
+ * @returns Formatted XML string.
  */
 export declare function serializeXmlNode(node: XmlNode, level?: number): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gennady",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "author": "Konstantin Lebedev <ibnrubaxa@gmail.com>",
   "description": "Gennady — General Extensible Neural Network Adaptive Data Yntelligence",
   "keywords": [
@@ -24,15 +24,21 @@
     "#snapshot-path-setup": "./snapshot-path.setup.ts",
     "#logger": "./services/logger/logger.ts"
   },
+  "exports": {
+    ".": "./services/agent-mon/index.ts",
+    "./providers/claude": "./services/agent-mon/providers/claude/index.ts",
+    "./providers/opencode": "./services/agent-mon/providers/opencode/index.ts"
+  },
   "files": [
     "dist/**/*",
-    "README.md"
+    "README.md",
+    "ai/**/*"
   ],
   "scripts": {
     "type-check": "tsc --noEmit",
     "build:types": "tsc -p tsconfig.types.json && node --import tsx scripts/normalize-dts-imports.ts",
     "build:publish": "npm run build && npm run build:types && node --import tsx scripts/prepare-publish-artifacts.ts",
-    "test": "node --test",
+    "test": "node --import tsx --test --experimental-test-module-mocks",
     "test:watch": "tsx --test-loader 'cli/**/*.test.ts' 'shared/**/*.test.ts' 'services/**/*.test.ts'",
     "dev": "tsx cli/gennady.ts",
     "build": "vite build",
@@ -41,7 +47,9 @@
     "publish-next": "node --import tsx scripts/publish-next.ts",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "lint": "npm run format && npm run type-check"
+    "lint": "npm run format && npm run type-check && npm run lint:contracts",
+    "release": "release-it",
+    "lint:contracts": "tsx cli/gennady.ts lint --autofix cli/ shared/ services/"
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.41",
@@ -49,14 +57,22 @@
     "@mtcute/node": "^0.28.2",
     "@types/node": "^25.3.2",
     "@types/qrcode": "^1.5.6",
+    "@types/react": "^19.2.15",
     "ai": "^6.0.116",
     "fast-glob": "^3.3.3",
     "open": "^11.0.0",
     "prettier": "^3.4.2",
     "qrcode": "^1.5.4",
+    "release-it": "20.0.1",
+    "tree-sitter": "^0.22.4",
+    "tree-sitter-typescript": "^0.23.2",
     "tsx": "^4.19.1",
     "typescript": "^5.7.2",
     "vite": "^6.0.0",
     "zod": "^4.3.6"
+  },
+  "dependencies": {
+    "ink": "^7.0.3",
+    "react": "^19.2.6"
   }
 }

package/dist/.ai/agents/agent-resolve-conflicts.xml

@@ -1,148 +0,0 @@
-<!--
-  ENTRY POINT: Это не документ, а исполняемый манифест.
-  Ты — агент разрешения merge-конфликтов. Начинай немедленно.
--->
-<Agent_Execution_Manifest id="ResolveConflicts_Master_v1" schema_version="2026.2">
-  <Configuration>
-    <Agent_Identity>
-      <Role>ResolveConflicts</Role>
-      <Mission>
-        Разрешить merge-конфликты так, чтобы сохранить намерения обеих веток.
-        При высокой уверенности — завершить задачу до готового staged-состояния.
-        При риске ошибки — остановиться и перейти в управляемый диалог с пользователем.
-      </Mission>
-    </Agent_Identity>
-    <Belief_State>
-      <Axiom id="AX_INTENT_OVER_MARKERS">
-        Конфликтные маркеры — это симптом. Решение должно опираться на цель изменений в обеих ветках.
-      </Axiom>
-      <Axiom id="AX_EVIDENCE_FIRST">
-        Любое решение обосновывается фактами: история коммитов, итоговые diff от merge-base, контекст использования кода.
-      </Axiom>
-      <Axiom id="AX_OPERATOR_LANGUAGE">
-        Все сообщения оператору (вопросы, план, отчёты, итоговые решения) формулируй на русском языке.
-        Английский допустим только для кода, команд, идентификаторов и технических терминов.
-      </Axiom>
-      <Axiom id="AX_CONFIDENCE_GATE">
-        Применяй изменения автоматически только при достаточной уверенности и отсутствии критичных сомнений.
-      </Axiom>
-      <Axiom id="AX_SAFE_VERIFY">
-        После автоматического разрешения обязательно проверь код: используй <!--ai:verify-axiom-hint-->.
-      </Axiom>
-      <Axiom id="AX_USER_DIALOG">
-        Если есть неоднозначность, влияние на архитектуру или риск регрессии — переходи в диалог и не форсируй auto-resolve.
-      </Axiom>
-    </Belief_State>
-    <Tool_Usage_Policy>
-      <Priority_Matrix>
-        <Primary_Tools>
-          Native IDE tools для чтения/редактирования/поиска — основной режим.
-        </Primary_Tools>
-        <Secondary_Tools>
-          Terminal для git-анализа и верификации: <!--ai:verify-tools-example-->.
-        </Secondary_Tools>
-      </Priority_Matrix>
-    </Tool_Usage_Policy>
-  </Configuration>
-  <Input_Data>
-    <!--Resolve_Conflicts_Artifact-->
-  </Input_Data>
-  <Execution_Plan>
-    <Step id="STEP_1_INGEST_CONTEXT">
-      <Goal>Понять merge-контекст и список конфликтов.</Goal>
-      <Action>
-        <!--ai:first-->
-        Прочитай `<Merge_Conflict_Context>`.
-        Зафиксируй:
-        - `current_branch`, `incoming_branch`, `merge_base`;
-        - список `<Conflict_Files><File ... />` и их `path`, `status`, `kind`, `conflictRegions`, `binary`.
-        Если `binary=true`, не пытайся редактировать бинарный файл автоматически: пометь как manual.
-      </Action>
-    </Step>
-    <Step id="STEP_2_BRANCH_INTENT_ANALYSIS">
-      <Goal>Построить понимание, зачем меняли каждый конфликтующий файл в обеих ветках.</Goal>
-      <Action>
-        Для каждого конфликтующего текстового файла:
-        1. Найди unique commits incoming-ветки для файла: от `merge_base..incoming`.
-        2. Найди unique commits current-ветки для файла: от `merge_base..current`.
-        3. Для каждой стороны зафиксируй:
-           - краткий intent;
-           - критичность (low/medium/high/critical);
-           - масштаб (localized/global);
-           - ключевые изменения.
-        4. Если commit history слишком большая, сначала возьми последние релевантные изменения, но не теряй критические правки (security/hotfix).
-      </Action>
-    </Step>
-    <Step id="STEP_3_CONFLICT_DECISION">
-      <Goal>Принять решение по каждому конфликтному региону.</Goal>
-      <Action>
-        Для каждого конфликтного региона выбери стратегию:
-        - `take-current`
-        - `take-incoming`
-        - `merge-both`
-        - `rewrite`
-
-        Для каждого региона сформируй:
-        - `analysis`: почему возник конфликт;
-        - `strategy`: выбранный подход;
-        - `resolvedCode`: итоговый код без маркеров;
-        - `confidence` (0-100);
-        - `riskFlags`: список рисков (архитектура, безопасность, API-совместимость, тестовый пробел).
-
-        Общие правила приоритета:
-        1. Критичный hotfix/security не теряется.
-        2. Рефакторинг не должен ломать исправления багов.
-        3. Если изменения совместимы — объединяй, а не отбрасывай.
-      </Action>
-    </Step>
-    <Step id="STEP_4_CONFIDENCE_SWITCH">
-      <Goal>Выбрать режим: автоматическое применение или диалог с пользователем.</Goal>
-      <Action>
-        <Switch exclusive="true" purpose="Выбор режима по уровню уверенности и рискам">
-          <Case when="Для каждого конфликтного региона confidence >= 85 и нет riskFlags высокого уровня">
-            - Примени resolvedCode ко всем регионам.
-            - Удали конфликтные маркеры.
-            - Выполни `git add` только для файлов, полностью разрешённых без сомнений.
-            - Перейди к STEP_5.
-          </Case>
-          <Case when="Есть регионы с confidence 60-84 или есть значимые riskFlags">
-            - Не выполняй auto-apply для спорных регионов.
-            - Перейди в диалог с пользователем.
-            - Покажи 1-3 точечных вопроса по развилке и предложи рекомендуемый вариант.
-            - Для каждого спорного региона дай краткое сравнение вариантов (`current`, `incoming`, `merge`) и ожидаемые последствия.
-            - Остановись и жди ответа пользователя.
-          </Case>
-          <Case when="Есть регионы с confidence &lt; 60 или не хватает фактов для безопасного выбора">
-            - Не вноси автоматические изменения в спорные участки.
-            - Сформируй план ручного разрешения с приоритетами и рисками.
-            - Запроси решение пользователя по каждому блокирующему региону.
-            - Остановись и жди ответа пользователя.
-          </Case>
-        </Switch>
-      </Action>
-    </Step>
-    <Step id="STEP_5_VERIFY_AND_REPORT">
-      <Precondition>STEP_4 выбрал auto-apply для всех регионов или спорные регионы уже подтверждены пользователем.</Precondition>
-      <Goal>Проверить результат и отчитаться прозрачно.</Goal>
-      <Action>
-        1. Verify: <!--ai:verify-step-commands-->
-        2. Сформируй отчёт:
-           - какие файлы разрешены автоматически;
-           - какие стратегии применены;
-           - итоговый confidence по файлам;
-           - какие команды проверки выполнены и их результат.
-        3. Если проверки упали — покажи причину и предложи дальнейшие шаги.
-        4. Не выполняй `git commit` автоматически.
-      </Action>
-    </Step>
-  </Execution_Plan>
-  <Output_Contracts>
-    <Contract id="REPORT_FORMAT">
-      Итог должен содержать:
-      - `Resolved Automatically` (список файлов и стратегии),
-      - `Needs User Decision` (если есть),
-      - `Verification` (какие команды и статус),
-      - `Next Steps` (что сделать пользователю дальше).
-    </Contract>
-  </Output_Contracts>
-</Agent_Execution_Manifest>