memorix 1.4.6 → 1.5.0

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.5.0] - 2026-08-14
+
+### Added
+- **Stability stress suite** -- Five deterministic, offline stress exams now
+  run in the normal test suite: a 2,000-observation corpus (planted needles,
+  ranked determinism, project isolation), 60-way parallel writes plus
+  20-way same-topic upserts, session churn across projects with parallel
+  starts, 300-record long-term maintenance exactness, and repeated CLI
+  invocations. Live embedding stress exams are env-gated
+  (`MEMORIX_RUN_LIVE_EMBEDDING_TESTS=1`) and never run in CI.
+- **Provider-aware embedding default** -- When the embedding base URL
+  points at OpenRouter and no model is configured, the default is now
+  `qwen/qwen3-embedding-8b` (4096 dimensions) instead of the OpenAI-only
+  default. An explicitly configured model always wins.
+
+### Changed
+- **Verified OpenRouter embedding lane** -- The `api` embedding provider
+  was exercised live against `qwen/qwen3-embedding-8b` on OpenRouter:
+  a 100-text batch, cache round-trip, and provider-singleton stability all
+  pass. Docs cover the env-var form and borrowing `OPENROUTER_API_KEY`.
+- **Multimodal vision option documented** -- Image analysis can run on the
+  LLM lane through an OpenAI-compatible vision endpoint, including
+  OpenRouter models such as `qwen/qwen3-vl-8b-instruct`.
+
 ## [1.4.6] - 2026-08-14
 
 ### Added

package/dist/cli/index.js

@@ -3221,7 +3221,7 @@ ${import_picocolors.default.gray(m3)}  ${s4}
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.4.6" : pkg.version;
+  return true ? "1.5.0" : pkg.version;
 }
 var init_version = __esm({
   "src/cli/version.ts"() {
@@ -21713,6 +21713,7 @@ var init_resolved_config = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  defaultEmbeddingModelFor: () => defaultEmbeddingModelFor,
   getAgentLLMApiKey: () => getAgentLLMApiKey,
   getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
   getAgentLLMModel: () => getAgentLLMModel,
@@ -21775,7 +21776,19 @@ function getEmbeddingBaseUrl() {
   return getResolvedEmbeddingLane().baseUrl || "https://api.openai.com/v1";
 }
 function getEmbeddingModel() {
-  return getResolvedEmbeddingLane().model || "text-embedding-3-small";
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+function defaultEmbeddingModelFor(baseUrl, explicitModel) {
+  if (explicitModel) return explicitModel;
+  try {
+    const url2 = baseUrl ? new URL(baseUrl) : null;
+    if (url2 && (url2.hostname === "openrouter.ai" || url2.hostname.endsWith(".openrouter.ai"))) {
+      return "qwen/qwen3-embedding-8b";
+    }
+  } catch {
+  }
+  return "text-embedding-3-small";
 }
 function getEmbeddingDimensions() {
   return getResolvedEmbeddingLane().dimensions ?? null;
@@ -258695,7 +258708,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.4.6" : "1.0.1"
+    version: true ? "1.5.0" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {

package/dist/index.js

@@ -3373,6 +3373,7 @@ var init_resolved_config = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  defaultEmbeddingModelFor: () => defaultEmbeddingModelFor,
   getAgentLLMApiKey: () => getAgentLLMApiKey,
   getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
   getAgentLLMModel: () => getAgentLLMModel,
@@ -3435,7 +3436,19 @@ function getEmbeddingBaseUrl() {
   return getResolvedEmbeddingLane().baseUrl || "https://api.openai.com/v1";
 }
 function getEmbeddingModel() {
-  return getResolvedEmbeddingLane().model || "text-embedding-3-small";
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+function defaultEmbeddingModelFor(baseUrl, explicitModel) {
+  if (explicitModel) return explicitModel;
+  try {
+    const url = baseUrl ? new URL(baseUrl) : null;
+    if (url && (url.hostname === "openrouter.ai" || url.hostname.endsWith(".openrouter.ai"))) {
+      return "qwen/qwen3-embedding-8b";
+    }
+  } catch {
+  }
+  return "text-embedding-3-small";
 }
 function getEmbeddingDimensions() {
   return getResolvedEmbeddingLane().dimensions ?? null;
@@ -165821,7 +165834,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.4.6" : "1.0.1"
+    version: true ? "1.5.0" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
@@ -170200,7 +170213,7 @@ var init_serve_shared = __esm({
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.4.6" : pkg.version;
+  return true ? "1.5.0" : pkg.version;
 }
 var init_version3 = __esm({
   "src/cli/version.ts"() {

package/dist/maintenance-runner.js

@@ -1868,6 +1868,7 @@ var init_resolved_config = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  defaultEmbeddingModelFor: () => defaultEmbeddingModelFor,
   getAgentLLMApiKey: () => getAgentLLMApiKey,
   getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
   getAgentLLMModel: () => getAgentLLMModel,
@@ -1930,7 +1931,19 @@ function getEmbeddingBaseUrl() {
   return getResolvedEmbeddingLane().baseUrl || "https://api.openai.com/v1";
 }
 function getEmbeddingModel() {
-  return getResolvedEmbeddingLane().model || "text-embedding-3-small";
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+function defaultEmbeddingModelFor(baseUrl, explicitModel) {
+  if (explicitModel) return explicitModel;
+  try {
+    const url = baseUrl ? new URL(baseUrl) : null;
+    if (url && (url.hostname === "openrouter.ai" || url.hostname.endsWith(".openrouter.ai"))) {
+      return "qwen/qwen3-embedding-8b";
+    }
+  } catch {
+  }
+  return "text-embedding-3-small";
 }
 function getEmbeddingDimensions() {
   return getResolvedEmbeddingLane().dimensions ?? null;

package/dist/media-audio-runner.js

@@ -3124,6 +3124,7 @@ var init_resolved_config = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  defaultEmbeddingModelFor: () => defaultEmbeddingModelFor,
   getAgentLLMApiKey: () => getAgentLLMApiKey,
   getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
   getAgentLLMModel: () => getAgentLLMModel,
@@ -3186,7 +3187,19 @@ function getEmbeddingBaseUrl() {
   return getResolvedEmbeddingLane().baseUrl || "https://api.openai.com/v1";
 }
 function getEmbeddingModel() {
-  return getResolvedEmbeddingLane().model || "text-embedding-3-small";
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+function defaultEmbeddingModelFor(baseUrl, explicitModel) {
+  if (explicitModel) return explicitModel;
+  try {
+    const url = baseUrl ? new URL(baseUrl) : null;
+    if (url && (url.hostname === "openrouter.ai" || url.hostname.endsWith(".openrouter.ai"))) {
+      return "qwen/qwen3-embedding-8b";
+    }
+  } catch {
+  }
+  return "text-embedding-3-small";
 }
 function getEmbeddingDimensions() {
   return getResolvedEmbeddingLane().dimensions ?? null;

package/dist/media-video-runner.js

@@ -2141,6 +2141,7 @@ var init_resolved_config = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  defaultEmbeddingModelFor: () => defaultEmbeddingModelFor,
   getAgentLLMApiKey: () => getAgentLLMApiKey,
   getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
   getAgentLLMModel: () => getAgentLLMModel,
@@ -2203,7 +2204,19 @@ function getEmbeddingBaseUrl() {
   return getResolvedEmbeddingLane().baseUrl || "https://api.openai.com/v1";
 }
 function getEmbeddingModel() {
-  return getResolvedEmbeddingLane().model || "text-embedding-3-small";
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+function defaultEmbeddingModelFor(baseUrl, explicitModel) {
+  if (explicitModel) return explicitModel;
+  try {
+    const url = baseUrl ? new URL(baseUrl) : null;
+    if (url && (url.hostname === "openrouter.ai" || url.hostname.endsWith(".openrouter.ai"))) {
+      return "qwen/qwen3-embedding-8b";
+    }
+  } catch {
+  }
+  return "text-embedding-3-small";
 }
 function getEmbeddingDimensions() {
   return getResolvedEmbeddingLane().dimensions ?? null;

package/dist/memcode-runtime/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.5.0] - 2026-08-14
+
+### Added
+- **Stability stress suite** -- Five deterministic, offline stress exams now
+  run in the normal test suite: a 2,000-observation corpus (planted needles,
+  ranked determinism, project isolation), 60-way parallel writes plus
+  20-way same-topic upserts, session churn across projects with parallel
+  starts, 300-record long-term maintenance exactness, and repeated CLI
+  invocations. Live embedding stress exams are env-gated
+  (`MEMORIX_RUN_LIVE_EMBEDDING_TESTS=1`) and never run in CI.
+- **Provider-aware embedding default** -- When the embedding base URL
+  points at OpenRouter and no model is configured, the default is now
+  `qwen/qwen3-embedding-8b` (4096 dimensions) instead of the OpenAI-only
+  default. An explicitly configured model always wins.
+
+### Changed
+- **Verified OpenRouter embedding lane** -- The `api` embedding provider
+  was exercised live against `qwen/qwen3-embedding-8b` on OpenRouter:
+  a 100-text batch, cache round-trip, and provider-singleton stability all
+  pass. Docs cover the env-var form and borrowing `OPENROUTER_API_KEY`.
+- **Multimodal vision option documented** -- Image analysis can run on the
+  LLM lane through an OpenAI-compatible vision endpoint, including
+  OpenRouter models such as `qwen/qwen3-vl-8b-instruct`.
+
 ## [1.4.6] - 2026-08-14
 
 ### Added

package/dist/sdk.js

@@ -3377,6 +3377,7 @@ var init_resolved_config = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  defaultEmbeddingModelFor: () => defaultEmbeddingModelFor,
   getAgentLLMApiKey: () => getAgentLLMApiKey,
   getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
   getAgentLLMModel: () => getAgentLLMModel,
@@ -3439,7 +3440,19 @@ function getEmbeddingBaseUrl() {
   return getResolvedEmbeddingLane().baseUrl || "https://api.openai.com/v1";
 }
 function getEmbeddingModel() {
-  return getResolvedEmbeddingLane().model || "text-embedding-3-small";
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+function defaultEmbeddingModelFor(baseUrl, explicitModel) {
+  if (explicitModel) return explicitModel;
+  try {
+    const url = baseUrl ? new URL(baseUrl) : null;
+    if (url && (url.hostname === "openrouter.ai" || url.hostname.endsWith(".openrouter.ai"))) {
+      return "qwen/qwen3-embedding-8b";
+    }
+  } catch {
+  }
+  return "text-embedding-3-small";
 }
 function getEmbeddingDimensions() {
   return getResolvedEmbeddingLane().dimensions ?? null;
@@ -165629,7 +165642,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.4.6" : "1.0.1"
+    version: true ? "1.5.0" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {

package/dist/vector-backfill-runner.js

@@ -2141,6 +2141,7 @@ var init_resolved_config = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  defaultEmbeddingModelFor: () => defaultEmbeddingModelFor,
   getAgentLLMApiKey: () => getAgentLLMApiKey,
   getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
   getAgentLLMModel: () => getAgentLLMModel,
@@ -2203,7 +2204,19 @@ function getEmbeddingBaseUrl() {
   return getResolvedEmbeddingLane().baseUrl || "https://api.openai.com/v1";
 }
 function getEmbeddingModel() {
-  return getResolvedEmbeddingLane().model || "text-embedding-3-small";
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+function defaultEmbeddingModelFor(baseUrl, explicitModel) {
+  if (explicitModel) return explicitModel;
+  try {
+    const url = baseUrl ? new URL(baseUrl) : null;
+    if (url && (url.hostname === "openrouter.ai" || url.hostname.endsWith(".openrouter.ai"))) {
+      return "qwen/qwen3-embedding-8b";
+    }
+  } catch {
+  }
+  return "text-embedding-3-small";
 }
 function getEmbeddingDimensions() {
   return getResolvedEmbeddingLane().dimensions ?? null;

package/docs/CONFIGURATION.md

@@ -180,6 +180,18 @@ Then set `OPENROUTER_API_KEY` in your shell, user environment, or `.env`. You
 can still set `MEMORIX_EMBEDDING_API_KEY` when you want an explicit embedding
 key override; it takes priority over `OPENROUTER_API_KEY`.
 
+When `base_url` points at OpenRouter and no `model` is configured, Memorix
+defaults to `qwen/qwen3-embedding-8b` (4096 dimensions) instead of the
+OpenAI-only default. The equivalent env-var form is
+`MEMORIX_EMBEDDING=api`, `MEMORIX_EMBEDDING_BASE_URL=https://openrouter.ai/api/v1`,
+`MEMORIX_EMBEDDING_MODEL=qwen/qwen3-embedding-8b`.
+
+Image analysis (visual description for ingested images) runs on the LLM lane
+through an OpenAI-compatible vision endpoint, so it can also use OpenRouter
+with a multimodal model — for example `qwen/qwen3-vl-8b-instruct` via
+`MEMORIX_LLM_BASE_URL=https://openrouter.ai/api/v1` and
+`MEMORIX_LLM_MODEL=qwen/qwen3-vl-8b-instruct`.
+
 ### Controlled MiniMax media
 
 MiniMax generation is separate from the text embedding lane. Set one of these

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorix",
   "mcpName": "io.github.AVIDS2/memorix",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,

package/plugins/claude/memorix/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memorix",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Local-first project memory for CodeBuddy Code and other coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codex/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Shared workspace memory for Codex and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/copilot/memorix/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Shared local workspace memory for GitHub Copilot CLI and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/gemini/memorix/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Memorix shared workspace memory package for Oh-my-Pi.",
   "license": "Apache-2.0",
   "keywords": [

package/plugins/openclaw/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Shared workspace memory for OpenClaw and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/pi/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-pi-package",
-  "version": "1.4.6",
+  "version": "1.5.0",
   "description": "Memorix shared workspace memory package for Pi coding agent.",
   "license": "Apache-2.0",
   "keywords": [

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/AVIDS2/memorix",
     "source": "github"
   },
-  "version": "1.4.6",
+  "version": "1.5.0",
   "websiteUrl": "https://github.com/AVIDS2/memorix#readme",
   "icons": [
     {
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "memorix",
-      "version": "1.4.6",
+      "version": "1.5.0",
       "runtimeHint": "npx",
       "packageArguments": [
         {

package/src/config.ts

@@ -84,9 +84,30 @@ export function getEmbeddingBaseUrl(): string {
   return getResolvedEmbeddingLane().baseUrl || 'https://api.openai.com/v1';
 }
 
-/** Embedding model: env > memorix.yml > config.json > default */
+/** Embedding model: env > memorix.yml > config.json > provider-aware default */
 export function getEmbeddingModel(): string {
-  return getResolvedEmbeddingLane().model || 'text-embedding-3-small';
+  const lane = getResolvedEmbeddingLane();
+  return defaultEmbeddingModelFor(lane.baseUrl, lane.model);
+}
+
+/**
+ * Provider-aware embedding model default: OpenRouter serves many providers,
+ * and the OpenAI-only default does not fit it. Qwen3-Embedding-8B is a
+ * strong multilingual default there; everywhere else keep the OpenAI model.
+ * An explicitly configured model always wins.
+ */
+export function defaultEmbeddingModelFor(
+  baseUrl: string | undefined,
+  explicitModel: string | undefined,
+): string {
+  if (explicitModel) return explicitModel;
+  try {
+    const url = baseUrl ? new URL(baseUrl) : null;
+    if (url && (url.hostname === 'openrouter.ai' || url.hostname.endsWith('.openrouter.ai'))) {
+      return 'qwen/qwen3-embedding-8b';
+    }
+  } catch { /* treat unparsable base URLs as non-OpenRouter */ }
+  return 'text-embedding-3-small';
 }
 
 /** Embedding dimensions override: env > memorix.yml > config.json > null (auto-detect) */