@soulcraft/brainy 5.3.6 → 5.5.0

package/dist/neural/entityExtractor.js

@@ -234,11 +234,11 @@ export class NeuralEntityExtractor {
         }
         // Hashtag
         if (text.startsWith('#')) {
-            return { type: NounType.Topic, confidence: 0.8 };
+            return { type: NounType.Concept, confidence: 0.8 };
         }
         // Mention
         if (text.startsWith('@')) {
-            return { type: NounType.User, confidence: 0.8 };
+            return { type: NounType.Person, confidence: 0.8 };
         }
         // Capitalized words (likely proper nouns)
         if (/^[A-Z]/.test(text)) {

package/dist/neural/relationshipConfidence.js

@@ -106,7 +106,7 @@ export class RelationshipConfidenceScorer {
             [VerbType.Contains]: ['contains', 'includes', 'has', 'holds'],
             [VerbType.Requires]: ['requires', 'needs', 'depends on', 'relies on'],
             [VerbType.Uses]: ['uses', 'utilizes', 'employs', 'applies'],
-            [VerbType.Supervises]: ['manages', 'oversees', 'supervises', 'controls'],
+            [VerbType.ReportsTo]: ['manages', 'oversees', 'supervises', 'controls'],
             [VerbType.Causes]: ['influences', 'affects', 'impacts', 'shapes', 'causes'],
             [VerbType.DependsOn]: ['depends on', 'relies on', 'based on'],
             [VerbType.Modifies]: ['modifies', 'changes', 'alters', 'updates'],

package/dist/neural/signals/VerbContextSignal.js

@@ -105,7 +105,7 @@ export class VerbContextSignal {
             {
                 subjectType: NounType.Document,
                 objectType: NounType.Person,
-                verbType: VerbType.CreatedBy,
+                verbType: VerbType.Creates,
                 confidence: 0.80,
                 description: 'Document created by Person'
             },
@@ -173,7 +173,7 @@ export class VerbContextSignal {
             {
                 subjectType: NounType.Product,
                 objectType: NounType.Organization,
-                verbType: VerbType.CreatedBy,
+                verbType: VerbType.Creates,
                 confidence: 0.75,
                 description: 'Product created by Organization'
             },
@@ -188,7 +188,7 @@ export class VerbContextSignal {
             {
                 subjectType: NounType.Product,
                 objectType: NounType.Person,
-                verbType: VerbType.CreatedBy,
+                verbType: VerbType.Creates,
                 confidence: 0.75,
                 description: 'Product created by Person'
             },
@@ -196,7 +196,7 @@ export class VerbContextSignal {
             {
                 subjectType: NounType.Event,
                 objectType: NounType.Person,
-                verbType: VerbType.CreatedBy,
+                verbType: VerbType.Creates,
                 confidence: 0.70,
                 description: 'Event created by Person'
             },
@@ -220,7 +220,7 @@ export class VerbContextSignal {
             {
                 subjectType: NounType.Project,
                 objectType: NounType.Organization,
-                verbType: VerbType.BelongsTo,
+                verbType: VerbType.Owns,
                 confidence: 0.75,
                 description: 'Project belongs to Organization'
             },
@@ -228,7 +228,7 @@ export class VerbContextSignal {
             {
                 subjectType: NounType.Project,
                 objectType: NounType.Person,
-                verbType: VerbType.CreatedBy,
+                verbType: VerbType.Creates,
                 confidence: 0.70,
                 description: 'Project created by Person'
             },

package/dist/neural/signals/VerbExactMatchSignal.js

@@ -190,14 +190,14 @@ export class VerbExactMatchSignal {
         // Common relationship phrases with their VerbTypes
         const phrases = [
             // Creation relationships
-            { pattern: /created?\s+by/i, type: VerbType.CreatedBy, confidence: 0.95 },
-            { pattern: /authored?\s+by/i, type: VerbType.CreatedBy, confidence: 0.95 },
-            { pattern: /written\s+by/i, type: VerbType.CreatedBy, confidence: 0.95 },
-            { pattern: /developed\s+by/i, type: VerbType.CreatedBy, confidence: 0.90 },
+            { pattern: /created?\s+by/i, type: VerbType.Creates, confidence: 0.95 },
+            { pattern: /authored?\s+by/i, type: VerbType.Creates, confidence: 0.95 },
+            { pattern: /written\s+by/i, type: VerbType.Creates, confidence: 0.95 },
+            { pattern: /developed\s+by/i, type: VerbType.Creates, confidence: 0.90 },
             { pattern: /built\s+by/i, type: VerbType.Creates, confidence: 0.85 },
             // Ownership relationships
             { pattern: /owned\s+by/i, type: VerbType.Owns, confidence: 0.95 },
-            { pattern: /belongs\s+to/i, type: VerbType.BelongsTo, confidence: 0.95 },
+            { pattern: /belongs\s+to/i, type: VerbType.Owns, confidence: 0.95 },
             { pattern: /attributed\s+to/i, type: VerbType.AttributedTo, confidence: 0.95 },
             // Part/Whole relationships
             { pattern: /part\s+of/i, type: VerbType.PartOf, confidence: 0.95 },
@@ -213,17 +213,17 @@ export class VerbExactMatchSignal {
             { pattern: /employed\s+by/i, type: VerbType.WorksWith, confidence: 0.90 },
             // Reporting relationships
             { pattern: /reports?\s+to/i, type: VerbType.ReportsTo, confidence: 0.95 },
-            { pattern: /manages/i, type: VerbType.Supervises, confidence: 0.85 },
-            { pattern: /supervises/i, type: VerbType.Supervises, confidence: 0.95 },
+            { pattern: /manages/i, type: VerbType.ReportsTo, confidence: 0.85 },
+            { pattern: /supervises/i, type: VerbType.ReportsTo, confidence: 0.95 },
             // Reference relationships
             { pattern: /references/i, type: VerbType.References, confidence: 0.90 },
             { pattern: /cites/i, type: VerbType.References, confidence: 0.90 },
             { pattern: /mentions/i, type: VerbType.References, confidence: 0.85 },
             // Temporal relationships
             { pattern: /precedes/i, type: VerbType.Precedes, confidence: 0.90 },
-            { pattern: /follows/i, type: VerbType.Succeeds, confidence: 0.90 },
+            { pattern: /follows/i, type: VerbType.Precedes, confidence: 0.90 },
             { pattern: /before/i, type: VerbType.Precedes, confidence: 0.75 },
-            { pattern: /after/i, type: VerbType.Succeeds, confidence: 0.75 },
+            { pattern: /after/i, type: VerbType.Precedes, confidence: 0.75 },
             // Causal relationships
             { pattern: /causes/i, type: VerbType.Causes, confidence: 0.90 },
             { pattern: /requires/i, type: VerbType.Requires, confidence: 0.90 },

package/dist/neural/signals/VerbPatternSignal.js

@@ -53,7 +53,7 @@ export class VerbPatternSignal {
             // ========== Creation & Authorship ==========
             {
                 regex: /\b(?:created?|made|built|developed|designed|wrote|authored|composed)\s+(?:by|from)\b/i,
-                type: VerbType.CreatedBy,
+                type: VerbType.Creates,
                 confidence: 0.90,
                 description: 'Creation with agent (passive)'
             },
@@ -84,7 +84,7 @@ export class VerbPatternSignal {
             },
             {
                 regex: /\bbelongs?\s+to\b/i,
-                type: VerbType.BelongsTo,
+                type: VerbType.Owns,
                 confidence: 0.95,
                 description: 'Belonging relationship'
             },
@@ -141,7 +141,7 @@ export class VerbPatternSignal {
             },
             {
                 regex: /\b(?:manages?|supervises?|oversees?)\b/i,
-                type: VerbType.Supervises,
+                type: VerbType.ReportsTo,
                 confidence: 0.85,
                 description: 'Management relationship'
             },
@@ -198,7 +198,7 @@ export class VerbPatternSignal {
             },
             {
                 regex: /\b(?:succeeds?|follows?|comes?\s+after|happens?\s+after)\b/i,
-                type: VerbType.Succeeds,
+                type: VerbType.Precedes,
                 confidence: 0.85,
                 description: 'Temporal succession'
             },
@@ -210,7 +210,7 @@ export class VerbPatternSignal {
             },
             {
                 regex: /\bafter\b/i,
-                type: VerbType.Succeeds,
+                type: VerbType.Precedes,
                 confidence: 0.70,
                 description: 'After (temporal)'
             },

package/dist/query/typeAwareQueryPlanner.js

@@ -145,18 +145,17 @@ export class TypeAwareQueryPlanner {
             NounType.Media,
             NounType.File,
             NounType.Message,
-            NounType.Content,
             NounType.Collection,
             NounType.Dataset,
             NounType.Product,
             NounType.Service,
-            NounType.User,
+            NounType.Person,
             NounType.Task,
             NounType.Project,
             NounType.Process,
             NounType.State,
             NounType.Role,
-            NounType.Topic,
+            NounType.Concept,
             NounType.Language,
             NounType.Currency,
             NounType.Measurement,

package/dist/storage/adapters/azureBlobStorage.d.ts

@@ -11,7 +11,7 @@
  *
  * v4.0.0: Fully compatible with metadata/vector separation architecture
  */
-import { HNSWNoun, HNSWVerb, HNSWNounWithMetadata, HNSWVerbWithMetadata, StatisticsData } from '../../coreTypes.js';
+import { HNSWNoun, HNSWVerb, StatisticsData } from '../../coreTypes.js';
 import { BaseStorage, StorageBatchConfig } from '../baseStorage.js';
 type HNSWNode = HNSWNoun;
 type Edge = HNSWVerb;
@@ -24,6 +24,12 @@ type Edge = HNSWVerb;
  * 2. Connection String - if connectionString provided
  * 3. Storage Account Key - if accountName + accountKey provided
  * 4. SAS Token - if accountName + sasToken provided
+ *
+ * v5.4.0: Type-aware storage now built into BaseStorage
+ * - Removed 10 *_internal method overrides (now inherit from BaseStorage's type-first implementation)
+ * - Removed pagination overrides
+ * - Updated HNSW methods to use BaseStorage's getNoun/saveNoun (type-first paths)
+ * - All operations now use type-first paths: entities/nouns/{type}/vectors/{shard}/{id}.json
  */
 export declare class AzureBlobStorage extends BaseStorage {
     private blobServiceClient;
@@ -53,6 +59,7 @@ export declare class AzureBlobStorage extends BaseStorage {
     private nounCacheManager;
     private verbCacheManager;
     private logger;
+    private hnswLocks;
     /**
      * Initialize the storage adapter
      * @param options Configuration options for Azure Blob Storage
@@ -146,10 +153,6 @@ export declare class AzureBlobStorage extends BaseStorage {
      * Flush verb buffer to Azure
      */
     private flushVerbBuffer;
-    /**
-     * Save a noun to storage (internal implementation)
-     */
-    protected saveNoun_internal(noun: HNSWNoun): Promise<void>;
     /**
      * Save a node to storage
      */
@@ -158,20 +161,10 @@ export declare class AzureBlobStorage extends BaseStorage {
      * Save a node directly to Azure (bypass buffer)
      */
     private saveNodeDirect;
-    /**
-     * Get a noun from storage (internal implementation)
-     * v4.0.0: Returns ONLY vector data (no metadata field)
-     * Base class combines with metadata via getNoun() -> HNSWNounWithMetadata
-     */
-    protected getNoun_internal(id: string): Promise<HNSWNoun | null>;
     /**
      * Get a node from storage
      */
     protected getNode(id: string): Promise<HNSWNode | null>;
-    /**
-     * Delete a noun from storage (internal implementation)
-     */
-    protected deleteNoun_internal(id: string): Promise<void>;
     /**
      * Write an object to a specific path in Azure
      * Primitive operation required by base class
@@ -222,10 +215,6 @@ export declare class AzureBlobStorage extends BaseStorage {
      * Helper: Convert Azure stream to buffer
      */
     private streamToBuffer;
-    /**
-     * Save a verb to storage (internal implementation)
-     */
-    protected saveVerb_internal(verb: HNSWVerb): Promise<void>;
     /**
      * Save an edge to storage
      */
@@ -234,55 +223,10 @@ export declare class AzureBlobStorage extends BaseStorage {
      * Save an edge directly to Azure (bypass buffer)
      */
     private saveEdgeDirect;
-    /**
-     * Get a verb from storage (internal implementation)
-     * v4.0.0: Returns ONLY vector + core relational fields (no metadata field)
-     * Base class combines with metadata via getVerb() -> HNSWVerbWithMetadata
-     */
-    protected getVerb_internal(id: string): Promise<HNSWVerb | null>;
     /**
      * Get an edge from storage
      */
     protected getEdge(id: string): Promise<Edge | null>;
-    /**
-     * Delete a verb from storage (internal implementation)
-     */
-    protected deleteVerb_internal(id: string): Promise<void>;
-    /**
-     * Get nouns with pagination
-     * v4.0.0: Returns HNSWNounWithMetadata[] (includes metadata field)
-     * Iterates through all UUID-based shards (00-ff) for consistent pagination
-     */
-    getNounsWithPagination(options?: {
-        limit?: number;
-        cursor?: string;
-        filter?: {
-            nounType?: string | string[];
-            service?: string | string[];
-            metadata?: Record<string, any>;
-        };
-    }): Promise<{
-        items: HNSWNounWithMetadata[];
-        totalCount?: number;
-        hasMore: boolean;
-        nextCursor?: string;
-    }>;
-    /**
-     * Get nouns by noun type (internal implementation)
-     */
-    protected getNounsByNounType_internal(nounType: string): Promise<HNSWNoun[]>;
-    /**
-     * Get verbs by source ID (internal implementation)
-     */
-    protected getVerbsBySource_internal(sourceId: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Get verbs by target ID (internal implementation)
-     */
-    protected getVerbsByTarget_internal(targetId: string): Promise<HNSWVerbWithMetadata[]>;
-    /**
-     * Get verbs by type (internal implementation)
-     */
-    protected getVerbsByType_internal(type: string): Promise<HNSWVerbWithMetadata[]>;
     /**
      * Clear all data from storage
      */
@@ -318,10 +262,14 @@ export declare class AzureBlobStorage extends BaseStorage {
     protected persistCounts(): Promise<void>;
     /**
      * Get a noun's vector for HNSW rebuild
+     * v5.4.0: Uses BaseStorage's getNoun (type-first paths)
      */
     getNounVector(id: string): Promise<number[] | null>;
     /**
      * Save HNSW graph data for a noun
+     *
+     * v5.4.0: Uses BaseStorage's getNoun/saveNoun (type-first paths)
+     * CRITICAL: Uses mutex locking to prevent read-modify-write races
      */
     saveHNSWData(nounId: string, hnswData: {
         level: number;
@@ -329,6 +277,7 @@ export declare class AzureBlobStorage extends BaseStorage {
     }): Promise<void>;
     /**
      * Get HNSW graph data for a noun
+     * v5.4.0: Uses BaseStorage's getNoun (type-first paths)
      */
     getHNSWData(nounId: string): Promise<{
         level: number;