gennady 0.6.0 → 0.7.0

package/dist/cli/cmd/review/_core/types/review-intent.type.d.ts

@@ -1,5 +1,5 @@
 /**
- * @purpose Исходное намерение review-запроса: явный MR или поиск по ветке.
+ * @purpose Initial review request intent: explicit MR or branch search.
  * @consumer resolve-review-intent.logic
  */
 export type ReviewIntent = {

package/dist/cli/cmd/review/_core/xml/build-review-artifact.xml.d.ts

@@ -1,20 +1,20 @@
 import type { XmlNode } from '../../../../../shared/common/xml.js';
 import type { ReviewContextMr, ReviewContextMrDiscussion } from '../types/review-context-mr.type.js';
 /**
- * @purpose Собрать дерево XmlNode артефакта ревью из MR и дискуссий.
+ * @purpose Build XmlNode tree of the review artifact from MR and discussions.
+ * @param mergeRequest MR object (iid, author, web_url, source_branch, title, etc.).
+ * @param discussions Array of discussions with notes (body, author, position).
+ * @param [showAll] Flag to show all threads, including resolved ones.
+ * @returns Root XmlNode (tag: MR_Audit_Context).
  * @consumer buildReviewArtifactXml
- * @param mergeRequest Объект MR (iid, author, web_url, source_branch, title и т.д.).
- * @param discussions Массив дискуссий с notes (body, author, position).
- * @param showAll Флаг показа всех тредов, включая resolved.
- * @returns Корневой XmlNode (tag: MR_Audit_Context).
  */
 export declare function createReviewArtifactXmlNode(mergeRequest: ReviewContextMr, discussions: ReviewContextMrDiscussion[], showAll?: boolean): XmlNode;
 /**
- * @purpose Построить XML артефакт ревью (MR + дискуссии).
+ * @purpose Build review XML artifact (MR + discussions).
+ * @param mergeRequest MR object.
+ * @param discussions Array of discussions.
+ * @param [showAll] Flag to show all threads, including resolved ones.
+ * @returns XML string (MR_Audit_Context).
  * @consumer run-review-command.logic
- * @param mergeRequest Объект MR.
- * @param discussions Массив дискуссий.
- * @param showAll Флаг показа всех тредов, включая resolved.
- * @returns Строка XML (MR_Audit_Context).
  */
 export declare function buildReviewArtifactXml(mergeRequest: ReviewContextMr, discussions: ReviewContextMrDiscussion[], showAll?: boolean): string;

package/dist/cli/cmd/review/_core/xml/render-review-issues.xml.d.ts

@@ -1,7 +1,7 @@
 /**
- * @purpose Сформировать итоговый XML для review-issues (только артефакт).
+ * @purpose Build the final XML for review-issues (artifact only).
+ * @param reviewArtifactXml Review XML artifact.
+ * @returns XML artifact without template.
  * @consumer run-review-command.logic
- * @param reviewArtifactXml XML-артефакт ревью.
- * @returns XML-артефакт без шаблона.
  */
 export declare function renderReviewIssuesXml(reviewArtifactXml: string): string;

package/dist/cli/cmd/review/_core/xml/render-review-verify.xml.d.ts

@@ -1,8 +1,8 @@
 /**
- * @purpose Сформировать итоговый XML для review-verify (template + артефакт + подстановки по проекту).
+ * @purpose Build the final XML for review-verify (template + artifact + project substitutions).
+ * @param reviewArtifactXml Review XML artifact.
+ * @param [projectRoot] Repository root for searching knowledge files and command detectors (default `process.cwd()`).
+ * @returns Full XML prompt for review-verify.
  * @consumer run-review-command.logic
- * @param reviewArtifactXml XML-артефакт ревью.
- * @param projectRoot Корень репозитория для поиска файлов знаний и детекторов команд (по умолчанию `process.cwd()`).
- * @returns Полный XML-промпт для review-verify.
  */
 export declare function renderReviewVerifyXml(reviewArtifactXml: string, projectRoot?: string): Promise<string>;

package/dist/cli/cmd/sync/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/cmd/sync/sync-core.d.ts

@@ -0,0 +1,65 @@
+import { SyncResult } from './sync.types.js';
+import type { SyncOptions } from './sync.types.js';
+/** @purpose Entries excluded from sync: empty architecture dir, deprecated/domain-specific directives. @invariant Must be kept in sync with cli spec §3.4 exclusion list. */
+export declare const EXCLUDED_ENTRIES: Set<string>;
+/** @purpose DI port for SyncCore — abstracts filesystem access for testability. @invariant All deps must be provided; no optional fields. */
+export interface SyncCoreDeps {
+    /**
+     * @purpose Read file from disk.
+     * @param path File path.
+     * @returns File contents as Buffer.
+     */
+    readFile: (path: string) => Buffer;
+    /**
+     * @purpose Write file to disk.
+     * @param path File path.
+     * @param data File contents.
+     */
+    writeFile: (path: string, data: Buffer) => void;
+    /**
+     * @purpose Create directory.
+     * @param path Directory path.
+     * @param [opts] Options.
+     */
+    mkdir: (path: string, opts?: {
+        recursive: boolean;
+    }) => void;
+    /**
+     * @purpose Get file stats.
+     * @param path File path.
+     * @returns Stats object.
+     */
+    stat: (path: string) => {
+        isDirectory(): boolean;
+        isFile(): boolean;
+    };
+    /**
+     * @purpose List directory contents.
+     * @param path Directory path.
+     * @returns File names.
+     */
+    readdir: (path: string) => string[];
+    /** @purpose Current working directory. */
+    cwd: string;
+}
+/**
+ * @purpose Find the ai/directives/ directory in the installed gennady npm package.
+ * @param cwd Current working directory.
+ * @returns Absolute path to ai/directives/ or null if the package is not found.
+ */
+export declare function resolvePackageDir(cwd: string): string | null;
+/**
+ * @purpose Recursively collect a list of files in sourceDir with filter and exclusion support.
+ * @param sourceDir Source directory to scan.
+ * @param [subdirs] Optional list of subdirectories to scan.
+ * @throws If subdir does not exist in sourceDir.
+ * @returns List of relative file paths.
+ */
+export declare function scanDirectives(sourceDir: string, subdirs?: string[]): string[];
+/**
+ * @purpose Main entry point: compare source and target, return SyncResult.
+ * @param deps Injectable filesystem dependencies.
+ * @param opts Sync options (package, target, dryRun, verbose).
+ * @returns Sync result with file entries and summary counts.
+ */
+export declare function collectAndCompare(deps: SyncCoreDeps, opts: SyncOptions): SyncResult;

package/dist/cli/cmd/sync/sync-formatter.d.ts

@@ -0,0 +1,12 @@
+import type { SyncFileEntry } from './sync.types.js';
+interface FormatOpts {
+    dryRun?: boolean;
+}
+/**
+ * @purpose Format a list of sync file entries into stdout lines.
+ * @param entries List of sync file entries to format.
+ * @param [opts] Formatting options (dryRun enables would-add/would-update labels).
+ * @returns Array of formatted lines, last line is the summary.
+ */
+export declare function formatEntries(entries: SyncFileEntry[], opts?: FormatOpts): string[];
+export {};

package/dist/cli/cmd/sync/sync.cmd.d.ts

@@ -0,0 +1,33 @@
+import { readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from 'node:fs';
+import { resolvePackageDir } from './sync-core.js';
+/** @purpose Injectable dependencies for the sync CLI command — enables testing without real FS. */
+export type SyncCmdDeps = {
+    /** @purpose Read file from disk. */
+    readFile?: typeof readFileSync;
+    /** @purpose Write file to disk. */
+    writeFile?: typeof writeFileSync;
+    /** @purpose Create directory. */
+    mkdir?: typeof mkdirSync;
+    /** @purpose Get file stats. */
+    stat?: typeof statSync;
+    /** @purpose List directory contents. */
+    readdir?: typeof readdirSync;
+    /** @purpose Resolve package directory. */
+    resolvePackageDir?: typeof resolvePackageDir;
+    /** @purpose Standard output stream. */
+    stdout?: NodeJS.WriteStream;
+    /** @purpose Standard error stream. */
+    stderr?: NodeJS.WriteStream;
+};
+/**
+ * @purpose CLI entry point for the sync command.
+ * *
+ * Parses CLI arguments, resolves the package source directory,
+ * compares source with target, and outputs the result.
+ * *
+ * @param rawArgs Raw CLI arguments (typically process.argv).
+ * @param [deps] Optional injectable dependencies for testing.
+ * @throws {Error} On package not found or invalid subdirectory.
+ * @returns Exit code (0 success, 1 error).
+ */
+export declare function run(rawArgs: string[], deps?: SyncCmdDeps): number;

package/dist/cli/cmd/sync/sync.types.d.ts

@@ -0,0 +1,50 @@
+/** @purpose Discriminated status of a synced file: new, changed, or identical. */
+export type SyncFileStatus = 'added' | 'updated' | 'unchanged';
+/** @purpose Options for the sync command. */
+export interface SyncOptions {
+    /** @purpose Absolute path to ai/directives/ in the npm package. */
+    sourceDir: string;
+    /** @purpose Absolute path to <cwd>/ai/directives/. */
+    targetDir: string;
+    /** @purpose Optional filter: subdirectory names inside ai/directives/. */
+    subdirs?: string[];
+    /** @purpose Preview without writing. */
+    dryRun?: boolean;
+}
+/** @purpose A single file entry in the sync result. */
+export interface SyncFileEntry {
+    /** @purpose Path relative to ai/directives/ (e.g., sdd/discovery.directive.xml). */
+    relativePath: string;
+    /** @purpose Sync status: added, updated, or unchanged. */
+    status: SyncFileStatus;
+    /** @purpose Size of the source file in bytes. */
+    sourceSize?: number;
+    /** @purpose Size of the target file in bytes. */
+    targetSize?: number;
+}
+/** @purpose Aggregated result of a sync operation with computed summaries. */
+export declare class SyncResult {
+    /** @purpose List of all synced file entries. */
+    readonly entries: SyncFileEntry[];
+    /**
+     * @purpose Construct a SyncResult from a list of entries.
+     * @param entries File entries.
+     */
+    constructor(entries: SyncFileEntry[]);
+    /** @purpose Files with status "added". | @returns Array of added entries. */
+    get added(): SyncFileEntry[];
+    /** @purpose Files with status "updated". | @returns Array of updated entries. */
+    get updated(): SyncFileEntry[];
+    /** @purpose Files with status "unchanged". | @returns Array of unchanged entries. */
+    get unchanged(): SyncFileEntry[];
+    /** @purpose Human-readable summary of added/updated/unchanged counts. | @returns Summary string. */
+    get summary(): string;
+    /** @purpose Dry-run summary message. | @returns Dry-run message. */
+    get dryRunSummary(): string;
+}
+/** @purpose Error code: subdirectory not found in source. */
+export declare const ERR_SYNC_SUBDIR_NOT_FOUND = "ERR_SYNC_SUBDIR_NOT_FOUND";
+/** @purpose Error code: package not found in node_modules. */
+export declare const ERR_SYNC_PKG_NOT_FOUND = "ERR_SYNC_PKG_NOT_FOUND";
+/** @purpose Error code: source directory not found. */
+export declare const ERR_SYNC_SOURCE_NOT_FOUND = "ERR_SYNC_SOURCE_NOT_FOUND";

package/dist/cli/cmd/vcs-reply/vcs-reply.cmd.d.ts

@@ -18,11 +18,11 @@ type MainOpts = {
     vcs?: VcsGitlabClient;
 };
 /**
- * @purpose Отправить ответы в дискуссии GitLab MR: читает JSON-массив из stdin или opts, постит notes.
+ * @purpose Post replies to GitLab MR discussions: reads JSON array from stdin or opts, posts notes.
+ * @param [opts] project, iid, dryRun, stdinJsonArray, token, remote, baseUrl, vcs (for tests).
+ * @returns Object { ok, sent, failed, code }; code 0 on ok, otherwise 1.
+ * @sideEffect Network: POST to GitLab Discussions API; Console: status and error output.
  * @consumer CLI (cmd/vcs-reply)
- * @param [opts] project, iid, dryRun, stdinJsonArray, token, remote, baseUrl, vcs (для тестов).
- * @returns Объект { ok, sent, failed, code }; code 0 при ok, иначе 1.
- * @sideEffect Network: POST в GitLab Discussions API; Console: вывод статуса и ошибок.
  */
 export declare function main(opts?: MainOpts): Promise<{
     ok: boolean;

package/dist/cli/utils/ai-legacy/ai-legacy-agent.d.ts

@@ -1,23 +1,24 @@
 import { AiLegacyModel } from './ai-legacy-model.js';
 /**
- * @purpose Legacy AI Agent — обёртка над AiLegacyModel для получения структурированного JSON-ответа.
- * @consumer cmd/agent, тесты
- * @invariant brain должен быть экземпляром AiLegacyModel; иначе конструктор бросает.
+ * @purpose Legacy AI Agent — wrapper over AiLegacyModel for receiving structured JSON responses.
+ * @invariant brain must be an instance of AiLegacyModel; otherwise the constructor throws.
+ * @consumer cmd/agent, tests
  */
 export declare class AiLegacyAgent {
+    /** @purpose AI model instance for making generation requests. */
     protected _brain: AiLegacyModel;
     /**
-     * @purpose Создать агента с заданной моделью.
-     * @param brain Экземпляр AiLegacyModel для запросов.
-     * @throws Error если brain не instanceof AiLegacyModel.
+     * @purpose Create an agent with the given model.
+     * @param brain Instance of AiLegacyModel for requests.
+     * @throws Error if brain is not instanceof AiLegacyModel.
      */
     constructor(brain: AiLegacyModel);
     /**
-     * @purpose Отправить промпт и распарсить ответ как JSON (с обрезкой markdown-блоков кода).
-     * @param prompt Текст запроса (непустая строка).
-     * @returns Кортеж [parsed object, null] или [null, Error] при пустом промпте/ошибке парсинга.
-     * @throws Error при пустом или не-строковом prompt (до запроса).
-     * @sideEffect Network: вызов this._brain.generate.
+     * @purpose Send a prompt and parse the response as JSON (with stripping of markdown code blocks).
+     * @param prompt Prompt text (non-empty string).
+     * @throws Error on empty or non-string prompt (before the request).
+     * @returns Tuple [parsed object, null] or [null, Error] on empty prompt/parsing error.
+     * @sideEffect Network: call this._brain.generate.
      */
     getJson(prompt: string): Promise<[object, null] | [null, Error]>;
 }

package/dist/cli/utils/ai-legacy/ai-legacy-core.d.ts

@@ -7,30 +7,46 @@ type AiLegacyCoreInit = {
 };
 type ParsedDiffFile = import('../../../shared/backend/git/git-diff.ts').ParsedDiffFile;
 /**
- * @purpose Ядро выбора модели и батчинга промптов по diff; объединяет GennadyRc и AiLegacyModel.
+ * @purpose Core for model selection and prompt batching by diff; combines GennadyRc and AiLegacyModel.
+ * @invariant Models loaded from .gennadyrc (cwd, HOME); if absent — getDefault().
  * @consumer CommitGen, ReviewGen
- * @invariant Модели загружаются из .gennadyrc (cwd, HOME); при отсутствии — getDefault().
- * @deprecated Используй прямую работу с AiLegacyModel и GennadyRc.
+ * @deprecated Use direct work with AiLegacyModel and GennadyRc.
  */
 export declare class AiLegacyCore {
+    /** @purpose Loaded AI model list from gennadyrc. */
     protected _models: AiLegacyModel[];
+    /** @purpose Currently active model that passed ping check. */
     protected _activeModel: AiLegacyModel | null;
+    /** @purpose Configuration and dependencies for the core. */
     protected init: AiLegacyCoreInit & {
         logger: typeof logger;
         timeout: number;
         maxInputTokens: number;
     };
+    /**
+     * @purpose Initialize AiLegacyCore with loaded models from gennadyrc.
+     * @param [init] Configuration (logger, timeout, maxInputTokens).
+     */
     constructor(init?: AiLegacyCoreInit);
-    /** @purpose Имя первой загруженной модели (для отображения в CLI). */
+    /**
+     * @purpose Name of the first loaded model (for CLI display).
+     * @returns Model name string or undefined.
+     */
     get model(): string | undefined;
-    /** @purpose URL первой загруженной модели. */
+    /**
+     * @purpose URL of the first loaded model.
+     * @returns API URL string or undefined.
+     */
     get apiUrl(): string | undefined;
-    /** @purpose Лимит токенов на один батч при разбиении diff. */
+    /**
+     * @purpose Token limit per batch when splitting diff.
+     * @returns Max input tokens count.
+     */
     get maxInputTokens(): number;
     /**
-     * @purpose Разбить разобранный diff на батчи по maxInputTokens для последовательных запросов к LLM.
-     * @param parseDiff Массив ParsedDiffFile (обычно parsedCodeDiff из getGitDiffInfo).
-     * @returns Массив батчей { tokens, diff, languages }.
+     * @purpose Split parsed diff into batches by maxInputTokens for sequential LLM requests.
+     * @param parseDiff Array of ParsedDiffFile (usually parsedCodeDiff from getGitDiffInfo).
+     * @returns Array of batches { tokens, diff, languages }.
      */
     createPromptsBatchesByDiff(parseDiff: ParsedDiffFile[]): {
         tokens: number;
@@ -38,19 +54,19 @@ export declare class AiLegacyCore {
         languages: string[];
     }[];
     /**
-     * @purpose Вызвать первую доступную модель (ping) и сгенерировать ответ по промпту.
-     * @param prompt Текст запроса.
-     * @param [systemPrompt] Опциональный system-промпт.
-     * @returns Текст ответа модели или пустая строка при ошибке.
-     * @sideEffect Network: ping затем generate; Logs: error/warn при сбое модели.
+     * @purpose Call the first available model (ping) and generate a response from the prompt.
+     * @param prompt Prompt text.
+     * @param [systemPrompt] Optional system prompt.
+     * @returns Model response text or empty string on error.
+     * @sideEffect Network: ping then generate; Logs: error/warn on model failure.
      */
     generate(prompt: string, systemPrompt?: {
         system?: string;
     }): Promise<string>;
     /**
-     * @purpose Выбрать первую модель, успешно ответившую на ping; кэширует в _activeModel.
-     * @returns Кортеж [модель, null] или [null, Error], если ни одна модель не доступна.
-     * @sideEffect Network: ping по каждой модели до первого успеха.
+     * @purpose Select the first model that successfully responded to ping; caches in _activeModel.
+     * @returns Tuple [model, null] or [null, Error] if no model is available.
+     * @sideEffect Network: ping each model until first success.
      */
     protected _choiceModel(): Promise<[AiLegacyModel, null] | [null, Error]>;
 }

package/dist/cli/utils/ai-legacy/ai-legacy-model.d.ts

@@ -1,47 +1,66 @@
 /**
- * @purpose Конфигурация инициализации AI Legacy Model: имя, URL, опциональный ключ и доп. параметры.
+ * @purpose AI Legacy Model initialization config: name, URL, optional key and additional parameters.
  * @consumer AiLegacyModel, AiLegacyCore, GennadyRc
  */
 export type AiLegacyModelInit = {
+    /** @purpose Model name identifier (e.g. "llama3.1:8b"). */
     model: string;
+    /** @purpose API endpoint URL for generation requests. */
     url: string;
+    /** @purpose Optional API key for authorization. */
     key?: string;
+    /** @purpose Extra parameters merged into the request body. */
     extra?: Record<string, unknown>;
 };
 /**
- * @purpose Legacy AI Model (LLM) — единая точка запросов к API генерации (Ollama/OpenAI-совместимые).
+ * @purpose Legacy AI Model (LLM) — single point for API generation requests (Ollama/OpenAI-compatible).
+ * @invariant Error Policy: network/timeout errors are returned as [null, Error]; does not throw.
+ * @invariant Retry Policy: no built-in retries; responsibility on the caller.
  * @consumer AiLegacyCore, cmd/agent
- * @invariant Error Policy: ошибки сети/таймаута возвращаются как [null, Error]; не бросает.
- * @invariant Retry Policy: нет встроенных ретраев; ответственность на вызывающей стороне.
  */
 export declare class AiLegacyModel {
     /**
-     * @purpose Создать экземпляр с дефолтными настройками (Ollama local).
-     * @returns Экземпляр с model=llama3.1:8b, url=localhost:11434.
+     * @purpose Create an instance with default settings (Ollama local).
+     * @returns Instance with model=llama3.1:8b, url=localhost:11434.
      */
     static getDefault(): AiLegacyModel;
+    /** @purpose Model initialization config with name, URL, and key. */
     protected _init: AiLegacyModelInit;
+    /** @purpose Cached ping promise to avoid duplicate pings. */
     protected _pingPromise: Promise<[boolean, null] | [null, Error]> | null;
+    /**
+     * @purpose Create an AI model instance with the given configuration.
+     * @param init Partial initialization config (model, url, key, extra).
+     */
     constructor(init: Partial<AiLegacyModelInit>);
-    /** @purpose Имя модели (для логов и заголовков). */
+    /**
+     * @purpose Model name (for logs and headers).
+     * @returns Model name string.
+     */
     get name(): string;
-    /** @purpose URL эндпоинта API. */
+    /**
+     * @purpose API endpoint URL.
+     * @returns API URL string.
+     */
     get url(): string;
-    /** @purpose API-ключ (если требуется авторизация). */
+    /**
+     * @purpose API key (if authorization is required).
+     * @returns API key string or undefined.
+     */
     get key(): string | undefined;
     /**
-     * @purpose Проверить доступность модели коротким запросом.
-     * @param [timeout] Таймаут в мс (по умолчанию 10e3).
-     * @returns Кортеж [true, null] при успехе, [null, Error] при сбое.
-     * @sideEffect Network: один запрос к API; Logs: debug/error.
+     * @purpose Check model availability with a short request.
+     * @param [timeout] Timeout in ms (default 10e3).
+     * @returns Tuple [true, null] on success, [null, Error] on failure.
+     * @sideEffect Network: single request to API; Logs: debug/error.
      */
     ping(timeout?: number): Promise<[boolean, null] | [null, Error]>;
     /**
-     * @purpose Отправить промпт в LLM и получить ответ (с подстановкой __KEY__ и удалением think-блоков).
-     * @param prompt Текст запроса пользователя.
-     * @param [init] system, temperature, timeout, replacements для подстановки в промпт/system.
-     * @returns Кортеж [текст ответа, null] при успехе, [null, Error] при ошибке сети/парсинга.
-     * @sideEffect Network: POST к this.url.
+     * @purpose Send a prompt to the LLM and get a response (with __KEY__ substitution and think-block removal).
+     * @param prompt User prompt text.
+     * @param [init] system, temperature, timeout, replacements for substitution in prompt/system.
+     * @returns Tuple [response text, null] on success, [null, Error] on network/parsing error.
+     * @sideEffect Network: POST to this.url.
      */
     generate(prompt: string, init?: {
         system?: string;
@@ -50,11 +69,11 @@ export declare class AiLegacyModel {
         replacements?: Record<string, string>;
     }): Promise<[string, null] | [null, Error]>;
     /**
-     * @purpose Выполнить POST-запрос к API и вернуть JSON или ошибку.
-     * @param params Тело запроса (Ollama- или OpenAI-формат).
-     * @param [timeout] Таймаут в мс.
-     * @returns Кортеж [parsed JSON, null] или [null, Error].
-     * @sideEffect Network: fetch с AbortController.
+     * @purpose Execute a POST request to the API and return JSON or an error.
+     * @param params Request body (Ollama or OpenAI format).
+     * @param [timeout] Timeout in ms.
+     * @returns Tuple [parsed JSON, null] or [null, Error].
+     * @sideEffect Network: fetch with AbortController.
      */
     protected _fetchAsJson(params: unknown, timeout?: number): Promise<[unknown, null] | [null, Error]>;
 }

package/dist/cli/utils/cat-gen/cat-gen.d.ts

@@ -1,32 +1,43 @@
+import type { VcsMergeRequestChanges } from '../../../services/vcs-client/entities/vcs-merge-request-changes.type.js';
+import type { VcsFileContent } from '../../../services/vcs-client/entities/vcs-file-content.type.js';
 /**
- * @purpose Список расширений файлов по умолчанию для сбора контента (cat).
+ * @purpose Default file extension list for content collection (cat).
  * @consumer catGen
  */
 export declare const DEFAULT_EXTENSIONS: string[];
 /**
- * @purpose Опции сбора файлов: расширения, исключения, отключение дефолтных исключений.
+ * @purpose File collection options: extensions, exclusions, disabling default exclusions.
  * @consumer catGen
  */
 export type CatGenOptions = {
+    /** @purpose File extensions to include (e.g. ['.ts', '.md']). */
     extensions?: string[];
+    /** @purpose Patterns or paths to exclude from collection. */
     exclude?: string | string[];
+    /** @purpose When true, skip default node_modules exclusion. */
     ignoreDefaultExcludes?: boolean;
 };
 /**
- * @purpose Один результат catGen: абсолютный путь, относительный путь, содержимое файла.
+ * @purpose Single catGen result: absolute path, relative path, file contents.
  * @consumer catGen, cmd/cat
  */
 export type CatGenResult = {
+    /** @purpose Absolute path of the collected file. */
     absPath: string;
+    /** @purpose Path relative to the working directory. */
     relativePath: string;
+    /** @purpose File contents as a UTF-8 string. */
     contents: string;
 };
 /**
- * @purpose Получить содержимое всех файлов по указанным glob-паттернам для вывода в XML/MD.
+ * @purpose Get contents of all files by specified glob patterns for output in XML/MD.
+ * @sideEffect Filesystem: traversal and reading of files.
  * @consumer CLI (cmd/cat)
- * @param paths Путь к файлу/директории или glob-паттерн(ы); директория раскрывается в **\/*.
- * @param options Опции: extensions, exclude, ignoreDefaultExcludes (node_modules по умолчанию исключён).
- * @returns Массив объектов { absPath, relativePath, contents }; файлы с ошибкой чтения пропускаются.
- * @sideEffect Filesystem: обход и чтение файлов.
  */
 export declare const catGen: (paths: string | string[], options?: CatGenOptions) => CatGenResult[];
+/**
+ * @purpose Pure function for converting VCS changes and contents into CatGenResult[].
+ *         Filters deleted files and binary (encoding: base64).
+ * @consumer cli/cmd/cat/cat-url.fn.ts
+ */
+export declare const catGenFromVcs: (changes: VcsMergeRequestChanges[], files: VcsFileContent[]) => CatGenResult[];

package/dist/cli/utils/commit-gen/commit-gen.d.ts

@@ -9,11 +9,12 @@ type CommitGenInit = {
     [key: string]: unknown;
 };
 /**
- * @purpose Генерировать commit-сообщение из staged diff через LLM.
+ * @purpose Generate commit message from staged diff via LLM.
+ * @invariant Uses AiLegacyCore and getGitDiffInfo; returns undefined if diff is empty.
  * @consumer CLI (cmd/commit)
- * @invariant Использует AiLegacyCore и getGitDiffInfo; при пустом diff возвращает undefined.
  */
 export declare class CommitGen {
+    /** @purpose Configuration with defaults for mode, prompts, timeout. */
     protected init: CommitGenInit & {
         mode: string;
         oneline: boolean;
@@ -24,31 +25,54 @@ export declare class CommitGen {
         promptCommitChangeset: string;
         timeout: number;
     };
+    /** @purpose AI core instance for LLM requests. */
     protected ai: AiLegacyCore;
+    /**
+     * @purpose Initialize CommitGen with configuration and AI core.
+     * @param [init] Configuration overrides (mode, oneline, targetBranch, task, timeout).
+     */
     constructor(init?: CommitGenInit);
-    /** @purpose Получить экземпляр логгера, используемый при генерации. */
+    /**
+     * @purpose Get the logger instance used during generation.
+     * @returns Logger instance.
+     */
     get logger(): typeof logger;
-    /** @purpose Режим вывода коммита: auto | oneline | detailed. */
+    /**
+     * @purpose Commit output mode: auto | oneline | detailed.
+     * @returns Mode string.
+     */
     get mode(): string;
-    /** @purpose Имя активной AI-модели (из первого доступного rc). */
+    /**
+     * @purpose Active AI model name (from the first available rc).
+     * @returns Model name string or undefined.
+     */
     get model(): string | undefined;
-    /** @purpose URL API активной модели. */
+    /**
+     * @purpose Active model API URL.
+     * @returns API URL string or undefined.
+     */
     get apiUrl(): string | undefined;
-    /** @purpose Ветка, относительно которой строится diff (если задана). */
+    /**
+     * @purpose Branch against which the diff is built (if specified).
+     * @returns Target branch name or undefined.
+     */
     get targetBranch(): string | undefined;
-    /** @purpose Идентификатор задачи для подстановки в subject (опционально). */
+    /**
+     * @purpose Task identifier for substitution in subject (optional).
+     * @returns Task ID string or number, or undefined.
+     */
     get task(): string | number | undefined;
     /**
-     * @purpose Вызвать LLM с одним промптом без think-блоков (для тестов или кастомного ввода).
-     * @param input Текст промпта.
-     * @returns Ответ модели как строка.
-     * @sideEffect Network: запрос к AI API.
+     * @purpose Call LLM with a single prompt without think blocks (for tests or custom input).
+     * @param input Prompt text.
+     * @returns Model response as string.
+     * @sideEffect Network: request to AI API.
      */
     fetchPrompt(input: string): Promise<string>;
     /**
-     * @purpose Сгенерировать commit-сообщение по staged diff (batches → changeset → message).
-     * @returns Строка сообщения (oneline или с description) или undefined при пустом diff/ошибке.
-     * @sideEffect Network: запросы к AI; Logs: info/warn/debug.
+     * @purpose Generate commit message from staged diff (batches → changeset → message).
+     * @returns Message string (oneline or with description) or undefined on empty diff/error.
+     * @sideEffect Network: requests to AI; Logs: info/warn/debug.
      */
     generate(): Promise<string | undefined>;
 }