@futdevpro/nts-dynamo 1.15.107 → 1.15.111

package/scripts/_seed-out/aim-seed.fixtures.ts

@@ -0,0 +1,161 @@
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+
+/**
+ * Valodi AI-generalasbol beegetve (live capture 2026-07-21). Kezzel NE szerkeszd.
+ *
+ * Determinisztikus sorrend (match-kulcs szerint) + rendezett objektum-kulcsok, hogy az ujra-generalas
+ * ne okozzon zajos diff-et. Forras: `DyNTS_AIMock_FixtureSerializer_Util`.
+ */
+export const DyNTS_AIMock_TextFixtures: DyNTS_AIMock_Fixture[] = [
+  {
+    "capturedAt": "2026-07-22T00:58:38.792Z",
+    "config": {
+      "temperature": 0
+    },
+    "input": "Reply with exactly: PONG",
+    "inputHash": "0fb5aed1b51b28b04409b7963b2453fe1597d198c3b8396fc8ebd072104511de",
+    "modality": "text",
+    "model": "gpt-4o-mini",
+    "output": {
+      "content": "PONG",
+      "finish_reason": "stop",
+      "usage": {
+        "completion_tokens": 2,
+        "completion_tokens_details": {
+          "accepted_prediction_tokens": 0,
+          "audio_tokens": 0,
+          "reasoning_tokens": 0,
+          "rejected_prediction_tokens": 0
+        },
+        "prompt_tokens": 13,
+        "prompt_tokens_details": {
+          "audio_tokens": 0,
+          "cached_tokens": 0
+        },
+        "total_tokens": 15
+      }
+    },
+    "provider": "open-ai",
+    "sourceModel": "gpt-4o-mini"
+  },
+  {
+    "capturedAt": "2026-07-22T00:58:37.828Z",
+    "config": {
+      "temperature": 0
+    },
+    "input": "Reply with exactly: PONG",
+    "inputHash": "0fb5aed1b51b28b04409b7963b2453fe1597d198c3b8396fc8ebd072104511de",
+    "modality": "text",
+    "model": "gpt-5.4-nano",
+    "output": {
+      "content": "PONG",
+      "finish_reason": "stop",
+      "usage": {
+        "completion_tokens": 5,
+        "completion_tokens_details": {
+          "accepted_prediction_tokens": 0,
+          "audio_tokens": 0,
+          "reasoning_tokens": 0,
+          "rejected_prediction_tokens": 0
+        },
+        "prompt_tokens": 12,
+        "prompt_tokens_details": {
+          "audio_tokens": 0,
+          "cached_tokens": 0
+        },
+        "total_tokens": 17
+      }
+    },
+    "provider": "open-ai",
+    "sourceModel": "gpt-5.4-nano"
+  },
+  {
+    "capturedAt": "2026-07-22T00:58:38.316Z",
+    "config": {
+      "temperature": 0
+    },
+    "input": "What is the capital of Hungary? One word.",
+    "inputHash": "85c5b3ea12c8e34d97a18cb75ae55936aeb2ef0af90eb2f395a44ace6ce997e8",
+    "modality": "text",
+    "model": "gpt-5.4-nano",
+    "output": {
+      "content": "Budapest",
+      "finish_reason": "stop",
+      "usage": {
+        "completion_tokens": 5,
+        "completion_tokens_details": {
+          "accepted_prediction_tokens": 0,
+          "audio_tokens": 0,
+          "reasoning_tokens": 0,
+          "rejected_prediction_tokens": 0
+        },
+        "prompt_tokens": 16,
+        "prompt_tokens_details": {
+          "audio_tokens": 0,
+          "cached_tokens": 0
+        },
+        "total_tokens": 21
+      }
+    },
+    "provider": "open-ai",
+    "sourceModel": "gpt-5.4-nano"
+  },
+  {
+    "capturedAt": "2026-07-22T00:58:39.151Z",
+    "config": {},
+    "input": "artificial intelligence",
+    "inputHash": "803b3eb2b6af027151950019f2d5ede506a6636a9eafd262b27c23e3f834056f",
+    "modality": "embedding",
+    "model": "text-embedding-3-small",
+    "output": {
+      "dimensions": 1536,
+      "embeddingHead": [
+        0.0005774497985839844,
+        -0.012481689453125,
+        -0.01143646240234375,
+        -0.0247344970703125,
+        0.011383056640625,
+        -0.006069183349609375,
+        -0.0209503173828125,
+        0.03741455078125
+      ],
+      "model": "text-embedding-3-small",
+      "object": "list",
+      "usage": {
+        "prompt_tokens": 3,
+        "total_tokens": 3
+      }
+    },
+    "provider": "open-ai",
+    "sourceModel": "text-embedding-3-small"
+  },
+  {
+    "capturedAt": "2026-07-22T00:58:39.020Z",
+    "config": {},
+    "input": "the quick brown fox",
+    "inputHash": "9ecb36561341d18eb65484e833efea61edc74b84cf5e6ae1b81c63533e25fc8f",
+    "modality": "embedding",
+    "model": "text-embedding-3-small",
+    "output": {
+      "dimensions": 1536,
+      "embeddingHead": [
+        -0.033355712890625,
+        -0.00183868408203125,
+        0.005237579345703125,
+        -0.06304931640625,
+        -0.04779052734375,
+        0.0018625259399414062,
+        0.016876220703125,
+        0.034820556640625
+      ],
+      "model": "text-embedding-3-small",
+      "object": "list",
+      "usage": {
+        "prompt_tokens": 4,
+        "total_tokens": 4
+      }
+    },
+    "provider": "open-ai",
+    "sourceModel": "text-embedding-3-small"
+  }
+];

package/scripts/_seed-out/seed-raw.json

@@ -0,0 +1,153 @@
+[
+  {
+    "provider": "open-ai",
+    "model": "gpt-5.4-nano",
+    "modality": "text",
+    "config": {
+      "temperature": 0
+    },
+    "input": "Reply with exactly: PONG",
+    "inputHash": "0fb5aed1b51b28b04409b7963b2453fe1597d198c3b8396fc8ebd072104511de",
+    "output": {
+      "content": "PONG",
+      "finish_reason": "stop",
+      "usage": {
+        "prompt_tokens": 12,
+        "completion_tokens": 5,
+        "total_tokens": 17,
+        "prompt_tokens_details": {
+          "cached_tokens": 0,
+          "audio_tokens": 0
+        },
+        "completion_tokens_details": {
+          "reasoning_tokens": 0,
+          "audio_tokens": 0,
+          "accepted_prediction_tokens": 0,
+          "rejected_prediction_tokens": 0
+        }
+      }
+    },
+    "capturedAt": "2026-07-22T00:58:37.828Z",
+    "sourceModel": "gpt-5.4-nano"
+  },
+  {
+    "provider": "open-ai",
+    "model": "gpt-5.4-nano",
+    "modality": "text",
+    "config": {
+      "temperature": 0
+    },
+    "input": "What is the capital of Hungary? One word.",
+    "inputHash": "85c5b3ea12c8e34d97a18cb75ae55936aeb2ef0af90eb2f395a44ace6ce997e8",
+    "output": {
+      "content": "Budapest",
+      "finish_reason": "stop",
+      "usage": {
+        "prompt_tokens": 16,
+        "completion_tokens": 5,
+        "total_tokens": 21,
+        "prompt_tokens_details": {
+          "cached_tokens": 0,
+          "audio_tokens": 0
+        },
+        "completion_tokens_details": {
+          "reasoning_tokens": 0,
+          "audio_tokens": 0,
+          "accepted_prediction_tokens": 0,
+          "rejected_prediction_tokens": 0
+        }
+      }
+    },
+    "capturedAt": "2026-07-22T00:58:38.316Z",
+    "sourceModel": "gpt-5.4-nano"
+  },
+  {
+    "provider": "open-ai",
+    "model": "gpt-4o-mini",
+    "modality": "text",
+    "config": {
+      "temperature": 0
+    },
+    "input": "Reply with exactly: PONG",
+    "inputHash": "0fb5aed1b51b28b04409b7963b2453fe1597d198c3b8396fc8ebd072104511de",
+    "output": {
+      "content": "PONG",
+      "finish_reason": "stop",
+      "usage": {
+        "prompt_tokens": 13,
+        "completion_tokens": 2,
+        "total_tokens": 15,
+        "prompt_tokens_details": {
+          "cached_tokens": 0,
+          "audio_tokens": 0
+        },
+        "completion_tokens_details": {
+          "reasoning_tokens": 0,
+          "audio_tokens": 0,
+          "accepted_prediction_tokens": 0,
+          "rejected_prediction_tokens": 0
+        }
+      }
+    },
+    "capturedAt": "2026-07-22T00:58:38.792Z",
+    "sourceModel": "gpt-4o-mini"
+  },
+  {
+    "provider": "open-ai",
+    "model": "text-embedding-3-small",
+    "modality": "embedding",
+    "config": {},
+    "input": "the quick brown fox",
+    "inputHash": "9ecb36561341d18eb65484e833efea61edc74b84cf5e6ae1b81c63533e25fc8f",
+    "output": {
+      "object": "list",
+      "model": "text-embedding-3-small",
+      "dimensions": 1536,
+      "embeddingHead": [
+        -0.033355712890625,
+        -0.00183868408203125,
+        0.005237579345703125,
+        -0.06304931640625,
+        -0.04779052734375,
+        0.0018625259399414062,
+        0.016876220703125,
+        0.034820556640625
+      ],
+      "usage": {
+        "prompt_tokens": 4,
+        "total_tokens": 4
+      }
+    },
+    "capturedAt": "2026-07-22T00:58:39.020Z",
+    "sourceModel": "text-embedding-3-small"
+  },
+  {
+    "provider": "open-ai",
+    "model": "text-embedding-3-small",
+    "modality": "embedding",
+    "config": {},
+    "input": "artificial intelligence",
+    "inputHash": "803b3eb2b6af027151950019f2d5ede506a6636a9eafd262b27c23e3f834056f",
+    "output": {
+      "object": "list",
+      "model": "text-embedding-3-small",
+      "dimensions": 1536,
+      "embeddingHead": [
+        0.0005774497985839844,
+        -0.012481689453125,
+        -0.01143646240234375,
+        -0.0247344970703125,
+        0.011383056640625,
+        -0.006069183349609375,
+        -0.0209503173828125,
+        0.03741455078125
+      ],
+      "usage": {
+        "prompt_tokens": 3,
+        "total_tokens": 3
+      }
+    },
+    "capturedAt": "2026-07-22T00:58:39.151Z",
+    "sourceModel": "text-embedding-3-small"
+  }
+]

package/scripts/ai-fixture-seed.js

@@ -0,0 +1,126 @@
+/**
+ * FIZETOS fixture-seed (MP-3 SP-3.3) — a VALODI `DyNTS_AIMock_FixtureHarness_Service`-en es a
+ * `DyNTS_AIMock_FixtureSerializer_Util`-on keresztul, hogy a sajat kodutunkat is bizonyitsa (dogfooding).
+ *
+ * ⚠️ EZ PENZT KOLT. Szandekosan KICSI es KORLATOZOTT:
+ *  - csak a legolcsobb engedett modellek (`gpt-5.4-nano` text, `text-embedding-3-small` embedding)
+ *  - rovid promptok + szuk `max_completion_tokens`
+ *  - kep-generalas NINCS (kulon dontes targya)
+ *  - MINDEN fixture AZONNAL lemezre irodik (runbook §2c) — kvota-kifogyas nem viszi el az addigi munkat
+ *  - 429 eseten az adott provider leall, a tobbi megy tovabb
+ *  - a futas vegen kiirja a TENYLEGES token-fogyast
+ *
+ * Futtatas:  node scripts/ai-fixture-seed.js
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const ENV_PATH = path.resolve(__dirname, '../../../fdp-devops/.env');
+const AIMOCK = path.resolve(__dirname, '../build/_modules/ai/_modules/ai-mock');
+const OUT_DIR = path.resolve(__dirname, '_seed-out');
+const RAW_FILE = path.join(OUT_DIR, 'seed-raw.json');
+
+const { DyNTS_AIMock_FixtureHarness_Service } = require(path.join(AIMOCK, '_services/aim-fixture-harness.service'));
+const { DyNTS_AIMock_FixtureSerializer_Util } = require(path.join(AIMOCK, '_collections/aim-fixture-serializer.util'));
+const { DyNTS_AIMock_Modality } = require(path.join(AIMOCK, '_enums/aim-modality.enum'));
+const { DyFM_OAI_Models } = require('@futdevpro/fsm-dynamo/ai/open-ai');
+
+function loadKey() {
+  for (const line of fs.readFileSync(ENV_PATH, 'utf8').split(/\r?\n/)) {
+    const m = line.match(/^OPENAI_API_KEY=(.*)$/);
+    if (m) { return m[1].trim().replace(/^["']|["']$/g, ''); }
+  }
+  return null;
+}
+
+const usage = { prompt: 0, completion: 0, calls: 0 };
+let quotaStop = false;
+
+/** VALODI generator — ez az egyetlen pont, ahol penz folyik. */
+function makeGenerator(key) {
+  return async (request) => {
+    if (request.modality === DyNTS_AIMock_Modality.embedding) {
+      const r = await fetch('https://api.openai.com/v1/embeddings', {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${key}`, 'content-type': 'application/json' },
+        body: JSON.stringify({ model: request.model, input: request.input, ...(request.config || {}) }),
+      });
+      if (r.status === 429) { quotaStop = true; throw new Error('429 quota'); }
+      const j = await r.json();
+      if (j.error) { throw new Error(j.error.message); }
+      usage.prompt += j.usage?.prompt_tokens || 0;
+      usage.calls++;
+      // a teljes vektor helyett a dimenziot + az elso 8 erteket orizzuk (a fixture-fajl maradjon kezelheto)
+      return { object: j.object, model: j.model, dimensions: j.data[0].embedding.length,
+        embeddingHead: j.data[0].embedding.slice(0, 8), usage: j.usage };
+    }
+
+    const r = await fetch('https://api.openai.com/v1/chat/completions', {
+      method: 'POST',
+      headers: { Authorization: `Bearer ${key}`, 'content-type': 'application/json' },
+      body: JSON.stringify({ model: request.model, messages: [ { role: 'user', content: request.input } ],
+        max_completion_tokens: 64, ...(request.config || {}) }),
+    });
+    if (r.status === 429) { quotaStop = true; throw new Error('429 quota'); }
+    const j = await r.json();
+    if (j.error) { throw new Error(j.error.message); }
+    usage.prompt += j.usage?.prompt_tokens || 0;
+    usage.completion += j.usage?.completion_tokens || 0;
+    usage.calls++;
+    return { content: j.choices[0].message.content, finish_reason: j.choices[0].finish_reason, usage: j.usage };
+  };
+}
+
+const SEED = [
+  { model: 'gpt-5.4-nano', modality: DyNTS_AIMock_Modality.text, config: { temperature: 0 }, input: 'Reply with exactly: PONG' },
+  { model: 'gpt-5.4-nano', modality: DyNTS_AIMock_Modality.text, config: { temperature: 0 }, input: 'What is the capital of Hungary? One word.' },
+  { model: 'gpt-4o-mini', modality: DyNTS_AIMock_Modality.text, config: { temperature: 0 }, input: 'Reply with exactly: PONG' },
+  { model: 'text-embedding-3-small', modality: DyNTS_AIMock_Modality.embedding, config: {}, input: 'the quick brown fox' },
+  { model: 'text-embedding-3-small', modality: DyNTS_AIMock_Modality.embedding, config: {}, input: 'artificial intelligence' },
+];
+
+(async () => {
+  const key = loadKey();
+  if (!key) { console.error('OPENAI_API_KEY hianyzik'); process.exit(1); }
+
+  const harness = new DyNTS_AIMock_FixtureHarness_Service({
+    generator: makeGenerator(key),
+    registry: DyFM_OAI_Models,
+    allowRealSpend: true,        // ⚠️ JOVAHAGYOTT futas (G1). Alapertelmezesben ez false.
+  });
+
+  fs.mkdirSync(OUT_DIR, { recursive: true });
+  const fixtures = [];
+
+  console.log('FIZETOS seed — kicsi es korlatozott, fixture-onkent lemezre irva\n');
+
+  for (const s of SEED) {
+    if (quotaStop) { console.log(`  KIHAGYVA (kvota): ${s.model} / ${s.input.slice(0, 30)}`); continue; }
+    try {
+      const f = await harness.capture({ provider: 'open-ai', model: s.model, modality: s.modality,
+        config: s.config, input: s.input });
+      fixtures.push(f);
+      fs.writeFileSync(RAW_FILE, JSON.stringify(fixtures, null, 2));   // INKREMENTALIS
+      console.log(`  ✅ ${s.model} [${s.modality}] "${s.input.slice(0, 32)}"`);
+    } catch (e) {
+      console.log(`  ❌ ${s.model}: ${e.message.slice(0, 90)}`);
+    }
+  }
+
+  if (fixtures.length) {
+    const src = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
+      constName: 'DyNTS_AIMock_TextFixtures', fixtures, importPath: '../_models/interfaces/aim-fixture.interface',
+      headerNote: 'Valodi AI-generalasbol beegetve (live capture 2026-07-21). Kezzel NE szerkeszd.',
+    });
+    const again = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
+      constName: 'DyNTS_AIMock_TextFixtures', fixtures, importPath: '../_models/interfaces/aim-fixture.interface',
+      headerNote: 'Valodi AI-generalasbol beegetve (live capture 2026-07-21). Kezzel NE szerkeszd.',
+    });
+    fs.writeFileSync(path.join(OUT_DIR, 'aim-seed.fixtures.ts'), src);
+    console.log(`\n  determinizmus (ketszer szerializalva byte-azonos): ${src === again ? '✅ IGEN' : '❌ NEM'}`);
+  }
+
+  console.log(`\n📊 TENYLEGES fogyas: ${usage.calls} hivas · prompt ${usage.prompt} token · completion ${usage.completion} token`);
+  console.log(`   ${fixtures.length} fixture → ${OUT_DIR}`);
+})();

package/src/_modules/ai/_collections/ai-provider-error.util.ts

@@ -34,8 +34,14 @@ export class DyNTS_AI_ProviderError_Util {
           type: 'error',
           error: {
             type: 'invalid_request_error',
-            message: `${set.param}: Extra inputs are not permitted for model '${set.model}'.`,
+            // MERT (capture 2026-07-21, claude-opus-4-8 + temperature): a valodi uzenet ez, NEM a korabbi
+            // kozelitesem ("Extra inputs are not permitted").
+            message: `\`${set.param}\` is deprecated for this model.`,
           },
+          // VERIFIED (capture 2026-07-21): a valodi Anthropic hiba-body TOP-LEVEL `request_id`-t is hoz —
+          // ez korabban hianyzott a sablonbol. Fixture-oknel a rogzitett valodi ertek szerepel; itt
+          // szintetikus placeholder, hogy az ALAK hu legyen.
+          request_id: 'req_mock',
         },
         reason: `invalid_request_error:${set.param}`,
       };
@@ -82,17 +88,57 @@ export class DyNTS_AI_ProviderError_Util {
       };
     }
 
+    // MERT (capture 2026-07-21, gpt-4o-mini + temperature: 3): a valodi OpenAI range-hiba kodja
+    // `decimal_above_max_value`, NEM az altalam felteteleztt `invalid_value`, es a message formatuma ez:
+    //   "Invalid 'temperature': decimal above maximum value. Expected a value <= 2, but got 3 instead."
     return {
       httpStatus: 400,
       providerErrorBody: {
         error: {
-          message: `Invalid value for '${set.param}': ${set.detail} (model '${set.model}').`,
+          message: `Invalid '${set.param}': ${set.detail}.`,
           type: 'invalid_request_error',
           param: set.param,
-          code: 'invalid_value',
+          code: 'decimal_above_max_value',
         },
       },
       reason: `invalid_value:${set.param}`,
     };
   }
+
+  /**
+   * Ismeretlen modell → **HTTP 404** (NEM 400), `code: 'model_not_found'`.
+   * MERT (capture 2026-07-21): `The model \`X\` does not exist or you do not have access to it.`
+   * @param set - provider + a nem letezo modell-azonosito
+   */
+  static buildModelNotFoundError(
+    set: {
+      provider: string,
+      model: string,
+    }
+  ): DyNTS_AI_ProviderError {
+    if (set.provider === this.anthropicProviderId) {
+      return {
+        httpStatus: 404,
+        providerErrorBody: {
+          type: 'error',
+          error: { type: 'not_found_error', message: `model: ${set.model}` },
+          request_id: 'req_mock',
+        },
+        reason: `not_found_error:${set.model}`,
+      };
+    }
+
+    return {
+      httpStatus: 404,
+      providerErrorBody: {
+        error: {
+          message: `The model \`${set.model}\` does not exist or you do not have access to it.`,
+          type: 'invalid_request_error',
+          param: null,
+          code: 'model_not_found',
+        },
+      },
+      reason: `model_not_found:${set.model}`,
+    };
+  }
 }

package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts

@@ -22,6 +22,14 @@ export class DyNTS_AIMock_FixtureSerializer_Util {
       constName: string,
       fixtures: DyNTS_AIMock_Fixture[],
       headerNote?: string,
+      /**
+       * A generalt fajl import-utvonala a `DyNTS_AIMock_Fixture` tipushoz.
+       *
+       * Default a publikus package-utvonal (KULSO consumer fixture-fajljaihoz). **A csomagon BELULRE**
+       * kerulo fixture-oknel relativ utat kell adni (pl. `'../_models/interfaces/aim-fixture.interface'`),
+       * kulonben a fajl onmagara hivatkozna a package-nevvel, ami build-kor nem oldodik fel.
+       */
+      importPath?: string,
     }
   ): string {
     const sorted: DyNTS_AIMock_Fixture[] = this.sortFixtures(set.fixtures);
@@ -31,8 +39,10 @@ export class DyNTS_AIMock_FixtureSerializer_Util {
 
     const note: string = set.headerNote ?? 'Auto-generalt fixture-keszlet — kezzel NE szerkeszd.';
 
+    const importPath: string = set.importPath ?? '@futdevpro/nts-dynamo/ai/ai-mock';
+
     return [
-      `import { DyNTS_AIMock_Fixture } from '@futdevpro/nts-dynamo/ai/ai-mock';`,
+      `import { DyNTS_AIMock_Fixture } from '${importPath}';`,
       '',
       '/**',
       ` * ${note}`,

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

@@ -706,9 +706,19 @@ 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);

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,
     };
   }