@bli-cockpit/mcp 0.1.2 → 0.1.3

package/dist/work-tools.js

@@ -15,8 +15,8 @@
  * server's other tools and only a `work_` call fails, by name.
  */
 import { z } from "zod";
-import { loadAgentDoorSession } from "./agent-door-session.js";
 import { callAgentDoor } from "./agent-door.js";
+import { doorFailureText, errorResult, registrarFor, textResult, withSession, } from "./tool-result.js";
 /** The closed state vocabulary, verbatim from `lib/work/api-doors.ts` `WORK_ISSUE_STATES`. */
 export const WORK_ISSUE_STATES = [
     "backlog",
@@ -26,30 +26,17 @@ export const WORK_ISSUE_STATES = [
     "done",
     "canceled",
 ];
-function textResult(text, structured) {
-    return { content: [{ type: "text", text }], ...(structured ? { structuredContent: structured } : {}) };
-}
-function errorResult(text) {
-    return { isError: true, content: [{ type: "text", text }] };
-}
-async function withSession(deps, run) {
-    const loadSession = deps.loadSession ?? loadAgentDoorSession;
-    const loaded = loadSession();
-    if (!loaded.ok)
-        return errorResult(`This machine is not paired with Tower (${loaded.reason}). ${loaded.message}`);
-    return run(loaded.session);
-}
-function doorFailureText(door, response) {
-    if (response.transportError) {
-        return `Tower could not be reached for ${door} (${response.transportError}). Nothing was read or written.`;
+/**
+ * A row the Linear import could not give state names to says which it is.
+ * Printing "(none) -> (none)" is honest and useless; naming the gap keeps
+ * nobody reading a real gap as a broken tool (`commands/issue.ts` says the
+ * same thing in the same words).
+ */
+function historyChange(row) {
+    if (row.from_value === null && row.to_value === null) {
+        return `(no state names recorded — imported from ${row.source ?? "elsewhere"})`;
     }
-    const reason = typeof response.body.reason === "string"
-        ? response.body.reason
-        : typeof response.body.error === "string"
-            ? response.body.error
-            : "unknown_error";
-    const message = typeof response.body.message === "string" ? response.body.message : `Tower answered ${response.status}.`;
-    return `Tower refused ${door} (${reason}): ${message}`;
+    return `${row.from_value ?? "(none)"} -> ${row.to_value ?? "(none)"}`;
 }
 /** A project id from a project NAME or a uuid — exact after case-folding, never fuzzy. */
 async function resolveProjectId(deps, session, ref) {
@@ -67,7 +54,7 @@ const ISSUE_REF = z
     .max(200)
     .describe("A BLI-#### identifier (e.g. BLI-3654) or an issue's uuid. Both work.");
 export function registerWorkTools(server, deps) {
-    const register = server.registerTool.bind(server);
+    const register = registrarFor(server);
     register("work_list_issues", {
         title: "List Tower issues",
         description: "Issues you may see, most recently updated first. Filter by state, assignee (\"me\", \"unassigned\", or a uuid) "
@@ -219,6 +206,29 @@ export function registerWorkTools(server, deps) {
         const comment = response.body.comment;
         return textResult(`Commented on ${ref} (${comment?.id ?? "?"}).`, { comment });
     }));
+    register("work_issue_history", {
+        title: "Read a Tower issue's history",
+        description: "Every recorded change to one issue — state moves, assignee changes — newest first, with who made it and "
+            + "when. History rows are never rewritten; a row imported without state names says so rather than showing "
+            + "\"(none) -> (none)\".",
+        inputSchema: {
+            id: ISSUE_REF,
+            limit: z.number().int().min(1).max(500).optional(),
+        },
+    }, async (args) => withSession(deps, async (session) => {
+        const ref = String(args.id ?? "");
+        const query = typeof args.limit === "number" ? `?limit=${args.limit}` : "";
+        const response = await callAgentDoor(session, deps.fetchImpl, "GET", `/api/work/issues/${encodeURIComponent(ref)}/history${query}`);
+        if (!response.ok)
+            return errorResult(doorFailureText("work_issue_history", response));
+        const history = (Array.isArray(response.body.history) ? response.body.history : []);
+        const lines = history
+            .map((row) => `${row.occurred_at ?? "?"}  ${(row.change_type ?? "?").padEnd(9)}  ${historyChange(row)}  `
+            + `${row.actor_name ?? ""}`)
+            .map((line) => line.trimEnd())
+            .join("\n");
+        return textResult(`${history.length} change(s) on ${ref}.${lines ? `\n${lines}` : ""}`, { history });
+    }));
     register("work_list_projects", {
         title: "List Tower projects",
         description: "The projects issues are filed under. Use a project's name with work_list_issues or work_create_issue.",

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@bli-cockpit/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
-  "description": "bli-tower — an MCP server over BLI Cockpit's agent doors: JARVIS (jarvis_*), documents (docs_*), channels (msg_*), issues (work_*), plus the legacy event-stream tools (emit_event, get_ticket_timeline, get_active_tickets).",
+  "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",
   "bin": {
     "bli-cockpit-mcp": "./dist/index.js"
@@ -25,10 +25,11 @@
     "typecheck": "tsc --noEmit",
     "pretest": "node ../../scripts/build-workspace-dep.mjs @bli-cockpit/telemetry-core",
     "test": "vitest run",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "readme": "npm run build && node scripts/write-readme-census.mjs"
   },
   "dependencies": {
-    "@bli-cockpit/telemetry-core": "0.1.28",
+    "@bli-cockpit/telemetry-core": "0.1.29",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6"
   },