@ikunin/sprintpilot 2.3.6 → 2.3.8

package/_Sprintpilot/manifest.yaml

@@ -1,6 +1,6 @@
 addon:
   name: sprintpilot
-  version: 2.3.6
+  version: 2.3.8
   description: Sprintpilot — autopilot and multi-agent addon for BMad Method (git workflow, parallel agents, autonomous story execution)
   bmad_compatibility: ">=6.2.0"
   modules:

package/_Sprintpilot/scripts/resolve-dag.js

@@ -661,6 +661,19 @@ function findMermaidCliBinary() {
   return null;
 }
 
+// PNG render dimensions. mmdc defaults are 800×600 which produces an
+// unusably-small image once a DAG has more than a handful of nodes
+// — story labels and edges get squashed and unreadable. We override
+// with a wide-format high-DPI render that stays legible up to ~80
+// nodes and prints / pastes cleanly into PRs and docs:
+//   width  2400 (wide; flowchart LR is wider than tall)
+//   height 1800
+//   scale  2    (final PNG = width*scale × height*scale = 4800×3600)
+// Roughly 1–3 MB per render — well within reason for sprint artifacts.
+const PNG_WIDTH = 2400;
+const PNG_HEIGHT = 1800;
+const PNG_SCALE = 2;
+
 // Try to render `<mmd>` to a sibling `<mmd>.png` via mmdc. Returns
 //   { written: true, file: <png-path> }                                — success
 //   { written: false, reason: 'mmdc-missing' }                         — toolchain absent
@@ -672,11 +685,32 @@ function tryRenderMermaidPng(mmdPath) {
     return { written: false, reason: 'mmdc-missing' };
   }
   const pngPath = mmdPath.endsWith('.mmd') ? mmdPath.slice(0, -4) + '.png' : mmdPath + '.png';
-  const r = spawnSync(bin, ['-i', mmdPath, '-o', pngPath, '-b', 'transparent', '--quiet'], {
-    encoding: 'utf8',
-    stdio: ['ignore', 'pipe', 'pipe'],
-    windowsHide: true,
-  });
+  const r = spawnSync(
+    bin,
+    [
+      '-i',
+      mmdPath,
+      '-o',
+      pngPath,
+      // White background, not transparent — DAG node fills (greens,
+      // yellows, greys) need a known light surface for contrast. On a
+      // transparent PNG these wash out against dark IDE/browser themes.
+      '-b',
+      'white',
+      '--width',
+      String(PNG_WIDTH),
+      '--height',
+      String(PNG_HEIGHT),
+      '--scale',
+      String(PNG_SCALE),
+      '--quiet',
+    ],
+    {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'pipe'],
+      windowsHide: true,
+    },
+  );
   if (r.status !== 0) {
     const message = (r.stderr || r.stdout || 'mmdc exited non-zero').trim();
     return { written: false, reason: 'render-failed', message };

package/_Sprintpilot/skills/sprintpilot-dependency-graph/workflow.md

@@ -136,18 +136,32 @@ silence communicates "not tracked" rather than spamming `[no issue]`.
 
 **PNG sibling render.** As a side-effect of the mermaid render, the
 script tries to produce a `<file>.png` next to the `.mmd` via the
-official Mermaid CLI (`mmdc`). Three outcomes to surface:
+official Mermaid CLI (`mmdc`). You **MUST** examine the envelope's
+`png_*` fields and surface one of the three outcomes to the user —
+silence is a bug, especially when mmdc is missing.
 
-- `png_file` set → PNG produced. Report:
+- **`png_file` set** → PNG produced. Report:
   > Also wrote PNG: `<png_file>` (rendered via Mermaid CLI).
-- `png_reason: "mmdc-missing"` → Mermaid CLI not installed. Report:
-  > PNG render skipped — install Mermaid CLI to get a `.png` next to
-  > the `.mmd`:
-  >   `npm install -g @mermaid-js/mermaid-cli`
-  > (Requires Node 18+. Then re-run this skill.)
-- `png_reason: "render-failed"` → mmdc errored. Report the `png_message`
-  verbatim and suggest re-running with `mmdc -i <mmd> -o <png>` to see
-  the full error.
+
+- **`png_reason: "mmdc-missing"`** → Mermaid CLI is not installed.
+  You **MUST** tell the user how to install it, verbatim:
+  > PNG render skipped — Mermaid CLI (`mmdc`) is not installed.
+  > To get a `.png` alongside the `.mmd` next time, install it:
+  >
+  > ```
+  > npm install -g @mermaid-js/mermaid-cli
+  > ```
+  >
+  > Works on Windows, Linux, and macOS. Requires Node 18+.
+  > After installing, re-run `/sprintpilot-dependency-graph mermaid`.
+
+  Do not silently drop this. The `.mmd` file is still useful but the
+  install hint is the primary value of this code path.
+
+- **`png_reason: "render-failed"`** → mmdc was found but errored.
+  Report the `png_message` verbatim and suggest re-running with
+  `mmdc -i <mmd-path> -o <png-path>` outside the skill to see the
+  full toolchain error.
 
 ### Graphviz
 
@@ -239,4 +253,6 @@ have different leading hyphen segments — leverage the JSON output).</action>
 | Plan file corrupt | Surface the parse error from `sprint-plan.js read`; suggest re-running the planning skill. |
 | Cycle detected (`resolve-dag.js` exits 1 with "cycle detected") | Report the cycling node list verbatim. Suggest reviewing `plan.dependencies.stories` for the named keys, or re-running `/sprintpilot-plan-sprint` to re-infer. |
 | Graphviz binary missing | Note the fallback; tell the user how to install `dot`; do NOT silently retry with a different format. |
+| Mermaid CLI (`mmdc`) missing (mermaid format, `png_reason: "mmdc-missing"`) | You **MUST** report the install command: `npm install -g @mermaid-js/mermaid-cli` (cross-platform, requires Node 18+). The `.mmd` file is still written, but never skip the install hint — that's the user-actionable signal. |
+| Mermaid CLI present but errored (`png_reason: "render-failed"`) | Surface `png_message` verbatim; suggest re-running `mmdc -i <mmd> -o <png>` outside the skill to see the full toolchain error. |
 | Output file write fails (permission, disk full) | Surface the error from the resolve-dag stderr; chat-render the JSON output as a fallback so the user still gets something usable. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikunin/sprintpilot",
-  "version": "2.3.6",
+  "version": "2.3.8",
   "description": "Sprintpilot — autopilot and multi-agent addon for BMad Method v6: git workflow, parallel agents, autonomous story execution",
   "license": "Apache-2.0",
   "repository": {