@futdevpro/nts-dynamo 1.15.126 → 1.15.128

package/build/_services/core/request-hunter.service.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_RequestHunter = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+/**
+ * ISSUE-HUNTER: **melyik keres blokkolta az event-loopot?**
+ *
+ * ⚠️ MIERT KELLETT (mert incidens, overseer 2026-08-05): az event-loop 10-15 masodpercre
+ * megallt (`DyNTS_EventLoopDiag`: elLag max 10058-14839 ms), a `MemoryGuard` es a healthcheck
+ * ONMAGABAN egyiket sem tudta MIHEZ kotni. A diagnozis igy a nyers log 4893 sorabol tortent,
+ * orak alatt — holott a dontő jel MINDOSSZE 4 sor volt benne. A hianyzo kepesseg nem a MERES
+ * volt (az megvolt), hanem az ATTRIBUCIO: *mi futott, amikor megallt?*
+ *
+ * Ez a service ezt potolja, KET fuggetlen jellel:
+ *
+ *  1. **Lassu-keres onjelentes (a fo jel).** Amikor egy keres BEFEJEZODIK, ha tovabb tartott a
+ *     kuszobnel, azonnal WARN-t ir a nevevel es az idejevel. A mai incidenst EZ egyetlen sorban
+ *     megadta volna: `[REQ-HUNTER] SLOW getCdpReportDetails 10240ms`.
+ *     ⚠️ Miert EZ a fo jel: a fagyas ALATT a diag-poll NEM fut (a loop all), tehat mire lefutna,
+ *     a bunos keres mar befejezodott — az "in-flight pillanatkep" onmagaban ELKESNE.
+ *
+ *  2. **In-flight pillanatkep (a masodik jel).** Azokra az esetekre, amikor a keres MEG MINDIG
+ *     fut (beragadt / vegtelen varakozas): a stall-detektor le tudja kerdezni, mi van eppen
+ *     folyamatban es mennyi ideje.
+ *
+ * KOLTSEG: egy `Map`-beszuras + `Date.now()` keresenkent. Elhanyagolhato; ezert
+ * alapertelmezetten BE van kapcsolva (a mai incidens tanulsaga: ami nincs bekapcsolva, az pont
+ * az incidens alatt nem all rendelkezesre).
+ *
+ * Settings (`DyNTS_global_settings.requestHunter`):
+ *   - `enabled?: boolean`        default true
+ *   - `slowRequestMs?: number`   default 1000 — e felett WARN a keres vegen
+ *   - `maxHistoryCount?: number` default 50 — a lassu-keres history merete
+ */
+class DyNTS_RequestHunter {
+    static instance;
+    static getInstance() {
+        if (!DyNTS_RequestHunter.instance) {
+            DyNTS_RequestHunter.instance = new DyNTS_RequestHunter();
+        }
+        return DyNTS_RequestHunter.instance;
+    }
+    nextId = 1;
+    inFlight = new Map();
+    slowHistory = [];
+    /** A settings-ertekek feloldasa (minden hivasnal, hogy a runtime-valtoztatas is hasson). */
+    getSettings() {
+        const s = global_settings_const_1.DyNTS_global_settings.requestHunter ?? {};
+        return {
+            enabled: s.enabled !== false,
+            slowRequestMs: typeof s.slowRequestMs === 'number' && s.slowRequestMs > 0 ? s.slowRequestMs : 1000,
+            maxHistoryCount: typeof s.maxHistoryCount === 'number' && s.maxHistoryCount > 0 ? s.maxHistoryCount : 50,
+        };
+    }
+    /**
+     * Keres kezdete. A visszaadott id-t az `end()`-nek kell atadni.
+     *
+     * @returns a keres id-ja, vagy 0 ha a hunter ki van kapcsolva (az `end(0)` no-op)
+     */
+    begin(label) {
+        if (!this.getSettings().enabled) {
+            return 0;
+        }
+        const id = this.nextId++;
+        this.inFlight.set(id, { label: label, startedAt: Date.now() });
+        return id;
+    }
+    /**
+     * Keres vege. Ha a kuszobnel tovabb tartott, WARN + bekerul a history-ba.
+     * Hibatur: ismeretlen / 0 id eseten no-op.
+     */
+    end(id) {
+        if (!id) {
+            return;
+        }
+        const entry = this.inFlight.get(id);
+        if (!entry) {
+            return;
+        }
+        this.inFlight.delete(id);
+        const settings = this.getSettings();
+        const durationMs = Date.now() - entry.startedAt;
+        if (durationMs < settings.slowRequestMs) {
+            return;
+        }
+        this.slowHistory.push({ at: Date.now(), label: entry.label, durationMs: durationMs });
+        if (this.slowHistory.length > settings.maxHistoryCount) {
+            this.slowHistory = this.slowHistory.slice(-settings.maxHistoryCount);
+        }
+        fsm_dynamo_1.DyFM_Log.warn(`[REQ-HUNTER] SLOW ${entry.label} ${durationMs}ms`
+            + (this.inFlight.size ? ` (kozben ${this.inFlight.size} masik keres is futott)` : ''));
+    }
+    /** Az EPPEN futo keresek — a stall-detektor ebbol tudja, mi ragadt be. */
+    getInFlight(now = Date.now()) {
+        const out = [];
+        for (const entry of this.inFlight.values()) {
+            out.push({ label: entry.label, ageMs: now - entry.startedAt });
+        }
+        return out.sort((a, b) => b.ageMs - a.ageMs);
+    }
+    /** A kozelmult lassu keresei (gorgo history) — `/server/diag`-ba is kitehető. */
+    getSlowHistory() {
+        return [...this.slowHistory];
+    }
+    /**
+     * Ember-olvashato in-flight osszefoglalo a stall-loghoz.
+     * Ures listanal expliciten ezt mondja — mert az IS informacio: a blokkolo mar befejezodott,
+     * tehat a lassu-keres onjelentest (1. jel) kell nezni.
+     */
+    describeInFlight(now = Date.now()) {
+        const list = this.getInFlight(now);
+        if (!list.length) {
+            return 'nincs futo keres (a blokkolo mar befejezodott — lasd a [REQ-HUNTER] SLOW sorokat)';
+        }
+        return list
+            .slice(0, 5)
+            .map((r) => `${r.label} (${r.ageMs}ms)`)
+            .join(', ');
+    }
+}
+exports.DyNTS_RequestHunter = DyNTS_RequestHunter;
+//# sourceMappingURL=request-hunter.service.js.map

package/build/_services/core/request-hunter.service.js.map

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

package/build/index.d.ts

@@ -26,6 +26,7 @@ export * from './_collections/signed-url.util';
 export * from './_collections/client-safe-error.util';
 export * from './_collections/load-shed.util';
 export * from './_services/core/event-loop-diag.service';
+export * from './_services/core/request-hunter.service';
 export * from './_services/core/db-stats.service';
 export * from './_services/core/diagnostics.service';
 export * from './_models/control-models/api-call-params.control-model';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AAIrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAK7C,mEAAmE;AACnE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,yDAAyD,CAAC;AACxE,cAAc,uDAAuD,CAAC;AACtE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,iDAAiD,CAAC;AAChE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,wDAAwD,CAAC;AACvE,cAAc,gEAAgE,CAAA;AAC9E,cAAc,mDAAmD,CAAC;AAClE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,wDAAwD,CAAC;AACvE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AAGtE,cAAc,gCAAgC,CAAC;AAG/C,cAAc,mDAAmD,CAAC;AAKlE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oDAAoD,CAAC;AACnE,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC;AAG1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AAIrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAK7C,mEAAmE;AACnE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,yDAAyD,CAAC;AACxE,cAAc,uDAAuD,CAAC;AACtE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,iDAAiD,CAAC;AAChE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,wDAAwD,CAAC;AACvE,cAAc,gEAAgE,CAAA;AAC9E,cAAc,mDAAmD,CAAC;AAClE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,wDAAwD,CAAC;AACvE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AAGtE,cAAc,gCAAgC,CAAC;AAG/C,cAAc,mDAAmD,CAAC;AAKlE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oDAAoD,CAAC;AACnE,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC;AAG1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,mCAAmC,CAAC"}

package/build/index.js

@@ -55,6 +55,7 @@ tslib_1.__exportStar(require("./_collections/signed-url.util"), exports);
 tslib_1.__exportStar(require("./_collections/client-safe-error.util"), exports);
 tslib_1.__exportStar(require("./_collections/load-shed.util"), exports);
 tslib_1.__exportStar(require("./_services/core/event-loop-diag.service"), exports);
+tslib_1.__exportStar(require("./_services/core/request-hunter.service"), exports);
 tslib_1.__exportStar(require("./_services/core/db-stats.service"), exports);
 tslib_1.__exportStar(require("./_services/core/diagnostics.service"), exports);
 // models/CONTROL MODELS

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;IAsBI;;;AAEJ,cAAc;AACd,sEAA4C;AAC5C,wFAA8D;AAC9D,8FAAoE;AACpE,sFAA4D;AAC5D,mFAAyD;AACzD,uFAA6D;AAC7D,+EAAqD;AAGrD,QAAQ;AACR,wEAA8C;AAC9C,8EAAoD;AACpD,8EAAoD;AACpD,uEAA6C;AAG7C,6CAA6C;AAE7C,mEAAmE;AACnE,gGAAsE;AACtE,8FAAoE;AACpE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AACvE,kGAAwE;AACxE,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,0FAAgE;AAChE,yFAA+D;AAC/D,+EAAqD;AACrD,yEAA+C;AAC/C,gFAAsD;AACtD,wEAA8C;AAC9C,mFAAyD;AACzD,4EAAkD;AAClD,+EAAqD;AAErD,wBAAwB;AACxB,iGAAuE;AACvE,yGAA8E;AAC9E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AACf,yEAA+C;AAE/C,qBAAqB;AACrB,4FAAkE;AAGlE,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAE9C,yEAA+C;AAC/C,6FAAmE;AACnE,0EAAgD;AAChD,gFAAsD;AAEtD,sFAA4D;AAC5D,oFAA0D;AAE1D,gBAAgB;AAChB,4EAAkD;AAClD,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,kFAAwD;AACxD,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAE9C,iBAAiB;AACjB,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;IAsBI;;;AAEJ,cAAc;AACd,sEAA4C;AAC5C,wFAA8D;AAC9D,8FAAoE;AACpE,sFAA4D;AAC5D,mFAAyD;AACzD,uFAA6D;AAC7D,+EAAqD;AAGrD,QAAQ;AACR,wEAA8C;AAC9C,8EAAoD;AACpD,8EAAoD;AACpD,uEAA6C;AAG7C,6CAA6C;AAE7C,mEAAmE;AACnE,gGAAsE;AACtE,8FAAoE;AACpE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AACvE,kGAAwE;AACxE,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,0FAAgE;AAChE,yFAA+D;AAC/D,+EAAqD;AACrD,yEAA+C;AAC/C,gFAAsD;AACtD,wEAA8C;AAC9C,mFAAyD;AACzD,kFAAwD;AACxD,4EAAkD;AAClD,+EAAqD;AAErD,wBAAwB;AACxB,iGAAuE;AACvE,yGAA8E;AAC9E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AACf,yEAA+C;AAE/C,qBAAqB;AACrB,4FAAkE;AAGlE,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAE9C,yEAA+C;AAC/C,6FAAmE;AACnE,0EAAgD;AAChD,gFAAsD;AAEtD,sFAA4D;AAC5D,oFAA0D;AAE1D,gBAAgB;AAChB,4EAAkD;AAClD,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,kFAAwD;AACxD,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAE9C,iBAAiB;AACjB,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.126",
+  "version": "01.15.128",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -378,7 +378,7 @@
     "@anthropic-ai/sdk": "~0.39.0",
     "@modelcontextprotocol/sdk": "~1.29.0",
     "better-sqlite3": "~12.4.1",
-    "@futdevpro/fsm-dynamo": "1.16.27",
+    "@futdevpro/fsm-dynamo": "1.16.30",
     "@types/express": "4.17.21",
     "@types/geoip-lite": "~1.4.1",
     "@types/node": "~24.1.0",

package/src/_models/control-models/endpoint-params.control-model.ts

@@ -10,6 +10,7 @@ import { DyNTS_global_settings } from '../../_collections/global-settings.const'
 import { DyNTS_ClientSafeError_Util } from '../../_collections/client-safe-error.util';
 import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
 import { DyNTS_GlobalService } from '../../_services/core/global.service';
+import { DyNTS_RequestHunter } from '../../_services/core/request-hunter.service';
 
 /**
  * High level endpoint for API
@@ -215,6 +216,11 @@ export class DyNTS_Endpoint_Params<
     let issuer: string;
 
     return async (req: Request, res: Response): Promise<void> => {
+      // ISSUE-HUNTER (2026-08-05) — keres-szintu attribucio. Ez a KOZPONTI vegrehajtasi pont,
+      // minden endpoint ezen megy at, ezert itt (es CSAK itt) merunk. Koltseg: egy Map-beszuras
+      // + Date.now(). A `finally` garantalja, hogy hiba/early-return eseten se szivarogjon be-
+      // jegyzes. Reszletes indoklas: `DyNTS_RequestHunter`.
+      const hunterId: number = DyNTS_RequestHunter.getInstance().begin(this.name);
       try {
         let issuer: string;
         try {
@@ -289,6 +295,8 @@ export class DyNTS_Endpoint_Params<
         }
       } catch (error) {
         this.error(req, res, error, issuer);
+      } finally {
+        DyNTS_RequestHunter.getInstance().end(hunterId);
       }
     };
   }

package/src/_modules/ai/_modules/ai-mock/index.ts

@@ -4,7 +4,7 @@
 // AI Mocking System — provider-faithful mock-service + fixture-store (Layer B) a valódi AI-hívások
 // kiváltására teszt/CI/lokál-fejlesztésben. A Layer A (per-model config-registry + validátor) a FR-048
 // (`DyFM_AI_ModelSettingsSchema` + reconciler) — az ai-mock azt FOGYASZTJA a provider-faithful
-// error-reprodukcióhoz. Terv: `documentations/plans/ai-mocking-system/HYPERPLAN.md`.
+// error-reprodukcióhoz. Terv: `fdp-documentations/plans/ai-mocking-system/HYPERPLAN.md`.
 //
 // SCAFFOLD (Cikl. 2, 2026-07-21): a modul-váz + a meglévő determinisztikus embedding-mock re-exportja.
 // A további szolgáltatások (fixture-store, mock-service, coverage) MP-3..MP-6 során kerülnek ide;

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

@@ -718,7 +718,7 @@ export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
    * 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.
+   * Reszletek: `fdp-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/_services/core/event-loop-diag.service.ts

@@ -3,6 +3,7 @@ import { monitorEventLoopDelay, IntervalHistogram } from 'perf_hooks';
 import { DyFM_Log } from '@futdevpro/fsm-dynamo';
 
 import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+import { DyNTS_RequestHunter } from './request-hunter.service';
 
 /** Egy event-loop-lag mintavétel (a gördülő history eleme). */
 export interface DyNTS_EventLoopSample {
@@ -32,6 +33,13 @@ export interface DyNTS_EventLoopSample {
  */
 export class DyNTS_EventLoopDiag {
 
+  /**
+   * E fölött a lag fölött írunk ki issue-hunter attribúciót (`[EL-STALL]`).
+   * 1000ms: egy másodperces loop-megállás már valódi tünet (a normál érték 20-50ms),
+   * de elég magas ahhoz, hogy a szokásos GC-tüskék ne spam-eljenek.
+   */
+  static readonly STALL_ATTRIBUTION_MS: number = 1000;
+
   private static instance: DyNTS_EventLoopDiag;
 
   static getInstance(): DyNTS_EventLoopDiag {
@@ -73,15 +81,29 @@ export class DyNTS_EventLoopDiag {
       }
 
       // a histogram ns-ben mér → ms-re váltunk; poll után reset (ablakonkénti kép)
+      const maxMs: number = Math.round(this.monitor.max / 1e6);
       this.history.push({
         at: Date.now(),
         p50Ms: Math.round(this.monitor.percentile(50) / 1e6),
         p95Ms: Math.round(this.monitor.percentile(95) / 1e6),
-        maxMs: Math.round(this.monitor.max / 1e6),
+        maxMs: maxMs,
         activeHandles: this.getActiveHandleCount(),
       });
       this.monitor.reset();
 
+      // ISSUE-HUNTER ATTRIBÚCIÓ (2026-08-05) — a mérés eddig csak azt mondta meg, HOGY megállt
+      // a loop, azt NEM, hogy MITŐL. Stall esetén kiírjuk az ÉPPEN futó kéréseket.
+      //
+      // ⚠️ Fontos korlát, amit a szöveg is kimond: a fagyás ALATT ez a poll NEM fut, ezért ha a
+      // blokkoló kérés időközben befejeződött, az in-flight lista ÜRES lesz. Ezért a `describeInFlight()`
+      // ilyenkor expliciten a `[REQ-HUNTER] SLOW` sorokra irányít — az a FŐ jel, ez a másodlagos.
+      if (maxMs >= DyNTS_EventLoopDiag.STALL_ATTRIBUTION_MS) {
+        DyFM_Log.warn(
+          `[EL-STALL] event-loop megallas ${maxMs}ms — futo keresek: `
+          + DyNTS_RequestHunter.getInstance().describeInFlight(),
+        );
+      }
+
       if (this.history.length > maxHistoryCount) {
         this.history = this.history.slice(-maxHistoryCount);
       }

package/src/_services/core/request-hunter.service.spec.ts

@@ -0,0 +1,124 @@
+import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+import { DyNTS_InFlightRequest, DyNTS_RequestHunter, DyNTS_SlowRequestSample } from './request-hunter.service';
+
+/**
+ * ISSUE-HUNTER — keres-szintu attribucio.
+ *
+ * A mert incidens (overseer 2026-08-05): az event-loop 10-15 mp-re megallt, de SEMMI nem mondta
+ * meg, MELYIK keres okozta. A diagnozis 4893 nyers log-sorbol tortent. Ez a service azt a
+ * kepesseget adja, ami hianyzott: a lassu keres MAGA jelenti magat, nevvel es idovel.
+ */
+describe('| DyNTS_RequestHunter', () => {
+
+  let hunter: DyNTS_RequestHunter;
+
+  beforeEach(() => {
+    hunter = DyNTS_RequestHunter.getInstance();
+    // Tiszta lap: a bennmaradt in-flight bejegyzeseket lezarjuk
+    for (let i = 0; i < 50; i++) { hunter.end(i); }
+    (DyNTS_global_settings as { requestHunter?: unknown }).requestHunter = { enabled: true, slowRequestMs: 20 };
+  });
+
+  afterEach(() => {
+    delete (DyNTS_global_settings as { requestHunter?: unknown }).requestHunter;
+  });
+
+  const wait = (ms: number): Promise<void> =>
+    new Promise<void>((r: () => void): void => { setTimeout(r, ms); });
+
+  describe('| in-flight nyilvantartas', () => {
+
+    it('| a futo keres LATSZIK, a befejezett NEM', () => {
+      // Arrange & Act
+      const id: number = hunter.begin('getCdpReportDetails');
+
+      // Assert — fut
+      const during: DyNTS_InFlightRequest[] = hunter.getInFlight();
+      expect(during.some((r: DyNTS_InFlightRequest): boolean => r.label === 'getCdpReportDetails')).toBeTrue();
+
+      // Act — vege
+      hunter.end(id);
+
+      // Assert — mar nem
+      expect(hunter.getInFlight().some((r: DyNTS_InFlightRequest): boolean => r.label === 'getCdpReportDetails'))
+        .toBeFalse();
+    });
+
+    it('| a leghosszabb ideje futo keres van ELOL (az a gyanus)', async (): Promise<void> => {
+      // Arrange
+      const first: number = hunter.begin('regota-fut');
+      await wait(30);
+      const second: number = hunter.begin('most-indult');
+
+      // Act
+      const list: DyNTS_InFlightRequest[] = hunter.getInFlight();
+
+      // Assert
+      expect(list[0].label).toBe('regota-fut');
+      expect(list[0].ageMs).toBeGreaterThanOrEqual(list[1].ageMs);
+
+      hunter.end(first);
+      hunter.end(second);
+    });
+  });
+
+  describe('| lassu-keres onjelentes (a FO jel)', () => {
+
+    it('| a kuszob folotti keres bekerul a history-ba, nevvel es idovel', async (): Promise<void> => {
+      // Arrange — 20ms a kuszob (beforeEach)
+      const id: number = hunter.begin('getCdpReportDetails');
+      await wait(45);
+
+      // Act
+      hunter.end(id);
+
+      // Assert — EZ az a sor, ami a mai incidenst egy lepesben megadta volna
+      const slow: DyNTS_SlowRequestSample[] = hunter.getSlowHistory();
+      const found: DyNTS_SlowRequestSample | undefined =
+        slow.find((s: DyNTS_SlowRequestSample): boolean => s.label === 'getCdpReportDetails');
+      expect(found).toBeDefined();
+      expect(found!.durationMs).toBeGreaterThanOrEqual(20);
+    });
+
+    it('| a GYORS keres NEM kerul a history-ba (nincs log-flood)', async (): Promise<void> => {
+      // Arrange
+      const before: number = hunter.getSlowHistory().length;
+      const id: number = hunter.begin('gyors-keres');
+
+      // Act
+      hunter.end(id);
+
+      // Assert
+      expect(hunter.getSlowHistory().length).toBe(before);
+    });
+  });
+
+  describe('| robusztussag', () => {
+
+    it('| kikapcsolva a begin 0-t ad, es az end(0) no-op (nem dob)', () => {
+      // Arrange
+      (DyNTS_global_settings as { requestHunter?: unknown }).requestHunter = { enabled: false };
+
+      // Act & Assert
+      const id: number = hunter.begin('barmi');
+      expect(id).toBe(0);
+      expect((): void => hunter.end(0)).not.toThrow();
+    });
+
+    it('| ismeretlen id-re az end no-op (dupla-end / elveszett id sem szivarogtat)', () => {
+      // Act & Assert
+      expect((): void => hunter.end(999999)).not.toThrow();
+    });
+
+    it('| ures in-flight eseten a leiras a SLOW-sorokra iranyit (ez is informacio)', () => {
+      // Arrange — minden lezarva
+      for (let i = 0; i < 50; i++) { hunter.end(i); }
+
+      // Act
+      const text: string = hunter.describeInFlight();
+
+      // Assert — a fagyas ALATT a poll nem fut, ezert az ures lista VARHATO; a szoveg ezt megmondja
+      expect(text).toContain('SLOW');
+    });
+  });
+});

package/src/_services/core/request-hunter.service.ts

@@ -0,0 +1,157 @@
+import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+
+/** Egy eppen futo keres a hunter nyilvantartasaban. */
+export interface DyNTS_InFlightRequest {
+  /** Az endpoint neve (`DyNTS_Endpoint_Params.name`). */
+  label: string;
+  /** Mennyi ideje fut (ms). */
+  ageMs: number;
+}
+
+/** Egy mar befejezodott LASSU keres (gorgo history). */
+export interface DyNTS_SlowRequestSample {
+  at: number;
+  label: string;
+  durationMs: number;
+}
+
+/**
+ * ISSUE-HUNTER: **melyik keres blokkolta az event-loopot?**
+ *
+ * ⚠️ MIERT KELLETT (mert incidens, overseer 2026-08-05): az event-loop 10-15 masodpercre
+ * megallt (`DyNTS_EventLoopDiag`: elLag max 10058-14839 ms), a `MemoryGuard` es a healthcheck
+ * ONMAGABAN egyiket sem tudta MIHEZ kotni. A diagnozis igy a nyers log 4893 sorabol tortent,
+ * orak alatt — holott a dontő jel MINDOSSZE 4 sor volt benne. A hianyzo kepesseg nem a MERES
+ * volt (az megvolt), hanem az ATTRIBUCIO: *mi futott, amikor megallt?*
+ *
+ * Ez a service ezt potolja, KET fuggetlen jellel:
+ *
+ *  1. **Lassu-keres onjelentes (a fo jel).** Amikor egy keres BEFEJEZODIK, ha tovabb tartott a
+ *     kuszobnel, azonnal WARN-t ir a nevevel es az idejevel. A mai incidenst EZ egyetlen sorban
+ *     megadta volna: `[REQ-HUNTER] SLOW getCdpReportDetails 10240ms`.
+ *     ⚠️ Miert EZ a fo jel: a fagyas ALATT a diag-poll NEM fut (a loop all), tehat mire lefutna,
+ *     a bunos keres mar befejezodott — az "in-flight pillanatkep" onmagaban ELKESNE.
+ *
+ *  2. **In-flight pillanatkep (a masodik jel).** Azokra az esetekre, amikor a keres MEG MINDIG
+ *     fut (beragadt / vegtelen varakozas): a stall-detektor le tudja kerdezni, mi van eppen
+ *     folyamatban es mennyi ideje.
+ *
+ * KOLTSEG: egy `Map`-beszuras + `Date.now()` keresenkent. Elhanyagolhato; ezert
+ * alapertelmezetten BE van kapcsolva (a mai incidens tanulsaga: ami nincs bekapcsolva, az pont
+ * az incidens alatt nem all rendelkezesre).
+ *
+ * Settings (`DyNTS_global_settings.requestHunter`):
+ *   - `enabled?: boolean`        default true
+ *   - `slowRequestMs?: number`   default 1000 — e felett WARN a keres vegen
+ *   - `maxHistoryCount?: number` default 50 — a lassu-keres history merete
+ */
+export class DyNTS_RequestHunter {
+
+  private static instance: DyNTS_RequestHunter;
+
+  static getInstance(): DyNTS_RequestHunter {
+    if (!DyNTS_RequestHunter.instance) {
+      DyNTS_RequestHunter.instance = new DyNTS_RequestHunter();
+    }
+
+    return DyNTS_RequestHunter.instance;
+  }
+
+  private nextId: number = 1;
+  private readonly inFlight: Map<number, { label: string; startedAt: number }> = new Map();
+  private slowHistory: DyNTS_SlowRequestSample[] = [];
+
+  /** A settings-ertekek feloldasa (minden hivasnal, hogy a runtime-valtoztatas is hasson). */
+  private getSettings(): { enabled: boolean; slowRequestMs: number; maxHistoryCount: number } {
+    const s: { enabled?: boolean; slowRequestMs?: number; maxHistoryCount?: number } =
+      (DyNTS_global_settings as { requestHunter?: Record<string, unknown> }).requestHunter ?? {};
+
+    return {
+      enabled: s.enabled !== false,
+      slowRequestMs: typeof s.slowRequestMs === 'number' && s.slowRequestMs > 0 ? s.slowRequestMs : 1000,
+      maxHistoryCount: typeof s.maxHistoryCount === 'number' && s.maxHistoryCount > 0 ? s.maxHistoryCount : 50,
+    };
+  }
+
+  /**
+   * Keres kezdete. A visszaadott id-t az `end()`-nek kell atadni.
+   *
+   * @returns a keres id-ja, vagy 0 ha a hunter ki van kapcsolva (az `end(0)` no-op)
+   */
+  begin(label: string): number {
+    if (!this.getSettings().enabled) {
+      return 0;
+    }
+
+    const id: number = this.nextId++;
+    this.inFlight.set(id, { label: label, startedAt: Date.now() });
+
+    return id;
+  }
+
+  /**
+   * Keres vege. Ha a kuszobnel tovabb tartott, WARN + bekerul a history-ba.
+   * Hibatur: ismeretlen / 0 id eseten no-op.
+   */
+  end(id: number): void {
+    if (!id) {
+      return;
+    }
+
+    const entry: { label: string; startedAt: number } | undefined = this.inFlight.get(id);
+    if (!entry) {
+      return;
+    }
+    this.inFlight.delete(id);
+
+    const settings: { slowRequestMs: number; maxHistoryCount: number } = this.getSettings();
+    const durationMs: number = Date.now() - entry.startedAt;
+    if (durationMs < settings.slowRequestMs) {
+      return;
+    }
+
+    this.slowHistory.push({ at: Date.now(), label: entry.label, durationMs: durationMs });
+    if (this.slowHistory.length > settings.maxHistoryCount) {
+      this.slowHistory = this.slowHistory.slice(-settings.maxHistoryCount);
+    }
+
+    DyFM_Log.warn(
+      `[REQ-HUNTER] SLOW ${entry.label} ${durationMs}ms`
+      + (this.inFlight.size ? ` (kozben ${this.inFlight.size} masik keres is futott)` : ''),
+    );
+  }
+
+  /** Az EPPEN futo keresek — a stall-detektor ebbol tudja, mi ragadt be. */
+  getInFlight(now: number = Date.now()): DyNTS_InFlightRequest[] {
+    const out: DyNTS_InFlightRequest[] = [];
+    for (const entry of this.inFlight.values()) {
+      out.push({ label: entry.label, ageMs: now - entry.startedAt });
+    }
+
+    return out.sort((a: DyNTS_InFlightRequest, b: DyNTS_InFlightRequest): number => b.ageMs - a.ageMs);
+  }
+
+  /** A kozelmult lassu keresei (gorgo history) — `/server/diag`-ba is kitehető. */
+  getSlowHistory(): DyNTS_SlowRequestSample[] {
+    return [...this.slowHistory];
+  }
+
+  /**
+   * Ember-olvashato in-flight osszefoglalo a stall-loghoz.
+   * Ures listanal expliciten ezt mondja — mert az IS informacio: a blokkolo mar befejezodott,
+   * tehat a lassu-keres onjelentest (1. jel) kell nezni.
+   */
+  describeInFlight(now: number = Date.now()): string {
+    const list: DyNTS_InFlightRequest[] = this.getInFlight(now);
+    if (!list.length) {
+      return 'nincs futo keres (a blokkolo mar befejezodott — lasd a [REQ-HUNTER] SLOW sorokat)';
+    }
+
+    return list
+      .slice(0, 5)
+      .map((r: DyNTS_InFlightRequest): string => `${r.label} (${r.ageMs}ms)`)
+      .join(', ');
+  }
+}

package/src/index.ts

@@ -60,6 +60,7 @@ export * from './_collections/signed-url.util';
 export * from './_collections/client-safe-error.util';
 export * from './_collections/load-shed.util';
 export * from './_services/core/event-loop-diag.service';
+export * from './_services/core/request-hunter.service';
 export * from './_services/core/db-stats.service';
 export * from './_services/core/diagnostics.service';