@futdevpro/fdp-agent-memory 1.1.162 → 1.1.166

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@futdevpro/fdp-agent-memory",
-    "version": "1.1.162",
+    "version": "1.1.166",
     "description": "Local-first, vector-backed multi-table agent memory exposed as an MCP server (read/write/capabilities). Public, FDP-Templates-free, no auth.",
     "private": false,
     "publishConfig": {

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

@@ -37,6 +37,18 @@ exports.SCAN_IGNORE_PATTERNS_DEFAULT = [
     // Generált report-ok / logok / teszt-artefaktumok (FAM-REV-057) — minifikált HTML / nagy JSON-log → embed-hang
     // (pl. dynamo-ngx: 515KB playwright-report HTML, 320KB .dynamo/logs status.json, 173KB logs/cicd-report.json).
     '**/playwright-report/**', '**/test-results/**', '**/.dynamo/**', '**/logs/**', '**/*.log', '**/*-report.json',
+    // GENERÁLT audit-/report-/evidence-artefaktumok (2026-08-22, a játék-projektek beemelésekor mérve). A fenti
+    // `*-report.json` TÚL SZŰK volt: a VERZIÓZOTT nevek (`asset-qa-report-v14.json`, `cat-animation-audit-v12.json`)
+    // átcsúsztak rajta. Mérve a teljes codebase táron: `evidence.json` 1082 chunk / 1,17M char (detektor-kimenet),
+    // `*-report*` 788, `*-audit*` 589, `asset|atlas-manifest` 257 (pixel-koordináták, occupancy-arányok),
+    // `dom-snapshot` 192, `*-capture` 153.
+    '**/*-report*.json', '**/*-audit*.json', '**/evidence.json', '**/dom-snapshot*.json', '**/*-capture.json',
+    '**/asset-manifest*.json', '**/atlas-manifest*.json',
+    // ⚠️ SZÁNDÉKOSAN NEM `**/reports/**` és NEM `**/manifest.json`:
+    //  - a `reports/` mappa-minta **4053 markdown DOKSI-chunkot** zárt volna ki (`__documentations/reports/…`),
+    //    ezért csak az e2e generált riport-mappája megy ki;
+    //  - a sima `manifest.json` a Unity `Packages/manifest.json` = a FÜGGŐSÉG-LISTA, ami valódi érték.
+    '**/e2e/reports/**',
     '**/*.min.js', '**/*.min.css', '**/*.map', '**/.env', '**/.env.*', '**/*.pem', '**/*.key',
     '**/*.secret', '**/secrets/**', '**/*.lock', '**/package-lock.json', '**/pnpm-lock.yaml',
     // Python (L4) — bytecode/venv/teszt-/lint-cache + telepített csomagok (SOHA nem forrás; a `*.pyc`/`*.pyo`
@@ -50,6 +62,19 @@ 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',
+    // Unity GÉPI SZERIALIZÁCIÓ — szöveges fájlok, ezért a bináris-routing ÁTENGEDTE őket, de a tartalmuk
+    // GUID-leves / YAML objektum-gráf / animációs görbe / mesh-vertex: NULLA emberi tudás. Mérve (2026-08-22, a
+    // játék-projektek beemelése után): **9 017 chunk / 9,5M karakter** csak ezekből — `.shadergraph` 4344,
+    // `.dwlt` 1105, `.anim` 1086, `.shadersubgraph` 1075, `.mat` 685, `.vfx` 281, `.controller` 178. És nem is
+    // csak holt teher: egy „shader for the water surface" query top-5-jéből **4 slot** ilyen szemét volt, a
+    // „UI button click handler"-ből 2 — a grafikai/UI kérdéseket gyakorlatilag használhatatlanná tette.
+    // A `.shader`/`.hlsl`/`.compute` SZÁNDÉKOSAN MARAD: azok kézzel írt forrás.
+    '**/*.shadergraph', '**/*.shadersubgraph', '**/*.vfx', '**/*.mat', '**/*.physicMaterial', '**/*.physicsMaterial2D',
+    '**/*.controller', '**/*.overrideController', '**/*.anim', '**/*.playable', '**/*.signal', '**/*.mask',
+    '**/*.terrainlayer', '**/*.brush', '**/*.inputactions', '**/*.lighting', '**/*.giparams', '**/*.cubemap',
+    '**/*.flare', '**/*.fontsettings', '**/*.guiskin', '**/*.spriteatlas', '**/*.spriteatlasv2', '**/*.mixer',
+    // Unity editor-layout + 3D-mesh + szerkesztői mentés (a `.obj` ProBuilder-generált geometria, nem forrás).
+    '**/*.dwlt', '**/*.obj', '**/*.fbx', '**/*.blend', '**/*.bak',
     // 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/

package/build/src/_models/data-models/fam-entry-base-properties.const.js

@@ -29,6 +29,7 @@ exports.famEntryBaseProperties = {
     referenceLinks: { type: 'string[]', default: [] },
     referenceCodes: { type: 'string[]', index: true, default: [] },
     weight: { type: 'number', default: 1 },
+    projectWeight: { type: 'number' },
     importance: { type: 'number', index: true },
     source: { type: 'object' },
     sourceFilePath: { type: 'string', index: true },

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

@@ -55,6 +55,14 @@ class FAM_Entry extends fsm_dynamo_1.DyFM_Metadata {
     // --- pontozás ---
     /** Retrieval-score multiplikátor (`> 0`); `0` → kizárt. Default `1.0` (per-tár override). */
     weight = 1;
+    /**
+     * A PROJEKT-szintu retrieval-szorzo a `.famconfig.json`-bol (`FAM_ProjectConfig_Util`). Kulon mezo a
+     * `weight`-tol, mert a `weight` a temperalason (`effectiveWeight`) megy at — az `read.weightInfluence: 0.06`
+     * mellett onnan MAXIMUM 6% lehuzas johet, barmilyen alacsony erteket adunk (merve 2026-08-22: `weight: 0.6`
+     * -> 2,4% csokkenes). Ez a mezo TEMPERALATLANUL szorozza a `finalScore`-t, igy a projekt-szintu policy
+     * valodi hatassal bir. Hianyzik/undefined -> 1 (nincs hatas).
+     */
+    projectWeight;
     /** Opcionális kvalitatív hangsúly (0..1). */
     importance;
     // --- Memory Activation Model (dsgn-013, CSAK a `memory` táron értelmezett) ---

package/build/src/_modules/ingest/_collections/fam-project-config.util.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAM_ProjectConfig_Util = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `FAM_ProjectConfig_Util` — a **projektben látható, verziókezelt** FAM-beállítás: `.famconfig.json` a
+ * scan-gyökérben, a már bevett `.fdpfamignore` MELLETT (owner-igény 2026-08-22: „ne csak a FAM-ban éljenek
+ * ezek a beállítások", legyen kényelmesen konfigurálható és a projektben is látszódjon).
+ *
+ * **Miért a SÚLY a fő mező.** A retrieval-rangsor RELATÍV: a `finalScore` a jelöltek KÖZÖTT dönt. Ezért egy
+ * projekt EGÉSZÉRE adott, egyenletes súly-szorzó pontosan azt csinálja, amit az owner kért:
+ *  - **általános keresésben** (a projekt más projektekkel VERSENYZIK) a tartalma halkabban jelenik meg;
+ *  - **célzott keresésben** (`scopeFilter` az adott projektre) MINDEN jelölt ugyanazt a szorzót kapja,
+ *    így a sorrend VÁLTOZATLAN — a projekt a saját keresésében teljes értékű marad.
+ * Nem kell tehát külön „általános vs. célzott" mechanika: az egyenletes szorzó önmagában elvégzi.
+ *
+ * A `weight: 0` és a negatív érték SZÁNDÉKOSAN tiltott: a `finalScore = score × weight` miatt az a bejegyzést
+ * VÉGLEG visszakereshetetlenné tenné (2026-08-22-én mérve a `write` oldalán — az entry a saját egyedi
+ * markerére sem jött vissza). Aki ki akar zárni valamit, `.fdpfamignore`-t írjon: az a szándék helyes kifejezése.
+ */
+class FAM_ProjectConfig_Util {
+    /** A projekt-konfig fájlneve — a `.fdpfamignore` testvére, ugyanabban a gyökérben. */
+    static FILE_NAME = '.famconfig.json';
+    /** Catch-all glob a projekt-szintű súlyhoz (a `weights` specifikus mintái ELÉBE kerülnek). */
+    static CATCH_ALL = '**';
+    /**
+     * A `.famconfig.json` beolvasása a megadott gyökérből. Hiányzó fájl → `undefined` (teljesen opcionális).
+     * Hibás JSON / érvénytelen érték → **WARN + a hibás mező kihagyása**, SOHA nem dönti meg a scant: egy
+     * elgépelt konfig ne akadályozza meg a projekt indexelését (`core-rich-error-handling`).
+     */
+    static load(rootDir) {
+        const file = path.join(rootDir, FAM_ProjectConfig_Util.FILE_NAME);
+        if (!fs.existsSync(file)) {
+            return undefined;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(fs.readFileSync(file, 'utf8'));
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[FAM scan] '${file}' NEM értelmezhető JSON (${error?.message}) — a projekt-konfig `
+                + 'KIHAGYVA, a scan a default beállításokkal folytatódik.');
+            return undefined;
+        }
+        const parsed = (raw && typeof raw === 'object') ? raw : {};
+        const config = {};
+        const weight = parsed.weight;
+        if (weight !== undefined) {
+            if (typeof weight === 'number' && Number.isFinite(weight) && weight > 0) {
+                config.weight = weight;
+            }
+            else {
+                fsm_dynamo_1.DyFM_Log.warn(`[FAM scan] '${file}': a \`weight\` POZITÍV szám kell legyen (kapott: ${String(weight)}) — `
+                    + 'kihagyva. A 0/negatív súly visszakereshetetlenné tenné a projektet; kizáráshoz `.fdpfamignore` kell.');
+            }
+        }
+        const weights = parsed.weights;
+        if (Array.isArray(weights)) {
+            const valid = weights.filter((rule) => !!rule && typeof rule === 'object'
+                && typeof rule.pattern === 'string'
+                && typeof rule.weight === 'number'
+                && Number.isFinite(rule.weight)
+                && rule.weight > 0);
+            if (valid.length !== weights.length) {
+                fsm_dynamo_1.DyFM_Log.warn(`[FAM scan] '${file}': ${weights.length - valid.length} érvénytelen \`weights\` szabály `
+                    + 'kihagyva (kell: `pattern` string + POZITÍV `weight`).');
+            }
+            if (valid.length) {
+                config.weights = valid;
+            }
+        }
+        if (typeof parsed.note === 'string') {
+            config.note = parsed.note;
+        }
+        return (config.weight !== undefined || config.weights || config.note) ? config : undefined;
+    }
+    /**
+     * A PROJEKT-FAKTOR szabálylistája (a temperálatlan `projectWeight`-hez). Az első illeszkedő nyer, ezért a
+     * sorrend jelentéses: ① a konfig SPECIFIKUS mintái, ② a projekt-szintű `weight` catch-all glob-ként — így
+     * egy `{"pattern": "__documentations/**", "weight": 1.0}` kivétel TÉNYLEGESEN kiveszi a doksikat a halkítás alól.
+     *
+     * ⚠️ KÜLÖN CSATORNA a hívó `weights`-étől. A hívó (scan-API) szabályai a `weight` mezőre mennek, ami a
+     * retrieval `effectiveWeight` temperálásán át hat (0.06 influence → max 6%). A projekt-konfig szabályai ide
+     * jönnek, ahol a szorzó KÖZVETLEN. A kettő összekeverése azt jelentené, hogy a `.famconfig.json`-ban felvett
+     * kivétel némán hatástalan marad — pontosan az a fajta látszat-funkció, amit kerülni akarunk.
+     */
+    static projectWeightRules(config) {
+        if (!config) {
+            return undefined;
+        }
+        const rules = [...(config.weights ?? [])];
+        if (config.weight !== undefined) {
+            rules.push({ pattern: FAM_ProjectConfig_Util.CATCH_ALL, weight: config.weight });
+        }
+        return rules.length ? rules : undefined;
+    }
+}
+exports.FAM_ProjectConfig_Util = FAM_ProjectConfig_Util;

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

@@ -484,6 +484,8 @@ class FAM_Ingest_ControlService {
             scopePath: set.scopePath,
             // Súly-kiemelés (FAM-REV-055): a scan-`weights`-ből feloldott fájl-súly (undefined → a tár model-default).
             weight: set.file.weight,
+            // A projekt-szintu szorzo a `.famconfig.json`-bol — a retrieval TEMPERALATLANUL alkalmazza.
+            projectWeight: set.file.projectWeight,
             sourceFilePath: set.file.relativePath,
             chunkIndex: set.chunk.chunkIndex,
             chunkTotal: set.chunk.chunkTotal,

package/build/src/_modules/ingest/_services/fam-scan.control-service.js

@@ -8,6 +8,7 @@ const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
 const config_catalog_const_1 = require("../../../_collections/config-catalog.const");
 const config_control_service_1 = require("../../../_routes/server/config/config.control-service");
 const fam_famignore_util_1 = require("../_collections/fam-famignore.util");
+const fam_project_config_util_1 = require("../_collections/fam-project-config.util");
 const fam_file_routing_util_1 = require("../_collections/fam-file-routing.util");
 const fam_glob_match_util_1 = require("../_collections/fam-glob-match.util");
 const fam_scan_path_util_1 = require("../_collections/fam-scan-path.util");
@@ -48,6 +49,17 @@ class FAM_Scan_ControlService {
         // (in-repo, gitignore-szerű; folder/project scan-nél — a scan-file egyetlen explicit fájlt céloz). HOZZÁADÓDIK.
         const baseIgnore = await this.resolveIgnorePatterns(set.scopePath, set.exclude);
         const famIgnore = set.operation === 'scan-file' ? [] : fam_famignore_util_1.FAM_FamIgnore_Util.loadFromDir(resolvedRoot);
+        // A projektben LATHATO, verziokezelt FAM-beallitas (`.famconfig.json`) — a `.fdpfamignore` testvere.
+        // Owner-igeny 2026-08-22: a beallitasok ne CSAK a FAM-ban eljenek, hanem a projektben is latszodjanak.
+        const projectConfig = set.operation === 'scan-file'
+            ? undefined
+            : fam_project_config_util_1.FAM_ProjectConfig_Util.load(resolvedRoot);
+        if (projectConfig) {
+            fsm_dynamo_1.DyFM_Log.info(`[famIngest] ${fam_project_config_util_1.FAM_ProjectConfig_Util.FILE_NAME} betoltve (${resolvedRoot}): `
+                + `weight=${projectConfig.weight ?? '-'}, per-minta szabaly=${projectConfig.weights?.length ?? 0}`
+                + `${projectConfig.note ? ` | ${projectConfig.note}` : ''}`);
+        }
+        const projectWeightRules = fam_project_config_util_1.FAM_ProjectConfig_Util.projectWeightRules(projectConfig);
         if (famIgnore.length) {
             fsm_dynamo_1.DyFM_Log.info(`[famIngest] .fdpfamignore betöltve (${resolvedRoot}): ${famIgnore.length / 2} minta-sor`);
         }
@@ -94,6 +106,7 @@ class FAM_Scan_ControlService {
                 maxFileSizeBytes: maxFileSizeBytes,
                 tableOverride: set.tableOverride,
                 weights: set.weights,
+                projectWeightRules: projectWeightRules,
                 testFileWeight: testFileWeight,
             });
             if (routed.route === 'skip') {
@@ -154,6 +167,7 @@ class FAM_Scan_ControlService {
         return {
             ...base, route: route,
             weight: fam_scan_weight_util_1.FAM_ScanWeight_Util.resolveWithDefault(set.relativePath, set.weights, set.testFileWeight),
+            projectWeight: fam_scan_weight_util_1.FAM_ScanWeight_Util.resolve(set.relativePath, set.projectWeightRules),
         };
     }
     /**

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

@@ -469,12 +469,21 @@ class FAM_Retrieval_ControlService {
             })
             : 0;
         const keywordBoost = 1 + set.config.keywordWeight * lexicalScore;
+        // PROJEKT-SZINTU szorzo a `.famconfig.json`-bol — SZANDEKOSAN a temperalason KIVUL. A `weight` mezo az
+        // `effectiveWeight`-en megy at, ahonnan a 0.06-os influence mellett MAXIMUM 6% lehuzas johet (merve
+        // 2026-08-22), ezert egy projekt-szintu policy ott gyakorlatilag hatastalan lenne. Itt viszont a szorzo
+        // KOZVETLENUL hat. A rangsor RELATIV, ezert az egyenletes projekt-szorzo altalanos keresesben halkit, de
+        // scope-olt (celzott) keresesben NEM valtoztat sorrendet — minden jelolt ugyanazt a szorzot kapja.
+        const projectFactor = typeof set.entry.projectWeight === 'number'
+            && Number.isFinite(set.entry.projectWeight) && set.entry.projectWeight > 0
+            ? set.entry.projectWeight
+            : 1;
         return {
             id: set.vectorHit.id,
             table: set.table,
             score: set.vectorHit.score,
             weight: set.weight,
-            finalScore: set.vectorHit.score * FAM_Retrieval_ControlService.effectiveWeight(set.weight, set.config.weightInfluence) * chunkFactor * sourceFactor * summaryFactor * decayFactor * keywordBoost,
+            finalScore: set.vectorHit.score * FAM_Retrieval_ControlService.effectiveWeight(set.weight, set.config.weightInfluence) * chunkFactor * sourceFactor * summaryFactor * decayFactor * keywordBoost * projectFactor,
             lexicalScore: lexicalScore,
             content: set.includeContent ? set.entry.content : undefined,
             contentHash: set.entry.contentHash,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fdp-agent-memory",
-  "version": "1.1.162",
+  "version": "1.1.166",
   "description": "Local-first, vector-backed multi-table agent memory exposed as an MCP server (read/write/capabilities). Public, FDP-Templates-free, no auth.",
   "private": false,
   "publishConfig": {