loopctl-mcp-server 2.44.0 → 2.46.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) and high_reject_rate (writes rejected at high rate, persisting no article row). Check whether knowledge capture is still landing AND being accepted. |
 | `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

@@ -824,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;
@@ -2751,6 +2780,47 @@ const TOOLS = [
       required: [],
     },
   },
+  {
+    name: "get_ingestion_anomalies",
+    description:
+      "Get ingestion-health anomalies — capture_silence (a source_type that was producing " +
+      "articles has gone silent) and high_reject_rate (writes attempted but rejected at high " +
+      "rate — 409 title_conflict / validation drops that persist no article row). Use to check " +
+      "whether knowledge capture is still landing AND being accepted. 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",
+          // Keep in sync with Loopctl.Knowledge.IngestionAnomaly @anomaly_types (the
+          // server-side Ecto.Enum + the ingestion_anomalies_anomaly_type_check DB CHECK).
+          enum: ["capture_silence", "high_reject_rate"],
+          description:
+            'Optional: filter by anomaly type — "capture_silence" (writes stopped) or ' +
+            '"high_reject_rate" (writes rejected at high rate).',
+        },
+        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:
@@ -5019,6 +5089,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.44.0",
+  "version": "2.46.0",
   "description": "MCP server for loopctl — structural trust for AI development loops",
   "type": "module",
   "main": "index.js",