feat: complete VFS with Knowledge Layer integration
- Add importFile() method for single file imports - Implement entity helper methods (linkEntities, findEntityOccurrences) - Fix critical embedding tokenizer bug (char.charCodeAt error) - Fix removeRelationship to actually remove using brain.unrelate() - Add setMetadata/getMetadata methods - Fix GitBridge to query real relationships and events - Enable background Knowledge Layer processing - Rewrite README to emphasize knowledge over files - Add comprehensive VFS documentation (core, knowledge layer, examples) - Add complete test suite covering all VFS methods This completes the VFS implementation with full Knowledge Layer support, enabling files as living knowledge that understand themselves, evolve over time, and connect to everything related.
This commit is contained in:
parent
b3c4f348ab
commit
581f9906fd
17 changed files with 2441 additions and 352 deletions
70
README.md
70
README.md
|
|
@ -9,11 +9,11 @@
|
|||
[](LICENSE)
|
||||
[](https://www.typescriptlang.org/)
|
||||
|
||||
**🧠 Brainy - Universal Knowledge Protocol™**
|
||||
**🧠 Brainy - The Knowledge Operating System**
|
||||
|
||||
**World's first Triple Intelligence™ database** unifying vector similarity, graph relationships, and document filtering in one magical API. **Framework-friendly design** works seamlessly with Next.js, React, Vue, Angular, and any modern JavaScript framework.
|
||||
**The world's first Knowledge Operating System** where every piece of knowledge - files, concepts, entities, ideas - exists as living information that understands itself, evolves over time, and connects to everything related. Built on revolutionary Triple Intelligence™ that unifies vector similarity, graph relationships, and document filtering in one magical API.
|
||||
|
||||
**Why Brainy Leads**: We're the first to solve the impossible—combining three different database paradigms (vector, graph, document) into one unified query interface. This breakthrough enables us to be the Universal Knowledge Protocol where all tools, augmentations, and AI models speak the same language.
|
||||
**Why Brainy Changes Everything**: Traditional systems trap knowledge in files or database rows. Brainy liberates it. Your characters exist across stories. Your concepts span projects. Your APIs remember their evolution. Every piece of knowledge - whether it's code, prose, or pure ideas - lives, breathes, and connects in a unified intelligence layer where everything understands its meaning, remembers its history, and relates to everything else.
|
||||
|
||||
**Framework-first design.** Built for modern web development with zero configuration and automatic framework compatibility. O(log n) performance, <10ms search latency, production-ready.
|
||||
|
||||
|
|
@ -182,7 +182,7 @@ If using nvm: `nvm use` (we provide a `.nvmrc` file)
|
|||
|
||||
### World's First Triple Intelligence™ Engine
|
||||
|
||||
**The breakthrough that enables the Universal Knowledge Protocol:**
|
||||
**The breakthrough that enables The Knowledge Operating System:**
|
||||
|
||||
- **Vector Search**: Semantic similarity with HNSW indexing
|
||||
- **Graph Relationships**: Navigate connected knowledge like Neo4j
|
||||
|
|
@ -190,7 +190,7 @@ If using nvm: `nvm use` (we provide a `.nvmrc` file)
|
|||
- **Unified in ONE API**: No separate queries, no complex joins
|
||||
- **First to solve this**: Others do vector OR graph OR document—we do ALL
|
||||
|
||||
### Universal Knowledge Protocol with Infinite Expressiveness
|
||||
### The Knowledge Operating System with Infinite Expressiveness
|
||||
|
||||
**Enabled by Triple Intelligence, standardized for everyone:**
|
||||
|
||||
|
|
@ -209,6 +209,56 @@ await brain.find("Popular JavaScript libraries similar to Vue")
|
|||
await brain.find("Documentation about authentication from last month")
|
||||
```
|
||||
|
||||
### 🧠🌐 **Knowledge Graph + Virtual Filesystem - Where Ideas Come Alive**
|
||||
|
||||
**Store ANY knowledge. Connect EVERYTHING. Files are optional.**
|
||||
|
||||
- **Living Knowledge**: Characters, concepts, and systems that exist independently of files
|
||||
- **Universal Connections**: Link files to entities, entities to concepts, anything to anything
|
||||
- **Semantic Intelligence**: Find knowledge by meaning, not by where it's stored
|
||||
- **Optional Files**: Use filesystem operations when helpful, pure knowledge when not
|
||||
- **Perfect Memory**: Every piece of knowledge remembers its entire history
|
||||
- **Knowledge Evolution**: Watch ideas grow and connect across time and projects
|
||||
|
||||
```javascript
|
||||
import { Brainy } from '@soulcraft/brainy'
|
||||
|
||||
const brain = new Brainy({ storage: { type: 'memory' } })
|
||||
await brain.init()
|
||||
const vfs = brain.vfs()
|
||||
await vfs.init()
|
||||
|
||||
// Start with familiar files if you want
|
||||
await vfs.writeFile('/story.txt', 'A tale of adventure...')
|
||||
|
||||
// But knowledge doesn't need files!
|
||||
const alice = await vfs.createEntity({
|
||||
name: 'Alice',
|
||||
type: 'character',
|
||||
description: 'Brave explorer discovering quantum worlds'
|
||||
})
|
||||
|
||||
const quantumPhysics = await vfs.createConcept({
|
||||
name: 'Quantum Entanglement',
|
||||
domain: 'physics',
|
||||
keywords: ['superposition', 'measurement', 'correlation']
|
||||
})
|
||||
|
||||
// Connect EVERYTHING - files, entities, concepts
|
||||
await vfs.linkEntities(alice, quantumPhysics, 'studies')
|
||||
await vfs.addRelationship('/story.txt', alice.id, 'features')
|
||||
|
||||
// Find knowledge by meaning, not location
|
||||
const physics = await vfs.search('quantum mechanics')
|
||||
// Returns: files, entities, concepts, relationships - ALL knowledge
|
||||
|
||||
// Knowledge transcends boundaries
|
||||
const aliceKnowledge = await vfs.getEntityGraph(alice)
|
||||
// Her relationships, appearances, evolution - her entire existence
|
||||
```
|
||||
|
||||
**Your knowledge isn't trapped anymore.** Characters live beyond stories. APIs exist beyond code files. Concepts connect across domains. This is knowledge that happens to support files, not a filesystem that happens to store knowledge.
|
||||
|
||||
### 🎯 Zero Configuration Philosophy
|
||||
|
||||
Brainy automatically configures **everything**:
|
||||
|
|
@ -661,7 +711,7 @@ Key changes in the latest version:
|
|||
|
||||
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
||||
|
||||
## 🧠 The Universal Knowledge Protocol Explained
|
||||
## 🧠 The Knowledge Operating System Explained
|
||||
|
||||
### How We Achieved The Impossible
|
||||
|
||||
|
|
@ -706,6 +756,14 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
|||
- [Next.js Integration](docs/guides/nextjs-integration.md) - **NEW!** React and Next.js examples
|
||||
- [Vue.js Integration](docs/guides/vue-integration.md) - **NEW!** Vue and Nuxt examples
|
||||
|
||||
### Virtual Filesystem & Knowledge Layer 🧠📁
|
||||
- [VFS Core Documentation](docs/vfs/VFS_CORE.md) - **NEW!** Complete filesystem architecture and API
|
||||
- [VFS + Knowledge Layer](docs/vfs/VFS_KNOWLEDGE_LAYER.md) - **NEW!** Intelligent knowledge management features
|
||||
- [Examples & Scenarios](docs/vfs/VFS_EXAMPLES_SCENARIOS.md) - **NEW!** Real-world use cases and code
|
||||
- [VFS API Guide](docs/vfs/VFS_API_GUIDE.md) - Complete API reference
|
||||
- [Knowledge Layer API](docs/vfs/KNOWLEDGE_LAYER_API.md) - Advanced knowledge features
|
||||
- [Knowledge Layer Overview](docs/KNOWLEDGE_LAYER_OVERVIEW.md) - Non-technical guide
|
||||
|
||||
### Core Documentation
|
||||
- [Getting Started Guide](docs/guides/getting-started.md)
|
||||
- [API Reference](docs/api/README.md)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue