@futdevpro/nts-dynamo 1.15.119 → 1.15.121

package/build/_services/core/diagnostics.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.service.d.ts","sourceRoot":"","sources":["../../../src/_services/core/diagnostics.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAQrC;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAKnE,qBAAa,iBAAiB;IAE5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAEjE,8EAA8E;IAC9E,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAItD,iFAAiF;WACpE,SAAS,CAAC,GAAG,EAAE;QAC1B,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;QAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqF/B,8GAA8G;IAC9G,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM;IAM3E,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM;CASzD"}

package/build/_services/core/diagnostics.service.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Diagnostics = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const db_stats_service_1 = require("./db-stats.service");
+const event_loop_diag_service_1 = require("./event-loop-diag.service");
+const memory_guard_service_1 = require("./memory-guard.service");
+/** Collection-méret warn-küszöb (MB) — e fölött a dbStats-check warn-ra vált. */
+const DEFAULT_COLLECTION_WARN_MB = 512;
+class DyNTS_Diagnostics {
+    static customChecks = [];
+    /** App-specifikus check regisztrálása (pl. env-validáció, provider-probe). */
+    static registerCheck(check) {
+        DyNTS_Diagnostics.customChecks.push(check);
+    }
+    /** A teljes doctor-riport. SOSEM dob — a hibás check `fail`-ként jelenik meg. */
+    static async runDoctor(set) {
+        const checks = [];
+        // 1) Mongo-probe (readiness-minta: readyState + admin ping).
+        try {
+            const readyState = set.connection?.readyState ?? 0;
+            let pingOk = false;
+            if (readyState === 1) {
+                await set.connection.db?.admin().ping();
+                pingOk = true;
+            }
+            checks.push({
+                name: 'mongo',
+                health: readyState === 1 && pingOk ? 'ok' : 'fail',
+                detail: { readyState: readyState, pingOk: pingOk },
+                fixHint: readyState === 1 && pingOk ? undefined
+                    : 'Check MONGO_URL + DB container/network reachability (readyState 1 + ping expected).',
+            });
+        }
+        catch (error) {
+            checks.push({
+                name: 'mongo', health: 'fail', detail: String(error),
+                fixHint: 'Mongo ping threw — check DB availability/credentials.',
+            });
+        }
+        // 2) Memória (MemoryGuard pressure).
+        try {
+            const pressure = memory_guard_service_1.DyNTS_MemoryGuard.getInstance().pressure();
+            const level = String(pressure?.level ?? 'ok');
+            checks.push({
+                name: 'memory',
+                health: level === 'critical' ? 'fail' : level === 'warning' ? 'warn' : 'ok',
+                detail: pressure,
+                fixHint: level === 'ok' ? undefined
+                    : 'Heap pressure — check collection sizes (/server/db-stats) + recent load; consider retention.',
+            });
+        }
+        catch (error) {
+            checks.push({ name: 'memory', health: 'warn', detail: String(error), fixHint: 'MemoryGuard snapshot failed.' });
+        }
+        // 3) Event-loop lag.
+        try {
+            const snapshot = event_loop_diag_service_1.DyNTS_EventLoopDiag.getInstance().getSnapshot();
+            checks.push({ name: 'eventLoop', health: 'ok', detail: snapshot });
+        }
+        catch (error) {
+            checks.push({ name: 'eventLoop', health: 'warn', detail: String(error), fixHint: 'EventLoopDiag snapshot failed.' });
+        }
+        // 4) DB-stats + bloat-küszöb (BFR-OVERSEER-004 early-warning).
+        try {
+            const stats = await db_stats_service_1.DyNTS_DbStats_Util.collect(set.connection);
+            const warnMB = set.collectionWarnMB ?? DEFAULT_COLLECTION_WARN_MB;
+            const bloated = stats.collections
+                .filter((c) => c.sizeMB + c.indexSizeMB > warnMB)
+                .map((c) => `${c.name} (${c.sizeMB}MB + ${c.indexSizeMB}MB idx)`);
+            checks.push({
+                name: 'dbStats',
+                health: bloated.length ? 'warn' : 'ok',
+                detail: { totalSizeMB: stats.totalSizeMB, collectionCount: stats.collections.length, bloated: bloated },
+                fixHint: bloated.length
+                    ? `Collections over ${warnMB}MB — add dataParams.retention (TTL) or prune: ${bloated.join(', ')}`
+                    : undefined,
+            });
+        }
+        catch (error) {
+            checks.push({ name: 'dbStats', health: 'warn', detail: String(error), fixHint: 'db-stats collection failed.' });
+        }
+        // 5) App-specifikus check-ek.
+        for (const customCheck of DyNTS_Diagnostics.customChecks) {
+            try {
+                checks.push(await customCheck());
+            }
+            catch (error) {
+                fsm_dynamo_1.DyFM_Log.warn('(DyNTS_Diagnostics) custom check threw (reported as fail)', error);
+                checks.push({ name: 'custom', health: 'fail', detail: String(error), fixHint: 'Custom check threw — see detail.' });
+            }
+        }
+        return {
+            health: DyNTS_Diagnostics.interpretHealth(checks),
+            checks: checks,
+            summary: DyNTS_Diagnostics.buildSummary(checks),
+            uptimeSec: Math.round(process.uptime()),
+        };
+    }
+    /** Aggregált health: bármely fail → fail; különben bármely warn → warn; különben ok. Pure (unit-tesztelt). */
+    static interpretHealth(checks) {
+        if (checks.some((c) => c.health === 'fail')) {
+            return 'fail';
+        }
+        if (checks.some((c) => c.health === 'warn')) {
+            return 'warn';
+        }
+        return 'ok';
+    }
+    /** Ember-olvasható összegzés a nem-ok check-ekből. Pure (unit-tesztelt). */
+    static buildSummary(checks) {
+        const notOk = checks.filter((c) => c.health !== 'ok');
+        if (!notOk.length) {
+            return 'all checks ok';
+        }
+        return notOk
+            .map((c) => `${c.name}: ${c.health}${c.fixHint ? ` — ${c.fixHint}` : ''}`)
+            .join(' | ');
+    }
+}
+exports.DyNTS_Diagnostics = DyNTS_Diagnostics;
+//# sourceMappingURL=diagnostics.service.js.map

package/build/_services/core/diagnostics.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.service.js","sourceRoot":"","sources":["../../../src/_services/core/diagnostics.service.ts"],"names":[],"mappings":";;;AAEA,sDAAiD;AAEjD,yDAAuE;AACvE,uEAAgE;AAChE,iEAA2D;AAiC3D,iFAAiF;AACjF,MAAM,0BAA0B,GAAW,GAAG,CAAC;AAE/C,MAAa,iBAAiB;IAEpB,MAAM,CAAU,YAAY,GAA0B,EAAE,CAAC;IAEjE,8EAA8E;IAC9E,MAAM,CAAC,aAAa,CAAC,KAA0B;QAC7C,iBAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,iFAAiF;IACjF,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAGtB;QACC,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,6DAA6D;QAC7D,IAAI,CAAC;YACH,MAAM,UAAU,GAAW,GAAG,CAAC,UAAU,EAAE,UAAU,IAAI,CAAC,CAAC;YAC3D,IAAI,MAAM,GAAY,KAAK,CAAC;YAC5B,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,UAAU,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;gBAClD,MAAM,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE;gBAClD,OAAO,EAAE,UAAU,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS;oBAC7C,CAAC,CAAC,qFAAqF;aAC1F,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpD,OAAO,EAAE,uDAAuD;aACjE,CAAC,CAAC;QACL,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAY,wCAAiB,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;YACrE,MAAM,KAAK,GAAW,MAAM,CAAE,QAA+B,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;gBAC3E,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS;oBACjC,CAAC,CAAC,8FAA8F;aACnG,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,CAAC;QAClH,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAY,6CAAmB,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;YAC1E,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,CAAC;QACvH,CAAC;QAED,+DAA+D;QAC/D,IAAI,CAAC;YACH,MAAM,KAAK,GAAkB,MAAM,qCAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9E,MAAM,MAAM,GAAW,GAAG,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;YAC1E,MAAM,OAAO,GAAa,KAAK,CAAC,WAAW;iBACxC,MAAM,CAAC,CAAC,CAAC,EAAW,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC;iBACzD,GAAG,CAAC,CAAC,CAAC,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,WAAW,SAAS,CAAC,CAAC;YAC5E,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;gBACtC,MAAM,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;gBACvG,OAAO,EAAE,OAAO,CAAC,MAAM;oBACrB,CAAC,CAAC,oBAAoB,MAAM,iDAAiD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACjG,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAC;QAClH,CAAC;QAED,8BAA8B;QAC9B,KAAK,MAAM,WAAW,IAAI,iBAAiB,CAAC,YAAY,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,qBAAQ,CAAC,IAAI,CAAC,2DAA2D,EAAE,KAAK,CAAC,CAAC;gBAClF,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;YACtH,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,iBAAiB,CAAC,eAAe,CAAC,MAAM,CAAC;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC;YAC/C,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;SACxC,CAAC;IACJ,CAAC;IAED,8GAA8G;IAC9G,MAAM,CAAC,eAAe,CAAC,MAA2B;QAChD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAoB,EAAW,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;YAAC,OAAO,MAAM,CAAC;QAAC,CAAC;QAC3F,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAoB,EAAW,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;YAAC,OAAO,MAAM,CAAC;QAAC,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CAAC,MAA2B;QAC7C,MAAM,KAAK,GAAwB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAoB,EAAW,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;QACvG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,OAAO,KAAK;aACT,GAAG,CAAC,CAAC,CAAoB,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aACpG,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;;AAlHH,8CAmHC"}

package/build/index.d.ts

@@ -24,6 +24,8 @@ export * from './_collections/security-headers.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/db-stats.service';
+export * from './_services/core/diagnostics.service';
 export * from './_models/control-models/api-call-params.control-model';
 export * from './_models/control-models/app-ext-system-controls.control-model';
 export * from './_models/control-models/app-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,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,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AAGzD,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,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,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"}

package/build/index.js

@@ -53,6 +53,8 @@ tslib_1.__exportStar(require("./_collections/security-headers.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/db-stats.service"), exports);
+tslib_1.__exportStar(require("./_services/core/diagnostics.service"), exports);
 // models/CONTROL MODELS
 tslib_1.__exportStar(require("./_models/control-models/api-call-params.control-model"), exports);
 tslib_1.__exportStar(require("./_models/control-models/app-ext-system-controls.control-model"), exports);

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,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,0FAAgE;AAChE,yFAA+D;AAC/D,+EAAqD;AACrD,gFAAsD;AACtD,wEAA8C;AAC9C,mFAAyD;AAEzD,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,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,0FAAgE;AAChE,yFAA+D;AAC/D,+EAAqD;AACrD,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.119",
+  "version": "01.15.121",
   "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.26",
+    "@futdevpro/fsm-dynamo": "1.16.27",
     "@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

@@ -261,6 +261,18 @@ export class DyNTS_Endpoint_Params<
           return;
         }
 
+        // BFR-OVERSEER-010: a logResponseContent IMPLEMENTÁLVA (a korábbi "not implemented yet"
+        // warn-stub minden requestre spam-elt). A res.send-et wrap-eljük a küldött body
+        // elkapásához; a task-ok után csonkolt preview-t logolunk (log-flood ellen).
+        let capturedResponseBody: unknown;
+        if (this.logRequest && this.logResponseContent) {
+          const originalSend: Response['send'] = res.send.bind(res);
+          res.send = (body?: unknown): Response => {
+            capturedResponseBody = body;
+            return originalSend(body);
+          };
+        }
+
         await DyFM_Array.asyncForEach(this.tasks,
           async (
             task: (req: Request, res: Response, issuer?: string) => Promise<void>
@@ -268,13 +280,11 @@ export class DyNTS_Endpoint_Params<
             await task(req, res, issuer);
           }
         );
-  
+
         if (this.logRequest) {
+          DyFM_Log.success(`  <<<=====   '${this.name}' result sent.`);
           if (this.logResponseContent) {
-            DyFM_Log.success(`  <<<=====   '${this.name}' result sent.`);
-            DyFM_Log.warn('sorry, the logResponseContent is not implemented yet.');
-          } else {
-            DyFM_Log.success(`  <<<=====   '${this.name}' result sent.`);
+            DyFM_Log.info(`              response: ${DyNTS_Endpoint_Params.previewBody(capturedResponseBody)}`);
           }
         }
       } catch (error) {
@@ -283,6 +293,28 @@ export class DyNTS_Endpoint_Params<
     };
   }
 
+  /**
+   * BFR-OVERSEER-010: csonkolt, safe response-preview a logResponseContent-hez —
+   * nem-parseolható/circular body-ra nem dob, hosszú body-t levág (log-flood ellen).
+   */
+  private static previewBody(body: unknown): string {
+    const maxLength: number = 2000;
+    let text: string;
+    if (body === undefined) {
+      return '-no body captured-';
+    }
+    if (typeof body === 'string') {
+      text = body;
+    } else {
+      try {
+        text = JSON.stringify(body);
+      } catch {
+        text = String(body);
+      }
+    }
+    return text.length > maxLength ? `${text.slice(0, maxLength)}…(truncated ${text.length} chars)` : text;
+  }
+
   /**
    * 
    * @param res 
@@ -492,20 +524,16 @@ export class DyNTS_Endpoint_Params<
       // test/dev környezetben TELJES DyFM-leaket hagyott (__localStack + ___systemVersion + issuer).
       // A szabályok (mindig-strip / prod-only additionalContent / kliens-mezők megtartása) SSOT-ja
       // a DyNTS_ClientSafeError_Util.
-      res.send(DyNTS_ClientSafeError_Util.toClientSafe(error));
+      // BFR-OVERSEER-010: a kiküldött client-safe error megőrzése a logResponseContent-hez.
+      const clientSafeError: unknown = DyNTS_ClientSafeError_Util.toClientSafe(error);
+      res.send(clientSafeError);
 
       if (this.logRequest) {
+        DyFM_Log.error(
+          `  <<<=====   '${this.name}' error sent: ${(error as DyFM_Error)?._message ?? ''}`
+        );
         if (this.logResponseContent) {
-          DyFM_Log.error(
-            `  <<<=====   '${this.name}' error sent: ${(error as DyFM_Error)?._message ?? ''}`
-          );
-          DyFM_Log.error(
-            'sorry, the logResponseContent is not implemented yet.'
-          );
-        } else {
-          DyFM_Log.error(
-            `  <<<=====   '${this.name}' error sent: ${(error as DyFM_Error)?._message ?? ''}`
-          );
+          DyFM_Log.error(`              error response: ${DyNTS_Endpoint_Params.previewBody(clientSafeError)}`);
         }
       }
 

package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts

@@ -75,6 +75,22 @@ describe('| DyNTS_LVS_PersistentVectorPool_ControlService', () => {
       (collectionKey: string) =>
         Promise.resolve(Array.from(store.get(collectionKey)?.values() ?? [])),
     );
+
+    // BFR-AM-013 (hydration-paging): a batch-elt lean-scan fake-je — a fake-store tartalmát
+    // batch-enként adagolja a handler-nek (a valós cursor-viselkedés memóriában modellezve).
+    spyOn(DyNTS_LVS_VectorPersist_DataService.prototype, 'findLeanBatchedByCollectionKey').and.callFake(
+      async (
+        collectionKey: string,
+        set: { batchSize?: number; handler: (batch: Partial<DyNTS_LVS_VectorPersist>[]) => Promise<void> | void },
+      ): Promise<number> => {
+        const all: DyNTS_LVS_VectorPersist[] = Array.from(store.get(collectionKey)?.values() ?? []);
+        const batchSize: number = set.batchSize && set.batchSize > 0 ? set.batchSize : 500;
+        for (let i: number = 0; i < all.length; i += batchSize) {
+          await set.handler(all.slice(i, i + batchSize));
+        }
+        return all.length;
+      },
+    );
   });
 
   /** Egy egységvektor a tengely-irányba (cosine-self = 1) — determinisztikus keresés-ellenőrzéshez. */

package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts

@@ -1,5 +1,5 @@
 
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
 
 import { LVS_Search_Mode } from '../_enums/lvs-search-mode.enum';
 import { LVS_SearchResult } from '../_models/lvs-search-result.interface';
@@ -97,24 +97,60 @@ export class DyNTS_LVS_PersistentVectorPool_ControlService {
    * előbb üríti (idempotens hidratálás). A hiányos (üres `vectorId`/`embedding`) rekordokat átugorja.
    * Visszaadja a betöltött vektorok számát. **NEM** Atlas — saját Mongo + in-memory pool.
    */
-  async hydrateFromMongo(): Promise<number> {
-    const records: DyNTS_LVS_VectorPersist[] =
-      await this.getPersistService().findByCollectionKey(this.collectionKey);
-
+  async hydrateFromMongo(set?: {
+    /** Cursor-batch méret (default 500) — a heap-tranziens felső korlátja egy batch. */
+    batchSize?: number,
+    /** Opcionális felső korlát a pool-méretre; elérésekor a hidratálás áll + WARN (no-silent-cap). */
+    maxVectors?: number,
+  }): Promise<number> {
+    // BFR-AM-013 (hydration-paging): a korábbi impl a TELJES collection-t egyetlen
+    // `findByCollectionKey`-jel (Mongoose-doc-tömb) töltötte memóriába → 32k×2560-dim vektornál
+    // RUNTIME-IGAZOLT 93% heap-spike (OOM-közeli). Mostantól LEAN + projektált (vectorId+embedding,
+    // a content-szöveg NÉLKÜL) CURSOR-batch — a tranziens felső korlátja EGY batch.
     this.pool.clearPool();
 
     let loaded: number = 0;
-
-    for (const record of records) {
-      if (!record.vectorId || !record.embedding?.length) {
-        continue;
-      }
-      this.pool.addVector(record.vectorId, record.embedding);
-      loaded++;
-    }
+    let skipped: number = 0;
+    let truncated: boolean = false;
+
+    await this.getPersistService().findLeanBatchedByCollectionKey(this.collectionKey, {
+      batchSize: set?.batchSize,
+      handler: (batch: Partial<DyNTS_LVS_VectorPersist>[]): void => {
+        for (const record of batch) {
+          if (truncated) {
+            return;
+          }
+          if (set?.maxVectors !== undefined && loaded >= set.maxVectors) {
+            truncated = true;
+            DyFM_Log.warn(
+              `[DyNTS LVS hydrate] '${this.collectionKey}': maxVectors (${set.maxVectors}) elérve — ` +
+              'a hidratálás CSONKOLVA (no-silent-cap; a maradék vektor NEM került a poolba).',
+            );
+            return;
+          }
+          if (!record.vectorId || !record.embedding?.length) {
+            continue;
+          }
+          try {
+            this.pool.addVector(record.vectorId, record.embedding);
+            loaded++;
+          } catch (error) {
+            // BFR-AM-013 (NaN/±Inf-guard a hidratálásban): EGY hibás (nem-véges elemű) perzistált
+            // vektor NEM boríthatja a teljes boot-hidratálást — skip + warn (nem néma).
+            skipped++;
+            DyFM_Log.warn(
+              `[DyNTS LVS hydrate] '${this.collectionKey}': vektor kihagyva ("${record.vectorId}") — ` +
+              `${DyFM_Error.getErrorMessage(error)}`,
+            );
+          }
+        }
+      },
+    });
 
     DyFM_Log.log(
-      `[DyNTS LVS hydrate] '${this.collectionKey}' pool: ${loaded} vektor betöltve az in-memory pool-ba.`,
+      `[DyNTS LVS hydrate] '${this.collectionKey}' pool: ${loaded} vektor betöltve az in-memory pool-ba` +
+      (skipped ? ` (${skipped} hibás vektor kihagyva)` : '') +
+      (truncated ? ' (CSONKOLT — maxVectors)' : '') + '.',
     );
 
     return loaded;

package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts

@@ -48,6 +48,28 @@ export class DyNTS_LVS_VectorPersist_DataService extends DyNTS_DataService<DyNTS
     );
   }
 
+  /**
+   * BFR-AM-013 (hydration-paging): LEAN + projektált (CSAK `vectorId` + `embedding` — a content-szöveg
+   * és metadata NÉLKÜL) cursor-batch scan a boot-hidratáláshoz. A heap-tranziens felső korlátja EGY batch
+   * (a teljes result-set + Mongoose-doc-boxing kimarad). Soft-delete-elt rekordok kihagyva.
+   */
+  async findLeanBatchedByCollectionKey(
+    collectionKey: string,
+    set: {
+      batchSize?: number,
+      handler: (batch: Partial<DyNTS_LVS_VectorPersist>[]) => Promise<void> | void,
+    }
+  ): Promise<number> {
+    return this.dataDBService.findLeanBatched(
+      { collectionKey: collectionKey, _deleted: undefined },
+      {
+        projection: { vectorId: 1, embedding: 1 },
+        batchSize: set.batchSize,
+        handler: set.handler,
+      }
+    );
+  }
+
   /**
    * Egy vektor ATOMIKUS upsert-je a `(collectionKey, vectorId)` logikai-kulcson. MEGLÉVŐ rekordnál
    * `$set` (a Mixed `metadata` silent-drop ellen — memory: mongoose_mixed_atomic_write); ÚJ rekordnál

package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts

@@ -374,9 +374,11 @@ describe('| LVS_VectorPool_ControlService', () => {
       expect(vec1Result!.score).toBeCloseTo(1, 10);
     });
 
-    it('| should produce cosine scores IDENTICAL to static cosineSimilarity (precomputed-normalized perf optimization, BFR-AM-013)', () => {
+    it('| should produce cosine scores EQUIVALENT to static cosineSimilarity (precomputed-normalized + Float32 storage, BFR-AM-013)', () => {
       // Regression-guard: a search optimalizalt (precomputed-normalized + alloc-mentes) cosine-ja
-      // viselkedes-identikus a regi per-osszehasonlitas `cosineSimilarity(query, vector)`-ral.
+      // viselkedes-EKVIVALENS a regi per-osszehasonlitas `cosineSimilarity(query, vector)`-ral.
+      // Tolerancia 6 tizedes (nem 10): a pool BELSŐ tárolása Float32Array (BFR-AM-013 Tier-1,
+      // ~2-4× memória) → ~1e-7 kerekítési eltérés — a similarity-RANGSORT nem érinti.
       const query: number[] = [0.3, 0.7, 0.2];
       const results: LVS_SearchResult[] = vectorPool.search(query, 4, LVS_Search_Mode.cosineSimilarity);
 
@@ -386,7 +388,7 @@ describe('| LVS_VectorPool_ControlService', () => {
         const original: number[] | undefined = originals.get(result.id);
         expect(original).toBeDefined();
         const expected: number = LVS_VectorPool_ControlService.cosineSimilarity(query, original!);
-        expect(result.score).toBeCloseTo(expected, 10);
+        expect(result.score).toBeCloseTo(expected, 6);
       }
     });
 

package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts

@@ -1,3 +1,5 @@
+import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+
 import { LVS_Search_Mode } from '../_enums/lvs-search-mode.enum';
 import { LVS_SearchResult } from '../_models/lvs-search-result.interface';
 
@@ -10,14 +12,19 @@ export class LVS_VectorPool_ControlService {
   /**
    * In-memory vektor pool tárolás
    * Key: vektor ID, Value: vektor értékek
+   *
+   * BFR-AM-013 (Tier-1 memória): a belső tárolás `Float32Array` (4 byte/elem, boxing nélkül) a
+   * korábbi `number[]` (8 byte + array-boxing) helyett → ~2–4× kisebb PERSISTENS pool-footprint
+   * (2560-dim × 32k vektornál a heap érdemi része). A cosine/l2 index-alapú loopjai változatlanul
+   * futnak rajta; a publikus `getAll()` kontraktja (number[]) konverzióval megőrzött.
    */
-  private vectorPool: Map<string, number[]> = new Map<string, number[]>();
+  private vectorPool: Map<string, Float32Array> = new Map<string, Float32Array>();
 
   /**
    * Normalizált vektor pool tárolás (L2 normalizált másolatok)
-   * Key: vektor ID, Value: L2 normalizált vektor értékek
+   * Key: vektor ID, Value: L2 normalizált vektor értékek (Float32Array — l. fent)
    */
-  private normalizedVectorPool: Map<string, number[]> = new Map<string, number[]>();
+  private normalizedVectorPool: Map<string, Float32Array> = new Map<string, Float32Array>();
 
   /**
    * `normalizedOnly` mód: ha `true`, a pool NEM tárolja a nyers vektorokat (`vectorPool`) — CSAK a
@@ -52,13 +59,13 @@ export class LVS_VectorPool_ControlService {
     }
 
     // Tároljuk az eredeti vektort — KIVÉVE normalizedOnly módban (akkor a nyers pool kihagyva, ~50% memória).
+    // Float32Array-ként (BFR-AM-013 Tier-1) — a number[]-boxing nélkül.
     if (!this.normalizedOnly) {
-      this.vectorPool.set(id, vector);
+      this.vectorPool.set(id, Float32Array.from(vector));
     }
 
     // L2 normalizált másolatot is tárolunk a cosine similarity számításokhoz
-    const normalized: number[] = LVS_VectorPool_ControlService.l2Normalize(vector);
-    this.normalizedVectorPool.set(id, normalized);
+    this.normalizedVectorPool.set(id, LVS_VectorPool_ControlService.l2NormalizeFloat32(vector));
   }
 
   /**
@@ -102,7 +109,33 @@ export class LVS_VectorPool_ControlService {
    * Debugging és export céljára
    */
   getAll(): Map<string, number[]> {
-    return new Map<string, number[]>(this.vectorPool);
+    // A publikus kontrakt (number[]) megőrzése — a belső Float32Array-ből konvertálva.
+    const result: Map<string, number[]> = new Map<string, number[]>();
+    for (const [ id, vector ] of this.vectorPool.entries()) {
+      result.set(id, Array.from(vector));
+    }
+    return result;
+  }
+
+  /**
+   * BFR-AM-013 (Tier-1): L2-normalizálás Float32Array-be, explicit loopokkal (allokáció-minimális) —
+   * a pool BELSŐ tárolási formátumához. Nullvektor → csupa-0 Float32Array.
+   */
+  private static l2NormalizeFloat32(vector: ArrayLike<number>): Float32Array {
+    let sumSquares: number = 0;
+    for (let i: number = 0; i < vector.length; i++) {
+      sumSquares += vector[i] * vector[i];
+    }
+    const magnitude: number = Math.sqrt(sumSquares);
+
+    const normalized: Float32Array = new Float32Array(vector.length);
+    if (magnitude === 0) {
+      return normalized;
+    }
+    for (let i: number = 0; i < vector.length; i++) {
+      normalized[i] = vector[i] / magnitude;
+    }
+    return normalized;
   }
 
   /**
@@ -156,7 +189,7 @@ export class LVS_VectorPool_ControlService {
    * Eredmény: 0 vagy pozitív érték, ahol 0 a legkisebb távolság
    * Statikus metódus, mivel nincs szüksége instance state-re
    */
-  static l2Distance(a: number[], b: number[]): number {
+  static l2Distance(a: ArrayLike<number>, b: ArrayLike<number>): number {
     if (a.length !== b.length) {
       throw new Error(
         `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
@@ -200,6 +233,14 @@ export class LVS_VectorPool_ControlService {
       throw new Error('Query vector must be a non-empty array');
     }
 
+    // BFR-AM-013 (NaN/±Inf-guard): nem-véges query-elem NÉMÁN mérgezné a TELJES rangsort
+    // (minden dot-product NaN → a valódi találatok kiesnek, hiba nélkül) → fail-closed throw.
+    for (let i: number = 0; i < query.length; i++) {
+      if (!Number.isFinite(query[i])) {
+        throw new Error(`Query vector must contain only finite numbers (non-finite at index ${i})`);
+      }
+    }
+
     if (k <= 0) {
       throw new Error('k must be a positive number');
     }
@@ -217,9 +258,9 @@ export class LVS_VectorPool_ControlService {
 
     // Validáljuk, hogy minden vektor ugyanolyan dimenziójú-e. A referencia-pool mód-függő: l2 a nyers,
     // cosine a normalizált (azonos dimenzió, de `normalizedOnly`-ban a nyers pool üres).
-    const referencePool: Map<string, number[]> =
+    const referencePool: Map<string, Float32Array> =
       mode === LVS_Search_Mode.l2Distance ? this.vectorPool : this.normalizedVectorPool;
-    const firstVector: number[] | undefined = Array.from(referencePool.values())[0];
+    const firstVector: Float32Array | undefined = referencePool.values().next().value;
     if (firstVector && firstVector.length !== query.length) {
       throw new Error(
         `Query vector dimension (${query.length}) does not match pool vector ` +
@@ -239,7 +280,10 @@ export class LVS_VectorPool_ControlService {
       //  (2) a per-összehasonlítás dot-product ALLOKÁCIÓ-MENTES (a régi `l2Normalize` hívásonként KÉT új
       //      tömböt allokált → egy 24k-vektoros keresés ~48k tömb-allokáció + GC-spike-ot okozott).
       // A drágán eltárolt `normalizedVectorPool` korábban SOHA nem volt használva a keresésben.
-      const queryNormalized: number[] = LVS_VectorPool_ControlService.l2Normalize(query);
+      const queryNormalized: Float32Array = LVS_VectorPool_ControlService.l2NormalizeFloat32(query);
+      // BFR-AM-013 (NaN-guard, defensive): ha egy tárolt vektor mégis NaN-score-t adna (elvileg az
+      // addVector-guard kizárja), a találat KIESIK — nem mérgezi a rangsort — és warn-t adunk (nem néma).
+      let nanScoreCount: number = 0;
       for (const [id, normalizedVector] of this.normalizedVectorPool.entries()) {
         if (candidateIds && !candidateIds.has(id)) {
           continue;
@@ -248,8 +292,15 @@ export class LVS_VectorPool_ControlService {
         for (let i: number = 0; i < queryNormalized.length; i++) {
           dotProduct += queryNormalized[i] * normalizedVector[i];
         }
+        if (!Number.isFinite(dotProduct)) {
+          nanScoreCount++;
+          continue;
+        }
         results.push({ id, score: dotProduct });
       }
+      if (nanScoreCount) {
+        DyFM_Log.warn(`[LVS search] ${nanScoreCount} vector(s) produced non-finite scores and were skipped.`);
+      }
       // Cosine similarity: csökkenő sorrend (legnagyobb hasonlóság először)
       results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => b.score - a.score);
     } else if (mode === LVS_Search_Mode.l2Distance) {

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

@@ -14,6 +14,8 @@ import * as mongoose from 'mongoose';
 
 import { version as _serverVersion } from '../../../../package.json';
 import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
+import { DyNTS_DbStats, DyNTS_DbStats_Util } from '../../../_services/core/db-stats.service';
+import { DyNTS_Diagnostics, DyNTS_DoctorReport } from '../../../_services/core/diagnostics.service';
 import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
 import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
 import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
@@ -221,6 +223,16 @@ export abstract class DyNTS_ServerStatus_ControlService<
    * A mongoose default-connection. Külön metódus = teszt-seam (spy-jal felülírható, hogy a
    * {@link checkDbReadiness} DB nélkül is tesztelhető legyen).
    */
+  /** BFR-OVERSEER-004 — stats-only DB-diagnosztika a `/server/db-stats` endpointnak (metaadat-only). */
+  async getDbStats(): Promise<DyNTS_DbStats> {
+    return DyNTS_DbStats_Util.collect(this.getMongooseConnection());
+  }
+
+  /** BFR-AM-015 — aggregált doctor-riport a `/server/doctor` endpointnak (sosem dob). */
+  async runDoctor(): Promise<DyNTS_DoctorReport> {
+    return DyNTS_Diagnostics.runDoctor({ connection: this.getMongooseConnection() });
+  }
+
   protected getMongooseConnection(): mongoose.Connection {
     // FIX (2026-07-22) — a `mongoose.connection` NEM feltetlenul az a handle, amit a data-layer hasznal.
     //

package/src/_modules/server/server-status/server-status.controller.ts

@@ -252,6 +252,34 @@ export abstract class DyNTS_ServerStatus_Controller<
         ],
       }),
 
+      // BFR-OVERSEER-004 — stats-only DB-diagnosztika (per-collection count + méret + index-méret;
+      // metaadat-only, SOHA nem dokumentum-tartalom). App-auth-tal gate-elhető (lazyPreProcessesFor).
+      new DyNTS_Endpoint_Params({
+        name: 'getDbStats',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/db-stats',
+        preProcesses: this.lazyPreProcessesFor('getDbStats'),
+        tasks: [
+          async (req: Request, res: Response): Promise<void> => {
+            res.send(await this.server_CS.getDbStats());
+          },
+        ],
+      }),
+
+      // BFR-AM-015 — aggregált doctor (mongo-probe + memory + event-loop + db-stats + app-checkek;
+      // health: ok|warn|fail + per-check fixHint). App-auth-tal gate-elhető.
+      new DyNTS_Endpoint_Params({
+        name: 'getDoctor',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/doctor',
+        preProcesses: this.lazyPreProcessesFor('getDoctor'),
+        tasks: [
+          async (req: Request, res: Response): Promise<void> => {
+            res.send(await this.server_CS.runDoctor());
+          },
+        ],
+      }),
+
       // Readiness-probe: a /health-tel (liveness) szemben a DB-elérhetőséget is ellenőrzi.
       // Public (mint a /health) — orchestrátor/LB hívja; 503 ha a DB nem ready → no traffic.
       new DyNTS_Endpoint_Params({