loopctl-mcp-server 2.43.0 → 2.45.0

package/README.md

@@ -188,6 +188,7 @@ autonomous agent) can self-remediate without a human. Full agent-tenant lifecycl
 | `get_cost_summary` | orch | Get cost/token usage summary for a project, optionally broken down by `agent`, `epic`, or `model`. |
 | `get_story_token_usage` | orch | Get all token usage records for a single story. |
 | `get_cost_anomalies` | orch | Get cost anomaly alerts — stories or agents exceeding expected budgets. Optionally filter by project. |
+| `get_ingestion_anomalies` | orch | Get ingestion-health anomalies — capture-silence (a source_type stopped producing articles). Check whether knowledge capture is still landing. |
 | `set_token_budget` | orch | Set a token budget (in millicents) for a project, epic, story, or agent scope. Requires orchestrator role. |
 
 ### Knowledge Wiki Tools (agent key)

package/index.js

@@ -413,6 +413,30 @@ async function createKbScope({ name, slug, repo_url, description, tech_stack })
   return toContent(result);
 }
 
+async function archiveKbScope({ project_id }) {
+  // Reversible soft-delete of an agent-owned :kb scope on the AGENT key; frees its
+  // max_projects slot. The server rejects a :work project (422). Reverse with restore_kb_scope.
+  const result = await apiCall(
+    "DELETE",
+    `/api/v1/kb-scopes/${project_id}`,
+    null,
+    process.env.LOOPCTL_AGENT_KEY,
+  );
+  return toContent(result);
+}
+
+async function restoreKbScope({ project_id }) {
+  // Re-activate an archived :kb scope on the AGENT key (re-consumes a max_projects slot;
+  // 422 if at the cap). The server rejects a :work project (422).
+  const result = await apiCall(
+    "POST",
+    `/api/v1/kb-scopes/${project_id}/restore`,
+    {},
+    process.env.LOOPCTL_AGENT_KEY,
+  );
+  return toContent(result);
+}
+
 async function deleteProject({ project_id }) {
   const result = await apiCall(
     "DELETE",
@@ -800,6 +824,35 @@ async function getCostAnomalies({ project_id, page, page_size }) {
   return toContent(result);
 }
 
+async function getIngestionAnomalies({
+  source_type,
+  anomaly_type,
+  resolved,
+  include_archived,
+  page,
+  page_size,
+}) {
+  const params = new URLSearchParams();
+  if (source_type) params.set("source_type", source_type);
+  if (anomaly_type) params.set("anomaly_type", anomaly_type);
+  if (resolved != null) params.set("resolved", String(resolved));
+  if (include_archived != null) params.set("include_archived", String(include_archived));
+  if (page != null) params.set("page", String(page));
+  if (page_size != null) params.set("page_size", String(page_size));
+
+  const query = params.toString() ? `?${params}` : "";
+  // Orchestrator-gated endpoint (RequireRole :orchestrator). Pass the ORCH key
+  // explicitly so a misconfigured single agent-role LOOPCTL_API_KEY fails loudly
+  // rather than drifting into an undiagnosable 403.
+  const result = await apiCall(
+    "GET",
+    `/api/v1/ingestion-anomalies${query}`,
+    undefined,
+    process.env.LOOPCTL_ORCH_KEY
+  );
+  return toContent(result);
+}
+
 async function setTokenBudget({ scope_type, scope_id, budget_millicents, alert_threshold_pct }) {
   const body = { scope_type, scope_id, budget_millicents };
   if (alert_threshold_pct != null) body.alert_threshold_pct = alert_threshold_pct;
@@ -2130,6 +2183,30 @@ const TOOLS = [
       required: ["name", "slug"],
     },
   },
+  {
+    name: "archive_kb_scope",
+    description:
+      "Archive (reversible soft-delete) a knowledge-only project scope (kind: kb) you own, on the agent key. Frees the scope's slot in the tenant's max_projects budget so you can reclaim KB-scope capacity — the reverse of create_kb_scope. Its articles remain readable/writable; restore_kb_scope re-activates it. Rejects a kind: work project (422) — archiving a work project stays human-anchored. Idempotent on an already-archived scope.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "UUID of the :kb scope to archive." },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "restore_kb_scope",
+    description:
+      "Restore (re-activate) an archived knowledge-only project scope (kind: kb) you own, on the agent key — the reverse of archive_kb_scope. Re-activating consumes an active max_projects slot, so it is rejected (422) when the tenant is at its cap. Rejects a kind: work project (422).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "UUID of the archived :kb scope to restore." },
+      },
+      required: ["project_id"],
+    },
+  },
   {
     name: "delete_project",
     description:
@@ -2703,6 +2780,41 @@ const TOOLS = [
       required: [],
     },
   },
+  {
+    name: "get_ingestion_anomalies",
+    description:
+      "Get ingestion-health anomalies — capture-silence (a source_type that was producing " +
+      "articles has gone silent). Use to check whether knowledge capture is still landing. " +
+      "Paginated (page/page_size); advance `page` to enumerate all. Filter by source_type, " +
+      "anomaly_type, resolved status, or include archived.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source_type: {
+          type: "string",
+          description: 'Optional: filter to one article source_type (e.g. "session_log").',
+        },
+        anomaly_type: {
+          type: "string",
+          enum: ["capture_silence"],
+          description: 'Optional: filter by anomaly type (only "capture_silence" is currently produced).',
+        },
+        resolved: {
+          type: "string",
+          enum: ["false", "true", "all"],
+          description:
+            'Which anomalies to return: "false" = unresolved only (default), "true" = resolved only, "all" = both.',
+        },
+        include_archived: {
+          type: "boolean",
+          description: "Optional: include archived (retired-source) anomalies (default false).",
+        },
+        page: { type: "integer", description: "Page number (default 1)." },
+        page_size: { type: "integer", description: "Anomalies per page (default 20, max 100)." },
+      },
+      required: [],
+    },
+  },
   {
     name: "set_token_budget",
     description:
@@ -4893,6 +5005,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     case "create_kb_scope":
       return await createKbScope(args);
 
+    case "archive_kb_scope":
+      return await archiveKbScope(args);
+
+    case "restore_kb_scope":
+      return await restoreKbScope(args);
+
     case "delete_project":
       return await deleteProject(args);
 
@@ -4965,6 +5083,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     case "get_cost_anomalies":
       return await getCostAnomalies(args);
 
+    case "get_ingestion_anomalies":
+      return await getIngestionAnomalies(args);
+
     case "set_token_budget":
       return await setTokenBudget(args);
 

package/package.json

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