@ikunin/sprintpilot 2.3.4 → 2.3.6

package/_Sprintpilot/manifest.yaml

@@ -1,6 +1,6 @@
 addon:
   name: sprintpilot
-  version: 2.3.4
+  version: 2.3.6
   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

@@ -508,11 +508,16 @@ function renderMermaid(dag, plan) {
   const epicIssueIds = issueIdByEpicId(plan);
   const { intra, cross } = bucketEdges(dag.edges);
   const lines = [];
+  // The diagram-type declaration MUST be the first non-blank line.
+  // Strict markdown→mermaid renderers (Claude Code's chat renderer
+  // included) sniff for `flowchart`/`graph`/etc. as the first content
+  // line; leading `%%` comments cause them to silently skip rendering.
+  // Comments after the type declaration are fine.
+  lines.push('flowchart LR');
   lines.push(`%% plan-id: ${plan?.plan_id ?? 'unknown'}`);
   lines.push(`%% generated: ${plan?.generated ?? new Date().toISOString()}`);
   lines.push('%% Sprint plan DAG — node fill encodes plan_status; cross-epic edges are dashed.');
   lines.push('%% Story labels are prefixed with their issue_id when set in plan.stories.');
-  lines.push('flowchart LR');
 
   // Group nodes by epic (if any). When sprint-wide, emit subgraphs.
   const epicGroups = new Map();
@@ -635,6 +640,50 @@ function hasGraphvizBinary() {
   }
 }
 
+// Find the Mermaid CLI binary on PATH. Cross-platform: npm installs
+// CLI tools as `.cmd` shims on Windows, and Node's spawn family does
+// not auto-resolve PATHEXT extensions without `shell: true`. We probe
+// platform-appropriate candidates explicitly. Returns the resolved
+// binary name (suitable for spawnSync) or null if none found.
+function findMermaidCliBinary() {
+  const candidates =
+    process.platform === 'win32'
+      ? ['mmdc.cmd', 'mmdc.ps1', 'mmdc.bat', 'mmdc.exe', 'mmdc']
+      : ['mmdc'];
+  for (const name of candidates) {
+    try {
+      const r = spawnSync(name, ['--version'], { stdio: 'ignore' });
+      if (r.status === 0) return name;
+    } catch {
+      // ENOENT etc — try next candidate
+    }
+  }
+  return null;
+}
+
+// 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
+//   { written: false, reason: 'render-failed', message: <stderr> }    — toolchain errored
+// Never throws; the caller threads the result into the envelope.
+function tryRenderMermaidPng(mmdPath) {
+  const bin = findMermaidCliBinary();
+  if (!bin) {
+    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,
+  });
+  if (r.status !== 0) {
+    const message = (r.stderr || r.stdout || 'mmdc exited non-zero').trim();
+    return { written: false, reason: 'render-failed', message };
+  }
+  return { written: true, file: pngPath };
+}
+
 function defaultRenderOutputPath(projectRoot, format) {
   const ext = format === 'graphviz' ? 'dot' : 'mmd';
   return path.join(projectRoot, '_bmad-output', 'implementation-artifacts', `sprint-plan-dag.${ext}`);
@@ -689,12 +738,29 @@ function runRender({ projectRoot, epic, format, output }) {
     };
   }
 
+  // Sibling-PNG render (mermaid only). Non-fatal: caller surfaces the
+  // reason if mmdc is missing or errored. graphviz users render via
+  // `dot -Tpng …` themselves; no auto-PNG for that format.
+  let pngEnvelope = null;
+  if (effectiveFormat === 'mermaid') {
+    const pngResult = tryRenderMermaidPng(outputPath);
+    if (pngResult.written) {
+      pngEnvelope = { png_file: pngResult.file };
+    } else {
+      pngEnvelope = {
+        png_reason: pngResult.reason,
+        ...(pngResult.message ? { png_message: pngResult.message } : {}),
+      };
+    }
+  }
+
   return {
     wrote: true,
     file: outputPath,
     format: effectiveFormat,
     requested_format: requestedFormat,
     ...(fallbackReason ? { fallback: fallbackReason } : {}),
+    ...(pngEnvelope || {}),
     nodes: dag.nodes.length,
     edges: dag.edges.length,
   };

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

@@ -113,8 +113,8 @@ node _Sprintpilot/scripts/resolve-dag.js render --format mermaid \
   [--epic <id>] [--output <path>] --project-root <root>
 ```
 
-Returns JSON `{wrote, file, format, nodes, edges, fallback?}`. Then
-read the rendered file and inline its contents in a ```mermaid fenced
+Returns JSON `{wrote, file, format, nodes, edges, fallback?, png_file?, png_reason?, png_message?}`.
+Then read the rendered file and inline its contents in a ```mermaid fenced
 code block so the chat client (Claude Code, etc.) renders the diagram
 inline. Also report the file path so the user can preview elsewhere:
 
@@ -134,6 +134,21 @@ cross-references back to the user's tracker (Jira / Linear / GitHub /
 GitLab). Stories/epics without an issue_id render with the bare key —
 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:
+
+- `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.
+
 ### Graphviz
 
 ```

package/package.json

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