@soulcraft/brainy 5.7.12 → 5.7.13

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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)
 
 

package/dist/brainy.js

@@ -1164,41 +1164,6 @@ export class Brainy {
                     Object.assign(filter, params.where);
                 if (params.service)
                     filter.service = params.service;
-                // v5.7.12: excludeVFS helper - ONLY exclude VFS infrastructure entities
-                // Bug fix: Previously excluded entities with ANY vfsType field
-                // Now ONLY excludes entities with isVFSEntity: true OR vfsType: 'file'/'directory'
-                // This allows extracted entities (concepts/people/etc) to be included even if they
-                // have vfsPath metadata showing where they were imported from
-                if (params.excludeVFS === true) {
-                    // Build filter: EXCLUDE WHERE (isVFSEntity == true) OR (vfsType IN ['file', 'directory'])
-                    // Implementation: INCLUDE WHERE (isVFSEntity missing/false) AND (vfsType missing/not file or directory)
-                    const existingFilter = { ...filter };
-                    filter = {
-                        allOf: [
-                            existingFilter,
-                            {
-                                // Only include entities WITHOUT isVFSEntity: true
-                                anyOf: [
-                                    { isVFSEntity: { exists: false } },
-                                    { isVFSEntity: { ne: true } }
-                                ]
-                            },
-                            {
-                                // Only include entities WITHOUT vfsType: 'file' or 'directory'
-                                // Since VFS files ALWAYS have vfsType set, we check it's missing OR not file/dir
-                                anyOf: [
-                                    { vfsType: { exists: false } },
-                                    {
-                                        allOf: [
-                                            { vfsType: { ne: 'file' } },
-                                            { vfsType: { ne: 'directory' } }
-                                        ]
-                                    }
-                                ]
-                            }
-                        ]
-                    };
-                }
                 if (params.type) {
                     const types = Array.isArray(params.type) ? params.type : [params.type];
                     if (types.length === 1) {
@@ -1213,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) {
@@ -1240,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) {
@@ -1308,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.12",
+  "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",