@futdevpro/nts-dynamo 1.15.156 → 1.15.160

package/__documentations/2026-04-28-logs-module.md

@@ -1,49 +0,0 @@
-# 2026-04-28 — NTS Logs Module
-
-## Összefoglaló
-
-Beépített `/logs` endpoint modul az NTS framework-be. Bármelyik NTS-alapú szerver bekapcsolhatja.
-Verzió: v01.15.14+
-
-## Használat
-
-```typescript
-import { DyNTS_Logs_Service, DyNTS_getLogsRoutingModule } from '@futdevpro/nts-dynamo/logs';
-
-// 1. App startup-nál: log buffer install
-DyNTS_Logs_Service.getInstance().install();
-
-// 2. Log settings-ben: enable
-DyNTS_global_settings.log_settings.logs_endpoint = { enabled: true, maxEntries: 2000 };
-
-// 3. Routing module-ok közé: endpoint regisztráció
-getRoutingModules() {
-  return [
-    ...
-    DyNTS_getLogsRoutingModule(),                              // auth nélkül
-    DyNTS_getLogsRoutingModule({ authPreProcess: myAuth }),     // auth-tal
-  ];
-}
-```
-
-## Endpoint-ok
-
-- `GET /logs/get?tail=200` — utolsó N sor a bufferből (max 2000)
-- `DELETE /logs/clear` — buffer ürítés
-
-## Architektura
-
-- `DyNTS_Logs_Service` — singleton, in-memory ring buffer (console.log/error/warn intercept)
-- `DyNTS_Logs_Controller` — GET /get + DELETE /clear endpoint-ok
-- `DyNTS_getLogsRoutingModule(config?)` — factory, opcionális authPreProcess
-- Ha `logs_endpoint.enabled === false` → 503 response
-- Ha `install()` nem volt meghívva → 503 response
-
-## Fájlok
-
-- `src/_modules/logs/logs.service.ts`
-- `src/_modules/logs/logs.controller.ts`
-- `src/_modules/logs/get-logs-routing-module.util.ts`
-- `src/_modules/logs/index.ts`
-- `src/_models/interfaces/global-log-settings.interface.ts` — `logs_endpoint` setting
-- `src/_collections/global-settings.const.ts` — default values

package/__documentations/2026-05-17-oai-compatible-providers.md

@@ -1,229 +0,0 @@
-# 2026-05-17 — Using OpenAI-compatible providers with Dynamo-NTS
-
-**Spec:** `__agent/feature-requests/FR-005-oai-compat-docs.md` (workspace root)
-**Scope:** docs-only, LOW priority. Semmilyen TS-változás. NEM kell npm publish.
-
----
-
-## Mire jó
-
-A Dynamo-NTS OAI service-ek — `DyNTS_OAI_LLM_ServiceBase`, `DyNTS_OAI_LLMChat_ServiceBase`, `DyNTS_OAI_Embedding_ControlService` — az `openai` npm SDK-t használják, és **out-of-the-box bármely OpenAI-API-kompatibilis endpoint-tal működnek** a `baseURL` override-on keresztül. Ez **MÁR MŰKÖDIK** (zéró kód-változás kell), csak eddig nem volt dokumentálva.
-
-A `baseURL` mező a `@futdevpro/fsm-dynamo/ai/open-ai` package `DyFM_OAI_ClientOptions` interface-en él. Bővebben a fsm-dynamo-szintű részletekért: [`@futdevpro/fsm-dynamo/__documentations/2026-05-17-oai-compatible-providers-howto.md`](../../dynamo-fsm/__documentations/2026-05-17-oai-compatible-providers-howto.md).
-
-Tipikus use-case-ek:
-- **Lokál fejlesztés** OpenAI-credits nélkül (LM Studio, Ollama)
-- **Self-hosted production** infrastruktúra (vLLM, LocalAI klaszter)
-- **Cost control** — nyílt-súlyú modellek drága cloud API helyett
-
----
-
-## A pattern
-
-```typescript
-import { DyFM_OAI_Settings, DyFM_OAI_CallSettings } from '@futdevpro/fsm-dynamo/ai/open-ai';
-import { DyNTS_OAI_LLMChat_ServiceBase } from '@futdevpro/nts-dynamo/ai/open-ai';
-
-const settings: DyFM_OAI_Settings = new DyFM_OAI_Settings({
-  config: {
-    baseURL: 'http://<provider-host>:<port>/v1',
-    apiKey: '<placeholder-or-real>',
-  },
-  defaultSettings: new DyFM_OAI_CallSettings({
-    useModel: '<provider-specific-model-id>',
-  }),
-});
-
-class MyChat extends DyNTS_OAI_LLMChat_ServiceBase {}
-const chat: MyChat = new MyChat(settings);
-```
-
-Csak `config.baseURL` + `config.apiKey` + `defaultSettings.useModel` kell. A többi (organization, project) lokál providereknél figyelmen kívül marad.
-
-A `DyNTS_OAI_Embedding_ControlService` és más OAI alapú service-ek ugyanezt a `DyFM_OAI_Settings`-t fogadják — egy konfig, minden service.
-
----
-
-## Provider-specifikus minták
-
-### LM Studio (port 1234)
-
-Desktop GUI (Mac/Windows/Linux), beépített OAI-compat szerverrel. Lépések:
-1. Töltsd be a modellt a UI-ben (pl. embedding-hez `nomic-embed-text-v1.5`, chat-hez `llama-3.2-3b-instruct`)
-2. **Local Server** tab → **Start Server**
-
-```typescript
-const lmStudio: DyFM_OAI_Settings = new DyFM_OAI_Settings({
-  config: {
-    baseURL: 'http://localhost:1234/v1',
-    apiKey: 'lm-studio',  // bármilyen non-empty placeholder
-  },
-  defaultSettings: new DyFM_OAI_CallSettings({
-    useModel: 'nomic-embed-text-v1.5',  // ahogy a Local Server tab megjeleníti
-  }),
-});
-
-// Embedding-hez
-class Knowledge_DataService extends DyNTS_OAI_VectorDataService<Knowledge> {
-  constructor() { super(/* args */); }
-}
-```
-
-### Ollama (port 11434, OAI-compat layer ≥ v0.1.14)
-
-CLI-driven, multi-modell runner.
-
-```bash
-ollama pull llama3.2:3b
-ollama pull nomic-embed-text
-ollama serve
-```
-
-```typescript
-const ollama: DyFM_OAI_Settings = new DyFM_OAI_Settings({
-  config: {
-    baseURL: 'http://localhost:11434/v1',
-    apiKey: 'ollama',  // szintén placeholder
-  },
-  defaultSettings: new DyFM_OAI_CallSettings({
-    useModel: 'nomic-embed-text',  // `ollama list` mutatja
-  }),
-});
-```
-
-### vLLM (port 8000, production GPU)
-
-Python-alapú batched + PagedAttention inference. OAI-compat REST endpoint beépítve.
-
-```bash
-pip install vllm
-python -m vllm.entrypoints.openai.api_server \
-  --model meta-llama/Meta-Llama-3-8B-Instruct \
-  --port 8000 \
-  --api-key local-secret-token
-```
-
-```typescript
-const vllm: DyFM_OAI_Settings = new DyFM_OAI_Settings({
-  config: {
-    baseURL: 'http://gpu-server:8000/v1',
-    apiKey: process.env.VLLM_API_KEY ?? 'local-secret-token',
-  },
-  defaultSettings: new DyFM_OAI_CallSettings({
-    useModel: 'meta-llama/Meta-Llama-3-8B-Instruct',  // a `--model` érték
-  }),
-});
-```
-
-### LocalAI (port 8080, REST multi-model)
-
-Go-alapú, multi-backend (llama.cpp + whisper.cpp + stable-diffusion).
-
-```bash
-docker run -p 8080:8080 \
-  -v $PWD/models:/build/models \
-  localai/localai:latest
-```
-
-```typescript
-const localai: DyFM_OAI_Settings = new DyFM_OAI_Settings({
-  config: {
-    baseURL: 'http://localai:8080/v1',
-    apiKey: 'sk-local',  // placeholder
-  },
-  defaultSettings: new DyFM_OAI_CallSettings({
-    useModel: 'gpt-4',  // LocalAI alias — `models.yaml`-ban mapped
-  }),
-});
-```
-
----
-
-## Dev → cloud quick recipe
-
-```typescript
-const isDev: boolean = process.env.NODE_ENV === 'development';
-
-export const aiSettings: DyFM_OAI_Settings = new DyFM_OAI_Settings({
-  config: isDev
-    ? {
-        baseURL: 'http://localhost:11434/v1',  // Ollama lokálban
-        apiKey: 'dev',
-      }
-    : {
-        apiKey: process.env.OPENAI_API_KEY,
-        organization: process.env.OPENAI_ORG_ID,
-      },
-  defaultSettings: new DyFM_OAI_CallSettings({
-    useModel: isDev ? 'llama3.2:3b' : 'gpt-4o',
-  }),
-});
-
-// Az összes Dynamo-NTS OAI service ugyanazt a settings-t fogyasztja:
-class ProdChat extends DyNTS_OAI_LLMChat_ServiceBase {}
-const chat: ProdChat = new ProdChat(aiSettings);
-```
-
----
-
-## Caveats — service-szintű
-
-### Tool/function calling
-A `DyNTS_OAI_LLMChat_ServiceBase` tool-calling support csak akkor működik a lokál provider-eknél, ha:
-- **Ollama**: tool-aware modell (Llama-3.1+, Mistral újabb verziók)
-- **vLLM**: v0.6+ + megfelelő chat-template
-- **LM Studio**: model-függő, gyakran részleges
-- **LocalAI**: function-call backend kell konfigolni
-
-Production OpenAI-mintával írt service-ek **lokál providerre váltáskor** előbb tesztelni kell, hogy a tool-callok valóban triggerelnek-e.
-
-### Streaming chat
-A `DyNTS_OAI_LLMChat_ServiceBase` streaming (SSE) működik mindenhol, **de**:
-- Ollama < v0.1.20 streaming-stabilitás kérdéses
-- LocalAI streaming-rate alacsonyabb mint az emit-rate
-- vLLM/LM Studio: rendszeresen frissül, érdemes a provider-changelogot követni
-
-### Embedding-modellek
-A `DyNTS_OAI_Embedding_ControlService` `useModel`-je a provider-specifikus dedikált embedding modell **pontos ID**-ja:
-
-| Provider | Embedding model ID |
-|---|---|
-| OpenAI (cloud) | `text-embedding-3-small` / `text-embedding-3-large` |
-| LM Studio | `nomic-embed-text-v1.5` / `BAAI/bge-large-en-v1.5` |
-| Ollama | `nomic-embed-text` / `mxbai-embed-large` |
-| vLLM | csak ha az indítási `--model` embedding-képes (pl. `intfloat/e5-mistral-7b-instruct`) |
-| LocalAI | `text-embedding-ada-002` alias (vagy egyéb a `models.yaml`-ban) |
-
-### Context window / max-tokens
-A `DyFM_OAI_CallSettings.maxTokens` provider-szintű limit alá kell esnie, különben 400/422 jön vissza:
-
-| Provider | Default context-window | Override |
-|---|---|---|
-| OpenAI gpt-4o | 128K | API tier |
-| LM Studio | a betöltött modell native context | UI slider |
-| Ollama | **2048 (legacy default!)** | `OLLAMA_NUM_CTX` env / Modelfile `PARAMETER num_ctx` |
-| vLLM | a modell native context | `--max-model-len` flag |
-| LocalAI | `models.yaml` `context_size` | per-model konfig |
-
-### Error-handling
-- OpenAI cloud: standard 4xx/5xx + structured error body
-- Lokál providerek: 404 a modell-name-re (rossz ID), timeout első call-on (modell load), OOM vLLM-en
-- Ollama-specifikus: ha a modell még nem `pull`-olt, csendben várakozik a pull-ig — látszólag hang
-
----
-
-## Reference
-
-| Fájl | Mit ad |
-|---|---|
-| `fsm-dynamo/.../oai-client-options.interface.ts` | `DyFM_OAI_ClientOptions.baseURL` — a kapcsoló mező |
-| `fsm-dynamo/.../oai-settings.control-model.ts` | `DyFM_OAI_Settings` — settings wrapper |
-| `dynamo-nts/.../oai-llm.service-base.ts` | `DyNTS_OAI_LLM_ServiceBase` — base LLM client (`openai` SDK instantiation) |
-| `dynamo-nts/.../oai-llm-chat.service-base.ts` | `DyNTS_OAI_LLMChat_ServiceBase` — chat service |
-| `dynamo-nts/.../oai-embedding.control-service.ts` | `DyNTS_OAI_Embedding_ControlService` — embedding service |
-
-További (fsm-szintű) részletek, ugyanezzel a 4 provider-mintázattal: [`dynamo-fsm/__documentations/2026-05-17-oai-compatible-providers-howto.md`](../../dynamo-fsm/__documentations/2026-05-17-oai-compatible-providers-howto.md).
-
-## Backward compatibility
-
-Docs-only. `baseURL` mindig is létezett az OpenAI SDK-ban, a Dynamo-NTS csak átadja a config-ot (`oai-llm.service-base.ts:91-98`). Ez a doc csak tisztázza a használati mintázatot — semmilyen TS-változás nincs.

package/__documentations/2026-05-17-static-client-serving-howto.md

@@ -1,144 +0,0 @@
-# Static client serving — how-to
-
-**Date:** 2026-05-17
-**Backlog:** [BL-20260417-001](../_specifications/BACKLOG.md) — DyNTS-kliens kiszolgálás képesség
-**Status:** ✅ done (audit + docs)
-
-## TL;DR
-
-A `DyNTS_App_Server` MÁR most ki tudja szolgálni a klienst (SPA-kat, statikus
-oldalakat) az API route-ok mellett ugyanazon a hoszton. Az implementáció
-2026-03-30 óta (commit `8ffe535`) része a frameworknek; a BL-20260417-001
-backlog entry post-dated a fejlesztést. Ez a how-to a meglévő capability-t
-dokumentálja.
-
-## Konfigurációs felület
-
-A static client serving akkor aktiválódik, ha a `DyNTS_App_Server`
-subclass-od `getStaticClientSettings()`-et override-olja és egy
-[`DyNTS_StaticClient_Settings`](../src/_models/interfaces/static-client-settings.interface.ts)
-objektumot ad vissza:
-
-```ts
-import { DyNTS_StaticClient_Settings } from '@futdevpro/nts-dynamo';
-
-export interface DyNTS_StaticClient_Settings {
-  root: string;                  // a static fájlok mappája (abszolút v. cwd-relatív)
-  fallbackPath?: string;          // SPA fallback (pl. 'index.html')
-  assetCacheMaxAge?: number;      // asset Cache-Control max-age (sec)
-  assetCacheImmutable?: boolean;  // 'immutable' direktíva (Angular hashed fájlokra)
-  fallbackCacheMaxAge?: number;   // fallback file Cache-Control max-age (sec)
-}
-```
-
-## Példa subclass (Angular SPA)
-
-```ts
-import path from 'path';
-import { DyNTS_App_Server, DyNTS_StaticClient_Settings } from '@futdevpro/nts-dynamo';
-
-export class MyApp_Server extends DyNTS_App_Server {
-  // ... egyéb override-ok (getAppParams, getPortSettings, getApiBasePath, stb.) ...
-
-  override getStaticClientSettings(): DyNTS_StaticClient_Settings | undefined {
-    return {
-      // Az Angular `dist/<app-name>` mappa abszolút path-ja
-      root: path.resolve(__dirname, '../../client/dist/my-app'),
-
-      // SPA — minden ismeretlen route a kliens-routerre megy
-      fallbackPath: 'index.html',
-
-      // Hashed assetek (Angular alapból ad nekik hash-et) — 1 év, immutable
-      assetCacheMaxAge: 31_536_000,
-      assetCacheImmutable: true,
-
-      // index.html-t SOHA ne cache-elje a böngésző (deploy után friss kell)
-      fallbackCacheMaxAge: 0,
-    };
-  }
-}
-```
-
-## Mit csinál a framework a háttérben
-
-A `DyNTS_App_Server.mountStaticClient()` ([app.server.ts ~1421-1484](../src/_services/server/app.server.ts))
-ezt automatikusan beállítja az API route-ok regisztrációja UTÁN:
-
-1. **`Express.static(root)` middleware** mount a `/` alatt. Ha `assetCacheMaxAge`
-   meg van adva, `setHeaders` callback-en keresztül beállítja a `Cache-Control:
-   max-age=<N>[, immutable]` header-t.
-2. **SPA fallback** (ha `fallbackPath` adott): minden ismeretlen GET kérésre
-   `res.sendFile(fallbackPath)` + `Cache-Control: max-age=<fallbackCacheMaxAge>`.
-3. **Default 404** (ha `fallbackPath` hiányzik): a beépített
-   [`DyNTS_defaultNotFoundPageHtml`](../src/_collections/default-not-found-page.const.ts)
-   kerül kiszolgálásra `status: 404` + `Content-Type: text/html`.
-4. **HTTP + HTTPS** mindkettő: a flow azonos a `this.openExpress` és
-   `this.secureExpress` instance-ekhez (ha mindkettő be van állítva).
-
-## Config matrix — mikor melyik mezőt használd
-
-| Use case | `root` | `fallbackPath` | `assetCacheMaxAge` | `assetCacheImmutable` | `fallbackCacheMaxAge` |
-|---|---|---|---|---|---|
-| **SPA** (Angular, React) hashed assetekkel | ✅ kötelező | `'index.html'` | `31_536_000` (1 év) | `true` | `0` (mindig friss) |
-| **SPA** dev mode (rebuild gyakori) | ✅ | `'index.html'` | `0` | `false` | `0` |
-| **Statikus oldal** (nincs SPA-router) | ✅ | hagyd ki | `3600` (1 óra) vagy ahogy jó | `false` | n/a |
-| **Csak API** (nincs frontend) | NE override-old a `getStaticClientSettings()`-et — akkor `undefined`-ot ad vissza és a `mountStaticClient` early-return-öl | | | | |
-
-## Asset + fallback cache stratégia (SPA)
-
-A két mező együttes használata az **alapja az Angular/React deploy-friendly caching**-nek:
-
-- **Hashed assetek** (`main.<hash>.js`, `styles.<hash>.css`, stb.) ÉLETBEN nem
-  változnak — biztonságosan `immutable` + 1 év max-age. A böngésző sose kérdezi
-  meg újra a szerverről, amíg a HTML egy új hash-elt nevet nem hivatkozik be.
-- **`index.html`** a "katalógus" ami a hashed assetekre mutat. Deploy után
-  AZONNAL friss kell legyen, különben a kliens régi assetekre hivatkozó régi
-  index.html-t kap → 404-ek a már nem létező hashed nevekre.
-  → `fallbackCacheMaxAge: 0` (no-cache).
-
-Az `assetCacheMaxAge` undefined-ja default (Express.static alapértelmezett) cache
-viselkedést hagy meg — production deploy-okra mindig explicit állítsd be.
-
-## Integration test minta
-
-A meglévő integration test fixture ([`DyNTS_AppIntegrationTest_Mock`](../src/_modules/mock/app-integration-test.mock.ts)) +
-spec ([app-extended.integration.spec.ts](../src/_modules/socket/app-extended.integration.spec.ts))
-mutatja a teljes flow-t:
-
-- A spec `beforeAll`-ban létrehoz egy temp dir-t, kitölti pár static fájllal,
-  beállítja a mock `integrationStaticRoot` static property-jét, majd elindítja
-  az appot.
-- A spec asszertálja:
-  - `started === true` (az app HTTP listenert kapott)
-  - GET nemlétező path → `404` + a default not-found HTML kiszolgálva
-  - GET `/index.html` → `200` + a temp dir-ben található static content
-  - GET `/api/test-0/test-base`, `/api/test-0/test-simple` → API kiszolgálva (az API
-    route-ok ELŐBB regisztráltak, mint a static fallback)
-- `afterAll`-ban leállítja az appot és kitakarítja a temp dir-t.
-
-## Edge case-ek + gotchák
-
-- **Mounting sorrend:** a `mountStaticClient` az `_routingModules` regisztráció
-  UTÁN fut, így az API route-ok prioritást élveznek. Tehát a `/api/...` mindig
-  az API-hoz megy, akkor is, ha a static root-ban véletlenül lenne `api/`
-  almappa.
-- **`fallbackPath` relatív** a `root`-hoz képest (`sendFile(fallbackPath, { root })`).
-- **Default 404 HTML:** szándékosan minimalista (`DyNTS_defaultNotFoundPageHtml`),
-  hogy ne ütközzön a kliens stílusával. Ha custom 404-et akarsz, add meg a
-  `fallbackPath`-t (az SPA-router majd kezelje belül a "page not found"-ot).
-- **CSP / security header-ek:** a `mountStaticClient` NEM állít be CSP-t —
-  ha kell, használj `helmet` middleware-t az API route-ok elé.
-
-## Releváns kód- és test-fájlok
-
-- [`src/_services/server/app.server.ts`](../src/_services/server/app.server.ts) — `mountStaticClient()` private + `getStaticClientSettings?()` opt-in override
-- [`src/_models/interfaces/static-client-settings.interface.ts`](../src/_models/interfaces/static-client-settings.interface.ts) — config interface
-- [`src/_collections/default-fallback-cache-max-age.const.ts`](../src/_collections/default-fallback-cache-max-age.const.ts) — default `0` (no-cache)
-- [`src/_collections/default-not-found-page.const.ts`](../src/_collections/default-not-found-page.const.ts) — default 404 HTML
-- [`src/_modules/mock/app-integration-test.mock.ts`](../src/_modules/mock/app-integration-test.mock.ts) — integration test fixture mintaként
-- [`__documentations/nts-integration-tests-2026-03-17.md`](./nts-integration-tests-2026-03-17.md) — első integration test bevezetése a unified host behavior-ra
-
-## Kapcsolódó backlog entry-k
-
-- **BL-20260420-001..004** (dynamo-nts) — `DyNTS_FileLog_Service` + admin endpoints. Mind ✅ done.
-- BL-20260417-001 (ez) — a kliens kiszolgálási képesség. ✅ done — implementáció már része a frameworknek; ez a doc a hivatkozás.

package/__documentations/2026-06-01-fr041-cors-middleware.md

@@ -1,96 +0,0 @@
-# FR-041 — CORS middleware infrastructure (2026-06-01)
-
-**Commit**: `3d16d69` — v01.15.35 → v01.15.36
-**Parent**: `__agent/feature-requests/FR-041-subdomain-per-service-architecture.md`
-**Pattern**: `fdp-documentations/guidelines/development/cors-and-subdomain-architecture.md`
-
-## What
-
-Adds CORS middleware infrastructure to `DyNTS_AppServer`. After this commit, any subclass that wants to be reachable cross-origin overrides `getCorsSettings()` and returns a `DyNTS_Cors_Settings` object.
-
-## Why
-
-Pre-FR-041: every cross-service call was same-origin via gateway nginx proxy (e.g. `<app>.futdevpro.hu/auth-api/*` → `fdp-auth-service:39005/api/*`). No CORS needed because same-origin.
-
-Post-FR-041: each sister service exposed at its own subdomain (`auth.futdevpro.hu`, `social.futdevpro.hu`, etc.). Cross-origin requires CORS allowlist.
-
-Audit pre-FR-041: ZERO existing CORS implementation in the entire FDP stack (`grep -rn "cors\|Access-Control" dynamo-nts/src` returned 0 hits). Greenfield work.
-
-## Design
-
-### `DyNTS_Cors_Settings` interface
-
-`src/_models/interfaces/cors-settings.interface.ts`:
-
-```typescript
-export interface DyNTS_Cors_Settings {
-  allowedOrigins: string[] | ((origin: string) => boolean) | '*';
-  allowCredentials?: boolean;        // default true
-  allowedMethods?: string[];          // default GET/POST/PUT/DELETE/PATCH/OPTIONS
-  allowedHeaders?: string[];          // default Authorization/Content-Type/X-Admin-Key/X-Requested-With
-  exposedHeaders?: string[];          // default Content-Length/Content-Type
-  maxAgeSeconds?: number;             // default 86400 (24h preflight cache)
-}
-```
-
-### `mountCors(express)` protected method
-
-`src/_services/server/app.server.ts` (~line 1422):
-
-- Reads `this.getCorsSettings?.()` ONCE at mount time. Undefined → returns immediately (no CORS headers, back-compat).
-- Express middleware: for each request, checks Origin against allowlist. Match → echoes the origin (NOT wildcard, because credentials require an exact origin echo) + sets Methods/Headers/Expose/MaxAge/Vary.
-- OPTIONS preflight short-circuits with 204.
-
-### `getCorsSettings?()` optional override
-
-Added to the class as `getCorsSettings?(): DyNTS_Cors_Settings | undefined;`. Subclasses opt in by implementing it.
-
-## Mount-points
-
-`initOpenExpress()` + `initSecureExpress()` both call `mountCors(this.<express>)` after BodyParser, BEFORE route mounting. CORS preflight always intercepts before any route handler can interfere.
-
-Timing verified: `asyncConstruct` line 410 `getAppParams()` (sets env via `FDPNTS_setEnvBase`) → line 1018 `initOpenExpress()` (calls `mountCors`). Env is always set by the time `getCorsSettings()` runs.
-
-## Why hand-rolled (no `cors` npm dep)
-
-- ~30 lines, zero new dependency
-- Full control over Vary/credentials/preflight semantics
-- Aligns with FDP "no unnecessary deps" philosophy
-
-## Spec coverage
-
-`src/_models/interfaces/cors-settings.interface.spec.ts` — 5 specs covering all `allowedOrigins` shapes (array, predicate, wildcard) + credential defaults + custom headers.
-
-`npx jasmine` post-change: **1250/0** (146 pending pre-existing, all 5 new specs green).
-
-## Consumer pattern
-
-```typescript
-import { DyNTS_Cors_Settings } from '@futdevpro/nts-dynamo';
-import { FDPNTS_buildCorsSettings } from '@futdevpro/nts-fdp-templates';
-
-export class App extends DyNTS_App {
-  override getCorsSettings(): DyNTS_Cors_Settings | undefined {
-    return FDPNTS_buildCorsSettings();   // env-aware allowlist from FDP-templates
-  }
-}
-```
-
-First consumer: `LIVE-projects/fdp-auth-service` commit `1319368`.
-
-## What's NOT in this commit
-
-- Per-env allowlist source (lives in `fdp-templates v01.15.38`, commit `0f793c4`)
-- Helper for FDPNTS apps to bind that allowlist (lives in `fdp-templates-nts v01.15.45`, commit `6e748ee`)
-
-## Wave-3 cleanup candidates
-
-- Once every app overrides `getCorsSettings()`, consider making it abstract (no more optional `?`).
-- OPTIONS-without-origin-match returns 204 + no CORS headers (functional: browser denies). Could be improved to 403 for clearer security audit.
-
-## Cross-references
-
-- `fdp-documentations/guidelines/development/cors-and-subdomain-architecture.md`
-- `NPM-packages/fdp-templates/src/_constants/environment/fdp-cors-origins.const.ts` — allowlist
-- `NPM-packages/fdp-templates-nts/src/_collections/cors-settings.util.ts` — consumer helper
-- `LIVE-projects/fdp-auth-service/src/app.server.ts` — first consumer

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

@@ -1,81 +0,0 @@
-# FR-047 P2+P3 — Function-calling agent-loop + OpenAI-wire translator (2026-06-01)
-
-**Commits**: `de6f79e` — v01.15.36 → v01.15.37 (agent-loop + OpenAI translator)
-            `514153f` — → v01.15.40 (critical reasoning-model fix; see below)
-**Parent**: `__agent/feature-requests/FR-047-phase-2-agent-loop-service-base.md` + `FR-047-phase-3-openai-fdpai-local.md`
-**Pattern**: `fdp-documentations/guidelines/development/ai-function-calling.md`
-**Depends on**: `@futdevpro/fsm-dynamo` ≥ 1.15.17 (tool vocabulary + registry; bumped to 1.15.18 here)
-
-## What
-
-Implements the provider-agnostic function-calling agent-loop in `DyNTS_AI_LLM_ServiceBase` and the
-first concrete provider translator in `DyNTS_OAI_LLM_ServiceBase`. After this, OpenAI tool calling
-works end-to-end through the strategic agnostic layer.
-
-## Why
-
-FR-047 P1 (fsm) shipped the vocabulary; the execution layer had the explicit TODO comment in
-`getMessageCreateInput` ("'llm-tool-use' categoria a tools bevezetésekor — jövőbeli FR"). This is that FR.
-The proven loop logic is ported from the legacy `FDPNTS_GPT_ControlService.getAnswerWithTools`.
-
-## Design
-
-### Agent-loop in `DyNTS_AI_LLM_ServiceBase` (written ONCE, concrete)
-- `requestWithTools({ conversation, tools, toolHandlers, settings?, issuer, maxIterations? })` — public entry.
-  Tools are a **request parameter** (not on settings). Resolves model → capability pre-check → `runToolLoop`.
-- `runToolLoop` — the loop: `callModelWithTools` → if `toolCalls`, push assistant-tool-call message,
-  run each handler (`runToolCall`), push `role:'tool'` result messages, repeat; exit on no-tool-call
-  final answer or `maxIterations` (default 8 → `DyFM_Error` `DyNTS-AILSB-TL0`).
-- `runToolCall` — **never throws**; missing/throwing handler → `ERROR …` string with `isError:true` (no `[object Object]`).
-- `assertToolsSupported(modelId)` — uses `DyFM_AI_ModelRegistry_Util.modelSupportsTools(getModelRegistry(), id)`;
-  rejects BEFORE any API call if unsupported (critical for Local).
-- `callModelWithTools` + `getModelRegistry` — **non-abstract safe defaults** (throw / `[]`); providers override.
-  Chosen over `abstract` so NO existing concrete subclass breaks (incremental rollout).
-
-### OpenAI translator in `DyNTS_OAI_LLM_ServiceBase`
-- `getModelRegistry()` → `DyFM_OAI_Models`.
-- `callModelWithTools` — builds the native request (system + `toOpenAIMessage`-mapped conversation incl.
-  tool-call/tool-result messages + `toOpenAITool`), calls the SDK, normalizes the response (`toolCalls`
-  from `message.tool_calls`, args JSON-parsed), emits `'llm-tool-use'` cost-event.
-- `toOpenAIMessage` — maps `role:'tool'` → `{role:'tool',tool_call_id,content}`, assistant-with-toolCalls →
-  `{role:'assistant',content|null,tool_calls:[…]}`.
-
-### Refinement vs the FR plan
-The registry lookup util takes the **registry array as a param** (`(models, id)`), not `(provider, id)` —
-so the fsm core never imports a provider submodule. The provider service supplies its own registry.
-
-## CRITICAL fix (`514153f`, v01.15.40) — found in code review
-
-The registry's tool-capable models (gpt-5.5, gpt-5.4-mini, o3-pro) are **reasoning models** that reject
-`temperature`/`top_p`/`frequency_penalty`/`presence_penalty` with HTTP 400. `callModelWithTools` sent them
-unconditionally (default temperature=0) → **every tool call 400'd on the flagship models**. Fix:
-- `isReasoningModel(modelId)` = `/^gpt-5/ || /^o[0-9]/`; reasoning → omit the 4 sampling params.
-- Omit `tools`/`tool_choice` when the tool array is empty (empty `[]` → 400).
-- Clear error when no model is configured.
-This is the local OpenAI-specific application of the FR-048 per-model-settings principle.
-See `[[reference_oai_reasoning_models_reject_sampling_params]]`.
-
-## Spec coverage
-
-`oai-llm.service-base.tools.spec.ts` (mocked OpenAI client, no network) — 6 specs:
-loop converges / never-throw on handler error / capability-reject for embedding model /
-reasoning omits sampling params / non-reasoning sends them / empty-tools omitted.
-`npx jasmine`: **1256/0** (146 pending pre-existing).
-
-## What's NOT in this commit
-
-- Anthropic / Google / FdpAI / Local LLM bases + translators (FR-047 P4/P5).
-- The NON-tool path (`getMessageCreateInput`/`resolveMessage`) still forwards sampling params → reasoning
-  completions would 400 (pre-existing; FR-048 / separate fix).
-- Adventor migration (FR-047 P6).
-- FR-048 general per-model settings reconciler.
-
-## Consumer pattern
-
-See `fdp-documentations/guidelines/development/ai-function-calling.md` ("How to USE it").
-
-## Cross-references
-
-- `fdp-documentations/guidelines/development/ai-function-calling.md` (pattern + provider-translator how-to)
-- `NPM-packages/dynamo-fsm/__documentations/2026-06-01-fr047-p1-function-calling-vocabulary.md` (vocabulary)
-- legacy `NPM-packages/fdp-templates-nts/src/_modules/gpt/_services/gpt-handler.control-service.ts` (logic source)

package/__documentations/2026-06-15-fr193-memory-guard.md

@@ -1,73 +0,0 @@
-# FR-193 — `DyNTS_MemoryGuard` (bedrock OOM korai-figyelmeztetés)
-
-**Csomag:** `@futdevpro/nts-dynamo` · **Dátum:** 2026-06-15
-
-## Probléma
-
-A Node heap-OOM (`--max-old-space-size` túllépés — pl. egy óriási `JSON.parse`, mint az
-Overseernél a CCAP több-tíz-MB-os `cdpReport`-ja) a process-t **azonnal megöli**. A
-`process.on('uncaughtException')` NEM kapja el — a crash pillanatában már **nincs mód a
-hibát rögzíteni**. Eredmény: a szerver „csak eltűnik", nyom nélkül, és a kézi diagnózis
-nehéz. Az EGYETLEN megbízható idő a rögzítésre a crash **ELŐTT** van.
-
-## Megoldás — `DyNTS_MemoryGuard`
-
-Bedrock, self-installing heap-watchdog **minden nts-szerverhez**. Periodikusan figyeli a
-heap-kihasználtságot, és a `--max-old-space-size` plafonhoz közeledve **tartós rekordot**
-hagy — mielőtt a fatal OOM bekövetkezne.
-
-- **Megfigyel:** `v8.getHeapStatistics().heap_size_limit` (a valódi plafon) vs
-  `process.memoryUsage().heapUsed`, default 10s-enként.
-- **Rögzít:** küszöb-átlépéskor `DyFM_Log` + `DyNTS_GlobalService.globalErrorHandler`
-  (az Errors-rendszer + Discord, ha bekötve). `warning` → `DyFM_ErrorLevel.warning`,
-  `critical` → `.critical`. Plusz egy in-memory ring-buffer (`getHistory()`) +
-  `getStatus()` (állapot + csúcsok) egy esetleges status-endpointhoz.
-- **Hiszterézis:** eseményt CSAK állapot-váltáskor jelez (normal→warning→critical), és a
-  `recoveryMargin`-nyit a warning alá esve jelez `recovered`-et → nincs küszöb-körüli spam.
-- **NEM csinál:** nem állítja le/újraindítja a process-t (az a konténer `restart:` policy
-  dolga), és nem próbálja elkapni a fatal OOM-ot (nem lehet). Tisztán megfigyelés +
-  rögzítés + opcionális `onCritical` hook (amivel a fogyasztó terhet dobhat).
-- **Biztonság:** minden út `try/catch`-elt — egy figyelő-réteg SOHA nem dönthet be egy
-  szervert. A timer `unref()`-elt (nem tartja életben a process-t).
-
-## Használat
-
-**Automatikus (default-on):** a base `App` startup feltelepíti, ha
-`DyNTS_global_settings.memoryGuard.enabled === true` (alapértelmezés szerint igen). Tehát
-**minden nts-szerver megkapja** az nts-dynamo bump után — kód nélkül.
-
-**Explicit / testreszabott:**
-```ts
-import { DyNTS_MemoryGuard } from '@futdevpro/nts-dynamo';
-
-DyNTS_MemoryGuard.getInstance().install({
-  heapWarningThreshold: 80,
-  heapCriticalThreshold: 92,
-  onCritical: (e) => { /* pl. terhelés-dobás / külső riasztás */ },
-});
-```
-
-**Konfiguráció** (`DyNTS_global_settings.memoryGuard`, defaultok):
-| mező | default | jelentés |
-|------|---------|----------|
-| `enabled` | `true` | a base App feltelepíti |
-| `pollIntervalMs` | `10000` | poll-gyakoriság |
-| `heapWarningThreshold` | `85` | warning a heap-plafon %-ában |
-| `heapCriticalThreshold` | `95` | critical % |
-| `recoveryMargin` | `10` | a warning alatti margó a `recovered`-hez |
-| `maxHistoryCount` | `100` | megőrzött események |
-
-## Az OOM-self-healing nagyobb képe
-
-Ez a **„rögzítés" rétege** (record). A **„restart" rétege** a konténer-szintű
-`restart: on-failure:N` + `mem_limit` (compose, fdp-devops) — együtt adják a teljes
-self-healinget: a guard nyomot hagy a near-OOM-ról, a restart-policy auto-helyreállít a
-crash után. A **forrás-prevenció** (a túl nagy payload parse-olásának elkerülése) külön
-réteg (runner-oldali report-cap / body-limit).
-
-## Fájlok
-- `src/_services/core/memory-guard.service.ts` + `.spec.ts` (11 spec)
-- `src/_models/interfaces/global-settings.interface.ts` (`memoryGuard` mező)
-- `src/_collections/global-settings.const.ts` (defaultok, enabled:true)
-- `src/_services/server/app.server.ts` (guarded auto-install a startup-ban)
-- `src/index.ts` (fő-export)