@soulcraft/cor 3.0.0 → 3.0.2

package/README.md

@@ -24,12 +24,13 @@
   <a href="#feature-tour">Features</a> ·
   <a href="#one-box-hundreds-of-brains--or-one-brain-at-billion-scale">Scale</a> ·
   <a href="#measured-not-promised">Benchmarks</a> ·
+  <a href="#licensing-that-never-breaks-your-app">Licensing</a> ·
   <a href="#learn-more">Docs</a>
 </p>
 
 ---
 
-[Brainy](https://github.com/soulcraftlabs/brainy) is the open-source knowledge database — vectors, relationships, metadata, and full-text in one MIT-licensed engine. Cor swaps compiled Rust in under every hot path. **No code changes. No configuration.** Add the package and it activates; **remove it and everything keeps working** on the same files, at open-source speed. That's the contract in both directions.
+[Brainy](https://github.com/soulcraftlabs/brainy) is the open-source knowledge database — vectors, relationships, metadata, and full-text in one MIT-licensed engine. Cor swaps compiled Rust in under every hot path. **No code changes. No configuration.** Install it and brainy (≥ 8.0.9) auto-detects it — loudly: activation prints `Providers: 10/10 native`, a missing license warns by name, and a broken install makes `init()` throw rather than quietly run slow. **Remove it and everything keeps working** on the same files, at open-source speed. That's the contract in both directions.
 
 | Brainy runs it as | Cor replaces it with | You get |
 |---|---|---|
@@ -48,28 +49,41 @@ npm install @soulcraft/cor    # or: bun add @soulcraft/cor
 ```
 
 ```typescript
-import { Brainy, NounType } from '@soulcraft/brainy'
+import { Brainy, NounType, VerbType } from '@soulcraft/brainy'
 
 const brain = new Brainy({ storage: { type: 'filesystem', path: './data' } })
-await brain.init() // cor is auto-detected — every hot path is now native
+await brain.init() // cor auto-detected (brainy ≥ 8.0.9) — look for "Providers: 10/10 native"
 
-await brain.add({ data: 'native rust acceleration', type: NounType.Concept })
+const cor = await brain.add({
+  data: 'Cor swaps compiled Rust in under every Brainy hot path',
+  type: NounType.Concept,
+  subtype: 'library',
+  metadata: { layer: 'native', year: 2026 },
+})
+const brainy = await brain.add({
+  data: 'Brainy is the open-source knowledge database',
+  type: NounType.Concept,
+  subtype: 'library',
+  metadata: { layer: 'engine', year: 2026 },
+})
+await brain.relate({ from: cor, to: brainy, type: VerbType.DependsOn, subtype: 'runtime' })
 
 const hits = await brain.find({
-  query: 'fast vector search',     // vector — what it means
-  where: { status: 'active' },     // metadata — pushed INTO the walk
-  connected: { from: teamId },     // graph — what it touches
-})                                 // one call, three indexes, fused
+  query: 'native acceleration',   // vector — what it means
+  where: { layer: 'native' },     // metadata — pushed INTO the walk
+  connected: { to: brainy },      // graph — what it touches
+})                                // one call, three indexes, fused
 ```
 
-**Activate** (paid tiers; free = just use brainy):
+**Get a license & activate** — under 1M entities, skip this: brainy alone is free and genuinely enough. Beyond that, pick a tier at **[soulcraft.com/pricing](https://soulcraft.com/pricing?focus=cor)** (pricing follows the size of your brain — from $49/mo), then:
 
 ```bash
-npx @soulcraft/cor login          # browser sign-in, like `gh auth login`
+npx @soulcraft/cor login          # browser sign-in, like `gh auth login` —
+                                  # walks you through checkout too if you don't have a key yet
 # or, for servers / CI:  export COR_LICENSE_KEY=sc_cor_...
 ```
 
-Keys verify **offline** in Rust — no network call at startup, no license server to run.
+Keys verify **offline** in Rust — no network call at startup, no license server to run. And a missing or expired key never breaks anything: cor steps aside and you're on open-source brainy, same files.
 
 ## Exact filters inside the vector walk
 

package/dist/graph/NativeGraphAdjacencyIndex.js

@@ -931,6 +931,12 @@ export class GraphAdjacencyIndex {
         this.flushTimer = setInterval(async () => {
             await this.flush();
         }, this.config.flushInterval);
+        // Never keep a bare process alive for housekeeping: durability rides the
+        // mmap'd LSM log at write time — this timer only paces background flushes.
+        // Without unref, any script that exits without reaching close() hangs
+        // forever. Same pattern as the cache + resource-manager timers.
+        if (this.flushTimer.unref)
+            this.flushTimer.unref();
     }
     calculateMemoryUsage() {
         const stats = this.native.getStats();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/cor",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Native Rust acceleration for Brainy \u2014 SIMD distance, vector quantization, zero-copy mmap, native embeddings. Free tier for storage, Pro license for compute acceleration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -82,7 +82,7 @@
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.0.0",
-    "@soulcraft/brainy": "8.0.7",
+    "@soulcraft/brainy": "8.0.11",
     "@types/node": "^22.0.0",
     "pg": "^8.21.0",
     "tsx": "^4.21.0",