brainy/docs/api-design-archive/API-QUICK-REFERENCE.md
David Snelling 994276f09f docs: consolidate and archive redundant documentation
- Archived 13 API design iterations to docs/api-design-archive/
- Consolidated augmentation docs to docs/augmentations-archive/
- Maintained ONE definitive API doc at docs/api/README.md
- Cleaned up documentation structure for 2.0 release
- Preserved all historical documents for reference
2025-08-25 10:15:38 -07:00

1.9 KiB

🧠 Brainy 2.0 Quick Reference Card

Core Operations

// Nouns
await brain.addNoun(vector, metadata)     // Create
await brain.getNoun(id)                   // Read
await brain.updateNoun(id, vector?, meta?) // Update  
await brain.deleteNoun(id)                // Delete

// Verbs
await brain.addVerb(source, target, type) // Create relationship
await brain.getVerb(id)                   // Get relationship
await brain.deleteVerb(id)                // Delete relationship

// Metadata
await brain.getNounMetadata(id)           // Get metadata only
await brain.updateNounMetadata(id, meta)  // Update metadata only
await brain.hasNoun(id)                   // Check existence
await brain.search(query, k?)             // Vector search
await brain.searchText('natural language') // NLP search
await brain.findSimilar(id, k?)           // Similarity search
await brain.find(tripleQuery)             // Triple Intelligence 🧠

Graph

await brain.getConnections(id)            // All connections
await brain.getVerbsBySource(id)          // Outgoing
await brain.getVerbsByTarget(id)          // Incoming
await brain.getVerbsByType(type)          // By type

Management

brain.getCacheStats()                      // Cache stats
brain.clearCache()                         // Clear cache
brain.size()                              // Total count
await brain.getStats()                    // All statistics
await brain.clear()                       // Clear all data

Lifecycle

const brain = new BrainyData()            // Create
await brain.init()                        // Initialize
await brain.shutdown()                    // Cleanup

Configuration

new BrainyData({
  storage: 'auto',      // auto | memory | filesystem | s3
  cache: true,          // Enable caching
  index: true,          // Enable indexing
  dimensions: 384       // Vector dimensions
})