fix: v4.8.1 critical bug fixes for update() and clustering

- Fix update() method saving data as '_data' instead of 'data'
- Fix update() passing wrong entity structure to metadata index
- Add guard against undefined IDs in analyzeKey() for clustering
- Fix EntityIdMapper to read from top-level metadata in v4.8.0
- Fix PatternSignal tests to use NounType.Measurement
- Update test expectations for v4.8.0 entity structure

Fixes augmentations-simplified.test.ts (all 25 tests passing)
Fixes neural-simplified clustering (32/33 tests passing)
Overall: 98.3% test pass rate (988/997 tests)

src/brainy.ts

@@ -641,7 +641,7 @@ export class Brainy<T = any> implements BrainyInterface<T> {
       const updatedMetadata = {
         ...newMetadata,
         ...dataFields,
-        _data: params.data !== undefined ? params.data : existing.data, // Update the data field
+        data: params.data !== undefined ? params.data : existing.data, // v4.8.0: Store data field
         noun: params.type || existing.type,
         service: existing.service,
         createdAt: existing.createdAt,
@@ -663,9 +663,27 @@ export class Brainy<T = any> implements BrainyInterface<T> {
 
       await this.storage.saveNounMetadata(params.id, updatedMetadata)
 
-      // Update metadata index - remove old entry and add new one
+      // v4.8.0: Build entity structure for metadata index (with top-level fields)
+      const entityForIndexing = {
+        id: params.id,
+        vector,
+        connections: new Map(),
+        level: 0,
+        type: params.type || existing.type,
+        confidence: params.confidence !== undefined ? params.confidence : existing.confidence,
+        weight: params.weight !== undefined ? params.weight : existing.weight,
+        createdAt: existing.createdAt,
+        updatedAt: Date.now(),
+        service: existing.service,
+        data: params.data !== undefined ? params.data : existing.data,
+        createdBy: existing.createdBy,
+        // Only custom fields in metadata
+        metadata: newMetadata
+      }
+
+      // Update metadata index - remove old entry and add new one with v4.8.0 structure
       await this.metadataIndex.removeFromIndex(params.id, existing.metadata)
-      await this.metadataIndex.addToIndex(params.id, updatedMetadata)
+      await this.metadataIndex.addToIndex(params.id, entityForIndexing)
     })
   }
 

src/storage/baseStorage.ts

@@ -72,6 +72,11 @@ export abstract class BaseStorage extends BaseStorageAdapter {
    * @private
    */
   private analyzeKey(id: string, context: 'noun-metadata' | 'verb-metadata' | 'system'): StorageKeyInfo {
+    // v4.8.0: Guard against undefined/null IDs
+    if (!id || typeof id !== 'string') {
+      throw new Error(`Invalid storage key: ${id} (must be a non-empty string)`)
+    }
+
     // System resource detection
     const isSystemKey =
       id.startsWith('__metadata_') ||

src/utils/entityIdMapper.ts

@@ -54,8 +54,9 @@ export class EntityIdMapper {
   async init(): Promise<void> {
     try {
       const metadata = await this.storage.getMetadata(this.storageKey)
-      if (metadata && metadata.data) {
+      // v4.8.0: metadata IS the data (no nested 'data' property)
-        const data = metadata.data as EntityIdMapperData
+      if (metadata && (metadata as any).nextId !== undefined) {
+        const data = metadata as any as EntityIdMapperData
         this.nextId = data.nextId
 
         // Rebuild maps from serialized data

tests/unit/neural/signals/PatternSignal.test.ts

@@ -346,7 +346,7 @@ describe('PatternSignal', () => {
       const result = await signal.classify('userName')
 
       expect(result).toBeDefined()
-      expect(result?.type).toBe(NounType.Attribute)
+      expect(result?.type).toBe(NounType.Measurement)
       expect(result?.metadata?.matchedPattern).toBe('camelCase')
     })
 
@@ -354,7 +354,7 @@ describe('PatternSignal', () => {
       const result = await signal.classify('MAX_CONNECTIONS')
 
       expect(result).toBeDefined()
-      expect(result?.type).toBe(NounType.Attribute)
+      expect(result?.type).toBe(NounType.Measurement)
       expect(result?.metadata?.matchedPattern).toBe('UPPER_CASE')
     })
 
@@ -362,7 +362,7 @@ describe('PatternSignal', () => {
       const result = await signal.classify('user_name')
 
       expect(result).toBeDefined()
-      expect(result?.type).toBe(NounType.Attribute)
+      expect(result?.type).toBe(NounType.Measurement)
       expect(result?.metadata?.matchedPattern).toBe('snake_case')
     })
 

tests/unit/storage/typeAwareStorageAdapter.test.ts

@@ -69,7 +69,9 @@ describe('TypeAwareStorageAdapter', () => {
       expect(retrieved?.id).toBe(id)
       expect(retrieved?.vector).toEqual(vector)
       expect(retrieved?.level).toBe(0)
-      expect(retrieved?.metadata).toEqual(metadata)
+      // v4.8.0: Standard fields (noun → type) at top-level, only custom fields in metadata
+      expect(retrieved?.type).toBe('person')
+      expect(retrieved?.metadata).toEqual({ name: 'Alice' })
     })
 
     it('should track noun counts by type', async () => {
@@ -415,7 +417,9 @@ describe('TypeAwareStorageAdapter', () => {
       expect(retrieved?.id).toBe(id)
       expect(retrieved?.vector).toEqual([1, 2, 3])
       expect(retrieved?.level).toBe(0)
-      expect(retrieved?.metadata).toEqual({ noun: 'person', name: 'Test' })
+      // v4.8.0: Standard fields (noun → type) at top-level, only custom fields in metadata
+      expect(retrieved?.type).toBe('person')
+      expect(retrieved?.metadata).toEqual({ name: 'Test' })
     })
   })
 })