@futdevpro/nts-dynamo 1.15.151 → 1.15.154

package/_specifications/agent.md

@@ -1,138 +1,138 @@
-
-
-
-
-## Agent
-
-0. A conversation listát megvágjuk, hogy beleférjen a chat-LLM hívásba (maxTokens)
-
-1. Egy elő LLM kérdésben beköthetjük a Routine-okat (a routinok afféle felülírók, megelőzik az utolsó üzenetet, de közben meg kell oldjuk valahogy, hogy az üzenet is feldolgozásra kerüljön, és a routine is érvényesüljön ha kell (van, hogy csak hozzá kell adjunk valamit a parancshoz))
-  - mik alapján keresünk routine-okat:
-    - session doing/goal/intent alapú micro routine-ok (vektor keresés; mindig amikor...)
-    - egyéb micro routine-ok (vektor keresés; mindig amikor...)
-    - idő alapú triggering
-    - ???
-
-2. Egy nagy LLM kérdésben megkérdezzük, hogy az utolsó user message teljesítéséhez... 
-  - milyen operation-ök kellenek
-    - itt felsoroljuk az elérhető operation-öket
-    - Ez lehet több is. 
-    - A: NONE | (operation-with-intent or get-operation-group-with-intent) list
-  - kell-e a kódbázisban keresni
-    - itt felsoroljuk az elérhető projekt-eket
-    - ha igen, mire kell vektorkeressünk
-    - A: NONE | vektor search keywords
-  - kell-e a dokumentumok között keresni keresni
-    - itt felsoroljuk az elérhető dokumentumokat/dokumentum tárakat (attól függően, hogy ne legyen túl sok opció)
-    - ha igen, mire kell vektorkeressünk
-    - A: NONE | vektor search keywords
-  - kell-e a DB context-ben keresni
-    - ha igen, mire kell vektorkeressünk
-    - A: NONE | vektor search keywords
-  - kell-e valamilyen specifikus context adat
-    - itt felsoroljuk az elérhető specifikus context adatokat
-    - ezek olyan speciális adatok amik fixek, és direkt method-okkal adjuk meg őket, 
-      - pontos dátum-idő
-      - user neve/nickneve/amin szólítsa a bot
-      - user data
-      - user settings
-      - ... TODO: add more special context data keys
-    - A: NONE | special context data key
-  Mindegyik input lehet NONE, ami azt jelzi, hogy nincs rá szükség
-
-3. Ha kell, bármilyen info, akkor először azokat gyűjtjük össze
-  - a talált info-kat beletesszük a beszélgetésbe mint assistant message-ek
-    (ezek valójában nem kerülnek elküldésre, a következő üzenet érkezésekkor nem fognak rendelkezésre állni, de elmentjük a db-be az egész conversation listát)
-
-4. Ha kell, akkor lekérjük a kért operation-group-okat és abból újabb LLM kérdéssel összeszedjük a szükséges operation-öket
-  - az operation-group-okat különféle módon szerezhetjük be
-    - Group-olt operation-ök listázása
-    - MCP Server-ről kérés
-    - ... TODO: is there any more operation-group sources?
-
-4. Ha kell, akkor végrehajtjuk a kért operation-öket
-  - a végrehajtás eredményéről röviden beszámolunk/értesítjük a user-t, hogy mit sikerült és nem sikerült csinálni
-    (nem csak a jelenlegi conversation listába tesszük be, hanem tényleg el is küldjük a user-nek egy message-et)
-
-5. Egy újabb LLM kérdéssel kiszedjük az új context-et aminek be kell kerülnie a DB context-be
-  - ha kell akkor a mentendő context-et kell visszaadja, ha nem akkor a NONE
-
-6. Megválaszoljuk a user üzenetét
-
-7. A végeredményt elmentjük a DB-be
-  - minden llm kérdés-választ, 
-  - és a result-okkal feltáplált conversation listát
-  - a vektor keresések eredményeit
-  - (not yet): ha nem messaging platformon vagyunk (discord/slack/teams), akkor chat session-ökbe mentjük az adatokat
-    - ebben az esetben külön kell válogatni azokat a message-eket amiket elküldtünk a user-nek (conversation) attól amik az operation-ök végrehajtása során keletkeznek (logs)
-
-
-## Operation-ök
-  - az operation-ök lista kérésekor hangsúlyozzuk az LLM-nek, hogy mindig próbáljuk a leg apróbb lépésekből összeállítani a listát
-  - minden operation úgy működik mint egy MCP Server kérés, adott egy input schema 
-  - az input-ot a conversation alapján állítjuk össze, úgy hogy az operation intent kerül bele a conversation-be mielőtt egy LLM hívással megpróbáljuk összeállítani az inputot
-    - az input-ok összeállításakor felhívjuk az LLM figyelmét, hogy a mentendő módosítandó adatokat csak akkor manipulálja, ha azt a user kérte, egyébként használjuk a user szava járását
-  - az operation-ok mindig string-et kell visszaadjanak ami szintén a conversation-be kerül bele (ha obj-et kapunk vissza, akkor azt egyszerűen string-gé alakítjuk)
-  - egyes operation-ök több lépéses operation-routine-okként hajtandóak végre (az LLM csak egy operation-t választ ki, de ha az egy operation-routine, akkor azokat hajtjuk végre sorban)
-
-## Routine-ok
-
-### Időalapú és Triggered routine-ok
-  - olyan routine-ok amiket egy adott időpontban/idő után/időközönként hajtunk végre
-  - ezek lehetnek olyan routine-ok is amiket nem egy felhasználói üzenet indít, hanem egy időpont, és ez után automatikusan üzenetet küld egy beállított default csatornára
-  - lehetnek webhook trigger alapúak is
-  - ezek lehetnek továbbá complex rutine-ok amik feladat folyamatokat indukálnak
-    pl.: 
-      - minden reggel nézd át az email-eket és az üzeneteket és amire tudsz válaszolj, amire pedig nem, azt beszéljük át
-      - minden reggel gyűjtsd össze az aktuális top prio feladatokat és segíts megtervezni a napomat
-      - ha új task kerül a rendszerbe, tervezd meg a megvalósítást (de mindenképpen egyeztess róla a PO-val)
-      - az új task resolution plan-eket mindig validáltatssuk le a PO-val
-      - mindig amikor új PR kerül fel az xy repo-ba akkor review-zz
-  
-
-
-### Micro routine-ok
-  - olyan routine-ok amiket módosítanak a user input-on, 
-    pl: mindig amikor kódokat generálunk, akkor figyeljünk oda, a hosszú sorok mindig törve legyenek (ilyenkor ezt mindig hozzáfűzzük a user message-hez)
-  - a micro routine-okat a DB-be mentjük, a kulcs adatokat vektorizálva
-  Adatok:
-    - goal: mindig amikor...
-
-### Egyéb
-  - meg kell keresnünk azt a pontot és értelmezést, hogy hogyan tudunk segíteni a user-nek a gondolatai megfogalmazásában
-    (talán a "2. Egy nagy LLM kérdés"-be bele vehetnénk, hogy ha a user bizonytalannak tűnik, vagy nem összeszedettnek akkor javaslunk egy összeszedettebb inputot, amit ha elfogad, akkor úgy kezeljük mintha a user küldte volna)
-
-
-
-
-
-
-PROMPT
- Az NTS-be szeretnénk implementálni egy Operation Handler Agent-öt, ami ugye az NTS package-be fog bekerülni egy saját modulba, és ezt a modult fogjuk használni a projektek implementálásakor úgy, hogy az IO-Control-ba handleMessage-be kötjük be. 
-
-Úgy kéne beépíteni ezt az Agent-öt, ahogy most is be van építve. Szóval ez az Agent modul, ez magában lesz. Megcsinál mindent, amit leírtunk ebbe a dokumentumban, specifikációba.  Azt már a projekt implementálásnál kell majd megadni, hogy a socket.io-ból behívjuk az agent-öt.
-
-
-
-ezt a CCAP-ba az agent-2 module-ba fejlesztjük le mint POC/prototípus (not like agent module)
-
-
-
-
-
-
-
-
-
-// TODO: we need to create a solution to create a maxed LLM call with 50-50% of the logs and the conversation
-// the logs will go to the userPrompt, after the conversation, but we will need to cut them equally beside the system and control prompt (last user prompt)
-// for the part that is before (both in log and conversation) we will need to be merged to a summary that is added as first (oldest element)
-
-
-
-
-
-
-
-
-
+
+
+
+
+## Agent
+
+0. A conversation listát megvágjuk, hogy beleférjen a chat-LLM hívásba (maxTokens)
+
+1. Egy elő LLM kérdésben beköthetjük a Routine-okat (a routinok afféle felülírók, megelőzik az utolsó üzenetet, de közben meg kell oldjuk valahogy, hogy az üzenet is feldolgozásra kerüljön, és a routine is érvényesüljön ha kell (van, hogy csak hozzá kell adjunk valamit a parancshoz))
+  - mik alapján keresünk routine-okat:
+    - session doing/goal/intent alapú micro routine-ok (vektor keresés; mindig amikor...)
+    - egyéb micro routine-ok (vektor keresés; mindig amikor...)
+    - idő alapú triggering
+    - ???
+
+2. Egy nagy LLM kérdésben megkérdezzük, hogy az utolsó user message teljesítéséhez... 
+  - milyen operation-ök kellenek
+    - itt felsoroljuk az elérhető operation-öket
+    - Ez lehet több is. 
+    - A: NONE | (operation-with-intent or get-operation-group-with-intent) list
+  - kell-e a kódbázisban keresni
+    - itt felsoroljuk az elérhető projekt-eket
+    - ha igen, mire kell vektorkeressünk
+    - A: NONE | vektor search keywords
+  - kell-e a dokumentumok között keresni keresni
+    - itt felsoroljuk az elérhető dokumentumokat/dokumentum tárakat (attól függően, hogy ne legyen túl sok opció)
+    - ha igen, mire kell vektorkeressünk
+    - A: NONE | vektor search keywords
+  - kell-e a DB context-ben keresni
+    - ha igen, mire kell vektorkeressünk
+    - A: NONE | vektor search keywords
+  - kell-e valamilyen specifikus context adat
+    - itt felsoroljuk az elérhető specifikus context adatokat
+    - ezek olyan speciális adatok amik fixek, és direkt method-okkal adjuk meg őket, 
+      - pontos dátum-idő
+      - user neve/nickneve/amin szólítsa a bot
+      - user data
+      - user settings
+      - ... TODO: add more special context data keys
+    - A: NONE | special context data key
+  Mindegyik input lehet NONE, ami azt jelzi, hogy nincs rá szükség
+
+3. Ha kell, bármilyen info, akkor először azokat gyűjtjük össze
+  - a talált info-kat beletesszük a beszélgetésbe mint assistant message-ek
+    (ezek valójában nem kerülnek elküldésre, a következő üzenet érkezésekkor nem fognak rendelkezésre állni, de elmentjük a db-be az egész conversation listát)
+
+4. Ha kell, akkor lekérjük a kért operation-group-okat és abból újabb LLM kérdéssel összeszedjük a szükséges operation-öket
+  - az operation-group-okat különféle módon szerezhetjük be
+    - Group-olt operation-ök listázása
+    - MCP Server-ről kérés
+    - ... TODO: is there any more operation-group sources?
+
+4. Ha kell, akkor végrehajtjuk a kért operation-öket
+  - a végrehajtás eredményéről röviden beszámolunk/értesítjük a user-t, hogy mit sikerült és nem sikerült csinálni
+    (nem csak a jelenlegi conversation listába tesszük be, hanem tényleg el is küldjük a user-nek egy message-et)
+
+5. Egy újabb LLM kérdéssel kiszedjük az új context-et aminek be kell kerülnie a DB context-be
+  - ha kell akkor a mentendő context-et kell visszaadja, ha nem akkor a NONE
+
+6. Megválaszoljuk a user üzenetét
+
+7. A végeredményt elmentjük a DB-be
+  - minden llm kérdés-választ, 
+  - és a result-okkal feltáplált conversation listát
+  - a vektor keresések eredményeit
+  - (not yet): ha nem messaging platformon vagyunk (discord/slack/teams), akkor chat session-ökbe mentjük az adatokat
+    - ebben az esetben külön kell válogatni azokat a message-eket amiket elküldtünk a user-nek (conversation) attól amik az operation-ök végrehajtása során keletkeznek (logs)
+
+
+## Operation-ök
+  - az operation-ök lista kérésekor hangsúlyozzuk az LLM-nek, hogy mindig próbáljuk a leg apróbb lépésekből összeállítani a listát
+  - minden operation úgy működik mint egy MCP Server kérés, adott egy input schema 
+  - az input-ot a conversation alapján állítjuk össze, úgy hogy az operation intent kerül bele a conversation-be mielőtt egy LLM hívással megpróbáljuk összeállítani az inputot
+    - az input-ok összeállításakor felhívjuk az LLM figyelmét, hogy a mentendő módosítandó adatokat csak akkor manipulálja, ha azt a user kérte, egyébként használjuk a user szava járását
+  - az operation-ok mindig string-et kell visszaadjanak ami szintén a conversation-be kerül bele (ha obj-et kapunk vissza, akkor azt egyszerűen string-gé alakítjuk)
+  - egyes operation-ök több lépéses operation-routine-okként hajtandóak végre (az LLM csak egy operation-t választ ki, de ha az egy operation-routine, akkor azokat hajtjuk végre sorban)
+
+## Routine-ok
+
+### Időalapú és Triggered routine-ok
+  - olyan routine-ok amiket egy adott időpontban/idő után/időközönként hajtunk végre
+  - ezek lehetnek olyan routine-ok is amiket nem egy felhasználói üzenet indít, hanem egy időpont, és ez után automatikusan üzenetet küld egy beállított default csatornára
+  - lehetnek webhook trigger alapúak is
+  - ezek lehetnek továbbá complex rutine-ok amik feladat folyamatokat indukálnak
+    pl.: 
+      - minden reggel nézd át az email-eket és az üzeneteket és amire tudsz válaszolj, amire pedig nem, azt beszéljük át
+      - minden reggel gyűjtsd össze az aktuális top prio feladatokat és segíts megtervezni a napomat
+      - ha új task kerül a rendszerbe, tervezd meg a megvalósítást (de mindenképpen egyeztess róla a PO-val)
+      - az új task resolution plan-eket mindig validáltatssuk le a PO-val
+      - mindig amikor új PR kerül fel az xy repo-ba akkor review-zz
+  
+
+
+### Micro routine-ok
+  - olyan routine-ok amiket módosítanak a user input-on, 
+    pl: mindig amikor kódokat generálunk, akkor figyeljünk oda, a hosszú sorok mindig törve legyenek (ilyenkor ezt mindig hozzáfűzzük a user message-hez)
+  - a micro routine-okat a DB-be mentjük, a kulcs adatokat vektorizálva
+  Adatok:
+    - goal: mindig amikor...
+
+### Egyéb
+  - meg kell keresnünk azt a pontot és értelmezést, hogy hogyan tudunk segíteni a user-nek a gondolatai megfogalmazásában
+    (talán a "2. Egy nagy LLM kérdés"-be bele vehetnénk, hogy ha a user bizonytalannak tűnik, vagy nem összeszedettnek akkor javaslunk egy összeszedettebb inputot, amit ha elfogad, akkor úgy kezeljük mintha a user küldte volna)
+
+
+
+
+
+
+PROMPT
+ Az NTS-be szeretnénk implementálni egy Operation Handler Agent-öt, ami ugye az NTS package-be fog bekerülni egy saját modulba, és ezt a modult fogjuk használni a projektek implementálásakor úgy, hogy az IO-Control-ba handleMessage-be kötjük be. 
+
+Úgy kéne beépíteni ezt az Agent-öt, ahogy most is be van építve. Szóval ez az Agent modul, ez magában lesz. Megcsinál mindent, amit leírtunk ebbe a dokumentumban, specifikációba.  Azt már a projekt implementálásnál kell majd megadni, hogy a socket.io-ból behívjuk az agent-öt.
+
+
+
+ezt a CCAP-ba az agent-2 module-ba fejlesztjük le mint POC/prototípus (not like agent module)
+
+
+
+
+
+
+
+
+
+// TODO: we need to create a solution to create a maxed LLM call with 50-50% of the logs and the conversation
+// the logs will go to the userPrompt, after the conversation, but we will need to cut them equally beside the system and control prompt (last user prompt)
+// for the part that is before (both in log and conversation) we will need to be merged to a summary that is added as first (oldest element)
+
+
+
+
+
+
+
+
+

package/build/_models/control-models/app-params.control-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-params.control-model.d.ts","sourceRoot":"","sources":["../../../src/_models/control-models/app-params.control-model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IAEpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;SAIK;IACL,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAIpC,GAAG,EAAE,gBAAgB;CA6ExB"}
+{"version":3,"file":"app-params.control-model.d.ts","sourceRoot":"","sources":["../../../src/_models/control-models/app-params.control-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM1C;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IAEpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;SAIK;IACL,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAIpC,GAAG,EAAE,gBAAgB;CA4ExB"}

package/build/_models/control-models/app-params.control-model.js

@@ -78,8 +78,7 @@ class DyNTS_App_Params {
                 this.dbUri = set.dbUri;
             }
             if (this.dbUri.split('//').length > 2) {
-                fsm_dynamo_1.DyFM_Log.warn('DyNTS_App_Params.constructor: ' +
-                    `dbUri should not contain more than one "//" in "${this.dbUri}".`);
+                fsm_dynamo_1.DyFM_Log.warn('DyNTS_App_Params.constructor: dbUri should not contain more than one "//".');
             }
             this.dbOptions = set.dbOptions ?? {
                 directConnection: true,

package/build/_models/control-models/app-params.control-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-params.control-model.js","sourceRoot":"","sources":["../../../src/_models/control-models/app-params.control-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-params.control-model.js","sourceRoot":"","sources":["../../../src/_models/control-models/app-params.control-model.ts"],"names":[],"mappings":"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"}

package/build/_modules/server/index.d.ts

@@ -1,8 +1,16 @@
 export * from './errors/errors.controller';
 export * from './errors/errors.control-service';
 export * from './errors/errors.data-service';
+export * from './server-status/db-readiness-probe-code.type-enum';
+export * from './server-status/db-readiness-probe-stage.type-enum';
+export * from './server-status/db-readiness-probe.interface';
+export * from './server-status/db-readiness-probe.control-service';
 export * from './server-status/server-status-snapshot.data-service';
 export * from './server-status/server-status-snapshot.control-service';
 export * from './server-status/server-status.control-service';
 export * from './server-status/server-status.controller';
+export * from './safe-diagnostic/safe-diagnostic-cause.type-enum';
+export * from './safe-diagnostic/safe-diagnostic-stage.type-enum';
+export * from './safe-diagnostic/safe-diagnostic.interface';
+export * from './safe-diagnostic/safe-diagnostic.control-service';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/server/index.ts"],"names":[],"mappings":"AAkBA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/server/index.ts"],"names":[],"mappings":"AAkBA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AACnE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AAGzD,cAAc,mDAAmD,CAAC;AAClE,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,mDAAmD,CAAC"}

package/build/_modules/server/index.js

@@ -20,8 +20,17 @@ tslib_1.__exportStar(require("./errors/errors.controller"), exports);
 tslib_1.__exportStar(require("./errors/errors.control-service"), exports);
 tslib_1.__exportStar(require("./errors/errors.data-service"), exports);
 // SERVER-STATUS
+tslib_1.__exportStar(require("./server-status/db-readiness-probe-code.type-enum"), exports);
+tslib_1.__exportStar(require("./server-status/db-readiness-probe-stage.type-enum"), exports);
+tslib_1.__exportStar(require("./server-status/db-readiness-probe.interface"), exports);
+tslib_1.__exportStar(require("./server-status/db-readiness-probe.control-service"), exports);
 tslib_1.__exportStar(require("./server-status/server-status-snapshot.data-service"), exports);
 tslib_1.__exportStar(require("./server-status/server-status-snapshot.control-service"), exports);
 tslib_1.__exportStar(require("./server-status/server-status.control-service"), exports);
 tslib_1.__exportStar(require("./server-status/server-status.controller"), exports);
+// SAFE-DIAGNOSTIC
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic-cause.type-enum"), exports);
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic-stage.type-enum"), exports);
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic.interface"), exports);
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic.control-service"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/server/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,gBAAgB;AAChB,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,aAAa;AACb,mEAAmE;AACnE,EAAE;AACF,oBAAoB;AACpB,0CAA0C;AAC1C,EAAE;AACF,6BAA6B;AAC7B,wEAAwE;AACxE,EAAE;;;AAGF,SAAS;AACT,qEAA2C;AAC3C,0EAAgD;AAChD,uEAA6C;AAE7C,gBAAgB;AAChB,8FAAoE;AACpE,iGAAuE;AACvE,wFAA8D;AAC9D,mFAAyD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/server/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,gBAAgB;AAChB,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,aAAa;AACb,mEAAmE;AACnE,EAAE;AACF,oBAAoB;AACpB,0CAA0C;AAC1C,EAAE;AACF,6BAA6B;AAC7B,wEAAwE;AACxE,EAAE;;;AAGF,SAAS;AACT,qEAA2C;AAC3C,0EAAgD;AAChD,uEAA6C;AAE7C,gBAAgB;AAChB,4FAAkE;AAClE,6FAAmE;AACnE,uFAA6D;AAC7D,6FAAmE;AACnE,8FAAoE;AACpE,iGAAuE;AACvE,wFAA8D;AAC9D,mFAAyD;AAEzD,kBAAkB;AAClB,4FAAkE;AAClE,4FAAkE;AAClE,sFAA4D;AAC5D,4FAAkE"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.d.ts

@@ -0,0 +1,9 @@
+/** Stable, content-free classifications for framework-owned failures. */
+export declare enum DyNTS_SafeDiagnosticCause_Type {
+    dynamoError = "dynamo-error",
+    nativeError = "native-error",
+    object = "object",
+    primitive = "primitive",
+    unknown = "unknown"
+}
+//# sourceMappingURL=safe-diagnostic-cause.type-enum.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-diagnostic-cause.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,oBAAY,8BAA8B;IACxC,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_SafeDiagnosticCause_Type = void 0;
+/** Stable, content-free classifications for framework-owned failures. */
+var DyNTS_SafeDiagnosticCause_Type;
+(function (DyNTS_SafeDiagnosticCause_Type) {
+    DyNTS_SafeDiagnosticCause_Type["dynamoError"] = "dynamo-error";
+    DyNTS_SafeDiagnosticCause_Type["nativeError"] = "native-error";
+    DyNTS_SafeDiagnosticCause_Type["object"] = "object";
+    DyNTS_SafeDiagnosticCause_Type["primitive"] = "primitive";
+    DyNTS_SafeDiagnosticCause_Type["unknown"] = "unknown";
+})(DyNTS_SafeDiagnosticCause_Type || (exports.DyNTS_SafeDiagnosticCause_Type = DyNTS_SafeDiagnosticCause_Type = {}));
+//# sourceMappingURL=safe-diagnostic-cause.type-enum.js.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-diagnostic-cause.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.ts"],"names":[],"mappings":";;;AAAA,yEAAyE;AACzE,IAAY,8BAMX;AAND,WAAY,8BAA8B;IACxC,8DAA4B,CAAA;IAC5B,8DAA4B,CAAA;IAC5B,mDAAiB,CAAA;IACjB,yDAAuB,CAAA;IACvB,qDAAmB,CAAA;AACrB,CAAC,EANW,8BAA8B,8CAA9B,8BAA8B,QAMzC"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.d.ts

@@ -0,0 +1,20 @@
+/** Framework stages that may emit a content-free diagnostic. */
+export declare enum DyNTS_SafeDiagnosticStage_Type {
+    bootstrap = "bootstrap",
+    collectionGrowthMonitor = "collection-growth-monitor",
+    databaseConnect = "database-connect",
+    databaseRuntime = "database-runtime",
+    eventLoopDiagnostic = "event-loop-diagnostic",
+    expressFallback = "express-fallback",
+    globalErrorHandler = "global-error-handler",
+    httpServer = "http-server",
+    httpsServer = "https-server",
+    memoryGuard = "memory-guard",
+    mongoReconnectGuard = "mongo-reconnect-guard",
+    postProcess = "post-process",
+    readiness = "readiness",
+    retention = "retention",
+    routing = "routing",
+    unhandledRejection = "unhandled-rejection"
+}
+//# sourceMappingURL=safe-diagnostic-stage.type-enum.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-diagnostic-stage.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oBAAY,8BAA8B;IACxC,SAAS,cAAc;IACvB,uBAAuB,8BAA8B;IACrD,eAAe,qBAAqB;IACpC,eAAe,qBAAqB;IACpC,mBAAmB,0BAA0B;IAC7C,eAAe,qBAAqB;IACpC,kBAAkB,yBAAyB;IAC3C,UAAU,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,mBAAmB,0BAA0B;IAC7C,WAAW,iBAAiB;IAC5B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,kBAAkB,wBAAwB;CAC3C"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_SafeDiagnosticStage_Type = void 0;
+/** Framework stages that may emit a content-free diagnostic. */
+var DyNTS_SafeDiagnosticStage_Type;
+(function (DyNTS_SafeDiagnosticStage_Type) {
+    DyNTS_SafeDiagnosticStage_Type["bootstrap"] = "bootstrap";
+    DyNTS_SafeDiagnosticStage_Type["collectionGrowthMonitor"] = "collection-growth-monitor";
+    DyNTS_SafeDiagnosticStage_Type["databaseConnect"] = "database-connect";
+    DyNTS_SafeDiagnosticStage_Type["databaseRuntime"] = "database-runtime";
+    DyNTS_SafeDiagnosticStage_Type["eventLoopDiagnostic"] = "event-loop-diagnostic";
+    DyNTS_SafeDiagnosticStage_Type["expressFallback"] = "express-fallback";
+    DyNTS_SafeDiagnosticStage_Type["globalErrorHandler"] = "global-error-handler";
+    DyNTS_SafeDiagnosticStage_Type["httpServer"] = "http-server";
+    DyNTS_SafeDiagnosticStage_Type["httpsServer"] = "https-server";
+    DyNTS_SafeDiagnosticStage_Type["memoryGuard"] = "memory-guard";
+    DyNTS_SafeDiagnosticStage_Type["mongoReconnectGuard"] = "mongo-reconnect-guard";
+    DyNTS_SafeDiagnosticStage_Type["postProcess"] = "post-process";
+    DyNTS_SafeDiagnosticStage_Type["readiness"] = "readiness";
+    DyNTS_SafeDiagnosticStage_Type["retention"] = "retention";
+    DyNTS_SafeDiagnosticStage_Type["routing"] = "routing";
+    DyNTS_SafeDiagnosticStage_Type["unhandledRejection"] = "unhandled-rejection";
+})(DyNTS_SafeDiagnosticStage_Type || (exports.DyNTS_SafeDiagnosticStage_Type = DyNTS_SafeDiagnosticStage_Type = {}));
+//# sourceMappingURL=safe-diagnostic-stage.type-enum.js.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-diagnostic-stage.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts"],"names":[],"mappings":";;;AAAA,gEAAgE;AAChE,IAAY,8BAiBX;AAjBD,WAAY,8BAA8B;IACxC,yDAAuB,CAAA;IACvB,uFAAqD,CAAA;IACrD,sEAAoC,CAAA;IACpC,sEAAoC,CAAA;IACpC,+EAA6C,CAAA;IAC7C,sEAAoC,CAAA;IACpC,6EAA2C,CAAA;IAC3C,4DAA0B,CAAA;IAC1B,8DAA4B,CAAA;IAC5B,8DAA4B,CAAA;IAC5B,+EAA6C,CAAA;IAC7C,8DAA4B,CAAA;IAC5B,yDAAuB,CAAA;IACvB,yDAAuB,CAAA;IACvB,qDAAmB,CAAA;IACnB,4EAA0C,CAAA;AAC5C,CAAC,EAjBW,8BAA8B,8CAA9B,8BAA8B,QAiBzC"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.d.ts

@@ -0,0 +1,19 @@
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import { DyNTS_SafeDiagnosticInput_Interface, DyNTS_SafeDiagnostic_Interface } from './safe-diagnostic.interface';
+/** Projects arbitrary failures to a versioned, content-free public diagnostic. */
+export declare class DyNTS_SafeDiagnostic_ControlService {
+    private static readonly contractVersion;
+    private static readonly defaultCode;
+    private static readonly defaultStatus;
+    /** Returns an immutable exact allowlist and never reflects raw failure content. */
+    static project(input: DyNTS_SafeDiagnosticInput_Interface): DyNTS_SafeDiagnostic_Interface;
+    /** Logs only the projected allowlist and returns the same immutable diagnostic. */
+    static report(input: DyNTS_SafeDiagnosticInput_Interface): DyNTS_SafeDiagnostic_Interface;
+    /** Creates a framework error that carries only the safe diagnostic allowlist. */
+    static toError(diagnostic: DyNTS_SafeDiagnostic_Interface): DyFM_Error;
+    private static getCode;
+    private static getCauseType;
+    private static getStatus;
+    private static getFingerprint;
+}
+//# sourceMappingURL=safe-diagnostic.control-service.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-diagnostic.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic.control-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAY,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EACL,mCAAmC,EACnC,8BAA8B,EAC/B,MAAM,6BAA6B,CAAC;AAErC,kFAAkF;AAClF,qBAAa,mCAAmC;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAwD;IAC/F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAgD;IACnF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAe;IAEpD,mFAAmF;IACnF,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,mCAAmC,GAAG,8BAA8B;IAsB1F,mFAAmF;IACnF,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,mCAAmC,GAAG,8BAA8B;IAQzF,iFAAiF;IACjF,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,8BAA8B,GAAG,UAAU;IAUtE,OAAO,CAAC,MAAM,CAAC,OAAO;IAItB,OAAO,CAAC,MAAM,CAAC,YAAY;IAwB3B,OAAO,CAAC,MAAM,CAAC,SAAS;IAQxB,OAAO,CAAC,MAAM,CAAC,cAAc;CAG9B"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_SafeDiagnostic_ControlService = void 0;
+const crypto_1 = require("crypto");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const safe_diagnostic_cause_type_enum_1 = require("./safe-diagnostic-cause.type-enum");
+/** Projects arbitrary failures to a versioned, content-free public diagnostic. */
+class DyNTS_SafeDiagnostic_ControlService {
+    static contractVersion = 'dynts-safe-diagnostic/1';
+    static defaultCode = 'DYNTS_SAFE_DIAGNOSTIC_INVALID_CODE';
+    static defaultStatus = 500;
+    /** Returns an immutable exact allowlist and never reflects raw failure content. */
+    static project(input) {
+        const code = this.getCode(input.code);
+        const causeType = this.getCauseType(input.error);
+        const status = this.getStatus(input.status);
+        const fingerprint = this.getFingerprint([
+            this.contractVersion,
+            code,
+            input.stage,
+            causeType,
+            status.toString(),
+        ]);
+        return Object.freeze({
+            contractVersion: this.contractVersion,
+            code: code,
+            stage: input.stage,
+            causeType: causeType,
+            fingerprint: fingerprint,
+            status: status,
+        });
+    }
+    /** Logs only the projected allowlist and returns the same immutable diagnostic. */
+    static report(input) {
+        const diagnostic = this.project(input);
+        fsm_dynamo_1.DyFM_Log.error('[DyNTS safe diagnostic]', diagnostic);
+        return diagnostic;
+    }
+    /** Creates a framework error that carries only the safe diagnostic allowlist. */
+    static toError(diagnostic) {
+        return new fsm_dynamo_1.DyFM_Error({
+            errorCode: diagnostic.code,
+            message: `Framework failure at ${diagnostic.stage}. Correlation: ${diagnostic.fingerprint}.`,
+            userMessage: 'A server operation failed. Contact the responsible team with the correlation fingerprint.',
+            additionalContent: { diagnostic: diagnostic },
+            status: diagnostic.status,
+        });
+    }
+    static getCode(code) {
+        return /^[A-Z][A-Z0-9_|-]{2,127}$/.test(code) ? code : this.defaultCode;
+    }
+    static getCauseType(error) {
+        try {
+            if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.dynamoError;
+            }
+            if (error instanceof Error) {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.nativeError;
+            }
+            if (error !== null && typeof error === 'object') {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.object;
+            }
+            if (error !== undefined) {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.primitive;
+            }
+        }
+        catch {
+            return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.unknown;
+        }
+        return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.unknown;
+    }
+    static getStatus(status) {
+        if (typeof status !== 'number' || !Number.isInteger(status) || status < 100 || status > 599) {
+            return this.defaultStatus;
+        }
+        return status;
+    }
+    static getFingerprint(subject) {
+        return (0, crypto_1.createHash)('sha256').update(subject.join('\u0000'), 'utf8').digest('hex');
+    }
+}
+exports.DyNTS_SafeDiagnostic_ControlService = DyNTS_SafeDiagnostic_ControlService;
+//# sourceMappingURL=safe-diagnostic.control-service.js.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.js.map

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

package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.d.ts

@@ -0,0 +1,19 @@
+import { DyNTS_SafeDiagnosticCause_Type } from './safe-diagnostic-cause.type-enum';
+import { DyNTS_SafeDiagnosticStage_Type } from './safe-diagnostic-stage.type-enum';
+/** Caller-owned input whose raw failure content is never returned or logged. */
+export interface DyNTS_SafeDiagnosticInput_Interface {
+    code: string;
+    stage: DyNTS_SafeDiagnosticStage_Type;
+    error?: unknown;
+    status?: number;
+}
+/** Exact public allowlist emitted by the safe diagnostic boundary. */
+export interface DyNTS_SafeDiagnostic_Interface {
+    contractVersion: 'dynts-safe-diagnostic/1';
+    code: string;
+    stage: DyNTS_SafeDiagnosticStage_Type;
+    causeType: DyNTS_SafeDiagnosticCause_Type;
+    fingerprint: string;
+    status: number;
+}
+//# sourceMappingURL=safe-diagnostic.interface.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-diagnostic.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAEnF,gFAAgF;AAChF,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,8BAA8B,CAAC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,yBAAyB,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,8BAA8B,CAAC;IACtC,SAAS,EAAE,8BAA8B,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=safe-diagnostic.interface.js.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-diagnostic.interface.js","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic.interface.ts"],"names":[],"mappings":""}

package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.d.ts

@@ -0,0 +1,14 @@
+/** Stable, content-free result codes emitted by the database-readiness probe. */
+export declare enum DyNTS_DbReadinessProbeCode_Type {
+    ready = "dynts-db-readiness-ready",
+    connectionUnavailable = "dynts-db-readiness-connection-unavailable",
+    disconnected = "dynts-db-readiness-disconnected",
+    connecting = "dynts-db-readiness-connecting",
+    disconnecting = "dynts-db-readiness-disconnecting",
+    stateUnknown = "dynts-db-readiness-state-unknown",
+    databaseUnavailable = "dynts-db-readiness-database-unavailable",
+    pingFailed = "dynts-db-readiness-ping-failed",
+    cancelled = "dynts-db-readiness-cancelled",
+    probeFailed = "dynts-db-readiness-probe-failed"
+}
+//# sourceMappingURL=db-readiness-probe-code.type-enum.d.ts.map

package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-readiness-probe-code.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/server-status/db-readiness-probe-code.type-enum.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oBAAY,+BAA+B;IACzC,KAAK,6BAA6B;IAClC,qBAAqB,8CAA8C;IACnE,YAAY,oCAAoC;IAChD,UAAU,kCAAkC;IAC5C,aAAa,qCAAqC;IAClD,YAAY,qCAAqC;IACjD,mBAAmB,4CAA4C;IAC/D,UAAU,mCAAmC;IAC7C,SAAS,iCAAiC;IAC1C,WAAW,oCAAoC;CAChD"}