@futdevpro/fsm-dynamo 1.20.8 → 1.20.10

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

@@ -1,100 +0,0 @@
-# ✅ 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

@@ -1,109 +0,0 @@
-# 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/2026-08-22-angular-20-phase1-release.md

@@ -1,39 +0,0 @@
-# Angular 20 fleet Phase 1 release evidence
-
-Date: 2026-08-22
-Scope: `@futdevpro/fsm-dynamo` 1.20 generation bootstrap for BFR-CTM-006
-
-## Outcome
-
-The package is aligned with the fleet Angular 20 shared-runtime baseline without changing its public API:
-
-- package generation normalized from `01.16.x` to `1.20.x`;
-- TypeScript upgraded to `~5.9.3`;
-- RxJS peer upgraded to `~7.8.2`;
-- `tslib`, Node types and UUID aligned with the fleet version matrix;
-- TypeScript 5.9's `Uint8Array<ArrayBufferLike>` Web Crypto incompatibility was resolved by preserving
-  the concrete `ArrayBuffer` backing type at every cryptographic boundary.
-
-The typed-array change is compile-time precision only. Signing, verification, checksum comparison,
-private-key zeroing and content-free error codes retain their existing runtime behavior.
-
-## Verification
-
-- clean dependency installation completed with pnpm 11.22.0;
-- TypeScript 5.9 build completed successfully;
-- build completeness: all 326 source TypeScript files have emitted JavaScript;
-- Jasmine: 1563 specifications, 0 failures, 72 explicitly pending;
-- production dependency audit: no known vulnerabilities;
-- no public export was removed and the `./ngx-models` subpath remains present.
-
-## Bootstrap note
-
-The pre-release install reports one temporary peer finding through the old
-`@futdevpro/dynamo-eslint@1.15.x` development dependency: that package still pulls
-`@futdevpro/fsm-dynamo@1.15.21`, whose peer is RxJS 7.8.1. Phase 2 replaces that lint package with the
-1.20 generation immediately after this publish. The final post-Phase-2 verification must therefore
-repeat a fresh install and peer check before the Angular package is released.
-
-The legacy import and naming validators also expose existing repository-wide debt and a flat-config
-runtime incompatibility in the 1.15 lint package. These findings are not attributed to the TypeScript
-or RxJS change; the flat-config runtime failure is a Phase 2 release gate.

package/__documentations/2026-08-23-atomic-rollback-manifest-contract.md

@@ -1,53 +0,0 @@
-# Atomic rollback manifest contract release evidence
-
-Date: 2026-08-23
-Scope: `@futdevpro/fsm-dynamo/deployment` 1.20.6 for BFR-CTM-022
-
-## Outcome
-
-The reusable, content-free atomic rollout and rollback target contract is now owned by Dynamo FSM instead of a
-single application or deployment host:
-
-- `fdp-atomic-rollback-manifest/1` describes the exact environment, authority evidence, source revision,
-  configuration revision and checksum, compatibility policy, immutable image targets, mutable promotion targets,
-  expected digests and post-deployment probes;
-- strict parsing rejects unknown fields, invalid cardinalities, duplicated services or checks, non-targeted checks,
-  unsafe endpoints and all image, configuration, authority or checksum substitutions;
-- canonical target checksums are stable when image and post-check sets arrive in a different order;
-- validation evidence is bounded and content-free: it never returns registry references, endpoints, arbitrary input
-  fields or their values;
-- the feature is additive and available only through the new `@futdevpro/fsm-dynamo/deployment` secondary entry
-  point; no existing export was removed or changed.
-
-The wire-level contract and gap-code namespace deliberately remain `FDP|ATOMIC_ROLLBACK|...` because the same
-manifest crosses the FDP CLI, FDP DevOps and deployment-host boundaries. TypeScript symbols follow the Dynamo FSM
-`DyFM_` prefix.
-
-## Cross-runtime checksum evidence
-
-The representative two-service Company Toolmaker target has this fixed SHA-256 checksum:
-
-`2b416434a8d36c5b3305383eb1f2ecebae4057d30d2f46d986d04728225b58df`
-
-The new CryptoJS-backed Dynamo implementation and the original Node `crypto` implementation produced the exact
-same value. The fixed vector is asserted in the shared contract test so a future canonicalization drift fails the
-release gate.
-
-## Verification
-
-- TypeScript 5.9 build completed successfully;
-- build completeness verified: all 329 source TypeScript files have emitted JavaScript;
-- focused Jasmine contract suite: 7 specifications, 0 failures;
-- full Jasmine regression suite: 1570 specifications, 0 failures, 72 explicitly pending legacy specifications;
-- deployment-module ESLint: 0 errors and 0 warnings;
-- full regression suite also passed with the lower supported RxJS 7.8.1 peer installed;
-- production dependency audit: no known vulnerabilities;
-- package manifest JSON and the new secondary export resolve from the emitted build;
-- `git diff --check` found no source or package whitespace errors.
-
-## Consumer migration gate
-
-FDP DevOps and FDP CLI must consume this exact secondary entry point before their local copies or partial validators
-are removed. BFR-CTM-022 remains active until the Company Toolmaker test environment completes the required
-preflight and induced-failure compensation rehearsal; publishing this contract alone does not claim that deployment
-evidence.

package/__documentations/2026-08-23-forms-v2-color-picker-settings.md

@@ -1,23 +0,0 @@
-# Forms v2 ColorPicker settings — 2026-08-23
-
-## Outcome
-
-Forms v2 now exposes `DyFM_ColorPickerFieldNew_Settings` as the serializable bedrock Settings model for a
-color-picker field. `DyFM_Field_Type.colorPicker` uses the stable `color-picker` discriminator.
-
-The value contract is a CSS/browser-native `#RRGGBB` string. The constructor adds that contract as a serializable
-pattern validator while preserving consumer validators, so backend and Angular consumers share the same rule.
-Rendering and interaction remain the responsibility of `@futdevpro/ngx-dynamo`; this package owns only the
-framework-independent constructor and discriminated union.
-
-## Public surface
-
-- `DyFM_Field_Type.colorPicker`
-- `DyFM_ColorPickerFieldNew_Settings`
-- `DyFM_FieldNew_Settings_AnyType` includes the new settings class
-
-## Verification
-
-The Forms v2 settings suite verifies constructor persistence, the immutable discriminator, default hexadecimal
-validation, and preservation of consumer validators. The complete package test and build gates must remain green
-before publishing the patch release.

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

@@ -1,75 +0,0 @@
-> ✅ **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

@@ -1,103 +0,0 @@
-# 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

@@ -1,84 +0,0 @@
-# 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/_specifications/BACKLOG.md

@@ -1,43 +0,0 @@
-# BACKLOG.md
-
-> STRICT PATTERN (MUST FOLLOW EXACTLY)
-> - Entry header: "- [TYPE] (BL-YYYYMMDD-###) TITLE"
-> - Immediately followed by (exact keys, colon-space, indented 2 spaces):
->   - "  status: <EMOJI status-key>"
->   - "  priority: <low|medium|high|urgent>"
->   - "  source: <user|system|assistant>"
->   - "  area: <ui|backend|infra|docs|tests|ux|general>"
->   - "  details: <single-line summary>"
-> - NO blank line between header and fields (parser reads i+1..i+5).
-> - One blank line between entries (readability).
-> - TYPE values: FEATURE, BUG, IMPROVEMENT, QUESTION, RESEARCH, TASK
-> - STATUS EMOJI: ❌ ⏳ 🔄 ✅ ⚠️ ❓
-> - IDs: unique, format BL-YYYYMMDD-### (increment ###).
-
-- [IMPROVEMENT] (BL-20260518-001) DyFM_StateMachine: explicit `_FailureResult` return type a `_failure()` helper-en (TS narrowing)
-  status: ⏳ pending
-  priority: low
-  source: assistant
-  area: backend
-  details: A `DyFM_StateMachine._failure()` jelenleg `DyFM_StateMachineTransition_Result<TState>` union-t ad vissza. A TS inference emiatt nem narrow-ol az `if (!r.ok) {...}` blokkban (a private helper visszatérése a union mind két ágát beilleszti, és a `_failure()` belső object literal `{ ok: false, ... }` típusa nem narrow-ódik le `false` literal-re). Konzumens kódban `as DyFM_StateMachineTransition_FailureResult<TState>` cast szükséges. Fix: `_failure()` return type-ja explicit `DyFM_StateMachineTransition_FailureResult<TState>` (NEM union). 1-line type-annotation change, 0 viselkedés-változás.
-
-- [IMPROVEMENT] (BL-20260518-002) DyFM_StateMachine: `DyFM_Error` wrapping a result.error mezőben
-  status: ⏳ pending
-  priority: low
-  source: assistant
-  area: backend
-  details: A jelenlegi `DyFM_StateMachineTransition_FailureResult.error` `DyFM_Error | Error` típusú, de a `_failure()` raw `Error`-t propagál (callback throw-jából). Konzisztencia a többi `DyFM_*` modullal: `DyFM_Error({ status: 422, errorCode: 'DyFM-SM-<subcode>', message, error: originalError, issuerService: 'DyFM_StateMachine' })` wrappingot adni a 4 throw-elhető helyen (guard/onLeave/onEnter/persist). Subcode-ok pl. 'DyFM-SM-GR' (guard-rejected throw), 'DyFM-SM-OL' (on-leave), 'DyFM-SM-OE' (on-enter), 'DyFM-SM-PE' (persist). Spec: minden 4 error-path-on `DyFM_Error.getErrorCode(f.error)` assertion.
-
-- [TASK] (BL-20260518-003) DyFM_StateMachine: guard-throw + self-loop spec coverage
-  status: ⏳ pending
-  priority: low
-  source: assistant
-  area: tests
-  details: Két explicit spec hiányzik a FR-006 (52354ba) 22-spec szettjéből: (1) guard callback throw esetén `transition()` `guard-rejected` reason-t ad-e, és a `canTransition()` `false`-t (mindkét helyen catch-eli a impl, de NEM bizonyított teszttel); (2) self-loop transition (`from === to`) explicit spec — a `_findTransition` matchel rá, de nincs lefedve. ~30 LOC spec, no impl change.
-
-- [FEATURE] (BL-20260518-004) DyFM_StateMachine: Mongoose persist adapter
-  status: ⏳ pending
-  priority: medium
-  source: assistant
-  area: backend
-  details: Az MVP-ben (FR-006 / 52354ba) a `persist` callback caller-supplied (CCAP MP1-D maga írja a Mongo updateOne logikát stateVersion optimistic-lock-kal). Egy genericikus adapter ami `DyFM_dataModel`-kötött (Mongoose ControlModel) state-document-et frissít automatikusan, kevesebb boilerplate-tel. API: `createMongoosePersistAdapter({ collection: Model<T>, docFilter: { _id: 'rag-status' } }): DyFM_StateMachineConfig['persist']`. Optimistic-lock: `findOneAndUpdate({ ...filter, stateVersion: prev }, { $set: { state, stateVersion: next, lastTransitionAt: timestamp } })` — match nélkül `'persist-failed'`. Tervek szerint a consumer real-world tapasztalat (MP1-D landolása) után írandó, hogy a tényleges minta visszahatáson alapuljon.