@mem-weave/server 0.3.3 → 0.3.5

package/dist/cli-entry.js

@@ -5,7 +5,18 @@
  * This file is the executable for the `memweave` bin command. It parses
  * argv, dispatches to the right command, and prints the result.
  */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 import { parseCli, runCli, CliError } from './cli.js';
+// Same fallback as bootstrap.ts: $MEMWEAVE_CONFIG > ~/.memweave/config.jsonc
+function resolveConfigPath() {
+    const explicit = process.env.MEMWEAVE_CONFIG;
+    if (explicit)
+        return explicit;
+    const fallback = join(homedir(), '.memweave', 'config.jsonc');
+    return existsSync(fallback) ? fallback : undefined;
+}
 async function main() {
     let parsed;
     try {
@@ -23,7 +34,7 @@ async function main() {
         command: parsed.command,
         args: parsed.args,
         env: process.env,
-        configPath: process.env.MEMWEAVE_CONFIG
+        configPath: resolveConfigPath()
     });
     // Print message + data
     if (result.message) {

package/dist/commands/doctor.js

@@ -76,7 +76,11 @@ export const doctorCommand = async (ctx) => {
     // 5. LLM
     if (config.llm.provider === 'openai-compatible') {
         const hasKey = Boolean(config.llm.apiKey);
-        results.push({ name: 'llm', ok: hasKey, detail: hasKey ? 'apiKey set' : 'apiKey missing' });
+        results.push({
+            name: 'llm',
+            ok: true,
+            detail: hasKey ? 'apiKey set' : 'configured (no apiKey → falls back to noop)'
+        });
     }
     else {
         results.push({ name: 'llm', ok: true, detail: 'noop' });

package/dist/commands/start.js

@@ -12,7 +12,7 @@ export const startCommand = async (ctx) => {
     // Lazy import to avoid pulling fastify in tests of the parser itself.
     const { createHttpServer } = await import('../server/http.js');
     const { startConsolidationScheduler } = await import('../server/scheduler.js');
-    const app = await createHttpServer({ dbPath });
+    const app = await createHttpServer({ dbPath, configPath: ctx.configPath });
     if (config.consolidation.enabled) {
         startConsolidationScheduler({
             dbPath,

package/dist/providers/llm/index.js

@@ -2,8 +2,15 @@ import { OpenaiLlmProvider } from './openai.js';
 import { NoopLlmProvider } from './noop.js';
 export function createLlmProvider(kind, config) {
     switch (kind) {
-        case 'openai-compatible':
-            return new OpenaiLlmProvider(config);
+        case 'openai-compatible': {
+            const provider = new OpenaiLlmProvider(config);
+            // Graceful degrade: openai-compatible without an apiKey is a noop.
+            // This keeps the "no external LLM required" guarantee while still
+            // letting users wire the provider in advance of having a key.
+            if (!provider.isConfigured)
+                return new NoopLlmProvider();
+            return provider;
+        }
         case 'noop':
             return new NoopLlmProvider();
         default:

package/dist/providers/llm/openai.js

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 const OpenaiConfigSchema = z.object({
     baseUrl: z.string().url().default('https://api.openai.com/v1'),
-    apiKey: z.string(),
+    // Optional: if missing/empty, the provider degrades to a noop (matches the
+    // "no external LLM required" boundary declared in src/providers/AGENTS.md).
+    apiKey: z.string().optional(),
     model: z.string().default('gpt-4o-mini'),
     temperature: z.number().min(0).max(2).default(0.2),
     maxTokens: z.number().int().positive().default(2048)
@@ -11,6 +13,10 @@ export class OpenaiLlmProvider {
     constructor(raw) {
         this.config = OpenaiConfigSchema.parse(raw);
     }
+    /** True only when a real remote endpoint is configured. */
+    get isConfigured() {
+        return typeof this.config.apiKey === 'string' && this.config.apiKey.length > 0;
+    }
     async call(systemPrompt, userPrompt) {
         try {
             const url = `${this.config.baseUrl.replace(/\/+$/, '')}/chat/completions`;

package/dist/server/bootstrap.js

@@ -1,8 +1,19 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 import { expandPath, loadConfig } from '../core/config.js';
 import { createHttpServer } from './http.js';
 import { startConsolidationScheduler } from './scheduler.js';
 import { logger } from './logger.js';
-const configPath = process.env.MEMWEAVE_CONFIG;
+// Resolution order for the config file:
+//   1. $MEMWEAVE_CONFIG (explicit override)
+//   2. ~/.memweave/config.jsonc (the default `memweave init` target)
+// Without step 2, a global `npm i -g @mem-weave/server` install would silently
+// fall back to schema defaults (llm/embedding = noop) and the user has no
+// signal that their config file was ignored.
+const explicit = process.env.MEMWEAVE_CONFIG;
+const fallback = join(homedir(), '.memweave', 'config.jsonc');
+const configPath = explicit ?? (existsSync(fallback) ? fallback : undefined);
 const config = loadConfig(configPath);
 const dbPath = expandPath(config.storage.path);
 const app = await createHttpServer({ dbPath, configPath });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mem-weave/server",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "MemWeave local-first memory infrastructure for AI agents: structured memory, 4-layer retrieval (BM25 + vector + graph + causal), token-budgeted injection, server-side write deduplication, and background consolidation. Server process: Fastify REST API + CLI.",
   "type": "module",
   "main": "./dist/cli-entry.js",