@futdevpro/nts-dynamo 1.15.151 → 1.15.154

package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-pipeline.spec.ts

@@ -1,105 +1,105 @@
-import { DyFM_AI_ModelInfo, DyFM_AI_ModelType, DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_FixtureSerializer_Util } from '../_collections/aim-fixture-serializer.util';
-import { DyNTS_AIMock_FixtureHarness_Service } from './aim-fixture-harness.service';
-import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
-import { DyNTS_AIMock_Service } from './aim-mock.service';
-
-/**
- * **End-to-end pipeline-bizonyitas (MP-3 + MP-4), NULLA koltessel.**
- *
- * A teljes fixture-eletciklust vegigviszi egyetlen teszben:
- *   `harness.capture()` (stub-generator) → `serializer.toConstantFile()` (beegetett konstans) →
- *   visszaolvasas (a generalt tomb-literal ERVENYES JSON) → `store.register()` → `service.chatCompletion()`.
- *
- * Ez azt igazolja, hogy a beegetett artefaktum **hianytalanul visszaallithato mukodo fixture-re** — vagyis a
- * G1 (fizetos generalas) jovahagyasakor a gepezet mar bizonyitottan mukodik, csak valodi generatort kap.
- */
-describe('| ai-mock fixture-pipeline (end-to-end, stub-generatorral)', () => {
-
-  const registry: DyFM_AI_ModelInfo[] = [
-    {
-      id: 'cheap-mini',
-      provider: DyFM_AI_Provider.OpenAI,
-      modelType: DyFM_AI_ModelType.Chat,
-      tier: 'mini',
-      capabilities: {} as any,
-    },
-  ];
-
-  const request: DyNTS_AIMock_Request = {
-    provider: 'open-ai',
-    model: 'cheap-mini',
-    modality: DyNTS_AIMock_Modality.text,
-    config: { maxTokens: 32 },
-    input: 'Mi a fovarosa Magyarorszagnak?',
-  };
-
-  /** A beegetett konstans-fajlbol visszaolvassa a fixture-tombot (a tomb-literal ervenyes JSON). */
-  function parseBack(source: string): DyNTS_AIMock_Fixture[] {
-    const start: number = source.indexOf('= [') + 2;
-    const end: number = source.lastIndexOf('];') + 1;
-
-    return JSON.parse(source.slice(start, end));
-  }
-
-  it('| capture → serialize → parse-back → store → replay: a beegetett ertek jon vissza', async () => {
-    // 1) GENERALAS — stub-generator, NULLA valodi hivas. A spend-guard explicit engedelyezve CSAK a stubhoz.
-    const harness: DyNTS_AIMock_FixtureHarness_Service = new DyNTS_AIMock_FixtureHarness_Service({
-      generator: async (): Promise<unknown> => 'Budapest.',
-      registry: registry,
-      allowRealSpend: true,
-      nowIso: (): string => '2026-07-21T00:00:00.000Z',
-    });
-
-    const captured: DyNTS_AIMock_Fixture = await harness.capture(request);
-
-    // 2) BEEGETES — determinisztikus TS-konstans fajl tartalma
-    const fileSource: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
-      constName: 'DyNTS_AIMock_PipelineFixtures',
-      fixtures: [ captured ],
-    });
-
-    expect(fileSource).toContain('export const DyNTS_AIMock_PipelineFixtures');
-
-    // 3) VISSZAOLVASAS — a beegetett artefaktumbol ujra fixture-objektum
-    const reloaded: DyNTS_AIMock_Fixture[] = parseBack(fileSource);
-
-    expect(reloaded.length).toBe(1);
-    expect(reloaded[0].inputHash).toBe(captured.inputHash);
-
-    // 4) REPLAY — a visszaolvasott fixture-t a store-ba tolve a mock ugyanazt adja vissza
-    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service(reloaded);
-    const service: DyNTS_AIMock_Service = new DyNTS_AIMock_Service(store, registry);
-
-    await expectAsync(
-      service.chatCompletion({
-        provider: 'open-ai',
-        model: 'cheap-mini',
-        config: { maxTokens: 32 },
-        input: 'Mi a fovarosa Magyarorszagnak?',
-      })
-    ).toBeResolvedTo('Budapest.');
-  });
-
-  it('| a beegetes/visszaolvasas kortje IDEMPOTENS (ketszer szerializalva azonos fajl)', async () => {
-    const harness: DyNTS_AIMock_FixtureHarness_Service = new DyNTS_AIMock_FixtureHarness_Service({
-      generator: async (): Promise<unknown> => 'Budapest.',
-      registry: registry,
-      allowRealSpend: true,
-      nowIso: (): string => '2026-07-21T00:00:00.000Z',
-    });
-
-    const captured: DyNTS_AIMock_Fixture = await harness.capture(request);
-    const first: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({ constName: 'X', fixtures: [ captured ] });
-    const second: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
-      constName: 'X',
-      fixtures: parseBack(first),
-    });
-
-    expect(second).toBe(first);
-  });
-});
+import { DyFM_AI_ModelInfo, DyFM_AI_ModelType, DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
+
+import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
+import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+import { DyNTS_AIMock_FixtureSerializer_Util } from '../_collections/aim-fixture-serializer.util';
+import { DyNTS_AIMock_FixtureHarness_Service } from './aim-fixture-harness.service';
+import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
+import { DyNTS_AIMock_Service } from './aim-mock.service';
+
+/**
+ * **End-to-end pipeline-bizonyitas (MP-3 + MP-4), NULLA koltessel.**
+ *
+ * A teljes fixture-eletciklust vegigviszi egyetlen teszben:
+ *   `harness.capture()` (stub-generator) → `serializer.toConstantFile()` (beegetett konstans) →
+ *   visszaolvasas (a generalt tomb-literal ERVENYES JSON) → `store.register()` → `service.chatCompletion()`.
+ *
+ * Ez azt igazolja, hogy a beegetett artefaktum **hianytalanul visszaallithato mukodo fixture-re** — vagyis a
+ * G1 (fizetos generalas) jovahagyasakor a gepezet mar bizonyitottan mukodik, csak valodi generatort kap.
+ */
+describe('| ai-mock fixture-pipeline (end-to-end, stub-generatorral)', () => {
+
+  const registry: DyFM_AI_ModelInfo[] = [
+    {
+      id: 'cheap-mini',
+      provider: DyFM_AI_Provider.OpenAI,
+      modelType: DyFM_AI_ModelType.Chat,
+      tier: 'mini',
+      capabilities: {} as any,
+    },
+  ];
+
+  const request: DyNTS_AIMock_Request = {
+    provider: 'open-ai',
+    model: 'cheap-mini',
+    modality: DyNTS_AIMock_Modality.text,
+    config: { maxTokens: 32 },
+    input: 'Mi a fovarosa Magyarorszagnak?',
+  };
+
+  /** A beegetett konstans-fajlbol visszaolvassa a fixture-tombot (a tomb-literal ervenyes JSON). */
+  function parseBack(source: string): DyNTS_AIMock_Fixture[] {
+    const start: number = source.indexOf('= [') + 2;
+    const end: number = source.lastIndexOf('];') + 1;
+
+    return JSON.parse(source.slice(start, end));
+  }
+
+  it('| capture → serialize → parse-back → store → replay: a beegetett ertek jon vissza', async () => {
+    // 1) GENERALAS — stub-generator, NULLA valodi hivas. A spend-guard explicit engedelyezve CSAK a stubhoz.
+    const harness: DyNTS_AIMock_FixtureHarness_Service = new DyNTS_AIMock_FixtureHarness_Service({
+      generator: async (): Promise<unknown> => 'Budapest.',
+      registry: registry,
+      allowRealSpend: true,
+      nowIso: (): string => '2026-07-21T00:00:00.000Z',
+    });
+
+    const captured: DyNTS_AIMock_Fixture = await harness.capture(request);
+
+    // 2) BEEGETES — determinisztikus TS-konstans fajl tartalma
+    const fileSource: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
+      constName: 'DyNTS_AIMock_PipelineFixtures',
+      fixtures: [ captured ],
+    });
+
+    expect(fileSource).toContain('export const DyNTS_AIMock_PipelineFixtures');
+
+    // 3) VISSZAOLVASAS — a beegetett artefaktumbol ujra fixture-objektum
+    const reloaded: DyNTS_AIMock_Fixture[] = parseBack(fileSource);
+
+    expect(reloaded.length).toBe(1);
+    expect(reloaded[0].inputHash).toBe(captured.inputHash);
+
+    // 4) REPLAY — a visszaolvasott fixture-t a store-ba tolve a mock ugyanazt adja vissza
+    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service(reloaded);
+    const service: DyNTS_AIMock_Service = new DyNTS_AIMock_Service(store, registry);
+
+    await expectAsync(
+      service.chatCompletion({
+        provider: 'open-ai',
+        model: 'cheap-mini',
+        config: { maxTokens: 32 },
+        input: 'Mi a fovarosa Magyarorszagnak?',
+      })
+    ).toBeResolvedTo('Budapest.');
+  });
+
+  it('| a beegetes/visszaolvasas kortje IDEMPOTENS (ketszer szerializalva azonos fajl)', async () => {
+    const harness: DyNTS_AIMock_FixtureHarness_Service = new DyNTS_AIMock_FixtureHarness_Service({
+      generator: async (): Promise<unknown> => 'Budapest.',
+      registry: registry,
+      allowRealSpend: true,
+      nowIso: (): string => '2026-07-21T00:00:00.000Z',
+    });
+
+    const captured: DyNTS_AIMock_Fixture = await harness.capture(request);
+    const first: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({ constName: 'X', fixtures: [ captured ] });
+    const second: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
+      constName: 'X',
+      fixtures: parseBack(first),
+    });
+
+    expect(second).toBe(first);
+  });
+});

package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.spec.ts

@@ -1,50 +1,50 @@
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
-import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
-
-describe('DyNTS_AIMock_FixtureStore_Service', () => {
-
-  const fixture: DyNTS_AIMock_Fixture = {
-    provider: 'open-ai',
-    model: 'gpt-4o-mini',
-    modality: DyNTS_AIMock_Modality.text,
-    config: { temperature: 0 },
-    input: 'ping',
-    inputHash: DyNTS_AIMock_FixtureMatch_Util.buildInputHash('ping'),
-    output: 'pong',
-    capturedAt: '2026-07-21T00:00:00.000Z',
-  };
-
-  const hitRequest: DyNTS_AIMock_Request = {
-    provider: 'open-ai',
-    model: 'gpt-4o-mini',
-    modality: DyNTS_AIMock_Modality.text,
-    config: { temperature: 0 },
-    input: 'ping',
-  };
-
-  it('register + resolve hit → a fixture', () => {
-    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service([fixture]);
-
-    expect(store.resolve(hitRequest)).toBe(fixture);
-    expect(store.has(hitRequest)).toBe(true);
-    expect(store.size).toBe(1);
-  });
-
-  it('resolve miss → undefined + has false', () => {
-    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service([fixture]);
-    const miss: DyNTS_AIMock_Request = { ...hitRequest, input: 'unknown' };
-
-    expect(store.resolve(miss)).toBeUndefined();
-    expect(store.has(miss)).toBe(false);
-  });
-
-  it('resolve config-sorrend-független hit', () => {
-    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service([fixture]);
-    const reordered: DyNTS_AIMock_Request = { ...hitRequest, config: { temperature: 0 } };
-
-    expect(store.resolve(reordered)).toBe(fixture);
-  });
-});
+import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
+import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+import { DyNTS_AIMock_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
+import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
+
+describe('DyNTS_AIMock_FixtureStore_Service', () => {
+
+  const fixture: DyNTS_AIMock_Fixture = {
+    provider: 'open-ai',
+    model: 'gpt-4o-mini',
+    modality: DyNTS_AIMock_Modality.text,
+    config: { temperature: 0 },
+    input: 'ping',
+    inputHash: DyNTS_AIMock_FixtureMatch_Util.buildInputHash('ping'),
+    output: 'pong',
+    capturedAt: '2026-07-21T00:00:00.000Z',
+  };
+
+  const hitRequest: DyNTS_AIMock_Request = {
+    provider: 'open-ai',
+    model: 'gpt-4o-mini',
+    modality: DyNTS_AIMock_Modality.text,
+    config: { temperature: 0 },
+    input: 'ping',
+  };
+
+  it('register + resolve hit → a fixture', () => {
+    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service([fixture]);
+
+    expect(store.resolve(hitRequest)).toBe(fixture);
+    expect(store.has(hitRequest)).toBe(true);
+    expect(store.size).toBe(1);
+  });
+
+  it('resolve miss → undefined + has false', () => {
+    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service([fixture]);
+    const miss: DyNTS_AIMock_Request = { ...hitRequest, input: 'unknown' };
+
+    expect(store.resolve(miss)).toBeUndefined();
+    expect(store.has(miss)).toBe(false);
+  });
+
+  it('resolve config-sorrend-független hit', () => {
+    const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service([fixture]);
+    const reordered: DyNTS_AIMock_Request = { ...hitRequest, config: { temperature: 0 } };
+
+    expect(store.resolve(reordered)).toBe(fixture);
+  });
+});

package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.ts

@@ -1,65 +1,65 @@
-import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
-
-/**
- * A beégetett fixture-ök tára — match-kulcs → fixture Map (lazy-cache; a Map MAGA a cache). A fixture-öket
- * konstans-blob-fájlokból (D6, git-tracked) importáljuk és `register`-rel adjuk be; a runtime-feloldás a
- * `DyNTS_AIMock_FixtureMatch_Util.buildMatchKey`-en megy (config-sorrend- + input-whitespace-független).
- * A reject-on-unknown (D3) NEM itt dől el — a `resolve` `undefined`-et ad, a hívó (`DyNTS_AIMock_Service`)
- * dob strukturált „no-fixture" hibát. Ez a réteg tiszta, hálózat-mentes — NEM generál (SP-3.2 = G1 gate).
- */
-export class DyNTS_AIMock_FixtureStore_Service {
-
-  /** match-kulcs → fixture. */
-  private readonly fixturesByKey: Map<string, DyNTS_AIMock_Fixture> = new Map();
-
-  /** @param fixtures opcionális kezdő-készlet (konstans-blob-okból). */
-  constructor(fixtures?: DyNTS_AIMock_Fixture[]) {
-    if (fixtures?.length) {
-      this.register(fixtures);
-    }
-  }
-
-  /**
-   * Fixture-ök beindexelése (match-kulcs szerint). Azonos kulcsú fixture felülírja a korábbit (last-wins).
-   * @param fixtures - a beégetett fixture-rekordok
-   */
-  register(fixtures: DyNTS_AIMock_Fixture[]): void {
-    for (const fixture of fixtures) {
-      this.fixturesByKey.set(this.keyOf(fixture), fixture);
-    }
-  }
-
-  /**
-   * Input-match feloldás: hit → fixture; miss → `undefined` (a reject-on-unknown a hívó dolga).
-   * @param request - a mock-hívás bemenete
-   */
-  resolve(request: DyNTS_AIMock_Request): DyNTS_AIMock_Fixture | undefined {
-    return this.fixturesByKey.get(DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(request));
-  }
-
-  /**
-   * Van-e fixture az adott request-re.
-   * @param request - a mock-hívás bemenete
-   */
-  has(request: DyNTS_AIMock_Request): boolean {
-    return this.fixturesByKey.has(DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(request));
-  }
-
-  /** A beindexelt fixture-ök száma. */
-  get size(): number {
-    return this.fixturesByKey.size;
-  }
-
-  /** A fixture match-kulcsa a saját nyers mezőiből (a `resolve`-val szimmetrikusan képezve). */
-  private keyOf(fixture: DyNTS_AIMock_Fixture): string {
-    return DyNTS_AIMock_FixtureMatch_Util.buildMatchKey({
-      provider: fixture.provider,
-      model: fixture.model,
-      modality: fixture.modality,
-      config: fixture.config,
-      input: fixture.input,
-    });
-  }
-}
+import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+import { DyNTS_AIMock_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
+
+/**
+ * A beégetett fixture-ök tára — match-kulcs → fixture Map (lazy-cache; a Map MAGA a cache). A fixture-öket
+ * konstans-blob-fájlokból (D6, git-tracked) importáljuk és `register`-rel adjuk be; a runtime-feloldás a
+ * `DyNTS_AIMock_FixtureMatch_Util.buildMatchKey`-en megy (config-sorrend- + input-whitespace-független).
+ * A reject-on-unknown (D3) NEM itt dől el — a `resolve` `undefined`-et ad, a hívó (`DyNTS_AIMock_Service`)
+ * dob strukturált „no-fixture" hibát. Ez a réteg tiszta, hálózat-mentes — NEM generál (SP-3.2 = G1 gate).
+ */
+export class DyNTS_AIMock_FixtureStore_Service {
+
+  /** match-kulcs → fixture. */
+  private readonly fixturesByKey: Map<string, DyNTS_AIMock_Fixture> = new Map();
+
+  /** @param fixtures opcionális kezdő-készlet (konstans-blob-okból). */
+  constructor(fixtures?: DyNTS_AIMock_Fixture[]) {
+    if (fixtures?.length) {
+      this.register(fixtures);
+    }
+  }
+
+  /**
+   * Fixture-ök beindexelése (match-kulcs szerint). Azonos kulcsú fixture felülírja a korábbit (last-wins).
+   * @param fixtures - a beégetett fixture-rekordok
+   */
+  register(fixtures: DyNTS_AIMock_Fixture[]): void {
+    for (const fixture of fixtures) {
+      this.fixturesByKey.set(this.keyOf(fixture), fixture);
+    }
+  }
+
+  /**
+   * Input-match feloldás: hit → fixture; miss → `undefined` (a reject-on-unknown a hívó dolga).
+   * @param request - a mock-hívás bemenete
+   */
+  resolve(request: DyNTS_AIMock_Request): DyNTS_AIMock_Fixture | undefined {
+    return this.fixturesByKey.get(DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(request));
+  }
+
+  /**
+   * Van-e fixture az adott request-re.
+   * @param request - a mock-hívás bemenete
+   */
+  has(request: DyNTS_AIMock_Request): boolean {
+    return this.fixturesByKey.has(DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(request));
+  }
+
+  /** A beindexelt fixture-ök száma. */
+  get size(): number {
+    return this.fixturesByKey.size;
+  }
+
+  /** A fixture match-kulcsa a saját nyers mezőiből (a `resolve`-val szimmetrikusan képezve). */
+  private keyOf(fixture: DyNTS_AIMock_Fixture): string {
+    return DyNTS_AIMock_FixtureMatch_Util.buildMatchKey({
+      provider: fixture.provider,
+      model: fixture.model,
+      modality: fixture.modality,
+      config: fixture.config,
+      input: fixture.input,
+    });
+  }
+}

package/src/_modules/ai/_modules/ai-mock/_services/aim-integration-proof.spec.ts

@@ -1,92 +1,92 @@
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_ServiceCollection } from '../_models/interfaces/aim-service-collection.interface';
-import { getDefaultAiMockServiceCollection } from '../_collections/aim-default-collection.util';
-import { DyNTS_AIMock_TextFixtures } from '../fixtures/aim-text.fixtures';
-
-/**
- * **MP-8 SP-8.2 — integracios bizonyitas, NULLA halozattal.**
- *
- * Ez a spec a TENYLEGESEN COMMITOLT, valodi AI-generalasbol beegetett fixture-oket (`DyNTS_AIMock_TextFixtures`)
- * tolti be a `getDefaultAiMockServiceCollection` factory-n keresztul — vagyis pontosan azon az uton, ahogy egy
- * consumer hasznalna —, es igazolja a rendszer ket alapigeretet:
- *  1. **replay**: a beegetett valasz visszajon, outbound hivas NELKUL,
- *  2. **reject-on-unknown**: a nem beegetett input strukturalt hibat kap (D3 — sosem csendes fallback).
- *
- * Ha ez a spec zold, akkor a lanc `valodi generalas → determinisztikus beegetes → offline replay` mukodik.
- */
-describe('| ai-mock INTEGRACIOS BIZONYITAS (commitolt fixture-ok, halozat nelkul)', () => {
-
-  /** A beegetett keszlet legyen tenylegesen jelen — ures fixture-keszlet eseten a spec hamis-zold lenne. */
-  it('| a commitolt fixture-keszlet NEM ures (kulonben a tobbi allitas ertelmetlen)', () => {
-    expect(DyNTS_AIMock_TextFixtures.length).toBeGreaterThan(0);
-  });
-
-  it('| a factory-n keresztul betoltve a beegetett valasz VISSZAJATSZHATO (outbound hivas nelkul)', async () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
-      fixtures: DyNTS_AIMock_TextFixtures,
-    });
-
-    const chat: DyNTS_AIMock_Fixture = DyNTS_AIMock_TextFixtures.find(
-      (fixture: DyNTS_AIMock_Fixture) => fixture.modality === DyNTS_AIMock_Modality.text && !!fixture.output
-    );
-
-    expect(chat).toBeDefined();
-
-    const replayed: unknown = await collection.service.chatCompletion({
-      provider: chat.provider,
-      model: chat.model,
-      config: chat.config,
-      input: chat.input,
-    });
-
-    expect(replayed).toEqual(chat.output);
-  });
-
-  it('| embedding-fixture is visszajatszhato ugyanazon a felületen', async () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
-      fixtures: DyNTS_AIMock_TextFixtures,
-    });
-
-    const embedding: DyNTS_AIMock_Fixture = DyNTS_AIMock_TextFixtures.find(
-      (fixture: DyNTS_AIMock_Fixture) => fixture.modality === DyNTS_AIMock_Modality.embedding
-    );
-
-    if (!embedding) {
-      pending('nincs embedding-fixture a beegetett keszletben');
-
-      return;
-    }
-
-    const replayed: unknown = await collection.service.embed({
-      provider: embedding.provider,
-      model: embedding.model,
-      config: embedding.config,
-      input: embedding.input,
-    });
-
-    expect(replayed).toEqual(embedding.output);
-  });
-
-  it('| NEM beegetett input → strukturalt reject-on-unknown (D3: sosem csendes fallback)', async () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
-      fixtures: DyNTS_AIMock_TextFixtures,
-    });
-
-    try {
-      await collection.service.chatCompletion({
-        provider: 'open-ai',
-        model: 'gpt-4o-mini',
-        input: 'ezt a bemenetet SOHA nem egettuk be',
-      });
-      fail('reject-on-unknown-t vartunk');
-    } catch (error) {
-      expect(error instanceof DyFM_Error).toBe(true);
-      if (error instanceof DyFM_Error) {
-        expect(error.message).toContain('no fixture');
-      }
-    }
-  });
-});
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+import { DyNTS_AIMock_ServiceCollection } from '../_models/interfaces/aim-service-collection.interface';
+import { getDefaultAiMockServiceCollection } from '../_collections/aim-default-collection.util';
+import { DyNTS_AIMock_TextFixtures } from '../fixtures/aim-text.fixtures';
+
+/**
+ * **MP-8 SP-8.2 — integracios bizonyitas, NULLA halozattal.**
+ *
+ * Ez a spec a TENYLEGESEN COMMITOLT, valodi AI-generalasbol beegetett fixture-oket (`DyNTS_AIMock_TextFixtures`)
+ * tolti be a `getDefaultAiMockServiceCollection` factory-n keresztul — vagyis pontosan azon az uton, ahogy egy
+ * consumer hasznalna —, es igazolja a rendszer ket alapigeretet:
+ *  1. **replay**: a beegetett valasz visszajon, outbound hivas NELKUL,
+ *  2. **reject-on-unknown**: a nem beegetett input strukturalt hibat kap (D3 — sosem csendes fallback).
+ *
+ * Ha ez a spec zold, akkor a lanc `valodi generalas → determinisztikus beegetes → offline replay` mukodik.
+ */
+describe('| ai-mock INTEGRACIOS BIZONYITAS (commitolt fixture-ok, halozat nelkul)', () => {
+
+  /** A beegetett keszlet legyen tenylegesen jelen — ures fixture-keszlet eseten a spec hamis-zold lenne. */
+  it('| a commitolt fixture-keszlet NEM ures (kulonben a tobbi allitas ertelmetlen)', () => {
+    expect(DyNTS_AIMock_TextFixtures.length).toBeGreaterThan(0);
+  });
+
+  it('| a factory-n keresztul betoltve a beegetett valasz VISSZAJATSZHATO (outbound hivas nelkul)', async () => {
+    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
+      fixtures: DyNTS_AIMock_TextFixtures,
+    });
+
+    const chat: DyNTS_AIMock_Fixture = DyNTS_AIMock_TextFixtures.find(
+      (fixture: DyNTS_AIMock_Fixture) => fixture.modality === DyNTS_AIMock_Modality.text && !!fixture.output
+    );
+
+    expect(chat).toBeDefined();
+
+    const replayed: unknown = await collection.service.chatCompletion({
+      provider: chat.provider,
+      model: chat.model,
+      config: chat.config,
+      input: chat.input,
+    });
+
+    expect(replayed).toEqual(chat.output);
+  });
+
+  it('| embedding-fixture is visszajatszhato ugyanazon a felületen', async () => {
+    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
+      fixtures: DyNTS_AIMock_TextFixtures,
+    });
+
+    const embedding: DyNTS_AIMock_Fixture = DyNTS_AIMock_TextFixtures.find(
+      (fixture: DyNTS_AIMock_Fixture) => fixture.modality === DyNTS_AIMock_Modality.embedding
+    );
+
+    if (!embedding) {
+      pending('nincs embedding-fixture a beegetett keszletben');
+
+      return;
+    }
+
+    const replayed: unknown = await collection.service.embed({
+      provider: embedding.provider,
+      model: embedding.model,
+      config: embedding.config,
+      input: embedding.input,
+    });
+
+    expect(replayed).toEqual(embedding.output);
+  });
+
+  it('| NEM beegetett input → strukturalt reject-on-unknown (D3: sosem csendes fallback)', async () => {
+    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
+      fixtures: DyNTS_AIMock_TextFixtures,
+    });
+
+    try {
+      await collection.service.chatCompletion({
+        provider: 'open-ai',
+        model: 'gpt-4o-mini',
+        input: 'ezt a bemenetet SOHA nem egettuk be',
+      });
+      fail('reject-on-unknown-t vartunk');
+    } catch (error) {
+      expect(error instanceof DyFM_Error).toBe(true);
+      if (error instanceof DyFM_Error) {
+        expect(error.message).toContain('no fixture');
+      }
+    }
+  });
+});