@bli-cockpit/mcp 0.1.94 → 0.1.95

package/README.md

@@ -109,7 +109,7 @@ about what an agent can reach.
 
 <!-- BEGIN GENERATED verb census — `npm run mcp:readme` -->
 
-**125 of 130 Tower verbs have an MCP twin.**
+**126 of 131 Tower verbs have an MCP twin.**
 Each tool goes through the SAME door its CLI verb calls, with the same
 collector device token — never a second route and never a service-role
 reader. `src/verb-census.test.ts` fails when a verb is in none of the
@@ -117,6 +117,7 @@ three tables below.
 
 | CLI verb | MCP tool | Door |
 | --- | --- | --- |
+| `cockpit brain status` | `brain_status` | `GET /api/brain/incidents` |
 | `cockpit brief done` | `brief_done` | `POST /api/jarvis/ticks` |
 | `cockpit brief history` | `brief_history` | `GET /api/jarvis/brief?history=1` |
 | `cockpit brief read` | `brief_read` | `GET /api/jarvis/brief` |

package/dist/brain-tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDeps } from "./tool-result.js";
+export declare function registerBrainTools(server: {
+    registerTool: (...args: never[]) => unknown;
+}, deps: ToolDeps): void;

package/dist/brain-tools.js

@@ -0,0 +1,39 @@
+/**
+ * `brain_status`, the twin of `cockpit brain status` (BLI-12859, slice 1).
+ *
+ * Tower's incident queue over the SAME door the CLI reads: `GET /api/brain/incidents`, on the
+ * collector's device token, never a second route. Per project: how many incidents are open, being
+ * worked, waiting on a person, fixed, not actionable or cleared; the newest ones (default open)
+ * with their Tower issue, count, last-seen time and masked template; and the last 7 days of
+ * verdicts. Read-only. The text half is plain words; the structured half carries the raw labels.
+ */
+import { z } from "zod";
+import { callAgentDoor } from "./agent-door.js";
+import { dataResult, doorFailureText, errorResult, registrarFor, withSession } from "./tool-result.js";
+const STATUSES = ["open", "running", "needs_human", "fixed", "not_actionable", "cleared"];
+export function registerBrainTools(server, deps) {
+    registrarFor(server)("brain_status", {
+        title: "Read Tower's incident queue",
+        description: "Tower's incident queue over every project's log digests. Every 15 minutes the log-digest cron turns each recurring problem (classes our_bug, config_drift, capacity, "
+            + "unknown) into ONE incident with ONE Tower issue; a repeat adds to its count and never opens a twin, and a template quiet for 24 hours is cleared. Returns, per project, "
+            + "the count of incidents by status (open, running, needs_human, fixed, not_actionable, cleared), the newest incidents in the `show` status (default open) with their Tower "
+            + "issue identifier, class, how many times each was seen, when it was last seen and its masked template, and how many verdicts landed in the last 7 days. "
+            + "`project` narrows to one project (see logs_digest for the ids). Read-only. `cockpit brain status`, same door.",
+        inputSchema: {
+            project: z.string().regex(/^[a-z][a-z0-9-]{1,40}$/).optional().describe("A registry project id, like pearl-portal or kolm. Omit for every project with an incident."),
+            show: z.enum(STATUSES).optional().describe("Which status the newest-incidents list shows. Default open."),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const query = new URLSearchParams();
+        if (typeof args.project === "string")
+            query.set("project", args.project);
+        if (typeof args.show === "string")
+            query.set("status", args.show);
+        const asked = query.toString();
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", asked ? `/api/brain/incidents?${asked}` : "/api/brain/incidents");
+        if (!response.ok)
+            return errorResult(doorFailureText("brain_status", response));
+        const text = typeof response.body.text === "string" ? response.body.text : "";
+        return dataResult(text, response.body);
+    }));
+}

package/dist/server.js

@@ -35,6 +35,7 @@ import { registerCareersTools } from "./careers-tools.js";
 import { registerRenameTools } from "./rename-tools.js";
 import { registerUsageTools } from "./usage-tools.js";
 import { registerLogsTools } from "./logs-tools.js";
+import { registerBrainTools } from "./brain-tools.js";
 import { registerSourcesTools } from "./sources-tools.js";
 import { TOWER_SERVER_ICONS } from "./server-icons.js";
 import { installToolRegistration } from "./tool-registration.js";
@@ -504,5 +505,8 @@ export function createServer(deps, options = {}) {
     // BLI-12833: a token-cheap digest of Tower's own logs, read on this machine
     // with the shared `@bli-cockpit/telemetry-core/log-digest`. Read-only; not on the hosted server.
     registerLogsTools(server, { fetchImpl: deps.fetchImpl });
+    // BLI-12859: Tower's incident queue (one incident, one issue, per recurring log problem), over
+    // the same GET /api/brain/incidents door `cockpit brain status` reads. Read-only.
+    registerBrainTools(server, { fetchImpl: deps.fetchImpl });
     return server;
 }

package/dist/tool-catalog.d.ts

@@ -10,7 +10,7 @@
  * from `src/` under Node's type stripping, so it may import nothing.
  */
 /** Tools that change nothing. The smoke calls every one. */
-export declare const READ_TOOLS: readonly ["get_ticket_timeline", "get_active_tickets", "docs_list", "docs_tree", "docs_read", "docs_sync_status", "msg_channels", "msg_read", "msg_thread", "work_list_issues", "work_get_issue", "work_issue_history", "work_list_projects", "careers_list", "careers_show", "careers_resume_url", "careers_takehome_show", "careers_settings_show", "rename_pending", "github_pr", "usage_people", "usage_sessions", "mail_accounts", "mail_inbox", "mail_read", "mail_search", "mail_attachment", "mail_sync_status", "cal_today", "cal_week", "cal_next", "cal_find", "cal_calendars", "cal_sync_status", "jarvis_ask", "jarvis_trace", "jarvis_check", "models_list", "models_card", "models_compare", "brief_read", "brief_history", "brief_status", "brief_missed", "notes_folders", "notes_list", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "notes_sync_status", "notes_granola_status", "ops_status", "slack_coverage", "slack_read", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search", "sources_check", "logs_digest"];
+export declare const READ_TOOLS: readonly ["get_ticket_timeline", "get_active_tickets", "docs_list", "docs_tree", "docs_read", "docs_sync_status", "msg_channels", "msg_read", "msg_thread", "work_list_issues", "work_get_issue", "work_issue_history", "work_list_projects", "careers_list", "careers_show", "careers_resume_url", "careers_takehome_show", "careers_settings_show", "rename_pending", "github_pr", "usage_people", "usage_sessions", "mail_accounts", "mail_inbox", "mail_read", "mail_search", "mail_attachment", "mail_sync_status", "cal_today", "cal_week", "cal_next", "cal_find", "cal_calendars", "cal_sync_status", "jarvis_ask", "jarvis_trace", "jarvis_check", "models_list", "models_card", "models_compare", "brief_read", "brief_history", "brief_status", "brief_missed", "notes_folders", "notes_list", "notes_show", "notes_shelf", "notes_shelves", "notes_place", "notes_accounts", "notes_sync_status", "notes_granola_status", "ops_status", "slack_coverage", "slack_read", "memory_profile", "memory_consolidation", "settings_show", "settings_list", "model_show", "team_members", "team_device_list", "scout_board", "workbook_read", "tower_search", "sources_check", "logs_digest", "brain_status"];
 /**
  * Tools that write, but answer a dry run that writes nothing. The smoke calls
  * each one ONLY with its dry-run flag set (`scripts/smoke.ts` says which).

package/dist/tool-catalog.js

@@ -80,6 +80,8 @@ export const READ_TOOLS = [
     "sources_check",
     // BLI-12833: a digest of Tower's own logs, read on this machine. Reads only.
     "logs_digest",
+    // BLI-12859: Tower's incident queue, per project. Reads only.
+    "brain_status",
 ];
 /**
  * Tools that write, but answer a dry run that writes nothing. The smoke calls

package/dist/verb-census.js

@@ -243,6 +243,7 @@ export const MCP_TWINS = {
     // this machine's collector logs and the `vercel` / `railway` CLIs.
     // BLI-12855: a project name (or --stored, or a local CLI that is missing) reads the digests Tower's cron stored, through GET /api/logs.
     "logs": { tool: "logs_digest", door: "LOCAL @bli-cockpit/telemetry-core/log-digest (this machine's logs); `project` reads GET /api/logs (the stored digests)" },
+    "brain status": { tool: "brain_status", door: "GET /api/brain/incidents" },
     "usage sessions": { tool: "usage_sessions", door: "GET /api/usage/sessions" },
     "usage people": { tool: "usage_people", door: "GET /api/usage/people" },
     "docs list": { tool: "docs_list", door: "GET /api/docs/documents" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/mcp",
-  "version": "0.1.94",
+  "version": "0.1.95",
   "private": false,
   "description": "bli-tower: an MCP server over BLI Cockpit's agent doors: JARVIS (jarvis_*), documents (docs_*), channels (msg_*), issues (work_*), the daily page (brief_*), meeting notes (notes_*), the ops board (ops_status/slack_*), settings/team/model, Scout and the workbook, plus the legacy event-stream tools (emit_event, get_ticket_timeline, get_active_tickets).",
   "type": "module",
@@ -37,7 +37,7 @@
     "readme": "npm run build && node scripts/write-readme-census.mjs"
   },
   "dependencies": {
-    "@bli-cockpit/telemetry-core": "0.1.64",
+    "@bli-cockpit/telemetry-core": "0.1.65",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6"
   },