@basementuniverse/kanbn 1.1.0 → 1.1.1

package/PLANS.md

@@ -0,0 +1,9 @@
+# Future plans
+
+* multiple boards
+* epics / stories
+* swimlanes
+* list of contributors in index config
+    * dropdown in vsce taskeditor
+    * optional autopopulate from git user
+* web UI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basementuniverse/kanbn",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A CLI Kanban application",
   "main": "index.js",
   "scripts": {

package/src/controller/gantt.js

@@ -64,7 +64,8 @@ function createChartCell() {
   return {
     bg: null,
     lineMask: 0,
-    arrowChar: null
+    arrowChar: null,
+    markerChar: null
   };
 }
 
@@ -121,6 +122,38 @@ function routeDependency(grid, sourceRow, sourceCol, targetRow, targetCol) {
   grid[targetRow][targetCol].arrowChar = targetCol >= routeCol ? '→' : '←';
 }
 
+function setMarker(cell, markerChar) {
+  if (!cell.arrowChar && !cell.markerChar) {
+    cell.markerChar = markerChar;
+  }
+}
+
+function routeIncomingExternalDependency(grid, row, targetCol) {
+  const arrowCol = Math.max(0, targetCol);
+  grid[row][arrowCol].arrowChar = '→';
+
+  if (arrowCol > 0) {
+    addMask(grid[row][arrowCol], DIR_LEFT);
+    addMask(grid[row][arrowCol - 1], DIR_RIGHT);
+  }
+  if (arrowCol > 1) {
+    setMarker(grid[row][arrowCol - 2], '…');
+  }
+}
+
+function routeOutgoingExternalDependency(grid, row, sourceCol, width) {
+  const arrowCol = Math.min(width - 1, sourceCol);
+  grid[row][arrowCol].arrowChar = '→';
+
+  if (arrowCol < width - 1) {
+    addMask(grid[row][arrowCol], DIR_RIGHT);
+    addMask(grid[row][arrowCol + 1], DIR_LEFT);
+  }
+  if (arrowCol < width - 2) {
+    setMarker(grid[row][arrowCol + 2], '…');
+  }
+}
+
 function buildDependencyOverlay(tasks, barGeometries, width) {
   const grid = createChartGrid(tasks.length, width);
   const taskRowMap = new Map(tasks.map((task, index) => [task.id, index]));
@@ -140,6 +173,14 @@ function buildDependencyOverlay(tasks, barGeometries, width) {
         barGeometries[targetRow].start
       );
     });
+
+    if (Array.isArray(task.externalIncomingDependencies) && task.externalIncomingDependencies.length > 0) {
+      routeIncomingExternalDependency(grid, targetRow, barGeometries[targetRow].start);
+    }
+
+    if (Array.isArray(task.externalOutgoingDependents) && task.externalOutgoingDependents.length > 0) {
+      routeOutgoingExternalDependency(grid, targetRow, barGeometries[targetRow].end, width);
+    }
   });
 
   return grid;
@@ -165,6 +206,10 @@ function renderChartRow(gridRow, barGeometry, barBackground, nowPosition) {
       return styleCell(lineChar, ANSI_FG_LINE, bg);
     }
 
+    if (cell.markerChar) {
+      return styleCell(cell.markerChar, ANSI_FG_LINE, bg);
+    }
+
     if (nowPosition === column) {
       return styleCell(NOW_MARKER, ANSI_FG_NOW, bg);
     }

package/src/main.js

@@ -905,14 +905,26 @@ function findDependencyCycle(dependencyMap) {
  * @param {Date} now
  * @return {object}
  */
-function buildGanttSchedule(index, tasks, now) {
+function buildGanttSchedule(index, tasks, now, trackedTaskIds = new Set()) {
   const taskById = new Map(tasks.map((task) => [task.id, task]));
   const dependencyMap = new Map(tasks.map((task) => [task.id, new Set()]));
   const dependentsMap = new Map();
   const indegree = new Map(tasks.map((task) => [task.id, 0]));
+  const externalIncomingDependenciesMap = new Map(tasks.map((task) => [task.id, new Set()]));
+  const externalOutgoingDependentsMap = new Map(tasks.map((task) => [task.id, new Set()]));
+
+  const taskExistsInBoard = (taskId) => trackedTaskIds.has(taskId);
 
   const addDependencyEdge = (dependencyId, dependentId) => {
+    if (!taskById.has(dependentId)) {
+      throw new Error(`Task "${dependentId}" depends on missing task "${dependencyId}"`);
+    }
+
     if (!taskById.has(dependencyId)) {
+      if (taskExistsInBoard(dependencyId)) {
+        externalIncomingDependenciesMap.get(dependentId).add(dependencyId);
+        return;
+      }
       throw new Error(`Task "${dependentId}" depends on missing task "${dependencyId}"`);
     }
 
@@ -939,7 +951,13 @@ function buildGanttSchedule(index, tasks, now) {
       if (relationType === 'depends-on') {
         addDependencyEdge(relation.task, task.id);
       } else if (relationType === 'blocks') {
-        addDependencyEdge(task.id, relation.task);
+        if (taskById.has(relation.task)) {
+          addDependencyEdge(task.id, relation.task);
+        } else if (taskExistsInBoard(relation.task)) {
+          externalOutgoingDependentsMap.get(task.id).add(relation.task);
+        } else {
+          throw new Error(`Task "${task.id}" blocks missing task "${relation.task}"`);
+        }
       }
     });
   });
@@ -1036,6 +1054,8 @@ function buildGanttSchedule(index, tasks, now) {
     const scheduledTask = {
       ...task,
       dependencies,
+      externalIncomingDependencies: [...(externalIncomingDependenciesMap.get(task.id) || [])],
+      externalOutgoingDependents: [...(externalOutgoingDependentsMap.get(task.id) || [])],
       start,
       end,
       blocked: dependencyEnd !== null && preferredStart instanceof Date && dependencyEnd.getTime() > preferredStart.getTime()
@@ -2850,7 +2870,8 @@ class Kanbn {
         }
       );
 
-    return buildGanttSchedule(index, tasks, effectiveNow);
+    const trackedTaskIds = getTrackedTaskIds(index);
+    return buildGanttSchedule(index, tasks, effectiveNow, trackedTaskIds);
   }
 
   /**