ma-agents 3.15.0 → 3.15.1

package/lib/bmad-extension-plugin/.claude-plugin/marketplace.json

@@ -37,7 +37,7 @@
       "name": "ma-skills",
       "source": "./",
       "description": "ma-agents extension module providing enterprise SDLC personas and operational workflow skills.",
-      "version": "3.15.0",
+      "version": "3.15.1",
       "author": {
         "name": "Alon Mayaffit"
       },

package/lib/knowledge-atlas/dist/atlas.cjs

@@ -5697,10 +5697,14 @@ var DESIGN_SYSTEM_CSS = `/* Knowledge Atlas \u2014 design system (Story 29.3) */
   top: 0;
 }
 
-/* FR223 \u2014 smooth scrolling for in-page anchor jumps (TOC, backlinks, orphan
-   summary links). Guarded below by prefers-reduced-motion. */
+/* Scroll behaviour: use auto (instant) so that landing on a page via a
+   #anchor \u2014 e.g. clicking a graph node or an entity link into a long reading
+   view \u2014 reliably jumps to the target. A global smooth scroll-behavior
+   made the browser's on-load hash navigation unreliable on long documents (it
+   could stay at the top \u2014 the "click goes to the start of the document" bug).
+   In-page TOC/backlink clicks still jump correctly, just without the animation. */
 html {
-  scroll-behavior: smooth;
+  scroll-behavior: auto;
 }
 
 body {
@@ -13096,6 +13100,20 @@ function buildAppScript() {
     return;
   }
 
+  // Layout forces (fixes the overlapping-blob): stronger charge repulsion + a
+  // larger link distance push nodes apart; a gentler velocity decay lets a
+  // dragged node's neighbourhood follow it and settle rather than everything
+  // snapping. The vendored force-graph exposes charge/link via d3Force but no
+  // collide, so spacing comes from charge+distance. All best-effort.
+  try {
+    var _charge = graph.d3Force && graph.d3Force('charge');
+    if (_charge && _charge.strength) _charge.strength(-160);
+    var _link = graph.d3Force && graph.d3Force('link');
+    if (_link && _link.distance) _link.distance(48);
+    if (graph.d3VelocityDecay) graph.d3VelocityDecay(0.3);
+    if (graph.warmupTicks) graph.warmupTicks(80); // pre-spread before first paint
+  } catch (_e) { /* forces best-effort; graph still renders without them */ }
+
   // FR222: distinct shape per entity type (previously color+size only \u2014 the
   // canvas never read NODE_STYLES' shape/data-shape, so every node was a
   // circle regardless of kind). Traces the path for the node's shape
@@ -13161,7 +13179,7 @@ function buildAppScript() {
       // FR222: paint the node as its per-kind shape (circle/square/diamond/
       // triangle) instead of force-graph's default circle-only rendering.
       .nodeCanvasObject(function(n, ctx) {
-        var size = n.size || 6;
+        var size = (n.size || 6) * 0.5; // smaller nodes (were visually oversized/overlapping)
         ctx.fillStyle = n.color || '#888';
         traceNodeShapePath(ctx, n.shape, n.x, n.y, size);
         ctx.fill();
@@ -13171,7 +13189,7 @@ function buildAppScript() {
       // custom shape drawn above (non-circle nodes would get unreliable
       // hover/click hit-boxes).
       .nodePointerAreaPaint(function(n, color, ctx) {
-        var size = (n.size || 6) + 2; // slightly larger \u2014 easier to hit
+        var size = (n.size || 6) * 0.5 + 2; // match the smaller draw size, +2 to stay easy to hit
         ctx.fillStyle = color;
         traceNodeShapePath(ctx, n.shape, n.x, n.y, size);
         ctx.fill();
@@ -13200,6 +13218,16 @@ function buildAppScript() {
         var href = page + (n.anchor ? '#' + n.anchor : '');
         window.location.href = href;
       })
+      // Drag-to-pin (fixes the spring-back): keep the node exactly where it was
+      // dropped (fx/fy). Because the simulation stays warm, its linked neighbours
+      // follow the drag and nodes farther along the graph move progressively less.
+      // Right-click a node to release its pin back into the layout.
+      .onNodeDrag(function(n) { n.fx = n.x; n.fy = n.y; })
+      .onNodeDragEnd(function(n) { n.fx = n.x; n.fy = n.y; })
+      .onNodeRightClick(function(n) {
+        n.fx = undefined; n.fy = undefined;
+        if (graph.d3ReheatSimulation) graph.d3ReheatSimulation();
+      })
       .onNodeHover(function(n) {
         // Distinct cursor hint: pointer only over nodes that actually
         // navigate somewhere (have a resolved page); default cursor otherwise

package/lib/knowledge-atlas/src/render/design-system.ts

@@ -108,10 +108,14 @@ export const DESIGN_SYSTEM_CSS: string = `\
   top: 0;
 }
 
-/* FR223 — smooth scrolling for in-page anchor jumps (TOC, backlinks, orphan
-   summary links). Guarded below by prefers-reduced-motion. */
+/* Scroll behaviour: use auto (instant) so that landing on a page via a
+   #anchor — e.g. clicking a graph node or an entity link into a long reading
+   view — reliably jumps to the target. A global smooth scroll-behavior
+   made the browser's on-load hash navigation unreliable on long documents (it
+   could stay at the top — the "click goes to the start of the document" bug).
+   In-page TOC/backlink clicks still jump correctly, just without the animation. */
 html {
-  scroll-behavior: smooth;
+  scroll-behavior: auto;
 }
 
 body {

package/lib/knowledge-atlas/src/render/graph.ts

@@ -687,6 +687,20 @@ function buildAppScript(): string {
     return;
   }
 
+  // Layout forces (fixes the overlapping-blob): stronger charge repulsion + a
+  // larger link distance push nodes apart; a gentler velocity decay lets a
+  // dragged node's neighbourhood follow it and settle rather than everything
+  // snapping. The vendored force-graph exposes charge/link via d3Force but no
+  // collide, so spacing comes from charge+distance. All best-effort.
+  try {
+    var _charge = graph.d3Force && graph.d3Force('charge');
+    if (_charge && _charge.strength) _charge.strength(-160);
+    var _link = graph.d3Force && graph.d3Force('link');
+    if (_link && _link.distance) _link.distance(48);
+    if (graph.d3VelocityDecay) graph.d3VelocityDecay(0.3);
+    if (graph.warmupTicks) graph.warmupTicks(80); // pre-spread before first paint
+  } catch (_e) { /* forces best-effort; graph still renders without them */ }
+
   // FR222: distinct shape per entity type (previously color+size only — the
   // canvas never read NODE_STYLES' shape/data-shape, so every node was a
   // circle regardless of kind). Traces the path for the node's shape
@@ -752,7 +766,7 @@ function buildAppScript(): string {
       // FR222: paint the node as its per-kind shape (circle/square/diamond/
       // triangle) instead of force-graph's default circle-only rendering.
       .nodeCanvasObject(function(n, ctx) {
-        var size = n.size || 6;
+        var size = (n.size || 6) * 0.5; // smaller nodes (were visually oversized/overlapping)
         ctx.fillStyle = n.color || '#888';
         traceNodeShapePath(ctx, n.shape, n.x, n.y, size);
         ctx.fill();
@@ -762,7 +776,7 @@ function buildAppScript(): string {
       // custom shape drawn above (non-circle nodes would get unreliable
       // hover/click hit-boxes).
       .nodePointerAreaPaint(function(n, color, ctx) {
-        var size = (n.size || 6) + 2; // slightly larger — easier to hit
+        var size = (n.size || 6) * 0.5 + 2; // match the smaller draw size, +2 to stay easy to hit
         ctx.fillStyle = color;
         traceNodeShapePath(ctx, n.shape, n.x, n.y, size);
         ctx.fill();
@@ -791,6 +805,16 @@ function buildAppScript(): string {
         var href = page + (n.anchor ? '#' + n.anchor : '');
         window.location.href = href;
       })
+      // Drag-to-pin (fixes the spring-back): keep the node exactly where it was
+      // dropped (fx/fy). Because the simulation stays warm, its linked neighbours
+      // follow the drag and nodes farther along the graph move progressively less.
+      // Right-click a node to release its pin back into the layout.
+      .onNodeDrag(function(n) { n.fx = n.x; n.fy = n.y; })
+      .onNodeDragEnd(function(n) { n.fx = n.x; n.fy = n.y; })
+      .onNodeRightClick(function(n) {
+        n.fx = undefined; n.fy = undefined;
+        if (graph.d3ReheatSimulation) graph.d3ReheatSimulation();
+      })
       .onNodeHover(function(n) {
         // Distinct cursor hint: pointer only over nodes that actually
         // navigate somewhere (have a resolved page); default cursor otherwise

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ma-agents",
-  "version": "3.15.0",
+  "version": "3.15.1",
   "description": "NPX tool to install skills for AI coding agents (Claude Code, Gemini, Copilot, Kilocode, Cline, Cursor, Roo Code)",
   "main": "index.js",
   "bin": {