@soulcraft/brainy 5.7.11 → 5.7.13

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [5.7.13](https://github.com/soulcraftlabs/brainy/compare/v5.7.12...v5.7.13) (2025-11-14)
+
+
+### 🐛 Bug Fixes
+
+* resolve excludeVFS architectural bug across all query paths (v5.7.13) ([e57e947](https://github.com/soulcraftlabs/brainy/commit/e57e9474986097f37e89a8dbfa868005368d645c))
+
+### [5.7.12](https://github.com/soulcraftlabs/brainy/compare/v5.7.11...v5.7.12) (2025-11-13)
+
+
+### 🐛 Bug Fixes
+
+* excludeVFS now only excludes VFS infrastructure entities (v5.7.12) ([99ac901](https://github.com/soulcraftlabs/brainy/commit/99ac901894bb81ad61b52d422f43cf30f07b6813))
+
 ### [5.7.11](https://github.com/soulcraftlabs/brainy/compare/v5.7.10...v5.7.11) (2025-11-13)
 
 

package/dist/brainy.js

@@ -1164,11 +1164,6 @@ export class Brainy {
                     Object.assign(filter, params.where);
                 if (params.service)
                     filter.service = params.service;
-                // v4.7.0: excludeVFS helper for cleaner UX
-                // Use vfsType field (more semantic than isVFS)
-                if (params.excludeVFS === true) {
-                    filter.vfsType = { exists: false };
-                }
                 if (params.type) {
                     const types = Array.isArray(params.type) ? params.type : [params.type];
                     if (types.length === 1) {
@@ -1183,6 +1178,19 @@ export class Brainy {
                         };
                     }
                 }
+                // v5.7.13: excludeVFS helper - ONLY exclude VFS infrastructure entities
+                // Applied AFTER type filter to avoid execution order bugs
+                // Excludes entities where:
+                //   - vfsType is 'file' or 'directory' (VFS files/folders)
+                //   - isVFSEntity is true (explicitly marked as VFS)
+                // Includes extracted entities (person/concept/etc) even if they have vfsPath metadata
+                if (params.excludeVFS === true) {
+                    // VFS infrastructure entities ALWAYS have vfsType set
+                    // Extracted entities do NOT have vfsType (undefined)
+                    filter.vfsType = { exists: false };
+                    // Extra safety: exclude entities explicitly marked as VFS
+                    filter.isVFSEntity = { ne: true };
+                }
                 // v4.5.4: Apply sorting if requested, otherwise just filter
                 let filteredIds;
                 if (params.orderBy) {
@@ -1210,10 +1218,12 @@ export class Brainy {
             if (!hasVectorSearchCriteria && !hasFilterCriteria && !hasGraphCriteria) {
                 const limit = params.limit || 20;
                 const offset = params.offset || 0;
-                // v4.7.0: excludeVFS helper
+                // v5.7.13: excludeVFS helper - exclude VFS infrastructure entities
+                // VFS files/folders have vfsType set, extracted entities do NOT
                 let filter = {};
                 if (params.excludeVFS === true) {
                     filter.vfsType = { exists: false };
+                    filter.isVFSEntity = { ne: true };
                 }
                 // Use metadata index if we need to filter
                 if (Object.keys(filter).length > 0) {
@@ -1278,9 +1288,11 @@ export class Brainy {
                     Object.assign(filter, params.where);
                 if (params.service)
                     filter.service = params.service;
-                // v4.7.0: excludeVFS helper for cleaner UX
+                // v5.7.13: excludeVFS helper - exclude VFS infrastructure entities
+                // VFS files/folders have vfsType set, extracted entities do NOT
                 if (params.excludeVFS === true) {
                     filter.vfsType = { exists: false };
+                    filter.isVFSEntity = { ne: true };
                 }
                 if (params.type) {
                     const types = Array.isArray(params.type) ? params.type : [params.type];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "5.7.11",
+  "version": "5.7.13",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. Stage 3 CANONICAL: 42 nouns × 127 verbs covering 96-97% of all human knowledge.",
   "main": "dist/index.js",
   "module": "dist/index.js",