@soulcraft/brainy 4.3.0 → 4.3.2

package/dist/import/ImportCoordinator.js

@@ -93,15 +93,22 @@ export class ImportCoordinator {
         // Extract entities and relationships
         const extractionResult = await this.extract(normalizedSource, detection.format, options);
         // Set defaults
+        // CRITICAL FIX (v4.3.2): Spread options FIRST, then apply defaults
+        // Previously: ...options at the end overwrote normalized defaults with undefined
+        // Now: Defaults properly override undefined values
+        // v4.4.0: Enable AI features by default for smarter imports
         const opts = {
+            ...options, // Spread first to get all options
             vfsPath: options.vfsPath || `/imports/${Date.now()}`,
             groupBy: options.groupBy || 'type',
             createEntities: options.createEntities !== false,
             createRelationships: options.createRelationships !== false,
             preserveSource: options.preserveSource !== false,
             enableDeduplication: options.enableDeduplication !== false,
-            deduplicationThreshold: options.deduplicationThreshold || 0.85,
-            ...options
+            enableNeuralExtraction: options.enableNeuralExtraction !== false, // v4.4.0: Default true
+            enableRelationshipInference: options.enableRelationshipInference !== false, // v4.4.0: Default true
+            enableConceptExtraction: options.enableConceptExtraction !== false, // Already defaults to true
+            deduplicationThreshold: options.deduplicationThreshold || 0.85
         };
         // Report VFS storage stage
         options.onProgress?.({
@@ -408,7 +415,10 @@ export class ImportCoordinator {
         const relationships = [];
         let mergedCount = 0;
         let newCount = 0;
-        if (!options.createEntities) {
+        // CRITICAL FIX (v4.3.2): Default to true when undefined
+        // Previously: if (!options.createEntities) treated undefined as false
+        // Now: Only skip when explicitly set to false
+        if (options.createEntities === false) {
             return { entities, relationships, merged: 0, newEntities: 0 };
         }
         // Extract rows/sections/entities from result (unified across formats)

package/dist/importers/SmartExcelImporter.d.ts

@@ -129,6 +129,24 @@ export declare class SmartExcelImporter {
      * Map type string to NounType
      */
     private mapTypeString;
+    /**
+     * Infer entity type from Excel sheet name
+     *
+     * Uses common naming patterns to suggest appropriate entity types:
+     * - "Characters", "People", "Humans" → Person
+     * - "Places", "Locations" → Location
+     * - "Terms", "Concepts", "Glossary" → Concept
+     * - etc.
+     *
+     * @param sheetName - Excel sheet name
+     * @returns Inferred NounType or null if no match
+     *
+     * @example
+     * inferTypeFromSheetName("Characters") // → NounType.Person
+     * inferTypeFromSheetName("Places") // → NounType.Location
+     * inferTypeFromSheetName("Animals") // → null (no semantic hint)
+     */
+    private inferTypeFromSheetName;
     /**
      * Infer relationship type from context using SmartRelationshipExtractor
      */

package/dist/importers/SmartExcelImporter.js

@@ -107,10 +107,16 @@ export class SmartExcelImporter {
                         ? this.brain.extractConcepts(definition, { limit: 10 }).catch(() => [])
                         : Promise.resolve([])
                 ]);
-                // Determine main entity type
+                // Determine main entity type with priority order:
+                // 1. Explicit "Type" column (highest priority - user specified)
+                // 2. Sheet name inference (NEW - semantic hint from Excel structure)
+                // 3. AI extraction from related entities
+                // 4. Default to Thing (fallback)
+                const sheetTypeHint = this.inferTypeFromSheetName(row._sheet || '');
                 const mainEntityType = type ?
                     this.mapTypeString(type) :
-                    (relatedEntities.length > 0 ? relatedEntities[0].type : NounType.Thing);
+                    sheetTypeHint ||
+                        (relatedEntities.length > 0 ? relatedEntities[0].type : NounType.Thing);
                 // Generate entity ID
                 const entityId = this.generateEntityId(term);
                 // Create main entity
@@ -297,6 +303,58 @@ export class SmartExcelImporter {
         };
         return mapping[normalized] || NounType.Thing;
     }
+    /**
+     * Infer entity type from Excel sheet name
+     *
+     * Uses common naming patterns to suggest appropriate entity types:
+     * - "Characters", "People", "Humans" → Person
+     * - "Places", "Locations" → Location
+     * - "Terms", "Concepts", "Glossary" → Concept
+     * - etc.
+     *
+     * @param sheetName - Excel sheet name
+     * @returns Inferred NounType or null if no match
+     *
+     * @example
+     * inferTypeFromSheetName("Characters") // → NounType.Person
+     * inferTypeFromSheetName("Places") // → NounType.Location
+     * inferTypeFromSheetName("Animals") // → null (no semantic hint)
+     */
+    inferTypeFromSheetName(sheetName) {
+        if (!sheetName)
+            return null;
+        const normalized = sheetName.toLowerCase();
+        // Person types: characters, people, humans, individuals
+        if (normalized.match(/character|people|person|human|individual|npc|cast/)) {
+            return NounType.Person;
+        }
+        // Location types: places, locations, areas, regions
+        if (normalized.match(/place|location|area|region|zone|geography|map|world/)) {
+            return NounType.Location;
+        }
+        // Concept types: terms, concepts, ideas, glossary
+        if (normalized.match(/term|concept|idea|definition|glossary|vocabulary|lexicon/)) {
+            return NounType.Concept;
+        }
+        // Organization types: groups, factions, companies
+        if (normalized.match(/organization|company|group|faction|tribe|guild|clan|corp/)) {
+            return NounType.Organization;
+        }
+        // Event types: events, occurrences, happenings
+        if (normalized.match(/event|occurrence|happening|battle|encounter|scene/)) {
+            return NounType.Event;
+        }
+        // Product types: items, equipment, gear
+        if (normalized.match(/item|product|equipment|gear|weapon|armor|artifact|treasure/)) {
+            return NounType.Product;
+        }
+        // Project types: quests, missions, campaigns
+        if (normalized.match(/project|quest|mission|campaign|task/)) {
+            return NounType.Project;
+        }
+        // No semantic match found - return null to continue to next type determination method
+        return null;
+    }
     /**
      * Infer relationship type from context using SmartRelationshipExtractor
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "4.3.0",
+  "version": "4.3.2",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",