@futdevpro/fsm-dynamo 1.16.39 → 1.16.40

package/__documentations/2026-06-06-ngx-models-merge-completion.md

@@ -0,0 +1,100 @@
+# ✅ ngx-dynamo-models → fsm-dynamo merge — COMPLETION REPORT
+
+> **UI-20260604-002** · Dátum: **2026-06-06** · Státusz: **KÉSZ (rollout lezárva)**
+> Kapcsolódó tervek: [`plans/00-MASTER-ngx-models-fsm-merge.md`](./plans/00-MASTER-ngx-models-fsm-merge.md),
+> [`plans/01-naming-convention-DyNM-to-DyFM.md`](./plans/01-naming-convention-DyNM-to-DyFM.md),
+> [`plans/02-consumer-rollout.md`](./plans/02-consumer-rollout.md).
+
+## Context — miért
+
+A `@futdevpro/ngx-dynamo-models` (`DyNM_` prefix, 76 forrás + 12 spec) egy **framework-agnosztikus** model/enum/control-model
+gyűjtemény volt (az egyetlen `@angular` import ki volt kommentezve). **Körkörös függésben** állt a `fsm-dynamo`-val
+(peerDependency), miközben tartalmilag a fsm `DyFM_` rétegének UI-közeli kiterjesztése.
+
+**Cél:** bemozgatni a `fsm-dynamo` egy submodulja alá (`_modules/ngx-models`), egységesíteni a névkonvenciót
+`DyNM_`→`DyFM_`-re (user-direktíva 2026-06-06), átállítani az összes fogyasztót, deprecate-elni a régi package-et.
+**Eredmény:** egyetlen bedrock model-package, megszűnt körkörös függés, egységes `DyFM_` névkonvenció.
+
+## Mit csináltunk — végrehajtott állapot
+
+### Wave 0 — modul-integráció + rename (fsm-dynamo, additív)
+- Új submodul: `src/_modules/ngx-models/` (88 fájl: `_collections`, `_enums`, `_models`, `_utils`, `index.ts`).
+- A 8 db `@futdevpro/fsm-dynamo` (+1 `/socket`) import → **belső relatív** importtá írva (a fsm submodul-minta szerint).
+- Subpath export: `package.json` `exports` + `typesVersions` → `@futdevpro/fsm-dynamo/ngx-models`.
+- **`DyNM_`→`DyFM_` rename**: 105 exportált szimbólum, identifier-only (AST-biztos) codemod.
+- Build + jasmine: **1409 spec, 0 failure** (a 12 áthozott ngx spec is). Publikálva: **`fsm-dynamo@1.15.22`**.
+
+### Collision-kezelés — 3 kategória (VERIFIKÁLT besorolás)
+10 db `DyNM_X` ütközött már létező `DyFM_X`-szel. Forrás-ellenőrzéssel kiderült, hogy a settings-cluster
+**paradigma-kötött** (signal `dependencyDataHandler` vs rxjs) → összeolvasztásuk eltörné a signal-handlert.
+**Döntés: 0 converge, mind a 10 → distinct `DyFM_` név, a tényleges konvergencia → Phase 5.**
+
+| Régi `DyNM_` | Új distinct `DyFM_` |
+|---|---|
+| `DyNM_DataHandler` | `DyFM_SignalDataHandler` |
+| `DyNM_DataHandlerDataLoadInProgress` | `DyFM_SignalDataHandlerDataLoadInProgress` |
+| `DyNM_DataHandlerDataLoadPostProcess` | `DyFM_SignalDataHandlerDataLoadPostProcess` |
+| `DyNM_DataHandler_Settings` | `DyFM_SignalDataHandler_Settings` |
+| `DyNM_DataListHandler_Settings` | `DyFM_SignalDataListHandler_Settings` |
+| `DyNM_DataSearchHandler_Settings` | `DyFM_SignalDataSearchHandler_Settings` |
+| `DyNM_ListCollectorDataHandler_Settings` | `DyFM_SignalListCollectorDataHandler_Settings` |
+| `DyNM_Error_Settings` | `DyFM_ErrorDisplay_Settings` |
+| `DyNM_Global_Settings` | `DyFM_UiGlobal_Settings` |
+| `DyNM_global_settings` | `DyFM_uiGlobal_settings` |
+
+A maradék **95** szimbólum tiszta `DyNM_X`→`DyFM_X`. **Kivétel:** a `DyNM_STORAGE_ENCRYPTION_KEY` **string-literál**
+(runtime env-var kulcs) **VÁLTOZATLAN** — átnevezése a Keystore/deploy-kontraktust törné (FR-015).
+
+### Hard cutover (NEM bridge-shim)
+A `dynamo-ngx-models` GitHub repo **archivált (read-only)** → bridge-shim nem publikálható. Ezért **tiszta hard cutover**:
+minden fogyasztó közvetlenül átállt, a régi `ngx-dynamo-models@1.15.14` npm-en marad fallbacknek, majd **deprecate-elve**.
+
+## Rollout — publikált/pushed (commit-hash-ekkel)
+
+| Réteg | Verzió / commit | Build |
+|---|---|---|
+| **fsm-dynamo** | `1.15.22` (`319c512`) | ✅ 1409/0 |
+| **dynamo-ngx** | `18.15.11` (`236a82f`) | ✅ ng-packagr (DyNX_DataHandler → extends DyFM_SignalDataHandler) |
+| **dynamo-builder-models** | `1.15.13` (`c152f2a`) | ✅ tsc + 232/0 |
+| **ngx-fdp-templates** | `18.15.21` (`893bdfb`) | ✅ karma 48/0 (teszt-fix után) |
+| **LIVE (10)** | art-tarot `c5548ee` · dum `3042efc` · war-factory `a611fc8` · adventor `6c2d194` · fdp-assistant `3ebcf50` · overseer `309fea3` · organizer `885430d` · warbots `062331b` · fdp-pal `3837635` · dynamo-builder `bb63b1a` | 8 lokál build-green; 2 lásd alább |
+| **Template (2)** | dynamo-template-project `7a11c11` · fdp-template-project `bf98bd3` | codemod (client+mobile) |
+| **OGS** | oldlight-site `f50f520` (docs/ogs-site-spec-plan branch) | codemod |
+| **ngx-dynamo-models** | `1.15.14` — **DEPRECATED** az npm-en | fallback fury/STALE-nek |
+
+## Megoldott akadályok + rendszerszintű tanulságok
+
+1. **Supply-chain policy (`minimumReleaseAge`)** — a frissen publikált bedrock-verziókat blokkolta. **GLOBÁLIS SZABÁLY:**
+   `minimumReleaseAgeExclude: ['@futdevpro/*']` wildcard minden repó `pnpm-workspace.yaml`-jában.
+2. **Semver vezető-nulla gotcha** — a dep-spec **NEM** lehet vezető-nullás (`1.15.22`, nem `01.15.22`); peer-ként nem matchel.
+   (A `version` mező marad vezető-nullás — csak a dep-spec tiszta semver.)
+3. **`allowBuilds` placeholder** — a pnpm v11 `set this to true or false` placeholdert generál; `true`-ra kell állítani,
+   különben az esbuild/lmdb natív build kimarad és az Angular build elhal.
+4. **FR-014 auth-interceptor teszt** (ngx-fdp-templates) — a mai auth-proxy SSOT config-drift (`/auth-api`→`/api`,
+   `/auth/refresh-pair`→`/refresh-pair`) miatt bukott; a teszt a régi URL-t drótozta. **Fix:** a teszt a
+   `FDP_authApiEnv_settings`-ből építi az auth-flow URL-t (robusztus, nem drótozott). NEM az ngx-models migráció okozta.
+5. **check-dev-leftovers CI-step (MINDEN consumer!)** — a `dc ci-ck-dl` PACKAGE_VERSIONS ellenőrzés a
+   `.dynamo/pipeline.cicd.config.json` (template-eknél root `pipeline.cicd.config.json`) `packages` listájában elvárja
+   az ott felsorolt @futdevpro csomagokat. A dep eltávolítása után a checker "not found in package.json"-nal BUKIK,
+   és a step `fatal:true` a LIVE/template configokban → az egész CI elhal (a client-build maga zöld!). **KÖTELEZŐ záró-lépés:
+   minden migrált consumer CICD-configjából kivenni a `@futdevpro/ngx-dynamo-models`-t a PACKAGE_VERSIONS listából.**
+   Elvégezve mind a 12 consumer-en (dum 85d6064, war-factory e43a497, organizer 086d134, art-tarot 79901e9,
+   fdp-template-project ebdfbed, dynamo-builder 05f5f1e, oldlight-site b5b3f30, fdp-pal accc04f, fdp-assistant 038a45d,
+   warbots 82979d2, dynamo-template-project 1fbbafb, adventor 6219b06).
+
+## Ismert, tudatosan hagyott elemek (follow-up)
+
+- **fdp-pal** (`3837635`): **PRE-EXISTING** build-hiba (`NgxMaskPipe` AOT) — a migráció nélkül is reprodukálódik
+  (stash-elt pristine build is bukik). NEM az ngx-models migráció; a fdp-pal-tulaj külön javítja.
+- **dynamo-builder** (`bb63b1a`): lokál **Windows natív postinstall crash** (esbuild/lmdb); a Linux CI-runner tisztán épít.
+- **Phase 5** (külön feladat): a 10 distinct-re keresztelt signal/UI cluster **tényleges összevonása** a rxjs `DyFM_`
+  réteggel (signal↔observable paradigma-refaktor). Lásd a megmaradt `DyFM_Signal*` neveket.
+- **fury** (STALE): a deprecated `ngx-dynamo-models@1.15.14`-en marad (tudatosan elengedve).
+- **fdp-github-actions** dev-leftovers fixture-ök: szándékos teszt-adat, NEM migrálandó.
+
+## Verifikáció
+
+- **Workspace-sweep:** `grep -rl '@futdevpro/ngx-dynamo-models'` (node_modules/build/DISABLED/tgz nélkül) → **0 valódi találat**.
+- **npm:** `npm view @futdevpro/ngx-dynamo-models deprecated` → a deprecation-üzenetet adja.
+- **fsm-dynamo modul:** `grep -rE '\bDyNM_' src/_modules/ngx-models` → csak a védett `DyNM_STORAGE_ENCRYPTION_KEY` env-kulcs.
+- Minden publikált package + 8 LIVE: build-green (lokál és/vagy CI).

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

@@ -0,0 +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.

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

@@ -0,0 +1,75 @@
+> ✅ **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: `fdp-documentations/guidelines/development/ngx-models-fsm-merge.md`.
+
+# MASTER — `@futdevpro/ngx-dynamo-models` → `@futdevpro/fsm-dynamo` merge + `DyNM_`→`DyFM_` rename
+
+> Koordinációs master-plan (UI-20260604-002). Dátum: 2026-06-06.
+> Egyedi al-tervek: [`01-naming-convention-DyNM-to-DyFM.md`](./01-naming-convention-DyNM-to-DyFM.md),
+> [`02-consumer-rollout.md`](./02-consumer-rollout.md).
+> Ez a fájl CSAK koordinál — a részletek az al-tervekben.
+
+## Context — miért
+
+A `@futdevpro/ngx-dynamo-models` (mappa: `NPM-packages/dynamo-ngx-models`, `DyNM_` prefix, 76 forrás + 12 spec)
+egy **framework-agnosztikus** model/enum/control-model gyűjtemény (az egyetlen `@angular` import ki van
+kommentezve). Ma **körkörös függésben** van a `@futdevpro/fsm-dynamo`-val (peerDependency `fsm-dynamo` 1.15.21),
+miközben tartalmilag a fsm-dynamo `DyFM_` rétegének UI-közeli kiterjesztése.
+
+**Cél**: bemozgatni a fsm-dynamo egy submodulja alá (`_modules/ngx-models`), átnevezni a `DyNM_` szimbólumokat
+`DyFM_`-re (user-direktíva 2026-06-06), átállítani az összes fogyasztót, majd az ngx-dynamo-models-t deprecate-elni.
+Eredmény: egy bedrock model-package, megszűnő körkörös függés, egységes `DyFM_` névkonvenció.
+
+## A három fő munka
+
+| # | Al-terv | Lényeg |
+|---|---------|--------|
+| A | [01 — Naming](./01-naming-convention-DyNM-to-DyFM.md) | 105 `DyNM_` szimbólum → `DyFM_`: 95 tiszta, 6 konvergál, 4 külön-névre. Codemod + ütközés-feloldás. |
+| B | [02 — Consumer rollout](./02-consumer-rollout.md) | 113 fájl / 15 projekt top-down, hullámokban, bridge-shimmel + validation gate-ekkel. |
+| C | Modul-integráció (lent) | A kód fizikai bemozgatása a fsm-dynamo-ba + subpath export. |
+
+## C — Modul-integráció a fsm-dynamo-ba (additív)
+
+Követett minta: meglévő `src/_modules/<modul>/index.ts` + `package.json` `exports`/`typesVersions` subpath
+(pl. `./crypto`, `./state-machine`). Belső modulok **relatív** importtal hivatkoznak a root-ra (`from '../../..'`).
+
+1. Új mappa `src/_modules/ngx-models/` — az ngx `_collections`, `_enums`, `_models` bemozgatva.
+2. A 8 `@futdevpro/fsm-dynamo` (+1 `/socket`) import → relatív belső import. A 9 szimbólum mind létezik a fsm-ben.
+3. `package.json`: `"./ngx-models"` export + `typesVersions["ngx-models"]`.
+4. A `DyNM_`→`DyFM_` rename (A al-terv) a bemozgatott modulon belül történik.
+
+## Sorrend (gate-elt hullámok)
+
+```
+Wave 0  Modul-integráció + rename a fsm-dynamo-ban (C + A) ──┐ bedrock, additív+rename
+                                                              ├─ publish fsm-dynamo
+Wave 0b ngx-dynamo-models → bridge-shim (re-export fsm/ngx-models) + DyNM_ deprecated-alias réteg
+─────────────────────────────  USER VALIDATION GATE  ─────────────────────────────
+Wave 1  NPM hubok: dynamo-ngx (7 collision-fájl!), fdp-templates-ngx, dynamo-builder-models
+─────────────────────────────  USER VALIDATION GATE  ─────────────────────────────
+Wave 2  LIVE prio szerint: organizer(46) → dynamo-builder(18) → overseer(13) → fdp-assistant(6) → adventor(5) → ...
+Wave 3  TEMPLATE-ek (+ `dc pattern` snapshot refresh) + OGS oldlight-site
+Wave 4  Tooling (fdp-github-actions fixture-ök) + `npm deprecate` ngx-dynamo-models + sunset
+```
+
+> A bridge-shim + `DyNM_` deprecated-aliasok miatt a Wave 1–4 NEM törésveszélyes: a régi `DyNM_` nevek és a régi
+> package-import is működik, amíg a fogyasztó migrál. Lásd [02](./02-consumer-rollout.md).
+
+## Phase 5 (külön feladat, NEM ez)
+
+A 4 divergens collision (signal-vs-observable DataHandler, UI-vs-data Error_Settings, UI-vs-infra Global_Settings)
+tényleges **összevonása/leépítése** — önálló plan, a rename után. Itt CSAK külön-névre keresztelünk + deprecated.
+
+## Bedrock-megkötések, amik érvényesek
+
+- A rename most **user-engedélyezett** (felülírja a `bedrock-no-unverified-rename` defaultot) — de a 4 divergens esetnél
+  NEM nevezünk át foglalt névre, hanem distinct `DyFM_` névre + alias-bridge (behavior-megőrzés).
+- `forward-only / no-rollback`: minden hullám előre lép; a shim a visszafelé-kompat eszköze, nem rollback.
+- `push-discipline`: hullámonként bundle-ölt commit, zöld teszt után push.
+
+## Globális verifikáció
+
+- Wave 0 után: `dynamo-fsm` build+jasmine zöld (12 áthozott spec is); subpath-feloldás füstteszt.
+- Minden hullám: érintett package/projekt build+teszt zöld a gate előtt.
+- Záró: workspace-szintű `grep DyNM_` csak a deprecated-alias rétegben ad találatot.

package/__documentations/plans/01-naming-convention-DyNM-to-DyFM.md

@@ -0,0 +1,103 @@
+# 01 — Naming convention átvezetés: `DyNM_` → `DyFM_`
+
+> Al-terv a [MASTER](./00-MASTER-ngx-models-fsm-merge.md)-hez. Dátum: 2026-06-06.
+
+## Context
+
+A bemozgatott model-réteg ma `DyNM_` (Dynamo NGX Models) prefixet használ; a fsm-dynamo `DyFM_` (Dynamo Full-stack
+Models). A user direktívája: egységesítsünk `DyFM_`-re. **Ez NEM vak prefix-csere** — 105 `DyNM_` szimbólumból 10
+ütközik már létező `DyFM_` névvel, és ezek egy része teljesen más doménű. A terv ezt a 3 kategóriát kezeli.
+
+Felmérés (mind verifikált): **105** exportált `DyNM_` szimbólum, **312** `DyFM_` a fsm-ben, **10** név-ütközés,
+**2** élő legacy alias (`D_Button_P`, `D_Button_Params`, fogyasztó nem használja), **113** érintett fájl / 15 projekt.
+
+## A 3 kategória
+
+### Kategória 1 — Tiszta átnevezés (95 szimbólum)
+Nincs `DyFM_` ütközés → mechanikus `DyNM_X` → `DyFM_X` csere a definícióban ÉS minden használati helyen.
+Reprezentatív minták: `DyNM_Button_Settings`, `DyNM_Field_Settings`, `DyNM_Form_Settings`, `DyNM_FormNew_Settings`,
+`DyNM_Voice*` (14 db), `DyNM_*FieldNew_Settings` (8 db), összes `_enums/*` enum-NÉV, `DyNM_*Placeholder` (4 db),
+`DyNM_sameObjects`, `DyNM_setExisitngNonSetValuesOnly`, stb.
+
+**Enum-caveat**: az enum NEVE változik (`DyNM_Button_Type`→`DyFM_Button_Type`), de a string-VALUE-k VÁLTOZATLANOK
+(CSS-class-ekre képződnek, a forrásban explicit warning — `button-type.enum.ts`). A codemod csak az azonosítót cseréli, az értékeket SOHA.
+
+> ⚠️ **VERIFIED REVISION (2026-06-06, Wave-0 végrehajtáskor)** — a Kat-2 „6 converge" besorolás forrás-ellenőrzés
+> után **felülírva**. A 4 settings-osztály (`DyNM_DataHandler_Settings` + 3 leszármazott) a `dependencyDataHandler?:`
+> / `dependentDataHandlers?:` / `getPostProcess?:` mezőkön át **paradigma-kötött** a signal `DyNM_DataHandler`-hez;
+> a fsm `DyFM_DataHandler_Settings` ugyanezeket az **rxjs** `DyFM_DataHandler`-re tipizálja. Összeolvasztásuk
+> **eltörné a signal-handler dependency-típusát** → NEM converge-elhetők, a Phase 5 paradigma-refaktorhoz tartoznak.
+> **Tényleges Wave-0 döntés: mind a 10 ütközés → DISTINCT `DyFM_` név (lásd lent), NULLA converge, NULLA bedrock-módosítás,
+> NULLA törlés. Minden konvergencia → Phase 5.** A 2 belső típus (`...DataLoadInProgress/PostProcess`) bitre azonos a
+> fsm-ével (converge-elhető lett volna), de a cluster-önállóságért szintén distinct `DyFM_Signal...` nevet kaptak.
+> Végrehajtott rename + build+jasmine zöld (1409 spec, 0 fail). Az alábbi eredeti Kat-2/3 szöveg a kiindulási terv.
+
+### Kategória 2 — ~~Konvergáló ütközés (6 szimbólum)~~ → VERIFIED: Phase 5-re halasztva (lásd fenti revízió)
+Itt NEM hozunk létre új `DyFM_X`-et, hanem a bemozgatott DyNM_ definíciót **töröljük**, és a használatok a
+fsm meglévő `DyFM_X`-ére mutatnak (ekvivalens/superset, drop-in vagy kis igazítás).
+
+| DyNM_ szimbólum | fsm cél | Verdict | Teendő |
+|---|---|---|---|
+| `DyNM_DataHandlerDataLoadInProgress` | `DyFM_DataHandlerDataLoadInProgress` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_DataHandlerDataLoadPostProcess` | `DyFM_...PostProcess` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_DataSearchHandler_Settings` | `DyFM_DataSearchHandler_Settings` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_ListCollectorDataHandler_Settings` | `DyFM_ListCollector...` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_DataHandler_Settings` | `DyFM_DataHandler_Settings` | SUPERSET | fsm-be portolni a plusz mezőt (`dontDefaultSetActiveItem` lánc), majd fsm-re mutat |
+| `DyNM_DataListHandler_Settings` | `DyFM_DataListHandler_Settings` | SUPERSET | mint fent |
+
+> A DyNM superset-mezők (`createObservable`, `loopSafety`) a signal-világhoz tartoznak — ezek a Kat-3
+> `DataHandler` döntéséhez kötöttek, NEM a settings-konvergenciához. Lásd Kat-3 / Phase 5.
+
+### Kategória 3 — Divergens ütközés (4 szimbólum) → DISTINCT `DyFM_` név + alias-bridge
+Csak a NÉV egyezik, a tartalom más doménű. Foglalt névre átnevezni TILOS (törne). → új, megkülönböztető `DyFM_` név,
++ deprecated alias a régi `DyNM_` néven (behavior-megőrzés a fogyasztóknak). Tényleges összevonás = Phase 5.
+
+| DyNM_ szimbólum | Mi ez | Ütközik | Javasolt DISTINCT név (döntést igényel) |
+|---|---|---|---|
+| `DyNM_DataHandler` (abstract, **signal**-alapú) | UI signal data-handler | `DyFM_DataHandler` (Observable) | **`DyFM_SignalDataHandler`** |
+| `DyNM_Error_Settings` (UI display settings, 7 mező) | error-komponens megjelenítés | `DyFM_Error_Settings` (error adat-modell, 22+ mező) | **`DyFM_ErrorDisplay_Settings`** |
+| `DyNM_Global_Settings` (UI/form globál) | Angular UI globál config | `DyFM_Global_Settings` (infra) | **`DyFM_UiGlobal_Settings`** |
+| `DyNM_global_settings` (const) | a fenti példánya | `DyFM_global_settings` (const) | **`DyFM_uiGlobal_settings`** |
+
+> ⚠️ **Nyitott döntés**: a 4 distinct név (`DyFM_SignalDataHandler`, `DyFM_ErrorDisplay_Settings`,
+> `DyFM_UiGlobal_Settings`, `DyFM_uiGlobal_settings`). Fenti = ajánlás; a user módosíthatja.
+
+### ✅ VÉGREHAJTOTT distinct-rename map (Wave-0, user-jóváhagyott + verified-kiterjesztett)
+
+Mind a 10 ütközés distinct `DyFM_` nevet kapott (a settings-cluster a paradigma-kötöttség miatt szintén ide került):
+
+| Régi `DyNM_` | Új distinct `DyFM_` | Megjegyzés |
+|---|---|---|
+| `DyNM_DataHandler` | `DyFM_SignalDataHandler` | user-jóváhagyott |
+| `DyNM_DataHandlerDataLoadInProgress` | `DyFM_SignalDataHandlerDataLoadInProgress` | bitre = fsm, de cluster-önállóság |
+| `DyNM_DataHandlerDataLoadPostProcess` | `DyFM_SignalDataHandlerDataLoadPostProcess` | bitre = fsm, de cluster-önállóság |
+| `DyNM_DataHandler_Settings` | `DyFM_SignalDataHandler_Settings` | paradigma-kötött |
+| `DyNM_DataListHandler_Settings` | `DyFM_SignalDataListHandler_Settings` | paradigma-kötött |
+| `DyNM_DataSearchHandler_Settings` | `DyFM_SignalDataSearchHandler_Settings` | paradigma-kötött |
+| `DyNM_ListCollectorDataHandler_Settings` | `DyFM_SignalListCollectorDataHandler_Settings` | paradigma-kötött |
+| `DyNM_Error_Settings` | `DyFM_ErrorDisplay_Settings` | user-jóváhagyott |
+| `DyNM_Global_Settings` | `DyFM_UiGlobal_Settings` | user-jóváhagyott |
+| `DyNM_global_settings` | `DyFM_uiGlobal_settings` | user-jóváhagyott |
+
+A maradék **95** szimbólum tiszta `DyNM_X`→`DyFM_X`. **Env-kulcs kivétel**: a `DyNM_STORAGE_ENCRYPTION_KEY` string-literál
+(runtime env-var kulcs, `dynamo-global.settings.ts`) **VÁLTOZATLAN** maradt — átnevezése a Keystore/deploy-kontraktust
+törné (FR-015 requireEnv deploy-order). A `DyFM_SharedService` osztály log-üzenet-stringjei is átírva a konzisztenciáért.
+
+### Legacy aliasok (cleanup)
+`D_Button_P`, `D_Button_Params` (= `DyNM_Button_Params` aliasai, `button-params.control-model.ts:17-18`) —
+fogyasztó nem használja → **törlés** a merge során. A `DNM_*` változatok ki vannak kommentezve, ignore.
+
+## Mechanika — codemod, NEM kézi
+
+1. **Forrás-igazság**: a 95+6+4 szimbólum + 2 alias egy `rename-map.json`-ban (szimbólum → akció: rename/converge/distinct/drop).
+2. **AST-alapú csere** (ts-morph / a meglévő `dynamo-fix` tooling láncban, NEM nyers `sed`): csak azonosító-tokenek,
+   szöveg-literál/string-VALUE érintetlen. Word-boundary `\bDyNM_…\b`.
+3. **Sorrend**: előbb a fsm-modul belseje (Wave 0), aztán hullámonként a fogyasztók ([02](./02-consumer-rollout.md)).
+4. **Deprecated-alias réteg** a bridge-ben: minden régi `DyNM_X` `export … DyNM_X = DyFM_X /* @deprecated */` —
+   így a nem-migrált fogyasztó fordul, amíg a saját hulláma le nem fut.
+
+## Verifikáció
+
+- `dynamo-fsm` build+jasmine zöld a rename után (a 12 spec szimbólumai is átírva).
+- Ütközés-ellenőrzés újrafuttatva: 0 duplikált `DyFM_` export (a Kat-2 törlés + Kat-3 distinct miatt).
+- `grep -rE '\bDyNM_' src` a fsm-modulban → 0 (csak a bridge deprecated-alias rétegben maradhat, ott szándékos).

package/__documentations/plans/02-consumer-rollout.md

@@ -0,0 +1,84 @@
+# 02 — Consumer rollout: a `DyNM_`-et használó projektek átállítása
+
+> Al-terv a [MASTER](./00-MASTER-ngx-models-fsm-merge.md)-hez. Dátum: 2026-06-06.
+
+## Context
+
+A merge + rename után **15 projekt / 113 fájl** hivatkozik `DyNM_` szimbólumokra és/vagy a
+`@futdevpro/ngx-dynamo-models` package-re. Ezt top-down, gate-elt hullámokban állítjuk át, hogy semmi ne törjön.
+Két, egymástól független átállítás van projektenként, és MINDKETTŐ kell:
+
+1. **Package-import**: `@futdevpro/ngx-dynamo-models` → `@futdevpro/fsm-dynamo/ngx-models` (+ package.json dep).
+2. **Symbol-rename**: `DyNM_X` → `DyFM_X` (a [01](./01-naming-convention-DyNM-to-DyFM.md) rename-map szerint).
+
+> A **bridge-shim** (ngx-dynamo-models re-export + `DyNM_` deprecated-aliasok) miatt egy projekt akkor is fordul,
+> ha még egyik átállítást sem kapta meg → a hullámok sorrendje rugalmas, nincs hard dependency-lánc.
+
+## Fogyasztói leltár (verifikált)
+
+| Projekt | Típus | DyNM_ fájl | Import | Collision-szimbólum? |
+|---|---|---:|---|---|
+| organizer | LIVE | 46 | direkt | csak teszt-spec (`DyNM_DataHandler`) |
+| dynamo-builder | LIVE | 18 | direkt | csak teszt-spec |
+| overseer | LIVE | 13 | direkt | nincs forrásban |
+| fdp-assistant | LIVE | 6 | direkt | nincs |
+| code-documentation-master | LIVE | 6 | tranzitív (ngx) | nincs |
+| adventor | LIVE | 5 | direkt | nincs |
+| dynamo-template-project | TEMPLATE | 4 | tranzitív | nincs |
+| fdp-template-project | TEMPLATE | 3 | tranzitív | nincs |
+| fdp-pal | LIVE | 2 | tranzitív | nincs |
+| war-factory | LIVE | 2 | tranzitív | nincs |
+| oldlight-site | OGS | 2 | tranzitív | nincs |
+| art-tarot | LIVE | 2 | tranzitív | nincs |
+| fury | STALE | 2 | tranzitív | nincs |
+| dum | LIVE | 1 | tranzitív | nincs |
+| warbots-distribution-server | LIVE | 1 | tranzitív | nincs |
+
+**NPM hubok** (külön, Wave 1): `dynamo-ngx` (**7 fájl, az összes valódi collision itt él** — DataHandler-család a
+`projects/ngx-dynamo/.../_models/data-handlers/`-ban), `fdp-templates-ngx`, `dynamo-builder-models` (extends DyNM modelleket).
+
+> Kulcsmegfigyelés: a 10 collision-szimbólum **valódi forrás-használata a `dynamo-ngx`-be koncentrálódik**; a LIVE
+> fogyasztók szinte mind csak a 95 tiszta szimbólumot használják, a collision-t legfeljebb teszt-specben. Ez a
+> kockázatot a Wave 1-re fókuszálja, a LIVE-hullám mechanikus.
+
+## Per-projekt eljárás (minden projektnél azonos, dev-cycle 9 szakasz)
+
+1. `git pull` → gather (érintett fájlok listája a leltárból).
+2. **dep-csere**: ha direkt — `@futdevpro/ngx-dynamo-models` ki, `@futdevpro/fsm-dynamo` be (a publikált verzióra,
+   `dc sfd`/`dc sync-fdp-deps`). Ha tranzitív — csak a hub-verzió emelése (Wave 1 után).
+3. **import-csere**: `from '@futdevpro/ngx-dynamo-models'` → `from '@futdevpro/fsm-dynamo/ngx-models'`.
+4. **symbol-rename**: codemod a rename-map alapján (`DyNM_`→`DyFM_`, a Kat-3 distinct nevekkel).
+5. **review** (dedikált) → **test**: full suite (NEM filterezett), kliens `ng build --configuration production`.
+6. test-fix-review loop piros tesztre.
+7. document (`__documentations/`) → commit (zöld) + push (bundle-ölt, nem fájlonként).
+8. **USER VALIDATION GATE** a tier-váltás előtt (Wave 1→2, és a LIVE prio-tier-ek között).
+
+## Hullámok
+
+- **Wave 1 — NPM hubok** (CRITICAL, itt a collision-munka):
+  `dynamo-ngx` (7 collision-fájl: a DataHandler-család a Kat-2 konvergencia + Kat-3 distinct szerint),
+  `fdp-templates-ngx`, `dynamo-builder-models` (öröklési lánc figyelése). Build+publish mindhárom.
+- **Wave 2 — LIVE prio szerint** (`project_live_priorities`): organizer → dynamo-builder → overseer →
+  fdp-assistant → adventor → fdp-pal → war-factory → art-tarot → dum → warbots-distribution-server →
+  code-documentation-master. (organizer a legnagyobb felület, de tiszta-rename dominál.)
+- **Wave 3 — TEMPLATE + OGS**: dynamo-template-project, fdp-template-project (client+mobile),
+  oldlight-site → utána `dc pattern` snapshot-refresh (`project_fdp_pattern_provider_keep_current`).
+- **Wave 4 — Tooling + deprecate**: `fdp-github-actions` dev-leftovers fixture-ök (`failing/`+`passing/`
+  package.json + tsconfig + workflow-referenciák); `npm deprecate @futdevpro/ngx-dynamo-models`; sunset.
+  A bridge-shim addig él, amíg minden fogyasztó (köztük STALE `fury`) migrált VAGY tudatosan elengedett.
+
+## Kockázat / nyitott pont
+
+- `dynamo-builder-models` DyNM_ modelleket **extends-el** (`form-settings.data-model.ts`, `field-settings.data-model.ts`)
+  → Wave 1-ben az öröklési lánc a Kat-2/Kat-3 döntésekkel együtt mozog.
+- Verzió-fragmentáció a fogyasztóknál (1.15.7–1.15.14): a shim + fsm verzió legyen ≥ a legmagasabb jelenlegi.
+- STALE `fury`: nem blokkol; a bridge-shim eltartja, vagy tudatosan kihagyjuk.
+- A `dynamo-ngx` sandbox (`dynamo-ngx-sandbox`) is használja `DyNM_Global_Settings`/`DyNM_global_settings` →
+  a Kat-3 distinct névre + alias migrál.
+
+## Verifikáció (rollout záró)
+
+- Minden hullám gate-jénél: érintett projektek build+full-suite zöld.
+- Záró sweep: workspace-szintű `grep -rE '\bDyNM_'` (node_modules nélkül) → 0 valódi használat
+  (csak a bridge deprecated-alias rétege, ami a deprecate után törölhető).
+- A bridge-shim eltávolítása + package `npm deprecate` csak akkor, ha a sweep tiszta.

package/build/_collections/constants/data-sizes.const.d.ts

@@ -1,37 +1,37 @@
-/**
- * One byte is 8 bits
- */
-export declare const byte = 8;
-/**
- * One kilobyte is 1024 bytes
- */
-export declare const kilobyte = 1024;
-/**
- * One megabyte is 1024 kilobytes
- */
-export declare const megabyte: number;
-/**
- * One gigabyte is 1024 megabytes
- */
-export declare const gigabyte: number;
-/**
- * One terabyte is 1024 gigabytes
- */
-export declare const terabyte: number;
-/**
- * One petabyte is 1024 terabytes
- */
-export declare const petabyte: number;
-/**
- * One exabyte is 1024 petabytes
- */
-export declare const exabyte: number;
-/**
- * One zettabyte is 1024 exabytes
- */
-export declare const zettabyte: number;
-/**
- * One yottabyte is 1024 zettabytes
- */
-export declare const yottabyte: number;
+/**
+ * One byte is 8 bits
+ */
+export declare const byte = 8;
+/**
+ * One kilobyte is 1024 bytes
+ */
+export declare const kilobyte = 1024;
+/**
+ * One megabyte is 1024 kilobytes
+ */
+export declare const megabyte: number;
+/**
+ * One gigabyte is 1024 megabytes
+ */
+export declare const gigabyte: number;
+/**
+ * One terabyte is 1024 gigabytes
+ */
+export declare const terabyte: number;
+/**
+ * One petabyte is 1024 terabytes
+ */
+export declare const petabyte: number;
+/**
+ * One exabyte is 1024 petabytes
+ */
+export declare const exabyte: number;
+/**
+ * One zettabyte is 1024 exabytes
+ */
+export declare const zettabyte: number;
+/**
+ * One yottabyte is 1024 zettabytes
+ */
+export declare const yottabyte: number;
 //# sourceMappingURL=data-sizes.const.d.ts.map

package/build/_collections/constants/data-sizes.const.js

@@ -1,41 +1,41 @@
-"use strict";
-//file méret számításoknál a byte a legkisebb egység amit használunk
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.yottabyte = exports.zettabyte = exports.exabyte = exports.petabyte = exports.terabyte = exports.gigabyte = exports.megabyte = exports.kilobyte = exports.byte = void 0;
-/**
- * One byte is 8 bits
- */
-exports.byte = 8;
-/**
- * One kilobyte is 1024 bytes
- */
-exports.kilobyte = 1024;
-/**
- * One megabyte is 1024 kilobytes
- */
-exports.megabyte = exports.kilobyte * 1024;
-/**
- * One gigabyte is 1024 megabytes
- */
-exports.gigabyte = exports.megabyte * 1024;
-/**
- * One terabyte is 1024 gigabytes
- */
-exports.terabyte = exports.gigabyte * 1024;
-/**
- * One petabyte is 1024 terabytes
- */
-exports.petabyte = exports.terabyte * 1024;
-/**
- * One exabyte is 1024 petabytes
- */
-exports.exabyte = exports.petabyte * 1024;
-/**
- * One zettabyte is 1024 exabytes
- */
-exports.zettabyte = exports.exabyte * 1024;
-/**
- * One yottabyte is 1024 zettabytes
- */
-exports.yottabyte = exports.zettabyte * 1024;
+"use strict";
+//file méret számításoknál a byte a legkisebb egység amit használunk
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yottabyte = exports.zettabyte = exports.exabyte = exports.petabyte = exports.terabyte = exports.gigabyte = exports.megabyte = exports.kilobyte = exports.byte = void 0;
+/**
+ * One byte is 8 bits
+ */
+exports.byte = 8;
+/**
+ * One kilobyte is 1024 bytes
+ */
+exports.kilobyte = 1024;
+/**
+ * One megabyte is 1024 kilobytes
+ */
+exports.megabyte = exports.kilobyte * 1024;
+/**
+ * One gigabyte is 1024 megabytes
+ */
+exports.gigabyte = exports.megabyte * 1024;
+/**
+ * One terabyte is 1024 gigabytes
+ */
+exports.terabyte = exports.gigabyte * 1024;
+/**
+ * One petabyte is 1024 terabytes
+ */
+exports.petabyte = exports.terabyte * 1024;
+/**
+ * One exabyte is 1024 petabytes
+ */
+exports.exabyte = exports.petabyte * 1024;
+/**
+ * One zettabyte is 1024 exabytes
+ */
+exports.zettabyte = exports.exabyte * 1024;
+/**
+ * One yottabyte is 1024 zettabytes
+ */
+exports.yottabyte = exports.zettabyte * 1024;
 //# sourceMappingURL=data-sizes.const.js.map