loopctl-mcp-server 2.23.0 → 2.25.0

package/index.js

@@ -848,6 +848,7 @@ async function knowledgeCreate({
   tags,
   project_id,
   draft,
+  force,
   source_type,
   source_id,
   idempotency_key,
@@ -868,6 +869,10 @@ async function knowledgeCreate({
   // knowledge_publish.
   if (draft) payload.draft = true;
 
+  // The server-side novelty gate dedups the proposal against the corpus (verdict in
+  // the response `gate`). force:true bypasses it.
+  if (force) payload.force = true;
+
   const result = await apiCall(
     "POST",
     "/api/v1/articles",
@@ -1097,9 +1102,10 @@ async function knowledgeIngestionJobs({ limit, offset, since_days } = {}) {
 
 // --- Knowledge Analytics Tools (orch key) ---
 
-async function knowledgeAnalyticsTop({ limit, since_days, access_type } = {}) {
+async function knowledgeAnalyticsTop({ limit, offset, since_days, access_type } = {}) {
   const params = new URLSearchParams();
   if (limit != null) params.set("limit", String(limit));
+  if (offset != null) params.set("offset", String(offset));
   if (since_days != null) params.set("since_days", String(since_days));
   if (access_type) params.set("access_type", access_type);
   const qs = params.toString();
@@ -1187,10 +1193,11 @@ async function knowledgeAgentUsage({ api_key_id, agent_id, limit, since_days } =
   return toContent(result);
 }
 
-async function knowledgeUnusedArticles({ days_unused, limit } = {}) {
+async function knowledgeUnusedArticles({ days_unused, limit, offset } = {}) {
   const params = new URLSearchParams();
   if (days_unused != null) params.set("days_unused", String(days_unused));
   if (limit != null) params.set("limit", String(limit));
+  if (offset != null) params.set("offset", String(offset));
   const qs = params.toString();
   const path = qs
     ? `/api/v1/knowledge/analytics/unused-articles?${qs}`
@@ -2563,6 +2570,13 @@ const TOOLS = [
       "to agents (search/index/context) right away — no separate publish step is needed. Pass " +
       "draft: true to stage the article for later review instead; the response `note` says which " +
       "outcome occurred, and a draft can be published afterwards with knowledge_publish. " +
+      "NOVELTY GATE (default ON): the server semantically dedups your proposal against the published " +
+      "corpus and returns a `gate.verdict` — `duplicate` means a near-identical article already exists, " +
+      "so NOTHING was created (HTTP 200, `deduplicated: true`); read/update the article at `data.id` " +
+      "instead (its `gate.similarity` ~1.0). `gated_to_draft` means high overlap, so the article was " +
+      "created as a DRAFT (not published) with the near-neighbors in metadata.proposal_novelty for you " +
+      "to merge or publish. `created` means it was novel and went through normally. Pass force: true to " +
+      "bypass the gate when you intentionally want an article near an existing one. " +
       "Concurrency-safe: if a create races/retries against an " +
       "existing article with the same title AND an identical body (ignoring surrounding whitespace), the " +
       "server returns that existing article idempotently (HTTP 200) instead of a 422. A same-title create " +
@@ -2598,6 +2612,13 @@ const TOOLS = [
             "Optional: stage as a draft instead of publishing on create (default false → " +
             "published immediately). Publish later with knowledge_publish.",
         },
+        force: {
+          type: "boolean",
+          description:
+            "Optional: bypass the novelty gate (default false). When true, the server skips " +
+            "semantic dedup and creates on the requested path even if a near-duplicate exists. " +
+            "Use only when you've already checked and intend an article close to an existing one.",
+        },
         idempotency_key: {
           type: "string",
           description:
@@ -3102,10 +3123,15 @@ const TOOLS = [
       properties: {
         limit: {
           type: "integer",
-          description: "Max rows to return. Default 20, max 100.",
+          description: "Max rows per page. Default 20, max 100.",
           minimum: 1,
           maximum: 100,
         },
+        offset: {
+          type: "integer",
+          description: "Rows to skip — page the ranking past the first page. Default 0.",
+          minimum: 0,
+        },
         since_days: {
           type: "integer",
           description: "Look back this many days. Default 7.",
@@ -3188,10 +3214,15 @@ const TOOLS = [
         },
         limit: {
           type: "integer",
-          description: "Max rows to return. Default 50, max 200.",
+          description: "Max rows per page. Default 50, max 200.",
           minimum: 1,
           maximum: 200,
         },
+        offset: {
+          type: "integer",
+          description: "Rows to skip — page the full unused set to completeness. Default 0.",
+          minimum: 0,
+        },
       },
       required: [],
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopctl-mcp-server",
-  "version": "2.23.0",
+  "version": "2.25.0",
   "description": "MCP server for loopctl — structural trust for AI development loops",
   "type": "module",
   "main": "index.js",