@prmichaelsen/remember-mcp 3.16.0 → 3.16.2

package/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to npm
+
+on:
+  push:
+    branches: [mainline]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test
+
+      - name: Check if version changed
+        id: version
+        run: |
+          CURRENT=$(node -p "require('./package.json').version")
+          PREVIOUS=$(git show HEAD~1:package.json 2>/dev/null | node -p "JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')).version" 2>/dev/null || echo "")
+          if [ "$CURRENT" != "$PREVIOUS" ]; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+            echo "version=$CURRENT" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Publish
+        if: steps.version.outputs.changed == 'true'
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Summary
+        if: steps.version.outputs.changed == 'true'
+        run: echo "Published @prmichaelsen/remember-mcp@${{ steps.version.outputs.version }} to npm"
+
+      - name: Skip
+        if: steps.version.outputs.changed != 'true'
+        run: echo "Version unchanged, skipping publish"

package/dist/server-factory.js

@@ -1931,7 +1931,13 @@ var COMMON_MEMORY_PROPERTIES = [
   { name: "total_significance", dataType: configure.dataType.NUMBER },
   // REM metadata
   { name: "rem_touched_at", dataType: configure.dataType.TEXT },
-  { name: "rem_visits", dataType: configure.dataType.INT }
+  { name: "rem_visits", dataType: configure.dataType.INT },
+  // Curation scoring (M36)
+  { name: "curated_score", dataType: configure.dataType.NUMBER },
+  { name: "editorial_score", dataType: configure.dataType.NUMBER },
+  { name: "click_count", dataType: configure.dataType.INT },
+  { name: "share_count", dataType: configure.dataType.INT },
+  { name: "comment_count", dataType: configure.dataType.INT }
 ];
 var PUBLISHED_MEMORY_PROPERTIES = [
   // Publication metadata
@@ -2582,7 +2588,13 @@ var ALL_MEMORY_PROPERTIES = [
   "functional_significance",
   "total_significance",
   "rem_touched_at",
-  "rem_visits"
+  "rem_visits",
+  // Curation scoring (M36)
+  "curated_score",
+  "editorial_score",
+  "click_count",
+  "share_count",
+  "comment_count"
 ];
 async function fetchMemoryWithAllProperties(collection, memoryId) {
   try {
@@ -3358,6 +3370,99 @@ var MemoryService = class {
       total_pool_size: totalPoolSize
     };
   }
+  // ── By Curated (composite quality score) ──────────────────────────
+  async byCurated(input) {
+    const limit = input.limit ?? 50;
+    const offset = input.offset ?? 0;
+    const direction = input.direction ?? "desc";
+    const memoryFilters = buildMemoryOnlyFilters(this.collection, input.filters);
+    const ghostFilters = [];
+    if (input.ghost_context) {
+      ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
+    }
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
+      ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
+    }
+    if (!input.filters?.types?.includes("rem")) {
+      ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("rem"));
+    }
+    const hasQuery = input.query?.trim();
+    const fetchLimit = (limit + offset) * 2;
+    const executeScoredQuery = async (useDeletedFilter) => {
+      const deletedFilter = useDeletedFilter ? buildDeletedFilter(this.collection, input.deleted_filter || "exclude") : null;
+      const scoredFilter = this.collection.filter.byProperty("curated_score").greaterThan(0);
+      const combined = combineFiltersWithAnd([deletedFilter, memoryFilters, scoredFilter, ...ghostFilters].filter((f) => f !== null));
+      if (hasQuery) {
+        const queryOptions2 = {
+          limit: fetchLimit,
+          alpha: 0.7,
+          query: hasQuery
+        };
+        if (combined)
+          queryOptions2.filters = combined;
+        return this.collection.query.hybrid(hasQuery, queryOptions2);
+      }
+      const queryOptions = {
+        limit: fetchLimit,
+        sort: this.collection.sort.byProperty("curated_score", direction === "asc")
+      };
+      if (combined)
+        queryOptions.filters = combined;
+      return this.collection.query.fetchObjects(queryOptions);
+    };
+    const executeUnscoredQuery = async (useDeletedFilter) => {
+      const deletedFilter = useDeletedFilter ? buildDeletedFilter(this.collection, input.deleted_filter || "exclude") : null;
+      const unscoredFilters = [];
+      const combined = combineFiltersWithAnd([deletedFilter, memoryFilters, ...ghostFilters].filter((f) => f !== null));
+      const queryOptions = {
+        limit: Math.ceil(fetchLimit / 4),
+        sort: this.collection.sort.byProperty("created_at", false)
+        // newest first
+      };
+      if (combined)
+        queryOptions.filters = combined;
+      return this.collection.query.fetchObjects(queryOptions);
+    };
+    const scoredResults = await this.retryWithoutDeletedFilter(executeScoredQuery);
+    const unscoredResults = await this.retryWithoutDeletedFilter(executeUnscoredQuery);
+    const scored = [];
+    for (const obj of scoredResults.objects) {
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
+      if (doc.doc_type === "memory" && doc.curated_score > 0) {
+        scored.push(doc);
+      }
+    }
+    if (hasQuery) {
+      scored.sort((a, b) => {
+        const aScore = a.curated_score ?? 0;
+        const bScore = b.curated_score ?? 0;
+        return direction === "asc" ? aScore - bScore : bScore - aScore;
+      });
+    }
+    const unscored = [];
+    for (const obj of unscoredResults.objects) {
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
+      if (doc.doc_type === "memory" && !doc.curated_score) {
+        unscored.push(doc);
+      }
+    }
+    const interleaved = interleaveDiscovery({
+      rated: scored,
+      discovery: unscored,
+      offset,
+      limit
+    });
+    const memories = interleaved.map((item) => ({
+      ...item.item,
+      ...item.is_discovery ? { is_discovery: true } : {}
+    }));
+    return {
+      memories,
+      total: memories.length,
+      offset,
+      limit
+    };
+  }
   // ── Find Similar (vector) ──────────────────────────────────────────
   async findSimilar(input) {
     if (!input.memory_id && !input.text)
@@ -3374,6 +3479,7 @@ var MemoryService = class {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("rem"));
+    ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("comment"));
     let memoryObj = null;
     if (input.memory_id) {
       memoryObj = await this.collection.query.fetchObjectById(input.memory_id, {
@@ -3565,6 +3671,28 @@ var MemoryService = class {
       orphaned_relationship_ids: orphanedIds
     };
   }
+  // ── Engagement Counters ───────────────────────────────────────────
+  async incrementClick(memoryId) {
+    await this.incrementCounter(memoryId, "click_count");
+  }
+  async incrementShare(memoryId) {
+    await this.incrementCounter(memoryId, "share_count");
+  }
+  async incrementComment(memoryId) {
+    await this.incrementCounter(memoryId, "comment_count");
+  }
+  async incrementCounter(memoryId, field) {
+    const existing = await this.collection.query.fetchObjectById(memoryId, {
+      returnProperties: [field]
+    });
+    if (!existing)
+      throw new Error(`Memory not found: ${memoryId}`);
+    const current = existing.properties?.[field] ?? 0;
+    await this.collection.data.update({
+      id: memoryId,
+      properties: { [field]: current + 1 }
+    });
+  }
 };
 
 // node_modules/@prmichaelsen/remember-core/dist/services/relationship.service.js
@@ -5006,6 +5134,42 @@ var SpaceService = class {
     });
     return { spaces_searched: spacesSearched, groups_searched: groupsSearched, results, total_pool_size: totalPoolSize };
   }
+  // ── By Curated (composite quality score) ──────────────────────────
+  async byCurated(input, authContext) {
+    const spaces = input.spaces || [];
+    const groups = input.groups || [];
+    const limit = input.limit ?? 50;
+    const offset = input.offset ?? 0;
+    const direction = input.direction ?? "desc";
+    this.validateSpaceGroupInput(spaces, groups, input.moderation_filter || "approved", authContext);
+    const fetchLimit = (limit + offset) * 2;
+    const hasQuery = input.query?.trim();
+    const { allResults, spacesSearched, groupsSearched } = await this.fetchAcrossCollections(input, spaces, groups, async (collection, baseFilters) => {
+      const combined = baseFilters.length > 0 ? Filters4.and(...baseFilters) : void 0;
+      if (hasQuery) {
+        const opts2 = { limit: fetchLimit, alpha: 0.7, query: hasQuery };
+        if (combined)
+          opts2.filters = combined;
+        return (await collection.query.hybrid(hasQuery, opts2)).objects;
+      }
+      const opts = {
+        limit: fetchLimit,
+        sort: collection.sort.byProperty("curated_score", direction === "asc")
+      };
+      if (combined)
+        opts.filters = combined;
+      return (await collection.query.fetchObjects(opts)).objects;
+    });
+    const deduped = dedupeBySourceId(allResults, input.dedupe);
+    deduped.sort((a, b) => {
+      const aVal = a.properties?.curated_score ?? 0;
+      const bVal = b.properties?.curated_score ?? 0;
+      return direction === "desc" ? bVal - aVal : aVal - bVal;
+    });
+    const paginated = deduped.slice(offset, offset + limit);
+    const memories = paginated.filter((obj) => obj.properties?.doc_type === "memory").map((obj) => ({ id: obj.uuid, ...obj.properties }));
+    return { spaces_searched: spacesSearched, groups_searched: groupsSearched, memories, total: memories.length, offset, limit };
+  }
   // ── Private: Validate Space/Group Input ───────────────────────────
   validateSpaceGroupInput(spaces, groups, moderationFilter, authContext) {
     if (spaces.length > 0) {
@@ -5150,6 +5314,18 @@ var REM_STATE_COLLECTION = `${BASE}.rem_state`;
 // node_modules/@prmichaelsen/remember-core/dist/services/rem.clustering.js
 import { Filters as Filters5 } from "weaviate-client";
 
+// node_modules/@prmichaelsen/remember-core/dist/services/rem.service.js
+import { Filters as Filters9 } from "weaviate-client";
+
+// node_modules/@prmichaelsen/remember-core/dist/services/scoring-context.service.js
+import { Filters as Filters6 } from "weaviate-client";
+
+// node_modules/@prmichaelsen/remember-core/dist/services/rem.pruning.js
+import { Filters as Filters7 } from "weaviate-client";
+
+// node_modules/@prmichaelsen/remember-core/dist/services/rem.reconciliation.js
+import { Filters as Filters8 } from "weaviate-client";
+
 // node_modules/@prmichaelsen/remember-core/dist/services/classification.service.js
 var GENRES = [
   "short_story",
@@ -7437,7 +7613,7 @@ async function handleDeny(args, userId, authContext) {
 }
 
 // src/tools/search-space.ts
-import { Filters as Filters6 } from "weaviate-client";
+import { Filters as Filters10 } from "weaviate-client";
 var searchSpaceTool = {
   name: "remember_search_space",
   description: `Search shared spaces and/or groups to discover memories from other users.

package/dist/server.js

@@ -1935,7 +1935,13 @@ var COMMON_MEMORY_PROPERTIES = [
   { name: "total_significance", dataType: configure.dataType.NUMBER },
   // REM metadata
   { name: "rem_touched_at", dataType: configure.dataType.TEXT },
-  { name: "rem_visits", dataType: configure.dataType.INT }
+  { name: "rem_visits", dataType: configure.dataType.INT },
+  // Curation scoring (M36)
+  { name: "curated_score", dataType: configure.dataType.NUMBER },
+  { name: "editorial_score", dataType: configure.dataType.NUMBER },
+  { name: "click_count", dataType: configure.dataType.INT },
+  { name: "share_count", dataType: configure.dataType.INT },
+  { name: "comment_count", dataType: configure.dataType.INT }
 ];
 var PUBLISHED_MEMORY_PROPERTIES = [
   // Publication metadata
@@ -2586,7 +2592,13 @@ var ALL_MEMORY_PROPERTIES = [
   "functional_significance",
   "total_significance",
   "rem_touched_at",
-  "rem_visits"
+  "rem_visits",
+  // Curation scoring (M36)
+  "curated_score",
+  "editorial_score",
+  "click_count",
+  "share_count",
+  "comment_count"
 ];
 async function fetchMemoryWithAllProperties(collection, memoryId) {
   try {
@@ -3362,6 +3374,99 @@ var MemoryService = class {
       total_pool_size: totalPoolSize
     };
   }
+  // ── By Curated (composite quality score) ──────────────────────────
+  async byCurated(input) {
+    const limit = input.limit ?? 50;
+    const offset = input.offset ?? 0;
+    const direction = input.direction ?? "desc";
+    const memoryFilters = buildMemoryOnlyFilters(this.collection, input.filters);
+    const ghostFilters = [];
+    if (input.ghost_context) {
+      ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
+    }
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
+      ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
+    }
+    if (!input.filters?.types?.includes("rem")) {
+      ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("rem"));
+    }
+    const hasQuery = input.query?.trim();
+    const fetchLimit = (limit + offset) * 2;
+    const executeScoredQuery = async (useDeletedFilter) => {
+      const deletedFilter = useDeletedFilter ? buildDeletedFilter(this.collection, input.deleted_filter || "exclude") : null;
+      const scoredFilter = this.collection.filter.byProperty("curated_score").greaterThan(0);
+      const combined = combineFiltersWithAnd([deletedFilter, memoryFilters, scoredFilter, ...ghostFilters].filter((f) => f !== null));
+      if (hasQuery) {
+        const queryOptions2 = {
+          limit: fetchLimit,
+          alpha: 0.7,
+          query: hasQuery
+        };
+        if (combined)
+          queryOptions2.filters = combined;
+        return this.collection.query.hybrid(hasQuery, queryOptions2);
+      }
+      const queryOptions = {
+        limit: fetchLimit,
+        sort: this.collection.sort.byProperty("curated_score", direction === "asc")
+      };
+      if (combined)
+        queryOptions.filters = combined;
+      return this.collection.query.fetchObjects(queryOptions);
+    };
+    const executeUnscoredQuery = async (useDeletedFilter) => {
+      const deletedFilter = useDeletedFilter ? buildDeletedFilter(this.collection, input.deleted_filter || "exclude") : null;
+      const unscoredFilters = [];
+      const combined = combineFiltersWithAnd([deletedFilter, memoryFilters, ...ghostFilters].filter((f) => f !== null));
+      const queryOptions = {
+        limit: Math.ceil(fetchLimit / 4),
+        sort: this.collection.sort.byProperty("created_at", false)
+        // newest first
+      };
+      if (combined)
+        queryOptions.filters = combined;
+      return this.collection.query.fetchObjects(queryOptions);
+    };
+    const scoredResults = await this.retryWithoutDeletedFilter(executeScoredQuery);
+    const unscoredResults = await this.retryWithoutDeletedFilter(executeUnscoredQuery);
+    const scored = [];
+    for (const obj of scoredResults.objects) {
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
+      if (doc.doc_type === "memory" && doc.curated_score > 0) {
+        scored.push(doc);
+      }
+    }
+    if (hasQuery) {
+      scored.sort((a, b) => {
+        const aScore = a.curated_score ?? 0;
+        const bScore = b.curated_score ?? 0;
+        return direction === "asc" ? aScore - bScore : bScore - aScore;
+      });
+    }
+    const unscored = [];
+    for (const obj of unscoredResults.objects) {
+      const doc = normalizeDoc({ id: obj.uuid, ...obj.properties });
+      if (doc.doc_type === "memory" && !doc.curated_score) {
+        unscored.push(doc);
+      }
+    }
+    const interleaved = interleaveDiscovery({
+      rated: scored,
+      discovery: unscored,
+      offset,
+      limit
+    });
+    const memories = interleaved.map((item) => ({
+      ...item.item,
+      ...item.is_discovery ? { is_discovery: true } : {}
+    }));
+    return {
+      memories,
+      total: memories.length,
+      offset,
+      limit
+    };
+  }
   // ── Find Similar (vector) ──────────────────────────────────────────
   async findSimilar(input) {
     if (!input.memory_id && !input.text)
@@ -3378,6 +3483,7 @@ var MemoryService = class {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("rem"));
+    ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("comment"));
     let memoryObj = null;
     if (input.memory_id) {
       memoryObj = await this.collection.query.fetchObjectById(input.memory_id, {
@@ -3569,6 +3675,28 @@ var MemoryService = class {
       orphaned_relationship_ids: orphanedIds
     };
   }
+  // ── Engagement Counters ───────────────────────────────────────────
+  async incrementClick(memoryId) {
+    await this.incrementCounter(memoryId, "click_count");
+  }
+  async incrementShare(memoryId) {
+    await this.incrementCounter(memoryId, "share_count");
+  }
+  async incrementComment(memoryId) {
+    await this.incrementCounter(memoryId, "comment_count");
+  }
+  async incrementCounter(memoryId, field) {
+    const existing = await this.collection.query.fetchObjectById(memoryId, {
+      returnProperties: [field]
+    });
+    if (!existing)
+      throw new Error(`Memory not found: ${memoryId}`);
+    const current = existing.properties?.[field] ?? 0;
+    await this.collection.data.update({
+      id: memoryId,
+      properties: { [field]: current + 1 }
+    });
+  }
 };
 
 // node_modules/@prmichaelsen/remember-core/dist/services/relationship.service.js
@@ -5010,6 +5138,42 @@ var SpaceService = class {
     });
     return { spaces_searched: spacesSearched, groups_searched: groupsSearched, results, total_pool_size: totalPoolSize };
   }
+  // ── By Curated (composite quality score) ──────────────────────────
+  async byCurated(input, authContext) {
+    const spaces = input.spaces || [];
+    const groups = input.groups || [];
+    const limit = input.limit ?? 50;
+    const offset = input.offset ?? 0;
+    const direction = input.direction ?? "desc";
+    this.validateSpaceGroupInput(spaces, groups, input.moderation_filter || "approved", authContext);
+    const fetchLimit = (limit + offset) * 2;
+    const hasQuery = input.query?.trim();
+    const { allResults, spacesSearched, groupsSearched } = await this.fetchAcrossCollections(input, spaces, groups, async (collection, baseFilters) => {
+      const combined = baseFilters.length > 0 ? Filters4.and(...baseFilters) : void 0;
+      if (hasQuery) {
+        const opts2 = { limit: fetchLimit, alpha: 0.7, query: hasQuery };
+        if (combined)
+          opts2.filters = combined;
+        return (await collection.query.hybrid(hasQuery, opts2)).objects;
+      }
+      const opts = {
+        limit: fetchLimit,
+        sort: collection.sort.byProperty("curated_score", direction === "asc")
+      };
+      if (combined)
+        opts.filters = combined;
+      return (await collection.query.fetchObjects(opts)).objects;
+    });
+    const deduped = dedupeBySourceId(allResults, input.dedupe);
+    deduped.sort((a, b) => {
+      const aVal = a.properties?.curated_score ?? 0;
+      const bVal = b.properties?.curated_score ?? 0;
+      return direction === "desc" ? bVal - aVal : aVal - bVal;
+    });
+    const paginated = deduped.slice(offset, offset + limit);
+    const memories = paginated.filter((obj) => obj.properties?.doc_type === "memory").map((obj) => ({ id: obj.uuid, ...obj.properties }));
+    return { spaces_searched: spacesSearched, groups_searched: groupsSearched, memories, total: memories.length, offset, limit };
+  }
   // ── Private: Validate Space/Group Input ───────────────────────────
   validateSpaceGroupInput(spaces, groups, moderationFilter, authContext) {
     if (spaces.length > 0) {
@@ -5154,6 +5318,18 @@ var REM_STATE_COLLECTION = `${BASE}.rem_state`;
 // node_modules/@prmichaelsen/remember-core/dist/services/rem.clustering.js
 import { Filters as Filters5 } from "weaviate-client";
 
+// node_modules/@prmichaelsen/remember-core/dist/services/rem.service.js
+import { Filters as Filters9 } from "weaviate-client";
+
+// node_modules/@prmichaelsen/remember-core/dist/services/scoring-context.service.js
+import { Filters as Filters6 } from "weaviate-client";
+
+// node_modules/@prmichaelsen/remember-core/dist/services/rem.pruning.js
+import { Filters as Filters7 } from "weaviate-client";
+
+// node_modules/@prmichaelsen/remember-core/dist/services/rem.reconciliation.js
+import { Filters as Filters8 } from "weaviate-client";
+
 // node_modules/@prmichaelsen/remember-core/dist/services/classification.service.js
 var GENRES = [
   "short_story",
@@ -7441,7 +7617,7 @@ async function handleDeny(args, userId, authContext) {
 }
 
 // src/tools/search-space.ts
-import { Filters as Filters6 } from "weaviate-client";
+import { Filters as Filters10 } from "weaviate-client";
 var searchSpaceTool = {
   name: "remember_search_space",
   description: `Search shared spaces and/or groups to discover memories from other users.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prmichaelsen/remember-mcp",
-  "version": "3.16.0",
+  "version": "3.16.2",
   "description": "Multi-tenant memory system MCP server with vector search and relationships",
   "main": "dist/server.js",
   "type": "module",
@@ -51,7 +51,7 @@
     "@google-cloud/vision": "^5.3.4",
     "@modelcontextprotocol/sdk": "^1.0.4",
     "@prmichaelsen/firebase-admin-sdk-v8": "^2.2.0",
-    "@prmichaelsen/remember-core": "^0.45.0",
+    "@prmichaelsen/remember-core": "^0.49.16",
     "dotenv": "^16.4.5",
     "uuid": "^13.0.0",
     "weaviate-client": "^3.2.0"