@prmichaelsen/remember-mcp 3.14.18 → 3.14.19

package/.github/workflows/bump-remember-core.yml

@@ -0,0 +1,48 @@
+name: Bump remember-core
+
+on:
+  repository_dispatch:
+    types: [dependency-update]
+
+jobs:
+  bump:
+    if: github.event.client_payload.package == '@prmichaelsen/remember-core'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: mainline
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Bump remember-core
+        run: npm install @prmichaelsen/remember-core@${{ github.event.client_payload.version }} --save
+
+      - name: Bump package version
+        id: bump
+        run: |
+          CURRENT=$(node -p "require('./package.json').version")
+          NEW=$(echo "$CURRENT" | awk -F. '{print $1"."$2"."$3+1}')
+          npm version "$NEW" --no-git-tag-version
+          echo "version=$NEW" >> "$GITHUB_OUTPUT"
+
+      - name: Commit and tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add package.json package-lock.json
+          git commit -m "bump: remember core"
+          git commit --allow-empty -m "${{ steps.bump.outputs.version }}"
+          git tag "v${{ steps.bump.outputs.version }}"
+          git push --follow-tags
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Summary
+        run: echo "Bumped remember-core to ${{ github.event.client_payload.version }}, published remember-mcp@${{ steps.bump.outputs.version }}"

package/agent/progress.yaml

@@ -1070,11 +1070,21 @@ tasks:
       notes: |
         Static imports for ghost-config and access-control
 
+  unassigned:
+    - id: task-201
+      name: Auto-bump remember-core via GitHub Actions
+      status: not_started
+      file: agent/tasks/unassigned/task-201-auto-bump-remember-core-ci.md
+      estimated_hours: 2
+      notes: |
+        Set up repository_dispatch CI/CD: remember-core publish triggers remember-mcp bump + publish.
+        Draft workflow files already created in both repos (not yet committed).
+
 documentation:
   design_documents: 31
   milestone_documents: 14
   pattern_documents: 7
-  task_documents: 91
+  task_documents: 92
 
 progress:
   planning: 100%

package/agent/tasks/unassigned/task-201-auto-bump-remember-core-ci.md

@@ -0,0 +1,85 @@
+# Task 201: Auto-bump remember-core via GitHub Actions
+
+**Milestone**: Unassigned
+**Estimated Time**: 1-2 hours
+**Dependencies**: None
+**Status**: Not Started
+
+---
+
+## Objective
+
+Set up GitHub Actions CI/CD so that when remember-core publishes a new version to npm, remember-mcp automatically bumps the dependency, patches its own version, and publishes to npm.
+
+---
+
+## Context
+
+Currently, bumping remember-core in remember-mcp is a manual process: update package.json, commit, tag, publish. This happens frequently (almost every remember-core release). Automating this eliminates toil and reduces lag between core changes and MCP availability.
+
+The approach uses `repository_dispatch` events: remember-core's publish workflow notifies remember-mcp after a successful npm publish, and remember-mcp's workflow handles the bump + publish.
+
+---
+
+## Steps
+
+### 1. Configure GitHub Secrets
+
+Add required secrets to both repositories:
+
+- **remember-core**: `REPO_DISPATCH_TOKEN` - a GitHub PAT with `repo` scope (to trigger dispatches on remember-mcp)
+- **remember-mcp**: `NPM_TOKEN` - an npm access token for publishing
+
+### 2. Add dispatch step to remember-core publish workflow
+
+File: `remember-core/.github/workflows/publish.yml`
+
+A "Notify remember-mcp" step has been drafted that sends a `repository_dispatch` event after successful npm publish. Review and merge.
+
+### 3. Add bump workflow to remember-mcp
+
+File: `remember-mcp/.github/workflows/bump-remember-core.yml`
+
+A workflow has been drafted that:
+- Triggers on `repository_dispatch` with `dependency-update` type
+- Filters to `@prmichaelsen/remember-core` events
+- Installs the new version
+- Patch-bumps remember-mcp version
+- Commits (`bump: remember core` then `{version}`)
+- Tags and pushes
+- Publishes to npm
+
+### 4. Fix remember-mcp git remote
+
+The remember-mcp git remote currently points to `remember-core.git` instead of `remember-mcp.git`. Fix with:
+
+```bash
+git remote set-url origin git@github.com:prmichaelsen/remember-mcp.git
+```
+
+### 5. Test end-to-end
+
+- Push a version bump to remember-core main
+- Verify remember-core publishes to npm
+- Verify dispatch fires
+- Verify remember-mcp bumps, commits, tags, publishes
+
+---
+
+## Verification
+
+- [ ] `REPO_DISPATCH_TOKEN` secret set in remember-core
+- [ ] `NPM_TOKEN` secret set in remember-mcp
+- [ ] remember-core publish.yml includes dispatch step
+- [ ] remember-mcp bump-remember-core.yml exists
+- [ ] remember-mcp git remote points to correct repo
+- [ ] End-to-end test: remember-core publish triggers remember-mcp bump + publish
+
+---
+
+## Notes
+
+- Draft workflow files already created in both repos (not yet committed)
+- remember-core publish.yml already has NPM_TOKEN configured
+- The bump workflow commits in the existing pattern: `bump: remember core` then `{version}`
+- Consider adding error notifications (GitHub Actions failure emails are on by default)

package/dist/server-factory.js

@@ -803,6 +803,64 @@ function handleToolError(error, context) {
   throw new Error(detailedMessage);
 }
 
+// node_modules/@prmichaelsen/remember-core/dist/types/trust.types.js
+var TrustLevel = {
+  /** Anyone can see this, including strangers */
+  PUBLIC: 1,
+  /** Friends and known users */
+  INTERNAL: 2,
+  /** Trusted friends only */
+  CONFIDENTIAL: 3,
+  /** Close/intimate contacts only */
+  RESTRICTED: 4,
+  /** Owner only (or explicitly granted) */
+  SECRET: 5
+};
+var TRUST_LABELS = {
+  [TrustLevel.PUBLIC]: "Public",
+  [TrustLevel.INTERNAL]: "Internal",
+  [TrustLevel.CONFIDENTIAL]: "Confidential",
+  [TrustLevel.RESTRICTED]: "Restricted",
+  [TrustLevel.SECRET]: "Secret"
+};
+var ALL_TRUST_LEVELS = [
+  TrustLevel.PUBLIC,
+  TrustLevel.INTERNAL,
+  TrustLevel.CONFIDENTIAL,
+  TrustLevel.RESTRICTED,
+  TrustLevel.SECRET
+];
+function isValidTrustLevel(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 5;
+}
+function normalizeTrustScore(value) {
+  if (value == null)
+    return TrustLevel.INTERNAL;
+  if (isValidTrustLevel(value))
+    return value;
+  const inverted = 1 - value;
+  if (inverted >= 0.875)
+    return TrustLevel.SECRET;
+  if (inverted >= 0.625)
+    return TrustLevel.RESTRICTED;
+  if (inverted >= 0.375)
+    return TrustLevel.CONFIDENTIAL;
+  if (inverted >= 0.125)
+    return TrustLevel.INTERNAL;
+  return TrustLevel.PUBLIC;
+}
+
+// node_modules/@prmichaelsen/remember-core/dist/types/ghost-config.types.js
+var DEFAULT_GHOST_CONFIG = {
+  enabled: false,
+  public_ghost_enabled: false,
+  default_friend_trust: TrustLevel.INTERNAL,
+  default_public_trust: TrustLevel.PUBLIC,
+  per_user_trust: {},
+  blocked_users: [],
+  enforcement_mode: "query"
+};
+
 // node_modules/@prmichaelsen/remember-core/dist/types/preferences.types.js
 var DEFAULT_PREFERENCES = {
   templates: {
@@ -1582,6 +1640,9 @@ function buildDocTypeFilters(collection, docType, filters) {
   if (filters?.tags && filters.tags.length > 0) {
     filterList.push(collection.filter.byProperty("tags").containsAny(filters.tags));
   }
+  if (filters?.memory_ids && filters.memory_ids.length > 0) {
+    filterList.push(collection.filter.byId().containsAny(filters.memory_ids));
+  }
   return combineFiltersWithAnd(filterList);
 }
 function buildMemoryOnlyFilters(collection, filters) {
@@ -1988,14 +2049,22 @@ function buildTrustFilter(collection, accessorTrustLevel) {
 }
 
 // node_modules/@prmichaelsen/remember-core/dist/services/memory.service.js
+function normalizeDoc(doc) {
+  if ("trust_score" in doc) {
+    doc.trust_score = normalizeTrustScore(doc.trust_score);
+  }
+  return doc;
+}
 var MemoryService = class {
   collection;
   userId;
   logger;
-  constructor(collection, userId, logger2) {
+  options;
+  constructor(collection, userId, logger2, options) {
     this.collection = collection;
     this.userId = userId;
     this.logger = logger2;
+    this.options = options;
   }
   /**
    * Execute a search function, retrying without the deleted_at filter if
@@ -2018,7 +2087,31 @@ var MemoryService = class {
       throw new Error(`Memory not found: ${memoryId}`);
     if (existing.properties.user_id !== this.userId)
       throw new Error("Unauthorized");
-    return { memory: { id: existing.uuid, ...existing.properties } };
+    return { memory: normalizeDoc({ id: existing.uuid, ...existing.properties }) };
+  }
+  // ── Resolve by ID (cross-collection) ─────────────────────────────────
+  /**
+   * Resolve any memory by UUID alone using the Firestore index.
+   * Requires `memoryIndex` and `weaviateClient` in constructor options.
+   */
+  async resolveById(memoryId) {
+    if (!this.options?.weaviateClient) {
+      throw new Error("resolveById requires weaviateClient in options");
+    }
+    if (this.options?.memoryIndex) {
+      const collectionName = await this.options.memoryIndex.lookup(memoryId);
+      if (collectionName) {
+        const col = this.options.weaviateClient.collections.get(collectionName);
+        const memory = await fetchMemoryWithAllProperties(col, memoryId);
+        if (memory?.properties) {
+          return {
+            memory: normalizeDoc({ id: memory.uuid, ...memory.properties }),
+            collectionName
+          };
+        }
+      }
+    }
+    return { memory: null, collectionName: null };
   }
   // ── Create ──────────────────────────────────────────────────────────
   async create(input) {
@@ -2032,7 +2125,7 @@ var MemoryService = class {
       summary: input.title,
       content_type: contentType,
       weight: input.weight ?? 0.5,
-      trust_score: input.trust ?? 0.25,
+      trust_score: input.trust ?? TrustLevel.INTERNAL,
       confidence: 1,
       context_summary: input.context_summary || "Memory created",
       context_conversation_id: input.context_conversation_id,
@@ -2057,6 +2150,14 @@ var MemoryService = class {
     };
     const memoryId = await this.collection.data.insert({ properties });
     this.logger.info("Memory created", { memoryId, userId: this.userId });
+    if (this.options?.memoryIndex) {
+      try {
+        const collectionName = this.collection.name;
+        await this.options.memoryIndex.index(memoryId, collectionName);
+      } catch (err2) {
+        this.logger.warn?.(`[MemoryService] Index write failed for ${memoryId}: ${err2}`);
+      }
+    }
     return { memory_id: memoryId, created_at: now };
   }
   // ── Search (hybrid) ─────────────────────────────────────────────────
@@ -2094,7 +2195,7 @@ var MemoryService = class {
     const memories = [];
     const relationships = [];
     for (const obj of paginated) {
-      const doc = { id: obj.uuid, ...obj.properties };
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
       if (doc.doc_type === "memory")
         memories.push(doc);
       else if (doc.doc_type === "relationship")
@@ -2137,7 +2238,7 @@ var MemoryService = class {
     const paginated = results.objects.slice(offset);
     const memories = [];
     for (const obj of paginated) {
-      const doc = { id: obj.uuid, ...obj.properties };
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
       if (doc.doc_type === "memory") {
         memories.push(doc);
       }
@@ -2181,7 +2282,7 @@ var MemoryService = class {
     const paginated = results.objects.slice(offset);
     const memories = [];
     for (const obj of paginated) {
-      const doc = { id: obj.uuid, ...obj.properties };
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
       if (doc.doc_type === "memory") {
         memories.push(doc);
       }
@@ -2240,7 +2341,7 @@ var MemoryService = class {
     if (!input.include_relationships) {
       results.objects = results.objects.filter((o) => o.properties.doc_type === "memory");
     }
-    const items = results.objects.map((obj) => ({
+    const items = results.objects.map((obj) => normalizeDoc({
       id: obj.uuid,
       ...obj.properties,
       similarity: Math.max(0, Math.min(1, 1 - (obj.metadata?.distance ?? 0)))
@@ -2269,7 +2370,7 @@ var MemoryService = class {
         opts.filters = combinedFilters;
       return this.collection.query.nearText(input.query, opts);
     });
-    const items = results.objects.map((obj) => ({
+    const items = results.objects.map((obj) => normalizeDoc({
       id: obj.uuid,
       ...obj.properties,
       relevance: Math.max(0, Math.min(1, 1 - (obj.metadata?.distance ?? 0)))
@@ -2313,8 +2414,8 @@ var MemoryService = class {
       updatedFields.push("weight");
     }
     if (input.trust !== void 0) {
-      if (input.trust < 0 || input.trust > 1)
-        throw new Error("Trust must be between 0 and 1");
+      if (!isValidTrustLevel(input.trust))
+        throw new Error("Trust must be an integer between 1 and 5");
       updates.trust_score = input.trust;
       updatedFields.push("trust_score");
     }

package/dist/server.js

@@ -807,6 +807,64 @@ function handleToolError(error, context) {
   throw new Error(detailedMessage);
 }
 
+// node_modules/@prmichaelsen/remember-core/dist/types/trust.types.js
+var TrustLevel = {
+  /** Anyone can see this, including strangers */
+  PUBLIC: 1,
+  /** Friends and known users */
+  INTERNAL: 2,
+  /** Trusted friends only */
+  CONFIDENTIAL: 3,
+  /** Close/intimate contacts only */
+  RESTRICTED: 4,
+  /** Owner only (or explicitly granted) */
+  SECRET: 5
+};
+var TRUST_LABELS = {
+  [TrustLevel.PUBLIC]: "Public",
+  [TrustLevel.INTERNAL]: "Internal",
+  [TrustLevel.CONFIDENTIAL]: "Confidential",
+  [TrustLevel.RESTRICTED]: "Restricted",
+  [TrustLevel.SECRET]: "Secret"
+};
+var ALL_TRUST_LEVELS = [
+  TrustLevel.PUBLIC,
+  TrustLevel.INTERNAL,
+  TrustLevel.CONFIDENTIAL,
+  TrustLevel.RESTRICTED,
+  TrustLevel.SECRET
+];
+function isValidTrustLevel(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 5;
+}
+function normalizeTrustScore(value) {
+  if (value == null)
+    return TrustLevel.INTERNAL;
+  if (isValidTrustLevel(value))
+    return value;
+  const inverted = 1 - value;
+  if (inverted >= 0.875)
+    return TrustLevel.SECRET;
+  if (inverted >= 0.625)
+    return TrustLevel.RESTRICTED;
+  if (inverted >= 0.375)
+    return TrustLevel.CONFIDENTIAL;
+  if (inverted >= 0.125)
+    return TrustLevel.INTERNAL;
+  return TrustLevel.PUBLIC;
+}
+
+// node_modules/@prmichaelsen/remember-core/dist/types/ghost-config.types.js
+var DEFAULT_GHOST_CONFIG = {
+  enabled: false,
+  public_ghost_enabled: false,
+  default_friend_trust: TrustLevel.INTERNAL,
+  default_public_trust: TrustLevel.PUBLIC,
+  per_user_trust: {},
+  blocked_users: [],
+  enforcement_mode: "query"
+};
+
 // node_modules/@prmichaelsen/remember-core/dist/types/preferences.types.js
 var DEFAULT_PREFERENCES = {
   templates: {
@@ -1586,6 +1644,9 @@ function buildDocTypeFilters(collection, docType, filters) {
   if (filters?.tags && filters.tags.length > 0) {
     filterList.push(collection.filter.byProperty("tags").containsAny(filters.tags));
   }
+  if (filters?.memory_ids && filters.memory_ids.length > 0) {
+    filterList.push(collection.filter.byId().containsAny(filters.memory_ids));
+  }
   return combineFiltersWithAnd(filterList);
 }
 function buildMemoryOnlyFilters(collection, filters) {
@@ -1992,14 +2053,22 @@ function buildTrustFilter(collection, accessorTrustLevel) {
 }
 
 // node_modules/@prmichaelsen/remember-core/dist/services/memory.service.js
+function normalizeDoc(doc) {
+  if ("trust_score" in doc) {
+    doc.trust_score = normalizeTrustScore(doc.trust_score);
+  }
+  return doc;
+}
 var MemoryService = class {
   collection;
   userId;
   logger;
-  constructor(collection, userId, logger2) {
+  options;
+  constructor(collection, userId, logger2, options) {
     this.collection = collection;
     this.userId = userId;
     this.logger = logger2;
+    this.options = options;
   }
   /**
    * Execute a search function, retrying without the deleted_at filter if
@@ -2022,7 +2091,31 @@ var MemoryService = class {
       throw new Error(`Memory not found: ${memoryId}`);
     if (existing.properties.user_id !== this.userId)
       throw new Error("Unauthorized");
-    return { memory: { id: existing.uuid, ...existing.properties } };
+    return { memory: normalizeDoc({ id: existing.uuid, ...existing.properties }) };
+  }
+  // ── Resolve by ID (cross-collection) ─────────────────────────────────
+  /**
+   * Resolve any memory by UUID alone using the Firestore index.
+   * Requires `memoryIndex` and `weaviateClient` in constructor options.
+   */
+  async resolveById(memoryId) {
+    if (!this.options?.weaviateClient) {
+      throw new Error("resolveById requires weaviateClient in options");
+    }
+    if (this.options?.memoryIndex) {
+      const collectionName = await this.options.memoryIndex.lookup(memoryId);
+      if (collectionName) {
+        const col = this.options.weaviateClient.collections.get(collectionName);
+        const memory = await fetchMemoryWithAllProperties(col, memoryId);
+        if (memory?.properties) {
+          return {
+            memory: normalizeDoc({ id: memory.uuid, ...memory.properties }),
+            collectionName
+          };
+        }
+      }
+    }
+    return { memory: null, collectionName: null };
   }
   // ── Create ──────────────────────────────────────────────────────────
   async create(input) {
@@ -2036,7 +2129,7 @@ var MemoryService = class {
       summary: input.title,
       content_type: contentType,
       weight: input.weight ?? 0.5,
-      trust_score: input.trust ?? 0.25,
+      trust_score: input.trust ?? TrustLevel.INTERNAL,
       confidence: 1,
       context_summary: input.context_summary || "Memory created",
       context_conversation_id: input.context_conversation_id,
@@ -2061,6 +2154,14 @@ var MemoryService = class {
     };
     const memoryId = await this.collection.data.insert({ properties });
     this.logger.info("Memory created", { memoryId, userId: this.userId });
+    if (this.options?.memoryIndex) {
+      try {
+        const collectionName = this.collection.name;
+        await this.options.memoryIndex.index(memoryId, collectionName);
+      } catch (err2) {
+        this.logger.warn?.(`[MemoryService] Index write failed for ${memoryId}: ${err2}`);
+      }
+    }
     return { memory_id: memoryId, created_at: now };
   }
   // ── Search (hybrid) ─────────────────────────────────────────────────
@@ -2098,7 +2199,7 @@ var MemoryService = class {
     const memories = [];
     const relationships = [];
     for (const obj of paginated) {
-      const doc = { id: obj.uuid, ...obj.properties };
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
       if (doc.doc_type === "memory")
         memories.push(doc);
       else if (doc.doc_type === "relationship")
@@ -2141,7 +2242,7 @@ var MemoryService = class {
     const paginated = results.objects.slice(offset);
     const memories = [];
     for (const obj of paginated) {
-      const doc = { id: obj.uuid, ...obj.properties };
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
       if (doc.doc_type === "memory") {
         memories.push(doc);
       }
@@ -2185,7 +2286,7 @@ var MemoryService = class {
     const paginated = results.objects.slice(offset);
     const memories = [];
     for (const obj of paginated) {
-      const doc = { id: obj.uuid, ...obj.properties };
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
       if (doc.doc_type === "memory") {
         memories.push(doc);
       }
@@ -2244,7 +2345,7 @@ var MemoryService = class {
     if (!input.include_relationships) {
       results.objects = results.objects.filter((o) => o.properties.doc_type === "memory");
     }
-    const items = results.objects.map((obj) => ({
+    const items = results.objects.map((obj) => normalizeDoc({
       id: obj.uuid,
       ...obj.properties,
       similarity: Math.max(0, Math.min(1, 1 - (obj.metadata?.distance ?? 0)))
@@ -2273,7 +2374,7 @@ var MemoryService = class {
         opts.filters = combinedFilters;
       return this.collection.query.nearText(input.query, opts);
     });
-    const items = results.objects.map((obj) => ({
+    const items = results.objects.map((obj) => normalizeDoc({
       id: obj.uuid,
       ...obj.properties,
       relevance: Math.max(0, Math.min(1, 1 - (obj.metadata?.distance ?? 0)))
@@ -2317,8 +2418,8 @@ var MemoryService = class {
       updatedFields.push("weight");
     }
     if (input.trust !== void 0) {
-      if (input.trust < 0 || input.trust > 1)
-        throw new Error("Trust must be between 0 and 1");
+      if (!isValidTrustLevel(input.trust))
+        throw new Error("Trust must be an integer between 1 and 5");
       updates.trust_score = input.trust;
       updatedFields.push("trust_score");
     }

package/esbuild.build.js

@@ -13,7 +13,10 @@ await esbuild.build({
   external: [
     'weaviate-client',
     '@prmichaelsen/firebase-admin-sdk-v8',
-    '@modelcontextprotocol/sdk'
+    '@modelcontextprotocol/sdk',
+    'unpdf',
+    'mammoth',
+    'turndown',
   ],
   banner: {
     js: "import { createRequire } from 'module'; const require = createRequire(import.meta.url);"
@@ -35,7 +38,10 @@ await esbuild.build({
   external: [
     'weaviate-client',
     '@prmichaelsen/firebase-admin-sdk-v8',
-    '@modelcontextprotocol/sdk'
+    '@modelcontextprotocol/sdk',
+    'unpdf',
+    'mammoth',
+    'turndown',
   ],
   banner: {
     js: "import { createRequire } from 'module'; const require = createRequire(import.meta.url);"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prmichaelsen/remember-mcp",
-  "version": "3.14.18",
+  "version": "3.14.19",
   "description": "Multi-tenant memory system MCP server with vector search and relationships",
   "main": "dist/server.js",
   "type": "module",
@@ -50,7 +50,7 @@
     "@modelcontextprotocol/sdk": "^1.0.4",
     "@prmichaelsen/firebase-admin-sdk-v8": "^2.2.0",
     "@prmichaelsen/mcp-auth": "^7.0.4",
-    "@prmichaelsen/remember-core": "^0.27.3",
+    "@prmichaelsen/remember-core": "^0.30.0",
     "dotenv": "^16.4.5",
     "uuid": "^13.0.0",
     "weaviate-client": "^3.2.0"