@futdevpro/fdp-agent-memory 1.1.21 → 1.1.112

package/build/src/_cli/register-commands.js

@@ -66,9 +66,37 @@ function registerFAMCommands(program, version) {
     ];
     for (const command of famCommands) {
         applyExitMapping(command);
+        if (SERVER_DEPENDENT_COMMANDS.has(command.name())) {
+            attachEnsureServerHook(command);
+        }
         program.addCommand(command);
     }
 }
+/**
+ * A szerver-függő (REST-et hívó) data-parancsok — ezekre rákötjük az auto-ensure pre-action hook-ot (user-FR
+ * 2026-06-22: „minden fam funkciónak gondoskodnia kell a fam elindításáról"). A környezet-szintű parancsok
+ * (`init`/`doctor`/`validate-env`/…) É a szerver-életciklust kezelő `start`/`serve` KIMARADNAK (azok nem a
+ * futó primary-t hívják, vagy MAGUK a szerver).
+ */
+const SERVER_DEPENDENT_COMMANDS = new Set([
+    'read', 'write', 'scan', 'scan-projects', 'import', 'export', 'capture',
+    'config', 'stats', 'find-duplicates', 'errors', 'migrate', 'seed-example',
+]);
+/**
+ * Az auto-ensure pre-action hook rákötése egy szerver-függő parancsra (a commander a hook-ot a parancs ÉS
+ * az al-parancsai action-jére is meghívja, így a `config get`/`import claude-mem` is fedett). Best-effort: ha
+ * az ensure elhasal, a parancs a SAJÁT `unreachable` hibáját adja (no-silent-failure, dsgn-008) — nem dob itt.
+ */
+function attachEnsureServerHook(command) {
+    command.hook('preAction', async () => {
+        try {
+            await serve_command_1.FAM_Serve_Util.ensureRunning();
+        }
+        catch {
+            /* best-effort auto-ensure — a tényleges elérhetetlenséget a parancs HTTP-rétege jelzi tiszta hibával */
+        }
+    });
+}
 /**
  * A dsgn-010 §3 exit-kód-mapping rákötése egy FAM parancsra ÉS minden al-parancsára (rekurzívan): a
  * commander használati/argument-hibái `2`-vel lépnek ki (a parancs-handler-ek `0`/`1`/`3` kódjait a

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

@@ -26,6 +26,11 @@ const GLOBAL_ONLY = [fam_config_level_type_enum_1.FAM_ConfigLevel.global];
  */
 exports.SCAN_IGNORE_PATTERNS_DEFAULT = [
     '**/node_modules/**', '**/.git/**', '**/build/**', '**/dist/**', '**/coverage/**',
+    // Workspace-szintű HARD-kizárás (user-direktíva 2026-06-24, KRITIKUS — „SEMMIT nem akarunk szkennelni, ami a
+    // Stale-ben van!!!"). Az archív/elavult projektek (`STALE-projects/`, pl. `fury`) + a sablon-junk
+    // (`TEMPLATE-projects/`, `{{PROJECT_NAME}}`) SOHA nem korpusz-anyag — még explicit cél-útvonalon sem. (A
+    // felderítés külön, garantáltan kihagyja őket: FAM_ProjectDiscovery_Util.SKIP_DIRS.)
+    '**/STALE-projects/**', '**/TEMPLATE-projects/**',
     // Framework build-/futás-cache + generált kimenet (FAM-REV-056) — sosem forrás, gyakran minifikált/bináris-
     // szerű (pl. az Angular `.angular/cache/.../babel-webpack` ezreket számláló, embed-timeout-ot okozó junk-ja).
     '**/.angular/**', '**/.nx/**', '**/.cache/**', '**/.turbo/**', '**/.next/**', '**/.nuxt/**', '**/.svelte-kit/**',
@@ -45,6 +50,11 @@ exports.SCAN_IGNORE_PATTERNS_DEFAULT = [
     // lowercase NEM matchelné a Unity `Logs/`-át).
     '**/Library/**', '**/Temp/**', '**/Obj/**', '**/obj/**', '**/bin/**', '**/Logs/**', '**/Build/**', '**/Builds/**',
     '**/.vs/**', '**/*.csproj', '**/*.sln', '**/*.meta', '**/*.unity', '**/*.prefab', '**/*.asset',
+    // Agent-/böngésző-state (lokális futás-melléktermék, SOHA nem korpusz-anyag): `.local-state` (pl. agent
+    // browser-automation profil) + Chromium-profil/cache — lockolt SQLite + bináris blobok (Login Data /
+    // Cookies / Web Data = SZEMÉLYES adat), olvashatatlanok + junk. (Lelet 2026-06-22: fdp-assistant/__agent/
+    // .local-state = 403 MB / 2452 fájl → 2208 `FAM-SCAN-READ-001`. Az `__agent` MAGA MARAD — csak a state junk.)
+    '**/.local-state/**', '**/browser-profiles/**', '**/Cache_Data/**',
     // A `.fdpfamignore` SAJÁT MAGÁT kizárja: ignore-spec-ként OLVASSUK (FAM_FamIgnore_Util.loadFromDir,
     // a walk/routing megkerülésével), de SOHA nem ingesteljük content-ként (a router amúgy is skip-elné).
     '**/.fdpfamignore',
@@ -69,13 +79,35 @@ exports.CONFIG_CATALOG = {
         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).',
+        type: 'number', default: 4000, min: 256, max: 32000, integer: true, levels: ALL_LEVELS,
+        description: 'Az agent context védelme + a read-válasz INLINE-tartása (max token; ~4 char/token). A read-tool '
+            + 'ÉRVÉNYESÍTI (FAM-REV: korábban dead-config volt → korlátlan hit-tartalom → a host fájlba mentette a választ). '
+            + 'A budget felett a hit-tartalom levágódik + a túlcsorduló hit-ek elhagyva (`truncated:true`).',
+    },
+    'write.dedupWarnEnabled': {
+        type: 'boolean', default: true, levels: ALL_LEVELS,
+        description: 'Near-duplikátum-FIGYELMEZTETÉS íráskor (user-FR 2026-06-25): a `create` UTÁN a friss vektorral '
+            + 'megkeresi a tár legközelebbi szomszédait; ha valamelyik a `write.dedupWarnThreshold` FÖLÖTT van, a write-'
+            + 'válasz `warnings`-ába kerül („majdnem ugyanaz, mint X — érdemes UPDATE-elni"). NEM blokkol (a duplikáció-'
+            + 'keletkezés megelőzése). `false` → nincs ellenőrzés (nulla extra munka, mert a friss vektor úgyis kész).',
+    },
+    'write.dedupWarnThreshold': {
+        type: 'number', default: 0.93, min: 0.5, max: 1.0, levels: ALL_LEVELS,
+        description: 'A near-duplikátum-warning koszinusz-küszöbe (0..1; default 0.93): e FÖLÖTT egy meglévő entry '
+            + '„majdnem azonosnak" számít az új tartalommal → figyelmeztetés. Magasabb = csak a szinte-teljes egyezésre '
+            + 'jelez; alacsonyabb = agresszívebb (több figyelmeztetés). CSAK jelzés, sosem blokkol.',
     },
     '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.hydrationWaitMs': {
+        type: 'number', default: 180000, min: 0, max: 600000, integer: true, levels: ALL_LEVELS,
+        description: 'A readiness-coordinator hidratálás-bevárás felső korlátja ms-ban: a `read`/`search` MEGVÁRJA a '
+            + 'tár pool-jának (kezdő VAGY újra-) hidratálását ahelyett, hogy `FAM-VEC-SEARCH-001 pool ÜRES`-t dobna. '
+            + '0 = nincs várakozás (azonnali hiba, ha még nem kész). Boot-kor a ~290k-vektor hidratálás percekig tarthat → '
+            + 'a default 180s ezt fedi; time-out után tiszta „még hidratál, próbáld újra" hiba (a következő hívás már kész).',
+    },
     'read.relevanceFloor': {
         type: 'number', default: 0.5, min: 0.0, max: 1.0, levels: ALL_LEVELS,
         description: 'Confidence-padló a nyers cosine score-on: a relevancia-JELZÉSEK (totalRelevant / '
@@ -87,11 +119,27 @@ exports.CONFIG_CATALOG = {
     'read.importChunkWeight': {
         type: 'number', default: 0.4, min: 0.0, max: 1.0, levels: ALL_LEVELS,
         description: 'Az import-only chunkok (`chunkType:"imports"`) read-idejű rangsor-szorzója (FAM-REV-060). '
-            + 'A szimbólum-név query-knél az import-sorok (`import { X } from "./y"`) magas cosine-t kapnak, de '
+            + 'A szimbólum-név query-knél az import-sorok (`import { X: X } from "./y"`) magas cosine-t kapnak, de '
             + 'alacsony az ÉRTÉKük (csak import, nem definíció) → e szorzóval a `finalScore = score × weight × '
             + 'importChunkWeight` a definíció-chunkok ALÁ rangsorolja őket. READ-time (nincs re-embed); a nyers '
             + 'cosine score (relevancia-jelzések) NEM változik, csak a ranking. 1 = nincs csökkentés.',
     },
+    'read.importSourceWeight': {
+        type: 'number', default: 0.85, min: 0.0, max: 1.0, levels: ALL_LEVELS,
+        description: 'Az import-FORRÁSÚ (`source.type:"import"`, pl. claude-mem-import) entry-k read-idejű rangsor-'
+            + 'szorzója (R2, 2026-06-22 eval-lelet). A `memory`/`knowledge` táron a 33k import ZAJA elnyomta a kurált '
+            + '(`manual`/`agent`/scan) tanulságokat → e szorzóval (`finalScore × importSourceWeight`) a kurált FÖLÉ '
+            + 'rangsorol. READ-time (nincs re-embed); a nyers cosine NEM változik, csak a ranking. 1 = kikapcsolva.',
+    },
+    'read.keywordWeight': {
+        type: 'number', default: 0.6, min: 0.0, max: 5.0, levels: ALL_LEVELS,
+        description: 'Hibrid LEXIKAI (keyword/term-overlap) boost súlya (Improvement 2, eval-lelet 2026-06-25): a tiszta-'
+            + 'vektor `read` ELVÉTI a literal-keyword választ (a koszinusz alacsony a query-megfogalmazásra; a `grep` '
+            + 'azonnal hozza). A finalScore-t `× (1 + keywordWeight × lexicalScore)` szorzóval BOOST-only emeli, ahol a '
+            + 'lexicalScore (0..1) a query disztinktív term-jeinek átfedése az entry szövegével (content+heading+forrás-út). '
+            + 'A tiszta-szemantikus találat (lexical 0) SOHA nem süllyed (×1). READ-time (nincs re-embed). `0` = pure-vektor '
+            + '(régi viselkedés). Default 0.6.',
+    },
     '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).',
@@ -104,6 +152,77 @@ exports.CONFIG_CATALOG = {
         type: 'string', default: 'weighted', enumValues: ['weighted', 'raw', 'recency'], levels: ALL_LEVELS,
         description: 'Score-rendezés módja (súlyozott / nyers / recency).',
     },
+    // --- 4.1b. Memory Activation Model — decay/reactivation/dormancy (fogyasztó: dsgn-013) ---
+    'memory.activationEnabled': {
+        type: 'boolean', default: true, levels: ALL_LEVELS,
+        description: 'Memory Activation Model (dsgn-013): a felidézés-alapú lazy-decay rangsor-szorzó a `memory` táron. '
+            + 'A frissen/gyakran FELIDÉZETT memória felül-, a régóta érintetlen alul-rangsorol (de sosem tűnik el, '
+            + 'csak kisebb a súlya). `false` → a decay-mentes (mai) viselkedés. CSAK a memory tárra hat.',
+    },
+    'memory.decayHalfLifeDays': {
+        type: 'number', default: 90, min: 1, max: 3650, integer: true, levels: ALL_LEVELS,
+        description: 'A recency-decay FELEZŐDÉSI ideje napban (Ebbinghaus-görbe, dsgn-013 §2): ennyi nap inaktivitás '
+            + '(nem-felidézés) után a recency-faktor a felére csökken. Nagyobb = lassabb felejtés. Default 90.',
+    },
+    'memory.floorWeight': {
+        type: 'number', default: 0.05, min: 0, max: 1, levels: ALL_LEVELS,
+        description: 'A memória-decay ALSÓ KORLÁTJA (dsgn-013 §2): az effektív szorzó sosem esik ez alá → a régi memória '
+            + 'lesüllyed a rangsorban, de a vektor-keresésben MÉG MEGTALÁLHATÓ (`> 0` → a `weight ≤ 0 → kizárt` szabályt '
+            + 'nem lépi át). `0` = a degradáció akár teljesen elnyomhat (de a tartalom akkor is megmarad Mongo-ban).',
+    },
+    'memory.maxFrequencyBoost': {
+        type: 'number', default: 2.5, min: 1, max: 100, levels: ALL_LEVELS,
+        description: 'A felidézés-gyakoriság (frequency) rangsor-boost FELSŐ KORLÁTJA (eval-lelet 2026-06-25): a nyers '
+            + '`1 + log2(1+recallCount)` KORLÁTLAN (gyakran-felidézett entry-re ~5×), ami multiplikatívan elnyomja a '
+            + 'koszinusz-relevanciát (a „forró" de alig-releváns memória eltemeti a releváns „hideget"). Itt plafonozzuk. '
+            + 'Default 2.5. Nagyobb = a gyakoriság erősebben rangsorol (a régi korlátlan viselkedéshez állítsd magasra).',
+    },
+    'memory.activationWeight': {
+        type: 'number', default: 0.35, min: 0, max: 1, levels: ALL_LEVELS,
+        description: 'Az aktiváció-szorzó TEMPER-súlya (α, eval-lelet 2026-06-25): a nyers decay-szorzót az 1 felé húzza '
+            + '(`1 + α·(raw−1)`) → az aktiváció FINOMAN modulál, a koszinusz-RELEVANCIA dominál (de a recent/frequent még '
+            + 'kissé előrébb). MINDKÉT véglet kompresszálódik: a „forró" entry nem boostolódik túl, ÉS a releváns „hideg" '
+            + 'entry nem zuhan a floor-ra. `1` = a régi (temper-mentes) viselkedés. Default 0.35.',
+    },
+    'memory.reactivateOnRead': {
+        type: 'boolean', default: true, levels: ALL_LEVELS,
+        description: 'Reaktiváció-on-read (dsgn-013 §4): a `read` által VISSZAADOTT memory-hitek „új energiát kapnak" '
+            + '(lastRecalledAt=most, recallCount++, dormant=false) — a felidézés megerősíti az emléket (feljebb rangsorol, '
+            + 'és ha alvó volt, visszakerül a hot készletbe). Async, NEM blokkolja a read-et. `false` → nincs frissítés.',
+    },
+    'memory.dormancyEnabled': {
+        type: 'boolean', default: true, levels: GLOBAL_ONLY,
+        description: 'Dormancy (dsgn-013 §5): a régóta-nem-felidézett, ritkán-használt memóriák ALVÓ-vá jelölése — NEM '
+            + 'hidratálódnak a hot LVS-poolba (RAM-/boot-spórolás), de COLD (Mongo) kereséssel elérhetők + megtaláláskor '
+            + 'reaktiválódnak. SOHA nem törlés. `false` → minden memória hidratálódik (a mai viselkedés).',
+    },
+    'memory.dormantMinAgeDays': {
+        type: 'number', default: 180, min: 1, max: 3650, integer: true, levels: GLOBAL_ONLY,
+        description: 'A DORMANT-küszöb minimális inaktivitása napban (dsgn-013 §5.1): egy memória CSAK akkor lehet alvó, '
+            + 'ha legalább ennyi napja nem idéztük fel (biztonsági alsó kor — a friss memória sosem alvó). Default 180.',
+    },
+    'memory.dormantMaxRecallCount': {
+        type: 'number', default: 2, min: 0, max: 1000, integer: true, levels: GLOBAL_ONLY,
+        description: 'A DORMANT-küszöb recall-gátja (dsgn-013 §5.1): a memória CSAK akkor lehet alvó, ha ennél kevesebbszer '
+            + 'idéztük fel — a gyakran-használt (≥ ennyi recall) memória SOHA nem alvó. Default 2.',
+    },
+    'memory.coldSearchEnabled': {
+        type: 'boolean', default: true, levels: ALL_LEVELS,
+        description: 'Cold-search (dsgn-013 §5.3): ha egy memória-read a HOT poolból kevés találatot ad (a dormant entry-k '
+            + 'nincsenek ott), a dormant készleten Mongo-oldali koszinusz-keresés fut (lassabb, de teljes), és a talált '
+            + 'entry-ket REAKTIVÁLJA (visszakerülnek a hot készletbe). `false` → a dormant entry-k csak re-scan/aktiváláskor jönnek vissza.',
+    },
+    'memory.coldSearchMaxCandidates': {
+        type: 'number', default: 5000, min: 100, max: 100000, integer: true, levels: ALL_LEVELS,
+        description: 'A cold-search dormant-scan FELSŐ KORLÁTJA (biztonsági memóriakorlát, dsgn-013 §5.3): a Mongo-koszinusz '
+            + 'legfeljebb ennyi dormant entry vektorát tölti be egy keresésnél. Default 5000.',
+    },
+    'memory.supersededPenalty': {
+        type: 'number', default: 0.25, min: 0, max: 1, levels: ALL_LEVELS,
+        description: 'A LEVÁLTOTT (superseded) memória ranking-PENALTYje (dsgn-013 §6): egy additív memory-fájl régi, már '
+            + 'átírt tartalma (pl. kompaktált MEMORY.md korábbi bejegyzései) ezzel a szorzóval süllyed a rangsorban — a friss '
+            + 'verzió fölébe kerül, de a régi MEGMARAD (cold-kereshető). `1` = nincs penalty; `0` = teljesen elnyomott (de megőrzött).',
+    },
     // --- 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,
@@ -236,10 +355,19 @@ exports.CONFIG_CATALOG = {
             + 'KÖZÖTT vár (az utolsó után nem), és a `dryRun` NEM vár (nincs valódi embed-munka).',
     },
     'scan.projectCooldownMs': {
-        type: 'number', default: 0, min: 0, max: 60000, integer: true, levels: ALL_LEVELS,
-        description: 'Kikapcsolható cooldown (ms) a PROJEKTEK KÖZÉ a `scan-projects` soros multi-scan-jében — a sok-'
-            + 'projektes (L2/L6) beolvasás ne thrash-elje a gépet. Default `0` = KIKAPCSOLVA; nagy futásra pl. 2000–'
-            + '5000. A CLI `--cooldown <ms>` felülírja ezt a config-default-ot (a projektek KÖZÖTT vár, az utolsó után nem).',
+        type: 'number', default: 10000, min: 0, max: 60000, integer: true, levels: ALL_LEVELS,
+        description: 'Cooldown (ms) a PROJEKTEK KÖZÉ a `scan-projects` soros multi-scan-jében — a sok-projektes '
+            + '(L2/L6) beolvasás ne thrash-elje a gépet. Default `10000` (10s). FELTÉTELES (user-FR 2026-06-22): CSAK '
+            + 'akkor vár, ha az ELŐZŐ projekt VALÓDI embed-munkát végzett (≥ `scan.projectCooldownMinChunks` új+módosult '
+            + 'chunk) — ha minden `equal` volt (0 embed), nincs gép-terhelés → NINCS cooldown. `0` = teljesen KI. A CLI '
+            + '`--cooldown <ms>` felülírja. (A projektek KÖZÖTT vár, az utolsó után nem.)',
+    },
+    'scan.projectCooldownMinChunks': {
+        type: 'number', default: 100, min: 0, max: 100000, integer: true, levels: ALL_LEVELS,
+        description: 'A feltételes projekt-cooldown küszöbe (user-FR 2026-06-22): a `scan-projects` CSAK akkor vár a '
+            + 'projektek között, ha az előző projekt ennyi VAGY több új+módosult (ténylegesen embeddelt) chunkot termelt. '
+            + 'Default `100` — a kis/`equal`-csak projektek után nincs felesleges szünet (a cooldown a helyi embed-terhelés '
+            + 'tehermentesítésére van). `0` = mindig vár (ha a cooldownMs > 0).',
     },
     'scan.estimateMsPerChunk': {
         type: 'number', default: 250, min: 1, max: 10000, integer: true, levels: ALL_LEVELS,
@@ -251,6 +379,20 @@ exports.CONFIG_CATALOG = {
         description: 'A futás-közbeni scan-progress log min. időköze (ms) — a nagy scan haladását ennyente jelzi '
             + 'a konzolon (`[famIngest]` activity-sor). A végső 100% mindig kibocsátódik.',
     },
+    'scan.stallThresholdMs': {
+        type: 'number', default: 120000, min: 5000, max: 1800000, integer: true, levels: ALL_LEVELS,
+        description: 'STALL-küszöb (ms, FEAT-008 Phase 5 — „jobb job kezelés"): ha egy FUTÓ scan-job ennyi ideje nem '
+            + 'mutat haladást (sem per-target befejezés, sem within-target progress), a `status`-ban `stalled:true` jelenik '
+            + 'meg. CSAK JELZÉS (nem szakítja meg automatikusan) — a user/CLI dönt (poll tovább / `cancel`). Az LM Studio '
+            + 'crash/hang determinisztikus felismeréséhez. Default `120000` (2 perc).',
+    },
+    'scan.maxResumeCount': {
+        type: 'number', default: 5, min: 0, max: 100, integer: true, levels: ALL_LEVELS,
+        description: 'AUTO-RESUME cap (FEAT-008 Phase 5): egy megszakadt job-ot a szerver legfeljebb ennyiszer indít újra '
+            + 'a startup-resume-on. Efölött a job `failed` (failureReason="resume-cap túllépve") — így egy folyton-elakadó '
+            + '(pl. mindig ugyanazon a tartalmon összeomló) job nem indul újra a végtelenségig minden restartkor. `0` = '
+            + 'soha ne resume-olj automatikusan.',
+    },
     // --- 4.6. Reference / scope (fogyasztó: dsgn-002) ---
     'reference.cacheTtlMs': {
         type: 'number', default: 60000, min: 0, max: 3600000, integer: true, levels: GLOBAL_ONLY,
@@ -269,32 +411,9 @@ exports.CONFIG_CATALOG = {
         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).',
     },
-    // --- 4.8. Memória / heap-guard (OOM-hibakezelés, fogyasztó: FAM_HeapGuard_ControlService) ---
-    'memory.guardEnabled': {
-        type: 'boolean', default: true, levels: GLOBAL_ONLY,
-        description: 'A heap-guard (OOM-hibakezelés) be/ki. `true` (default): watchdog (heap-arány + GC-hányad) + a '
-            + 'nehéz write-ek (scan/import/re-embed) load-shed-je critical nyomásnál + graceful-exit a near-limit '
-            + 'zónában (a kriptikus exit-134 helyett). `false`: csak a crash-handlerek (uncaught/unhandled) aktívak.',
-    },
-    'memory.warnRatio': {
-        type: 'number', default: 0.70, min: 0.1, max: 1.0, levels: GLOBAL_ONLY,
-        description: 'Heap-arány (used/limit), ami fölött a guard `warn` szintet jelez (log; még nincs load-shed).',
-    },
-    'memory.shedRatio': {
-        type: 'number', default: 0.82, min: 0.1, max: 1.0, levels: GLOBAL_ONLY,
-        description: 'Heap-arány, ami fölött `critical` → a nehéz write-ek (scan/import/re-embed) 503-mal elutasítva '
-            + '(a könnyű read/create/update fut tovább). A GC-hányad ≥60% is critical-t vált (mark-compact thrash-jel).',
-    },
-    'memory.exitRatio': {
-        type: 'number', default: 0.92, min: 0.1, max: 1.0, levels: GLOBAL_ONLY,
-        description: 'Heap-arány, ami fölött tartósan (GC-vel sem csökken) a guard TISZTÁN kilép (exit 137) → a `fam '
-            + 'serve` ps1 prediktíven újraindít. A kriptikus „Ineffective mark-compacts" exit-134 elkerülése. shed < exit ajánlott.',
-    },
-    'memory.pollMs': {
-        type: 'number', default: 3000, min: 500, max: 60000, integer: true, levels: GLOBAL_ONLY,
-        description: 'A heap-watchdog mintavételi időköze (ms) + a GC-hányad gördülő-ablaka. Kisebb = gyorsabb '
-            + 'reakció a hirtelen növekedésre, több CPU. 3000 = jó alapérték.',
-    },
+    // (Az OOM-hibakezelés/heap-guard configja a BEDROCK `DyNTS_global_settings.memoryGuard`-ban van — NEM FAM-config:
+    // a bedrock `DyNTS_MemoryGuard`-ot a base App auto-installálja, a FAM a thresholdokat az `overrideDynamoNTSGlobalSettings`-ben
+    // állítja. Ezért nincs FAM `memory.*` config-kulcs.)
     '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/error-codes.const.js

@@ -111,6 +111,8 @@ exports.FAM_ERROR_CODES = {
     // --- Vector (FAM-VEC-*) ---
     /** Mongo→in-memory pool hidratálás sikertelen boot-on (BFR-AM-001). */
     vecHydrate: 'FAM-VEC-HYDRATE-001',
+    /** A hidratálás-bevárás (readiness-coordinator) hibája: a tár hidratálása MEGBUKOTT vagy a várakozás time-outolt. */
+    vecHydrateWait: 'FAM-VEC-HYDRATE-002',
     /** vectorSearch hiba (dimenzió / üres pool / searchMode). */
     vecSearch: 'FAM-VEC-SEARCH-001',
     /** contentVector Mongo-persist sikertelen (BFR-AM-005). */