@knolo/cli 3.1.2 → 3.2.1

package/README.md

@@ -0,0 +1,125 @@
+# @knolo/cli
+
+The official CLI for building `.knolo` knowledge packs.
+
+It indexes structured content and produces a deterministic, local-first knowledge bundle for use with `@knolo/core`.
+
+---
+
+## 📦 Installation
+
+Global:
+
+```bash
+npm install -g @knolo/cli
+```
+
+Or use via npx:
+
+```bash
+npx knolo build
+```
+
+---
+
+## 🚀 Commands
+
+### Build a Knowledge Pack
+
+```bash
+knolo build
+```
+
+Indexes your configured content and outputs:
+
+```
+dist/knowledge.knolo
+```
+
+---
+
+## 📁 Expected Project Structure
+
+Example:
+
+```
+/knowledge
+  mobile.json
+  backend.json
+knolo.config.ts
+```
+
+---
+
+## ⚙️ knolo.config.ts Example
+
+```ts
+export default {
+  input: "./knowledge",
+  output: "./dist/knowledge.knolo"
+};
+```
+
+---
+
+## 🧱 What the CLI Does
+
+* Parses structured documents
+* Normalizes metadata
+* Indexes namespaces
+* Extracts agent routing profiles
+* Validates agent registry
+* Generates compact `.knolo` bundle
+
+All builds are deterministic.
+
+---
+
+## 🧠 Agent Features
+
+Phase 2 includes:
+
+* Routing profile extraction
+* Tool policy validation
+* Mount-time registry validation
+* Deterministic selection logic
+
+---
+
+## 🔍 Why No Embeddings?
+
+KnoLo intentionally avoids:
+
+* Vector databases
+* Similarity search
+* External inference APIs
+
+This ensures:
+
+* Reproducibility
+* Security
+* Low memory usage
+* Predictable results
+
+---
+
+## 🗺 Roadmap
+
+* Watch mode
+* Incremental indexing
+* Rust-powered build engine
+* WASM build output
+
+---
+
+## ClaimGraph section compatibility
+
+New `.knolo` packs may include an optional trailing **ClaimGraph** JSON section.
+This section is deterministic, offline-safe, and additive; runtimes that ignore trailing sections remain backward compatible.
+
+---
+
+## 📄 License
+
+MIT
+

package/bin/knolo.mjs

@@ -47,7 +47,10 @@ async function tryImport(filePath) {
 }
 
 async function loadCore() {
-  const candidates = ['@knolo/core', path.resolve(__dirname, '../../core/dist/index.js')];
+  const candidates = [
+    path.resolve(__dirname, '../../core/dist/index.js'),
+    '@knolo/core',
+  ];
   for (const candidate of candidates) {
     const mod = await tryImport(candidate);
     if (mod?.buildPack && mod?.mountPack && mod?.query) return mod;
@@ -278,7 +281,9 @@ async function cmdQuery(core, args) {
   const topK = opts.k !== undefined ? Number(opts.k) : (config.query?.topK ?? 5);
   if (!Number.isInteger(topK) || topK <= 0) throw createError('--k must be a positive integer.');
 
-  const kb = await core.mountPack({ src: packPath });
+  const packBuffer = readFileSync(packPath);
+  const bytes = Uint8Array.from(packBuffer);
+  const kb = await mountPackFromBytes(core, bytes);
   const hits = core.query(kb, question, { topK }).map((hit) => ({
     title: kb.headings?.[hit.blockId] || hit.source || `Block ${hit.blockId}`,
     source: hit.source || kb.docIds?.[hit.blockId] || 'unknown',
@@ -308,6 +313,14 @@ async function cmdQuery(core, args) {
   });
 }
 
+async function mountPackFromBytes(core, bytes) {
+  try {
+    return await core.mountPack({ bytes });
+  } catch {
+    return await core.mountPack({ src: bytes });
+  }
+}
+
 function listDirectoriesRecursively(root) {
   const dirs = [root];
   for (let i = 0; i < dirs.length; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knolo/cli",
-  "version": "3.1.2",
+  "version": "3.2.1",
   "type": "module",
   "bin": {
     "knolo": "bin/knolo.mjs"
@@ -13,7 +13,7 @@
     "test": "npm run build --prefix ../core && node --test test/cli.test.mjs"
   },
   "dependencies": {
-    "@knolo/core": "^3.1.2"
+    "@knolo/core": "^3.2.0"
   },
   "private": false
 }