@thehammer/danx-dashboard-mcp 0.1.195 → 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/dist/index.js

@@ -345,7 +345,12 @@ strictTool("danxbot_api", "Call any dashboard API route your credential may reac
     "the dashboard's own `plan_list.listener_unattached` reminder relayed there (DX-3997). `board` overrides this dispatch's configured board for a board-scoped route only " +
     "(ignored by a route that isn't board-scoped). See this server's own instructions (shown once, at connect) " +
     "for the shared resource shape, the stale-hash rule, and how to read a refusal — don't know the route? call " +
-    "`danxbot_api_list` first; unsure of its exact shape? call `danxbot_api_spec` first. " +
+    "`danxbot_api_list` first. " +
+    // DX-4015 — the ONE statement of which writes need a spec call first; the
+    // `work` profile's spec-first sentence defers to this list. A shown write
+    // is copied from its example (3 of 3 canary sessions did, with zero 4xx).
+    "Before your first write to a route not shown below, and always before `PUT /api/issues/:id/retro`, " +
+    "call `danxbot_api_spec`. " +
     // DX-3923 — the shapes agents guessed wrong most often, shown before the
     // first call instead of learned from a 4xx.
     danxbotApiExamplesText(), {

package/dist/session-stats.js

@@ -59,17 +59,10 @@ export function transcriptPathFromEnv(env) {
 const realWatcher = (options) => new SessionLogWatcher(options);
 /** The collector's dispatch-id argument; the heartbeat is addressed by session, not dispatch. */
 const OPERATOR_DISPATCH_REF = "operator-session";
-/**
- * DX-3962 - the bridge's collector. `"operator-bridge"` is the ONE mode that credits a sub-agent's replies to the card
- * it claimed (from its own transcript's pickup); a worker builds its collector with attribution off.
- */
-function newCollector() {
-    return new DispatchUsage("operator-bridge");
-}
 export class OperatorSessionStats {
     transcriptPath;
     makeWatcher;
-    usage = newCollector();
+    usage = new DispatchUsage();
     watcher = null;
     stopped = false;
     constructor(transcriptPath, makeWatcher = realWatcher) {
@@ -160,7 +153,7 @@ export class OperatorSessionStats {
                 return;
             watcher.stop();
             this.watcher = null;
-            this.usage = newCollector();
+            this.usage = new DispatchUsage();
         })
             .catch((err) => {
             process.stderr.write(`operator session stats: transcript watcher failed: ${err.message}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/danx-dashboard-mcp",
-  "version": "0.1.195",
+  "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",
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "@thehammer/danx-session-telemetry": "0.1.21",
+    "@thehammer/danx-session-telemetry": "0.1.19",
     "zod": "^3.25.76"
   },
   "devDependencies": {