@futdevpro/nts-dynamo 1.15.105 → 1.15.110

package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts

@@ -12,7 +12,8 @@ import {
   DyFM_AI_LLM_Response,
   DyFM_AI_Tool,
   DyFM_AI_ToolCall,
-  DyFM_AI_ModelInfo
+  DyFM_AI_ModelInfo,
+  DyFM_AI_ModelRegistry_Util
 } from '@futdevpro/fsm-dynamo/ai';
 
 import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
@@ -514,33 +515,17 @@ export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
     try {
       const settings = set.settings ?? this.defaultSettings;
 
+      const useModel: string = String(settings?.useModel ?? this.defaultModel);
+
       const result: ChatCompletionCreateParamsBase = {
-        model: settings?.useModel ?? this.defaultModel,
+        model: useModel,
         messages: set.conversation as ChatCompletionMessageParam[],
       };
 
-      result.temperature = DyFM_notNull(settings?.temperature) ? 
-        settings.temperature : 
-        this.defaultSettings.temperature;
-      
-      /* result.max_completion_tokens = DyFM_notNull(settings?.maxTokens) ? 
-        settings.maxTokens : 
-        this.defaultSettings.maxTokens; */
-      result.max_completion_tokens = DyFM_notNull(settings?.maxTokens) ? 
-        settings.maxTokens : 
-        this.defaultSettings.maxTokens;
-
-      result.top_p = DyFM_notNull(settings?.topP) ? 
-        settings.topP : 
-        this.defaultSettings.topP;
-
-      result.frequency_penalty = DyFM_notNull(settings?.frequencyPenalty) ? 
-        settings.frequencyPenalty : 
-        this.defaultSettings.frequencyPenalty;
-
-      result.presence_penalty = DyFM_notNull(settings?.presencePenalty) ? 
-        settings.presencePenalty : 
-        this.defaultSettings.presencePenalty;
+      // FR-048 §3: a sampling-parameterek (+ max_completion_tokens) a per-model `settingsSchema` szerint
+      // kerulnek ra (drop/clamp). KORABBAN ez a NEM-tool ag FELTETEL NELKUL kuldte a sampling-parametereket,
+      // ezert reasoning modellen (GPT-5.x / o-series) 400-zal elhasalt volna — ezt itt zarjuk le.
+      this.applySamplingParams({ input: result, useModel: useModel, settings: set.settings });
 
       return result;
     } catch (error) {
@@ -603,19 +588,12 @@ export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
       const input: ChatCompletionCreateParamsBase = {
         model: useModel,
         messages: messages,
-        max_completion_tokens: DyFM_notNull(settings?.maxTokens) ? settings.maxTokens : this.defaultSettings.maxTokens,
       };
 
-      // Reasoning modellek (GPT-5.x / o-series) elutasitjak a sampling-parametereket
-      // (temperature != 1, top_p, frequency/presence_penalty) -> 400. Ezeket NEM kuldjuk
-      // reasoning modellnel. (Ez a FR-048 per-model settings elv lokalis, OpenAI-specifikus
-      // alkalmazasa — amig a general reconciler el nem keszul.)
-      if (!this.isReasoningModel(String(useModel))) {
-        input.temperature = DyFM_notNull(settings?.temperature) ? settings.temperature : this.defaultSettings.temperature;
-        input.top_p = DyFM_notNull(settings?.topP) ? settings.topP : this.defaultSettings.topP;
-        input.frequency_penalty = DyFM_notNull(settings?.frequencyPenalty) ? settings.frequencyPenalty : this.defaultSettings.frequencyPenalty;
-        input.presence_penalty = DyFM_notNull(settings?.presencePenalty) ? settings.presencePenalty : this.defaultSettings.presencePenalty;
-      }
+      // FR-048 §3: a sampling-parameterek + `max_completion_tokens` a per-model `settingsSchema` szerint
+      // kerulnek ra. A korabbi lokalis `isReasoningModel`-drop atmeneti fallback-kent bent maradt a
+      // helper-ben (l. `applySamplingParams`), amig a schema ki nem kerul a fsm-bol — igy nincs regresszio.
+      this.applySamplingParams({ input: input, useModel: String(useModel), settings: set.settings });
 
       // Ures tools-tomb -> 400 ("tools must have minimum length 1"). Csak akkor kuldjuk, ha van tool.
       if (set.tools.length) {
@@ -728,14 +706,88 @@ export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
   }
 
   /**
-   * Reasoning modell-e (GPT-5.x sor vagy o-series, pl. o1/o3/o4)? Ezek elutasitjak a
-   * sampling-parametereket (temperature != 1, top_p, frequency/presence_penalty). A `gpt-4o`
-   * NEM reasoning (a 'gpt-5' prefix nem illeszti, 'o'-prefix sem).
+   * ⚠️ **TUL TAG HEURISZTIKA — csak FALLBACK, ne ez legyen az igazsag forrasa.**
+   *
+   * Eredetileg (FR-047) azt felteteleztuk, hogy MINDEN `gpt-5.x` + o-series modell elutasitja a
+   * sampling-parametereket. **Live capture 2026-07-21 ezt MEGCAFOLTA:**
+   *  - elutasit: `gpt-5.5`, `o3-mini`, `o4-mini`
+   *  - **ELFOGADJA**: `gpt-5.4-mini`, `gpt-5.4-nano` (HTTP 200, `reasoning_tokens: 0`)
+   *
+   * Vagyis erre a ket modellre ez a regex **NEMAN kidobna ervenyes parametereket** — halkan rontva a
+   * kimenetet. Ezert az `applySamplingParams` a **registry `settingsSchema`-t reszesiti elonyben**, es ezt
+   * a heurisztikat CSAK akkor hasznalja, ha az adott modellhez nincs schema (regi fsm-verzio / ismeretlen
+   * modell). Amint a populalt schema mindenhol elerheto, ez a metodus elhagyhato.
+   *
+   * Reszletek: `documentations/plans/ai-mocking-system/CAPTURE-FINDINGS.md` §1.
    */
   protected isReasoningModel(modelId: string): boolean {
     return /^gpt-5/.test(modelId) || /^o[0-9]/.test(modelId);
   }
 
+  /**
+   * FR-048 §3 — feloldja az agnosztikus sampling-settingseket (hivas-settings > default), atengedi a
+   * per-model reconciler-en (`settingsSchema` szerinti drop/clamp), majd RAKEPZI a natív OpenAI mezokre.
+   * Csak azok a natív mezok kerulnek az input-ra, amik a reconcile utan MEGMARADTAK.
+   *
+   * Ezzel a "melyik modell mit fogad el" tudas a registry `settingsSchema`-jaban (SSoT) el, nem
+   * provider-translatoronkent duplikalva.
+   *
+   * **Atmeneti fallback (szandekos):** ha a registry-bejegyzesnek MEG NINCS `settingsSchema`-ja (regebbi
+   * fsm-verzio, vagy registry-ben nem szereplo modell), a korabbi lokalis `isReasoningModel`-drop marad
+   * ervenyben — igy a FR-047 `514153f` fix NEM regresszal, amig a schema ki nem kerul a fsm-bol. Amint a
+   * schema mindenhol elerheto, ez a fallback (es az `isReasoningModel`) elhagyhato.
+   */
+  protected applySamplingParams(
+    set: {
+      input: ChatCompletionCreateParamsBase,
+      useModel: string,
+      settings?: DyFM_OAI_CallSettings,
+    }
+  ): void {
+    const source: DyFM_OAI_CallSettings = set.settings ?? this.defaultSettings;
+
+    const resolved: DyFM_OAI_CallSettings = {
+      ...source,
+      useModel: set.useModel,
+      temperature: DyFM_notNull(source?.temperature) ? source.temperature : this.defaultSettings.temperature,
+      maxTokens: DyFM_notNull(source?.maxTokens) ? source.maxTokens : this.defaultSettings.maxTokens,
+      topP: DyFM_notNull(source?.topP) ? source.topP : this.defaultSettings.topP,
+      frequencyPenalty: DyFM_notNull(source?.frequencyPenalty) ?
+        source.frequencyPenalty : this.defaultSettings.frequencyPenalty,
+      presencePenalty: DyFM_notNull(source?.presencePenalty) ?
+        source.presencePenalty : this.defaultSettings.presencePenalty,
+    };
+
+    const final: DyFM_OAI_CallSettings = this.reconcileCallSettings(set.useModel, resolved);
+
+    const modelInfo: DyFM_AI_ModelInfo = DyFM_AI_ModelRegistry_Util.findModelInfo(
+      this.getModelRegistry(),
+      set.useModel
+    );
+    const dropSampling: boolean = !modelInfo?.settingsSchema && this.isReasoningModel(set.useModel);
+
+    if (DyFM_notNull(final?.maxTokens)) {
+      set.input.max_completion_tokens = final.maxTokens;
+    }
+
+    if (dropSampling) {
+      return;
+    }
+
+    if (DyFM_notNull(final?.temperature)) {
+      set.input.temperature = final.temperature;
+    }
+    if (DyFM_notNull(final?.topP)) {
+      set.input.top_p = final.topP;
+    }
+    if (DyFM_notNull(final?.frequencyPenalty)) {
+      set.input.frequency_penalty = final.frequencyPenalty;
+    }
+    if (DyFM_notNull(final?.presencePenalty)) {
+      set.input.presence_penalty = final.presencePenalty;
+    }
+  }
+
   //#endregion
 
 //  async askJSONListQuestion(

package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts

@@ -1,6 +1,6 @@
 import { DyNTS_AI_EmbeddingProvider_Registry } from './ai-embedding-provider.registry';
 import { DyNTS_LMStudio_Embedding_ControlService } from './lmstudio-embedding.control-service';
-import { DyNTS_AI_Embedding_MockService } from './ai-embedding-mock.service';
+import { DyNTS_AI_Embedding_MockService } from '../_modules/ai-mock/_services/ai-embedding-mock.service';
 import { DyNTS_OAI_Embedding_ControlService } from '../_modules/open-ai/_services/oai-embedding.control-service';
 
 describe('| DyNTS_AI_EmbeddingProvider_Registry', () => {

package/src/_modules/ai/_services/ai-embedding-provider.registry.ts

@@ -3,7 +3,7 @@ import { DyFM_OAI_Settings } from '@futdevpro/fsm-dynamo/ai/open-ai';
 import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 import { DyNTS_OAI_Embedding_ControlService } from '../_modules/open-ai/_services/oai-embedding.control-service';
 import { DyNTS_LMStudio_Embedding_ControlService, DyNTS_LMStudio_Embedding_Settings } from './lmstudio-embedding.control-service';
-import { DyNTS_AI_Embedding_MockService, DyNTS_AI_Embedding_MockSettings } from './ai-embedding-mock.service';
+import { DyNTS_AI_Embedding_MockService, DyNTS_AI_Embedding_MockSettings } from '../_modules/ai-mock/_services/ai-embedding-mock.service';
 import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
 
 /**

package/src/_modules/ai/_services/ai-llm.service-base.reconciler.spec.ts

@@ -0,0 +1,133 @@
+import {
+  DyFM_AI_CallSettings,
+  DyFM_AI_ModelInfo,
+  DyFM_AI_ModelType,
+  DyFM_AI_Provider,
+} from '@futdevpro/fsm-dynamo/ai';
+
+import { DyNTS_AI_LLM_ServiceBase } from './ai-llm.service-base';
+
+/** Minden-false capability-blokk a teszt-registry bejegyzesekhez. */
+const NO_CAPS: any = {
+  functionCalling: false,
+  vision: false,
+  streaming: false,
+  jsonMode: false,
+  audioInput: false,
+  audioOutput: false,
+  imageGeneration: false,
+  embeddings: false,
+  adultContent: false,
+};
+
+/** Teszt-registry: egy schema-val rendelkezo es egy schema-mentes modell. */
+const TEST_REGISTRY: DyFM_AI_ModelInfo[] = [
+  {
+    id: 'schema-model',
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    capabilities: NO_CAPS,
+    settingsSchema: {
+      supported: ['maxTokens'],
+      unsupported: ['temperature', 'topP'],
+      extraParams: ['reasoningEffort'],
+      constraints: {
+        maxTokens: { min: 10, max: 100 },
+      },
+    },
+  },
+  {
+    id: 'plain-model',
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    capabilities: NO_CAPS,
+  },
+];
+
+class ReconcilerTestService extends DyNTS_AI_LLM_ServiceBase<DyFM_AI_CallSettings> {
+  readonly aiProvider: any = {} as any;
+  readonly capabilities: any = {} as any;
+  setup = (config: any): void => {};
+  testConnection = async (issuer: string): Promise<boolean> => true;
+
+  readonly defaultSettings: DyFM_AI_CallSettings = {
+    systemPrompt: 'Test',
+    useModel: 'schema-model',
+    debugLog: false,
+  };
+
+  readonly predefinedRequests = { yesNo: { upperCaseYes: 'YES' } };
+
+  requestSimpleMessage = async (set: any): Promise<string> => { return ''; };
+  requestYesNo = async (set: any): Promise<boolean> => { return false; };
+  requestPercentage = async (set: any): Promise<number> => { return 0; };
+  requestSelect = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestMultiselect = async <T>(set: any): Promise<T[] | { unparsableResult: string }> => { return []; };
+  requestJSON = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestJSONQuestionWithKeysDescription = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestJSONWithExactKeys = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestList = async <T>(set: any): Promise<T[] | { unparsableResult: string }> => { return []; };
+
+  protected override getModelRegistry(): DyFM_AI_ModelInfo[] {
+    return TEST_REGISTRY;
+  }
+
+  static getInstance(): ReconcilerTestService {
+    return ReconcilerTestService.getSingletonInstance();
+  }
+}
+
+describe('| DyNTS_AI_LLM_ServiceBase — FR-048 reconcileCallSettings', () => {
+  let service: ReconcilerTestService;
+
+  beforeEach(() => {
+    service = ReconcilerTestService.getInstance();
+  });
+
+  it('| dropolja az `unsupported` kulcsokat, a tobbit meghagyja', () => {
+    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', {
+      temperature: 0.7,
+      topP: 0.9,
+      maxTokens: 50,
+    });
+
+    expect(result.temperature).toBeUndefined();
+    expect(result.topP).toBeUndefined();
+    expect(result.maxTokens).toBe(50);
+  });
+
+  it('| NEM mutalja az eredeti settings-objektumot', () => {
+    const original: DyFM_AI_CallSettings = { temperature: 0.7, maxTokens: 50 };
+
+    (service as any).reconcileCallSettings('schema-model', original);
+
+    expect(original.temperature).toBe(0.7);
+  });
+
+  it('| clamp-eli a `constraints` min/max szerint', () => {
+    const tooHigh: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', { maxTokens: 500 });
+    const tooLow: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', { maxTokens: 1 });
+
+    expect(tooHigh.maxTokens).toBe(100);
+    expect(tooLow.maxTokens).toBe(10);
+  });
+
+  it('| schema-mentes modell → permisszi­v passthrough (non-breaking)', () => {
+    const input: DyFM_AI_CallSettings = { temperature: 0.7, topP: 0.9 };
+    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('plain-model', input);
+
+    expect(result).toBe(input);
+    expect(result.temperature).toBe(0.7);
+  });
+
+  it('| ismeretlen modell → permisszi­v passthrough (honesty, nem dob)', () => {
+    const input: DyFM_AI_CallSettings = { temperature: 0.7 };
+    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('nincs-ilyen-modell', input);
+
+    expect(result).toBe(input);
+  });
+
+  it('| undefined settings → valtozatlanul visszaadva', () => {
+    expect((service as any).reconcileCallSettings('schema-model', undefined)).toBeUndefined();
+  });
+});

package/src/_modules/ai/_services/ai-llm.service-base.ts

@@ -10,6 +10,8 @@ import {
   DyFM_AI_ToolHandlers,
   DyFM_AI_ModelInfo,
   DyFM_AI_ModelRegistry_Util,
+  DyFM_AI_ModelSettingsSchema,
+  DyFM_AI_SettingConstraint,
 } from '@futdevpro/fsm-dynamo/ai';
 import { DyFM_Error, DyFM_Error_Settings, DyFM_getLocalStackLocation, DyFM_Log, DyFM_Object } from '@futdevpro/fsm-dynamo';
 import {
@@ -82,6 +84,84 @@ export abstract class DyNTS_AI_LLM_ServiceBase<
     }
   }
 
+  //////////////////////////////////////////////////////////////////////////////////////////
+                    // PER-MODEL SETTINGS RECONCILER — FR-048 //
+  //////////////////////////////////////////////////////////////////////////////////////////
+
+  /**
+   * FR-048 reconciler — a resolved modell `settingsSchema`-ja szerint egyezteti a call-settings-et a
+   * tenyleges provider-hivas ELOTT: DROPolja az `unsupported` kulcsokat (debug-log, SOHA nem csendben),
+   * CLAMP-eli a `constraints` (min/max) szerint. Ismeretlen modell / schema-mentes registry-bejegyzes →
+   * permisszi­v passthrough + log (best-effort, honesty).
+   *
+   * Ezzel altalanosul a FR-047 Phase-4 lokalis param-drop (Anthropic Opus 4.7+ temperature/topP/topK) es a
+   * FR-047 `isReasoningModel` sampling-drop: a tudas mostantol a registry `settingsSchema`-jaban (SSoT) el,
+   * nem provider-translator-onkent duplikalva.
+   *
+   * NON-BREAKING: ha a registry ures vagy a modellnek nincs schemaja, a bemenet valtozatlanul ter vissza —
+   * igy a meglevo providerek viselkedese nem valtozik, amig a schema nincs feltoltve.
+   * @param modelId - a feloldott modell azonositoja
+   * @param settings - a hivas-settings (opcionalis)
+   */
+  protected reconcileCallSettings(modelId: string, settings?: T_AISettings): T_AISettings {
+    if (!settings) {
+      return settings;
+    }
+
+    const modelInfo: DyFM_AI_ModelInfo = DyFM_AI_ModelRegistry_Util.findModelInfo(this.getModelRegistry(), modelId);
+    const schema: DyFM_AI_ModelSettingsSchema = modelInfo?.settingsSchema;
+
+    if (!schema) {
+      if (this.debugLog) {
+        DyFM_Log.info(`[FR-048] no settingsSchema for '${modelId}' — passthrough (best-effort)`);
+      }
+
+      return settings;
+    }
+
+    const reconciled: T_AISettings = { ...settings };
+    // A generikus `T_AISettings` csak OLVASASRA indexelheto (TS2862), ezert a mutaciot egy nem-generikus
+    // aliason vegezzuk — UGYANARRA az objektumra mutat, igy cast nelkul is tipus-helyes marad.
+    const mutable: Record<string, unknown> = reconciled;
+
+    for (const key of schema.unsupported ?? []) {
+      if (mutable[key] !== undefined) {
+        if (this.debugLog) {
+          DyFM_Log.info(`[FR-048] drop unsupported '${key}' for model '${modelId}'`);
+        }
+        delete mutable[key];
+      }
+    }
+
+    const constraints: Record<string, DyFM_AI_SettingConstraint> = schema.constraints ?? {};
+
+    for (const key of Object.keys(constraints)) {
+      const constraint: DyFM_AI_SettingConstraint = constraints[key];
+      const value: unknown = mutable[key];
+
+      if (typeof value !== 'number') {
+        continue;
+      }
+
+      let next: number = value;
+
+      if (typeof constraint.min === 'number' && next < constraint.min) {
+        next = constraint.min;
+      }
+      if (typeof constraint.max === 'number' && next > constraint.max) {
+        next = constraint.max;
+      }
+      if (next !== value) {
+        if (this.debugLog) {
+          DyFM_Log.info(`[FR-048] clamp '${key}' ${value} → ${next} for model '${modelId}'`);
+        }
+        mutable[key] = next;
+      }
+    }
+
+    return reconciled;
+  }
+
   /**
    * GPT valasz Function Calling Agent Tool-okkal — provider-agnosztikus agent-loop.
    * @description A `tools` definiciok + `toolHandlers` alapjan tool-loop-ot futtat: hivja a

package/src/_modules/ai/index.ts

@@ -10,6 +10,12 @@ export * from './_models/ai-test-generation-result.interface';
 export * from './_models/interfaces/dynts-ai-cost-event.interface';
 export * from './_models/interfaces/dynts-ai-cost-event-callback.interface';
 
+// FR-048 per-model settings — provider-faithful hiba-alak + validate-mode (production pre-validation).
+// A reconciler (`DyNTS_AI_LLM_ServiceBase.reconcileCallSettings`) testvére: UGYANAZ a `settingsSchema` forrás.
+export * from './_models/interfaces/dynts-ai-provider-error.interface';
+export * from './_collections/ai-provider-error.util';
+export * from './_collections/ai-model-config-validator.util';
+
 // Abstract Services
 export * from './_services/ai-provider.service-base';
 export * from './_services/ai-llm.service-base';
@@ -19,5 +25,9 @@ export * from './_services/ai-user-key.service-base';
 
 // Concrete Embedding Services + provider-dispatch (BFR-AM-002 / 007 / 008)
 export * from './_services/lmstudio-embedding.control-service';
-export * from './_services/ai-embedding-mock.service';
 export * from './_services/ai-embedding-provider.registry';
+
+// BACKWARD-COMPAT (MP-5 SP-5.1): a determinisztikus embedding-mock FIZIKAILAG az `ai-mock` submodulba
+// koltozott (`./_modules/ai-mock/_services/`), de a `@futdevpro/nts-dynamo/ai` import-utvonal VALTOZATLAN —
+// a meglevo consumer (FAM `EMBEDDING_PROVIDER=mock`) nem torik. Uj kod inkabb `@futdevpro/nts-dynamo/ai/ai-mock`.
+export * from './_modules/ai-mock/_services/ai-embedding-mock.service';

package/src/_modules/server/server-status/server-status.control-service.spec.ts

@@ -529,6 +529,46 @@ describe('| DyNTS_ServerStatus_ControlService', () => {
       expect(result.dbPingOk).toBe(false);
     });
 
+    // DIAGNOSZTIKA (2026-07-22) — a "readiness 503, de az app kiszolgál" flotta-lelet miatt.
+    // A lényeg: a diag-mezők akkor is kitöltődnek, amikor a probe NEM-ready-t jelent — épp AKKOR
+    // kellenek, hogy a következő mérés eldöntse, a probe mér-e rosszul vagy a DB halott-e.
+    it('| should populate diagnostics fields EVEN when not ready (this is when they matter)', async () => {
+      const fakeConnection = {
+        readyState: 0,
+        db: undefined,
+        host: 'mongodb',
+        name: 'adventor',
+        models: { user: {}, preset: {} },
+      };
+      spyOn(service as any, 'getMongooseConnection').and.returnValue(fakeConnection);
+
+      const result = await service.checkDbReadiness();
+
+      expect(result.ready).toBe(false);
+      expect(result.dbHost).toBe('mongodb');
+      expect(result.dbName).toBe('adventor');
+      // 0 model a default connectionön = a data-layer NEM ezt a handle-t használja (a fő gyanú)
+      expect(result.dbModelCount).toBe(2);
+      expect(result.dbConnectionCount).toEqual(jasmine.any(Number));
+      expect(result.dbOtherReadyStates).toEqual(jasmine.any(Array));
+    });
+
+    it('| should stay ready even if diagnostics collection throws (probe must never fail)', async () => {
+      // a diag-gyűjtés SAJÁT try-ban van → a getter-robbanás nem ronthatja el a readiness-választ
+      const fakeConnection = {
+        readyState: 1,
+        db: { admin: () => ({ ping: async () => ({ ok: 1 }) }) },
+        get host(): string { throw new Error('diag boom'); },
+      };
+      spyOn(service as any, 'getMongooseConnection').and.returnValue(fakeConnection);
+
+      const result = await service.checkDbReadiness();
+
+      expect(result.ready).toBe(true);
+      expect(result.dbReadyState).toBe(1);
+      expect(result.dbPingOk).toBe(true);
+    });
+
     it('| should NOT be ready when connected but ping fails (DB unresponsive)', async () => {
       const fakeConnection = {
         readyState: 1,

package/src/_modules/server/server-status/server-status.control-service.ts

@@ -44,6 +44,24 @@ export interface DyNTS_DbReadiness {
   serverVersion: string;
   /** AZ APP saját verziója (`DyNTS_global_settings.systemVersion`) — deploy-verifikációhoz. */
   appVersion?: string;
+
+  // --- DIAGNOSZTIKA (2026-07-22) — a flotta-szintű "readiness 503, de az app kiszolgál" lelet miatt ---
+  // Élesben mérve: az adventor / token-service / master-prompter MIND `dbReadyState:0`-t adott, miközben
+  // kiszolgáltak, a Mongo bizonyítottan élt, és a reconnect-guard (amely UGYANEZT a readyState-et olvassa)
+  // egyetlen warningot sem logolt. Öt hipotézist zártunk ki méréssel (több replika · két mongoose-példány ·
+  // esModule default-export · leszármazott-override · halott DB) — a gyökér-ok NEM dőlt el. Ezek a mezők
+  // teszik a KÖVETKEZŐ mérést döntővé, találgatás nélkül. Mind ADDITÍV + opcionális → nem törnek meg semmit.
+
+  /** Hány mongoose-connection létezik ebben a process-ben (`mongoose.connections.length`). >1 → nem a default-on megy a data-layer. */
+  dbConnectionCount?: number;
+  /** A default connection cél-hosztja (`connection.host`) — üres/undefined, ha a connect sosem futott le rajta. */
+  dbHost?: string;
+  /** A default connection adatbázis-neve (`connection.name`). */
+  dbName?: string;
+  /** Hány model van a default connectionre regisztrálva. 0 → a data-layer NEM ezt a connectiont használja. */
+  dbModelCount?: number;
+  /** A NEM-default connectionök readyState-jei — ha itt van 1-es, a probe rossz handle-t mér. */
+  dbOtherReadyStates?: number[];
 }
 
 export abstract class DyNTS_ServerStatus_ControlService<
@@ -232,6 +250,27 @@ export abstract class DyNTS_ServerStatus_ControlService<
       dbPingOk = false;
     }
 
+    // DIAGNOSZTIKA (2026-07-22): sosem dobhat — a probe-nak determinisztikusan kell válaszolnia,
+    // ezért a diag-gyűjtés SAJÁT try-ban van (ha bármelyik mező kiolvasása elszáll, a readiness
+    // válasz attól még ép marad).
+    let diagnostics: Partial<DyNTS_DbReadiness> = {};
+    try {
+      const conn: mongoose.Connection = this.getMongooseConnection();
+      const all: mongoose.Connection[] = mongoose.connections ?? [];
+
+      diagnostics = {
+        dbConnectionCount: all.length,
+        dbHost: conn?.host,
+        dbName: conn?.name,
+        dbModelCount: Object.keys(conn?.models ?? {}).length,
+        // a default connectiont kihagyjuk — csak a "van-e MÁSIK, élő handle" kérdés érdekes
+        dbOtherReadyStates: all.filter((c: mongoose.Connection): boolean => c !== conn)
+          .map((c: mongoose.Connection): number => c?.readyState ?? -1),
+      };
+    } catch (error) {
+      DyFM_Log.warn('(checkDbReadiness) diagnostics collection failed (non-fatal)', error);
+    }
+
     return {
       ready: dbReadyState === 1 && dbPingOk,
       dbReadyState: dbReadyState,
@@ -239,6 +278,7 @@ export abstract class DyNTS_ServerStatus_ControlService<
       uptime: +new Date() - +this.up,
       serverVersion: this.serverVersion,
       appVersion: this.appVersion,
+      ...diagnostics,
     };
   }
 

package/build/_modules/ai/_services/ai-embedding-mock.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-embedding-mock.service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-mock.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAE7E,2GAA2G;AAC3G,eAAO,MAAM,4BAA4B,EAAE,MAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,8BAA+B,SAAQ,8BAA8B;IAEhF,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAA4B;IAEjE,8FAA8F;IAC9F,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAU;IAEjD,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAWjD;IAEF,oCAAoC;IACpC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IAEvB,gDAAgD;gBACpC,GAAG,CAAC,EAAE,+BAA+B;IASjD,wGAAwG;IACxG,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAQnC;;;OAGG;IACG,eAAe,CACnB,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,GAAG,uBAAuB,CAAC;IAc9C;;;OAGG;IACG,gBAAgB,CACpB,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,uBAAuB,CAAC;IAehD,4EAA4E;IAC5E,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB;IAOvD,qDAAqD;IAC/C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvD;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAerD,wFAAwF;IACxF,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAejD,gFAAgF;IAChF,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,uBAAuB;IAclG,wFAAwF;IACxF,SAAS,CAAC,iBAAiB,CACzB,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,EAChD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI;IAkBP,mDAAmD;IACnD,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;CASlD"}

package/build/_modules/ai/_services/ai-embedding-mock.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-embedding-mock.service.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-mock.service.ts"],"names":[],"mappings":"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"}