gennady 0.6.0 → 0.7.0

package/dist/services/dbc/linter/implementations/ts/dbc-ts-linter.d.ts

@@ -0,0 +1,152 @@
+import type { DbcParser, DbcEntrySchema } from '../../../parser/dbc-parser.types.js';
+import type { DbcAstAdapter, DbcExportedEntity, DbcSignatureInfo } from '../../dbc-ast-adapter.types.js';
+import type { DbcLinter, DbcLintReport, DbcLintFixReport, DbcLintError, DbcLintOptions } from '../../dbc-linter.types.js';
+/**
+ * @purpose Pure-function validator that compares parsed contract entries against | a code signature and returns structural mismatches.
+ * @invariant Never throws. Unknown `kind` returns an empty error array.
+ * @invariant Errors are returned in stable order: PARAM_MISSING → PARAM_EXTRA → | PARAM_ORDER → RETURNS_MISSING → RETURNS_UNEXPECTED → TYPE_REDUNDANT.
+ * @param entries Parsed contract entries from `DbcParser.parse()`.
+ * @param signature Signature information extracted from AST.
+ * @param kind Entity or member kind — drives the validation matrix (FR-24).
+ * @returns Array of lint errors (empty when contract matches signature).
+ */
+export declare function validate(entries: DbcEntrySchema[], signature: DbcSignatureInfo, kind: string): DbcLintError[];
+/**
+ * @purpose TypeScript adapter implementing the DbcLinter contract. | Pass 1: AST extraction. Pass 2: contract validation + signature matching. | Pass 3: ESLint report. Pass 4: autofix chain.
+ * @implements {DbcLinter} in ../../dbc-linter.types.ts
+ * @invariant Never throws — all errors are returned via report objects.
+ * @invariant Error order is stable (top-to-bottom by entity position).
+ */
+export declare class DbcTsLinter implements DbcLinter {
+    /** @purpose DBC parser for parsing contract text */
+    protected _parser: DbcParser;
+    /** @purpose AST adapter for parsing TypeScript source files */
+    protected _astAdapter: DbcAstAdapter;
+    /**
+     * @purpose Construct a linter with injected parser and AST adapter.
+     * @param parser DbcParser instance for contract parsing.
+     * @param astAdapter DbcAstAdapter instance for source file parsing.
+     */
+    constructor(parser: DbcParser, astAdapter: DbcAstAdapter);
+    /**
+     * @param filePath Path to the source file to check.
+     * @param [options] Optional lint configuration.
+     * @returns Full lint report with errors and a formatting function.
+     * @see {DbcLinter#lint} in ../../dbc-linter.types.ts
+     */
+    lint(filePath: string, options?: DbcLintOptions): Promise<DbcLintReport>;
+    /**
+     * @param filePath Path to the source file to check.
+     * @param [options] Optional lint configuration.
+     * @returns Combined report with errors and count of auto-fixed issues.
+     * @see {DbcLinter#lintAndFix} in ../../dbc-linter.types.ts
+     */
+    lintAndFix(filePath: string, options?: DbcLintOptions): Promise<DbcLintFixReport>;
+    /**
+     * @purpose Walk all exported entities and their members, collecting lint errors.
+     * @param entities Exported entities from AST parse result.
+     * @param filePath Source file path for error attribution.
+     * @returns Array of lint errors collected from entities and members.
+     */
+    protected _lintEntities(entities: DbcExportedEntity[], filePath: string): DbcLintError[];
+    /**
+     * @purpose Parse a contract text and validate it, returning both parser issues
+     * (translated per FR-23) and structural mismatches via DbcContractMatchValidator.
+     * @param contractText Raw JSDoc contract text to parse and validate.
+     * @param signature Signature info from AST for parameter/returns matching.
+     * @param kind Entity or member kind for validation matrix lookup.
+     * @param filePath Source file path for error attribution.
+     * @param startLine Contract start line in source for error position.
+     * @param startCol Contract start column in source for error position.
+     * @returns Array of lint errors from parser issues and structural mismatches.
+     */
+    protected _validateContract(contractText: string, signature: DbcSignatureInfo, kind: string, filePath: string, startLine: number, startCol: number): DbcLintError[];
+    /** @purpose Internal record of a contract block with context for autofix. */
+    protected _ContractBlock: {
+        new (text: string, kind: string, signature: DbcSignatureInfo): {
+            text: string;
+            kind: string;
+            signature: DbcSignatureInfo;
+        };
+    };
+    /**
+     * @purpose Walk entities and members, collecting all JSDoc contract blocks
+     * with their associated kind and signature for autofix processing.
+     * @param entities Exported entities from AST parse result.
+     * @returns Array of contract blocks with kind and signature context.
+     */
+    protected _collectContracts(entities: DbcExportedEntity[]): InstanceType<typeof this._ContractBlock>[];
+    /**
+     * @purpose Expand single-line pipe contracts to multi-line for callable kinds or >3 tags.
+     * @param jsdocText Raw JSDoc comment text.
+     * @param [kind] Entity kind — callable kinds or pipe with >3 tags are expanded.
+     * @returns JSDoc text in multi-line format if applicable.
+     */
+    protected _expandToMultiline(jsdocText: string, kind?: string): string;
+    /**
+     * @purpose Remove redundant `{dataType}` annotations from @param and @returns tags.
+     * @param jsdocText Raw JSDoc comment text.
+     * @returns JSDoc text with types stripped.
+     */
+    protected _removeRedundantTypes(jsdocText: string): string;
+    /**
+     * @purpose Adjust @param specifiers to wrap optional params in `[brackets]` and remove brackets from required params.
+     * @param jsdocText Raw JSDoc comment text.
+     * @param signature Signature with optionality flags.
+     * @returns JSDoc text with normalized brackets.
+     */
+    protected _normalizeParamBrackets(jsdocText: string, signature: DbcSignatureInfo): string;
+    /**
+     * @purpose Remove @param entries whose specifier does not match any signature parameter. | Handles both multi-line and single-line contracts.
+     * @param jsdocText Raw JSDoc comment text.
+     * @param signature Signature to match against.
+     * @returns JSDoc text with extra params removed.
+     */
+    protected _removeExtraParams(jsdocText: string, signature: DbcSignatureInfo): string;
+    /**
+     * @purpose Remove @returns tag when the kind does not allow it or return type is void.
+     * @param jsdocText Raw JSDoc comment text.
+     * @param kind Entity or member kind.
+     * @param [signature] Optional signature info to check void return type.
+     * @returns JSDoc text with unexpected @returns removed.
+     */
+    protected _removeUnexpectedReturns(jsdocText: string, kind: string, signature?: DbcSignatureInfo): string;
+    /**
+     * @purpose Reorder @param entries to match the signature parameter order.
+     * @param jsdocText Raw JSDoc comment text.
+     * @param signature Signature with desired parameter order.
+     * @returns JSDoc text with params reordered.
+     */
+    protected _reorderParams(jsdocText: string, signature: DbcSignatureInfo): string;
+    /**
+     * @purpose Reorder contract tags to canonical DBC order. | Order: description → purpose → implements → invariant → pre → param(*) → | throws → returns → post → sideEffect → other tags.
+     * @param jsdocText Raw JSDoc comment text.
+     * @returns JSDoc text with tags in canonical order.
+     */
+    protected _reorderTags(jsdocText: string): string;
+    /**
+     * @purpose Normalize multi-line JSDoc format: ensure closing marker is on its own line | and opening marker is bare (no content after it). | Preserves original indentation by patching specific format issues | rather than reconstructing the entire block.
+     * @invariant Single-line contracts pass through unchanged.
+     * @param jsdocText Raw JSDoc comment text.
+     * @returns Normalized JSDoc text.
+     */
+    protected _normalizeMultiLine(jsdocText: string): string;
+    /**
+     * @purpose Detect the indentation pattern used by content lines. | Returns the whitespace prefix before `*` on the first content line, | or the indent of the opening line as fallback.
+     * @param lines All lines of the JSDoc block (may be mutated by Step 1).
+     * @returns Indent string for `*`-prefixed content lines.
+     */
+    protected _detectContentIndent(lines: string[]): string;
+    /**
+     * @purpose Attempt to convert a multi-line JSDoc comment to single-line format. | Inlines only single-tag contracts (1 @tag); multi-tag contracts stay multi-line. | Performs a dry-run through the parser: if the inline version introduces new | parse errors, the original multi-line text is returned unchanged.
+     * @param jsdocText Raw JSDoc comment text.
+     * @returns Inline text if safe, otherwise the original text.
+     */
+    protected _inlineIfSafe(jsdocText: string): string;
+    /**
+     * @purpose Extract the specifier (parameter name) from a @param tag line. | Example: `@param userId Description` → `userId`
+     * @param line Trimmed line content starting with `@param`.
+     * @returns The specifier or empty string.
+     */
+    protected _extractParamSpecifier(line: string): string;
+}

package/dist/services/dbc/parser/dbc-parser.types.d.ts

@@ -1,16 +1,19 @@
+/** @purpose Signal whether contract was authored in a single compressed line or multi-line block. */
+export type DbcSchemaFormat = 'single-line' | 'multi-line';
 /**
  * @purpose Defines the universal contract schema and parser interface for DBC parsers.
- * @consumer DbcParserImplementations
  * @invariant Any implementation must return an entries array for every parse invocation.
  */
 export type DbcSchema = {
     /** @purpose Parsed contract entries normalized into the universal shape. */
     entries: DbcEntrySchema[];
+    /** @purpose Format of the original input contract */
+    format: DbcSchemaFormat;
 };
 /**
  * @purpose Represents a single parsed contract tag or inferred description block.
- * @consumer DbcSchema
  * @invariant Every entry always contains an `issues` array, even when it is empty.
+ * @consumer DbcSchema
  */
 export type DbcEntrySchema = {
     /** @purpose Tag type without leading at-sign, for example `param` or `returns`. */
@@ -25,6 +28,8 @@ export type DbcEntrySchema = {
     value: string;
     /** @purpose Validation issues related to this entry. */
     issues: DbcDbcEntryIssue[];
+    /** @purpose Inline child tags extracted from pipe-delimited single-line contracts */
+    inline?: DbcEntrySchema[];
 };
 /**
  * @purpose Represents a single validation issue bound to an issue code and optional source line.
@@ -36,30 +41,25 @@ export type DbcDbcEntryIssue = {
     /** @purpose One-based line number in the input contract where the issue was detected. */
     line?: number;
 };
-/**
- * @purpose Signals a forbidden combination: `@purpose` and `@see` are used together.
- */
+/** @purpose Signals a forbidden combination: `@purpose` and `@see` are used together. */
 export declare const ERR_DBC_PURPOSE_CONFLICT = "ERR_DBC_PURPOSE_CONFLICT";
-/**
- * @purpose Signals that contract tags violate the required ordering.
- */
+/** @purpose Signals that contract tags violate the required ordering. */
 export declare const ERR_DBC_ORDER = "ERR_DBC_ORDER";
-/**
- * @purpose Signals that a `@param` tag misses its specifier.
- */
+/** @purpose Signals that a `@param` tag misses its specifier. */
 export declare const ERR_DBC_PARAM_NAME_MISSING = "ERR_DBC_PARAM_NAME_MISSING";
-/**
- * @purpose Signals that a `@see` tag misses a valid `{specifier}` payload.
- */
+/** @purpose Signals that a `@see` tag misses a valid `{specifier}` payload. */
 export declare const ERR_DBC_SEE_FORMAT_INVALID = "ERR_DBC_SEE_FORMAT_INVALID";
 /** @purpose Union of all supported parser issue codes. */
 export type DbcIssueCode = typeof ERR_DBC_PURPOSE_CONFLICT | typeof ERR_DBC_ORDER | typeof ERR_DBC_PARAM_NAME_MISSING | typeof ERR_DBC_SEE_FORMAT_INVALID;
 /**
  * @purpose Defines the universal parser contract for textual Design by Contract blocks.
  * @consumer Any parser implementation in `services/dbc/parser/implementations/*`
- * @param inputContract Raw contract text in plain or JSDoc-like syntax.
- * @returns Parsed entries with entry-local validation diagnostics in the universal schema.
  */
 export interface DbcParser {
+    /**
+     * @purpose Parse a raw contract text block into a universal DBC schema with entries and issues.
+     * @param inputContract Raw JSDoc-like contract text block to parse.
+     * @returns Parsed schema containing normalized entries and format info.
+     */
     parse(inputContract: string): DbcSchema;
 }

package/dist/services/dbc/parser/implementations/jsdoc/dbc-jsdoc-parser.d.ts

@@ -4,11 +4,13 @@ type ParsedEntryWithLine = DbcEntrySchema & {
 };
 /**
  * @purpose Parses JSDoc-like contract blocks into a universal DBC schema and validates contract rules.
- * @consumer DbcParserRuntime
+ * @implements {DbcParser} in ../../dbc-parser.types.ts
  * @invariant Input is handled line-by-line with explicit support for leading `*` markers.
  */
 export declare class DbcJsDocParser implements DbcParser {
     /**
+     * @param inputContract Raw contract text to parse.
+     * @returns Parsed DBC schema with entries and format metadata.
      * @see {DbcParser#parse} in ../../dbc-parser.types.ts
      */
     parse(inputContract: string): DbcSchema;
@@ -45,10 +47,18 @@ export declare class DbcJsDocParser implements DbcParser {
      * @purpose Parses `@see` into required `{specifier}` and optional trailing value.
      * @param type Tag type.
      * @param tail Content after `@see`.
-     * @param line One-based source line number.
+     * @param line Source line number.
      * @returns Parsed entry.
      */
     protected parseSeeTag(type: string, tail: string, line: number): ParsedEntryWithLine;
+    /**
+     * @purpose Parses `@implements` into required `{ContractName}` and optional trailing value.
+     * @param type Tag type.
+     * @param tail Content after `@implements`.
+     * @param line One-based source line number.
+     * @returns Parsed entry.
+     */
+    protected parseImplementsTag(type: string, tail: string, line: number): ParsedEntryWithLine;
     /**
      * @purpose Emits a conflict issue when `purpose` and `see` are both present in the parsed entries.
      * @param entries Parsed entries with source lines.
@@ -65,8 +75,8 @@ export declare class DbcJsDocParser implements DbcParser {
      */
     protected validateParamSpecifier(entries: ParsedEntryWithLine[]): void;
     /**
-     * @purpose Emits invalid-see-format issues for `@see` entries without a non-empty specifier.
-     * @param entries Parsed entries with source lines.
+     * @purpose Emits invalid-see-format issues for `@see` entries.
+     * @param entries Parsed entries to validate.
      */
     protected validateSeeSpecifier(entries: ParsedEntryWithLine[]): void;
     /**

package/dist/services/logger/logger.d.ts

@@ -1,16 +1,36 @@
 /** @purpose Project-wide logger contract with a stable debug/info/warn/error API. */
 export type SimpleLogger = {
-    /** @purpose Emits a debug-level message for development diagnostics. */
+    /**
+     * @purpose Emits a debug-level message for development diagnostics.
+     * @param message Log message with Trace-Prefix and state transition.
+     * @param [detail] Optional structured payload.
+     */
     debug: (message: string, detail?: unknown) => void;
-    /** @purpose Emits an info-level message for normal operational events. */
+    /**
+     * @purpose Emits an info-level message for normal operational events.
+     * @param message Log message with Trace-Prefix and state transition.
+     * @param [detail] Optional structured payload.
+     */
     info: (message: string, detail?: unknown) => void;
-    /** @purpose Emits a warning-level message for non-fatal issues. */
+    /**
+     * @purpose Emits a warning-level message for non-fatal issues.
+     * @param message Log message with Trace-Prefix and state transition.
+     * @param [detail] Optional structured payload.
+     */
     warn: (message: string, detail?: unknown) => void;
-    /** @purpose Emits an error-level message for failures requiring investigation. */
+    /**
+     * @purpose Emits an error-level message for failures requiring investigation.
+     * @param message Log message with Trace-Prefix and state transition.
+     * @param [detail] Optional structured payload.
+     */
     error: (message: string, detail?: unknown) => void;
 };
+/** @purpose Ordered log levels — lower index = more verbose. */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/** @purpose Set the minimum log level for the global logger instance. */
+export declare const setLogLevel: (level: LogLevel) => void;
 /**
- * @purpose Logger implementation bound to the runtime console.
- * @sideEffect Console: writes log entries to stdout/stderr.
+ * @purpose Logger implementation bound to the runtime console, filtered by the active log level.
+ * @sideEffect Console: writes log entries to stderr via console methods.
  */
 export declare const logger: SimpleLogger;

package/dist/services/remote-console/client/remote-console-client-serializer.d.ts

@@ -0,0 +1,7 @@
+import type { RemoteConsoleSerializedArg } from './remote-console-client.types.js';
+/**
+ * @purpose Converts unknown console arguments into deterministic, printable transport-safe descriptors.
+ * @param value Single console argument value from browser runtime.
+ * @returns Serialized representation that never throws and can always be rendered by stdout writer.
+ */
+export declare function serializeRemoteConsoleArg(value: unknown): RemoteConsoleSerializedArg;

package/dist/services/remote-console/client/remote-console-client.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteConsoleClientConnectConfig, RemoteConsoleClientRuntime, RemoteConsoleClientTarget } from './remote-console-client.types.js';
+/**
+ * @purpose Connects a console-like browser target to a remote endpoint without breaking local console behavior.
+ * @param consoleTarget Console-like target to patch for log mirroring.
+ * @param config URL-centric transport configuration for remote endpoint and optional source tag.
+ * @throws {Error} When URL is invalid or console target does not expose required logging methods.
+ * @returns Runtime controls attached to console target under `__remote__.disconnect`.
+ * @sideEffect Monkey patch: replaces log/info/warn/error/debug methods on target.
+ * @sideEffect Timer: starts periodic batch flush every five seconds.
+ * @sideEffect Network: sends envelope commands to configured URL.
+ * @sideEffect Browser lifecycle: subscribes to pagehide and beforeunload for unload-safe shutdown.
+ */
+export declare function connectRemoteConsoleClient(consoleTarget: RemoteConsoleClientTarget, config: RemoteConsoleClientConnectConfig): RemoteConsoleClientRuntime;
+/**
+ * @purpose Public client facade exposing only browser connect API for remote-console domain.
+ * @consumer Browser page runtime
+ */
+export declare const remoteConsoleClient: {
+    connect: typeof connectRemoteConsoleClient;
+};

package/dist/services/remote-console/client/remote-console-client.types.d.ts

@@ -0,0 +1,88 @@
+/** @purpose Defines the supported browser console levels for remote mirroring. */
+export type RemoteConsoleLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+/**
+ * @purpose Describes one serialized console argument in a transport-safe and printable form.
+ * @consumer RemoteConsoleClient, RemoteConsoleStdoutWriter
+ */
+export type RemoteConsoleSerializedArg = {
+    /** @purpose Declares whether the value was primitive or required a tagged fallback descriptor. */
+    kind: 'primitive' | 'tagged';
+    /** @purpose Stores the deterministic text representation for stdout rendering. */
+    text: string;
+    /** @purpose Carries Object.prototype.toString tag for tagged values when available. */
+    tag?: string;
+};
+/**
+ * @purpose Captures one browser console invocation as an ordered transport entry.
+ * @consumer RemoteConsoleHttpServer
+ */
+export type RemoteConsoleLogEntry = {
+    /** @purpose Mirrors the source logging level used in console call. */
+    level: RemoteConsoleLevel;
+    /** @purpose Stores event time as Unix epoch milliseconds for stable ordering in a batch. */
+    timestamp: number;
+    /** @purpose Preserves source argument order after safe serialization. */
+    args: RemoteConsoleSerializedArg[];
+    /** @purpose Optionally marks originating tab identity for diagnostics correlation. */
+    tabId?: string;
+    /** @purpose Optionally marks source branch identity for diagnostics correlation. */
+    branch?: string;
+};
+/**
+ * @purpose Provides URL-centric browser connection options for remote console transport.
+ * @consumer Browser page runtime
+ */
+export type RemoteConsoleClientConnectConfig = {
+    /** @purpose Stores absolute endpoint used for both logs and disconnect envelopes. */
+    url: string;
+    /** @purpose Carries optional source marker copied into outgoing log entries. */
+    tabId?: string;
+    /** @purpose Carries optional branch marker copied into outgoing log entries. */
+    branch?: string;
+};
+/** @purpose Declares runtime controls published on patched console targets. */
+export type RemoteConsoleClientRuntime = {
+    /**
+     * @purpose Stops batching, attempts final flush and sends disconnect envelope exactly once.
+     * @returns Promise that resolves after disconnect.
+     */
+    disconnect: () => Promise<void>;
+};
+/**
+ * @purpose Describes a console-compatible patch target that can expose remote runtime controls.
+ * @consumer remoteConsoleClient.connect
+ */
+export type RemoteConsoleClientTarget = {
+    /**
+     * @purpose Receives plain log-level messages while patched runtime mirrors entries remotely.
+     * @param args Log arguments to mirror remotely.
+     * @returns Result of the underlying console call.
+     */
+    log: (...args: unknown[]) => unknown;
+    /**
+     * @purpose Receives info-level messages while patched runtime mirrors entries remotely.
+     * @param args Info arguments to mirror remotely.
+     * @returns Result of the underlying console call.
+     */
+    info: (...args: unknown[]) => unknown;
+    /**
+     * @purpose Receives warning-level messages while patched runtime mirrors entries remotely.
+     * @param args Warning arguments to mirror remotely.
+     * @returns Result of the underlying console call.
+     */
+    warn: (...args: unknown[]) => unknown;
+    /**
+     * @purpose Receives error-level messages while patched runtime mirrors entries remotely.
+     * @param args Error arguments to mirror remotely.
+     * @returns Result of the underlying console call.
+     */
+    error: (...args: unknown[]) => unknown;
+    /**
+     * @purpose Receives debug-level messages while patched runtime mirrors entries remotely.
+     * @param args Debug arguments to mirror remotely.
+     * @returns Result of the underlying console call.
+     */
+    debug: (...args: unknown[]) => unknown;
+    /** @purpose Exposes injected remote runtime controls after successful connect. */
+    __remote__?: RemoteConsoleClientRuntime;
+};

package/dist/services/remote-console/remote-console.d.ts

@@ -0,0 +1,6 @@
+export { remoteConsoleClient, connectRemoteConsoleClient } from './client/remote-console-client.js';
+export { serializeRemoteConsoleArg } from './client/remote-console-client-serializer.js';
+export type { RemoteConsoleClientConnectConfig, RemoteConsoleClientRuntime, RemoteConsoleClientTarget, RemoteConsoleLevel, RemoteConsoleLogEntry, RemoteConsoleSerializedArg, } from './client/remote-console-client.types.js';
+export { startRemoteConsoleServer } from './server/remote-console-server.js';
+export { RemoteConsoleStdoutWriter } from './server/remote-console-stdout-writer.js';
+export type { RemoteConsoleCommandEnvelope, RemoteConsoleServerLifecycle, RemoteConsoleServerOptions, } from './server/remote-console-server.types.js';

package/dist/services/remote-console/server/remote-console-server.d.ts

@@ -0,0 +1,10 @@
+import type { RemoteConsoleServerLifecycle, RemoteConsoleServerOptions } from './remote-console-server.types.js';
+/**
+ * @purpose Starts a single-endpoint HTTP runtime that accepts remote log and disconnect envelopes.
+ * @param options Runtime startup options with bind address, exit policy and optional test adapters.
+ * @throws {Error} When options are invalid or server startup fails.
+ * @returns Lifecycle handle exposing resolved endpoint URL and graceful close routine.
+ * @sideEffect Network: opens an HTTP listening socket.
+ * @sideEffect IO: writes incoming log payloads to stdout via normalized writer.
+ */
+export declare function startRemoteConsoleServer(options: RemoteConsoleServerOptions): Promise<RemoteConsoleServerLifecycle>;

package/dist/services/remote-console/server/remote-console-server.types.d.ts

@@ -0,0 +1,44 @@
+import type { RemoteConsoleLogEntry } from '../client/remote-console-client.types.js';
+/** @purpose Describes accepted command envelope variants handled by the single remote-console endpoint. */
+export type RemoteConsoleCommandEnvelope = {
+    /** @purpose Selects log-batch dispatch branch for the single endpoint. */
+    type: 'logs';
+    /** @purpose Optionally identifies source tab for downstream diagnostics. */
+    tabId?: string;
+    /** @purpose Carries ordered log entries to be rendered as stdout lines. */
+    items: RemoteConsoleLogEntry[];
+} | {
+    /** @purpose Selects controlled shutdown dispatch branch for the single endpoint. */
+    type: 'disconnect';
+    /** @purpose Optionally identifies source tab that requested shutdown. */
+    tabId?: string;
+};
+/** @purpose Defines startup options for the remote console HTTP runtime. */
+export type RemoteConsoleServerOptions = {
+    /** @purpose Configures the listening port for local server runtime. */
+    port: number;
+    /** @purpose Overrides bind host; defaults to loopback-safe host when omitted. */
+    host?: string;
+    /** @purpose Defines process exit code used after controlled disconnect shutdown. */
+    exitCode?: number;
+    /**
+     * @purpose Custom line writer for tests or integration embeddings.
+     * @param line Text line to write.
+     */
+    stdoutWrite?: (line: string) => void;
+    /**
+     * @purpose Custom exit strategy for tests; defaults to process.exit in production runtime.
+     * @param code Exit code to use.
+     */
+    exit?: (code: number) => void;
+};
+/** @purpose Describes the lifecycle handle returned by the server startup API. */
+export type RemoteConsoleServerLifecycle = {
+    /** @purpose Exposes fully resolved endpoint URL for browser client configuration. */
+    url: string;
+    /**
+     * @purpose Closes the listening server without forcing process termination.
+     * @returns Promise that resolves when server is closed.
+     */
+    close: () => Promise<void>;
+};

package/dist/services/remote-console/server/remote-console-stdout-writer.d.ts

@@ -0,0 +1,26 @@
+import type { RemoteConsoleLogEntry } from '../client/remote-console-client.types.js';
+/**
+ * @purpose Renders remote log entries into deterministic flat stdout lines for terminal consumers.
+ * @consumer RemoteConsoleHttpServer
+ */
+export declare class RemoteConsoleStdoutWriter {
+    /** @purpose Stores low-level line sink used to emit already-rendered stdout entries. */
+    protected readonly _writeLine: (line: string) => void;
+    /**
+     * @purpose Configures writer with injected sink or defaults to process.stdout line output.
+     * @param [writeLine] Optional custom line writer function.
+     */
+    constructor(writeLine?: (line: string) => void);
+    /**
+     * @purpose Prints ordered log entries as one normalized line per entry.
+     * @param items Parsed log entry list from command envelope payload.
+     * @sideEffect IO: writes rendered lines into stdout stream (or injected writer).
+     */
+    write(items: RemoteConsoleLogEntry[]): void;
+    /**
+     * @purpose Creates stable text format independent from platform util.inspect behavior.
+     * @param item Single remote log entry with serialized args.
+     * @returns Flat line in format `[console.<level>] <arg1> <arg2> ...`.
+     */
+    render(item: RemoteConsoleLogEntry): string;
+}

package/dist/services/vcs-client/abstract/vcs-client-merge-discussions.d.ts

@@ -1,48 +1,56 @@
 /**
- * @purpose Параметры создания заметки в дискуссии MR: проект, IID MR, ID дискуссии, текст.
+ * @purpose Parameters for creating a note in an MR discussion: project, MR IID, discussion ID, text.
  * @consumer VcsClientMergeDiscussions
  */
 export type VcsAddNoteQuery = {
+    /** @purpose GitLab project path or ID */
     project: string;
+    /** @purpose Merge request internal ID */
     iid: string | number;
+    /** @purpose Target discussion identifier */
     discussionId: string;
+    /** @purpose Note body text in Markdown */
     body: string;
 };
 /**
- * @purpose Параметры запроса списка дискуссий MR: проект, IID MR, пагинация.
+ * @purpose Parameters for querying MR discussion list: project, MR IID, pagination.
  * @consumer VcsClientMergeDiscussions
  */
 export type VcsDiscussionsListQuery = {
+    /** @purpose GitLab project path or ID */
     project: string;
+    /** @purpose Merge request internal ID */
     iid: string | number;
+    /** @purpose Page size | @invariant Default: GitLab default when absent */
     perPage?: number;
+    /** @purpose Page number starting from 1 */
     page?: number;
 };
 /**
- * @purpose Доступ к Discussions для Merge Request в GitLab.
+ * @purpose Access to Discussions for Merge Requests in GitLab.
+ * @invariant Error Policy: Network/status errors are thrown outward from request().
  * @consumer VcsClient
- * @invariant Error Policy: Ошибки сети/статуса пробрасываются наружу из request().
  */
 export declare abstract class VcsClientMergeDiscussions {
     /**
-     * @purpose Создать ответ (note) в существующей дискуссии Merge Request.
-     * @param query Параметры запроса.
-     * @returns Объект созданной заметки (JSON), как возвращает GitLab API.
+     * @purpose Create a reply (note) in an existing Merge Request discussion.
+     * @param query Query parameters.
+     * @returns Created note object (JSON), as returned by GitLab API.
      * @sideEffect Network: POST /projects/:project/merge_requests/:iid/discussions/:discussion_id/notes
      */
     abstract addNote(query: VcsAddNoteQuery): Promise<unknown>;
     /**
-     * @purpose Получить страницу дискуссий MR.
-     * @param query Параметры: { project, iid, perPage?, page? }.
-     * @returns Список дискуссий текущей страницы.
+     * @purpose Get a page of MR discussions.
+     * @param query Parameters: { project, iid, perPage?, page? }.
+     * @returns List of discussions for the current page.
      * @sideEffect Network: GET /projects/:project/merge_requests/:iid/discussions
      */
     abstract getList(query: VcsDiscussionsListQuery): Promise<unknown[]>;
     /**
-     * @purpose Собрать все страницы дискуссий MR.
-     * @param query Параметры: { project, iid }.
-     * @returns Полный список дискуссий MR.
-     * @sideEffect Network: Многократные GET для постраничной загрузки.
+     * @purpose Collect all pages of MR discussions.
+     * @param query Parameters: { project, iid }.
+     * @returns Complete list of MR discussions.
+     * @sideEffect Network: Multiple GET requests for paginated loading.
      */
     abstract getAll(query: {
         project: string;