@thehammer/danx-dashboard-mcp 0.1.47 → 0.1.48

package/dist/handlers.js

@@ -95,49 +95,49 @@ export async function repoKnowledgeSet(client, args) {
         board,
     });
 }
-// ---------------- master_plan_list / master_plan_get_page / master_plan_set_page ----------------
-const MASTER_PLAN_BASE_PATH = "/api/master-plan";
+// ---------------- brief_list / brief_get_page / brief_set_page ----------------
+const BRIEF_BASE_PATH = "/api/brief";
 /**
- * List the board's named Master Plan pages via GET /api/master-plan (DX-2083).
+ * List the board's named Brief pages via GET /api/brief (DX-2083).
  * Mirrors `repoKnowledgeGet`'s shape (a bare board-scoped GET, no id) but
  * targets the list-shaped sibling surface — many named pages per board,
  * not one document.
  */
-export async function masterPlanList(client, args = {}) {
+export async function briefList(client, args = {}) {
     return client.request({
         method: "GET",
         path: "",
-        basePath: MASTER_PLAN_BASE_PATH,
+        basePath: BRIEF_BASE_PATH,
         board: args.board,
     });
 }
 /**
- * Fetch one Master Plan page by slug via GET /api/master-plan/page?slug=
+ * Fetch one Brief page by slug via GET /api/brief/page?slug=
  * (DX-2083). A missing row (including a not-yet-created page) reads as the
  * same empty-view convention `repoKnowledgeGet` uses — never a 404.
  */
-export async function masterPlanGetPage(client, args) {
+export async function briefGetPage(client, args) {
     return client.request({
         method: "GET",
         path: "/page",
-        basePath: MASTER_PLAN_BASE_PATH,
+        basePath: BRIEF_BASE_PATH,
         query: { slug: args.slug },
         board: args.board,
     });
 }
 /**
- * Write one Master Plan page via PUT /api/master-plan/page?slug= (DX-2083).
+ * Write one Brief page via PUT /api/brief/page?slug= (DX-2083).
  * Mirrors `repoKnowledgeSet`'s shape (optimistic-concurrency `base_hash`,
  * verbatim 409 passthrough on a stale write) but targets one named page
  * instead of the board's single working-knowledge doc. `slug` rides the
  * query string (matching the route), never the body.
  */
-export async function masterPlanSetPage(client, args) {
+export async function briefSetPage(client, args) {
     const { slug, board, ...body } = args;
     return client.request({
         method: "PUT",
         path: "/page",
-        basePath: MASTER_PLAN_BASE_PATH,
+        basePath: BRIEF_BASE_PATH,
         query: { slug },
         body,
         board,

package/dist/index.js

@@ -28,9 +28,9 @@
  *   - 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)
- *   - master_plan_list       GET    /api/master-plan
- *   - master_plan_get_page   GET    /api/master-plan/page (DX-2083 / DX-2484)
- *   - master_plan_set_page   PUT    /api/master-plan/page (DX-2083 / DX-2484)
+ *   - brief_list       GET    /api/brief
+ *   - brief_get_page   GET    /api/brief/page (DX-2083 / DX-2484)
+ *   - brief_set_page   PUT    /api/brief/page (DX-2083 / DX-2484)
  *   - plan_list              GET    /api/plans (DX-2683)
  *   - plan_get               GET    /api/plans/:id/full | /api/plans/mine
  *   - plan_connect           POST   /api/plan-sessions/me/plan
@@ -75,7 +75,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, issueQualityGateVerdict, issueRequiresHuman, issueRetro, issueTransition, issueTriage, masterPlanGetPage, masterPlanList, masterPlanSetPage, planAddCard, planAddRecord, planConnect, planGet, planList, planSetArchitecture, repoKnowledgeGet, repoKnowledgeSet, } from "./handlers.js";
+import { issueAttach, issueChecklist, issueComment, issueCreate, issueDependency, issueEdit, issueGet, issueList, issueQualityGate, issueQualityGateVerdict, issueRequiresHuman, issueRetro, issueTransition, issueTriage, briefGetPage, briefList, briefSetPage, planAddCard, planAddRecord, planConnect, planGet, planList, planSetArchitecture, repoKnowledgeGet, repoKnowledgeSet, } from "./handlers.js";
 import { PRIORITY_TIER_WORDS } from "./priority.js";
 function readEnvOrDie(name) {
     const v = process.env[name];
@@ -522,20 +522,20 @@ server.tool("repo_knowledge_set", 'Write the board\'s working-knowledge markdown
         .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)));
-// ---------------- master_plan_list ----------------
-server.tool("master_plan_list", "List the board's named Master Plan pages via GET /api/master-plan (DX-2083 / DX-2484). Board-scoped; defaults to the dispatch's board. Pass `board` (a qualified id `<repo>:<slug>`) to list another board's pages. Returns `{boardId, pages: [{slug, title, contentHash, sortOrder, updatedAt, updatedBy}]}` — metadata only, no page content (use `master_plan_get_page` for that). This is the list+page-shaped sibling of `repo_knowledge_get`/`repo_knowledge_set` (one board-level doc) — Master Plan pages are MANY named pages per board (the Goals / Architecture / Rules / Caveats tabs), keyed by `(board, slug)`. The reserved `index` slug always exists — every board carries exactly one.", {
+// ---------------- brief_list ----------------
+server.tool("brief_list", "List the board's named Brief pages via GET /api/brief (DX-2083 / DX-2484). Board-scoped; defaults to the dispatch's board. Pass `board` (a qualified id `<repo>:<slug>`) to list another board's pages. Returns `{boardId, pages: [{slug, title, contentHash, sortOrder, updatedAt, updatedBy}]}` — metadata only, no page content (use `brief_get_page` for that). This is the list+page-shaped sibling of `repo_knowledge_get`/`repo_knowledge_set` (one board-level doc) — Brief pages are MANY named pages per board (the Goals / Architecture / Rules / Caveats tabs), keyed by `(board, slug)`. The reserved `index` slug always exists — every board carries exactly one.", {
     ...boardField,
-}, async (args) => jsonResult(await masterPlanList(client, args)));
-// ---------------- master_plan_get_page ----------------
-server.tool("master_plan_get_page", 'Fetch one Master Plan page by slug via GET /api/master-plan/page?slug=<slug> (DX-2083 / DX-2484). Board-scoped; defaults to the dispatch\'s board. Returns `{boardId, slug, title, content, contentHash, sortOrder, updatedAt, updatedBy}` — a missing/not-yet-created page reads as the empty view (`content: ""`, `contentHash: ""`), NOT a 404, matching `repo_knowledge_get`\'s convention. Before `master_plan_set_page`, ALWAYS `master_plan_get_page` immediately first and pass its `contentHash` back as `base_hash` — the server\'s optimistic-concurrency guard rejects a stale write.', {
+}, async (args) => jsonResult(await briefList(client, args)));
+// ---------------- brief_get_page ----------------
+server.tool("brief_get_page", 'Fetch one Brief page by slug via GET /api/brief/page?slug=<slug> (DX-2083 / DX-2484). Board-scoped; defaults to the dispatch\'s board. Returns `{boardId, slug, title, content, contentHash, sortOrder, updatedAt, updatedBy}` — a missing/not-yet-created page reads as the empty view (`content: ""`, `contentHash: ""`), NOT a 404, matching `repo_knowledge_get`\'s convention. Before `brief_set_page`, ALWAYS `brief_get_page` immediately first and pass its `contentHash` back as `base_hash` — the server\'s optimistic-concurrency guard rejects a stale write.', {
     slug: z
         .string()
         .min(1)
         .describe("The page's slug. The reserved `index` slug always exists on every board."),
     ...boardField,
-}, async (args) => jsonResult(await masterPlanGetPage(client, args)));
-// ---------------- master_plan_set_page ----------------
-server.tool("master_plan_set_page", 'Write one Master Plan page via PUT /api/master-plan/page?slug=<slug> (DX-2083 / DX-2484). Board-scoped; defaults to the dispatch\'s board. Body: `{content, title?, sortOrder?, base_hash?}` — mirrors `repo_knowledge_set`\'s optimistic-concurrency shape but targets one named page instead of the board\'s single working-knowledge doc. `base_hash` MUST be the `contentHash` from the immediately-prior `master_plan_get_page` call ("" for a true first write, when the page doesn\'t exist yet) — the server compares it against the CURRENT hash and, on mismatch, fails loud with `{ok: false, body: {error: "stale_master_plan_page", currentHash}}` rather than silently overwriting a concurrent write — re-get, re-merge, and retry on that refusal, never retry blindly or overwrite. On success, persists to the DB, publishes `master-plan:updated` over SSE, and returns the new view. NO delete tool is exposed on this surface — the reserved `index` slug can never be deleted through the tool surface, matching the route\'s own refusal; deleting a non-index page is dashboard-UI-only for now.', {
+}, async (args) => jsonResult(await briefGetPage(client, args)));
+// ---------------- brief_set_page ----------------
+server.tool("brief_set_page", 'Write one Brief page via PUT /api/brief/page?slug=<slug> (DX-2083 / DX-2484). Board-scoped; defaults to the dispatch\'s board. Body: `{content, title?, sortOrder?, base_hash?}` — mirrors `repo_knowledge_set`\'s optimistic-concurrency shape but targets one named page instead of the board\'s single working-knowledge doc. `base_hash` MUST be the `contentHash` from the immediately-prior `brief_get_page` call ("" for a true first write, when the page doesn\'t exist yet) — the server compares it against the CURRENT hash and, on mismatch, fails loud with `{ok: false, body: {error: "stale_brief_page", currentHash}}` rather than silently overwriting a concurrent write — re-get, re-merge, and retry on that refusal, never retry blindly or overwrite. On success, persists to the DB, publishes `brief:updated` over SSE, and returns the new view. NO delete tool is exposed on this surface — the reserved `index` slug can never be deleted through the tool surface, matching the route\'s own refusal; deleting a non-index page is dashboard-UI-only for now.', {
     slug: z
         .string()
         .min(1)
@@ -546,9 +546,9 @@ server.tool("master_plan_set_page", 'Write one Master Plan page via PUT /api/mas
     base_hash: z
         .string()
         .optional()
-        .describe('The contentHash last read via master_plan_get_page ("" for a true first write). Omitted also normalizes to "" server-side, so it only succeeds against an empty/absent page — always get immediately before set.'),
+        .describe('The contentHash last read via brief_get_page ("" for a true first write). Omitted also normalizes to "" server-side, so it only succeeds against an empty/absent page — always get immediately before set.'),
     ...boardField,
-}, async (args) => jsonResult(await masterPlanSetPage(client, args)));
+}, async (args) => jsonResult(await briefSetPage(client, args)));
 // ---------------- plans (DX-2683) ----------------
 // THE BINDING ASYMMETRY IS IN THE SCHEMAS, NOT IN PROSE. `plan_get` takes an
 // optional `plan_id`; `plan_add_record`, `plan_add_card` and
@@ -556,7 +556,7 @@ server.tool("master_plan_set_page", 'Write one Master Plan page via PUT /api/mas
 // cannot even express "write to that other plan". `plan_connect` takes one
 // because binding a session to a plan is the one operation that is ABOUT a
 // plan id — and it can only ever bind the caller's own session.
-server.tool("plan_list", "List every plan via GET /api/plans (DX-2683), and learn which plan THIS session is connected to. Plans are GLOBAL, not board-scoped: a plan is a named, dated set of cards an operator assembled by hand, and its cards may come from any repository. Returns `{ok, status, body: {plans: [{id, name, createdAt, cardCount, boards}], session}}`. `session` is your own registration — `{sessionId, title, planId, planName, firstSeenAt, lastActiveAt}` — or `null` if this process is not running inside a Claude Code session. A `planId` of null means you are connected to no plan: read any plan with `plan_get`, then `plan_connect` to the one you are working on (or ask the operator to connect you from the Plans list). NOTE this is NOT the board Master Plan (`master_plan_list`), which is a different feature entirely.", {}, async () => jsonResult(await planList(client)));
+server.tool("plan_list", "List every plan via GET /api/plans (DX-2683), and learn which plan THIS session is connected to. Plans are GLOBAL, not board-scoped: a plan is a named, dated set of cards an operator assembled by hand, and its cards may come from any repository. Returns `{ok, status, body: {plans: [{id, name, createdAt, cardCount, boards}], session}}`. `session` is your own registration — `{sessionId, title, planId, planName, firstSeenAt, lastActiveAt}` — or `null` if this process is not running inside a Claude Code session. A `planId` of null means you are connected to no plan: read any plan with `plan_get`, then `plan_connect` to the one you are working on (or ask the operator to connect you from the Plans list). NOTE this is NOT the board Brief (`brief_list`), which is a different feature entirely.", {}, async () => jsonResult(await planList(client)));
 server.tool("plan_get", "Read one plan WHOLE via GET /api/plans (DX-2683) — its member cards (with the boards they cover), its goals, rules and caveats, its architecture document, the sessions working on it, and your own session state. One call, not five. Pass `plan_id` to read ANY plan (browsing another plan is useful and changes nothing); OMIT it to read the plan this session is connected to. Omitting it while connected to no plan fails loud with `{error: \"session_not_connected\"}` — connect first. Returns `{plan, cards, boards, records: {goal: [], rule: [], caveat: []}, architecture: {content, contentHash, updatedAt, updatedBy}, sessions, session}`. ALWAYS `plan_get` immediately before `plan_set_architecture` and pass the returned `architecture.contentHash` back as `base_hash`.", {
     plan_id: z
         .number()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/danx-dashboard-mcp",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "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",