mnemosyne-core 2.1.1 → 2.1.2

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

@@ -7599,7 +7599,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "mnemosyne-core",
-      version: "2.1.1",
+      version: "2.1.2",
       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",