@futdevpro/fdp-agent-memory 0.1.0

package/build/src/_models/data-models/fam-error.data-model.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.famError_dataParams = exports.FAM_Error_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `FAM_Error` rekord (collection `fam_errors`, dsgn-008 §2). **REUSE, NEM reinvent** (dsgn-008 §1):
+ * `extends DyFM_Errors<DyFM_Error>` — a Dynamo error-record bázisa, ahonnan az **auto-dedup +
+ * occurrence-count** (`count`), a `level`/`source`/`message`/`stackTrace`/`versions`/`duplications`
+ * mind örökölt. A `DyNTS_Errors_DataService` (amit a `FAM_Error_DataService` terjeszt) ezeket
+ * kezeli — saját error-infra NEM épül.
+ *
+ * A `FAM_Error` a bázist a FAM-rétegekre szabott mezőkkel egészíti ki:
+ * - `errorCode` — a `FAM-<SVC>-<METHOD>-NNN` séma (a katalógus SSOT-ból, dsgn-008 §3),
+ * - `handled` — UI-ból / `list_errors` capability-ből "kezelve" jelölhető (dsgn-008 §5),
+ * - `contextSnapshot` — a diagnózis-kontextus (dsgn-008 §2, sensitive-szűrt — `FAM_ErrorContext_Util`).
+ *
+ * A dsgn-008 §2 `occurrenceCount` shape-mező a Dynamo-bázis **`count`**-jára képződik: a dedup-on a
+ * base `recordError` a `count`-ot növeli (azonos `message` → +1, nem új rekord). NEM teszünk rá
+ * getter-t a DataModel-re (az a `DyFM_DataProperties` mapped-type-ban kötelező séma-mezőt kívánna);
+ * a dsgn-008 §2 mezőnévre a `occurrenceCount(record)` statikus projekció ad hozzáférést, így a
+ * `list_errors`/UI a spec-mezőnévvel olvashat, a persisztált shape pedig változatlan (= Dynamo
+ * errors-record + FAM-mezők).
+ */
+class FAM_Error_DataModel extends fsm_dynamo_1.DyFM_Errors {
+    /** Egyedi, kereshető hibakód (`FAM-<SVC>-<METHOD>-NNN`, dsgn-008 §3 katalógus). */
+    errorCode;
+    /** "Kezelve" jelölés (UI / `list_errors`); default `false` (dsgn-008 §2/§5). */
+    handled = false;
+    /** Diagnózis-kontextus (dsgn-008 §2); sensitive-szűrt (`FAM_ErrorContext_Util`). */
+    contextSnapshot;
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+    /**
+     * A dsgn-008 §2 `occurrenceCount` projekció — a Dynamo-bázis `count` (default 1). A `list_errors`/
+     * UI ezt a spec-mezőnevet adja ki a rekordról (a `count` a dedup által növelt szám).
+     */
+    static occurrenceCount(record) {
+        return record.count ?? 1;
+    }
+}
+exports.FAM_Error_DataModel = FAM_Error_DataModel;
+/**
+ * MongoDB data-params a `fam_errors` collection-höz (dsgn-008 §2). A `DyFM_errors_dataParams`
+ * (Dynamo errors-séma) tulajdonságait tükrözi (a dedup/occurrence/audit mezők), kiegészítve a
+ * FAM-specifikus `errorCode` / `handled` / `contextSnapshot` mezőkkel. NINCS `addArchive`: az
+ * error-rekord maga a tartós napló (a dedup felülír, nem archivál).
+ *
+ * A `contextSnapshot` `type:'object'` (Mongoose `Mixed`) — strukturált, de séma-szabad blob; a
+ * mező-halmaz a `FAM_ErrorContext` interfész (dsgn-008 §2), nem a Mongoose-séma kényszeríti.
+ */
+exports.famError_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'fam_errors',
+    properties: {
+        // --- Dynamo errors-bázis (DyFM_errors_dataParams tükrözve) ---
+        flag: { type: 'string' },
+        issuer: { type: 'string', index: true },
+        username: { type: 'string' },
+        versions: { type: 'string[]' },
+        localTime: { type: 'string' },
+        region: { type: 'string' },
+        message: { type: 'string' },
+        exception: { type: 'string' },
+        exceptionObj: { type: 'any' },
+        stackTrace: { type: 'string[]' },
+        error: { type: 'any' },
+        count: { type: 'number' },
+        d_error: { type: 'DyFM_Error' },
+        additionalContent: { type: 'any' },
+        level: { type: 'DyFM_ErrorLevel', index: true },
+        priority: { type: 'number' },
+        duplications: { type: 'DyNTS_Error[]' },
+        category: { type: 'string', index: true },
+        fixAttempts: { type: 'any' },
+        lastFixedAt: { type: 'Date' },
+        lastFixedBy: { type: 'string' },
+        lastFixedInVersion: { type: 'string' },
+        lastFixHypothesis: { type: 'string' },
+        regressedAfterFix: { type: 'boolean' },
+        // --- FAM-specifikus (dsgn-008 §2) ---
+        errorCode: { type: 'string', index: true },
+        handled: { type: 'boolean', index: true },
+        contextSnapshot: { type: 'object' },
+    },
+});

package/build/src/_models/data-models/fam-ingest-run.data-model.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.famIngestRun_dataParams = exports.FAM_IngestRun_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `FAM_IngestRun` — ingest-futtatás összefoglaló (dsgn-001 §7 + dsgn-004 §5).
+ * Collection `fam_ingest_runs`; `extends DyFM_Metadata` (NEM `FAM_Entry`).
+ *
+ * Minden scan-művelet EGYETLEN ilyen rekordot ír; minden generált chunk megőrzi az
+ * `ingestRunId`-jét (`FAM_Entry.ingestRunId`) — így a run chunkjai csoportosan listázhatók/
+ * törölhetők (dsgn-004 §5). MP-4 a fogyasztó/író; itt a stabil minimál szerződés.
+ *
+ * `_id` = a `runId` (UUID v4).
+ */
+class FAM_IngestRun_DataModel extends fsm_dynamo_1.DyFM_Metadata {
+    /** A futtatás triggere. */
+    trigger;
+    /** Érintett tár(ak) — egy `scan-project` többet is érinthet. */
+    table;
+    /** Feloldott canonical scope (dsgn-002). */
+    scopePath = [];
+    /** A scan gyökere (projekt-relatív). */
+    rootPath;
+    /** Ténylegesen route-olt + chunkolt fájlok száma. */
+    filesProcessed;
+    /** Skip-routing + biztonsági szűrés miatt kihagyott fájlok száma. */
+    filesSkipped;
+    /** Generált chunkok összesen. */
+    chunkCount;
+    /** Delta-detection aggregátum (`new`/`modified`/`equal`/`deleted`). */
+    verdicts;
+    /** Embedding token-költség (dsgn-006; BEDROCK-FRS surface — `undefined`, ha nem elérhető). */
+    embedTokenCost;
+    /** A futtatás időtartama (ms). */
+    durationMs;
+    /** Futtatás-állapot (dsgn-004 §5). */
+    status;
+    /**
+     * Részleges hibák (dsgn-008) — per-fájl hiba nem buktatja az egész run-t.
+     * Minimál szerződés MP-1-ben (object[]); a `FAM_ErrorRef` shape pontosítása dsgn-008 / MP-4.
+     */
+    errors = [];
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.FAM_IngestRun_DataModel = FAM_IngestRun_DataModel;
+/**
+ * MongoDB data-params a `fam_ingest_runs` collection-höz (dsgn-004 §5).
+ *
+ * Stabil minimál szerződés (runId/table/scope/status/számlálók); a bővítés MP-4-ben additív
+ * (non-breaking). Nincs vektor-mező (a run nem retrieve-elhető tartalom).
+ */
+exports.famIngestRun_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'fam_ingest_runs',
+    addArchive: true,
+    properties: {
+        trigger: { type: 'string', index: true },
+        table: { type: 'array' },
+        scopePath: { type: 'array', default: [] },
+        rootPath: { type: 'string' },
+        filesProcessed: { type: 'number' },
+        filesSkipped: { type: 'number' },
+        chunkCount: { type: 'number' },
+        verdicts: { type: 'object' },
+        embedTokenCost: { type: 'number' },
+        durationMs: { type: 'number' },
+        status: { type: 'string', index: true },
+        errors: { type: 'array', default: [] },
+    },
+});

package/build/src/_models/data-models/fam-knowledge.data-model.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.famKnowledge_dataParams = exports.FAM_Knowledge_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const fam_entry_base_properties_const_1 = require("./fam-entry-base-properties.const");
+const fam_entry_data_model_1 = require("./fam-entry.data-model");
+/**
+ * `knowledge` tár (dsgn-001 §1/§4) — domain-tudás / fogalmak / definíciók / kapcsolatok.
+ *
+ * A `FAM_Entry` bázisra épül; per-tár mezők: `subject` (egysoros téma), `description` (részletes
+ * tudás) — a `content` ezek kombinációja a vektorizáláshoz. `kind` default `'knowledge'`.
+ */
+class FAM_Knowledge_DataModel extends fam_entry_data_model_1.FAM_Entry {
+    /** Egysoros téma / azonosító. */
+    subject;
+    /** Részletes tudás-tartalom (a `subject` kifejtése). */
+    description;
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.FAM_Knowledge_DataModel = FAM_Knowledge_DataModel;
+/**
+ * MongoDB data-params a `knowledge` tárhoz (collection `fam_knowledge`, dsgn-001 §1).
+ *
+ * `contentVector` `vectorizedFrom: ['content', 'subject', 'description']` — a subject + description
+ * merge maximalizálja a retrieval-jelet (dsgn-001 §4; embedding-provider MP-2). `kind` default
+ * `'knowledge'`.
+ */
+exports.famKnowledge_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'fam_knowledge',
+    addArchive: true,
+    properties: {
+        ...fam_entry_base_properties_const_1.famEntryBaseProperties,
+        kind: { type: 'string', index: true, default: 'knowledge' },
+        contentVector: {
+            type: 'number[]',
+            vectorizedFrom: ['content', 'subject', 'description'],
+            vectorizeUseIndex: 'contentVector',
+            default: [],
+        },
+        subject: { type: 'string', index: true },
+        description: { type: 'string' },
+    },
+});

package/build/src/_models/data-models/fam-memory.data-model.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.famMemory_dataParams = exports.FAM_Memory_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const fam_entry_base_properties_const_1 = require("./fam-entry-base-properties.const");
+const fam_entry_data_model_1 = require("./fam-entry.data-model");
+/**
+ * `memory` tár (dsgn-001 §1/§4) — történeti dolgok: session/development history, incidensek,
+ * megjegyzendő apróságok, lessons-learned (dsgn-001 §3).
+ *
+ * A `FAM_Entry` bázisra épül; per-tár mezők: `memoryType` (== `kind`), `sessionId`, `runId`,
+ * `instanceId`, `summarizedEntryIds` (rekurzív summary-referenciák — későbbi fázis foundation).
+ * `kind` default `'memory_entry'`.
+ */
+class FAM_Memory_DataModel extends fam_entry_data_model_1.FAM_Entry {
+    /** A memória-elem típusa (== `kind`: `session_history`|`summary`|`observation`|…). */
+    memoryType;
+    /** Forrás-session hivatkozás. */
+    sessionId;
+    /** Forrás-run hivatkozás. */
+    runId;
+    /** Forrás-instance hivatkozás. */
+    instanceId;
+    /** Rekurzív summary-referenciák (összegzett entry-`_id`-k — későbbi fázis foundation). */
+    summarizedEntryIds = [];
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.FAM_Memory_DataModel = FAM_Memory_DataModel;
+/**
+ * MongoDB data-params a `memory` tárhoz (collection `fam_memory`, dsgn-001 §1).
+ *
+ * `contentVector` `vectorizedFrom: ['content']` — auto-embed mentéskor (embedding-provider MP-2).
+ * `kind` default `'memory_entry'` (dsgn-001 §4).
+ */
+exports.famMemory_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'fam_memory',
+    addArchive: true,
+    properties: {
+        ...fam_entry_base_properties_const_1.famEntryBaseProperties,
+        kind: { type: 'string', index: true, default: 'memory_entry' },
+        contentVector: {
+            type: 'number[]', vectorizedFrom: ['content'], vectorizeUseIndex: 'contentVector', default: [],
+        },
+        memoryType: { type: 'string', index: true },
+        sessionId: { type: 'string', index: true },
+        runId: { type: 'string', index: true },
+        instanceId: { type: 'string', index: true },
+        summarizedEntryIds: { type: 'string[]', default: [] },
+    },
+});

package/build/src/_models/data-models/fam-reference.data-model.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.famReference_dataParams = exports.FAM_Reference_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `reference` helper-tár (dsgn-001 §5). NEM `FAM_Entry`-alapú (saját shape, `extends DyFM_Metadata`).
+ *
+ * Cél: alias/typo/fonetikus/STT-név → canonical fogalom ÉS scope-feloldás (dsgn-002). Soha nem
+ * önálló tudástár. A fuzzy-match a `contentVector`-on fut (canonicalTerm + description embedje).
+ *
+ * `addedBy` SZŰKÍTETT (`FAM_AddedBy_Constrained`): a `'scan'` / `'re-embed'` itt NEM értelmezett
+ * (dsgn-001 §6 megjegyzés).
+ */
+class FAM_Reference_DataModel extends fsm_dynamo_1.DyFM_Metadata {
+    /** A canonical (helyes) terminus (pl. `"Future Development Program Kft."`, `"Dynamo FSM"`). */
+    canonicalTerm;
+    /** Aliasok: typo + fonetikus + STT variánsok, amelyek a canonical terminusra mutatnak. */
+    aliasTerms = [];
+    /** Mit jelent / mire használt (a `canonicalTerm`-mel együtt adja a vektorizált tartalmat). */
+    description;
+    /** Vektorizált reprezentáció (canonicalTerm + description) — fuzzy match (embedding MP-2). */
+    contentVector = [];
+    /** Kategória (`project`|`package`|`concept`|`person`|`organization`|`scope-layer`). */
+    category;
+    /** Ha scope-feloldásra szolgál: melyik layer-re (pl. `'project'`). */
+    scopeLayer;
+    /** Ha az alias EGY konkrét scope-entitásra mutat. */
+    canonicalScopeRef;
+    /** Mely tárakra alkalmazandó (üres = mind). */
+    ragScopes = [];
+    /** Aktív-e — inaktív bejegyzés NEM expand-elődik (dsgn-002 §3.1). */
+    isActive = true;
+    /** Ki adta hozzá (szűkített: `manual` | `agent-write` | `import`). */
+    addedBy;
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.FAM_Reference_DataModel = FAM_Reference_DataModel;
+/**
+ * MongoDB data-params a `reference` helper-tárhoz (collection `fam_reference`, dsgn-001 §1/§5).
+ *
+ * `contentVector` `vectorizedFrom: ['canonicalTerm', 'description']` — fuzzy alias-match
+ * (embedding-provider MP-2). `isActive` default `true` (dsgn-002 §3.1).
+ */
+exports.famReference_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'fam_reference',
+    addArchive: true,
+    properties: {
+        canonicalTerm: { type: 'string', index: true, required: true },
+        aliasTerms: { type: 'string[]', index: true, default: [] },
+        description: { type: 'string' },
+        contentVector: {
+            type: 'number[]', vectorizedFrom: ['canonicalTerm', 'description'],
+            vectorizeUseIndex: 'contentVector', default: [],
+        },
+        category: { type: 'string', index: true },
+        scopeLayer: { type: 'string', index: true },
+        canonicalScopeRef: { type: 'object' },
+        ragScopes: { type: 'string[]', default: [] },
+        isActive: { type: 'boolean', index: true, default: true },
+        addedBy: { type: 'string', index: true },
+    },
+});

package/build/src/_models/data-models/fam-rules.data-model.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.famRules_dataParams = exports.FAM_Rules_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const fam_entry_base_properties_const_1 = require("./fam-entry-base-properties.const");
+const fam_entry_data_model_1 = require("./fam-entry.data-model");
+/**
+ * `rules` tár (dsgn-001 §1/§4) — szabályok (coding / architecture / naming / behavior / …).
+ *
+ * A `FAM_Entry` bázisra épül; per-tár mezők: `category` (== `kind`), `isActive` (inaktív szabály
+ * NEM retrieve-elődik), `applicableScopes` (üres = globális), `dimensions`.
+ * `kind` default `'rule'`, `isActive` default `true` (dsgn-001 §4).
+ */
+class FAM_Rules_DataModel extends fam_entry_data_model_1.FAM_Entry {
+    /** Kategória (== `kind`; pl. `'coding'` / `'project'` / `'naming'`). */
+    category;
+    /** Aktív-e — inaktív szabály NEM kerül retrieve-be (dsgn-001 §4). */
+    isActive = true;
+    /** Alkalmazható scope-ok (üres = globális szabály). */
+    applicableScopes = [];
+    /** Dimenziók (`server`|`client`|`fullstack`|`devops`|`testing`). */
+    dimensions = [];
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.FAM_Rules_DataModel = FAM_Rules_DataModel;
+/**
+ * MongoDB data-params a `rules` tárhoz (collection `fam_rules`, dsgn-001 §1).
+ *
+ * `contentVector` `vectorizedFrom: ['content']` — auto-embed mentéskor (dsgn-001 §8, dsgn-006 §3;
+ * embedding-provider bekötése MP-2). `kind` default `'rule'`, `isActive` default `true` (dsgn-001 §4).
+ */
+exports.famRules_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'fam_rules',
+    addArchive: true,
+    properties: {
+        ...fam_entry_base_properties_const_1.famEntryBaseProperties,
+        kind: { type: 'string', index: true, default: 'rule' },
+        contentVector: {
+            type: 'number[]', vectorizedFrom: ['content'], vectorizeUseIndex: 'contentVector', default: [],
+        },
+        category: { type: 'string', index: true },
+        isActive: { type: 'boolean', index: true, default: true },
+        applicableScopes: { type: 'array', default: [] },
+        dimensions: { type: 'string[]', index: true, default: [] },
+    },
+});

package/build/src/_models/data-models/fam-scope.data-model.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.famScope_dataParams = exports.FAM_Scope_DataModel = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `FAM_Scope` entitás (dsgn-002 §2). Normalizált scope-entitás + scope-fa (collection `fam_scopes`).
+ * `extends DyFM_Metadata` (NEM `FAM_Entry`).
+ *
+ * A scope NEM fix mezőhalmaz, hanem dinamikus lánc: akárhány layer, futásidőben bővíthető
+ * (dsgn-002 §1). A `_id` a `scopeId`; a `parentScopeId` adja a fa-struktúrát (null = gyökér).
+ *
+ * `createdBy` SZŰKÍTETT (`FAM_AddedBy_Constrained`): a `'scan'` / `'re-embed'` itt NEM értelmezett
+ * (dsgn-002 §2, dsgn-001 §6 megjegyzés).
+ */
+class FAM_Scope_DataModel extends fsm_dynamo_1.DyFM_Metadata {
+    /** Dinamikus layer-név (`'organization'`|`'project'`|`'module'`|… — szabad string, NEM fix). */
+    layer;
+    /** Normalizált canonical név. */
+    canonicalName;
+    /** A fölérendelt scope (fa-struktúra; null = gyökér). */
+    parentScopeId;
+    /** Denormalizált gyors-alias gyorsítótár (forrás: `fam_reference`; szinkron MP-3). */
+    aliases = [];
+    /** Leírás. */
+    description;
+    /** Ki hozta létre (szűkített: `manual` | `agent-write` | `import`). */
+    createdBy;
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.FAM_Scope_DataModel = FAM_Scope_DataModel;
+/**
+ * MongoDB data-params a `fam_scopes` collection-höz (dsgn-002 §2).
+ *
+ * `aliases` default `[]`; nincs vektor-mező (a fuzzy alias-match a `fam_reference`-en fut).
+ */
+exports.famScope_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'fam_scopes',
+    addArchive: true,
+    properties: {
+        layer: { type: 'string', index: true, required: true },
+        canonicalName: { type: 'string', index: true, required: true },
+        parentScopeId: { type: 'string', index: true },
+        aliases: { type: 'string[]', index: true, default: [] },
+        description: { type: 'string' },
+        createdBy: { type: 'string', index: true },
+    },
+});

package/build/src/_models/interfaces/fam-common.interface.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_RECOMMENDED_TAGS = void 0;
+const fam_table_type_enum_1 = require("../../_enums/fam-table.type-enum");
+/**
+ * Per-tár ajánlott tag-vokabulár (dsgn-001 §3). DOKUMENTÁLT, NEM kényszerített: a `tags`
+ * típusa marad `string[]` (szabadon bővíthető — dsgn-001 §9.3). Ez csak felajánlott szótár
+ * az UI/CLI-nek és a konzisztens kategorizáláshoz.
+ */
+exports.FAM_RECOMMENDED_TAGS = {
+    [fam_table_type_enum_1.FAM_Table.rules]: ['coding', 'architecture', 'naming', 'behavior', 'security', 'project'],
+    [fam_table_type_enum_1.FAM_Table.documents]: ['spec', 'feature_request', 'bug_report', 'architecture_doc', 'dev_note', 'meeting_note', 'research_note'],
+    [fam_table_type_enum_1.FAM_Table.codebase]: ['source_file', 'symbol', 'function', 'class', 'interface', 'config', 'dataflow', 'runflow', 'module_summary'],
+    [fam_table_type_enum_1.FAM_Table.knowledge]: [
+        'fact', 'concept', 'definition', 'relationship',
+        'domain_knowledge', 'company_knowledge', 'user_knowledge', 'decision_rationale',
+    ],
+    [fam_table_type_enum_1.FAM_Table.codingPatterns]: ['pattern', 'anti_pattern', 'recipe', 'example', 'template', 'migration_pattern', 'debugging_pattern'],
+    [fam_table_type_enum_1.FAM_Table.memory]: [
+        'session_history', 'development_history', 'decision_history', 'incident', 'lesson_learned',
+        'important_note', 'user_preference', 'project_event', 'temporary_context', 'resolved_issue',
+    ],
+};

package/build/src/_models/interfaces/fam-config.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/_models/interfaces/fam-error.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/_modules/embedding/_collections/fam-embedding-pricing.const.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Embedding modell-ár táblázat (USD / 1000 input-token) — **BFR-AM-007 projekt-lokális workaround**
+ * (dsgn-006 §7, SP-2.4). A Dynamo NEM számol USD-t (nincs pricing-registry), ezért a cost-cap
+ * becsléséhez ITT tartunk egy konzervatív ár-táblát; a bedrock cost-aggregátor landolásakor (MP-15)
+ * ez lecserélődik a valós provider-számlára (a kulcs-szerződés stabil).
+ *
+ * A lokális providerek (LM Studio / mock) ára `0` — nincs USD-költség (dsgn-006 §7, csak telemetria).
+ * Az OpenAI árak a publikus listaár (2026-os szint, konzervatív felfelé kerekítve).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_EMBEDDING_CHARS_PER_TOKEN = exports.FAM_EMBEDDING_DEFAULT_OPENAI_PRICE_PER_1K = exports.FAM_EMBEDDING_PRICE_PER_1K_TOKENS = void 0;
+/** USD / 1000 input-token modellenként (ismeretlen OpenAI-modell → a `defaultOpenAiPer1k` fallback). */
+exports.FAM_EMBEDDING_PRICE_PER_1K_TOKENS = {
+    'text-embedding-3-large': 0.00013,
+    'text-embedding-3-small': 0.00002,
+    'text-embedding-ada-002': 0.0001,
+};
+/** Ismeretlen OpenAI-modell konzervatív fallback-ára (a legdrágább ismert modell ára). */
+exports.FAM_EMBEDDING_DEFAULT_OPENAI_PRICE_PER_1K = 0.00013;
+/** Egy token átlagos karakter-becslése (token-számláló nélküli becsléshez; ~4 char/token heurisztika). */
+exports.FAM_EMBEDDING_CHARS_PER_TOKEN = 4;

package/build/src/_modules/embedding/_collections/fam-store-registry.const.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_StoreRegistry_Util = exports.FAM_STORE_REGISTRY = void 0;
+const fam_table_type_enum_1 = require("../../../_enums/fam-table.type-enum");
+const fam_codebase_data_model_1 = require("../../../_models/data-models/fam-codebase.data-model");
+const fam_coding_patterns_data_model_1 = require("../../../_models/data-models/fam-coding-patterns.data-model");
+const fam_documents_data_model_1 = require("../../../_models/data-models/fam-documents.data-model");
+const fam_knowledge_data_model_1 = require("../../../_models/data-models/fam-knowledge.data-model");
+const fam_memory_data_model_1 = require("../../../_models/data-models/fam-memory.data-model");
+const fam_rules_data_model_1 = require("../../../_models/data-models/fam-rules.data-model");
+/**
+ * A 6 fő RAG-tár registry-je (dsgn-001 §1). A `reference`/`scope`/`config`/`ingest` helper-tárak
+ * NEM vektorizáltak, ezért kimaradnak. A `dataParams` típusát a közös `FAM_Entry` bázisra szűkítjük
+ * (a per-tár mezők a vektor-réteg számára irrelevánsak — csak a közös `content`/`contentVector`/
+ * `embeddingStatus`/`scopePath`/`tags`/`kind`/`weight` kell).
+ *
+ * **FIGYELEM:** a `dataParams` generikus paramétere a konkrét per-tár modell (pl. `FAM_Codebase_DataModel`),
+ * de a registry a `FAM_Entry`-bázisra normalizál (widening — NEM `as`-cast). Ez safe, mert a per-tár
+ * modellek a `FAM_Entry`-t terjesztik ki, és a vektor-réteg CSAK a közös bázis-mezőket olvassa, az
+ * írást pedig atomikus `$set`-tel végzi (nem a teljes instance-en).
+ */
+exports.FAM_STORE_REGISTRY = [
+    {
+        table: fam_table_type_enum_1.FAM_Table.rules,
+        dataParams: fam_rules_data_model_1.famRules_dataParams,
+        vectorizedFrom: ['content'],
+    },
+    {
+        table: fam_table_type_enum_1.FAM_Table.documents,
+        dataParams: fam_documents_data_model_1.famDocuments_dataParams,
+        vectorizedFrom: ['content'],
+    },
+    {
+        table: fam_table_type_enum_1.FAM_Table.codebase,
+        dataParams: fam_codebase_data_model_1.famCodebase_dataParams,
+        vectorizedFrom: ['content', 'description'],
+    },
+    {
+        table: fam_table_type_enum_1.FAM_Table.knowledge,
+        dataParams: fam_knowledge_data_model_1.famKnowledge_dataParams,
+        vectorizedFrom: ['content', 'subject', 'description'],
+    },
+    {
+        table: fam_table_type_enum_1.FAM_Table.codingPatterns,
+        dataParams: fam_coding_patterns_data_model_1.famCodingPatterns_dataParams,
+        vectorizedFrom: ['content', 'patternName', 'description'],
+    },
+    {
+        table: fam_table_type_enum_1.FAM_Table.memory,
+        dataParams: fam_memory_data_model_1.famMemory_dataParams,
+        vectorizedFrom: ['content'],
+    },
+];
+/**
+ * Store-registry segéd (dependency-mentes statikus util — FDP-konvenció: nincs top-level export-function).
+ */
+class FAM_StoreRegistry_Util {
+    /** Egy tár registry-bejegyzése `FAM_Table` alapján (vagy undefined, ha nem fő/vektorizált tár). */
+    static getEntry(table) {
+        return exports.FAM_STORE_REGISTRY.find((entry) => entry.table === table);
+    }
+}
+exports.FAM_StoreRegistry_Util = FAM_StoreRegistry_Util;

package/build/src/_modules/embedding/_models/interfaces/fam-embedding-cost.interface.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Embedding-költség surfacing típusok (dsgn-006 §7, SP-2.4) — **BFR-AM-007 projekt-lokális workaround**.
+ *
+ * A Dynamo OpenAI embedding-impl `onCostEvent`-et emittál (token-fogyasztás), de NEM számol USD-t
+ * (nincs Dynamo-pricing-registry). A FAM hívás-típusonként aggregál + token-becslésből USD-t becsül,
+ * amíg a bedrock cost-aggregátor (BFR-AM-007) landol. A kulcs-szerződés (`callType` + token + USD)
+ * stabil, hogy a bedrock-csere non-breaking legyen.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/_modules/embedding/_models/interfaces/fam-embedding-provider.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/_modules/embedding/_models/interfaces/fam-resolved-provider.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/_modules/embedding/_services/fam-embedding-bootstrap.control-service.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_EmbeddingBootstrap_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const config_control_service_1 = require("../../../_routes/server/config/config.control-service");
+const fam_vector_search_control_service_1 = require("./fam-vector-search.control-service");
+/**
+ * `FAM_EmbeddingBootstrap_ControlService` (SP-2.2/2.4) — az embedding + vektor-réteg **boot-hook**-ja.
+ * Az `App.postProcess()` (a DB-connect + setup UTÁNI hook) hívja. Két lépés:
+ *
+ * 1. **ENV → config seed** (MP-7 `seedDefaultsFromEnv`): az `EMBEDDING_PROVIDER` / `OPENAI_EMBEDDING_MODEL`
+ *    ENV-ből GLOBAL default-ot seedel (csak hiányzó kulcsra; a titok SOHA nem kerül DB-be — dsgn-007 §6).
+ * 2. **Boot-hidratálás** (dsgn-006 §4.1): a `FAM_VectorSearch_ControlService.hydrateAll` minden fő tárra
+ *    a `completed`-embeddingű, nem-törölt entry-k `contentVector`-jét az in-memory LVS pool-ba tölti
+ *    (BFR-AM-001 workaround). Best-effort: a hidratálás-hiba persistált (no-silent-failure), de NEM
+ *    akasztja meg a szerver-startot (a `read` ettől még bootstrap-skip-et jelez).
+ *
+ * **AUTO-EMBED REGISZTRÁCIÓ (döntés):** NINCS globális embedding-service-regisztráció a Dynamo
+ * `getGlobalServiceCollection`-be — a Dynamo `DyNTS_DataService.saveData` NEM hív provider-agnosztikus
+ * embedding-hook-ot (csak a hardwired-OpenAI `DyNTS_OAI_VectorDataService.saveData` vektorizál). A FAM
+ * az embeddinget EXPLICIT pipeline-on végzi (`FAM_EmbeddingPipeline_ControlService.embedAndPersist`),
+ * amit a write/scan path (MP-4/MP-5) hív mentés után. Ezért a boot CSAK a config-seed + a pool-hidratálás.
+ */
+class FAM_EmbeddingBootstrap_ControlService {
+    static _instance;
+    static getInstance() {
+        if (!FAM_EmbeddingBootstrap_ControlService._instance) {
+            FAM_EmbeddingBootstrap_ControlService._instance = new FAM_EmbeddingBootstrap_ControlService();
+        }
+        return FAM_EmbeddingBootstrap_ControlService._instance;
+    }
+    /**
+     * A teljes embedding/vektor boot (az `App.postProcess` hívja). Best-effort: a hibákat logoljuk +
+     * a global error-handler persistálja, de a szerver-start NEM bukik el (a vektor-keresés bootstrap-skip
+     * jelzéssel működik tovább, amíg az embedding konfigurálódik).
+     */
+    async boot() {
+        try {
+            await config_control_service_1.FAM_Config_ControlService.getInstance().seedDefaultsFromEnv();
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[FAM bootstrap] ENV-config seed sikertelen: ${error?.message}`);
+        }
+        try {
+            await fam_vector_search_control_service_1.FAM_VectorSearch_ControlService.getInstance().hydrateAll();
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[FAM bootstrap] vektor-pool hidratálás sikertelen: ${error?.message}`);
+        }
+    }
+}
+exports.FAM_EmbeddingBootstrap_ControlService = FAM_EmbeddingBootstrap_ControlService;