@dewtech/dare-cli 2.17.0 → 3.1.0

package/dist/utils/excalidraw-renderer.js

@@ -1,188 +1,55 @@
 /**
- * Excalidraw Renderer for DARE DAG Visualization
+ * Excalidraw Renderer for DARE DAG Visualization.
  *
- * Converts a DARE DAG (task graph) to an Excalidraw JSON file.
- * - Tasks are rendered as colored rectangles based on complexity
- * - Dependencies are rendered as arrows
- * - Tasks are grouped by rank in swim lanes
+ * Maps a DARE DAG (task graph) onto the generic graph renderer
+ * (`graph-renderer.ts`) so the task DAG and `dare reverse`'s module graph
+ * share one rendering engine:
+ *   - Tasks → rectangles colored by status (complexity as fallback when PENDING)
+ *   - Dependencies → arrows
+ *   - Tasks grouped by rank in swim lanes
  *
  * Design tokens: /docs/DESIGN-TOKENS-EXCALIDRAW.md
- * License: AGPL v3 (part of DARE CLI)
- */
-import { computeRanks } from '../dag-runner/run_dag.js';
-/**
- * Color palette based on DARE Design Tokens
+ * License: MIT (D-001 — part of DARE CLI)
  */
+import { renderGraphExcalidraw, serializeExcalidraw, } from './graph-renderer.js';
+export { serializeExcalidraw };
+/** Color palette based on DARE Design Tokens. */
 const COLOR_BY_COMPLEXITY = {
-    LOW: {
-        bg: '#e3f2fd', // Azure blue
-        stroke: '#1976d2', // Dark blue
-    },
-    MED: {
-        bg: '#fff3e0', // Orange
-        stroke: '#e65100', // Dark orange
-    },
-    HIGH: {
-        bg: '#fce4ec', // Pink/Magenta
-        stroke: '#c2185b', // Dark pink
-    },
+    LOW: { bg: '#e3f2fd', stroke: '#1976d2' }, // Azure blue
+    MED: { bg: '#fff3e0', stroke: '#e65100' }, // Orange
+    HIGH: { bg: '#fce4ec', stroke: '#c2185b' }, // Pink/Magenta
 };
 const COLOR_BY_STATUS = {
-    PENDING: {
-        bg: '#f5f5f5', // Light gray
-        stroke: '#999999', // Medium gray
-    },
-    RUNNING: {
-        bg: '#e3f2fd', // Azure blue
-        stroke: '#1976d2', // Dark blue
-        dashed: true,
-    },
-    DONE: {
-        bg: '#e8f5e9', // Light green
-        stroke: '#388e3c', // Dark green
-    },
-    FAILED: {
-        bg: '#ffebee', // Light red
-        stroke: '#d32f2f', // Dark red
-    },
-    SKIPPED: {
-        bg: '#e5e7eb', // Gray
-        stroke: '#6b7280', // Dark gray
-    },
+    PENDING: { bg: '#f5f5f5', stroke: '#999999' },
+    RUNNING: { bg: '#e3f2fd', stroke: '#1976d2', dashed: true },
+    DONE: { bg: '#e8f5e9', stroke: '#388e3c' },
+    FAILED: { bg: '#ffebee', stroke: '#d32f2f' },
+    SKIPPED: { bg: '#e5e7eb', stroke: '#6b7280' },
 };
-/**
- * Generate unique ID for Excalidraw elements
- */
-function generateId() {
-    return Math.random().toString(36).substr(2, 9);
-}
-/**
- * Get status color, preferring status over complexity
- */
+/** Status takes precedence; PENDING falls back to complexity for richer color. */
 function getTaskColors(task) {
     const status = task.status ?? 'PENDING';
-    // Status takes precedence, but if PENDING, use complexity for better visualization
     if (status === 'PENDING' && task.complexity) {
         return COLOR_BY_COMPLEXITY[task.complexity] || COLOR_BY_COMPLEXITY.MED;
     }
     return COLOR_BY_STATUS[status] || COLOR_BY_STATUS.PENDING;
 }
-/**
- * Create rectangle element for a task
- */
-function createTaskElement(task, x, y) {
+function taskToGraphNode(task) {
     const colors = getTaskColors(task);
     const complexity = task.complexity || 'MED';
-    const text = `${task.id}\n${task.title}\n[${complexity}]`;
     return {
         id: task.id,
-        type: 'rectangle',
-        x,
-        y,
-        width: 120,
-        height: 60,
-        angle: 0,
-        strokeColor: colors.stroke,
-        backgroundColor: colors.bg,
-        fillStyle: 'hachure',
-        strokeWidth: 2,
-        strokeStyle: colors.dashed ? 'dashed' : 'solid',
-        roughness: 0,
-        opacity: 100,
-        roundness: { type: 2, value: 6 },
-        text,
-        fontSize: 12,
-        fontFamily: 1, // Virgil (default Excalidraw font)
-        textAlign: 'center',
-        verticalAlign: 'middle',
-        boundElements: [],
-        updated: Date.now(),
-        link: null,
-        locked: false,
-        seed: Math.floor(Math.random() * 2147483647),
-        versionNonce: Math.floor(Math.random() * 2147483647),
+        depends_on: task.depends_on,
+        labelLines: [task.id, task.title, `[${complexity}]`],
+        bg: colors.bg,
+        stroke: colors.stroke,
+        dashed: colors.dashed,
     };
 }
-/**
- * Create arrow element for a dependency
- */
-function createArrowElement(fromTaskId, toTaskId) {
-    return {
-        id: generateId(),
-        type: 'arrow',
-        x: 0, // Will be computed from start/end binding
-        y: 0,
-        startBinding: { elementId: fromTaskId },
-        endBinding: { elementId: toTaskId },
-        startArrowType: 'dot',
-        endArrowType: 'arrow',
-        strokeColor: '#999999',
-        strokeWidth: 2,
-        strokeStyle: 'solid',
-        roughness: 0,
-        opacity: 100,
-        updated: Date.now(),
-        link: null,
-        locked: false,
-        seed: Math.floor(Math.random() * 2147483647),
-        versionNonce: Math.floor(Math.random() * 2147483647),
-    };
-}
-/**
- * Render DAG to Excalidraw JSON
- */
+/** Render a task DAG to Excalidraw JSON via the generic graph renderer. */
 export function renderDagExcalidraw(dag) {
-    const elements = [];
-    const ranks = computeRanks(dag.tasks);
-    // Group tasks by rank
-    const byRank = new Map();
-    for (const task of dag.tasks) {
-        const r = ranks.get(task.id) ?? 1;
-        if (!byRank.has(r))
-            byRank.set(r, []);
-        byRank.get(r).push(task);
-    }
-    // Position elements
-    const taskPositions = new Map();
-    const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
-    for (const rank of sortedRanks) {
-        const tasksInRank = byRank.get(rank);
-        for (let i = 0; i < tasksInRank.length; i++) {
-            const task = tasksInRank[i];
-            // Position: X based on task index in rank, Y based on rank
-            const x = 20 + i * 140;
-            const y = 20 + rank * 160;
-            taskPositions.set(task.id, { x, y });
-            // Create rectangle for this task
-            const taskElement = createTaskElement(task, x, y);
-            elements.push(taskElement);
-        }
-    }
-    // Create arrows for dependencies
-    for (const task of dag.tasks) {
-        for (const depId of task.depends_on) {
-            const arrow = createArrowElement(depId, task.id);
-            elements.push(arrow);
-        }
-    }
-    const data = {
-        type: 'excalidraw',
-        version: 2,
+    return renderGraphExcalidraw(dag.tasks.map(taskToGraphNode), {
         source: 'dare-dag-viz',
-        elements,
-        appState: {
-            gridMode: 'grid',
-            gridSize: 20,
-            viewBackgroundColor: '#ffffff',
-        },
-        files: {},
-    };
-    return data;
-}
-/**
- * Serialize Excalidraw data to JSON string
- */
-export function serializeExcalidraw(data) {
-    return JSON.stringify(data, null, 2);
+    });
 }
 //# sourceMappingURL=excalidraw-renderer.js.map

package/dist/utils/excalidraw-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"excalidraw-renderer.js","sourceRoot":"","sources":["../../src/utils/excalidraw-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA4B,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAmDlF;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,GAAG,EAAE;QACH,EAAE,EAAE,SAAS,EAAO,aAAa;QACjC,MAAM,EAAE,SAAS,EAAG,YAAY;KACjC;IACD,GAAG,EAAE;QACH,EAAE,EAAE,SAAS,EAAO,SAAS;QAC7B,MAAM,EAAE,SAAS,EAAG,cAAc;KACnC;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,SAAS,EAAO,eAAe;QACnC,MAAM,EAAE,SAAS,EAAG,YAAY;KACjC;CACF,CAAC;AAEF,MAAM,eAAe,GAAyE;IAC5F,OAAO,EAAE;QACP,EAAE,EAAE,SAAS,EAAO,aAAa;QACjC,MAAM,EAAE,SAAS,EAAG,cAAc;KACnC;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS,EAAO,aAAa;QACjC,MAAM,EAAE,SAAS,EAAG,YAAY;QAChC,MAAM,EAAE,IAAI;KACb;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,SAAS,EAAO,cAAc;QAClC,MAAM,EAAE,SAAS,EAAG,aAAa;KAClC;IACD,MAAM,EAAE;QACN,EAAE,EAAE,SAAS,EAAO,YAAY;QAChC,MAAM,EAAE,SAAS,EAAG,WAAW;KAChC;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS,EAAO,OAAO;QAC3B,MAAM,EAAE,SAAS,EAAG,YAAY;KACjC;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,IAAa;IAEb,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;IACxC,mFAAmF;IACnF,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC;IACzE,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,IAAa,EACb,CAAS,EACT,CAAS;IAET,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;IAE5C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,MAAM,UAAU,GAAG,CAAC;IAE1D,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,CAAC;QACD,CAAC;QACD,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1B,eAAe,EAAE,MAAM,CAAC,EAAE;QAC1B,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;QAC/C,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;QAChC,IAAI;QACJ,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,CAAC,EAAE,mCAAmC;QAClD,SAAS,EAAE,QAAQ;QACnB,aAAa,EAAE,QAAQ;QACvB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC;QAC5C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC;KACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,UAAkB,EAClB,QAAgB;IAEhB,OAAO;QACL,EAAE,EAAE,UAAU,EAAE;QAChB,IAAI,EAAE,OAAO;QACb,CAAC,EAAE,CAAC,EAAE,0CAA0C;QAChD,CAAC,EAAE,CAAC;QACJ,YAAY,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;QACvC,UAAU,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;QACnC,cAAc,EAAE,KAAK;QACrB,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC;QAC5C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC;KACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEtC,sBAAsB;IACtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,oBAAoB;IACpB,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoC,CAAC;IAElE,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7D,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAE5B,2DAA2D;YAC3D,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;YACvB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,GAAG,CAAC;YAE1B,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAErC,iCAAiC;YACjC,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAmB;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,cAAc;QACtB,QAAQ;QACR,QAAQ,EAAE;YACR,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,EAAE;YACZ,mBAAmB,EAAE,SAAS;SAC/B;QACD,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoB;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"excalidraw-renderer.js","sourceRoot":"","sources":["../../src/utils/excalidraw-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAuB,CAAC;AAEpD,iDAAiD;AACjD,MAAM,mBAAmB,GAAG;IAC1B,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,aAAa;IACxD,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS;IACpD,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,eAAe;CAC5D,CAAC;AAEF,MAAM,eAAe,GAAyE;IAC5F,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;IAC7C,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;IAC3D,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;IAC1C,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;IAC5C,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;CAC9C,CAAC;AAEF,kFAAkF;AAClF,SAAS,aAAa,CAAC,IAAa;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;IACxC,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC;IACzE,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC;AAC5D,CAAC;AAED,SAAS,eAAe,CAAC,IAAa;IACpC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;IAC5C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,UAAU,GAAG,CAAC;QACpD,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE;QAC3D,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/graph-renderer.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Generic graph renderer — the shared core behind `dare dag viz` (the task
+ * DAG) and `dare reverse` (the module-dependency graph).
+ *
+ * Callers map their domain objects (DagTask, Module, …) to `GraphNode`,
+ * resolving colors / labels / styling, and this module owns the layout
+ * (rank grouping via the same Kahn-style traversal the DAG uses) and the
+ * serialization to Mermaid, Graphviz DOT, and Excalidraw JSON.
+ *
+ * Two styling strategies for Mermaid:
+ *   - `'class'`  → emits `class <id> <cls>;` + shared `classDef` lines.
+ *                  Used by the DAG (status-driven palette).
+ *   - `'inline'` → emits `style <id> fill:…,stroke:…;` per node.
+ *                  Used by `reverse` (arbitrary per-node colors, e.g. size).
+ *
+ * License: MIT (part of DARE CLI).
+ */
+export interface GraphNode {
+    id: string;
+    depends_on: string[];
+    /** Lines composing the node label (joined with the renderer's separator). */
+    labelLines: string[];
+    /** Background fill (Excalidraw, Mermaid inline, DOT fillcolor). */
+    bg: string;
+    /** Stroke / border color. */
+    stroke: string;
+    /** Dashed border (Excalidraw / inline). */
+    dashed?: boolean;
+    /** Mermaid class name when using class-based styling (e.g. `st_done`). */
+    mermaidClass?: string;
+}
+export interface MermaidOptions {
+    /** Goes into `%% <headerComment>` at the top (caller pre-escapes). */
+    headerComment: string;
+    direction?: 'LR' | 'TB';
+    styling: 'class' | 'inline';
+    /** Emitted (indented) when `styling === 'class'`. */
+    classDefs?: string[];
+}
+export interface DotOptions {
+    /** `digraph <name> { … }`. */
+    name: string;
+}
+export interface ExcalidrawOptions {
+    /** Stamped into the Excalidraw `source` field. */
+    source: string;
+}
+/**
+ * Compute layout ranks for a set of nodes from their `depends_on` edges.
+ * Nodes with no dependencies are rank 0; otherwise rank = max(parent) + 1.
+ * Throws on circular dependencies (same contract as the DAG runner).
+ */
+export declare function computeRanks(nodes: GraphNode[]): Map<string, number>;
+export declare function sanitizeId(id: string): string;
+export declare function escapeMermaid(s: string): string;
+export declare function renderGraphMermaid(nodes: GraphNode[], opts: MermaidOptions): string;
+export declare function renderGraphDot(nodes: GraphNode[], opts: DotOptions): string;
+interface ExcalidrawElement {
+    id: string;
+    type: string;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    angle?: number;
+    strokeColor?: string;
+    backgroundColor?: string;
+    fillStyle?: string;
+    strokeWidth?: number;
+    strokeStyle?: string;
+    roughness?: number;
+    opacity?: number;
+    roundness?: {
+        type: number;
+        value: number;
+    };
+    text?: string;
+    fontSize?: number;
+    fontFamily?: number;
+    textAlign?: string;
+    verticalAlign?: string;
+    startBinding?: {
+        elementId: string;
+    };
+    endBinding?: {
+        elementId: string;
+    };
+    startArrowType?: string;
+    endArrowType?: string;
+    boundElements?: Array<{
+        id: string;
+        type: string;
+    }>;
+    updated?: number;
+    link?: null;
+    locked?: boolean;
+    seed?: number;
+    versionNonce?: number;
+}
+export interface ExcalidrawData {
+    type: string;
+    version: number;
+    source: string;
+    elements: ExcalidrawElement[];
+    appState: {
+        gridMode: string;
+        gridSize: number;
+        viewBackgroundColor?: string;
+    };
+    files: Record<string, unknown>;
+}
+export declare function renderGraphExcalidraw(nodes: GraphNode[], opts: ExcalidrawOptions): ExcalidrawData;
+export declare function serializeExcalidraw(data: ExcalidrawData): string;
+export {};
+//# sourceMappingURL=graph-renderer.d.ts.map

package/dist/utils/graph-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-renderer.d.ts","sourceRoot":"","sources":["../../src/utils/graph-renderer.ts"],"names":[],"mappings":"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"}

package/dist/utils/graph-renderer.js

@@ -0,0 +1,216 @@
+/**
+ * Generic graph renderer — the shared core behind `dare dag viz` (the task
+ * DAG) and `dare reverse` (the module-dependency graph).
+ *
+ * Callers map their domain objects (DagTask, Module, …) to `GraphNode`,
+ * resolving colors / labels / styling, and this module owns the layout
+ * (rank grouping via the same Kahn-style traversal the DAG uses) and the
+ * serialization to Mermaid, Graphviz DOT, and Excalidraw JSON.
+ *
+ * Two styling strategies for Mermaid:
+ *   - `'class'`  → emits `class <id> <cls>;` + shared `classDef` lines.
+ *                  Used by the DAG (status-driven palette).
+ *   - `'inline'` → emits `style <id> fill:…,stroke:…;` per node.
+ *                  Used by `reverse` (arbitrary per-node colors, e.g. size).
+ *
+ * License: MIT (part of DARE CLI).
+ */
+// ─── Rank computation (Kahn-style, mirrors run_dag.computeRanks) ─────────────
+/**
+ * Compute layout ranks for a set of nodes from their `depends_on` edges.
+ * Nodes with no dependencies are rank 0; otherwise rank = max(parent) + 1.
+ * Throws on circular dependencies (same contract as the DAG runner).
+ */
+export function computeRanks(nodes) {
+    const ranks = new Map();
+    const byId = new Map(nodes.map((n) => [n.id, n]));
+    function getRank(id, visited = new Set()) {
+        if (ranks.has(id))
+            return ranks.get(id);
+        if (visited.has(id)) {
+            throw new Error(`Circular dependency detected: ${id}`);
+        }
+        visited.add(id);
+        const node = byId.get(id);
+        // Unknown dependency targets are treated as rank-0 anchors so a missing
+        // edge never crashes a best-effort reverse-engineering render.
+        if (!node || node.depends_on.length === 0) {
+            ranks.set(id, 0);
+            return 0;
+        }
+        const maxDep = Math.max(...node.depends_on.map((dep) => getRank(dep, new Set(visited))));
+        const rank = maxDep + 1;
+        ranks.set(id, rank);
+        return rank;
+    }
+    for (const n of nodes)
+        getRank(n.id);
+    return ranks;
+}
+function groupByRank(nodes, ranks) {
+    const byRank = new Map();
+    for (const node of nodes) {
+        const r = ranks.get(node.id) ?? 0;
+        if (!byRank.has(r))
+            byRank.set(r, []);
+        byRank.get(r).push(node);
+    }
+    return byRank;
+}
+// ─── Shared helpers ──────────────────────────────────────────────────────────
+export function sanitizeId(id) {
+    return id.replace(/[^a-zA-Z0-9_]/g, '_');
+}
+export function escapeMermaid(s) {
+    return s.replace(/"/g, '&quot;').replace(/[\r\n]+/g, ' ');
+}
+// ─── Mermaid ──────────────────────────────────────────────────────────────────
+export function renderGraphMermaid(nodes, opts) {
+    const dir = opts.direction ?? 'LR';
+    const lines = [
+        `%% ${opts.headerComment}`,
+        `%% Generated: ${new Date().toISOString()}`,
+        `graph ${dir}`,
+    ];
+    const ranks = computeRanks(nodes);
+    const byRank = groupByRank(nodes, ranks);
+    const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
+    for (const r of sortedRanks) {
+        lines.push(`  subgraph rank_${r} ["Rank ${r}"]`);
+        lines.push(`    direction TB`);
+        for (const node of byRank.get(r)) {
+            const id = sanitizeId(node.id);
+            const label = node.labelLines.map(escapeMermaid).join('\\n');
+            lines.push(`    ${id}["${label}"]`);
+        }
+        lines.push('  end');
+    }
+    for (const node of nodes) {
+        for (const dep of node.depends_on) {
+            lines.push(`  ${sanitizeId(dep)} --> ${sanitizeId(node.id)}`);
+        }
+    }
+    if (opts.styling === 'class') {
+        for (const node of nodes) {
+            lines.push(`  class ${sanitizeId(node.id)} ${node.mermaidClass};`);
+        }
+        for (const cls of opts.classDefs ?? [])
+            lines.push(`  ${cls}`);
+    }
+    else {
+        for (const node of nodes) {
+            lines.push(`  style ${sanitizeId(node.id)} fill:${node.bg},stroke:${node.stroke};`);
+        }
+    }
+    return lines.join('\n');
+}
+// ─── Graphviz DOT ──────────────────────────────────────────────────────────────
+export function renderGraphDot(nodes, opts) {
+    const lines = [
+        `digraph ${opts.name} {`,
+        '  rankdir=LR;',
+        '  node [shape=box style=filled fontname=Helvetica];',
+    ];
+    for (const node of nodes) {
+        const id = JSON.stringify(node.id);
+        const label = JSON.stringify(node.labelLines.join('\n'));
+        lines.push(`  ${id} [label=${label} fillcolor="${node.bg}" color="${node.stroke}"];`);
+    }
+    for (const node of nodes) {
+        for (const dep of node.depends_on) {
+            lines.push(`  ${JSON.stringify(dep)} -> ${JSON.stringify(node.id)};`);
+        }
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function randomId() {
+    return Math.random().toString(36).substr(2, 9);
+}
+function createNodeRect(node, x, y) {
+    return {
+        id: node.id,
+        type: 'rectangle',
+        x,
+        y,
+        width: 120,
+        height: 60,
+        angle: 0,
+        strokeColor: node.stroke,
+        backgroundColor: node.bg,
+        fillStyle: 'hachure',
+        strokeWidth: 2,
+        strokeStyle: node.dashed ? 'dashed' : 'solid',
+        roughness: 0,
+        opacity: 100,
+        roundness: { type: 2, value: 6 },
+        text: node.labelLines.join('\n'),
+        fontSize: 12,
+        fontFamily: 1, // Virgil (default Excalidraw font)
+        textAlign: 'center',
+        verticalAlign: 'middle',
+        boundElements: [],
+        updated: Date.now(),
+        link: null,
+        locked: false,
+        seed: Math.floor(Math.random() * 2147483647),
+        versionNonce: Math.floor(Math.random() * 2147483647),
+    };
+}
+function createEdgeArrow(fromId, toId) {
+    return {
+        id: randomId(),
+        type: 'arrow',
+        x: 0, // computed from start/end binding by Excalidraw
+        y: 0,
+        startBinding: { elementId: fromId },
+        endBinding: { elementId: toId },
+        startArrowType: 'dot',
+        endArrowType: 'arrow',
+        strokeColor: '#999999',
+        strokeWidth: 2,
+        strokeStyle: 'solid',
+        roughness: 0,
+        opacity: 100,
+        updated: Date.now(),
+        link: null,
+        locked: false,
+        seed: Math.floor(Math.random() * 2147483647),
+        versionNonce: Math.floor(Math.random() * 2147483647),
+    };
+}
+export function renderGraphExcalidraw(nodes, opts) {
+    const elements = [];
+    const ranks = computeRanks(nodes);
+    const byRank = groupByRank(nodes, ranks);
+    const sortedRanks = [...byRank.keys()].sort((a, b) => a - b);
+    for (const rank of sortedRanks) {
+        const inRank = byRank.get(rank);
+        for (let i = 0; i < inRank.length; i++) {
+            const x = 20 + i * 140;
+            const y = 20 + rank * 160;
+            elements.push(createNodeRect(inRank[i], x, y));
+        }
+    }
+    for (const node of nodes) {
+        for (const dep of node.depends_on) {
+            elements.push(createEdgeArrow(dep, node.id));
+        }
+    }
+    return {
+        type: 'excalidraw',
+        version: 2,
+        source: opts.source,
+        elements,
+        appState: {
+            gridMode: 'grid',
+            gridSize: 20,
+            viewBackgroundColor: '#ffffff',
+        },
+        files: {},
+    };
+}
+export function serializeExcalidraw(data) {
+    return JSON.stringify(data, null, 2);
+}
+//# sourceMappingURL=graph-renderer.js.map

package/dist/utils/graph-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-renderer.js","sourceRoot":"","sources":["../../src/utils/graph-renderer.ts"],"names":[],"mappings":"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"}

package/dist/utils/migration.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Migration planning for `dare migrate` (Phase 2 brownfield).
+ *
+ * Consumes the reverse/dna artifacts and produces a migration plan skeleton +
+ * one Gherkin parity feature stub per module. The CLI is deterministic (reads
+ * facts, lists blocking gaps from the Phase-1 confidence markers, scaffolds
+ * skeletons); the `/dare-migrate` skill writes the real strategy, risk
+ * analysis, and parity scenarios.
+ *
+ * Concept inspired by the Reversa migration team + parity scenarios
+ * (Macedo & da Costa, arXiv:2605.18684, 2026) — clean-room, deterministic.
+ *
+ * License: MIT (part of DARE CLI).
+ */
+export interface KnownTarget {
+    value: string;
+    label: string;
+}
+/** Target stacks we give tailored hints for. `--to` also accepts free text. */
+export declare const KNOWN_TARGETS: KnownTarget[];
+export interface MigrationModule {
+    id: string;
+    name: string;
+    path: string;
+    size: string;
+}
+export interface BlockingGap {
+    spec: string;
+    gaps: number;
+}
+export interface MigrationFacts {
+    generatedAt: string;
+    source: {
+        name: string;
+        structure: string;
+        stack: string;
+    };
+    target: {
+        stack: string;
+    };
+    modules: MigrationModule[];
+    blockingGaps: {
+        total: number;
+        perSpec: BlockingGap[];
+    };
+    conventions: {
+        architecture?: string;
+        testing?: string;
+        libraries?: Record<string, string | undefined>;
+    };
+}
+export interface ReverseArtifacts {
+    reverseFacts: Record<string, any>;
+    dnaFacts: Record<string, any> | null;
+}
+/** Path to the reverse-facts.json that `dare migrate` requires. */
+export declare function reverseFactsPath(root: string): string;
+export declare function loadReverseArtifacts(root: string): Promise<ReverseArtifacts | null>;
+export declare function buildMigrationFacts(artifacts: ReverseArtifacts, target: string, generatedAt: string): MigrationFacts;
+/** A safe file slug for a per-module .feature filename. */
+export declare function parityFeatureFilename(mod: MigrationModule): string;
+export declare function renderParityFeature(mod: MigrationFacts['modules'][number]): string;
+export declare function renderMigrationDoc(facts: MigrationFacts): string;
+//# sourceMappingURL=migration.d.ts.map

package/dist/utils/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/utils/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+EAA+E;AAC/E,eAAO,MAAM,aAAa,EAAE,WAAW,EAStC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,WAAW,EAAE,CAAC;KACxB,CAAC;IACF,WAAW,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KAChD,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;CACtC;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAUzF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,cAAc,CA8ChB;AAID,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAElE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAelF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA4EhE"}