@soulcraft/brainy 5.6.2 → 5.6.3

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [5.6.3](https://github.com/soulcraftlabs/brainy/compare/v5.6.2...v5.6.3) (2025-11-11)
+
+- docs: add entity versioning to fork section (3e81fd8)
+- docs: add asOf() time-travel to fork section (5706b71)
+
+
 ### [5.6.2](https://github.com/soulcraftlabs/brainy/compare/v5.6.1...v5.6.2) (2025-11-11)
 
 - fix: update tests for Stage 3 CANONICAL taxonomy (42 nouns, 127 verbs) (c5dcdf6)

package/README.md

@@ -236,9 +236,9 @@ Brainy automatically:
 
 **You write business logic. Brainy handles infrastructure.**
 
-### 🚀 **Instant Fork™** — Git for Databases (v5.0.0)
+### 🚀 **Git-Style Version Control** — Database & Entity Level (v5.0.0+)
 
-**Clone your entire database in <100ms. Merge back when ready. Full Git-style workflow.**
+**Clone your entire database in <100ms. Track every entity change. Full Git-style workflow.**
 
 ```javascript
 // Fork instantly - Snowflake-style copy-on-write
@@ -257,19 +257,44 @@ const result = await brain.merge('test-migration', 'main', {
 })
 
 console.log(result)  // { added: 1, modified: 0, conflicts: 0 }
+
+// Time-travel: Query database at any past commit (read-only)
+const commits = await brain.getHistory({ limit: 10 })
+const snapshot = await brain.asOf(commits[5].id)
+const pastResults = await snapshot.find({ query: 'historical data' })
+await snapshot.close()
+
+// Entity versioning: Track changes to individual entities (v5.3.0+)
+const userId = await brain.add({ type: 'user', data: { name: 'Alice' } })
+await brain.versions.save(userId, { tag: 'v1.0', description: 'Initial profile' })
+
+await brain.update(userId, { data: { name: 'Alice Smith', role: 'admin' } })
+await brain.versions.save(userId, { tag: 'v2.0', description: 'Added role' })
+
+// Compare versions or restore previous state
+const diff = await brain.versions.compare(userId, 1, 2)  // See what changed
+await brain.versions.restore(userId, 1)  // Restore v1.0
 ```
 
-**NEW in v5.0.0:**
+**Database-level version control (v5.0.0):**
 - ✅ `fork()` - Instant clone in <100ms
 - ✅ `merge()` - Merge with conflict resolution
 - ✅ `commit()` - Snapshot state
+- ✅ `asOf()` - Time-travel queries (query at any commit)
 - ✅ `getHistory()` - View commit history
 - ✅ `checkout()`, `listBranches()` - Full branch management
 - ✅ CLI support for all features
 
+**Entity-level version control (v5.3.0):**
+- ✅ `versions.save()` - Save entity snapshots with tags
+- ✅ `versions.restore()` - Restore previous versions
+- ✅ `versions.compare()` - Diff between versions
+- ✅ `versions.list()` - View version history
+- ✅ Automatic deduplication (content-addressable storage)
+
 **How it works:** Snowflake-style COW shares HNSW index structures, copying only modified nodes (10-20% memory overhead).
 
-**Perfect for:** Safe migrations, A/B testing, feature branches, distributed development
+**Perfect for:** Safe migrations, A/B testing, feature branches, distributed development, time-travel debugging, audit trails, document versioning, compliance tracking
 
 [→ See Full Documentation](docs/features/instant-fork.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "5.6.2",
+  "version": "5.6.3",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. Stage 3 CANONICAL: 42 nouns × 127 verbs covering 96-97% of all human knowledge.",
   "main": "dist/index.js",
   "module": "dist/index.js",