mrvn-cli 0.4.4 → 0.4.5

package/dist/index.js

@@ -15019,132 +15019,22 @@ function generateFeatureTags(features) {
   return features.map((id) => `feature:${id}`);
 }
 
-// src/reports/gar/collector.ts
-function collectGarMetrics(store) {
-  const allActions = store.list({ type: "action" });
-  const openActions = allActions.filter((d) => d.frontmatter.status === "open");
-  const doneActions = allActions.filter((d) => d.frontmatter.status === "done");
-  const allDocs = store.list();
-  const blockedItems = allDocs.filter(
-    (d) => d.frontmatter.tags?.includes("blocked")
-  );
-  const tagOverdueItems = allDocs.filter(
-    (d) => d.frontmatter.tags?.includes("overdue")
-  );
-  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const dateOverdueActions = openActions.filter((d) => {
-    const dueDate = d.frontmatter.dueDate;
-    return typeof dueDate === "string" && dueDate < today;
-  });
-  const overdueItems = [...tagOverdueItems, ...dateOverdueActions].filter(
-    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
-  );
-  const openQuestions = store.list({ type: "question", status: "open" });
-  const riskItems = allDocs.filter(
-    (d) => d.frontmatter.tags?.includes("risk") && d.frontmatter.status !== "done" && d.frontmatter.status !== "closed"
-  );
-  const unownedActions = openActions.filter((d) => !d.frontmatter.owner);
-  const total = allActions.length;
-  const done = doneActions.length;
-  const completionPct = total > 0 ? Math.round(done / total * 100) : 100;
-  const scheduleItems = [
-    ...blockedItems,
-    ...overdueItems
-  ].filter(
-    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
-  ).map((d) => ({ id: d.frontmatter.id, title: d.frontmatter.title }));
-  const qualityItems = [
-    ...riskItems,
-    ...openQuestions
-  ].filter(
-    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
-  ).map((d) => ({ id: d.frontmatter.id, title: d.frontmatter.title }));
-  const resourceItems = unownedActions.map((d) => ({
-    id: d.frontmatter.id,
-    title: d.frontmatter.title
-  }));
-  return {
-    scope: {
-      total,
-      open: openActions.length,
-      done,
-      completionPct
-    },
-    schedule: {
-      blocked: blockedItems.length,
-      overdue: overdueItems.length,
-      items: scheduleItems
-    },
-    quality: {
-      risks: riskItems.length,
-      openQuestions: openQuestions.length,
-      items: qualityItems
-    },
-    resources: {
-      unowned: unownedActions.length,
-      items: resourceItems
+// src/plugins/builtin/tools/task-utils.ts
+function normalizeLinkedEpics(value) {
+  if (value === void 0 || value === null) return [];
+  if (typeof value === "string") {
+    try {
+      const parsed = JSON.parse(value);
+      if (Array.isArray(parsed)) return parsed.filter((v) => typeof v === "string");
+    } catch {
     }
-  };
-}
-
-// src/reports/gar/evaluator.ts
-function worstStatus(statuses) {
-  if (statuses.includes("red")) return "red";
-  if (statuses.includes("amber")) return "amber";
-  return "green";
+    return [value];
+  }
+  if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
+  return [];
 }
-function evaluateGar(projectName, metrics) {
-  const areas = [];
-  const scopePct = metrics.scope.completionPct;
-  const scopeStatus = scopePct >= 70 ? "green" : scopePct >= 40 ? "amber" : "red";
-  areas.push({
-    name: "Scope",
-    status: scopeStatus,
-    summary: `${scopePct}% complete (${metrics.scope.done}/${metrics.scope.total})`,
-    items: []
-  });
-  const scheduleCount = metrics.schedule.blocked + metrics.schedule.overdue;
-  const scheduleStatus = scheduleCount === 0 ? "green" : scheduleCount <= 2 ? "amber" : "red";
-  const scheduleParts = [];
-  if (metrics.schedule.blocked > 0)
-    scheduleParts.push(`${metrics.schedule.blocked} blocked`);
-  if (metrics.schedule.overdue > 0)
-    scheduleParts.push(`${metrics.schedule.overdue} overdue`);
-  areas.push({
-    name: "Schedule",
-    status: scheduleStatus,
-    summary: scheduleParts.length > 0 ? scheduleParts.join(", ") : "on track",
-    items: metrics.schedule.items
-  });
-  const qualityCount = metrics.quality.risks + metrics.quality.openQuestions;
-  const qualityStatus = qualityCount === 0 ? "green" : qualityCount <= 2 ? "amber" : "red";
-  const qualityParts = [];
-  if (metrics.quality.risks > 0)
-    qualityParts.push(`${metrics.quality.risks} risk(s)`);
-  if (metrics.quality.openQuestions > 0)
-    qualityParts.push(`${metrics.quality.openQuestions} open question(s)`);
-  areas.push({
-    name: "Quality",
-    status: qualityStatus,
-    summary: qualityParts.length > 0 ? qualityParts.join(", ") : "no issues",
-    items: metrics.quality.items
-  });
-  const resourceCount = metrics.resources.unowned;
-  const resourceStatus = resourceCount === 0 ? "green" : resourceCount <= 2 ? "amber" : "red";
-  areas.push({
-    name: "Resources",
-    status: resourceStatus,
-    summary: resourceCount > 0 ? `${resourceCount} unowned action(s)` : "all assigned",
-    items: metrics.resources.items
-  });
-  const overall = worstStatus(areas.map((a) => a.status));
-  return {
-    projectName,
-    generatedAt: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-    overall,
-    areas,
-    metrics
-  };
+function generateEpicTags(epics) {
+  return epics.map((id) => `epic:${id}`);
 }
 
 // src/reports/health/collector.ts
@@ -15286,6 +15176,134 @@ function collectHealthMetrics(store) {
   };
 }
 
+// src/reports/gar/collector.ts
+function collectGarMetrics(store) {
+  const allActions = store.list({ type: "action" });
+  const openActions = allActions.filter((d) => d.frontmatter.status === "open");
+  const doneActions = allActions.filter((d) => d.frontmatter.status === "done");
+  const allDocs = store.list();
+  const blockedItems = allDocs.filter(
+    (d) => d.frontmatter.tags?.includes("blocked")
+  );
+  const tagOverdueItems = allDocs.filter(
+    (d) => d.frontmatter.tags?.includes("overdue")
+  );
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const dateOverdueActions = openActions.filter((d) => {
+    const dueDate = d.frontmatter.dueDate;
+    return typeof dueDate === "string" && dueDate < today;
+  });
+  const overdueItems = [...tagOverdueItems, ...dateOverdueActions].filter(
+    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
+  );
+  const openQuestions = store.list({ type: "question", status: "open" });
+  const riskItems = allDocs.filter(
+    (d) => d.frontmatter.tags?.includes("risk") && d.frontmatter.status !== "done" && d.frontmatter.status !== "closed"
+  );
+  const unownedActions = openActions.filter((d) => !d.frontmatter.owner);
+  const total = allActions.length;
+  const done = doneActions.length;
+  const completionPct = total > 0 ? Math.round(done / total * 100) : 100;
+  const scheduleItems = [
+    ...blockedItems,
+    ...overdueItems
+  ].filter(
+    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
+  ).map((d) => ({ id: d.frontmatter.id, title: d.frontmatter.title }));
+  const qualityItems = [
+    ...riskItems,
+    ...openQuestions
+  ].filter(
+    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
+  ).map((d) => ({ id: d.frontmatter.id, title: d.frontmatter.title }));
+  const resourceItems = unownedActions.map((d) => ({
+    id: d.frontmatter.id,
+    title: d.frontmatter.title
+  }));
+  return {
+    scope: {
+      total,
+      open: openActions.length,
+      done,
+      completionPct
+    },
+    schedule: {
+      blocked: blockedItems.length,
+      overdue: overdueItems.length,
+      items: scheduleItems
+    },
+    quality: {
+      risks: riskItems.length,
+      openQuestions: openQuestions.length,
+      items: qualityItems
+    },
+    resources: {
+      unowned: unownedActions.length,
+      items: resourceItems
+    }
+  };
+}
+
+// src/reports/gar/evaluator.ts
+function worstStatus(statuses) {
+  if (statuses.includes("red")) return "red";
+  if (statuses.includes("amber")) return "amber";
+  return "green";
+}
+function evaluateGar(projectName, metrics) {
+  const areas = [];
+  const scopePct = metrics.scope.completionPct;
+  const scopeStatus = scopePct >= 70 ? "green" : scopePct >= 40 ? "amber" : "red";
+  areas.push({
+    name: "Scope",
+    status: scopeStatus,
+    summary: `${scopePct}% complete (${metrics.scope.done}/${metrics.scope.total})`,
+    items: []
+  });
+  const scheduleCount = metrics.schedule.blocked + metrics.schedule.overdue;
+  const scheduleStatus = scheduleCount === 0 ? "green" : scheduleCount <= 2 ? "amber" : "red";
+  const scheduleParts = [];
+  if (metrics.schedule.blocked > 0)
+    scheduleParts.push(`${metrics.schedule.blocked} blocked`);
+  if (metrics.schedule.overdue > 0)
+    scheduleParts.push(`${metrics.schedule.overdue} overdue`);
+  areas.push({
+    name: "Schedule",
+    status: scheduleStatus,
+    summary: scheduleParts.length > 0 ? scheduleParts.join(", ") : "on track",
+    items: metrics.schedule.items
+  });
+  const qualityCount = metrics.quality.risks + metrics.quality.openQuestions;
+  const qualityStatus = qualityCount === 0 ? "green" : qualityCount <= 2 ? "amber" : "red";
+  const qualityParts = [];
+  if (metrics.quality.risks > 0)
+    qualityParts.push(`${metrics.quality.risks} risk(s)`);
+  if (metrics.quality.openQuestions > 0)
+    qualityParts.push(`${metrics.quality.openQuestions} open question(s)`);
+  areas.push({
+    name: "Quality",
+    status: qualityStatus,
+    summary: qualityParts.length > 0 ? qualityParts.join(", ") : "no issues",
+    items: metrics.quality.items
+  });
+  const resourceCount = metrics.resources.unowned;
+  const resourceStatus = resourceCount === 0 ? "green" : resourceCount <= 2 ? "amber" : "red";
+  areas.push({
+    name: "Resources",
+    status: resourceStatus,
+    summary: resourceCount > 0 ? `${resourceCount} unowned action(s)` : "all assigned",
+    items: metrics.resources.items
+  });
+  const overall = worstStatus(areas.map((a) => a.status));
+  return {
+    projectName,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+    overall,
+    areas,
+    metrics
+  };
+}
+
 // src/reports/health/evaluator.ts
 function worstStatus2(statuses) {
   if (statuses.includes("red")) return "red";
@@ -15505,6 +15523,204 @@ function getDiagramData(store) {
   }
   return { sprints, epics, features, statusCounts };
 }
+function computeUrgency(dueDateStr, todayStr) {
+  const due = new Date(dueDateStr).getTime();
+  const today = new Date(todayStr).getTime();
+  const diffDays = Math.floor((due - today) / 864e5);
+  if (diffDays < 0) return "overdue";
+  if (diffDays <= 3) return "due-3d";
+  if (diffDays <= 7) return "due-7d";
+  if (diffDays <= 14) return "upcoming";
+  return "later";
+}
+var DONE_STATUSES = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+function getUpcomingData(store) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const allDocs = store.list();
+  const docById = /* @__PURE__ */ new Map();
+  for (const doc of allDocs) {
+    docById.set(doc.frontmatter.id, doc);
+  }
+  const actions = allDocs.filter(
+    (d) => d.frontmatter.type === "action" && !DONE_STATUSES.has(d.frontmatter.status)
+  );
+  const actionsWithDue = actions.filter((d) => d.frontmatter.dueDate);
+  const sprints = allDocs.filter((d) => d.frontmatter.type === "sprint");
+  const epics = allDocs.filter((d) => d.frontmatter.type === "epic");
+  const tasks = allDocs.filter((d) => d.frontmatter.type === "task");
+  const epicToTasks = /* @__PURE__ */ new Map();
+  for (const task of tasks) {
+    const tags = task.frontmatter.tags ?? [];
+    for (const tag of tags) {
+      if (tag.startsWith("epic:")) {
+        const epicId = tag.slice(5);
+        if (!epicToTasks.has(epicId)) epicToTasks.set(epicId, []);
+        epicToTasks.get(epicId).push(task);
+      }
+    }
+  }
+  function getSprintTasks(sprintDoc) {
+    const linkedEpics = normalizeLinkedEpics(sprintDoc.frontmatter.linkedEpics);
+    const result = [];
+    for (const epicId of linkedEpics) {
+      const epicTasks = epicToTasks.get(epicId) ?? [];
+      result.push(...epicTasks);
+    }
+    return result;
+  }
+  function countRelatedTasks(actionDoc) {
+    const actionTags = actionDoc.frontmatter.tags ?? [];
+    const relatedTaskIds = /* @__PURE__ */ new Set();
+    for (const tag of actionTags) {
+      if (tag.startsWith("sprint:")) {
+        const sprintId = tag.slice(7);
+        const sprint = docById.get(sprintId);
+        if (sprint) {
+          const sprintTaskDocs = getSprintTasks(sprint);
+          for (const t of sprintTaskDocs) relatedTaskIds.add(t.frontmatter.id);
+        }
+      }
+    }
+    return relatedTaskIds.size;
+  }
+  const dueSoonActions = actionsWithDue.map((d) => ({
+    id: d.frontmatter.id,
+    title: d.frontmatter.title,
+    status: d.frontmatter.status,
+    owner: d.frontmatter.owner,
+    dueDate: d.frontmatter.dueDate,
+    urgency: computeUrgency(d.frontmatter.dueDate, today),
+    relatedTaskCount: countRelatedTasks(d)
+  })).sort((a, b) => a.dueDate.localeCompare(b.dueDate));
+  const todayMs = new Date(today).getTime();
+  const fourteenDaysMs = 14 * 864e5;
+  const nearSprints = sprints.filter((s) => {
+    const endDate = s.frontmatter.endDate;
+    if (!endDate) return false;
+    const endMs = new Date(endDate).getTime();
+    const diff = endMs - todayMs;
+    return diff >= 0 && diff <= fourteenDaysMs;
+  });
+  const taskSprintMap = /* @__PURE__ */ new Map();
+  for (const sprint of nearSprints) {
+    const sprintEnd = sprint.frontmatter.endDate;
+    const sprintTaskDocs = getSprintTasks(sprint);
+    for (const task of sprintTaskDocs) {
+      if (DONE_STATUSES.has(task.frontmatter.status)) continue;
+      const existing = taskSprintMap.get(task.frontmatter.id);
+      if (!existing || sprintEnd < existing.sprintEnd) {
+        taskSprintMap.set(task.frontmatter.id, { task, sprint, sprintEnd });
+      }
+    }
+  }
+  const dueSoonSprintTasks = [...taskSprintMap.values()].map(({ task, sprint, sprintEnd }) => ({
+    id: task.frontmatter.id,
+    title: task.frontmatter.title,
+    status: task.frontmatter.status,
+    sprintId: sprint.frontmatter.id,
+    sprintTitle: sprint.frontmatter.title,
+    sprintEndDate: sprintEnd,
+    urgency: computeUrgency(sprintEnd, today)
+  })).sort((a, b) => a.sprintEndDate.localeCompare(b.sprintEndDate));
+  const openItems = allDocs.filter(
+    (d) => ["action", "question", "task"].includes(d.frontmatter.type) && !DONE_STATUSES.has(d.frontmatter.status)
+  );
+  const fourteenDaysAgo = new Date(todayMs - fourteenDaysMs).toISOString().slice(0, 10);
+  const recentMeetings = allDocs.filter(
+    (d) => d.frontmatter.type === "meeting" && (d.frontmatter.updated ?? d.frontmatter.created) >= fourteenDaysAgo
+  );
+  const crossRefCounts = /* @__PURE__ */ new Map();
+  for (const doc of allDocs) {
+    const content = doc.content ?? "";
+    for (const item of openItems) {
+      if (doc.frontmatter.id === item.frontmatter.id) continue;
+      if (content.includes(item.frontmatter.id)) {
+        crossRefCounts.set(
+          item.frontmatter.id,
+          (crossRefCounts.get(item.frontmatter.id) ?? 0) + 1
+        );
+      }
+    }
+  }
+  const activeSprints = sprints.filter((s) => {
+    const status = s.frontmatter.status;
+    if (status === "active") return true;
+    const startDate = s.frontmatter.startDate;
+    if (!startDate) return false;
+    const startMs = new Date(startDate).getTime();
+    const diff = startMs - todayMs;
+    return diff >= 0 && diff <= fourteenDaysMs;
+  });
+  const activeSprintIds = new Set(activeSprints.map((s) => s.frontmatter.id));
+  const activeEpicIds = /* @__PURE__ */ new Set();
+  for (const s of activeSprints) {
+    for (const epicId of normalizeLinkedEpics(s.frontmatter.linkedEpics)) {
+      activeEpicIds.add(epicId);
+    }
+  }
+  const trending = openItems.map((doc) => {
+    const signals = [];
+    let score = 0;
+    const updated = doc.frontmatter.updated ?? doc.frontmatter.created;
+    const ageDays = daysBetween(updated, today);
+    const recencyPts = Math.max(0, Math.round(20 * (1 - ageDays / 30)));
+    if (recencyPts > 0) {
+      signals.push({ factor: "recency", points: recencyPts });
+      score += recencyPts;
+    }
+    const tags = doc.frontmatter.tags ?? [];
+    const linkedToActiveSprint = tags.some(
+      (t) => t.startsWith("sprint:") && activeSprintIds.has(t.slice(7))
+    );
+    const linkedToActiveEpic = tags.some(
+      (t) => t.startsWith("epic:") && activeEpicIds.has(t.slice(5))
+    );
+    if (linkedToActiveSprint) {
+      signals.push({ factor: "sprint proximity", points: 25 });
+      score += 25;
+    } else if (linkedToActiveEpic) {
+      signals.push({ factor: "sprint proximity", points: 15 });
+      score += 15;
+    }
+    const mentionCount = recentMeetings.filter(
+      (m) => (m.content ?? "").includes(doc.frontmatter.id)
+    ).length;
+    if (mentionCount > 0) {
+      const meetingPts = Math.min(15, mentionCount * 5);
+      signals.push({ factor: "meeting mentions", points: meetingPts });
+      score += meetingPts;
+    }
+    const priority = doc.frontmatter.priority?.toLowerCase();
+    const priorityPts = priority === "critical" ? 15 : priority === "high" ? 10 : priority === "medium" ? 3 : 0;
+    if (priorityPts > 0) {
+      signals.push({ factor: "priority", points: priorityPts });
+      score += priorityPts;
+    }
+    if (["action", "question"].includes(doc.frontmatter.type)) {
+      const createdDays = daysBetween(doc.frontmatter.created, today);
+      if (createdDays >= 14) {
+        const agingPts = Math.min(10, Math.floor((createdDays - 14) / 7) * 3 + 5);
+        signals.push({ factor: "aging", points: agingPts });
+        score += agingPts;
+      }
+    }
+    const refs = crossRefCounts.get(doc.frontmatter.id) ?? 0;
+    if (refs > 0) {
+      const crossRefPts = Math.min(15, refs * 5);
+      signals.push({ factor: "cross-references", points: crossRefPts });
+      score += crossRefPts;
+    }
+    return {
+      id: doc.frontmatter.id,
+      title: doc.frontmatter.title,
+      type: doc.frontmatter.type,
+      status: doc.frontmatter.status,
+      score,
+      signals
+    };
+  }).filter((item) => item.score > 0).sort((a, b) => b.score - a.score).slice(0, 15);
+  return { dueSoonActions, dueSoonSprintTasks, trending };
+}
 
 // src/web/templates/layout.ts
 function escapeHtml(str) {
@@ -15628,6 +15844,7 @@ function inline(text) {
 function layout(opts, body) {
   const topItems = [
     { href: "/", label: "Overview" },
+    { href: "/upcoming", label: "Upcoming" },
     { href: "/timeline", label: "Timeline" },
     { href: "/board", label: "Board" },
     { href: "/gar", label: "GAR Report" },
@@ -16514,6 +16731,56 @@ tr:hover td {
   fill: var(--bg) !important;
   font-weight: 600;
 }
+
+/* Urgency row indicators */
+.urgency-row-overdue { border-left: 3px solid var(--red); }
+.urgency-row-due-3d { border-left: 3px solid var(--amber); }
+.urgency-row-due-7d { border-left: 3px solid #e2a308; }
+
+/* Urgency badge pills */
+.urgency-badge-overdue { background: rgba(248, 113, 113, 0.15); color: var(--red); }
+.urgency-badge-due-3d { background: rgba(251, 191, 36, 0.15); color: var(--amber); }
+.urgency-badge-due-7d { background: rgba(226, 163, 8, 0.15); color: #e2a308; }
+.urgency-badge-upcoming { background: rgba(108, 140, 255, 0.15); color: var(--accent); }
+.urgency-badge-later { background: rgba(139, 143, 164, 0.1); color: var(--text-dim); }
+
+/* Trending */
+.trending-rank {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  border-radius: 50%;
+  background: var(--bg-hover);
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--text-dim);
+}
+
+.trending-score {
+  display: inline-block;
+  padding: 0.15rem 0.6rem;
+  border-radius: 999px;
+  font-size: 0.7rem;
+  font-weight: 700;
+  background: rgba(108, 140, 255, 0.15);
+  color: var(--accent);
+}
+
+.signal-tag {
+  display: inline-block;
+  padding: 0.1rem 0.45rem;
+  border-radius: 4px;
+  font-size: 0.65rem;
+  background: var(--bg-hover);
+  color: var(--text-dim);
+  margin-right: 0.25rem;
+  margin-bottom: 0.15rem;
+  white-space: nowrap;
+}
+
+.text-dim { color: var(--text-dim); }
 `;
 }
 
@@ -16686,13 +16953,14 @@ function buildArtifactFlowchart(data) {
       var svg = document.getElementById('flow-lines');
       if (!container || !svg) return;
 
-      // Build adjacency map (bidirectional) for traversal
-      var adj = {};
+      // Build directed adjacency maps for traversal
+      var fwd = {};   // from \u2192 [to] (Feature\u2192Epic, Epic\u2192Sprint)
+      var bwd = {};   // to \u2192 [from] (Sprint\u2192Epic, Epic\u2192Feature)
       edges.forEach(function(e) {
-        if (!adj[e.from]) adj[e.from] = [];
-        if (!adj[e.to]) adj[e.to] = [];
-        adj[e.from].push(e.to);
-        adj[e.to].push(e.from);
+        if (!fwd[e.from]) fwd[e.from] = [];
+        if (!bwd[e.to]) bwd[e.to] = [];
+        fwd[e.from].push(e.to);
+        bwd[e.to].push(e.from);
       });
 
       function drawLines() {
@@ -16725,14 +16993,28 @@ function buildArtifactFlowchart(data) {
         });
       }
 
-      // Find all nodes reachable from a starting node
+      // Find directly related nodes via directed traversal
+      // Follows forward edges (Feature\u2192Epic\u2192Sprint) and backward edges
+      // (Sprint\u2192Epic\u2192Feature) separately to avoid sideways expansion
       function findConnected(startId) {
         var visited = {};
-        var queue = [startId];
         visited[startId] = true;
+        // Traverse forward (from\u2192to direction)
+        var queue = [startId];
         while (queue.length) {
           var id = queue.shift();
-          (adj[id] || []).forEach(function(neighbor) {
+          (fwd[id] || []).forEach(function(neighbor) {
+            if (!visited[neighbor]) {
+              visited[neighbor] = true;
+              queue.push(neighbor);
+            }
+          });
+        }
+        // Traverse backward (to\u2192from direction)
+        queue = [startId];
+        while (queue.length) {
+          var id = queue.shift();
+          (bwd[id] || []).forEach(function(neighbor) {
             if (!visited[neighbor]) {
               visited[neighbor] = true;
               queue.push(neighbor);
@@ -17174,6 +17456,131 @@ function timelinePage(diagrams) {
   `;
 }
 
+// src/web/templates/pages/upcoming.ts
+function urgencyBadge(tier) {
+  const labels = {
+    overdue: "Overdue",
+    "due-3d": "Due in 3d",
+    "due-7d": "Due in 7d",
+    upcoming: "Upcoming",
+    later: "Later"
+  };
+  return `<span class="badge urgency-badge-${tier}">${labels[tier]}</span>`;
+}
+function urgencyRowClass(tier) {
+  if (tier === "overdue") return " urgency-row-overdue";
+  if (tier === "due-3d") return " urgency-row-due-3d";
+  if (tier === "due-7d") return " urgency-row-due-7d";
+  return "";
+}
+function upcomingPage(data) {
+  const hasActions = data.dueSoonActions.length > 0;
+  const hasSprintTasks = data.dueSoonSprintTasks.length > 0;
+  const hasTrending = data.trending.length > 0;
+  const actionsTable = hasActions ? `
+    <h3 class="section-title">Due Soon \u2014 Actions</h3>
+    <div class="table-wrap">
+      <table>
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Title</th>
+            <th>Status</th>
+            <th>Owner</th>
+            <th>Due Date</th>
+            <th>Urgency</th>
+            <th>Tasks</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${data.dueSoonActions.map(
+    (a) => `
+          <tr class="${urgencyRowClass(a.urgency)}">
+            <td><a href="/docs/action/${escapeHtml(a.id)}">${escapeHtml(a.id)}</a></td>
+            <td>${escapeHtml(a.title)}</td>
+            <td>${statusBadge(a.status)}</td>
+            <td>${a.owner ? escapeHtml(a.owner) : '<span class="text-dim">\u2014</span>'}</td>
+            <td>${formatDate(a.dueDate)}</td>
+            <td>${urgencyBadge(a.urgency)}</td>
+            <td>${a.relatedTaskCount > 0 ? a.relatedTaskCount : "\u2014"}</td>
+          </tr>`
+  ).join("")}
+        </tbody>
+      </table>
+    </div>` : "";
+  const sprintTasksTable = hasSprintTasks ? `
+    <h3 class="section-title">Due Soon \u2014 Sprint Tasks</h3>
+    <div class="table-wrap">
+      <table>
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Title</th>
+            <th>Status</th>
+            <th>Sprint</th>
+            <th>Sprint Ends</th>
+            <th>Urgency</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${data.dueSoonSprintTasks.map(
+    (t) => `
+          <tr class="${urgencyRowClass(t.urgency)}">
+            <td><a href="/docs/task/${escapeHtml(t.id)}">${escapeHtml(t.id)}</a></td>
+            <td>${escapeHtml(t.title)}</td>
+            <td>${statusBadge(t.status)}</td>
+            <td><a href="/docs/sprint/${escapeHtml(t.sprintId)}">${escapeHtml(t.sprintId)}</a></td>
+            <td>${formatDate(t.sprintEndDate)}</td>
+            <td>${urgencyBadge(t.urgency)}</td>
+          </tr>`
+  ).join("")}
+        </tbody>
+      </table>
+    </div>` : "";
+  const trendingTable = hasTrending ? `
+    <h3 class="section-title">Trending</h3>
+    <div class="table-wrap">
+      <table>
+        <thead>
+          <tr>
+            <th>#</th>
+            <th>ID</th>
+            <th>Title</th>
+            <th>Type</th>
+            <th>Status</th>
+            <th>Score</th>
+            <th>Signals</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${data.trending.map(
+    (t, i) => `
+          <tr>
+            <td><span class="trending-rank">${i + 1}</span></td>
+            <td><a href="/docs/${escapeHtml(t.type)}/${escapeHtml(t.id)}">${escapeHtml(t.id)}</a></td>
+            <td>${escapeHtml(t.title)}</td>
+            <td>${escapeHtml(typeLabel(t.type))}</td>
+            <td>${statusBadge(t.status)}</td>
+            <td><span class="trending-score">${t.score}</span></td>
+            <td>${t.signals.map((s) => `<span class="signal-tag">${escapeHtml(s.factor)} +${s.points}</span>`).join(" ")}</td>
+          </tr>`
+  ).join("")}
+        </tbody>
+      </table>
+    </div>` : "";
+  const emptyState = !hasActions && !hasSprintTasks && !hasTrending ? '<div class="empty"><p>No upcoming items or trending activity found.</p></div>' : "";
+  return `
+    <div class="page-header">
+      <h2>Upcoming</h2>
+      <div class="subtitle">Time-sensitive items and trending activity</div>
+    </div>
+    ${actionsTable}
+    ${sprintTasksTable}
+    ${trendingTable}
+    ${emptyState}
+  `;
+}
+
 // src/web/router.ts
 function handleRequest(req, res, store, projectName, navGroups) {
   const parsed = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
@@ -17214,6 +17621,12 @@ function handleRequest(req, res, store, projectName, navGroups) {
       respond(res, layout({ title: "Health Check", activePath: "/health", projectName, navGroups }, body));
       return;
     }
+    if (pathname === "/upcoming") {
+      const data = getUpcomingData(store);
+      const body = upcomingPage(data);
+      respond(res, layout({ title: "Upcoming", activePath: "/upcoming", projectName, navGroups }, body));
+      return;
+    }
     const boardMatch = pathname.match(/^\/board(?:\/([^/]+))?$/);
     if (boardMatch) {
       const type = boardMatch[1];
@@ -18586,26 +18999,6 @@ function createSprintPlanningTools(store) {
 
 // src/plugins/builtin/tools/tasks.ts
 import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
-
-// src/plugins/builtin/tools/task-utils.ts
-function normalizeLinkedEpics(value) {
-  if (value === void 0 || value === null) return [];
-  if (typeof value === "string") {
-    try {
-      const parsed = JSON.parse(value);
-      if (Array.isArray(parsed)) return parsed.filter((v) => typeof v === "string");
-    } catch {
-    }
-    return [value];
-  }
-  if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
-  return [];
-}
-function generateEpicTags(epics) {
-  return epics.map((id) => `epic:${id}`);
-}
-
-// src/plugins/builtin/tools/tasks.ts
 var linkedEpicArray = external_exports.preprocess(
   (val) => {
     if (typeof val === "string") {
@@ -20024,8 +20417,9 @@ function findByJiraKey(store, jiraKey) {
   const docs = store.list({ type: JIRA_TYPE });
   return docs.find((d) => d.frontmatter.jiraKey === jiraKey);
 }
-function createJiraTools(store) {
+function createJiraTools(store, projectConfig) {
   const jiraUserConfig = loadUserConfig().jira;
+  const defaultProjectKey = projectConfig?.jira?.projectKey;
   return [
     // --- Local read tools ---
     tool20(
@@ -20189,10 +20583,22 @@ function createJiraTools(store) {
       "Create a Jira issue from any Marvin artifact (D/A/Q/F/E) and create a tracking JI-xxx document",
       {
         artifactId: external_exports.string().describe("Marvin artifact ID (e.g. 'D-001', 'F-003', 'E-002')"),
-        projectKey: external_exports.string().describe("Jira project key (e.g. 'PROJ')"),
+        projectKey: external_exports.string().optional().describe("Jira project key (e.g. 'PROJ'). Falls back to jira.projectKey from .marvin/config.yaml if not provided."),
         issueType: external_exports.enum(["Story", "Task", "Bug", "Epic"]).optional().describe("Jira issue type (default: 'Task')")
       },
       async (args) => {
+        const resolvedProjectKey = args.projectKey ?? defaultProjectKey;
+        if (!resolvedProjectKey) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "No projectKey provided and no default configured. Either pass projectKey or set jira.projectKey in .marvin/config.yaml."
+              }
+            ],
+            isError: true
+          };
+        }
         const jira = createJiraClient(jiraUserConfig);
         if (!jira) return jiraNotConfiguredError();
         const artifact = store.get(args.artifactId);
@@ -20212,7 +20618,7 @@ function createJiraTools(store) {
           `Status: ${artifact.frontmatter.status}`
         ].join("\n");
         const jiraResult = await jira.client.createIssue({
-          project: { key: args.projectKey },
+          project: { key: resolvedProjectKey },
           summary: artifact.frontmatter.title,
           description,
           issuetype: { name: args.issueType ?? "Task" }
@@ -20353,14 +20759,14 @@ var jiraSkill = {
   documentTypeRegistrations: [
     { type: "jira-issue", dirName: "jira-issues", idPrefix: "JI" }
   ],
-  tools: (store) => createJiraTools(store),
+  tools: (store, projectConfig) => createJiraTools(store, projectConfig),
   promptFragments: {
     "product-owner": `You have the **Jira Integration** skill. You can pull issues from Jira and push Marvin artifacts to Jira.
 
 **Available tools:**
 - \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally synced Jira issues
 - \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import issues from Jira by key or JQL query
-- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, feature, etc.)
+- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, feature, etc.). The \`projectKey\` parameter is optional when a default is configured in \`.marvin/config.yaml\` under \`jira.projectKey\`.
 - \`sync_jira_issue\` \u2014 bidirectional sync of a local JI-xxx with Jira
 - \`link_artifact_to_jira\` \u2014 link a Marvin artifact to an existing JI-xxx
 
@@ -20374,7 +20780,7 @@ var jiraSkill = {
 **Available tools:**
 - \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally synced Jira issues
 - \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import issues from Jira by key or JQL query
-- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, action, epic, task, etc.)
+- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, action, epic, task, etc.). The \`projectKey\` parameter is optional when a default is configured in \`.marvin/config.yaml\` under \`jira.projectKey\`.
 - \`sync_jira_issue\` \u2014 bidirectional sync of a local JI-xxx with Jira
 - \`link_artifact_to_jira\` \u2014 link a Marvin artifact to an existing JI-xxx
 
@@ -20388,7 +20794,7 @@ var jiraSkill = {
 **Available tools:**
 - \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally synced Jira issues
 - \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import issues from Jira by key or JQL query
-- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, action, etc.)
+- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, action, etc.). The \`projectKey\` parameter is optional when a default is configured in \`.marvin/config.yaml\` under \`jira.projectKey\`.
 - \`sync_jira_issue\` \u2014 bidirectional sync of a local JI-xxx with Jira
 - \`link_artifact_to_jira\` \u2014 link a Marvin artifact to an existing JI-xxx
 
@@ -20966,12 +21372,12 @@ function collectSkillRegistrations(skillIds, allSkills) {
   }
   return registrations;
 }
-function getSkillTools(skillIds, allSkills, store) {
+function getSkillTools(skillIds, allSkills, store, projectConfig) {
   const tools = [];
   for (const id of skillIds) {
     const skill = allSkills.get(id);
     if (skill?.tools) {
-      tools.push(...skill.tools(store));
+      tools.push(...skill.tools(store, projectConfig));
     }
   }
   return tools;
@@ -21211,6 +21617,7 @@ function createWebTools(store, projectName, navGroups) {
         const base = `http://localhost:${runningServer.port}`;
         const urls = {
           overview: base,
+          upcoming: `${base}/upcoming`,
           gar: `${base}/gar`,
           board: `${base}/board`
         };
@@ -21284,6 +21691,18 @@ function createWebTools(store, projectName, navGroups) {
         };
       },
       { annotations: { readOnlyHint: true } }
+    ),
+    tool22(
+      "get_dashboard_upcoming",
+      "Get upcoming data: due-soon actions and sprint tasks, plus trending items scored by relevance signals. Works without the web server running.",
+      {},
+      async () => {
+        const data = getUpcomingData(store);
+        return {
+          content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -21544,7 +21963,7 @@ async function startSession(options) {
   const manifest = hasSourcesDir ? new SourceManifestManager(marvinDir) : void 0;
   const pluginTools = plugin ? getPluginTools(plugin, store, marvinDir) : [];
   const pluginPromptFragment = plugin ? getPluginPromptFragment(plugin, persona.id) : void 0;
-  const codeSkillTools = getSkillTools(skillIds, allSkills, store);
+  const codeSkillTools = getSkillTools(skillIds, allSkills, store, config2.project);
   const skillAgents = getSkillAgentDefinitions(skillIds, allSkills);
   const skillPromptFragment = getSkillPromptFragment(skillIds, allSkills, persona.id);
   const allSkillIds = [...allSkills.keys()];
@@ -21656,6 +22075,7 @@ Marvin \u2014 ${persona.name}
       "mcp__marvin-governance__get_dashboard_overview",
       "mcp__marvin-governance__get_dashboard_gar",
       "mcp__marvin-governance__get_dashboard_board",
+      "mcp__marvin-governance__get_dashboard_upcoming",
       ...pluginTools.map((t) => `mcp__marvin-governance__${t.name}`),
       ...codeSkillTools.map((t) => `mcp__marvin-governance__${t.name}`)
     ]
@@ -22055,7 +22475,7 @@ function collectTools(marvinDir) {
   const sessionStore = new SessionStore(marvinDir);
   const allSkills = loadAllSkills(marvinDir);
   const allSkillIds = [...allSkills.keys()];
-  const codeSkillTools = getSkillTools(allSkillIds, allSkills, store);
+  const codeSkillTools = getSkillTools(allSkillIds, allSkills, store, config2);
   const skillsWithActions = allSkillIds.map((id) => allSkills.get(id)).filter((s) => s.actions && s.actions.length > 0);
   const projectRoot = path11.dirname(marvinDir);
   const actionTools = createSkillActionTools(skillsWithActions, { store, marvinDir, projectRoot });
@@ -24821,7 +25241,7 @@ function createProgram() {
   const program = new Command();
   program.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.4.4");
+  ).version("0.4.5");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });