@futdevpro/fsm-dynamo 1.16.28 → 1.16.29

package/.cursor/rules/error_code_pattern.md

@@ -1,40 +1,40 @@
-# Error Code Pattern [FDP-Dev-Error]
-
-## Format
-```
-[PROJ]-[SERV]-[FUNC]
-```
-
-## Components
-- PROJ: 3 character project code
-  - FMP: FDP Master Prompter
-  - CUR: Cursor
-  - DYN: Dynamo
-  - etc.
-- SERV: 3-4 character service code (abbreviated from service name)
-  - DTS: _DataService
-  - CTR: _Controller
-  - SSS: _SocketServerService
-  - SCS: _SocketClientService
-  - EMS: _EmailService
-  - etc.
-- FUNC: 3-4 character function code (derived from function name + index)
-  - NC2: newChange (second throw)
-  - GF1: getFile (first throw)
-  - etc.
-
-## Examples
-- FMP-DTS-NC2: Second error in newChange function of TokenHistory_DataService
-- FMP-CTR-GF1: First error in getFile function of User_Controller
-- CUR-SSS-UP3: Third error in updateProfile function of Chat_SocketServerService
-- DYN-SCS-EM1: First error in sendMessage function of Chat_SocketClientService
-- FMP-EMS-NT1: First error in sendNotification function of Notification_EmailService
-- ASD-SSS-ST0: The function's main try and catch rewrap error point.
-
-## Usage
-- Use in all backend error responses
-- Include in error logs
-- Reference in documentation
-- Keep error codes consistent
-- Document all error codes 
+# Error Code Pattern [FDP-Dev-Error]
+
+## Format
+```
+[PROJ]-[SERV]-[FUNC]
+```
+
+## Components
+- PROJ: 3 character project code
+  - FMP: FDP Master Prompter
+  - CUR: Cursor
+  - DYN: Dynamo
+  - etc.
+- SERV: 3-4 character service code (abbreviated from service name)
+  - DTS: _DataService
+  - CTR: _Controller
+  - SSS: _SocketServerService
+  - SCS: _SocketClientService
+  - EMS: _EmailService
+  - etc.
+- FUNC: 3-4 character function code (derived from function name + index)
+  - NC2: newChange (second throw)
+  - GF1: getFile (first throw)
+  - etc.
+
+## Examples
+- FMP-DTS-NC2: Second error in newChange function of TokenHistory_DataService
+- FMP-CTR-GF1: First error in getFile function of User_Controller
+- CUR-SSS-UP3: Third error in updateProfile function of Chat_SocketServerService
+- DYN-SCS-EM1: First error in sendMessage function of Chat_SocketClientService
+- FMP-EMS-NT1: First error in sendNotification function of Notification_EmailService
+- ASD-SSS-ST0: The function's main try and catch rewrap error point.
+
+## Usage
+- Use in all backend error responses
+- Include in error logs
+- Reference in documentation
+- Keep error codes consistent
+- Document all error codes 
 - All error codes should be unique in the entire system across all projects.

package/.cursor/rules/saved rule mcp server use.md

@@ -1,16 +1,16 @@
-
-Always use the CCAP MCP Server search tools (grep_search, codebase_search) for any code or text search, whenever they are available.
-Only use other search tools if the CCAP MCP Server is unavailable or returns an error.
-If a search is performed with a non-CCAP tool, always explain the reason (e.g., CCAP was not available or failed).
-When both local and CCAP search tools are available, always choose the CCAP MCP Server version.
-If the user asks for a search, always default to the CCAP MCP Server, unless explicitly instructed otherwise.
-If the CCAP MCP Server is temporarily unavailable, notify the user and fall back to the local search tool, but try the CCAP MCP Server again as soon as possible.
-Document in your responses which tool was used for the search, and confirm if it was the CCAP MCP Server.
-If the user wants to change this behavior, only do so if they explicitly request it.
-If you are unsure which tool to use, always ask the user, but default to CCAP MCP Server.
-Always follow all other workspace and user rules in addition to these preferences.
-In addition to the above, before and during any code writing, modification, or implementation, you must always:
-Use the CCAP MCP Server's dedicated tools (related_code_search, related_coding_policy_search) to search for related code examples, existing implementations, and relevant coding policies or guidelines in the workspace and documentation.
-Apply any relevant patterns, examples, or policies found via these tools to ensure consistency and best practices in all new code.
-If no clear example or policy is found, use the closest relevant pattern and document this choice in the development process (e.g., in commit messages or PR descriptions).
+
+Always use the CCAP MCP Server search tools (grep_search, codebase_search) for any code or text search, whenever they are available.
+Only use other search tools if the CCAP MCP Server is unavailable or returns an error.
+If a search is performed with a non-CCAP tool, always explain the reason (e.g., CCAP was not available or failed).
+When both local and CCAP search tools are available, always choose the CCAP MCP Server version.
+If the user asks for a search, always default to the CCAP MCP Server, unless explicitly instructed otherwise.
+If the CCAP MCP Server is temporarily unavailable, notify the user and fall back to the local search tool, but try the CCAP MCP Server again as soon as possible.
+Document in your responses which tool was used for the search, and confirm if it was the CCAP MCP Server.
+If the user wants to change this behavior, only do so if they explicitly request it.
+If you are unsure which tool to use, always ask the user, but default to CCAP MCP Server.
+Always follow all other workspace and user rules in addition to these preferences.
+In addition to the above, before and during any code writing, modification, or implementation, you must always:
+Use the CCAP MCP Server's dedicated tools (related_code_search, related_coding_policy_search) to search for related code examples, existing implementations, and relevant coding policies or guidelines in the workspace and documentation.
+Apply any relevant patterns, examples, or policies found via these tools to ensure consistency and best practices in all new code.
+If no clear example or policy is found, use the closest relevant pattern and document this choice in the development process (e.g., in commit messages or PR descriptions).
 If the CCAP MCP Server or these tools are unavailable, follow the fallback and documentation rules above, and notify the user.

package/.vscode/settings.json

@@ -1,11 +1,11 @@
-{
-  "eslint.run": "onSave",
-  "eslint.workingDirectories": [{ "mode": "auto" }],
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit"
-  },
-  "eslint.validate": [
-    "javascript",
-    "typescript"
-  ]
-}
+{
+  "eslint.run": "onSave",
+  "eslint.workingDirectories": [{ "mode": "auto" }],
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "eslint.validate": [
+    "javascript",
+    "typescript"
+  ]
+}

package/LICENSE

@@ -1,21 +1,21 @@
-    MIT License
-
-    Copyright (c) Future Development Program Ltd. (HU)
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE
+    MIT License
+
+    Copyright (c) Future Development Program Ltd. (HU)
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/__documentations/2026-06-01-fr047-fc-foundation.md

@@ -44,5 +44,5 @@ Function calling needed to live in the strategic provider-agnostic layer (not on
 ## Cross-references
 
 - `__agent/feature-requests/FR-047-*.md`, `FR-048-per-model-agnostic-settings.md`
-- `documentations/guidelines/development/ai-per-model-settings.md`
+- `fdp-documentations/guidelines/development/ai-per-model-settings.md`
 - dynamo-nts Phase 2+3 (agent-loop + OpenAI translator) — implemented in parallel.

package/__documentations/2026-06-01-fr047-p1-function-calling-vocabulary.md

@@ -2,7 +2,7 @@
 
 **Commit**: `08e8859` — v01.15.16 → v01.15.17 (published)
 **Parent**: `__agent/feature-requests/FR-047-phase-1-tool-abstraction.md` (master: `FR-047-provider-agnostic-function-calling.md`)
-**Pattern**: `documentations/guidelines/development/ai-function-calling.md`
+**Pattern**: `fdp-documentations/guidelines/development/ai-function-calling.md`
 **Also in this commit**: FR-048 settings-schema reservation (`FR-048-per-model-agnostic-settings.md`)
 
 ## What
@@ -69,7 +69,7 @@ zero AI SDKs. Provider model data lives under `./ai/<provider>` subpaths.
 
 ## Cross-references
 
-- `documentations/guidelines/development/ai-function-calling.md` (pattern)
-- `documentations/guidelines/development/ai-per-model-settings.md` (FR-048)
+- `fdp-documentations/guidelines/development/ai-function-calling.md` (pattern)
+- `fdp-documentations/guidelines/development/ai-per-model-settings.md` (FR-048)
 - `NPM-packages/dynamo-nts/__documentations/2026-06-01-fr047-p2p3-function-calling.md` (the consumer)
 - legacy `NPM-packages/fdp-templates-nts/src/_modules/gpt/_services/gpt-handler.control-service.ts`

package/__documentations/2026-06-22-dyfm-error-extends-error.md

@@ -1,109 +1,109 @@
-# DyFM_Error `extends Error implements DyFM_Metadata` — bedrock redesign
-
-**Dátum:** 2026-06-22
-**Verzió:** `@futdevpro/fsm-dynamo` 01.16.7 → **01.16.8**
-**Érintett fájlok:** `src/_models/control-models/error.control-model.ts`, `src/_models/data-models/metadata.data-model.ts`
-**Eredet:** CCAP Revisioned `BFR-CCAPREVISIONED-001` (Node 22 unhandled-rejection misattribution)
-
----
-
-## 1. A probléma
-
-A `DyFM_Error` eddig `extends DyFM_Metadata` volt, és a `DyFM_Metadata` **nem** `Error`-leszármazott. Emiatt egy
-async-throw `new DyFM_Error({...})` a futtató számára egy **bare-object Promise rejection**-ként ment ki.
-
-**Node 22 strict unhandled-rejection** módban, ha a rejection-érték nem `instanceof Error`, a runtime nem tud
-hozzá throw-site stack-trace-et társítani — ehelyett a **véletlen** (spec-runner sorrend szerinti) éppen futó
-spec-et blame-eli `Error: Unhandled promise rejection: [object Object]` üzenettel. Tünet a CCAP LDP-ben: minden
-futáskor **MÁS** spec esik el (`SCH_ControlService`, `AC2_FunctionCallExecutor_Util`, `RF_ReceivedFilesExtract_Util`
-…), egyik sem a tényleges thrower.
-
-## 2. Döntés
-
-| Opció | Verdikt |
-|---|---|
-| `DyFM_Metadata extends Error` | **ELVETVE** — MINDEN DataModel a `DyFM_Metadata`-ból öröklődik, így minden adat-rekord magával cipelné az `Error` gépezetét (stack-capture stb.). Felesleges blast-radius. |
-| **`DyFM_Error extends Error implements DyFM_Metadata`** | **VÁLASZTOTT** — csak az egyetlen `DyFM_Error` osztály bázisa változik; a metadatát **strukturálisan implementáljuk** (mezők + `applyMetadata`), nem öröklődéssel. |
-
-A `target: es2022` (lásd `tsconfig.json`) miatt a natív class `extends Error` **megőrzi az `instanceof`-ot** — nincs
-szükség az ES5-ös `Object.setPrototypeOf(this, …)` hackre.
-
-## 3. Implementáció
-
-### 3a. `metadata.data-model.ts` — `applyMetadata` statikus kiemelés
-
-A `DyFM_Metadata` constructor-törzse átkerült egy `static applyMetadata(target, set?, init?)`-be (bit-re azonos
-logika). A constructor most ezt hívja. Így a `DyFM_Error` — ami `extends Error` miatt **nem** tud `super(set, init)`-tel
-a `DyFM_Metadata` constructorába lépni — `target`-alapon ugyanazt az init-logikát futtathatja.
-
-### 3b. `error.control-model.ts`
-
-- **Osztály:** `extends DyFM_Metadata` → **`extends Error implements DyFM_Metadata`**.
-- **Metadata-mezők** explicit deklarálva az osztályon (`_id`, `__created`, `__createdBy`, `__lastModified`,
-  `__lastModifiedBy`, `__v`, `_deleted`, `_deletedBy`, `_archived`, `_originalId`) — az `implements` strukturális,
-  ezért a mezőknek létezniük kell.
-- **`stack?: string` deklaráció törölve** — az `Error` már biztosítja; ha bennhagynánk, a class-field-init
-  `undefined`-dal felülírná a natív stacket a `super()` után.
-- **Constructor:**
-  1. `super(set?.message)` — KÖTELEZŐEN az első utasítás (`this` érintése előtt).
-  2. `name` → `'DyFM_Error'` (non-enumerable, `defineProperty`).
-  3. `DyFM_Metadata.applyMetadata(this, set, { issuer })` — a korábbi `super(set, { issuer })` helyett.
-  4. (változatlan eredeti törzs: `_errorCode(s)`, `_message(s)`, `__userMessage(s)`, `errors`, stb.)
-  5. **Szerializációs igazítások** (lásd lent), majd `safeCleanObject`.
-
-### 3c. A két szerializációs buktató és kezelésük (KRITIKUS)
-
-A natív `Error` a `stack`-et és a `message`-et **NON-ENUMERABLE** own-property-ként kezeli. Ezt két helyen kellett
-tudatosan kezelni:
-
-1. **`stack` → enumerable.** A `getErrorsFlat()` `{ ...this }` spread-je és a `getParsable()` / perzisztálás
-   `JSON.stringify`-ja a non-enumerable stacket **elejtené** (regresszió). A constructor végén
-   `Object.defineProperty(this, 'stack', { enumerable: true, … })` visszaállítja az enumerable-séget, így a
-   szerializációs utak megtartják. (A `DyFM_Error` korábban is enumerable stacket adott — ez a viselkedés-megőrzés.)
-
-2. **natív `message` → a `_message`-re állítva (non-enumerable marad).** Extending Error után `(err as Error).message`
-   alapból `''` lenne (a `_message` a forrás), ami megtörné a `(err as Error).message ?? _message` fogyasztói
-   mintát (`'' ?? x === ''`). A constructor végén `Object.defineProperty(this, 'message', { value: this._message …,
-   enumerable: false, … })` ráállítja a valódi üzenetre. **Non-enumerable**, hogy a szerializált shape NE változzon
-   (a `_message` marad a forrás), de a `.message`-olvasók ÉS a Node 22 unhandled-rejection printer a valódi üzenetet
-   lássák.
-
-## 4. Mi NEM tört el (blast-radius, két kör)
-
-A teljes `DyFM_Error` + `DyFM_Errors`/`FDP_Errors` használat felderítve (dynamo-nts, fdp-templates(-nts), dynamo-fsm,
-FE/CLI/builder). Összkép: a kódbázis **flag-alapú `isDyFMError()`-t és POZITÍV `instanceof DyFM_Error` guard-okat**
-használ — mindkettő helyes marad. NINCS érdemi negatív „`instanceof Error` ⇒ tehát nem-DyFM" branch.
-
-- **`isDyFMError` / `isAnyDyFMError`** — flag-duck-type (`flag?.includes('DYNAMO')`), változatlan.
-- **NTS errors-rendszer** (`DyNTS_Errors_DataService.createErrorRecord`) — flag-alapú elágazás + `getErrorSimplified()`
-  (explicit enumerable mezők) → SAFE.
-- **`DyFM_Errors` / `FDP_Errors` perzisztált wrapper** — a `d_error`/`error` mezőt `getErrorSimplified()`-en át tölti
-  (direkt `this.stack` property-read, ami non-enumerable mellett is működik); a hidratáció plain objectet ad vissza,
-  nincs `new DyFM_Error()` / setPrototype / instanceof. Generikus constraint `T_Error extends DyFM_Error` nominálisan
-  továbbra is kielégített. → SAFE.
-- **`getErrorsFlat()` `:476`** `error instanceof Error ? error : ({...subError})` — a `error` itt a `{ ...this }`
-  **spread plain-object**, ami SOHA nem `instanceof Error` (sem előtte, sem utána), így NEM flippel. (Latens intent-bug
-  marad — `subError` lenne a helyes —, de a viselkedése a változással nem módosul, ezért szándékosan nem nyúltunk hozzá.)
-
-### Alacsony-kockázatú follow-up a CONSUMER package-ekben (NEM ebben a commitban)
-Néhány hely `instanceof Error`-ral választ **log-formátumot**, ahol a DyFM_Error mostantól a generikusabb ágra esne
-(nem törés, csak gyengébb diagnosztika). Külön cycle-ben javítandó (explicit `isDyFMError` ág elé):
-- `dynamo-cli`: `update-utils.ts`, `git-utils.ts`, `file-operations.ts`
-- `fdp-templates-nts`: `gpt-handler.control-service.ts:225`
-- `fdp-templates-ngx`: `acc-login.component.ts` clipboard-serializer (rich `_message`/`_errorCode` review)
-
-## 5. Verifikáció
-
-- `npx tsc --noEmit` → 0 hiba.
-- `npx tsc && npx jasmine` → **1409 specs, 0 failures** (70 pending = pre-existing xit).
-- Runtime smoke (a buildelt outputon):
-  - `instanceof Error` = **true** · `instanceof DyFM_Error` = true · `isDyFMError` = true
-  - `name` = `'DyFM_Error'` · natív `.message` = valódi üzenet · `_message` = ugyanaz
-  - `stack` benne a `{ ...e }` spread-ben ÉS a `JSON.stringify`-ban · `message` NINCS a JSON-ban (shape változatlan)
-  - `getErrorsFlat().stack` string · `getErrorSimplified()` ép · metadata `__created`/`__v` ép · error-chain `_errorCodes` ép
-
-## 6. Consumer-rollout (követő, többkörös — CSAK package-ek)
-
-A friss `fsm-dynamo@01.16.8` kiérése után a többi `@futdevpro/*` package-et frissíteni kell, hogy mindenki az új
-javított verziót használja. Ez egy **többkörös, többrétegű** dependency-update sor (nts/ngx/fdp-templates(-nts/-ngx)/cli
-→ majd a LIVE-projektek). A fenti §4 alacsony-kockázatú log-branch follow-up-ok ezzel a hullámmal mehetnek.
+# DyFM_Error `extends Error implements DyFM_Metadata` — bedrock redesign
+
+**Dátum:** 2026-06-22
+**Verzió:** `@futdevpro/fsm-dynamo` 01.16.7 → **01.16.8**
+**Érintett fájlok:** `src/_models/control-models/error.control-model.ts`, `src/_models/data-models/metadata.data-model.ts`
+**Eredet:** CCAP Revisioned `BFR-CCAPREVISIONED-001` (Node 22 unhandled-rejection misattribution)
+
+---
+
+## 1. A probléma
+
+A `DyFM_Error` eddig `extends DyFM_Metadata` volt, és a `DyFM_Metadata` **nem** `Error`-leszármazott. Emiatt egy
+async-throw `new DyFM_Error({...})` a futtató számára egy **bare-object Promise rejection**-ként ment ki.
+
+**Node 22 strict unhandled-rejection** módban, ha a rejection-érték nem `instanceof Error`, a runtime nem tud
+hozzá throw-site stack-trace-et társítani — ehelyett a **véletlen** (spec-runner sorrend szerinti) éppen futó
+spec-et blame-eli `Error: Unhandled promise rejection: [object Object]` üzenettel. Tünet a CCAP LDP-ben: minden
+futáskor **MÁS** spec esik el (`SCH_ControlService`, `AC2_FunctionCallExecutor_Util`, `RF_ReceivedFilesExtract_Util`
+…), egyik sem a tényleges thrower.
+
+## 2. Döntés
+
+| Opció | Verdikt |
+|---|---|
+| `DyFM_Metadata extends Error` | **ELVETVE** — MINDEN DataModel a `DyFM_Metadata`-ból öröklődik, így minden adat-rekord magával cipelné az `Error` gépezetét (stack-capture stb.). Felesleges blast-radius. |
+| **`DyFM_Error extends Error implements DyFM_Metadata`** | **VÁLASZTOTT** — csak az egyetlen `DyFM_Error` osztály bázisa változik; a metadatát **strukturálisan implementáljuk** (mezők + `applyMetadata`), nem öröklődéssel. |
+
+A `target: es2022` (lásd `tsconfig.json`) miatt a natív class `extends Error` **megőrzi az `instanceof`-ot** — nincs
+szükség az ES5-ös `Object.setPrototypeOf(this, …)` hackre.
+
+## 3. Implementáció
+
+### 3a. `metadata.data-model.ts` — `applyMetadata` statikus kiemelés
+
+A `DyFM_Metadata` constructor-törzse átkerült egy `static applyMetadata(target, set?, init?)`-be (bit-re azonos
+logika). A constructor most ezt hívja. Így a `DyFM_Error` — ami `extends Error` miatt **nem** tud `super(set, init)`-tel
+a `DyFM_Metadata` constructorába lépni — `target`-alapon ugyanazt az init-logikát futtathatja.
+
+### 3b. `error.control-model.ts`
+
+- **Osztály:** `extends DyFM_Metadata` → **`extends Error implements DyFM_Metadata`**.
+- **Metadata-mezők** explicit deklarálva az osztályon (`_id`, `__created`, `__createdBy`, `__lastModified`,
+  `__lastModifiedBy`, `__v`, `_deleted`, `_deletedBy`, `_archived`, `_originalId`) — az `implements` strukturális,
+  ezért a mezőknek létezniük kell.
+- **`stack?: string` deklaráció törölve** — az `Error` már biztosítja; ha bennhagynánk, a class-field-init
+  `undefined`-dal felülírná a natív stacket a `super()` után.
+- **Constructor:**
+  1. `super(set?.message)` — KÖTELEZŐEN az első utasítás (`this` érintése előtt).
+  2. `name` → `'DyFM_Error'` (non-enumerable, `defineProperty`).
+  3. `DyFM_Metadata.applyMetadata(this, set, { issuer })` — a korábbi `super(set, { issuer })` helyett.
+  4. (változatlan eredeti törzs: `_errorCode(s)`, `_message(s)`, `__userMessage(s)`, `errors`, stb.)
+  5. **Szerializációs igazítások** (lásd lent), majd `safeCleanObject`.
+
+### 3c. A két szerializációs buktató és kezelésük (KRITIKUS)
+
+A natív `Error` a `stack`-et és a `message`-et **NON-ENUMERABLE** own-property-ként kezeli. Ezt két helyen kellett
+tudatosan kezelni:
+
+1. **`stack` → enumerable.** A `getErrorsFlat()` `{ ...this }` spread-je és a `getParsable()` / perzisztálás
+   `JSON.stringify`-ja a non-enumerable stacket **elejtené** (regresszió). A constructor végén
+   `Object.defineProperty(this, 'stack', { enumerable: true, … })` visszaállítja az enumerable-séget, így a
+   szerializációs utak megtartják. (A `DyFM_Error` korábban is enumerable stacket adott — ez a viselkedés-megőrzés.)
+
+2. **natív `message` → a `_message`-re állítva (non-enumerable marad).** Extending Error után `(err as Error).message`
+   alapból `''` lenne (a `_message` a forrás), ami megtörné a `(err as Error).message ?? _message` fogyasztói
+   mintát (`'' ?? x === ''`). A constructor végén `Object.defineProperty(this, 'message', { value: this._message …,
+   enumerable: false, … })` ráállítja a valódi üzenetre. **Non-enumerable**, hogy a szerializált shape NE változzon
+   (a `_message` marad a forrás), de a `.message`-olvasók ÉS a Node 22 unhandled-rejection printer a valódi üzenetet
+   lássák.
+
+## 4. Mi NEM tört el (blast-radius, két kör)
+
+A teljes `DyFM_Error` + `DyFM_Errors`/`FDP_Errors` használat felderítve (dynamo-nts, fdp-templates(-nts), dynamo-fsm,
+FE/CLI/builder). Összkép: a kódbázis **flag-alapú `isDyFMError()`-t és POZITÍV `instanceof DyFM_Error` guard-okat**
+használ — mindkettő helyes marad. NINCS érdemi negatív „`instanceof Error` ⇒ tehát nem-DyFM" branch.
+
+- **`isDyFMError` / `isAnyDyFMError`** — flag-duck-type (`flag?.includes('DYNAMO')`), változatlan.
+- **NTS errors-rendszer** (`DyNTS_Errors_DataService.createErrorRecord`) — flag-alapú elágazás + `getErrorSimplified()`
+  (explicit enumerable mezők) → SAFE.
+- **`DyFM_Errors` / `FDP_Errors` perzisztált wrapper** — a `d_error`/`error` mezőt `getErrorSimplified()`-en át tölti
+  (direkt `this.stack` property-read, ami non-enumerable mellett is működik); a hidratáció plain objectet ad vissza,
+  nincs `new DyFM_Error()` / setPrototype / instanceof. Generikus constraint `T_Error extends DyFM_Error` nominálisan
+  továbbra is kielégített. → SAFE.
+- **`getErrorsFlat()` `:476`** `error instanceof Error ? error : ({...subError})` — a `error` itt a `{ ...this }`
+  **spread plain-object**, ami SOHA nem `instanceof Error` (sem előtte, sem utána), így NEM flippel. (Latens intent-bug
+  marad — `subError` lenne a helyes —, de a viselkedése a változással nem módosul, ezért szándékosan nem nyúltunk hozzá.)
+
+### Alacsony-kockázatú follow-up a CONSUMER package-ekben (NEM ebben a commitban)
+Néhány hely `instanceof Error`-ral választ **log-formátumot**, ahol a DyFM_Error mostantól a generikusabb ágra esne
+(nem törés, csak gyengébb diagnosztika). Külön cycle-ben javítandó (explicit `isDyFMError` ág elé):
+- `dynamo-cli`: `update-utils.ts`, `git-utils.ts`, `file-operations.ts`
+- `fdp-templates-nts`: `gpt-handler.control-service.ts:225`
+- `fdp-templates-ngx`: `acc-login.component.ts` clipboard-serializer (rich `_message`/`_errorCode` review)
+
+## 5. Verifikáció
+
+- `npx tsc --noEmit` → 0 hiba.
+- `npx tsc && npx jasmine` → **1409 specs, 0 failures** (70 pending = pre-existing xit).
+- Runtime smoke (a buildelt outputon):
+  - `instanceof Error` = **true** · `instanceof DyFM_Error` = true · `isDyFMError` = true
+  - `name` = `'DyFM_Error'` · natív `.message` = valódi üzenet · `_message` = ugyanaz
+  - `stack` benne a `{ ...e }` spread-ben ÉS a `JSON.stringify`-ban · `message` NINCS a JSON-ban (shape változatlan)
+  - `getErrorsFlat().stack` string · `getErrorSimplified()` ép · metadata `__created`/`__v` ép · error-chain `_errorCodes` ép
+
+## 6. Consumer-rollout (követő, többkörös — CSAK package-ek)
+
+A friss `fsm-dynamo@01.16.8` kiérése után a többi `@futdevpro/*` package-et frissíteni kell, hogy mindenki az új
+javított verziót használja. Ez egy **többkörös, többrétegű** dependency-update sor (nts/ngx/fdp-templates(-nts/-ngx)/cli
+→ majd a LIVE-projektek). A fenti §4 alacsony-kockázatú log-branch follow-up-ok ezzel a hullámmal mehetnek.

package/__documentations/plans/00-MASTER-ngx-models-fsm-merge.md

@@ -1,7 +1,7 @@
 > ✅ **KÉSZ (2026-06-06)** — rollout lezárva. Végrehajtott állapot + commit-hash-ek + tanulságok:
 > [`../2026-06-06-ngx-models-merge-completion.md`](../2026-06-06-ngx-models-merge-completion.md).
 > Eltérés a tervtől: 0 converge / 10 distinct (settings paradigma-kötött → Phase 5); bridge-shim helyett
-> hard cutover (a repo archivált). Globális arch-doc: `documentations/guidelines/development/ngx-models-fsm-merge.md`.
+> hard cutover (a repo archivált). Globális arch-doc: `fdp-documentations/guidelines/development/ngx-models-fsm-merge.md`.
 
 # MASTER — `@futdevpro/ngx-dynamo-models` → `@futdevpro/fsm-dynamo` merge + `DyNM_`→`DyFM_` rename
 

package/build/_modules/ai/_models/ai-call-settings.interface.d.ts

@@ -17,7 +17,7 @@
  * Anthropic). Do not assume a field here is universally accepted.
  *
  * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
- *      `documentations/guidelines/development/ai-per-model-settings.md`
+ *      `fdp-documentations/guidelines/development/ai-per-model-settings.md`
  */
 export declare class DyFM_AI_CallSettings {
     systemPrompt?: string;

package/build/_modules/ai/_models/ai-call-settings.interface.js

@@ -20,7 +20,7 @@ exports.DyFM_AI_CallSettings = void 0;
  * Anthropic). Do not assume a field here is universally accepted.
  *
  * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
- *      `documentations/guidelines/development/ai-per-model-settings.md`
+ *      `fdp-documentations/guidelines/development/ai-per-model-settings.md`
  */
 class DyFM_AI_CallSettings {
     systemPrompt = '';

package/build/_modules/ai/_models/ai-model-settings-schema.interface.d.ts

@@ -13,7 +13,7 @@
  * FR-048 is built; treat this as a forward placeholder, not a frozen contract.
  *
  * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
- *      `documentations/guidelines/development/ai-per-model-settings.md`
+ *      `fdp-documentations/guidelines/development/ai-per-model-settings.md`
  */
 export interface DyFM_AI_ModelSettingsSchema {
     /** Agnostic setting keys this model ACCEPTS (e.g. 'temperature','topP','maxTokens','reasoningEffort'). */

package/build/_modules/ai/_modules/anthropic/_collections/aai-models.const.js

@@ -15,7 +15,7 @@ const aai_model_enum_1 = require("../_enums/aai-model.enum");
  * Param note (FR-048): Opus 4.7+ reject `temperature`/`top_p`/`top_k` with 400. This IS now
  * modelled here via `settingsSchema.unsupported` — the general reconciler drops them before the
  * call. The Anthropic translator's local param-drop (FR-047 Phase 4) becomes redundant once it
- * delegates to the reconciler. See `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ * delegates to the reconciler. See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
  */
 /**
  * Opus 4.7+ REJECT the sampling params with HTTP 400 on any non-default value.

package/build/_modules/ai/_modules/fdp-ai/_collections/fdpai-models.const.d.ts

@@ -12,7 +12,7 @@ import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
  * actually accepts depends on the backing model it proxies to, and there is no verified record of that
  * yet; encoding a guess could make the reconciler drop params the gateway does accept. With no schema the
  * reconciler stays permissive (debug-logged). Populate once measured against the live gateway.
- * See `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ * See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
  */
 export declare const DyFM_FdpAI_Models: DyFM_AI_ModelInfo[];
 //# sourceMappingURL=fdpai-models.const.d.ts.map

package/build/_modules/ai/_modules/fdp-ai/_collections/fdpai-models.const.js

@@ -17,7 +17,7 @@ const fdpai_model_enum_1 = require("../_enums/fdpai-model.enum");
  * actually accepts depends on the backing model it proxies to, and there is no verified record of that
  * yet; encoding a guess could make the reconciler drop params the gateway does accept. With no schema the
  * reconciler stays permissive (debug-logged). Populate once measured against the live gateway.
- * See `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ * See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
  */
 exports.DyFM_FdpAI_Models = [
     {

package/build/_modules/ai/_modules/local-ai/_collections/lai-models.const.d.ts

@@ -13,7 +13,7 @@ import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
  * surface of a local model is decided by whatever the user loaded into the backend at runtime, so it is
  * not knowable ahead of time; inventing one would be a guess. With no schema the reconciler stays
  * permissive (passes settings through, with a debug log) — the honest best-effort behaviour.
- * See `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ * See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
  */
 export declare const DyFM_LAI_Models: DyFM_AI_ModelInfo[];
 //# sourceMappingURL=lai-models.const.d.ts.map

package/build/_modules/ai/_modules/local-ai/_collections/lai-models.const.js

@@ -18,7 +18,7 @@ const lai_model_enum_1 = require("../_enums/lai-model.enum");
  * surface of a local model is decided by whatever the user loaded into the backend at runtime, so it is
  * not knowable ahead of time; inventing one would be a guess. With no schema the reconciler stays
  * permissive (passes settings through, with a debug log) — the honest best-effort behaviour.
- * See `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ * See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
  */
 exports.DyFM_LAI_Models = [
     {

package/build/_modules/ai/_modules/open-ai/_collections/oai-models.const.js

@@ -17,7 +17,7 @@ const oai_model_enum_1 = require("../_enums/oai-model.enum");
  * Settings note (FR-048): `settingsSchema` is now populated — it records which tuning
  * params each model ACCEPTS/REJECTS, so the reconciler can drop model-rejected params
  * before the call instead of hard-failing with HTTP 400. See
- * `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ * `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
  */
 /**
  * Models that MEASURABLY reject the sampling params (HTTP 400) and expose `reasoningEffort` instead.

package/build/_modules/socket/_models/sck-socket-event.control-model.js

@@ -70,7 +70,7 @@ class DyFM_SocketEvent {
     async getPreLog(content) {
         try {
             if (this.logEventContent && this.eventKey !== sck_event_key_enum_1.DyFM_SocketEvent_Key.incomingNewConnection) {
-                log_util_1.DyFM_Log.log(`--->   incoming socket(${this.serviceName}) event: ${this.eventKey};
+                log_util_1.DyFM_Log.log(`--->   incoming socket(${this.serviceName}) event: ${this.eventKey};
           \ncontent:`, content);
             }
             else {

package/eslint.config.js

@@ -1,4 +1,4 @@
-const ntsPackageConfig = require('@futdevpro/dynamo-eslint/nts-package');
-
-module.exports = ntsPackageConfig;
-
+const ntsPackageConfig = require('@futdevpro/dynamo-eslint/nts-package');
+
+module.exports = ntsPackageConfig;
+

package/nodemon.json

@@ -1,23 +1,23 @@
-{
-  "exec": "title Test Build of Dynamo-FSM && npm run nodemon-run",
-  "restartable": "rs",
-  "delay": "3000",
-  "ext": ".ts,json",
-  "verbose": false,
-  "legacyWatch": false,
-  "watch": [
-    "./src/*",
-    "package.json",
-    "tsconfig.json"
-  ],
-  "ignore": [
-    "./node_modules",
-    "./build"
-  ],
-  "events": {
-    "start": "echo 🚀 Starting nodemon...",
-    "restart": "echo 🔄 Restarting due to changes...",
-    "crash": "echo 💥 Application crashed!",
-    "exit": "echo 🛑 Application stopped!"
-  }
+{
+  "exec": "title Test Build of Dynamo-FSM && npm run nodemon-run",
+  "restartable": "rs",
+  "delay": "3000",
+  "ext": ".ts,json",
+  "verbose": false,
+  "legacyWatch": false,
+  "watch": [
+    "./src/*",
+    "package.json",
+    "tsconfig.json"
+  ],
+  "ignore": [
+    "./node_modules",
+    "./build"
+  ],
+  "events": {
+    "start": "echo 🚀 Starting nodemon...",
+    "restart": "echo 🔄 Restarting due to changes...",
+    "crash": "echo 💥 Application crashed!",
+    "exit": "echo 🛑 Application stopped!"
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.16.28",
+  "version": "01.16.29",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",