@aeriondyseti/vector-memory-mcp 2.0.0 → 2.1.1-dev.0

package/README.md

@@ -103,14 +103,45 @@ Assistant: [calls search_memories with history_only: true, history_before/after
 
 CLI flags:
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--db-file`, `-d` | `.vector-memory/memories.db` | Database location |
-| `--port`, `-p` | `3271` | HTTP server port |
-| `--no-http` | *(HTTP enabled)* | Disable HTTP/SSE transport |
-| `--enable-history` | *(disabled)* | Enable conversation history indexing |
-| `--history-path` | *(auto-detect)* | Path to session log directory |
-| `--history-weight` | `0.75` | Weight for history results in unified search |
+| Flag | Alias | Default | Description |
+|------|-------|---------|-------------|
+| `--db-file <path>` | `-d` | `.vector-memory/memories.db` | Database location (relative to cwd) |
+| `--port <number>` | `-p` | `3271` | HTTP server port |
+| `--no-http` | | *(HTTP enabled)* | Disable HTTP/SSE transport |
+| `--enable-history` | | *(disabled)* | Enable conversation history indexing |
+| `--history-path` | | *(auto-detect)* | Path to session log directory |
+| `--history-weight` | | `0.75` | Weight for history results in unified search |
+
+---
+
+## Release Channels
+
+The stable release is what you get by default:
+
+```bash
+bun install -g @aeriondyseti/vector-memory-mcp
+```
+
+Pre-release channels are available for testing upcoming changes. **These are unstable and may break without notice — use at your own risk.**
+
+| Channel | Install | Description |
+|---------|---------|-------------|
+| `@latest` | *(default)* | Stable releases |
+| `@rc` | `@aeriondyseti/vector-memory-mcp@rc` | Release candidates — final testing before stable |
+| `@dev` | `@aeriondyseti/vector-memory-mcp@dev` | Development builds — latest features, least stable |
+
+```bash
+# Install the dev channel
+bun install -g @aeriondyseti/vector-memory-mcp@dev
+
+# Pin to a specific pre-release version
+bun install -g @aeriondyseti/vector-memory-mcp@2.1.0-dev.1
+
+# Go back to stable
+bun install -g @aeriondyseti/vector-memory-mcp@latest
+```
+
+> **Warning:** Pre-release versions may include breaking changes, incomplete features, or data migration requirements that haven't been finalized. Do not use them in production workflows you depend on.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeriondyseti/vector-memory-mcp",
-  "version": "2.0.0",
+  "version": "2.1.1-dev.0",
   "description": "A zero-configuration RAG memory server for MCP clients",
   "type": "module",
   "main": "src/index.ts",

package/src/config/index.ts

@@ -59,10 +59,19 @@ export function loadConfig(overrides: ConfigOverrides = {}): Config {
   const enableHttp = overrides.enableHttp ?? true;
 
   return {
-    dbPath: resolvePath(overrides.dbPath ?? DEFAULT_DB_PATH),
+    dbPath: resolvePath(
+      overrides.dbPath
+      ?? process.env.VECTOR_MEMORY_DB_PATH
+      ?? DEFAULT_DB_PATH
+    ),
     embeddingModel: DEFAULT_EMBEDDING_MODEL,
     embeddingDimension: DEFAULT_EMBEDDING_DIMENSION,
-    httpPort: overrides.httpPort ?? DEFAULT_HTTP_PORT,
+    httpPort:
+      overrides.httpPort
+      ?? (process.env.VECTOR_MEMORY_HTTP_PORT
+        ? parseInt(process.env.VECTOR_MEMORY_HTTP_PORT, 10)
+        : undefined)
+      ?? DEFAULT_HTTP_PORT,
     httpHost: DEFAULT_HTTP_HOST,
     enableHttp,
     transportMode,

package/src/services/conversation.service.ts

@@ -9,6 +9,7 @@ import type {
   IndexedSession,
   ParsedMessage,
   SessionFileInfo,
+  SessionIndexDetail,
 } from "../types/conversation.js";
 import type { ConversationHistoryConfig } from "../config/index.js";
 import { resolveSessionLogPath } from "../config/index.js";
@@ -175,12 +176,18 @@ export class ConversationHistoryService {
   async indexConversations(
     path?: string,
     since?: Date
-  ): Promise<{ indexed: number; skipped: number; errors: string[] }> {
+  ): Promise<{
+    indexed: number;
+    skipped: number;
+    errors: string[];
+    details: SessionIndexDetail[];
+  }> {
     if (!this.config.enabled) {
       return {
         indexed: 0,
         skipped: 0,
         errors: ["Conversation history indexing is not enabled"],
+        details: [],
       };
     }
 
@@ -190,6 +197,7 @@ export class ConversationHistoryService {
         indexed: 0,
         skipped: 0,
         errors: ["No session log path configured or detected"],
+        details: [],
       };
     }
 
@@ -203,39 +211,48 @@ export class ConversationHistoryService {
     let indexed = 0;
     let skipped = 0;
     const errors: string[] = [];
+    const details: SessionIndexDetail[] = [];
 
     for (const file of sessionFiles) {
       const existing = indexState.get(file.sessionId);
       if (existing && existing.lastModified >= file.lastModified.getTime()) {
         skipped++;
+        details.push({ sessionId: file.sessionId, project: file.project, status: "skipped" });
         continue;
       }
 
       try {
-        await this.indexSession(file, indexState);
+        const state = await this.indexSession(file, indexState);
         indexed++;
+        details.push({
+          sessionId: file.sessionId,
+          project: file.project,
+          status: "indexed",
+          chunks: state.chunkCount,
+          messages: state.messageCount,
+        });
       } catch (err) {
-        errors.push(
-          `${file.sessionId}: ${err instanceof Error ? err.message : String(err)}`
-        );
+        const message = err instanceof Error ? err.message : String(err);
+        errors.push(`${file.sessionId}: ${message}`);
+        details.push({ sessionId: file.sessionId, project: file.project, status: "error", error: message });
       }
     }
 
     await this.saveIndexState(indexState);
-    return { indexed, skipped, errors };
+    return { indexed, skipped, errors, details };
   }
 
   private async indexSession(
     file: SessionFileInfo,
     indexState: Map<string, IndexedSession>
-  ): Promise<void> {
+  ): Promise<IndexedSession> {
     const messages = await this.parser.parse(
       file.filePath,
       this.config.indexSubagents
     );
     if (messages.length === 0) {
       // Still track it so we don't re-attempt
-      indexState.set(file.sessionId, {
+      const session: IndexedSession = {
         sessionId: file.sessionId,
         filePath: file.filePath,
         project: file.project,
@@ -245,8 +262,9 @@ export class ConversationHistoryService {
         indexedAt: new Date(),
         firstMessageAt: file.lastModified,
         lastMessageAt: file.lastModified,
-      });
-      return;
+      };
+      indexState.set(file.sessionId, session);
+      return session;
     }
 
     const chunks = chunkMessages(
@@ -280,7 +298,7 @@ export class ConversationHistoryService {
     await this.repository.insertBatch(rows);
 
     // Update index state
-    indexState.set(file.sessionId, {
+    const session: IndexedSession = {
       sessionId: file.sessionId,
       filePath: file.filePath,
       project: file.project,
@@ -290,7 +308,9 @@ export class ConversationHistoryService {
       indexedAt: new Date(),
       firstMessageAt: messages[0].timestamp,
       lastMessageAt: messages[messages.length - 1].timestamp,
-    });
+    };
+    indexState.set(file.sessionId, session);
+    return session;
   }
 
   async reindexSession(

package/src/types/conversation.ts

@@ -90,6 +90,19 @@ export interface SessionFileInfo {
   lastModified: Date;
 }
 
+/** Outcome status for a single session during indexing */
+export type IndexStatus = "indexed" | "skipped" | "error";
+
+/** Per-session detail returned from indexConversations */
+export interface SessionIndexDetail {
+  sessionId: string;
+  project: string;
+  status: IndexStatus;
+  chunks?: number;
+  messages?: number;
+  error?: string;
+}
+
 /** Search filter options for conversation history */
 export interface HistoryFilters {
   sessionId?: string;