@yamo/memory-mesh 3.0.1 → 3.0.3

package/README.md

@@ -27,10 +27,10 @@ npm install @yamo/memory-mesh
 
 ```bash
 # Store a memory (automatically scrubbed & embedded)
-memory-mesh store "My important memory" '{"tag":"test"}'
+memory-mesh store --content "My important memory" --type "insight" --rationale "Documentation upgrade"
 
 # Search memories
-memory-mesh search "query" 5
+memory-mesh search "query" --limit 5
 ```
 
 ### Node.js API
@@ -245,7 +245,7 @@ LANCEDB_URI=./data/lancedb
 
 # Embeddings (local default)
 EMBEDDING_MODEL_TYPE=local
-EMBEDDING_MODEL_NAME=Xenova/all-MiniLM-L6-v2
+EMBEDDING_MODEL_NAME=hf_ggml-org_embeddinggemma-300m-qat-Q8_0.gguf
 ```
 
 

package/bin/memory_mesh.js

@@ -1,14 +1,101 @@
 #!/usr/bin/env node
 
 /**
- * MemoryMesh CLI Entry Point
- * Delegates to the core CLI handler in lib/memory/memory-mesh.js
+ * YAMO MemoryMesh CLI - Protocol-Native Edition (v3.1.0)
+ * 
+ * Enforces the "Zero JSON" mandate by using standard CLI flags.
+ * Machines don't parse YAMO; they execute commands.
  */
 
-import { run } from '@yamo/memory-mesh';
+import { Command } from 'commander';
+import { MemoryMesh } from '../lib/memory/index.js';
+import { createLogger } from '../lib/utils/logger.js';
 
-// Execute the main CLI handler
-run().catch(err => {
-  console.error(`❌ Fatal Error: ${err.message}`);
-  process.exit(1);
-});
+const logger = createLogger('memory-mesh-cli');
+const program = new Command();
+
+program
+  .name('memory-mesh')
+  .description('Portable semantic memory subconscious for YAMO agents')
+  .version('3.1.0');
+
+// 1. Store/Ingest Command
+program
+  .command('store')
+  .alias('ingest')
+  .description('Persist a semantic memory')
+  .requiredOption('-c, --content <text>', 'The memory content')
+  .option('-t, --type <type>', 'Memory type (e.g., insight, decision, error)', 'event')
+  .option('-r, --rationale <text>', 'The constitutional rationale for this memory')
+  .option('-h, --hypothesis <text>', 'The associated hypothesis')
+  .option('--metadata <json>', 'Additional metadata (as flat flags or optional JSON)', '{}')
+  .action(async (options) => {
+    const mesh = new MemoryMesh();
+    try {
+      let metadata = {};
+      try {
+        metadata = JSON.parse(options.metadata);
+      } catch (_e) {
+        // Fallback to empty if invalid JSON
+      }
+      
+      if (options.type) metadata.type = options.type;
+      if (options.rationale) metadata.rationale = options.rationale;
+      if (options.hypothesis) metadata.hypothesis = options.hypothesis;
+      
+      const record = await mesh.add(options.content, metadata);
+      process.stdout.write(`[MemoryMesh] Ingested record ${record.id}\n`);
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    } finally {
+      await mesh.close();
+    }
+  });
+
+// 2. Search Command
+program
+  .command('search')
+  .description('Perform semantic recall')
+  .argument('<query>', 'The semantic search query')
+  .option('-l, --limit <number>', 'Number of results', '10')
+  .option('-f, --filter <string>', 'LanceDB SQL-style filter')
+  .action(async (query, options) => {
+    const mesh = new MemoryMesh();
+    try {
+      const results = await mesh.search(query, {
+        limit: parseInt(options.limit),
+        filter: options.filter || null
+      });
+      
+      process.stdout.write(`[MemoryMesh] Found ${results.length} matches.\n`);
+      process.stdout.write(mesh.formatResults(results));
+      process.stdout.write('\n');
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    } finally {
+      await mesh.close();
+    }
+  });
+
+// 3. Stats Command
+program
+  .command('stats')
+  .description('Get database health and statistics')
+  .action(async () => {
+    const mesh = new MemoryMesh();
+    try {
+      const stats = await mesh.stats();
+      process.stdout.write(`[MemoryMesh] Total Memories: ${stats.count}\n`);
+      process.stdout.write(`[MemoryMesh] DB Path: ${stats.uri}\n`);
+      process.stdout.write(`[MemoryMesh] Status: ${stats.isConnected ? 'Connected' : 'Disconnected'}\n`);
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    } finally {
+      await mesh.close();
+    }
+  });
+
+program.parse();

package/lib/memory/memory-mesh.d.ts

@@ -105,6 +105,18 @@ export declare class MemoryMesh {
         metadata: {};
         created_at: string;
     }>;
+    /**
+     * Semantic alias for add().
+     * @param content - The text content to store
+     * @param metadata - Optional metadata
+     * @returns Promise with memory record
+     */
+    ingest(content: any, metadata?: {}): Promise<{
+        id: any;
+        content: string;
+        metadata: {};
+        created_at: string;
+    }>;
     /**
      * Reflect on recent memories
      */

package/lib/memory/memory-mesh.js

@@ -437,6 +437,15 @@ export class MemoryMesh {
             throw error instanceof Error ? error : new Error(String(error));
         }
     }
+    /**
+     * Semantic alias for add().
+     * @param content - The text content to store
+     * @param metadata - Optional metadata
+     * @returns Promise with memory record
+     */
+    async ingest(content, metadata = {}) {
+        return this.add(content, metadata);
+    }
     /**
      * Reflect on recent memories
      */

package/lib/memory/memory-mesh.ts

@@ -437,6 +437,15 @@ export class MemoryMesh {
             throw error instanceof Error ? error : new Error(String(error));
         }
     }
+    /**
+     * Semantic alias for add().
+     * @param content - The text content to store
+     * @param metadata - Optional metadata
+     * @returns Promise with memory record
+     */
+    async ingest(content, metadata = {}) {
+        return this.add(content, metadata);
+    }
     /**
      * Reflect on recent memories
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yamo/memory-mesh",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "Portable semantic memory system with Layer 0 Scrubber for YAMO agents (v3 Singularity Edition)",
   "type": "module",
   "main": "lib/memory/index.js",
@@ -26,6 +26,7 @@
     "@lancedb/lancedb": "^0.23.0",
     "@xenova/transformers": "^2.17.0",
     "apache-arrow": "^17.0.0",
+    "commander": "^14.0.3",
     "onnxruntime-node": "^1.18.0",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3"