mnemosyne-core 2.1.1 → 2.1.3

package/README.md

@@ -112,10 +112,10 @@ import { MnemosyneClient } from 'mnemosyne-core/sdk';
 const client = new MnemosyneClient({ baseUrl: 'http://localhost:7321' });
 
 // Create a project
-const { project } = await client.createProject({ name: 'Work Notes' });
+const project = await client.createProject({ name: 'Work Notes' });
 
 // Create an atom (a note)
-const { atom } = await client.createAtom({
+const atom = await client.createAtom({
   project_id: project.id,
   title: 'Meeting Notes',
   type: 'text',

package/WORKING_EXAMPLE.md

@@ -0,0 +1,126 @@
+# Mnemosyne — Working Example
+
+Copy-paste runnable code. Every line below has been tested against a live server.
+
+## Quick Start
+
+```bash
+npm install -g mnemosyne-core
+mnemosyne init --data-dir ./data
+mnemosyne start --data-dir ./data
+# In another terminal, run the examples below
+```
+
+## Naming Guide
+
+| Mnemosyne Term | What It Means |
+|---|---|
+| **Project** | A folder/workspace (e.g. "Work", "Personal") |
+| **Atom** | A note, idea, or document |
+| **Block** | A paragraph, snippet, or file attachment inside an atom |
+| **Bond** | A link or relationship between two atoms |
+
+## SDK Example
+
+```typescript
+import { MnemosyneClient } from 'mnemosyne-core/sdk';
+
+const client = new MnemosyneClient({ baseUrl: 'http://localhost:7321' });
+
+async function demo() {
+  // Health check
+  const health = await client.health();
+  console.log('Version:', health.version);
+
+  // Create a project
+  const project = await client.createProject({ name: 'My Project' });
+  console.log('Project:', project.id);
+
+  // Create an atom (a note)
+  const atom = await client.createAtom({
+    project_id: project.id,
+    title: 'Hello World',
+    type: 'text',
+  });
+  console.log('Atom:', atom.id, atom.title);
+
+  // Add a content block
+  const block = await client.createBlock(atom.id, {
+    type: 'text',
+    content: 'This is my first note in Mnemosyne.',
+  });
+  console.log('Block:', block.id);
+
+  // Search by keyword
+  const results = await client.searchKeyword('first note');
+  console.log('Found:', results.count, 'results');
+
+  // Create a second atom and bond them
+  const atom2 = await client.createAtom({
+    project_id: project.id,
+    title: 'Related Idea',
+    type: 'text',
+  });
+  const bond = await client.createBond(atom.id, { target_id: atom2.id, label: 'relates to' });
+  console.log('Bond:', bond.id);
+
+  // List bonds
+  const bonds = await client.listBonds(atom.id);
+  console.log('Bonds:', bonds.length);
+
+  // Cleanup
+  await client.deleteAtom(atom.id);
+  await client.deleteAtom(atom2.id);
+  await client.deleteProject(project.id);
+}
+
+demo().catch(console.error);
+```
+
+## Raw Fetch Example
+
+If you prefer `fetch` over the SDK:
+
+```typescript
+const BASE = 'http://localhost:7321/api/v1';
+
+async function fetchDemo() {
+  // Health
+  const health = await fetch(`${BASE}/health`).then(r => r.json());
+  console.log(health);
+
+  // Create project
+  const project = await fetch(`${BASE}/projects`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ name: 'Demo' }),
+  }).then(r => r.json());
+  console.log(project);
+
+  // Create atom
+  const atom = await fetch(`${BASE}/atoms`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ project_id: project.project.id, title: 'Note', type: 'text' }),
+  }).then(r => r.json());
+  console.log(atom);
+}
+
+fetchDemo().catch(console.error);
+```
+
+## CLI One-Liners
+
+```bash
+# Start with dashboard + MCP SSE
+mnemosyne start --data-dir ./data
+
+# Start stdio mode for Claude Desktop
+mnemosyne start --data-dir ./data --mcp-transport stdio
+
+# Export a project to Markdown
+mnemosyne export --project "My Project" --format markdown --data-dir ./data
+
+# Run diagnostics
+mnemosyne doctor --data-dir ./data
+```

package/dist/cli/index.js

@@ -3635,7 +3635,7 @@ function getVersion() {
       const pkg = JSON.parse(readFileSync8(resolve14(process.cwd(), "package.json"), "utf-8"));
       return pkg.version;
     } catch {
-      return "2.1.0";
+      return "2.1.3";
     }
   }
 }
@@ -7599,7 +7599,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "mnemosyne-core",
-      version: "2.1.1",
+      version: "2.1.3",
       description: "Unified memory engine for AI agents \u2014 graph atoms, semantic search, and collaborative memory",
       logo: "logo.png",
       author: "Arman Aslanyan <aslanyanarman88@gmail.com> (https://www.linkedin.com/in/arman-aslanyan/)",
@@ -7637,7 +7637,9 @@ var require_package = __commonJS({
         }
       },
       files: [
-        "dist"
+        "dist",
+        "README.md",
+        "WORKING_EXAMPLE.md"
       ],
       scripts: {
         start: "node dist/cli/index.js",
@@ -8945,7 +8947,7 @@ function getVersion2() {
       const pkg = JSON.parse(readFileSync8(resolve14(process.cwd(), "package.json"), "utf-8"));
       return pkg.version;
     } catch {
-      return "2.1.0";
+      return "2.1.3";
     }
   }
 }
@@ -9543,7 +9545,7 @@ function getVersion3() {
       const pkg = JSON.parse(readFileSync8(resolve14(process.cwd(), "package.json"), "utf-8"));
       return pkg.version;
     } catch {
-      return "2.1.0";
+      return "2.1.3";
     }
   }
 }
@@ -10678,7 +10680,7 @@ var PKG_VERSION = (() => {
     const pkg = JSON.parse(require("fs").readFileSync(require("path").resolve(__dirname, "../../package.json"), "utf-8"));
     return pkg.version;
   } catch {
-    return "2.1.0";
+    return "2.1.3";
   }
 })();
 function handleHealth(store, pathname, method, res) {
@@ -11002,7 +11004,7 @@ var MnemosyneServer = class {
       const wss = new import_websocket_server.default({ server: this.httpServer });
       this.wsHandler = new WebSocketHandler(wss, this.store);
     }
-    const version = cfg?.server?.version || "2.1.0";
+    const version = cfg?.server?.version || "2.1.3";
     this.httpServer.listen(port, () => {
       console.log(`Mnemosyne v${version} \u2014 port ${port}`);
       console.log(`Dashboard: http://${host}:${port}/dashboard`);
@@ -11060,7 +11062,7 @@ function getVersion4() {
     const { resolve: resolve14 } = require("path");
     return JSON.parse(readFileSync8(resolve14(__dirname, "../../package.json"), "utf-8")).version;
   } catch {
-    return "2.1.0";
+    return "2.1.3";
   }
 }
 async function startCommand(options) {
@@ -11352,7 +11354,7 @@ program2.name("mnemosyne").description("Mnemosyne \u2014 Your exocortex").versio
   try {
     return require_package().version;
   } catch {
-    return "2.1.0";
+    return "2.1.3";
   }
 })());
 program2.command("init").description("Initialize a new Mnemosyne workspace").option("-d, --data-dir <path>", "Data directory", "./data").option("-c, --config <path>", "Config file path").action(initCommand);