@futdevpro/fdp-agent-memory 0.1.0

package/build/src/_collections/config-catalog.const.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_CATALOG = exports.SCAN_IGNORE_PATTERNS_DEFAULT = void 0;
+const fam_table_type_enum_1 = require("../_enums/fam-table.type-enum");
+const fam_config_level_type_enum_1 = require("../_enums/fam-config-level.type-enum");
+/**
+ * `CONFIG_CATALOG` — a hangolható config-kulcsok **single source of truth**-ja (dsgn-007 §4).
+ *
+ * Minden kulcshoz: `type` + reasonable `default` + tartomány/enum + a hozzá értelmezett `levels`.
+ * A default-ok grounding-forrása a CCAP RAG-konstansok (dsgn-007 §4, grounding [C]); a fogyasztó-MP-k
+ * (dsgn-004/005/006) a `resolve`-ot hívják (NEM hard-code-olnak), így a default EGY helyen él.
+ *
+ * A katalógus bővíthető, de minden új kulcsnak ugyanazt a leírást kell adnia (`type`/`default`/
+ * tartomány/`levels`). Ismeretlen kulcs `set`-je → `FAM-CONFIG-SET-001` (dsgn-007 §7.1).
+ */
+/** A három feloldási-szint összes kulcshoz (a leggyakoribb `levels` érték). */
+const ALL_LEVELS = [fam_config_level_type_enum_1.FAM_ConfigLevel.global, fam_config_level_type_enum_1.FAM_ConfigLevel.table, fam_config_level_type_enum_1.FAM_ConfigLevel.scope];
+/** Csak global + table (a scope-szinten NEM értelmezett kulcsoknak). */
+const GLOBAL_TABLE = [fam_config_level_type_enum_1.FAM_ConfigLevel.global, fam_config_level_type_enum_1.FAM_ConfigLevel.table];
+/** Csak global (a kizárólag rendszer-szintű kulcsoknak — pl. `reference.cacheTtlMs`). */
+const GLOBAL_ONLY = [fam_config_level_type_enum_1.FAM_ConfigLevel.global];
+/**
+ * `scan.ignorePatterns` biztonsági default (dsgn-007 §4.5). A `.env` / `*.pem` / `*.key` /
+ * `secrets/**` kizárás **biztonsági alap** (a scan ezeket alapból NEM dolgozza fel). A scan-input
+ * `exclude`-ja ehhez **hozzáadódik** (nem felülír) — a scan-réteg (MP-4) felelőssége.
+ */
+exports.SCAN_IGNORE_PATTERNS_DEFAULT = [
+    '**/node_modules/**', '**/.git/**', '**/build/**', '**/dist/**', '**/coverage/**',
+    '**/*.min.js', '**/*.map', '**/.env', '**/.env.*', '**/*.pem', '**/*.key',
+    '**/*.secret', '**/secrets/**', '**/*.lock', '**/package-lock.json', '**/pnpm-lock.yaml',
+];
+/**
+ * A teljes katalógus (dsgn-007 §4). A kulcsok dotted-formában; a `FAM_ConfigKey` típus ebből
+ * származik (a `set`/`resolve` típusosan csak katalógus-kulcsot fogad, nem `string`).
+ */
+exports.CONFIG_CATALOG = {
+    // --- 4.1. Read / retrieval limitek (fogyasztó: dsgn-005) ---
+    'read.topK': {
+        type: 'number', default: 5, min: 1, max: 200, integer: true, levels: ALL_LEVELS,
+        description: 'Alap visszaadott találat-szám (CCAP DEFAULT_TOP_K=5).',
+    },
+    'read.maxResults': {
+        type: 'number', default: 50, min: 1, max: 500, integer: true, levels: ALL_LEVELS,
+        description: 'A topK effektív felső korlátja (CCAP DEFAULT_PAGE_SIZE=50, cap 500).',
+    },
+    'read.maxTokens': {
+        type: 'number', default: 6000, min: 256, max: 32000, integer: true, levels: ALL_LEVELS,
+        description: 'Az agent context védelme (max token a read-válaszban).',
+    },
+    'read.minScore': {
+        type: 'number', default: 0.0, min: 0.0, max: 1.0, levels: ALL_LEVELS,
+        description: 'Minimum similarity-score küszöb (CCAP default 0 = nincs vágás).',
+    },
+    'read.denseResultRatio': {
+        type: 'number', default: 2.0, min: 1.0, max: 50.0, levels: ALL_LEVELS,
+        description: 'Dense-jelzés ratio-kapuja: totalRelevant >= ratio*topK → denseResults (dsgn-005 §4.2).',
+    },
+    'read.denseResultAbsMin': {
+        type: 'number', default: 25, min: 1, max: 500, integer: true, levels: ALL_LEVELS,
+        description: 'Dense-jelzés abszolút kapuja: totalRelevant >= absMin → denseResults (OR a ratio-val).',
+    },
+    'read.scoreOrder': {
+        type: 'string', default: 'weighted', enumValues: ['weighted', 'raw', 'recency'], levels: ALL_LEVELS,
+        description: 'Score-rendezés módja (súlyozott / nyers / recency).',
+    },
+    // --- 4.2. Chunking — fájl-típusonként (fogyasztó: dsgn-004) ---
+    'chunk.ts.maxSize': {
+        type: 'number', default: 1500, min: 200, max: 8000, integer: true, levels: ALL_LEVELS,
+        description: 'TypeScript chunker max chunk-méret (CCAP 1500).',
+    },
+    'chunk.ts.overlap': {
+        type: 'number', default: 100, min: 0, max: 1000, integer: true, levels: ALL_LEVELS,
+        description: 'TypeScript chunker overlap (CCAP 100).',
+    },
+    'chunk.ts.minSize': {
+        type: 'number', default: 50, min: 0, max: 2000, integer: true, levels: ALL_LEVELS,
+        description: 'TypeScript chunker minimum chunk-méret (CCAP 50).',
+    },
+    'chunk.md.maxSize': {
+        type: 'number', default: 1200, min: 200, max: 8000, integer: true, levels: ALL_LEVELS,
+        description: 'Markdown chunker max chunk-méret (CCAP 1200).',
+    },
+    'chunk.md.overlap': {
+        type: 'number', default: 150, min: 0, max: 1000, integer: true, levels: ALL_LEVELS,
+        description: 'Markdown chunker overlap (CCAP 150).',
+    },
+    'chunk.md.minSize': {
+        type: 'number', default: 80, min: 0, max: 2000, integer: true, levels: ALL_LEVELS,
+        description: 'Markdown chunker minimum chunk-méret (CCAP 80).',
+    },
+    'chunk.generic.maxSize': {
+        type: 'number', default: 1200, min: 200, max: 8000, integer: true, levels: ALL_LEVELS,
+        description: 'Sliding-window chunker max chunk-méret (CCAP 1200).',
+    },
+    'chunk.generic.overlap': {
+        type: 'number', default: 150, min: 0, max: 1000, integer: true, levels: ALL_LEVELS,
+        description: 'Sliding-window chunker overlap (CCAP 150).',
+    },
+    'chunk.generic.minSize': {
+        type: 'number', default: 50, min: 0, max: 2000, integer: true, levels: ALL_LEVELS,
+        description: 'Sliding-window fallback-küszöb (CCAP 50).',
+    },
+    'chunk.fallbackWholeFileUnder': {
+        type: 'number', default: 50, min: 0, max: 2000, integer: true, levels: ALL_LEVELS,
+        description: 'E méret alatt a fájl 1 chunk fallback jelzéssel (CCAP).',
+    },
+    // --- 4.3. Embedding — provider + modell (fogyasztó: dsgn-006) ---
+    'embedding.provider': {
+        type: 'string', default: 'lmstudio', enumValues: ['openai', 'lmstudio', 'mock'], levels: ALL_LEVELS,
+        description: 'Embedding-provider választás (a secret/baseUrl ENV-ből, dsgn-007 §6). DEFAULT: lmstudio '
+            + '(lokális, ingyenes, offline — a local-first filozófiához; az openai opcionális, kulccsal). A '
+            + '`mock` egy determinisztikus, külső-függőség-mentes test/offline double (BFR-AM-008) — e2e/CI-hez '
+            + '(NEM szemantikus keresésre).',
+    },
+    'embedding.model': {
+        type: 'string', default: 'nomic-embed-text-v1.5', levels: ALL_LEVELS,
+        description: 'Embedding-modell azonosító. DEFAULT: nomic-embed-text-v1.5 (LM Studio default; SSOT dsgn-006). '
+            + 'OpenAI-providerrel pl. text-embedding-3-large.',
+    },
+    'embedding.dimensions': {
+        type: 'number-or-null', default: null, min: 64, max: 4096, integer: true, levels: ALL_LEVELS,
+        description: 'Embedding-dimenzió; null = a modell natív dimenziója.',
+    },
+    'embedding.batchSize': {
+        type: 'number', default: 64, min: 1, max: 512, integer: true, levels: ALL_LEVELS,
+        description: 'Embed-batch méret (token-/rate-limit védelem).',
+    },
+    // --- 4.4. Embedding cost — cap + warn (fogyasztó: dsgn-006 / dsgn-008) ---
+    'embedding.costCapUsd': {
+        type: 'number-or-null', default: null, min: 0, levels: ALL_LEVELS,
+        description: 'Embedding cost-plafon USD-ben; null = nincs plafon; túllépésnél a hívás blokkolva.',
+    },
+    'embedding.costCapWarnRatio': {
+        type: 'number', default: 0.8, min: 0.0, max: 1.0, levels: ALL_LEVELS,
+        description: 'A costCapUsd hányadánál vált sárga warn-t (dsgn-006 §7).',
+    },
+    'embedding.costWarnUsd': {
+        type: 'number-or-null', default: null, min: 0, levels: ALL_LEVELS,
+        description: 'Opcionális abszolút warn-küszöb (<= costCapUsd ha mindkettő adott).',
+    },
+    'embedding.costWindow': {
+        type: 'string', default: 'run', enumValues: ['run', 'day', 'total'], levels: ALL_LEVELS,
+        description: 'Melyik aggregátumra vonatkozik a cap/warn (futtatás/nap/összes).',
+    },
+    // --- 4.5. Scan — ignore patterns + biztonság (fogyasztó: dsgn-004) ---
+    'scan.ignorePatterns': {
+        type: 'string[]', default: exports.SCAN_IGNORE_PATTERNS_DEFAULT, levels: ALL_LEVELS,
+        description: 'Secret-/zaj-kizárás glob-minták; a scan-input exclude-ja HOZZÁADÓDIK (nem felülír).',
+    },
+    'scan.maxFileSizeBytes': {
+        type: 'number', default: 1048576, min: 1024, max: 52428800, integer: true, levels: ALL_LEVELS,
+        description: 'E méret felett a fájl kihagyva (1 MB default).',
+    },
+    'scan.followSymlinks': {
+        type: 'boolean', default: false, levels: ALL_LEVELS,
+        description: 'Symlink-követés (path-traversal védelem, dsgn-004).',
+    },
+    // --- 4.6. Reference / scope (fogyasztó: dsgn-002) ---
+    'reference.cacheTtlMs': {
+        type: 'number', default: 60000, min: 0, max: 3600000, integer: true, levels: GLOBAL_ONLY,
+        description: 'Reference-cache TTL ms-ben (CCAP REFERENCE_CACHE_TTL_MS=60000).',
+    },
+    'reference.fuzzyMinScore': {
+        type: 'number', default: 0.75, min: 0.0, max: 1.0, levels: GLOBAL_ONLY,
+        description: 'Fuzzy alias-match konfidencia-küszöb (dsgn-002 §3.1).',
+    },
+    'reference.autoCreateScope': {
+        type: 'boolean', default: true, levels: GLOBAL_TABLE,
+        description: 'Write-on hiányzó (biztos) scope auto-regisztráció (dsgn-002 §3.2).',
+    },
+    // --- 4.7. Ingest flow-limit (fogyasztó: dsgn-004) ---
+    'ingest.flowLimit': {
+        type: 'number', default: 20, min: 1, max: 200, integer: true, levels: GLOBAL_TABLE,
+        description: 'Párhuzamos ingest flow-limit (CCAP DEFAULT_INGEST_FLOW_LIMIT=20, cap 200).',
+    },
+    'patterns.defaultWeight': {
+        type: 'number', default: 5, min: 0, levels: [fam_config_level_type_enum_1.FAM_ConfigLevel.table], tableOnly: fam_table_type_enum_1.FAM_Table.codingPatterns,
+        description: 'A coding_patterns tár default retrieval-súlya (CCAP weight 5; csak coding_patterns).',
+    },
+};

package/build/src/_collections/config-error-codes.const.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_CONFIG_ERROR_CODES = void 0;
+/**
+ * Config-réteg hibakódok (dsgn-007 §7.1 + dsgn-008 §3 `FAM-CFG-*`). NEM coinolunk új kódot:
+ * a `set`-validáció kódjai a dsgn-007 §7 SSOT-ból (`FAM-CONFIG-SET-001..006`), a resolve/preset
+ * kódok a dsgn-008 §3 katalógusból (`FAM-CFG-RESOLVE-001`, `FAM-CFG-PRESET-001`).
+ *
+ * A `<SVC>` réteg-kód a config-rétegen `FAM-CFG` (dsgn-008 §3 táblázat); a `set`-validáció a
+ * dsgn-007 §7-ben rögzített `FAM-CONFIG-SET` névteret használja (a két névtér a két doc szerint
+ * párhuzamosan él; mindkettő SSOT a saját rétegére).
+ */
+exports.FAM_CONFIG_ERROR_CODES = {
+    /** Ismeretlen kulcs a `set`-en (a katalógusban nincs; hasonló-kulcs javaslat — dsgn-007 §7.1). */
+    setUnknownKey: 'FAM-CONFIG-SET-001',
+    /** Típus-eltérés (várt típus vs. kapott — dsgn-007 §7.1). */
+    setTypeMismatch: 'FAM-CONFIG-SET-002',
+    /** Tartomány-/enum-sértés (a megengedett tartomány/enum felsorolva — dsgn-007 §7.1). */
+    setRangeViolation: 'FAM-CONFIG-SET-003',
+    /** Cross-field invariáns-sértés (topK<=maxResults, overlap<maxSize, costWarn<=costCap — dsgn-007 §7.1). */
+    setCrossFieldViolation: 'FAM-CONFIG-SET-004',
+    /** Szint-sértés (a kulcs nem értelmezett a kért level-en / tableOnly — dsgn-007 §7.1). */
+    setLevelViolation: 'FAM-CONFIG-SET-005',
+    /** Scope-azonosítás: a level='scope' scopeId nem létező/aktív FAM_Scope (dsgn-007 §7.1, dsgn-002). */
+    setScopeNotFound: 'FAM-CONFIG-SET-006',
+    /** Precedencia-feloldás hiba (global<table<scope — dsgn-008 §3). */
+    resolve: 'FAM-CFG-RESOLVE-001',
+    /** Ismeretlen / hiányos embedding-preset (dsgn-008 §3). */
+    preset: 'FAM-CFG-PRESET-001',
+};

package/build/src/_collections/config-presets.const.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_PRESETS = void 0;
+/**
+ * A két beépített preset (dsgn-007 §5). `openai-recommended` a magasabb minőségű OpenAI modellel;
+ * `lmstudio-recommended` a lokális, olcsó LM Studio modellel (pl. nagy `codebase` tárhoz).
+ */
+exports.CONFIG_PRESETS = {
+    'openai-recommended': {
+        'embedding.provider': 'openai',
+        'embedding.model': 'text-embedding-3-large',
+        'embedding.dimensions': null, // natív 3072 (dsgn-006)
+        'embedding.batchSize': 64,
+        'read.minScore': 0.0,
+        'read.topK': 5,
+    },
+    'lmstudio-recommended': {
+        'embedding.provider': 'lmstudio',
+        'embedding.model': 'nomic-embed-text-v1.5', // OpenAI-kompatibilis lokális endpoint (dsgn-006)
+        'embedding.dimensions': 768,
+        'embedding.batchSize': 32,
+        'read.minScore': 0.0,
+        'read.topK': 5,
+    },
+};

package/build/src/_collections/error-banners.const.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_BANNER_DESCRIPTORS = exports.FAM_BannerCase = exports.FAM_Banner_Util = exports.FAM_BannerColor = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const error_codes_const_1 = require("./error-codes.const");
+/**
+ * Felhasználói banner-szerződés (dsgn-008 §5, SP-8.3). Itt az **adat/szerződés** él: a level→szín
+ * leképezés + a három nevesített banner-eset trigger + üzenet-payload deskriptora. A **render** az
+ * adott felület-MP-ben (banner + `/errors` UI → MP-10, capability → MP-6, `errors` CLI → MP-9) — ez
+ * a const a render-bemenet (a trigger→payload) SSOT-ja, hogy a felület csak megjeleníti.
+ */
+/**
+ * Banner-szín (dsgn-008 §5): `user`/`warning` → sárga (nem-blokkoló), `error`/`critical`/`fatal` →
+ * piros. Enum-konvenció: key camelCase, value kebab-case.
+ */
+var FAM_BannerColor;
+(function (FAM_BannerColor) {
+    FAM_BannerColor["yellow"] = "yellow";
+    FAM_BannerColor["red"] = "red";
+})(FAM_BannerColor || (exports.FAM_BannerColor = FAM_BannerColor = {}));
+/**
+ * Banner-domén segéd (dependency-mentes statikus util — FDP-konvenció: nincs top-level export-function).
+ */
+class FAM_Banner_Util {
+    /**
+     * A `DyFM_ErrorLevel` → banner-szín leképezés (dsgn-008 §5). A `user`/`warning`/`info`/`debug`/
+     * `known` nem-blokkoló → **sárga**; az `error`/`serious`/`critical`/`fatal`/`systemUnreachable`/
+     * `buildFailure` → **piros**.
+     */
+    static colorForLevel(level) {
+        switch (level) {
+            case fsm_dynamo_1.DyFM_ErrorLevel.user:
+            case fsm_dynamo_1.DyFM_ErrorLevel.warning:
+            case fsm_dynamo_1.DyFM_ErrorLevel.info:
+            case fsm_dynamo_1.DyFM_ErrorLevel.debug:
+            case fsm_dynamo_1.DyFM_ErrorLevel.known:
+                return FAM_BannerColor.yellow;
+            default:
+                return FAM_BannerColor.red;
+        }
+    }
+}
+exports.FAM_Banner_Util = FAM_Banner_Util;
+/**
+ * A három nevesített banner-eset azonosítója (dsgn-008 §5; konzultáció §12.2). A trigger a
+ * megfelelő `errorCode` kibocsátása; a render-MP a `descriptorId`-re kapcsol.
+ */
+var FAM_BannerCase;
+(function (FAM_BannerCase) {
+    /** Sync lefutott — 0 fájl matchelt (sárga, info, NEM hiba). */
+    FAM_BannerCase["syncZeroMatch"] = "sync-zero-match";
+    /** Embedding nincs konfigurálva (piros bootstrap-skip + settings-link). */
+    FAM_BannerCase["embeddingNotConfigured"] = "embedding-not-configured";
+    /** Költség-plafon közelít (sárga a blokk előtt; cap elérve → piros + blokk). */
+    FAM_BannerCase["costCapApproaching"] = "cost-cap-approaching";
+})(FAM_BannerCase || (exports.FAM_BannerCase = FAM_BannerCase = {}));
+/**
+ * A három **kötelező nevesített banner-deszkriptor** (dsgn-008 §5). Ez a render-szerződés SSOT-ja:
+ * a felület-MP (MP-9/10) a `bannerCase`-re kapcsol és a `title`/`messageTemplate`/`color`/
+ * `settingsLink` mezőket jeleníti meg; a trigger-MP (MP-2/4) a `errorCode`-ot bocsátja ki.
+ *
+ * **A cost-cap KÉT állapotú** (dsgn-008 §5): a `costCapApproaching` a blokk ELŐTTI sárga
+ * figyelmeztetés (NEM blokkoló); a cap-elérés blokkoló piros ágát a render a trigger-kontextus
+ * `blocking`/`level` felülírásából képezi (ugyanaz a `FAM-EMB-COSTCAP-001` kód, `level:user`).
+ */
+exports.FAM_BANNER_DESCRIPTORS = {
+    [FAM_BannerCase.syncZeroMatch]: {
+        bannerCase: FAM_BannerCase.syncZeroMatch,
+        errorCode: error_codes_const_1.FAM_ERROR_CODES.scanEmpty,
+        level: fsm_dynamo_1.DyFM_ErrorLevel.info,
+        color: FAM_BannerColor.yellow,
+        blocking: false,
+        title: 'Sync lefutott — 0 fájl matchelt',
+        messageTemplate: 'A scan/sync lefutott, de a konfigurált mintára 0 fájl illeszkedett. ' +
+            'A forrás-mappák üresek a mintákra (vagy a minta túl szűk). Ez NEM hiba.',
+        settingsLink: false,
+    },
+    [FAM_BannerCase.embeddingNotConfigured]: {
+        bannerCase: FAM_BannerCase.embeddingNotConfigured,
+        errorCode: error_codes_const_1.FAM_ERROR_CODES.embProviderNotConfigured,
+        level: fsm_dynamo_1.DyFM_ErrorLevel.user,
+        color: FAM_BannerColor.red,
+        blocking: true,
+        title: 'Embedding nincs konfigurálva',
+        messageTemplate: 'Nincs embedding-provider beállítva, ezért a mentés/scan kihagyva (bootstrap-skip). ' +
+            'Állíts be egy providert (OpenAI / LM Studio) a beállításokban a folytatáshoz.',
+        settingsLink: true,
+    },
+    [FAM_BannerCase.costCapApproaching]: {
+        bannerCase: FAM_BannerCase.costCapApproaching,
+        errorCode: error_codes_const_1.FAM_ERROR_CODES.embCostCap,
+        level: fsm_dynamo_1.DyFM_ErrorLevel.warning,
+        color: FAM_BannerColor.yellow,
+        blocking: false,
+        title: 'Költség-plafon közelít',
+        messageTemplate: 'Az embedding-költség a konfigurált plafonhoz közelít ({current} / {cap}). ' +
+            'A plafon elérésekor a következő embedding-hívás blokkolva lesz.',
+        settingsLink: true,
+    },
+};

package/build/src/_collections/error-codes.const.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_CFG_ERROR_CODES = exports.FAM_ERROR_CODES = exports.FAM_ERROR_SVC_DEFAULT_LEVEL = exports.FAM_ErrorSvc = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const config_error_codes_const_1 = require("./config-error-codes.const");
+/**
+ * Hibakód-katalógus **egyetlen SSOT-ja** (dsgn-008 §3, SP-8.1). A FAM hibakód-konvenció:
+ * `FAM-<SVC>-<METHOD>-NNN`, ahol `<SVC>` a réteg/service rövid kódja (9 prefix), `<METHOD>` a
+ * kibocsátó metódus, `NNN` réteg-stabil sorszám.
+ *
+ * **HARD szabály (dsgn-008 §3, MP-8-detailed kockázat "katalógus-szétfolyás"):** új hibakód CSAK
+ * ide kerül. A réteg-MP-k (MP-2 embedding, MP-3 scope/reference, MP-4 scan, MP-6 MCP/validation)
+ * NEM találnak ki saját prefixet — innen importálnak, különben a `list_errors` / `/errors` UI
+ * réteg-szerinti csoportosítása törik.
+ *
+ * **MP-7 alignment (nincs duplikáció):** a config-réteg `set`-validációs kódjai
+ * (`FAM-CONFIG-SET-001..006`) és a resolve/preset kódjai (`FAM-CFG-RESOLVE-001`,
+ * `FAM-CFG-PRESET-001`) MÁR a `config-error-codes.const.ts`-ben élnek (dsgn-007 §7 SSOT). Ez a
+ * katalógus NEM definiálja újra őket — a `FAM_CFG_ERROR_CODES` re-exporton át hivatkozik rájuk, így
+ * a teljes `FAM-<SVC>-<METHOD>-NNN` séma EGY home-mal rendelkezik, ütközés/duplikáció nélkül.
+ */
+/**
+ * A 9 réteg/service prefix (dsgn-008 §3 táblázat). A `<SVC>` szegmens a `FAM-<SVC>-<METHOD>-NNN`
+ * kódban; a `list_errors`/UI réteg szerint csoportosít ezen.
+ *
+ * Enum-konvenció (workspace base CLAUDE.md): key camelCase, value a kód-szegmens.
+ */
+var FAM_ErrorSvc;
+(function (FAM_ErrorSvc) {
+    /** MCP-tool határ (transport, schema-dispatch, capabilities-invoke). */
+    FAM_ErrorSvc["mcp"] = "MCP";
+    /** Input-validáció (`read`/`write` schema, kötelező mezők). */
+    FAM_ErrorSvc["validation"] = "VAL";
+    /** MongoDB adatréteg (connect, query, write). */
+    FAM_ErrorSvc["db"] = "DB";
+    /** VectorDB / Memory Vector Search (hidratálás, keresés, persist). */
+    FAM_ErrorSvc["vector"] = "VEC";
+    /** Embedding-provider (OpenAI / LM Studio, cost-cap). */
+    FAM_ErrorSvc["embedding"] = "EMB";
+    /** Scan + chunking (fájlolvasás, parser, delta). */
+    FAM_ErrorSvc["scan"] = "SCAN";
+    /** Scope + reference resolve (feloldatlan/bizonytalan). */
+    FAM_ErrorSvc["reference"] = "REF";
+    /** Config-réteg (DB-backed scoped config, preset). */
+    FAM_ErrorSvc["config"] = "CFG";
+    /** claude-mem import / migráció. */
+    FAM_ErrorSvc["import"] = "IMP";
+})(FAM_ErrorSvc || (exports.FAM_ErrorSvc = FAM_ErrorSvc = {}));
+/**
+ * Réteg-default hiba-szint (dsgn-008 §3 "Default `level`" oszlop). A `DyFM_ErrorLevel` enum a
+ * tényleges Dynamo-érték (`debug`/`info`/`known`/`warning`/`error`/`serious`/`critical`/`fatal`/
+ * `user`/...). A dsgn-008 §2 `warn` rövidítés a Dynamo `DyFM_ErrorLevel.warning`-jára képződik.
+ *
+ * A `<SCAN>` réteg default-ja `error`, de a 0-match (`EMPTY`) `info`, a parse-fallback `warning`
+ * (eset-szintű override, NEM réteg-default). A `<REF>` default `user`-felé hajlik (a feloldatlan
+ * scope user-hiba), de az index-rebuild `error`.
+ */
+exports.FAM_ERROR_SVC_DEFAULT_LEVEL = {
+    [FAM_ErrorSvc.mcp]: fsm_dynamo_1.DyFM_ErrorLevel.error,
+    [FAM_ErrorSvc.validation]: fsm_dynamo_1.DyFM_ErrorLevel.user,
+    [FAM_ErrorSvc.db]: fsm_dynamo_1.DyFM_ErrorLevel.critical,
+    [FAM_ErrorSvc.vector]: fsm_dynamo_1.DyFM_ErrorLevel.error,
+    [FAM_ErrorSvc.embedding]: fsm_dynamo_1.DyFM_ErrorLevel.error,
+    [FAM_ErrorSvc.scan]: fsm_dynamo_1.DyFM_ErrorLevel.error,
+    [FAM_ErrorSvc.reference]: fsm_dynamo_1.DyFM_ErrorLevel.user,
+    [FAM_ErrorSvc.config]: fsm_dynamo_1.DyFM_ErrorLevel.error,
+    [FAM_ErrorSvc.import]: fsm_dynamo_1.DyFM_ErrorLevel.error,
+};
+/**
+ * A reprezentatív hibakódok (dsgn-008 §3). A sorszám-tartomány réteg-stabil; a teljes lista a
+ * service-ek bevezetésekor (réteg-MP) bővül — DE mindig ITT (SSOT), nem a réteg-MP-ben.
+ *
+ * Egy lapos `const` objektum (camelCase kulcs → kód string), réteg-szekciókba rendezve. A
+ * réteg-MP-k a `FAM_ERROR_CODES.<kulcs>`-ra hivatkoznak.
+ */
+exports.FAM_ERROR_CODES = {
+    // --- MCP (FAM-MCP-*) ---
+    /** unknown tool name a hirdetett 3-on kívül (dsgn-008 §3). */
+    mcpDispatchUnknownTool: 'FAM-MCP-DISPATCH-001',
+    /** capabilities.invoke ismeretlen capability-névre. */
+    mcpDispatchUnknownCapability: 'FAM-MCP-DISPATCH-002',
+    /** tool-input nem felel meg a JSON-schema-nak (transport-szint). */
+    mcpSchemaMismatch: 'FAM-MCP-SCHEMA-001',
+    // --- Validation (FAM-VAL-*) ---
+    /** write: hiányzó kötelező mező (table | content | scopePath). */
+    valWriteMissingField: 'FAM-VAL-WRITE-001',
+    /** write: 'reference' tár tartalom-műveletre (helper, csak CRUD). */
+    valWriteReferenceContent: 'FAM-VAL-WRITE-002',
+    /** update/delete target hiányzik vagy nem azonosít egyértelműen. */
+    valWriteTargetAmbiguous: 'FAM-VAL-WRITE-003',
+    /** read: üres queries / 'reference' a tables-ben (dsgn-003 §2.1). */
+    valReadEmptyOrReference: 'FAM-VAL-READ-001',
+    // --- Reference / Scope (FAM-REF-* / FAM-SCOPE-*; dsgn-002 §4) ---
+    /** nincs-match + bizonytalan → részletes hiba (level=user). */
+    refResolveNoMatch: 'FAM-REF-RESOLVE-001',
+    /** több magas-konfidenciájú kandidátus, scope nem egyértelmű. */
+    refResolveAmbiguous: 'FAM-REF-RESOLVE-002',
+    /** reference-index rebuild sikertelen (cache stale). */
+    refIndexRebuild: 'FAM-REF-INDEX-001',
+    /** write scope kötelezőség megsértve (scope nélküli create/scan/import). */
+    scopeWriteRequired: 'FAM-SCOPE-WRITE-001',
+    // --- Embedding (FAM-EMB-*) ---
+    /** provider nincs konfigurálva (bootstrap-skip, level=user, dsgn-008 §5). */
+    embProviderNotConfigured: 'FAM-EMB-PROVIDER-001',
+    /** provider elérhetetlen (OpenAI 5xx / LM Studio baseUrl down). */
+    embProviderUnreachable: 'FAM-EMB-PROVIDER-002',
+    /** model-válasz dimenzió-eltérés a tárhoz konfigurálttól. */
+    embProviderDimensionMismatch: 'FAM-EMB-PROVIDER-003',
+    /** embedding cost-cap elérve → következő hívás blokkolva (dsgn-007). */
+    embCostCap: 'FAM-EMB-COSTCAP-001',
+    // --- Vector (FAM-VEC-*) ---
+    /** Mongo→in-memory pool hidratálás sikertelen boot-on (BFR-AM-001). */
+    vecHydrate: 'FAM-VEC-HYDRATE-001',
+    /** vectorSearch hiba (dimenzió / üres pool / searchMode). */
+    vecSearch: 'FAM-VEC-SEARCH-001',
+    /** contentVector Mongo-persist sikertelen (BFR-AM-005). */
+    vecPersist: 'FAM-VEC-PERSIST-001',
+    // --- Scan / Chunking (FAM-SCAN-*) ---
+    /** fájl olvashatatlan / engedély / path-traversal védelem. */
+    scanRead: 'FAM-SCAN-READ-001',
+    /** parser hiba (markdown / AST) → fallback whole-content chunk (warn). */
+    scanParse: 'FAM-SCAN-PARSE-001',
+    /** delta-detection / compareData hiba (BFR-AM-006 compareData). */
+    scanDelta: 'FAM-SCAN-DELTA-001',
+    /** 0 fájl matchelt a konfigurált mintára (level=info, NEM error, dsgn-008 §5). */
+    scanEmpty: 'FAM-SCAN-EMPTY-001',
+    // --- DB (FAM-DB-*) ---
+    /** MongoDB connect sikertelen (critical). */
+    dbConnect: 'FAM-DB-CONNECT-001',
+    /** saveData / updateOne sikertelen. */
+    dbWrite: 'FAM-DB-WRITE-001',
+    // --- Config (FAM-CFG-*) — a `set`-validáció kódjai a config-error-codes.const SSOT-ból (alább). ---
+    /** config precedencia-feloldás hiba (global<table<scope). */
+    cfgResolve: config_error_codes_const_1.FAM_CONFIG_ERROR_CODES.resolve,
+    /** ismeretlen / hiányos embedding-preset. */
+    cfgPreset: config_error_codes_const_1.FAM_CONFIG_ERROR_CODES.preset,
+    // --- Import (FAM-IMP-*) ---
+    /** claude-mem forrás elérhetetlen (sqlite path / worker API). */
+    impSource: 'FAM-IMP-SOURCE-001',
+    /** target-mapping nem egyértelmű (dsgn-009). */
+    impMap: 'FAM-IMP-MAP-001',
+};
+/**
+ * MP-7 alignment re-export (nincs duplikáció): a config `set`-validációs + resolve/preset kódok
+ * (`FAM-CONFIG-SET-001..006`, `FAM-CFG-RESOLVE-001`, `FAM-CFG-PRESET-001`) a dsgn-007 §7 SSOT-ból
+ * (`config-error-codes.const.ts`). A katalógus innen hivatkozik rájuk — egy import-pont a teljes
+ * sémához, a két névtér ütközés nélkül együtt él (a `FAM-CONFIG-SET` a `<SVC>=CONFIG` névtér, a
+ * `FAM-CFG` a `<SVC>=CFG` réteg-kód; mindkettő stabil).
+ */
+exports.FAM_CFG_ERROR_CODES = config_error_codes_const_1.FAM_CONFIG_ERROR_CODES;

package/build/src/_collections/fam-db-models.const.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_DB_MODELS = void 0;
+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_config_data_model_1 = require("../_models/data-models/fam-config.data-model");
+const fam_documents_data_model_1 = require("../_models/data-models/fam-documents.data-model");
+const fam_error_data_model_1 = require("../_models/data-models/fam-error.data-model");
+const fam_ingest_run_data_model_1 = require("../_models/data-models/fam-ingest-run.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_reference_data_model_1 = require("../_models/data-models/fam-reference.data-model");
+const fam_rules_data_model_1 = require("../_models/data-models/fam-rules.data-model");
+const fam_scope_data_model_1 = require("../_models/data-models/fam-scope.data-model");
+/**
+ * A FAM perzisztens collection-jeinek `dataParams`-listája (MP-1, dsgn-001) — **SSOT**.
+ * A `DyNTS_GlobalService.setServices({ dbModels })` ezt regisztrálja a boot-kor (`app.server.ts`),
+ * és UGYANEZT használja az integration-test setup (`_integration-tests/_helpers`) a lightweight
+ * DB-setuphoz — így a két regisztráció SOSEM driftel (egy-forrás).
+ */
+exports.FAM_DB_MODELS = [
+    // Error-réteg (MP-8, dsgn-008 §2): `fam_errors` (DyNTS_Errors-pipeline, dedup + occurrence-count).
+    fam_error_data_model_1.famError_dataParams, // fam_errors
+    // A 6 fő RAG-tár (`addArchive: true` → soft-delete, dsgn-001 §8):
+    fam_rules_data_model_1.famRules_dataParams, // fam_rules
+    fam_documents_data_model_1.famDocuments_dataParams, // fam_documents
+    fam_codebase_data_model_1.famCodebase_dataParams, // fam_codebase
+    fam_knowledge_data_model_1.famKnowledge_dataParams, // fam_knowledge
+    fam_coding_patterns_data_model_1.famCodingPatterns_dataParams, // fam_coding_patterns
+    fam_memory_data_model_1.famMemory_dataParams, // fam_memory
+    // Helper-collection-ök (dsgn-001 §5, dsgn-002 §2, dsgn-004 §5):
+    fam_reference_data_model_1.famReference_dataParams, // fam_reference
+    fam_scope_data_model_1.famScope_dataParams, // fam_scopes
+    fam_ingest_run_data_model_1.famIngestRun_dataParams, // fam_ingest_runs
+    // Config-réteg (MP-7, dsgn-007): DB-backed scoped config (global<table<scope).
+    fam_config_data_model_1.famConfig_dataParams, // fam_config
+];

package/build/src/_collections/fam-entry-bootstrap.util.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_EntryBootstrap_Util = void 0;
+const app_server_1 = require("../app.server");
+const package_json_1 = require("../../package.json");
+const mcp_1 = require("../_modules/mcp");
+/** Az MCP-szerver SDK-neve (REQ-001, dsgn-003 §5). */
+const MCP_SERVER_NAME = 'fdp-agent-memory';
+/**
+ * `FAM_EntryBootstrap_Util` (MP-6, dsgn-010 §6 / dsgn-012 §4) — a `node build/src/index.js [start]`
+ * (és a publikált `fam start` bin) belépési orchestrátora. A `fam start` MINDKÉT csatornát felhúzza:
+ *   - **REST szerver** (port 39185, `App extends DyNTS_App`) — a CLI (MP-9) + UI (MP-10) belépője,
+ *   - **MCP stdio szerver** — a `read`/`write`/`capabilities` 3 tool a JSON-RPC stdio transporton.
+ *
+ * A kettő KÜLÖN csatorna (stdio JSON-RPC vs. HTTP), így egyszerre futhat: a REST a HTTP-porton, az MCP
+ * a stdin/stdout-on. Mindkettő ugyanazt a Mongo-kapcsolatot + a hidratált vektor-pool-t használja (az
+ * `App` connect + `postProcess` boot).
+ *
+ * **stdio-konvenció (dsgn-003 §1, dsgn-010 §6):** stdio módban a stdout a JSON-RPC csatorna — minden
+ * log/diag a stderr-re kerül. Ezért a boot ELŐTT a `console.log`/`info`/`warn` stdout-írásait a
+ * stderr-re irányítjuk (a `DyFM_Log` ezeken megy); az MCP `StdioServerTransport` közvetlenül a
+ * `process.stdout`-ra ír (nem console-on át), így a JSON-RPC framing tiszta marad.
+ */
+class FAM_EntryBootstrap_Util {
+    /**
+     * A belépő (`index.ts` ezt hívja). A `start` (vagy `start-server`) argumentum → REST + MCP stdio
+     * együtt; argumentum nélkül VISSZAFELÉ-KOMPATIBILIS: csak a REST `App` indul (a régi `new App()`
+     * viselkedés). A `--transport stdio` MVP1-ben az egyetlen MCP-transport (dsgn-010 §6).
+     */
+    static async main(argv) {
+        const command = argv[2];
+        const isStart = command === 'start' || command === 'start-server';
+        if (isStart) {
+            // stdio-konvenció: a log-stdout-ot a stderr-re irányítjuk a JSON-RPC csatorna tisztaságáért.
+            FAM_EntryBootstrap_Util.redirectConsoleToStderr();
+        }
+        // (1) REST szerver felhúzása (a DyNTS_App ctor indítja a connect + setup + postProcess láncot;
+        // a DyNTS_App a side-effect-konstruktor mintát követi — az `index.ts` is így indít).
+        FAM_EntryBootstrap_Util.startRestApp();
+        if (isStart) {
+            // (2) MCP stdio szerver indítása (a 3 advertised core-tool: read/write/capabilities).
+            await mcp_1.FAM_McpServer_Service.getInstance().start({ name: MCP_SERVER_NAME, version: package_json_1.version });
+        }
+    }
+    /**
+     * A REST `App` felhúzása (a `DyNTS_App` ctor a connect + setup + postProcess láncot indítja —
+     * side-effect-konstruktor minta, az App-ot nem kell elkapni, a globális service-be regisztrálódik).
+     */
+    static startRestApp() {
+        const app = new app_server_1.App();
+        void app;
+    }
+    /**
+     * A `console.log`/`info`/`warn`/`debug` stdout-írásainak átirányítása a stderr-re (stdio mód). A
+     * `console.error` már alapból stderr-re megy. Így a `DyFM_Log` (ami `console.*`-on megy) NEM
+     * szennyezi a JSON-RPC stdout-csatornát; az MCP transport `process.stdout`-ja érintetlen marad.
+     */
+    static redirectConsoleToStderr() {
+        const toStderr = (...args) => {
+            process.stderr.write(`${args.map((arg) => FAM_EntryBootstrap_Util.stringifyArg(arg)).join(' ')}\n`);
+        };
+        console.log = toStderr;
+        console.info = toStderr;
+        console.warn = toStderr;
+        console.debug = toStderr;
+    }
+    /** Egy log-argumentum string-reprezentációja (objektum → JSON, primitív → String). */
+    static stringifyArg(arg) {
+        if (typeof arg === 'string') {
+            return arg;
+        }
+        try {
+            return JSON.stringify(arg);
+        }
+        catch {
+            return String(arg);
+        }
+    }
+}
+exports.FAM_EntryBootstrap_Util = FAM_EntryBootstrap_Util;