@futdevpro/fsm-dynamo 1.16.30 → 1.16.33

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-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/build/_modules/game/_collections/audio-mixer.util.d.ts

@@ -0,0 +1,55 @@
+import { DyFM_AudioChannel } from '../_enums/audio-channel.enum';
+import { DyFM_AudioMixer_Settings } from '../_models/audio-mixer-settings.interface';
+/**
+ * Statikus util a jatek-audio mixer beallitasaihoz.
+ *
+ * Rendereles-agnosztikus es platform-fuggetlen: NINCS benne DOM, Web Audio, Angular vagy Node
+ * fuggoseg — a tenyleges lejatszast az `@futdevpro/ngx-dynamo` game-modulja (vagy a projekt sajat
+ * motorja) vegzi, ez csak a **modell + szamitas**.
+ *
+ * **Hasznalat:**
+ * ```typescript
+ * const settings: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.merge(loadedFromSave);
+ * const volume: number = DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.music);
+ * audioElement.volume = volume;
+ * ```
+ */
+export declare class DyFM_AudioMixer_Util {
+    /** Alapertelmezett hangero minden csatornara (0..1). */
+    private static readonly defaultVolume;
+    /**
+     * Az alapertelmezett mixer-beallitas. Minden hivas UJ objektumot ad vissza, hogy a
+     * hivo szabadon mutalhassa (nincs megosztott referencia).
+     */
+    static getDefaults(): DyFM_AudioMixer_Settings;
+    /**
+     * Egy hangero-erteket a 0..1 tartomanyba szorit. A nem-szamokat (NaN, undefined, null,
+     * nem-szam tipus) a `fallback`-re cseréli — igy egy serult save-payload sem tud NaN-t
+     * juttatni a lejatszoba (a `HTMLAudioElement.volume = NaN` dobna).
+     */
+    static clamp(value: number, fallback?: number): number;
+    /**
+     * Reszleges (vagy hianyzo) beallitas-objektumbol teljes, ervenyes settingset allit elo:
+     * a hianyzo mezoket a defaultbol veszi, a meglevoket 0..1-re szoritja.
+     *
+     * **Ez a migracios biztositek:** egy regi save-payload, ami meg nem ismerte az `ambience`
+     * csatornat, igy is betoltheto marad.
+     */
+    static merge(partial?: Partial<DyFM_AudioMixer_Settings> | null): DyFM_AudioMixer_Settings;
+    /**
+     * Egy csatorna EFFEKTIV hangereje: a csatorna sajat erteke szorozva a master-rel.
+     * Nemitas (`muted`) eseten mindig 0. A `master` csatornara a sajat erteket adja vissza
+     * (nem negyzetre emelve).
+     */
+    static getEffectiveVolume(settings: DyFM_AudioMixer_Settings, channel: DyFM_AudioChannel): number;
+    /**
+     * Egy csatorna hangerejenek beallitasa — UJ settings-objektumot ad vissza (immutable update),
+     * hogy signal-/state-alapu tarolokban is biztonsagos legyen.
+     */
+    static withChannelVolume(settings: DyFM_AudioMixer_Settings, channel: DyFM_AudioChannel, volume: number): DyFM_AudioMixer_Settings;
+    /** Nemitas beallitasa — UJ settings-objektumot ad vissza (immutable update). */
+    static withMuted(settings: DyFM_AudioMixer_Settings, muted: boolean): DyFM_AudioMixer_Settings;
+    /** Ket beallitas ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
+    static isEqual(a: DyFM_AudioMixer_Settings, b: DyFM_AudioMixer_Settings): boolean;
+}
+//# sourceMappingURL=audio-mixer.util.d.ts.map

package/build/_modules/game/_collections/audio-mixer.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_collections/audio-mixer.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAoB;IAE/B,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAe;IAEpD;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAU9C;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA2C,GAAG,MAAM;IAgB1F;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI,GAAG,wBAAwB;IAgB1F;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,iBAAiB,GACzB,MAAM;IAcT;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,GACb,wBAAwB;IAO3B,gFAAgF;IAChF,MAAM,CAAC,SAAS,CACd,QAAQ,EAAE,wBAAwB,EAClC,KAAK,EAAE,OAAO,GACb,wBAAwB;IAO3B,4FAA4F;IAC5F,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,EAAE,wBAAwB,GAAG,OAAO;CAUlF"}

package/build/_modules/game/_collections/audio-mixer.util.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AudioMixer_Util = void 0;
+const audio_channel_enum_1 = require("../_enums/audio-channel.enum");
+/**
+ * Statikus util a jatek-audio mixer beallitasaihoz.
+ *
+ * Rendereles-agnosztikus es platform-fuggetlen: NINCS benne DOM, Web Audio, Angular vagy Node
+ * fuggoseg — a tenyleges lejatszast az `@futdevpro/ngx-dynamo` game-modulja (vagy a projekt sajat
+ * motorja) vegzi, ez csak a **modell + szamitas**.
+ *
+ * **Hasznalat:**
+ * ```typescript
+ * const settings: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.merge(loadedFromSave);
+ * const volume: number = DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.music);
+ * audioElement.volume = volume;
+ * ```
+ */
+class DyFM_AudioMixer_Util {
+    /** Alapertelmezett hangero minden csatornara (0..1). */
+    static defaultVolume = 0.8;
+    /**
+     * Az alapertelmezett mixer-beallitas. Minden hivas UJ objektumot ad vissza, hogy a
+     * hivo szabadon mutalhassa (nincs megosztott referencia).
+     */
+    static getDefaults() {
+        return {
+            master: this.defaultVolume,
+            music: this.defaultVolume,
+            ambience: this.defaultVolume,
+            effects: this.defaultVolume,
+            muted: false,
+        };
+    }
+    /**
+     * Egy hangero-erteket a 0..1 tartomanyba szorit. A nem-szamokat (NaN, undefined, null,
+     * nem-szam tipus) a `fallback`-re cseréli — igy egy serult save-payload sem tud NaN-t
+     * juttatni a lejatszoba (a `HTMLAudioElement.volume = NaN` dobna).
+     */
+    static clamp(value, fallback = DyFM_AudioMixer_Util.defaultVolume) {
+        if (typeof value !== 'number' || Number.isNaN(value)) {
+            return fallback;
+        }
+        if (value < 0) {
+            return 0;
+        }
+        if (1 < value) {
+            return 1;
+        }
+        return value;
+    }
+    /**
+     * Reszleges (vagy hianyzo) beallitas-objektumbol teljes, ervenyes settingset allit elo:
+     * a hianyzo mezoket a defaultbol veszi, a meglevoket 0..1-re szoritja.
+     *
+     * **Ez a migracios biztositek:** egy regi save-payload, ami meg nem ismerte az `ambience`
+     * csatornat, igy is betoltheto marad.
+     */
+    static merge(partial) {
+        const defaults = this.getDefaults();
+        if (!partial) {
+            return defaults;
+        }
+        return {
+            master: this.clamp(partial.master ?? defaults.master, defaults.master),
+            music: this.clamp(partial.music ?? defaults.music, defaults.music),
+            ambience: this.clamp(partial.ambience ?? defaults.ambience, defaults.ambience),
+            effects: this.clamp(partial.effects ?? defaults.effects, defaults.effects),
+            muted: partial.muted === true,
+        };
+    }
+    /**
+     * Egy csatorna EFFEKTIV hangereje: a csatorna sajat erteke szorozva a master-rel.
+     * Nemitas (`muted`) eseten mindig 0. A `master` csatornara a sajat erteket adja vissza
+     * (nem negyzetre emelve).
+     */
+    static getEffectiveVolume(settings, channel) {
+        const safe = this.merge(settings);
+        if (safe.muted) {
+            return 0;
+        }
+        if (channel === audio_channel_enum_1.DyFM_AudioChannel.master) {
+            return safe.master;
+        }
+        return this.clamp(safe[channel] * safe.master);
+    }
+    /**
+     * Egy csatorna hangerejenek beallitasa — UJ settings-objektumot ad vissza (immutable update),
+     * hogy signal-/state-alapu tarolokban is biztonsagos legyen.
+     */
+    static withChannelVolume(settings, channel, volume) {
+        const next = this.merge(settings);
+        next[channel] = this.clamp(volume);
+        return next;
+    }
+    /** Nemitas beallitasa — UJ settings-objektumot ad vissza (immutable update). */
+    static withMuted(settings, muted) {
+        const next = this.merge(settings);
+        next.muted = muted === true;
+        return next;
+    }
+    /** Ket beallitas ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
+    static isEqual(a, b) {
+        const left = this.merge(a);
+        const right = this.merge(b);
+        return left.master === right.master
+            && left.music === right.music
+            && left.ambience === right.ambience
+            && left.effects === right.effects
+            && left.muted === right.muted;
+    }
+}
+exports.DyFM_AudioMixer_Util = DyFM_AudioMixer_Util;
+//# sourceMappingURL=audio-mixer.util.js.map

package/build/_modules/game/_collections/audio-mixer.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer.util.js","sourceRoot":"","sources":["../../../../src/_modules/game/_collections/audio-mixer.util.ts"],"names":[],"mappings":"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"}

package/build/_modules/game/_collections/audio-scale.util.d.ts

@@ -0,0 +1,57 @@
+import { DyFM_AudioScale } from '../_models/audio-scale.interface';
+/**
+ * Skala-konverziok az audio-mixerhez: a projekt sajat szamabrazolasa (pl. `0-100` egesz)
+ * es a lejatszo API-k altal vart `0..1` kozott.
+ *
+ * **Miert statikus util:** nincs allapota — tiszta fuggvenyek, a `DyFM_Math` mintajara.
+ *
+ * **Hasznalat:**
+ * ```typescript
+ * const percent = DyFM_AudioScale_Util.getPercentScale();
+ * DyFM_AudioScale_Util.toUnit(72, percent);      // 0.72  -> ezt varja a HTMLAudio / GainNode
+ * DyFM_AudioScale_Util.fromUnit(0.725, percent); // 73    -> ezt tarolja / mutatja a projekt
+ * ```
+ */
+export declare class DyFM_AudioScale_Util {
+    /** Alapertelmezett hangero-arany (a skala maximumanak hanyada), ha nincs jobb ertek. */
+    static readonly defaultRatio: number;
+    /**
+     * A `0..1` lebegopontos skala — a Prototyper prototipusai (es a round-1
+     * `DyFM_AudioMixer_Settings`) ezt hasznaljak. Minden hivas UJ objektumot ad vissza, hogy a
+     * hivo szabadon mutalhassa.
+     */
+    static getUnitScale(): DyFM_AudioScale;
+    /**
+     * A `0-100` egesz skala — a Hero Coordinator ezt tarolja a localStorage-ban
+     * (`clampVolume` = `Math.round`). Minden hivas UJ objektumot ad vissza.
+     */
+    static getPercentScale(): DyFM_AudioScale;
+    /**
+     * Sajat skalan levo erteket `0..1`-re normalizal, es a tartomanyba szorit.
+     * Ervenytelen bemenet (NaN, nem-szam, null/undefined) eseten a `fallbackUnit`-ot adja —
+     * igy egy serult save-payload sem tud NaN-t juttatni a lejatszoba
+     * (`HTMLAudioElement.volume = NaN` dobna, a `GainNode.gain.value = NaN` elnemitana).
+     */
+    static toUnit(value: number, scale: DyFM_AudioScale, fallbackUnit?: number): number;
+    /**
+     * `0..1` erteket a sajat skalara alakit vissza. Egesz skalanal (`integer: true`) kerekit,
+     * igy a `0-100`-as UI-nak nem kell tortszamokkal dolgoznia.
+     */
+    static fromUnit(unit: number, scale: DyFM_AudioScale): number;
+    /**
+     * Egy erteket a sajat skala `0..max` tartomanyaba szorit (egesz skalanal kerekit is).
+     *
+     * Ervenytelen bemenetre (NaN, nem-szam) a `fallbackScaleValue`-t adja — **a sajat skalan**.
+     * Alapertelmezesben `0`; a mixer viszont a csatorna DEFAULT-jat adja at, mert egy serult
+     * mentesbol jobb a hallhato alapertek, mint a nema 0 (a felhasznalo eszre sem venne).
+     */
+    static clampToScale(value: number, scale: DyFM_AudioScale, fallbackScaleValue?: number): number;
+    /** Egy `0..1` erteket a tartomanyba szorit. */
+    static clampUnit(value: number): number;
+    /**
+     * A skala maximuma vedve: a hianyzo / nem-pozitiv / NaN maximumot `1`-re cseréli, hogy a
+     * nullaval valo osztas es a NaN-terjedes kizart legyen.
+     */
+    private static getSafeMax;
+}
+//# sourceMappingURL=audio-scale.util.d.ts.map