@thehammer/danx-dashboard-mcp 0.1.28 → 0.1.31

package/dist/handlers.js

@@ -66,6 +66,40 @@ export async function issueGet(client, args) {
         board: args.board,
     });
 }
+// ---------------- repo_knowledge_get / repo_knowledge_set ----------------
+const REPO_KNOWLEDGE_BASE_PATH = "/api/repo-knowledge";
+/**
+ * Fetch the board's working-knowledge doc via GET /api/repo-knowledge
+ * (DX-1128, Story 2). Mirrors `issueGet` — a bare board-scoped GET, no id
+ * (the doc is 1-per-board). Board resolves the same way every other tool's
+ * `board` arg does: per-call override, else the dispatch's env-derived board.
+ */
+export async function repoKnowledgeGet(client, args = {}) {
+    return client.request({
+        method: "GET",
+        path: "",
+        basePath: REPO_KNOWLEDGE_BASE_PATH,
+        board: args.board,
+    });
+}
+/**
+ * Write the board's working-knowledge doc via PUT /api/repo-knowledge
+ * (DX-1128, Story 2). Mirrors `issueEdit`'s shape (a PATCH-like body write)
+ * but targets the repo-knowledge route family, not `/api/issues`. The
+ * server's optimistic-concurrency guard rejects a stale `base_hash` — the
+ * refusal envelope (`{ok: false, body: {error, currentHash}}`) passes
+ * through verbatim so the caller can re-get, re-merge, and retry.
+ */
+export async function repoKnowledgeSet(client, args) {
+    const { board, ...body } = args;
+    return client.request({
+        method: "PUT",
+        path: "",
+        basePath: REPO_KNOWLEDGE_BASE_PATH,
+        body,
+        board,
+    });
+}
 export async function issueCreate(client, args, defaultBoard) {
     // Resolve the target board ONCE: per-call `args.board` override (a
     // qualified `<repo>:<slug>` id) wins, else the dispatch's env-derived

package/dist/http-client.js

@@ -6,7 +6,7 @@ export class DashboardHttpClient {
         this.fetchImpl = fetchImpl;
     }
     async request(args) {
-        const url = this.buildUrl(args.path, args.query, args.board);
+        const url = this.buildUrl(args.path, args.query, args.board, args.basePath);
         const headers = {
             Authorization: `Bearer ${this.config.token}`,
             Accept: "application/json",
@@ -54,7 +54,7 @@ export class DashboardHttpClient {
         }
         return { ok: false, status: res.status, body: parsed };
     }
-    buildUrl(path, extraQuery, boardOverride) {
+    buildUrl(path, extraQuery, boardOverride, basePath = "/api/issues") {
         const base = this.config.baseUrl.replace(/\/+$/, "");
         const [rawPath, existingQs] = path.split("?", 2);
         let cleanPath;
@@ -73,6 +73,6 @@ export class DashboardHttpClient {
                 params.set(k, String(v));
             }
         }
-        return `${base}/api/issues${cleanPath}?${params.toString()}`;
+        return `${base}${basePath}${cleanPath}?${params.toString()}`;
     }
 }

package/dist/index.js

@@ -24,6 +24,8 @@
  *   - issue_quality_gate     POST   /api/issues/:id/quality-gates/:gate
  *   - issue_retro            PUT    /api/issues/:id/retro
  *   - issue_attach           POST   /api/issues/:id/attachments (reads a local file)
+ *   - repo_knowledge_get     GET    /api/repo-knowledge
+ *   - repo_knowledge_set     PUT    /api/repo-knowledge (DX-1128, Story 2)
  *
  * BOARD-ONLY (DX-1171): board is the first-level concept; repo is
  * DERIVED from board server-side, never passed. The package composes the
@@ -53,7 +55,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { DashboardHttpClient } from "./http-client.js";
-import { issueAttach, issueChecklist, issueComment, issueCreate, issueDependency, issueEdit, issueGet, issueList, issueQualityGate, issueRequiresHuman, issueRetro, issueTransition, issueTriage, } from "./handlers.js";
+import { issueAttach, issueChecklist, issueComment, issueCreate, issueDependency, issueEdit, issueGet, issueList, issueQualityGate, issueRequiresHuman, issueRetro, issueTransition, issueTriage, repoKnowledgeGet, repoKnowledgeSet, } from "./handlers.js";
 import { PRIORITY_TIER_WORDS } from "./priority.js";
 function readEnvOrDie(name) {
     const v = process.env[name];
@@ -379,6 +381,19 @@ server.tool("issue_attach", "Attach a LOCAL file to an issue card via POST /api/
         .describe("Absolute path to a local file on the dispatch's shared filesystem (must start with `/`)."),
     ...boardField,
 }, async (args) => jsonResult(await issueAttach(client, args)));
+// ---------------- repo_knowledge_get ----------------
+server.tool("repo_knowledge_get", "Fetch the board's working-knowledge markdown doc via GET /api/repo-knowledge (DX-1128, Story 2). Board-scoped; defaults to the dispatch's board. Pass `board` (a qualified id `<repo>:<slug>`) to read another board's doc. Returns `{ok, status, body: {content, contentHash, updatedAt, updatedBy, boardId}}` — an unset doc reads as the empty view (`content: \"\"`, `contentHash: \"\"`), NOT a 404. Ground exploratory answers in `content`; before `repo_knowledge_set`, ALWAYS `repo_knowledge_get` immediately first and pass its `contentHash` back as `base_hash` — the server's optimistic-concurrency guard rejects a stale write.", {
+    ...boardField,
+}, async (args) => jsonResult(await repoKnowledgeGet(client, args)));
+// ---------------- repo_knowledge_set ----------------
+server.tool("repo_knowledge_set", 'Write the board\'s working-knowledge markdown doc via PUT /api/repo-knowledge (DX-1128, Story 2). Board-scoped; defaults to the dispatch\'s board. `base_hash` MUST be the `contentHash` from the immediately-prior `repo_knowledge_get` call ("" for the true first write, when the board has no doc yet) — the server compares it against the CURRENT hash and, on mismatch, fails loud with `{ok: false, body: {error: "stale_repo_knowledge", currentHash}}` rather than silently overwriting a concurrent write. On that refusal: re-`repo_knowledge_get`, re-merge your insight into the fresh content, and retry `repo_knowledge_set` with the new hash. On success, persists to the DB, publishes `repo-knowledge:updated` over SSE (live in the dashboard editor), and returns the new view.', {
+    content: z.string(),
+    base_hash: z
+        .string()
+        .optional()
+        .describe('The contentHash last read via repo_knowledge_get ("" for a true first write). Omitted also normalizes to "" server-side, so it only succeeds against an empty/absent doc — always get immediately before set.'),
+    ...boardField,
+}, async (args) => jsonResult(await repoKnowledgeSet(client, args)));
 // ---------------- main ----------------
 async function main() {
     boot();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/danx-dashboard-mcp",
-  "version": "0.1.28",
+  "version": "0.1.31",
   "description": "Stdio MCP server wrapping danxbot's dashboard /api/issues/* normalized DB-backed HTTP routes for dispatched agents (DX-704 Phase 2).",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@modelcontextprotocol/sdk": "1.29.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {