@endge/core 5.0.0 → 6.0.0

package/dist/features/core/modules/context/EndgeContext_Module.d.ts

@@ -0,0 +1,157 @@
+import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
+import { EndgeConfiguration } from '../configuration/domain/types/configuration.type';
+import { EndgeContextPersistenceConfig, EndgeContextSnapshot, EndgeKeyboardContextSnapshot, EndgePersistenceScope, EndgeRuntimeContextSnapshot, EndgeSessionIdentityProvider, EndgeStorageAdapter } from './domain/context-persistence.types';
+import { EndgePersistenceInput } from './persistence/EndgeStorageAdapterRegistry';
+import { EndgeExecutionContext, EndgeExecutionContextResolutionInput } from '../runtime/domain/execution-context.types';
+import { EndgeDataMode } from '../workspace/domain/workspace.types';
+import { RuntimeStateController } from './persistence/RuntimeStateController';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/**
+ * Контекст выполнения Endge: текущий workspace/project/environment/user scope
+ * и координатор persistence-инфраструктуры приложения.
+ */
+export declare class EndgeContext_Module extends EndgeModule<EndgeBootContext> {
+    private readonly _adapters;
+    private readonly _runtimeControllers;
+    private _contextPersistence;
+    private _currentWorkspace;
+    private _currentTenant;
+    private _currentProject;
+    private _currentEnvironment;
+    private _currentUser;
+    private _currentLocale;
+    private _pendingLocale;
+    private _currentTheme;
+    private _themePreference;
+    private _currentTimezone;
+    private _pendingTimezone;
+    private _workspaceDataMode;
+    private _dataModeOverride;
+    private _sessionProvider;
+    private _isHydrating;
+    private _executionContextLocked;
+    /** Создаёт контекст, регистрирует storage adapters и восстанавливает snapshot. */
+    constructor();
+    /** Применяет explicit structural context до load/build остальных модулей. */
+    setup(ctx: EndgeBootContext): void;
+    /** Разрешает выбрать новый structural context только перед следующим boot. */
+    reset(): void;
+    /** Показывает, выполняется ли восстановление контекста из storage. */
+    get isLoadingFromStorage(): boolean;
+    /** Регистрирует storage adapter для persistence-контекста. */
+    registerStorageAdapter(adapter: EndgeStorageAdapter): void;
+    /** Настраивает persistence текущего контекста. */
+    configurePersistence(config: EndgeContextPersistenceConfig): void;
+    /** Устанавливает provider актуальных tenant и user identity. */
+    setSessionIdentityProvider(provider: EndgeSessionIdentityProvider | null): void;
+    /** Показывает, что Tenant принудительно задан authenticated session provider. */
+    get isTenantLockedBySession(): boolean;
+    /** Сериализует текущий execution scope в snapshot. */
+    serialize(): EndgeContextSnapshot;
+    /** Возвращает полный доступный SFC контекст без добавления временных значений в persistence. */
+    runtimeSnapshot(): EndgeRuntimeContextSnapshot;
+    /** Возвращает текущее временное состояние клавиатуры из общего пространства контекста Raph. */
+    getKeyboardState(): EndgeKeyboardContextSnapshot;
+    /** Публикует состояние клавиатуры UI-адаптера как узкие несохраняемые изменения Raph. */
+    setKeyboardState(input: EndgeKeyboardContextSnapshot): void;
+    /** Сохраняет подписчиков legacy-модуля и проецирует постоянные поля контекста в Raph. */
+    notify(): void;
+    /** Восстанавливает execution scope из snapshot с безопасными defaults. */
+    deserialize(payload: Partial<EndgeContextSnapshot> | undefined): void;
+    /** Сохраняет текущий context snapshot через выбранный adapter. */
+    saveToStorage(): void;
+    /** Загружает context snapshot из нового или legacy storage key. */
+    loadFromStorage(): EndgeContextSnapshot | undefined;
+    /** Возвращает полный persistence scope текущей сессии. */
+    getPersistenceScope(): EndgePersistenceScope;
+    /** Создаёт или возвращает controller runtime-состояния по runtime id. */
+    createRuntimeStateController(input: {
+        runtimeId: string;
+        storageId?: string;
+        persistence?: EndgePersistenceInput;
+    }): RuntimeStateController;
+    /** Возвращает runtime state controller по id. */
+    getRuntimeStateController(runtimeId: string): RuntimeStateController | null;
+    /** Удаляет runtime state controller из registry. */
+    destroyRuntimeStateController(runtimeId: string): void;
+    /** Возвращает identity текущего workspace. */
+    getCurrentWorkspace(): string | null;
+    /** Устанавливает текущий workspace и сохраняет контекст. */
+    setCurrentWorkspace(identity: string | null): void;
+    /** Возвращает identity текущего tenant с учётом session provider. */
+    getCurrentTenant(): string;
+    /** Устанавливает fallback identity текущего tenant. */
+    setCurrentTenant(identity: string | null): void;
+    /** Возвращает identity текущего project. */
+    getCurrentProject(): string;
+    /** Устанавливает текущий project и сохраняет контекст. */
+    setCurrentProject(identity: string | null): void;
+    /** Возвращает identity текущего environment. */
+    getCurrentEnvironment(): string;
+    /** Возвращает immutable structural coordinates текущего boot lifecycle. */
+    getExecutionContext(): EndgeExecutionContext;
+    /**
+     * Разрешает structural context после загрузки Domain, но до configuration/build.
+     * Explicit и session coordinates обязательны; сохранённые preferences могут
+     * безопасно перейти на первую доступную сущность, если Domain изменился.
+     */
+    resolveExecutionContext(input: EndgeExecutionContextResolutionInput): EndgeExecutionContext;
+    /** Устанавливает текущий environment и сохраняет контекст. */
+    setCurrentEnvironment(identity: string | null): void;
+    /** Возвращает identity текущего user с учётом session provider. */
+    getCurrentUser(): string;
+    /** Устанавливает fallback identity текущего user. */
+    setCurrentUser(identity: string | null): void;
+    /** Возвращает текущий режим выполнения данных для fixtures Store и внешних запусков Query. */
+    get dataMode(): EndgeDataMode;
+    /** Показывает, должны ли runtime-потребители вычислять сохранённые fixtures RMock. */
+    get isMockEnabled(): boolean;
+    /** Показывает, получен ли фактический режим из локального runtime-переопределения. */
+    get isDataModeOverridden(): boolean;
+    /** Применяет сохранённое значение Workspace по умолчанию без записи в локальное хранилище контекста. */
+    setWorkspaceDataMode(mode: EndgeDataMode): void;
+    /** Применяет принадлежащее host переопределение режима данных без перестроения структурного контекста. */
+    setDataMode(mode: EndgeDataMode): void;
+    /** Удаляет локальное переопределение и восстанавливает текущее значение Workspace по умолчанию. */
+    clearDataModeOverride(): void;
+    /** Упрощённый API для переключателей UI, представляющих mock-режим как boolean-состояние. */
+    setMockEnabled(enabled: boolean): void;
+    /** Возвращает текущую locale контекста. */
+    get currentLocale(): string;
+    /** Нормализует, сохраняет и публикует новую locale. */
+    setCurrentLocale(locale: string | null): void;
+    /** Согласует текущую locale с effective configuration после workspace resolution. */
+    reconcileCurrentLocaleWithWorkspace(configuration?: EndgeConfiguration): void;
+    /** Возвращает текущую тему контекста. */
+    get currentTheme(): string;
+    /** Нормализует, сохраняет и публикует пользовательскую тему. */
+    setCurrentTheme(theme: string | null): void;
+    /** Согласует сохранённую тему с effective configuration после workspace resolution. */
+    reconcileCurrentThemeWithWorkspace(configuration?: EndgeConfiguration): void;
+    /** Возвращает текущую временную зону контекста. */
+    get currentTimezone(): string;
+    /** Нормализует, сохраняет и публикует новую временную зону. */
+    setCurrentTimezone(timezone: string | null): void;
+    /** Согласует сохранённую временную зону с effective configuration. */
+    reconcileCurrentTimezoneWithWorkspace(configuration?: EndgeConfiguration): void;
+    /** Возвращает effective configuration либо persisted workspace configuration до resolution. */
+    private _activeConfiguration;
+    private _normalizeLocale;
+    private _normalizeTheme;
+    private _normalizeTimezone;
+    /** Сохраняет только явное предпочтение; фактическим значением по умолчанию продолжает владеть конфигурация. */
+    private _serializeForPersistence;
+    /** Выбирает storage adapter для заданной persistence policy. */
+    private _resolveAdapter;
+    private _syncPersistentContextToRaph;
+    private _setRaphValueIfChanged;
+    /** Возвращает identity активного workspace для persistence scope. */
+    private _requireCurrentWorkspace;
+    /** Создаёт безопасный scope для контроллера, который не читает и не изменяет состояние. */
+    private _getDisabledPersistenceScope;
+    /** Вычисляет tenant и user identity текущей сессии. */
+    private _resolveSessionIdentity;
+    /** Обновляет одно поле scope и публикует изменение контекста. */
+    private _setScopeValue;
+    private _assertStructuralContextMutable;
+}

package/dist/features/core/modules/context/domain/context-persistence.types.d.ts

@@ -0,0 +1,84 @@
+import { EndgePublicConfigurationSnapshot } from '../../configuration/domain/types/configuration.type';
+export type EndgePersistenceDriver = 'local' | 'disabled';
+export interface EndgePersistenceOptions {
+    driver?: EndgePersistenceDriver;
+}
+export interface EndgeContextPersistenceConfig {
+    context?: EndgePersistenceDriver | EndgePersistenceOptions | null;
+}
+export interface EndgeContextSnapshot {
+    workspace: string | null;
+    tenant: string | null;
+    project: string | null;
+    environment: string | null;
+    user: string | null;
+    locale: string | null;
+    theme: string | null;
+    timezone: string | null;
+}
+/** Данные хранилища, отличающие явный выбор темы от фактического default. */
+export interface EndgePersistedContextSnapshot extends EndgeContextSnapshot {
+    themePreferenceVersion?: 1;
+}
+/** Временное состояние клавиатуры, предоставляемое активным UI-адаптером. */
+export interface EndgeKeyboardContextSnapshot {
+    platform: 'macos' | 'windows' | 'linux' | 'unknown';
+    modifiers: {
+        ctrl: boolean;
+        shift: boolean;
+        alt: boolean;
+        meta: boolean;
+        mod: boolean;
+        altGraph: boolean;
+    };
+    held: {
+        key: string[];
+        code: string[];
+    };
+}
+/** Полный readonly-контекст SFC. Временное состояние ввода намеренно не сериализуется. */
+export interface EndgeRuntimeContextSnapshot extends EndgeContextSnapshot {
+    /** Статическая фактическая конфигурация текущей сборки; не сохраняется и не поддерживается Raph. */
+    config: EndgePublicConfigurationSnapshot;
+    input: {
+        keyboard: EndgeKeyboardContextSnapshot;
+    };
+}
+export interface EndgePersistenceScope {
+    workspaceId: string;
+    tenantId: string;
+    projectId: string;
+    environmentId: string;
+    userId: string;
+}
+export type EndgePersistenceScopeResolver = () => EndgePersistenceScope;
+export interface EndgeSessionIdentity {
+    userId?: string | null;
+    tenantId?: string | null;
+}
+export interface EndgeSessionIdentityProvider {
+    getCurrentIdentity: () => EndgeSessionIdentity | null;
+}
+export interface EndgeStorageAdapter {
+    readonly id: EndgePersistenceDriver;
+    isAvailable: () => boolean;
+    read: <T>(key: string) => T | undefined;
+    write: <T>(key: string, value: T) => void;
+    remove: (key: string) => void;
+}
+export interface RuntimeStateDocument {
+    version: 1;
+    scope: EndgePersistenceScope;
+    runtimeId: string;
+    state: Record<string, Record<string, unknown>>;
+}
+export interface RuntimeStateControllerLike {
+    readonly runtimeId: string;
+    readonly storageId: string;
+    readonly storageKey: string;
+    readonly scope: EndgePersistenceScope;
+    get: <T>(entityKey: string, section: string, fallback: T) => T;
+    set: <T>(entityKey: string, section: string, value: T) => void;
+    remove: (entityKey: string, section?: string) => void;
+    clear: () => void;
+}

package/dist/features/core/modules/context/endge-vars.d.ts

@@ -0,0 +1,81 @@
+import { EndgeResolvedWorkspaceVariable, EndgeWorkspaceVar } from '../workspace/domain/workspace.types';
+type EnvRecord = Record<string, unknown>;
+/**
+ * WorkspaceVariables resolves effective values of workspace variable definitions.
+ *
+ * Источник списка переменных:
+ *  - workspace.vars
+ *
+ * Источники значений и приоритеты:
+ *  1) ENVY/runtime vars (если задано) - самый высокий приоритет
+ *  2) Vite env: import.meta.env.VITE_<NAME> (напрямую, без сканирования)
+ *     - имя переменной внутри системы: без префикса (ENDPOINT_AUTH -> VITE_ENDPOINT_AUTH)
+ *  3) workspace.vars
+ *
+ * Runtime projections are owned by EndgeRuntime_Module, not by this service.
+ */
+export declare class WorkspaceVariables {
+    private readonly _getDefinitions;
+    private _envyRecord;
+    constructor(_getDefinitions: () => EndgeWorkspaceVar[]);
+    /**
+     * Устанавливает внешние overrides переменных и сразу пересинхронизирует Raph.
+     */
+    setEnvironment(envyRecord: EnvRecord): void;
+    /** Имя совместимости для вызывающего кода, который всё ещё напрямую передаёт runtime-переопределения. */
+    setEnvyRecord(envyRecord: EnvRecord): void;
+    /** Сохранённые определения переменных, принадлежащие Workspace. */
+    get definitions(): EndgeWorkspaceVar[];
+    /**
+     * Возвращает Domain Vars.
+     */
+    private _getDomainVars;
+    /**
+     * Порядок поиска:
+     *  1) ENVY
+     *  2) Vite env: import.meta.env.VITE_<NAME>
+     *  3) домен
+     */
+    getValue(name: string): string | undefined;
+    /**
+     * Возвращает все доменные переменные с учетом overrides.
+     */
+    getAll(): EndgeResolvedWorkspaceVariable[];
+    /**
+     * Возвращает переменные в виде record, удобном для сериализации и debug UI.
+     */
+    toRecord(): Record<string, {
+        defaultValue: string;
+        currentValue: string;
+    }>;
+    /**
+     * Резолвит одиночные токены и интерполирует несколько переменных в строке,
+     * затем применяет optional coercion.
+     */
+    resolve<T = string>(raw: unknown, options?: {
+        coerce?: (value: string | number | boolean | null | undefined) => T;
+        fallback?: T;
+        onInvalid?: 'fallback' | 'as-is' | 'throw';
+    }): T | undefined;
+    /**
+     * Приводит значение переменной к number.
+     */
+    static toNumber(v: unknown): number;
+    /**
+     * Приводит значение переменной к string.
+     */
+    static toString(v: unknown): string;
+    /**
+     * Приводит значение переменной к boolean.
+     */
+    static toBoolean(v: unknown): boolean;
+    /** Интерполирует все корректные `{{ VAR }}` и legacy `{VAR}` токены в строке. */
+    private _interpolate;
+    /**
+     * Внутренний helper модуля: parse Var Token.
+     */
+    private static _parseVarToken;
+    /** Читает variable из внешнего environment без изменения module state. */
+    private _getExternalValue;
+}
+export {};

package/dist/features/core/modules/context/persistence/EndgeStorageAdapterRegistry.d.ts

@@ -0,0 +1,9 @@
+import { EndgePersistenceDriver, EndgePersistenceOptions, EndgeStorageAdapter } from '../domain/context-persistence.types';
+export type EndgePersistenceInput = EndgePersistenceDriver | EndgePersistenceOptions | null | undefined;
+export declare function normalizePersistence(input: EndgePersistenceInput): EndgePersistenceOptions;
+export declare function normalizePersistenceDriver(value: unknown): EndgePersistenceDriver;
+export declare class EndgeStorageAdapterRegistry {
+    private readonly _adapters;
+    register(adapter: EndgeStorageAdapter): void;
+    resolve(input: EndgePersistenceInput): EndgeStorageAdapter;
+}

package/dist/features/core/modules/context/persistence/RuntimeStateController.d.ts

@@ -0,0 +1,24 @@
+import { EndgePersistenceScope, EndgePersistenceScopeResolver, EndgeStorageAdapter, RuntimeStateControllerLike } from '../domain/context-persistence.types';
+export declare function buildRuntimeStateStorageKey(scope: EndgePersistenceScope, runtimeId: string): string;
+export declare class RuntimeStateController implements RuntimeStateControllerLike {
+    readonly runtimeId: string;
+    readonly storageId: string;
+    private readonly _adapter;
+    private readonly _resolveScope;
+    constructor(input: {
+        runtimeId: string;
+        storageId?: string;
+        scope: EndgePersistenceScope | EndgePersistenceScopeResolver;
+        adapter: EndgeStorageAdapter;
+    });
+    /** Возвращает актуальный persistence scope, включая текущую session identity. */
+    get scope(): EndgePersistenceScope;
+    /** Строит storage key из актуального scope, чтобы переавторизация не сохраняла данные прежнему пользователю. */
+    get storageKey(): string;
+    get<T>(entityKey: string, section: string, fallback: T): T;
+    set<T>(entityKey: string, section: string, value: T): void;
+    remove(entityKey: string, section?: string): void;
+    clear(): void;
+    private _readDocument;
+    private _createDefaultDocument;
+}

package/dist/features/core/modules/context/persistence/adapters/DisabledContextAdapter.d.ts

@@ -0,0 +1,8 @@
+import { EndgeStorageAdapter } from '../../domain/context-persistence.types';
+export declare class DisabledContextAdapter implements EndgeStorageAdapter {
+    readonly id: "disabled";
+    isAvailable(): boolean;
+    read<T>(_key: string): T | undefined;
+    write<T>(_key: string, _value: T): void;
+    remove(_key: string): void;
+}

package/dist/features/core/modules/context/persistence/adapters/LocalStorageContextAdapter.d.ts

@@ -0,0 +1,10 @@
+import { EndgeStorageAdapter } from '../../domain/context-persistence.types';
+export declare class LocalStorageContextAdapter implements EndgeStorageAdapter {
+    readonly id: "local";
+    isAvailable(): boolean;
+    read<T>(key: string): T | undefined;
+    /** Читает legacy raw string, который ещё не использовал JSON serialization. */
+    readRaw(key: string): string | null;
+    write<T>(key: string, value: T): void;
+    remove(key: string): void;
+}

package/dist/features/core/modules/converters/EndgeConverters_Module.d.ts

@@ -0,0 +1,42 @@
+import { ImplementationBindingScope } from '../actions/domain/action.types';
+import { EntityOrigin } from '../domain/types/document/entity-management.type';
+import { EndgeImplementations_Module } from '../implementations/EndgeImplementations_Module';
+import { EndgeModule } from '../../../federation/EndgeModule';
+type ConverterProvider = (value: unknown, options?: Record<string, unknown>) => unknown;
+/** Синхронно координирует definitions, providers и bindings конвертеров. */
+export declare class EndgeConverters_Module extends EndgeModule {
+    private readonly _implementations;
+    private readonly _definitions;
+    private readonly _providerDisposers;
+    private readonly _definitionDisposers;
+    private _started;
+    /**
+     * ----------------------------------------
+     * PUBLIC
+     * ----------------------------------------
+     */
+    constructor(_implementations: EndgeImplementations_Module);
+    has(identity: string): boolean;
+    define(definition: {
+        identity: string;
+        origin: EntityOrigin;
+        defaultProviderKey?: string;
+    }): VoidFunction;
+    provide(provider: {
+        identity: string;
+        key: string;
+        origin: EntityOrigin;
+        convert: ConverterProvider;
+    }): VoidFunction;
+    override(binding: {
+        identity: string;
+        providerKey: string;
+        scope?: Exclude<ImplementationBindingScope, 'default' | 'invocation'>;
+        scopeIdentity?: string;
+        priority?: number;
+    }): VoidFunction;
+    execute(identity: string, value: unknown, options?: Record<string, unknown>): unknown;
+    start(): void;
+    reset(): void;
+}
+export {};

package/dist/features/core/modules/diagnostics/EndgeDiagnostics_Module.d.ts

@@ -0,0 +1,108 @@
+import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
+import { DiagnosticsAdapter, DiagnosticsAdapterFactory, DiagnosticsFlushResult } from './domain/types/diagnostics-adapter.type';
+import { DiagnosticsContextProvider, DiagnosticsExceptionOptions, DiagnosticsFilter, DiagnosticsListener, DiagnosticsLogInput, DiagnosticsLogOptions, DiagnosticsLogRecord, DiagnosticsRecord, DiagnosticsResource, DiagnosticsSnapshot, DiagnosticsSnapshotOptions, DiagnosticsSpanHandle, DiagnosticsSpanOptions, DiagnosticsSpanRecord, DiagnosticsSubscribeOptions, EndgeDiagnosticsConfiguration } from './domain/types/diagnostics.types';
+import { DiagnosticsAdapterRegistry } from './adapters/DiagnosticsAdapterRegistry';
+import { EndgeProblems_Module } from './EndgeProblems_Module';
+import { EndgeTelemetry_Module } from './EndgeTelemetry_Module';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/**
+ * Родительский diagnostics-модуль ядра.
+ * Объединяет append-only telemetry history и replaceable registry актуальных problems.
+ */
+export declare class EndgeDiagnostics_Module extends EndgeModule<EndgeBootContext> {
+    /** Registry системных и внешних adapter factories. */
+    readonly adapters: DiagnosticsAdapterRegistry;
+    /** Подмодуль logs, traces, adapters и external delivery. */
+    readonly telemetry: EndgeTelemetry_Module;
+    /** Подмодуль актуальных authoring/build/runtime problems. */
+    readonly problems: EndgeProblems_Module;
+    /** Состояние automatic snapshot policy и её внутренней подписки. */
+    private _automaticErrorTimestamps;
+    private _automaticCooldownUntil;
+    private _unsubscribeAutomaticRecords;
+    /**
+     * ----------------------------------------
+     * PUBLIC
+     * ----------------------------------------
+     */
+    /** Связывает независимые уведомления подмодулей с родительским diagnostics-модулем. */
+    constructor();
+    /** Передаёт setup lifecycle подмодулям в порядке их зависимостей. */
+    setup(ctx: EndgeBootContext): Promise<void>;
+    /** Передаёт load lifecycle подмодулям в порядке их зависимостей. */
+    load(ctx: EndgeBootContext): Promise<void>;
+    /** Передаёт build lifecycle подмодулям в порядке их зависимостей. */
+    build(ctx: EndgeBootContext): Promise<void>;
+    /** Передаёт start lifecycle подмодулям в порядке их зависимостей. */
+    start(ctx: EndgeBootContext): Promise<void>;
+    /** Сбрасывает подмодули в обратном порядке их запуска. */
+    reset(): Promise<void>;
+    /** Применяет telemetry, outputs, routes и snapshots configuration. */
+    configure(configuration: EndgeDiagnosticsConfiguration, resource?: DiagnosticsResource): void;
+    /** Записывает один structured log через telemetry-подмодуль. */
+    log(input: DiagnosticsLogInput): DiagnosticsLogRecord | null;
+    /** Записывает log уровня TRACE. */
+    trace(body: string, options?: DiagnosticsLogOptions): DiagnosticsLogRecord | null;
+    /** Записывает log уровня DEBUG. */
+    debug(body: string, options?: DiagnosticsLogOptions): DiagnosticsLogRecord | null;
+    /** Записывает log уровня INFO. */
+    info(body: string, options?: DiagnosticsLogOptions): DiagnosticsLogRecord | null;
+    /** Записывает log уровня WARN. */
+    warn(body: string, options?: DiagnosticsLogOptions): DiagnosticsLogRecord | null;
+    /** Записывает log уровня ERROR. */
+    error(body: string, options?: DiagnosticsLogOptions): DiagnosticsLogRecord | null;
+    /** Записывает log уровня FATAL без автоматической остановки runtime. */
+    fatal(body: string, options?: DiagnosticsLogOptions): DiagnosticsLogRecord | null;
+    /** Нормализует exception и записывает его в telemetry history. */
+    recordException(error: unknown, options?: DiagnosticsExceptionOptions): DiagnosticsLogRecord | null;
+    /** Создаёт root или child span через telemetry-подмодуль. */
+    startSpan(name: string, options?: DiagnosticsSpanOptions): DiagnosticsSpanHandle;
+    /** Завершает span, созданный через низкоуровневый DiagnosticsSpanOwner contract. */
+    finishSpan(input: Parameters<EndgeTelemetry_Module['finishSpan']>[0]): DiagnosticsSpanRecord | null;
+    /** Подписывает listener на любое изменение родительского diagnostics-модуля. */
+    subscribe(listener: () => void): () => void;
+    /** Подписывает listener на отфильтрованный telemetry stream. */
+    subscribe(filter: DiagnosticsFilter, listener: DiagnosticsListener, options?: DiagnosticsSubscribeOptions): () => void;
+    /** Возвращает telemetry records, соответствующие фильтру. */
+    query(filter?: DiagnosticsFilter): readonly DiagnosticsRecord[];
+    /** Возвращает JSON-safe snapshot telemetry, problems и optional configuration. */
+    snapshot(options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
+    /** Создаёт snapshot и доставляет его в выбранные configured outputs. */
+    sendSnapshot(outputIds?: readonly string[], options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
+    /** Возвращает telemetry counters текущей session. */
+    getCounters(): ReturnType<EndgeTelemetry_Module['getCounters']>;
+    /** Очищает только telemetry history, не затрагивая актуальные problems. */
+    clear(): void;
+    /** Регистрирует provider общих telemetry attributes. */
+    registerContextProvider(id: string, provider: DiagnosticsContextProvider): () => void;
+    /** Регистрирует adapter внешней telemetry delivery. */
+    registerAdapter(adapter: DiagnosticsAdapter): () => void;
+    /** Регистрирует внешний тип adapter и возвращает функцию удаления factory. */
+    registerAdapterFactory(factory: DiagnosticsAdapterFactory): () => void;
+    /** Проверяет configured output через созданный runtime adapter. */
+    testOutput(outputId: string): Promise<boolean>;
+    /** Отключает telemetry adapter и освобождает его ресурсы. */
+    unregisterAdapter(adapterId: string): Promise<void>;
+    /** Выполняет best-effort flush всех telemetry adapters. */
+    flush(): Promise<DiagnosticsFlushResult>;
+    /**
+     * ----------------------------------------
+     * PRIVATE
+     * ----------------------------------------
+     */
+    /** Восстанавливает внутреннюю подписку на ERROR/FATAL records после reset. */
+    private _subscribeAutomaticSnapshots;
+    /** Применяет sliding window и cooldown политики автоматического snapshot. */
+    private _handleAutomaticSnapshotRecord;
+    /**
+     * ----------------------------------------
+     * ACCESS
+     * ----------------------------------------
+     */
+    /** Возвращает идентификатор текущей telemetry session. */
+    get sessionId(): string;
+    /** Возвращает effective telemetry configuration. */
+    get configuration(): EndgeDiagnosticsConfiguration;
+    /** Возвращает resource текущей telemetry session. */
+    get resource(): DiagnosticsResource;
+}

package/dist/features/core/modules/diagnostics/EndgeProblems_Module.d.ts

@@ -0,0 +1,38 @@
+import { DiagnosticsEntityRef, DiagnosticsProblem, DiagnosticsProblemFilter, DiagnosticsProblemInput, DiagnosticsProblemOwner, DiagnosticsProblemsSnapshot } from './domain/types/diagnostics.types';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/** Создаёт стабильного owner для проблем одной доменной сущности и фазы. */
+export declare function createDiagnosticsEntityOwner(entityRef: DiagnosticsEntityRef, phase?: DiagnosticsProblemOwner['phase']): DiagnosticsProblemOwner;
+/**
+ * Replaceable registry актуальных проблем Endge.
+ * В отличие от telemetry history, исправленные проблемы удаляются через replace/resolve.
+ */
+export declare class EndgeProblems_Module extends EndgeModule {
+    private readonly _problemsByOwner;
+    private _revision;
+    /** Возвращает монотонную версию текущего problem state. */
+    get revision(): number;
+    /** Полностью заменяет набор проблем owner и удаляет его при пустом результате. */
+    replace(owner: DiagnosticsProblemOwner, inputs: readonly DiagnosticsProblemInput[]): readonly DiagnosticsProblem[];
+    /** Добавляет или заменяет одну persistent-проблему без изменения остальных проблем owner. */
+    upsert(owner: DiagnosticsProblemOwner, input: DiagnosticsProblemInput): DiagnosticsProblem;
+    /** Удаляет одну проблему owner по её локальному key. */
+    resolve(ownerKey: string, problemKey: string): boolean;
+    /** Возвращает immutable snapshot проблем, соответствующих фильтру. */
+    query(filter?: DiagnosticsProblemFilter): readonly DiagnosticsProblem[];
+    /** Очищает весь registry или только проблемы, соответствующие фильтру. */
+    clear(filter?: DiagnosticsProblemFilter): void;
+    /** Возвращает сериализуемый snapshot текущих актуальных проблем. */
+    snapshot(filter?: DiagnosticsProblemFilter): DiagnosticsProblemsSnapshot;
+    /** Полностью сбрасывает problem state для следующего boot lifecycle. */
+    reset(): void;
+    /** Проверяет проблему по фильтру registry. */
+    private _matches;
+    /** Нормализует owner и запрещает неадресуемые наборы проблем. */
+    private _normalizeOwner;
+    /** Нормализует и замораживает одну проблему перед публикацией. */
+    private _normalizeProblem;
+    /** Клонирует плоские attributes без передачи mutable arrays наружу. */
+    private _cloneAttributes;
+    /** Обновляет revision и уведомляет подписчиков об изменении problem state. */
+    private _touch;
+}