gennady 0.6.0 → 0.7.0

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

@@ -0,0 +1,72 @@
+/** @purpose Single lint error in ESLint-compatible format. */
+export type LintError = {
+    /** @purpose Path to the file containing the error */
+    file: string;
+    /** @purpose 1-based line number */
+    line: number;
+    /** @purpose 1-based column number */
+    col: number;
+    /** @purpose Always 'error' for lint violations */
+    severity: 'error';
+    /** @purpose Error code from ERR_CLI_LINT_* or ERR_DBC_LINT_* set */
+    code: string;
+    /** @purpose Human-readable description with corrective action */
+    message: string;
+};
+/** @purpose Configuration for a single lint run. */
+export type LintOptions = {
+    /** @purpose List of .ts file paths to lint */
+    files: string[];
+    /** @purpose Enable autofix for dbc contract checks */
+    autofix: boolean;
+    /** @purpose Git scan mode — collect files from git index */
+    gitMode?: 'staged';
+};
+/** @purpose Aggregated lint result with ESLint-compatible formatting. | @invariant exitCode is 0 when errors is empty, 1 otherwise. */
+export declare class LintReport {
+    /** @purpose Collected lint errors — empty array when clean. */
+    readonly errors: LintError[];
+    /** @purpose Count of errors auto-fixed by DbcContractCheck. */
+    readonly autoFixed: number;
+    /** @purpose Deduplicated task file paths resolved from @tasks annotations in linted files. */
+    readonly taskPaths: string[];
+    /** @purpose Deduplicated spec file paths resolved from task files. */
+    readonly specPaths: string[];
+    /**
+     * @purpose Creates a LintReport with collected errors, autoFixed count, and resolved references.
+     * @param errors Collected lint errors.
+     * @param [autoFixed] Count of auto-fixed errors, defaults to 0.
+     * @param [taskPaths] Resolved task file paths (deduplicated).
+     * @param [specPaths] Resolved spec file paths (deduplicated).
+     */
+    constructor(errors: LintError[], autoFixed?: number, taskPaths?: string[], specPaths?: string[]);
+    /** @purpose Returns 0 when no errors, 1 otherwise — ESLint convention. | @returns 0 for clean, 1 for errors. */
+    get exitCode(): 0 | 1;
+    /**
+     * @purpose Formats errors in ESLint-compatible output with resolved task/spec references.
+     * @returns ESLint-compatible formatted string with References block.
+     */
+    format(): string;
+}
+/** @purpose File is missing the mandatory // @file: directive before the first import. */
+export declare const ERR_CLI_LINT_MISSING_FILE: "ERR_CLI_LINT_MISSING_FILE";
+/** @purpose File is missing the mandatory // @consumers: directive before the first import. */
+export declare const ERR_CLI_LINT_MISSING_CONSUMERS: "ERR_CLI_LINT_MISSING_CONSUMERS";
+/** @purpose A START anchor has no matching END anchor — opening block never closed. */
+export declare const ERR_CLI_LINT_ANCHOR_UNPAIRED_START: "ERR_CLI_LINT_ANCHOR_UNPAIRED_START";
+/** @purpose An END anchor has no matching START anchor — closing block never opened. */
+export declare const ERR_CLI_LINT_ANCHOR_UNPAIRED_END: "ERR_CLI_LINT_ANCHOR_UNPAIRED_END";
+/** @purpose Anchors violate nesting — parent closed before child. */
+export declare const ERR_CLI_LINT_ANCHOR_NESTING: "ERR_CLI_LINT_ANCHOR_NESTING";
+/** @purpose Bare #region/#endregion without START_/END_ prefix — malformed anchor. */
+export declare const ERR_CLI_LINT_ANCHOR_MALFORMED: "ERR_CLI_LINT_ANCHOR_MALFORMED";
+/** @purpose Cyrillic characters found in JSDoc contracts or file headers — English required. */
+export declare const ERR_CLI_LINT_NON_ENGLISH: "ERR_CLI_LINT_NON_ENGLISH";
+/** @purpose Target resolution failed — path does not exist (ENOENT) or permission denied (EACCES). | @invariant Used by resolveTargets for graceful degradation. */
+export declare const ERR_CLI_LINT_RESOLVE_FAILED: "ERR_CLI_LINT_RESOLVE_FAILED";
+/** @purpose Mutually exclusive flags: --staged and positional targets cannot be used together. */
+export declare const ERR_CLI_LINT_STAGED_CONFLICT: "ERR_CLI_LINT_STAGED_CONFLICT";
+/** @purpose TypeScript / linter disable comment without a Decision Log reference (D-NNN) in the same line. | @invariant Implements policy D-007 (cli.spec.md): every @ts-ignore / @ts-nocheck / @ts-expect-error / eslint-disable* must cite D-NNN in the same comment. */
+export declare const ERR_CLI_LINT_UNAUTHORIZED_DISABLE: "ERR_CLI_LINT_UNAUTHORIZED_DISABLE";
+/** @purpose TypeScript / linter disable comment has a D-NNN reference but lacks a purpose explanation. | @invariant Implements D-007 contract tightening (TSK-52): >= 8 non-whitespace characters of purpose must remain after stripping the comment opener, the marker, and the D-NNN token. */
+export declare const ERR_CLI_LINT_DISABLE_MISSING_PURPOSE: "ERR_CLI_LINT_DISABLE_MISSING_PURPOSE";

package/dist/cli/cmd/lint/utils/resolve-references.fn.d.ts

@@ -0,0 +1,32 @@
+/** @purpose Resolved reference pair: task file path and its linked spec paths. */
+export type ResolvedReference = {
+    /** @purpose Relative path to the task file from project root */
+    taskPath: string;
+    /** @purpose Relative paths to spec files referenced by the task */
+    specPaths: string[];
+};
+/**
+ * @purpose Scan all task .md files in tasks/ directory and build a map of taskId -> ResolvedReference.
+ * Walks the directory tree recursively, parses each task file for Task-ID and Spec References.
+ * @param projectRoot Absolute path to the project root (where tasks/ lives).
+ * @param [taskDir] Relative path to the tasks directory (default: 'tasks').
+ * @returns Map from task ID string (e.g. 'TSK-21') to its ResolvedReference.
+ */
+export declare function loadTaskReferences(projectRoot: string, taskDir?: string): Map<string, ResolvedReference>;
+/**
+ * @purpose Extract task IDs from a file's @tasks annotation in the header.
+ * Parses lines like: `// @tasks: TSK-12, TSK-15`
+ * @param content File content to parse.
+ * @returns Array of task ID strings (e.g. ['TSK-12', 'TSK-15']), empty if no @tasks found.
+ */
+export declare function extractTaskIdsFromHeader(content: string): string[];
+/**
+ * @purpose Resolve references for a set of task IDs into deduplicated task and spec path lists.
+ * @param taskIds Array of task ID strings.
+ * @param taskRefMap Pre-loaded task reference map from loadTaskReferences().
+ * @returns Object with deduplicated, sorted arrays of taskPaths and specPaths.
+ */
+export declare function resolveReferencesForTasks(taskIds: string[], taskRefMap: Map<string, ResolvedReference>): {
+    taskPaths: string[];
+    specPaths: string[];
+};

package/dist/cli/cmd/remote-console/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/cmd/remote-console/remote-console.cmd.d.ts

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { startRemoteConsoleServer } from '../../../services/remote-console/remote-console.js';
+/** @purpose Defines parsed CLI arguments for remote-console command execution. */
+export type RemoteConsoleCommandArgs = {
+    /** @purpose Overrides default server port when provided by operator. */
+    port?: number;
+    /** @purpose Overrides default loopback bind host for server startup. */
+    host?: string;
+    /** @purpose Provides optional page URL to open with remote-console activation flag. */
+    url?: string;
+};
+/** @purpose Describes injectable dependencies for command testing and runtime orchestration. */
+export type RemoteConsoleCommandDeps = {
+    /** @purpose Starts remote-console server runtime and returns lifecycle handle. */
+    startServer: typeof startRemoteConsoleServer;
+    /**
+     * @purpose Opens target URL in default browser process.
+     * @param targetUrl Absolute browser URL provided by CLI user.
+     * @returns Promise resolving after the browser opens.
+     */
+    openBrowser: (targetUrl: string) => Promise<unknown>;
+    /**
+     * @purpose Emits informational command diagnostics for operator feedback.
+     * @param args Format arguments passed to console.info.
+     */
+    info: (...args: unknown[]) => void;
+    /**
+     * @purpose Emits degraded-path diagnostics when optional browser opening fails.
+     * @param args Format arguments passed to console.warn.
+     */
+    warn: (...args: unknown[]) => void;
+};
+/**
+ * @purpose Runs remote-console CLI command, starts server and optionally opens a browser URL with activation flag.
+ * @param argv Process argv or compatible command argument list.
+ * @param [deps] Optional dependency overrides for deterministic tests.
+ * @returns void — process stays alive while server runs.
+ * @sideEffect Network: starts HTTP server runtime for remote console envelopes.
+ * @sideEffect Process: writes startup diagnostics to stdout.
+ * @sideEffect OS: opens default browser when --url is passed.
+ */
+export declare function runRemoteConsoleCommand(argv: string[], deps?: RemoteConsoleCommandDeps): Promise<void>;
+/**
+ * @purpose Parses command arguments for remote-console startup options.
+ * @param argv Raw process argument vector.
+ * @returns Normalized command arguments with optional port, host and url values.
+ */
+export declare function parseRemoteConsoleCommandArgs(argv: string[]): RemoteConsoleCommandArgs;
+/**
+ * @purpose Adds deterministic activation query flag without dropping existing query params or hash fragment.
+ * @param targetUrl Absolute browser URL provided by CLI user.
+ * @throws {Error} When URL cannot be parsed as absolute URL.
+ * @returns Mutated URL with `__remote_console__=1` query parameter.
+ */
+export declare function composeRemoteConsoleActivationUrl(targetUrl: string): string;

package/dist/cli/cmd/resolve-conflicts/_core/io/resolve-conflicts-template-load.io.d.ts

@@ -1,6 +1,6 @@
 /**
- * @purpose Загрузить шаблон resolve-conflicts из проекта или fallback из библиотеки.
+ * @purpose Load resolve-conflicts template from the project or fallback from the library.
+ * @returns XML template content.
  * @consumer resolve-conflicts-render.xml
- * @returns Содержимое XML-шаблона.
  */
 export declare function loadResolveConflictsTemplate(): Promise<string>;

package/dist/cli/cmd/resolve-conflicts/_core/logic/resolve-conflicts-command-args-parse.logic.d.ts

@@ -1,8 +1,8 @@
 import type { ResolveConflictsCommandArgs } from '../types/resolve-conflicts-command-args.type.js';
 /**
- * @purpose Нормализовать CLI-аргументы resolve-conflicts в единый контракт.
- * @consumer resolve-conflicts.cmd
- * @param argv Массив process.argv.
+ * @purpose Normalize resolve-conflicts CLI arguments into a single contract.
+ * @param argv process.argv array.
  * @returns ResolveConflictsCommandArgs.
+ * @consumer resolve-conflicts.cmd
  */
 export declare function parseResolveConflictsCommandArgs(argv: string[]): ResolveConflictsCommandArgs;

package/dist/cli/cmd/resolve-conflicts/_core/logic/resolve-conflicts-command-run.logic.d.ts

@@ -1,9 +1,9 @@
 import type { ResolveConflictsCommandArgs } from '../types/resolve-conflicts-command-args.type.js';
 import type { ResolveConflictsCommandResult } from '../types/resolve-conflicts-command-result.type.js';
 /**
- * @purpose Выполнить pipeline resolve-conflicts и вернуть финальный prompt.
+ * @purpose Execute resolve-conflicts pipeline and return the final prompt.
+ * @param args Normalized launch arguments.
+ * @returns Exit code and ready output.
  * @consumer resolve-conflicts.cmd
- * @param args Нормализованные аргументы запуска.
- * @returns Код выполнения и готовый output.
  */
 export declare function runResolveConflictsCommand(args: ResolveConflictsCommandArgs): Promise<ResolveConflictsCommandResult>;

package/dist/cli/cmd/resolve-conflicts/_core/logic/resolve-conflicts-context-git-build.logic.d.ts

@@ -1,10 +1,10 @@
 import type { ResolveConflictsCommandArgs } from '../types/resolve-conflicts-command-args.type.js';
 import type { ResolveConflictsContextGit } from '../types/resolve-conflicts-context-git.type.js';
 /**
- * @purpose Собрать merge-контекст из git для генерации prompt resolve-conflicts.
- * @consumer resolve-conflicts-command-run.logic
- * @param args Аргументы запуска команды.
- * @throws {Error} Когда текущая директория не git-репозиторий, нет активного merge или нет конфликтов.
+ * @purpose Build merge context from git for resolve-conflicts prompt generation.
+ * @param args Command launch arguments.
+ * @throws {Error} When the current directory is not a git repository, no active merge, or no conflicts.
  * @returns ResolveConflictsContextGit.
+ * @consumer resolve-conflicts-command-run.logic
  */
 export declare function buildResolveConflictsContextGit(args: ResolveConflictsCommandArgs): ResolveConflictsContextGit;

package/dist/cli/cmd/resolve-conflicts/_core/types/resolve-conflicts-artifact.type.d.ts

@@ -1,9 +1,11 @@
 import type { ResolveConflictsContextGit } from './resolve-conflicts-context-git.type.js';
 /**
- * @purpose Базовый артефакт команды resolve-conflicts: git-контекст и XML.
+ * @purpose Base artifact of the resolve-conflicts command: git context and XML.
  * @consumer resolve-conflicts-command-run.logic
  */
 export type ResolveConflictsArtifact = {
+    /** @purpose Git context for resolve-conflicts prompt generation. */
     resolveConflictsContextGit: ResolveConflictsContextGit;
+    /** @purpose XML artifact generated from the resolve-conflicts pipeline. */
     resolveConflictsArtifactXml: string;
 };

package/dist/cli/cmd/resolve-conflicts/_core/types/resolve-conflicts-command-args.type.d.ts

@@ -1,8 +1,10 @@
 /**
- * @purpose Нормализованные аргументы запуска resolve-conflicts.
+ * @purpose Normalized launch arguments for resolve-conflicts.
  * @consumer resolve-conflicts-command-args-parse.logic
  */
 export type ResolveConflictsCommandArgs = {
+    /** @purpose Target branch name for the merge resolution. */
     branch?: string;
+    /** @purpose Incoming branch name to merge into the target. */
     incoming?: string;
 };

package/dist/cli/cmd/resolve-conflicts/_core/types/resolve-conflicts-command-result.type.d.ts

@@ -1,11 +1,15 @@
 import type { ResolveConflictsArtifact } from './resolve-conflicts-artifact.type.js';
 /**
- * @purpose Результат выполнения resolve-conflicts.
+ * @purpose Resolve-conflicts execution result.
  * @consumer resolve-conflicts.cmd
  */
 export type ResolveConflictsCommandResult = {
+    /** @purpose Whether the command completed successfully. */
     ok: boolean;
+    /** @purpose Process exit code (0 = success). */
     code: number;
+    /** @purpose Optional text output produced by the command. */
     output?: string;
+    /** @purpose Optional structured artifact from the resolve-conflicts pipeline. */
     artifact?: ResolveConflictsArtifact;
 };

package/dist/cli/cmd/resolve-conflicts/_core/types/resolve-conflicts-context-git.type.d.ts

@@ -1,29 +1,45 @@
 import type { GitRemoteInfo } from '../../../../../shared/backend/git/git-core.js';
 /**
- * @purpose Описать один конфликтующий файл в merge-контексте.
+ * @purpose Describe a single conflicting file in the merge context.
  * @consumer resolve-conflicts-context-git-build.logic, resolve-conflicts-artifact-build.xml
  */
 export type ResolveConflictsContextFile = {
+    /** @purpose File path relative to repository root. */
     path: string;
+    /** @purpose Git file status (e.g. "modified", "both modified"). */
     status: string;
+    /** @purpose Kind of conflict (e.g. "content", "rename"). */
     kind: string;
+    /** @purpose Whether the file exists on disk. */
     exists: boolean;
+    /** @purpose Whether the file is binary. */
     binary: boolean;
+    /** @purpose Number of conflict marker regions in the file. */
     conflictRegions: number;
 };
 /**
- * @purpose Собрать git-контекст для генерации prompt resolve-conflicts.
+ * @purpose Build git context for resolve-conflicts prompt generation.
  * @consumer resolve-conflicts-command-run.logic
  */
 export type ResolveConflictsContextGit = {
+    /** @purpose Current branch name. */
     currentBranch: string;
+    /** @purpose Incoming branch name to merge. */
     incomingBranch: string;
+    /** @purpose HEAD SHA of the current branch. */
     currentHead: string;
+    /** @purpose HEAD SHA of the incoming branch. */
     incomingHead: string;
+    /** @purpose Merge base commit SHA. */
     mergeBase: string;
+    /** @purpose Merge commit message. */
     mergeMessage: string;
+    /** @purpose Number of commits unique to the current branch. */
     currentOnlyCommits: number;
+    /** @purpose Number of commits unique to the incoming branch. */
     incomingOnlyCommits: number;
+    /** @purpose Remote repository info (null if no remote configured). */
     remote: GitRemoteInfo | null;
+    /** @purpose List of conflicting files in the merge context. */
     conflictFiles: ResolveConflictsContextFile[];
 };

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

@@ -1,16 +1,16 @@
 import type { XmlNode } from '../../../../../shared/common/xml.js';
 import type { ResolveConflictsContextGit } from '../types/resolve-conflicts-context-git.type.js';
 /**
- * @purpose Собрать дерево XmlNode артефакта resolve-conflicts из git-контекста merge.
+ * @purpose Build the resolve-conflicts artifact XmlNode tree from merge git context.
+ * @param resolveConflictsContextGit Merge context and conflicting files.
+ * @returns Root XmlNode (tag: Merge_Conflict_Context).
  * @consumer resolve-conflicts-artifact-build.xml
- * @param resolveConflictsContextGit Контекст merge и конфликтующих файлов.
- * @returns Корневой XmlNode (tag: Merge_Conflict_Context).
  */
 export declare function createResolveConflictsArtifactXmlNode(resolveConflictsContextGit: ResolveConflictsContextGit): XmlNode;
 /**
- * @purpose Построить XML-артефакт для resolve-conflicts.
+ * @purpose Build the XML artifact for resolve-conflicts.
+ * @param resolveConflictsContextGit Git merge context.
+ * @returns XML string (Merge_Conflict_Context).
  * @consumer resolve-conflicts-command-run.logic
- * @param resolveConflictsContextGit Git-контекст merge.
- * @returns Строка XML (Merge_Conflict_Context).
  */
 export declare function buildResolveConflictsArtifactXml(resolveConflictsContextGit: ResolveConflictsContextGit): string;

package/dist/cli/cmd/resolve-conflicts/_core/xml/resolve-conflicts-render.xml.d.ts

@@ -1,8 +1,8 @@
 /**
- * @purpose Сформировать итоговый XML для resolve-conflicts (template + артефакт + project placeholders).
+ * @purpose Build the final XML for resolve-conflicts (template + artifact + project placeholders).
+ * @param resolveConflictsArtifactXml Merge conflicts XML artifact.
+ * @param [projectRoot] Repository root for searching knowledge and verify commands.
+ * @returns Full XML prompt for resolve-conflicts.
  * @consumer resolve-conflicts-command-run.logic
- * @param resolveConflictsArtifactXml XML-артефакт merge conflicts.
- * @param projectRoot Корень репозитория для поиска знаний и verify-команд.
- * @returns Полный XML-промпт для resolve-conflicts.
  */
 export declare function renderResolveConflictsXml(resolveConflictsArtifactXml: string, projectRoot?: string): Promise<string>;

package/dist/cli/cmd/review/_core/io/load-review-verify-template.io.d.ts

@@ -1,6 +1,6 @@
 /**
- * @purpose Загрузить шаблон review-verify из проекта или fallback из библиотеки.
+ * @purpose Load review-verify template from the project or fallback from the library.
+ * @returns XML template content.
  * @consumer render-review-verify.xml
- * @returns Содержимое XML-шаблона.
  */
 export declare function loadReviewVerifyTemplate(): Promise<string>;

package/dist/cli/cmd/review/_core/logic/build-review-context-git.logic.d.ts

@@ -1,8 +1,8 @@
 import type { ReviewContextGit } from '../types/review-context-git.type.js';
 /**
- * @purpose Собрать git-контекст review-запуска (branch + origin remote).
- * @consumer run-review-command.logic
- * @param [branchOverride] Явно заданная ветка из CLI.
+ * @purpose Build git context for review launch (branch + origin remote).
+ * @param [branchOverride] Explicitly specified branch from CLI.
  * @returns ReviewContextGit.
+ * @consumer run-review-command.logic
  */
 export declare function buildReviewContextGit(branchOverride?: string): ReviewContextGit;

package/dist/cli/cmd/review/_core/logic/build-review-context-vcs.logic.d.ts

@@ -1,9 +1,9 @@
 import type { ReviewContextVcs } from '../types/review-context-vcs.type.js';
 /**
- * @purpose Собрать VCS-контекст и клиент GitLab API.
- * @consumer run-review-command.logic
+ * @purpose Build VCS context and GitLab API client.
  * @param host GitLab host.
  * @param project GitLab project path/id.
  * @returns ReviewContextVcs.
+ * @consumer run-review-command.logic
  */
 export declare function buildReviewContextVcs(host: string, project: string): ReviewContextVcs;

package/dist/cli/cmd/review/_core/logic/load-review-context-mr.logic.d.ts

@@ -4,12 +4,12 @@ import type { ReviewContextVcs } from '../types/review-context-vcs.type.js';
 import type { ReviewIntent } from '../types/review-intent.type.js';
 import type { ReviewContextGit } from '../types/review-context-git.type.js';
 /**
- * @purpose Загрузить MR и discussions по ReviewIntent.
+ * @purpose Load MR and discussions by ReviewIntent.
+ * @param reviewIntent Review command launch intent.
+ * @param reviewContextVcs VCS context with GitLab client.
+ * @param [reviewContextGit] Git context (needed for branch fallback).
+ * @returns MR and list of discussions or null if MR not found.
  * @consumer run-review-command.logic
- * @param reviewIntent Намерение запуска review-команды.
- * @param reviewContextVcs VCS-контекст с клиентом GitLab.
- * @param [reviewContextGit] Git-контекст (нужен для branch fallback).
- * @returns MR и список discussions или null, если MR не найден.
  */
 export declare function loadReviewContextMr(reviewIntent: ReviewIntent, reviewContextVcs: ReviewContextVcs, reviewContextGit?: ReviewContextGit): Promise<{
     mergeRequest: ReviewContextMr;

package/dist/cli/cmd/review/_core/logic/parse-review-command-args.logic.d.ts

@@ -1,8 +1,8 @@
 import type { ReviewCommandArgs } from '../types/review-command-args.type.js';
 /**
- * @purpose Нормализовать CLI-аргументы review-команд в единый контракт.
- * @consumer review-verify.cmd, review-issues.cmd
- * @param argv Массив process.argv.
+ * @purpose Normalize review command CLI arguments into a single contract.
+ * @param argv process.argv array.
  * @returns ReviewCommandArgs.
+ * @consumer review-verify.cmd, review-issues.cmd
  */
 export declare function parseReviewCommandArgs(argv: string[]): ReviewCommandArgs;

package/dist/cli/cmd/review/_core/logic/resolve-review-intent.logic.d.ts

@@ -1,9 +1,9 @@
 import type { ReviewCommandArgs } from '../types/review-command-args.type.js';
 import type { ReviewIntent } from '../types/review-intent.type.js';
 /**
- * @purpose Разрешить намерение review-запуска из аргументов (url/ref/project+iid/branch).
+ * @purpose Resolve review launch intent from arguments (url/ref/project+iid/branch).
+ * @param args Normalized review command arguments.
+ * @returns ReviewIntent with priority url > ref > project+iid > branch fallback.
  * @consumer run-review-command.logic
- * @param args Нормализованные аргументы review-команды.
- * @returns ReviewIntent с приоритетом url > ref > project+iid > branch fallback.
  */
 export declare function resolveReviewIntent(args: ReviewCommandArgs): ReviewIntent;

package/dist/cli/cmd/review/_core/logic/run-review-command.logic.d.ts

@@ -1,9 +1,9 @@
 import type { ReviewCommandOptions } from '../types/review-command-options.type.js';
 import type { ReviewCommandResult } from '../types/review-command-result.type.js';
 /**
- * @purpose Выполнить общий pipeline review-команд и вернуть финальный output.
+ * @purpose Execute common review command pipeline and return the final output.
+ * @param options Command mode and launch arguments.
+ * @returns Exit code and ready output.
  * @consumer review-verify.cmd, review-issues.cmd
- * @param options Режим команды и аргументы запуска.
- * @returns Код выполнения и готовый output.
  */
 export declare function runReviewCommand(options: ReviewCommandOptions): Promise<ReviewCommandResult>;

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

@@ -1,11 +1,14 @@
 import type { ReviewContextMr } from './review-context-mr.type.js';
 import type { ReviewContextMrDiscussion } from './review-context-mr.type.js';
 /**
- * @purpose Базовый артефакт review-команд: MR + discussions + XML.
+ * @purpose Base artifact of review commands: MR + discussions + XML.
  * @consumer run-review-command.logic
  */
 export type ReviewArtifact = {
+    /** @purpose MR context used for review artifact generation. */
     mergeRequest: ReviewContextMr;
+    /** @purpose Discussions on the MR. */
     discussions: ReviewContextMrDiscussion[];
+    /** @purpose XML artifact generated from the review pipeline. */
     reviewArtifactXml: string;
 };

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

@@ -1,12 +1,18 @@
 /**
- * @purpose Нормализованные аргументы запуска review-команд.
+ * @purpose Normalized launch arguments for review commands.
  * @consumer review-verify.cmd, review-issues.cmd
  */
 export type ReviewCommandArgs = {
+    /** @purpose Branch name for the review. */
     branch?: string;
+    /** @purpose MR URL for VCS-based review. */
     url?: string;
+    /** @purpose Git ref to review. */
     ref?: string;
+    /** @purpose VCS project path (owner/repo). */
     project?: string;
+    /** @purpose MR IID for GitLab-based review. */
     iid?: string;
+    /** @purpose Review all MRs (for review-verify --all). */
     all?: boolean;
 };

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

@@ -1,5 +1,5 @@
 /**
- * @purpose Режим вывода review-команды.
+ * @purpose Review command output mode.
  * @consumer review cmd _core
  */
 export type ReviewCommandMode = 'verify' | 'issues';

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

@@ -1,10 +1,12 @@
 import type { ReviewCommandArgs } from './review-command-args.type.js';
 import type { ReviewCommandMode } from './review-command-mode.type.js';
 /**
- * @purpose Опции запуска review pipeline.
+ * @purpose Review pipeline launch options.
  * @consumer run-review-command.logic
  */
 export type ReviewCommandOptions = {
+    /** @purpose Review command mode (verify or issues). */
     mode: ReviewCommandMode;
+    /** @purpose Normalized launch arguments for the review command. */
     args: ReviewCommandArgs;
 };

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

@@ -1,11 +1,15 @@
 import type { ReviewArtifact } from './review-artifact.type.js';
 /**
- * @purpose Результат выполнения review-команды.
+ * @purpose Review command execution result.
  * @consumer review-verify.cmd, review-issues.cmd
  */
 export type ReviewCommandResult = {
+    /** @purpose Whether the command completed successfully. */
     ok: boolean;
+    /** @purpose Process exit code (0 = success). */
     code: number;
+    /** @purpose Optional text output produced by the command. */
     output?: string;
+    /** @purpose Optional structured artifact from the review pipeline. */
     artifact?: ReviewArtifact;
 };

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

@@ -1,9 +1,11 @@
 import type { GitRemoteInfo } from '../../../../../shared/backend/git/git-core.js';
 /**
- * @purpose Git-контекст для review-команд.
+ * @purpose Git context for review commands.
  * @consumer build-review-context-git.logic
  */
 export type ReviewContextGit = {
+    /** @purpose Current branch name for the review. */
     branch: string;
+    /** @purpose Remote repository info extracted from git config. */
     remote: GitRemoteInfo;
 };

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

@@ -1,28 +1,39 @@
 /**
- * @purpose Минимальный MR-контекст для генерации review-артефакта.
+ * @purpose Minimal MR context for review artifact generation.
  * @consumer load-review-context-mr.logic
  */
 export type ReviewContextMr = {
+    /** @purpose GitLab MR internal ID. */
     iid: number;
+    /** @purpose GitLab project ID. */
     project_id?: number;
+    /** @purpose Source branch of the MR. */
     source_branch?: string;
+    /** @purpose MR title. */
     title?: string;
+    /** @purpose Web URL of the MR. */
     web_url?: string;
+    /** @purpose Author info of the MR. */
     author?: {
         username?: string;
     };
 };
 /**
- * @purpose Тип заметки GitLab discussion, используемый в XML-артефакте.
+ * @purpose GitLab discussion note type used in the XML artifact.
  * @consumer build-review-artifact.xml
  */
 export type ReviewContextMrNote = {
+    /** @purpose Note ID. */
     id?: number;
+    /** @purpose Note body text. */
     body?: string;
+    /** @purpose Note author info. */
     author?: {
         username?: string;
     };
+    /** @purpose Whether this is a system-generated note. */
     system?: boolean;
+    /** @purpose Diff position the note applies to. */
     position?: {
         new_path?: string;
         old_path?: string;
@@ -30,21 +41,29 @@ export type ReviewContextMrNote = {
         old_line?: number;
         head_sha?: string;
     };
+    /** @purpose Whether the note is resolvable. */
     resolvable?: boolean;
+    /** @purpose Whether the note is resolved. */
     resolved?: boolean;
+    /** @purpose Who resolved the note. */
     resolved_by?: {
         username?: string;
     } | null;
 };
 /**
- * @purpose Тип discussion GitLab, используемый в XML-артефакте.
+ * @purpose GitLab discussion type used in the XML artifact.
  * @consumer build-review-artifact.xml
  */
 export type ReviewContextMrDiscussion = {
+    /** @purpose Discussion ID. */
     id: string;
+    /** @purpose Notes in this discussion thread. */
     notes?: ReviewContextMrNote[];
+    /** @purpose Whether the discussion is resolvable. */
     resolvable?: boolean;
+    /** @purpose Whether the discussion is resolved. */
     resolved?: boolean;
+    /** @purpose Who resolved the discussion. */
     resolved_by?: {
         username?: string;
     } | null;

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

@@ -1,10 +1,13 @@
 import type { VcsGitlabClient } from '../../../../../services/vcs-client/gitlab/vcs-gitlab-client.js';
 /**
- * @purpose VCS-контекст для запросов к GitLab API.
+ * @purpose VCS context for GitLab API requests.
  * @consumer build-review-context-vcs.logic
  */
 export type ReviewContextVcs = {
+    /** @purpose GitLab host (e.g. "gitlab.example.com"). */
     host: string;
+    /** @purpose GitLab project path (owner/repo). */
     project: string;
+    /** @purpose Initialized VCS client for GitLab API requests. */
     vcs: VcsGitlabClient;
 };