mnueron 0.5.0 → 0.6.1

package/INSTALL.md

@@ -66,6 +66,82 @@ Not detected:
 ✨ Done. Restart any running AI tool to load the memory plugin.
 ```
 
+For the published package, the same flow is:
+
+```bash
+npm install -g mnueron
+mnueron setup
+```
+
+Local mode is the default. No account, token, or cloud service is required, and
+your memories stay on your machine. Hosted/cloud mode is an explicit opt-in for
+users who want cross-machine sync or the hosted dashboard. When the user passes
+a hosted token, the setup wizard writes the hosted environment variables into
+each detected MCP config so Claude Desktop, Claude Code, Cursor, Windsurf, and
+Cline all talk to the same cloud memory store:
+
+```bash
+mnueron setup --hosted https://www.mnueron.com --token mnu_xxxxxxxxxxxx
+```
+
+Use `--namespace mnueron` or set `MNUERON_NAMESPACE=mnueron` when you want a
+general cross-project default namespace. Use project-specific namespaces such
+as `elevizio` only when you intentionally want that separation.
+
+### Manual MCP config fallback
+
+`mnueron setup` should be the normal path. Manual config is only needed when
+an IDE has not created its config folder yet, its MCP format changed, or you
+want to verify exactly what was written.
+
+Use this MCP server block, replacing the token with your own raw token:
+
+```json
+{
+  "mcpServers": {
+    "mnueron": {
+      "command": "node",
+      "args": [
+        "C:\\Mnueron\\Mnueron\\mnueron-v0.1.0\\mnueron\\dist\\index.js"
+      ],
+      "env": {
+        "MNUERON_API_URL": "https://www.mnueron.com",
+        "MNUERON_API_TOKEN": "mnu_xxxxxxxxxxxx",
+        "MNUERON_NAMESPACE": "mnueron"
+      }
+    }
+  }
+}
+```
+
+Common config locations:
+
+| Tool | Config file |
+| --- | --- |
+| Claude Desktop, Windows regular install | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Claude Desktop, Windows Store install | `%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json` |
+| Claude Desktop, macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Claude Code | `~/.claude/settings.json` |
+| Codex | `~/.codex/config.toml` |
+| Cursor | `~/.cursor/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+| Cline (VS Code) | `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json` |
+| Continue.dev | `~/.continue/config.json` or `~/.continue/config.yaml` |
+
+For Claude Code, prefer the official CLI when available:
+
+```bash
+claude mcp add --scope user \
+  -e MNUERON_API_URL="https://www.mnueron.com" \
+  -e MNUERON_API_TOKEN="mnu_xxxxxxxxxxxx" \
+  -e MNUERON_NAMESPACE="mnueron" \
+  mnueron -- node /absolute/path/to/mnueron/dist/index.js
+```
+
+After any manual edit, fully restart the IDE. For Claude Code, exit the
+current session with `/exit` and start a fresh one so it reloads the MCP tool
+list.
+
 ### Step 3 — Verify it works
 
 Restart Claude Desktop (or any AI tool that was configured). In a new chat,
@@ -227,6 +303,55 @@ Removes mnueron from every tool's MCP config. Your local memories at
   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - Look for a `mcpServers.mnueron` entry. If missing, re-run `setup`.
 
+**Codex doesn't see the memory tools after setup.**
+
+Codex reads `~/.codex/config.toml` **once at startup**, and on Windows it's an
+Electron multi-process app — closing the window does not kill the main process.
+That means a config edit (from `mnueron setup --only codex` or by hand) won't
+be picked up until every Codex process is killed and Codex is launched fresh.
+
+Quick check + force-restart on Windows (PowerShell):
+
+```powershell
+# 1. Confirm mnueron is registered in the config.
+Get-Content $HOME\.codex\config.toml | Select-String -Pattern "mnueron" -Context 0,6
+
+# 2. Kill every Codex process — GUI shell AND CLI helper.
+Get-Process | Where-Object { $_.ProcessName -ieq "codex" } | Stop-Process -Force
+
+# 3. Verify nothing is left.
+Get-Process | Where-Object { $_.ProcessName -ieq "codex" }
+
+# 4. Relaunch Codex normally. In a new chat, ask: "what MCP tools are loaded?"
+#    The mnueron tools (memory_save, memory_recall, memory_namespaces, …)
+#    should appear.
+```
+
+If the config block from step 1 looks right (`command = "…node.exe"`,
+`args = ["…\\dist\\index.js"]`) but Codex still shows no mnueron tools after a
+clean restart, check Codex's MCP log for spawn errors:
+
+```powershell
+Get-ChildItem $HOME\.codex\log -Recurse -ErrorAction SilentlyContinue |
+  Sort-Object LastWriteTime -Descending | Select-Object -First 1 |
+  Get-Content -Tail 60
+```
+
+You should see a line like `[mnueron] mode=local ns=default db=…` — that's the
+mnueron MCP server starting cleanly on stderr. If you see a stack trace
+instead, that's the real failure (usually a Node version older than 20, a
+broken `better-sqlite3` native binding, or a typo in the `args` path).
+
+To verify the mnueron MCP server itself is healthy independent of Codex, send
+it an `initialize` JSON-RPC frame on stdin:
+
+```powershell
+$req = '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}'
+$req | node "C:\Path\To\mnueron\dist\index.js" 2>$env:TEMP\mnueron.err
+```
+
+A healthy server prints a JSON object with `"serverInfo":{"name":"mnueron","version":"…"}` and writes only the banner to `$env:TEMP\mnueron.err`.
+
 **`mnueron setup` says "tool not detected" but the tool is installed.**
 - Run the tool once before setup so it creates its config directory.
 - For Cursor, the detector looks for `~/.cursor/` — open Cursor once if it's a fresh install.

package/LICENSE

@@ -1,21 +1,28 @@
-MIT License
-
-Copyright (c) 2026 MNUERON contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Mnueron
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software, EXCEPT for the contents of the
+`server/` and `dashboard-web/` directories, which are governed by
+[`server/LICENSE`](server/LICENSE) (FSL-1.1-Apache-2.0) and take precedence
+within those directories.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+----------------------------------------------------------------------
+This repository uses a split license model. See LICENSE-OVERVIEW.md for the
+plain-English version and NOTICE for trademark and hosted-platform carve-outs.

package/NOTICE

@@ -0,0 +1,164 @@
+Mnueron
+Copyright 2026 Mnueron
+
+This repository uses a split license model.
+
+  Default (everything not under server/ or dashboard-web/):
+    MIT License — see LICENSE
+
+  Hosted backend (server/ and future dashboard-web/):
+    Functional Source License 1.1, Apache 2.0 Future License (FSL-1.1-Apache-2.0)
+    See server/LICENSE
+    Each version auto-converts to Apache 2.0 two years after release.
+
+----------------------------------------------------------------------
+Mnueron Additional Notices
+----------------------------------------------------------------------
+
+Mnueron is an open-source memory infrastructure platform designed to
+provide persistent memory, context synchronization, semantic retrieval,
+and workflow intelligence for AI systems, agents, IDEs, and applications.
+
+The following are NOT granted under either license in this repository:
+
+- The Mnueron name
+- The Mnueron logo
+- Mnueron branding assets
+- Marketing materials
+- Website design/assets
+- Hosted Mnueron cloud services
+- Proprietary SaaS infrastructure
+- Commercial hosted synchronization platform
+
+"Mnueron", the Mnueron logo, and related branding are trademarks
+or registered trademarks of Mnueron.
+
+You may not use the Mnueron name, logo, or branding in a manner
+that implies endorsement, affiliation, or official association
+without prior written permission.
+
+----------------------------------------------------------------------
+Hosted-Features Carve-Out
+----------------------------------------------------------------------
+
+Some features that are conceptually part of the hosted Mnueron product
+surface may, for engineering reasons, touch files outside server/.
+For clarity, contributions that extend or modify the following
+hosted-product features are accepted under FSL-1.1-Apache-2.0 terms
+even when they live in client directories:
+
+- Multi-tenant plumbing (org scoping, tenant isolation helpers)
+- Row-Level Security (RLS) aware client patches
+- Billing hooks and Stripe integration glue
+- Audit log emitters that target the hosted backend
+- SSO / SAML / SCIM integration code that depends on the hosted
+  identity service
+- Telemetry on the hosted edge (rate limiting, quota enforcement,
+  hosted-tier metrics)
+- Hosted-only dashboard surfaces (when dashboard-web/ is built)
+
+This carve-out is narrow. If you are touching files under src/, sdks/,
+extension/, dashboard/, examples/, or scripts/ for any reason that is
+not directly implementing or supporting one of the items above, your
+contribution is under MIT.
+
+Contributors retain copyright to their respective contributions.
+
+By submitting a contribution to this repository, you agree that:
+
+1. Your contribution is licensed under MIT if it lives in client
+   directories, OR FSL-1.1-Apache-2.0 if it lives in server/ /
+   dashboard-web/ or extends a hosted-features carve-out item above.
+2. You have the legal right to submit the contribution.
+3. You grant Mnueron and its users the rights described under the
+   applicable license.
+
+See CLA.md for the formal Contributor License Agreement text.
+
+----------------------------------------------------------------------
+Privacy & Data Usage Notice
+----------------------------------------------------------------------
+
+Mnueron supports both local-only and hosted cloud modes.
+
+Local Mode:
+- Can operate entirely on the user's machine
+- May store memories locally using local databases
+- Does not require cloud synchronization
+
+Hosted Mode:
+- May synchronize memories across devices
+- May process encrypted or user-authorized data
+- May use third-party infrastructure providers
+
+Mnueron does NOT claim ownership of user memories,
+documents, prompts, or synchronized content.
+
+Users are responsible for ensuring they have the rights
+to process, store, or synchronize any content used
+with Mnueron.
+
+----------------------------------------------------------------------
+Third-Party Providers
+----------------------------------------------------------------------
+
+Mnueron may integrate with third-party AI providers,
+storage systems, databases, authentication providers,
+or APIs including but not limited to:
+
+- OpenAI
+- Anthropic
+- Google
+- Microsoft
+- AWS
+- Supabase
+- PostgreSQL
+- Vector database providers
+- IDE integrations
+- Browser integrations
+
+Use of those services is subject to their respective
+terms and privacy policies.
+
+----------------------------------------------------------------------
+Disclaimer
+----------------------------------------------------------------------
+
+Mnueron is provided "AS IS", without warranty of any kind.
+
+The authors and contributors shall not be liable for:
+
+- Data loss
+- AI-generated inaccuracies
+- Context corruption
+- Security incidents
+- Misuse of synchronized memories
+- Workflow interruptions
+- Financial or business damages
+- Third-party service failures
+
+Users are responsible for validating outputs generated
+through AI systems connected to Mnueron.
+
+----------------------------------------------------------------------
+Website & Hosted Platform
+----------------------------------------------------------------------
+
+Neither the MIT license (root LICENSE) nor the FSL (server/LICENSE)
+applies to the running hosted Mnueron platform, cloud synchronization
+service, website infrastructure, billing systems, analytics systems,
+or proprietary backend services. Those operate under separate
+commercial terms.
+
+----------------------------------------------------------------------
+Official Project
+----------------------------------------------------------------------
+
+Official Website:
+https://www.mnueron.com
+
+Official Repository:
+https://github.com/randi2160/mnueron
+
+Tagline:
+"Memory for every AI."