Add initial native Rust runtime (packages/core-rust) for mounting and querying .knolo packs

.gitignore

@@ -7,7 +7,6 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
-package-lock.json
 yarn.lock
 pnpm-lock.yaml
 

README.md

@@ -104,6 +104,26 @@ Hybrid semantic reranking is optional and **never replaces lexical grounding**.
 | `create-knolo-app`  | Next.js scaffolding with playground                       |
 | `@knolo/langchain`  | LangChain-style retriever interface                       |
 | `@knolo/llamaindex` | LlamaIndex-style retriever interface                      |
+| `knolo-core-rust`   | Native Rust pack mount + lexical query runtime            |
+
+---
+
+# 🦀 Rust Runtime Support (New)
+
+Knolo now includes an initial Rust runtime in `packages/core-rust`.
+
+Current Rust support includes:
+
+* Mounting `.knolo` packs from bytes
+* Parsing v1/v3-compatible core sections (`meta`, `lexicon`, `postings`, `blocks`)
+* Deterministic lexical querying with `top_k`, `min_score`, `namespace`, and `source` filters
+
+Run Rust tests:
+
+```bash
+cd packages/core-rust
+cargo test
+```
 
 ---
 

package.json

@@ -9,6 +9,7 @@
     "test": "npm run test --workspaces --if-present",
     "format": "npm run format --workspace @knolo/core",
     "format:check": "npm run format:check --workspace @knolo/core",
-    "knolo": "node ./packages/cli/bin/knolo.mjs"
+    "knolo": "node ./packages/cli/bin/knolo.mjs",
+    "test:rust": "cargo test --manifest-path packages/core-rust/Cargo.toml"
   }
 }

packages/core-rust/.gitignore

@@ -0,0 +1 @@
+/target

packages/core-rust/Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "knolo-core-rust"
+version = "0.1.0"
+edition = "2021"
+license = "Apache-2.0"
+description = "Rust runtime support for reading and querying .knolo packs"
+
+[lib]
+name = "knolo_core_rust"
+path = "src/lib.rs"

packages/core-rust/README.md

@@ -0,0 +1,36 @@
+# knolo-core-rust
+
+Native Rust runtime support for Knolo `.knolo` packs.
+
+## Included in this initial release
+
+- `mount_pack_from_bytes(&[u8]) -> Pack`
+- `query(&Pack, &str, QueryOptions) -> Vec<Hit>`
+- Pack parsing support for:
+  - `meta`
+  - `lexicon`
+  - `postings`
+  - `blocks` (legacy string array and v3 object array)
+
+## Example
+
+```rust
+use knolo_core_rust::{mount_pack_from_bytes, query, QueryOptions};
+
+let bytes: Vec<u8> = std::fs::read("knowledge.knolo")?;
+let pack = mount_pack_from_bytes(&bytes)?;
+
+let hits = query(
+    &pack,
+    "react native bridge throttling",
+    QueryOptions {
+        top_k: 5,
+        ..Default::default()
+    },
+);
+
+for hit in hits {
+    println!("{} => {}", hit.source.unwrap_or_default(), hit.score);
+}
+# Ok::<(), Box<dyn std::error::Error>>(())
+```