@thehammer/danx-dashboard-mcp 0.1.196 → 0.1.197

package/dist/danxbot-api-examples.js

@@ -8,6 +8,10 @@
  * 36 KB `danxbot_api_list`) because nothing an agent
  * reads before its first call showed the right shape. The tool description
  * is the one surface every profile and every operator session carries.
+ * DX-4016 — the DX-3678 phase C run found the non-work profiles still paying
+ * a 4xx on three writes: a card create without `plan`, an edit whose `ac[]`
+ * items were keyed `text` (and one with no `content_hash`), and a retro whose
+ * flag was false but whose description was missing, then prose.
  *
  * Kept as data, not prose, so danxbot's own tests can check each example
  * against the live server contract (route table, resource fields, body
@@ -25,10 +29,15 @@ export const DANXBOT_API_EXAMPLES = {
         path: "/api/issues",
         query: { filter: { status_derived: "ToDo", q: "<text>" } },
     },
+    cardCreate: {
+        method: "POST",
+        path: "/api/issues",
+        body: { board: "<repo>:<slug>", type: "Bug", title: "<title>", description: "<markdown>", plan: null },
+    },
     cardEdit: {
         method: "PATCH",
         path: "/api/issues/<id>/edit",
-        body: { description: "<markdown>", content_hash: "<content_hash from your read>" },
+        body: { description: "<markdown>", ac: [{ title: "<criterion>" }], content_hash: "<content_hash from your read>" },
     },
     comment: {
         method: "POST",
@@ -40,6 +49,19 @@ export const DANXBOT_API_EXAMPLES = {
         path: "/api/issues/<id>/checklists/<checklists[].id>/items/<items[].id>",
         body: { status: "passing" },
     },
+    retro: {
+        method: "PUT",
+        path: "/api/issues/<id>/retro",
+        body: {
+            good: "<text>",
+            bad: "<text>",
+            correctable_danxbot_problem: false,
+            correctable_danxbot_problem_description: "",
+            action_item_ids: [],
+            commits: [{ sha: "<sha>" }],
+            tests: [],
+        },
+    },
 };
 /** The retro route's accepted `tests[].kind` values. */
 export const RETRO_TEST_KIND_EXAMPLES = ["group", "e2e"];
@@ -52,8 +74,10 @@ export function danxbotApiExamplesText() {
     const e = DANXBOT_API_EXAMPLES;
     return (`Correct first calls: card read ${render(e.cardRead)} (\`fields\` is an object, never a comma string); ` +
         `card list ${render(e.cardList)} (filters only inside \`filter\`); ` +
-        `card edit ${render(e.cardEdit)}; ` +
+        `card create ${render(e.cardCreate)} (\`plan\` required: "mine" or null); ` +
+        `card edit ${render(e.cardEdit)} (only the keys you change; \`ac\` replaces the list); ` +
         `comment ${render(e.comment)}; ` +
         `AC tick ${render(e.acTick)}; ` +
-        `retro \`tests[].kind\` is ${RETRO_TEST_KIND_EXAMPLES.map((k) => `"${k}"`).join(" or ")}.`);
+        `retro ${render(e.retro)} (description "" unless the flag is true; ` +
+        `\`tests[].kind\` ${RETRO_TEST_KIND_EXAMPLES.map((k) => `"${k}"`).join(" or ")}).`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/danx-dashboard-mcp",
-  "version": "0.1.196",
+  "version": "0.1.197",
   "description": "Stdio MCP server fronting danxbot's dashboard API for agents (operator sessions and dispatched workers alike): the generic danxbot_api/danxbot_api_list/danxbot_api_spec tools reach any route the caller's credential may call, plus dedicated agent-specific tools (plan_connect, danxbot_complete, and other per-dispatch lifecycle callbacks) (DX-3465, PLN-11 R-25).",
   "license": "MIT",
   "type": "module",