mrvn-cli 0.5.13 → 0.5.14

package/dist/marvin-serve.js

@@ -176,9 +176,9 @@ var DocumentStore = class {
       }
     }
   }
-  list(query4) {
+  list(query5) {
     const results = [];
-    const types = query4?.type ? [query4.type] : Object.keys(this.typeDirs);
+    const types = query5?.type ? [query5.type] : Object.keys(this.typeDirs);
     for (const type of types) {
       const dirName = this.typeDirs[type];
       if (!dirName) continue;
@@ -189,9 +189,9 @@ var DocumentStore = class {
         const filePath = path3.join(dir, file2);
         const raw = fs3.readFileSync(filePath, "utf-8");
         const doc = parseDocument(raw, filePath);
-        if (query4?.status && doc.frontmatter.status !== query4.status) continue;
-        if (query4?.owner && doc.frontmatter.owner !== query4.owner) continue;
-        if (query4?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query4.tag)))
+        if (query5?.status && doc.frontmatter.status !== query5.status) continue;
+        if (query5?.owner && doc.frontmatter.owner !== query5.owner) continue;
+        if (query5?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query5.tag)))
           continue;
         results.push(doc);
       }
@@ -19196,6 +19196,11 @@ function mapJiraStatusForTask(status, configMap) {
   const lookup = buildStatusLookup(configMap, DEFAULT_TASK_STATUS_MAP);
   return lookup.get(status.toLowerCase()) ?? "backlog";
 }
+function extractJiraKeyFromTags(tags) {
+  if (!tags) return void 0;
+  const tag = tags.find((t) => /^jira:[A-Z]+-\d+$/i.test(t));
+  return tag ? tag.slice(5) : void 0;
+}
 function computeSubtaskProgress(subtasks) {
   if (subtasks.length === 0) return 0;
   const done = subtasks.filter(
@@ -19538,10 +19543,10 @@ async function fetchJiraDaily(store, client, host, projectKey, dateRange, status
       jiraKeyToArtifacts.set(jk, list);
     }
   }
-  const BATCH_SIZE = 5;
+  const BATCH_SIZE2 = 5;
   const issues = searchResult.issues;
-  for (let i = 0; i < issues.length; i += BATCH_SIZE) {
-    const batch = issues.slice(i, i + BATCH_SIZE);
+  for (let i = 0; i < issues.length; i += BATCH_SIZE2) {
+    const batch = issues.slice(i, i + BATCH_SIZE2);
     const results = await Promise.allSettled(
       batch.map(
         (issue2) => processIssue(issue2, client, host, dateRange, jiraKeyToArtifacts, allDocs, statusMap)
@@ -19765,6 +19770,420 @@ function generateProposedActions(issues) {
   return actions;
 }
 
+// src/skills/builtin/jira/sprint-progress.ts
+import { query as query2 } from "@anthropic-ai/claude-agent-sdk";
+var DONE_STATUSES7 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "obsolete", "wont do", "cancelled"]);
+var BATCH_SIZE = 5;
+async function assessSprintProgress(store, client, host, options = {}) {
+  const errors = [];
+  const sprintData = collectSprintSummaryData(store, options.sprintId);
+  if (!sprintData) {
+    return {
+      sprintId: options.sprintId ?? "unknown",
+      sprintTitle: "Sprint not found",
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      timeline: { startDate: null, endDate: null, daysRemaining: 0, totalDays: 0, percentComplete: 0 },
+      overallProgress: 0,
+      itemReports: [],
+      focusAreas: [],
+      driftItems: [],
+      blockers: [],
+      proposedUpdates: [],
+      appliedUpdates: [],
+      errors: [`Sprint ${options.sprintId ?? "(active)"} not found. Create a sprint artifact first.`]
+    };
+  }
+  const sprintTag = `sprint:${sprintData.sprint.id}`;
+  const actions = store.list({ type: "action", tag: sprintTag });
+  const tasks = store.list({ type: "task", tag: sprintTag });
+  const sprintItemIds = new Set([...actions, ...tasks].map((d) => d.frontmatter.id));
+  const allTasks = store.list({ type: "task" });
+  const allActions = store.list({ type: "action" });
+  const nestedTasks = allTasks.filter(
+    (d) => !sprintItemIds.has(d.frontmatter.id) && d.frontmatter.aboutArtifact && sprintItemIds.has(d.frontmatter.aboutArtifact)
+  );
+  const nestedActions = allActions.filter(
+    (d) => !sprintItemIds.has(d.frontmatter.id) && d.frontmatter.aboutArtifact && sprintItemIds.has(d.frontmatter.aboutArtifact)
+  );
+  const allItems = [...actions, ...tasks, ...nestedTasks, ...nestedActions];
+  const itemJiraKeys = /* @__PURE__ */ new Map();
+  for (const doc of allItems) {
+    const jiraKey = doc.frontmatter.jiraKey ?? extractJiraKeyFromTags(doc.frontmatter.tags);
+    if (jiraKey) {
+      itemJiraKeys.set(doc.frontmatter.id, jiraKey);
+    }
+  }
+  const jiraKeys = [...new Set(itemJiraKeys.values())];
+  const jiraIssues = /* @__PURE__ */ new Map();
+  for (let i = 0; i < jiraKeys.length; i += BATCH_SIZE) {
+    const batch = jiraKeys.slice(i, i + BATCH_SIZE);
+    const results = await Promise.allSettled(
+      batch.map(async (key) => {
+        const [issue2, comments] = await Promise.all([
+          client.getIssueWithLinks(key),
+          client.getComments(key)
+        ]);
+        return { key, issue: issue2, comments };
+      })
+    );
+    for (const result of results) {
+      if (result.status === "fulfilled") {
+        jiraIssues.set(result.value.key, {
+          issue: result.value.issue,
+          comments: result.value.comments
+        });
+      } else {
+        const batchKey = batch[results.indexOf(result)];
+        errors.push(`Failed to fetch ${batchKey}: ${result.reason instanceof Error ? result.reason.message : String(result.reason)}`);
+      }
+    }
+  }
+  const proposedUpdates = [];
+  const itemReports = [];
+  const childReportsByParent = /* @__PURE__ */ new Map();
+  for (const doc of allItems) {
+    const fm = doc.frontmatter;
+    const jiraKey = itemJiraKeys.get(fm.id) ?? null;
+    const jiraData = jiraKey ? jiraIssues.get(jiraKey) : null;
+    let jiraStatus = null;
+    let proposedMarvinStatus = null;
+    let jiraSubtaskProgress = null;
+    const commentSignals = [];
+    if (jiraData) {
+      jiraStatus = jiraData.issue.fields.status.name;
+      proposedMarvinStatus = fm.type === "task" ? mapJiraStatusForTask(jiraStatus, options.statusMap?.task) : mapJiraStatusForAction(jiraStatus, options.statusMap?.action);
+      const subtasks = jiraData.issue.fields.subtasks ?? [];
+      if (subtasks.length > 0) {
+        jiraSubtaskProgress = computeSubtaskProgress(subtasks);
+      }
+      for (const comment of jiraData.comments) {
+        const text = extractCommentText(comment.body);
+        const signals = detectCommentSignals(text);
+        commentSignals.push(...signals);
+      }
+    }
+    const statusDrift = proposedMarvinStatus !== null && proposedMarvinStatus !== fm.status;
+    const currentProgress = getEffectiveProgress(fm);
+    const progressDrift = jiraSubtaskProgress !== null && !fm.progressOverride && jiraSubtaskProgress !== currentProgress;
+    if (statusDrift && proposedMarvinStatus) {
+      proposedUpdates.push({
+        artifactId: fm.id,
+        field: "status",
+        currentValue: fm.status,
+        proposedValue: proposedMarvinStatus,
+        reason: `Jira ${jiraKey} is "${jiraStatus}" \u2192 maps to "${proposedMarvinStatus}"`
+      });
+    }
+    if (progressDrift && jiraSubtaskProgress !== null) {
+      proposedUpdates.push({
+        artifactId: fm.id,
+        field: "progress",
+        currentValue: currentProgress,
+        proposedValue: jiraSubtaskProgress,
+        reason: `Jira ${jiraKey} subtask progress is ${jiraSubtaskProgress}%`
+      });
+    }
+    const tags = fm.tags ?? [];
+    const focusTag = tags.find((t) => t.startsWith("focus:"));
+    const report = {
+      id: fm.id,
+      title: fm.title,
+      type: fm.type,
+      marvinStatus: fm.status,
+      marvinProgress: currentProgress,
+      jiraKey,
+      jiraStatus,
+      jiraSubtaskProgress,
+      proposedMarvinStatus,
+      statusDrift,
+      progressDrift,
+      commentSignals,
+      commentSummary: null,
+      children: [],
+      owner: fm.owner ?? null,
+      focusArea: focusTag ? focusTag.slice(6) : null
+    };
+    const aboutArtifact = fm.aboutArtifact;
+    if (aboutArtifact && sprintItemIds.has(aboutArtifact)) {
+      if (!childReportsByParent.has(aboutArtifact)) {
+        childReportsByParent.set(aboutArtifact, []);
+      }
+      childReportsByParent.get(aboutArtifact).push(report);
+    }
+    itemReports.push(report);
+  }
+  for (const report of itemReports) {
+    const children = childReportsByParent.get(report.id);
+    if (children) {
+      report.children = children;
+    }
+  }
+  const childIds = /* @__PURE__ */ new Set();
+  for (const children of childReportsByParent.values()) {
+    for (const child of children) childIds.add(child.id);
+  }
+  const rootReports = itemReports.filter((r) => !childIds.has(r.id));
+  const focusAreaMap = /* @__PURE__ */ new Map();
+  for (const report of rootReports) {
+    const area = report.focusArea ?? "Uncategorized";
+    if (!focusAreaMap.has(area)) focusAreaMap.set(area, []);
+    focusAreaMap.get(area).push(report);
+  }
+  const focusAreas = [];
+  for (const [name, items] of focusAreaMap) {
+    const allFlatItems = items.flatMap((i) => [i, ...i.children]);
+    const doneCount = allFlatItems.filter((i) => DONE_STATUSES7.has(i.marvinStatus)).length;
+    const blockedCount = allFlatItems.filter((i) => i.marvinStatus === "blocked").length;
+    const avgProgress = allFlatItems.length > 0 ? Math.round(allFlatItems.reduce((s, i) => s + i.marvinProgress, 0) / allFlatItems.length) : 0;
+    focusAreas.push({
+      name,
+      items,
+      totalCount: allFlatItems.length,
+      doneCount,
+      blockedCount,
+      avgProgress
+    });
+  }
+  focusAreas.sort((a, b) => {
+    if (a.name === "Uncategorized") return 1;
+    if (b.name === "Uncategorized") return -1;
+    return a.name.localeCompare(b.name);
+  });
+  const driftItems = itemReports.filter((r) => r.statusDrift || r.progressDrift);
+  const blockers = itemReports.filter(
+    (r) => r.marvinStatus === "blocked" || r.commentSignals.some((s) => s.type === "blocker")
+  );
+  if (options.analyzeComments) {
+    const itemsWithComments = itemReports.filter((r) => r.commentSignals.length > 0 && r.jiraKey);
+    if (itemsWithComments.length > 0) {
+      try {
+        const summaries = await analyzeCommentsForProgress(
+          itemsWithComments,
+          jiraIssues,
+          itemJiraKeys
+        );
+        for (const [artifactId, summary] of summaries) {
+          const report = itemReports.find((r) => r.id === artifactId);
+          if (report) report.commentSummary = summary;
+        }
+      } catch (err) {
+        errors.push(`Comment analysis failed: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+  }
+  const appliedUpdates = [];
+  if (options.applyUpdates && proposedUpdates.length > 0) {
+    for (const update of proposedUpdates) {
+      try {
+        store.update(update.artifactId, {
+          [update.field]: update.proposedValue,
+          lastJiraSyncAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        const doc = store.get(update.artifactId);
+        if (doc) {
+          if (doc.frontmatter.type === "task") {
+            propagateProgressFromTask(store, update.artifactId);
+          } else if (doc.frontmatter.type === "action") {
+            propagateProgressToAction(store, update.artifactId);
+          }
+        }
+        appliedUpdates.push(update);
+      } catch (err) {
+        errors.push(
+          `Failed to apply update to ${update.artifactId}: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  }
+  return {
+    sprintId: sprintData.sprint.id,
+    sprintTitle: sprintData.sprint.title,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    timeline: {
+      startDate: sprintData.sprint.startDate ?? null,
+      endDate: sprintData.sprint.endDate ?? null,
+      daysRemaining: sprintData.timeline.daysRemaining,
+      totalDays: sprintData.timeline.totalDays,
+      percentComplete: sprintData.timeline.percentComplete
+    },
+    overallProgress: sprintData.workItems.completionPct,
+    itemReports: rootReports,
+    focusAreas,
+    driftItems,
+    blockers,
+    proposedUpdates: options.applyUpdates ? [] : proposedUpdates,
+    appliedUpdates,
+    errors
+  };
+}
+var COMMENT_ANALYSIS_PROMPT = `You are a delivery management assistant analyzing Jira comments for progress signals.
+
+For each item below, read the Jira comments and produce a 1-2 sentence progress summary.
+Focus on: what work was done, what's pending, any blockers or decisions mentioned.
+
+Return your response as a JSON object mapping artifact IDs to summary strings.
+Example: {"T-001": "Backend API completed and deployed. Frontend integration pending review.", "A-003": "Blocked on infrastructure team approval."}
+
+IMPORTANT: Only return the JSON object, no other text.`;
+async function analyzeCommentsForProgress(items, jiraIssues, itemJiraKeys) {
+  const summaries = /* @__PURE__ */ new Map();
+  const MAX_ITEMS_PER_CALL = 20;
+  const itemsToAnalyze = items.slice(0, MAX_ITEMS_PER_CALL);
+  const promptParts = [];
+  for (const item of itemsToAnalyze) {
+    const jiraKey = itemJiraKeys.get(item.id);
+    if (!jiraKey) continue;
+    const jiraData = jiraIssues.get(jiraKey);
+    if (!jiraData || jiraData.comments.length === 0) continue;
+    const commentTexts = jiraData.comments.map((c) => {
+      const text = extractCommentText(c.body);
+      return `  [${c.author.displayName}, ${c.created.slice(0, 10)}]: ${text.slice(0, 500)}`;
+    }).join("\n");
+    promptParts.push(`## ${item.id} \u2014 ${item.title} (${jiraKey}, Jira status: ${item.jiraStatus})
+Comments:
+${commentTexts}`);
+  }
+  if (promptParts.length === 0) return summaries;
+  const prompt = promptParts.join("\n\n");
+  const result = query2({
+    prompt,
+    options: {
+      systemPrompt: COMMENT_ANALYSIS_PROMPT,
+      maxTurns: 1,
+      tools: [],
+      allowedTools: []
+    }
+  });
+  for await (const msg of result) {
+    if (msg.type === "assistant") {
+      const textBlock = msg.message.content.find(
+        (b) => b.type === "text"
+      );
+      if (textBlock) {
+        try {
+          const parsed = JSON.parse(textBlock.text);
+          for (const [id, summary] of Object.entries(parsed)) {
+            if (typeof summary === "string") {
+              summaries.set(id, summary);
+            }
+          }
+        } catch {
+          const match = textBlock.text.match(/```(?:json)?\s*([\s\S]*?)```/);
+          if (match) {
+            try {
+              const parsed = JSON.parse(match[1]);
+              for (const [id, summary] of Object.entries(parsed)) {
+                if (typeof summary === "string") {
+                  summaries.set(id, summary);
+                }
+              }
+            } catch {
+            }
+          }
+        }
+      }
+    }
+  }
+  return summaries;
+}
+function formatProgressReport(report) {
+  const parts = [];
+  parts.push(`# Sprint Progress Assessment \u2014 ${report.sprintId}`);
+  parts.push(`${report.sprintTitle}`);
+  parts.push(`Generated: ${report.generatedAt.slice(0, 16)}`);
+  parts.push("");
+  if (report.timeline.startDate && report.timeline.endDate) {
+    parts.push(`## Timeline`);
+    parts.push(`${report.timeline.startDate} \u2192 ${report.timeline.endDate}`);
+    parts.push(`Days remaining: ${report.timeline.daysRemaining} / ${report.timeline.totalDays} (${report.timeline.percentComplete}% elapsed)`);
+    parts.push(`Overall progress: ${report.overallProgress}%`);
+    parts.push("");
+  }
+  if (report.focusAreas.length > 0) {
+    parts.push(`## Focus Areas`);
+    parts.push("");
+    for (const area of report.focusAreas) {
+      const bar = progressBar(area.avgProgress);
+      parts.push(`### ${area.name} ${bar} ${area.avgProgress}%`);
+      parts.push(`${area.doneCount}/${area.totalCount} done${area.blockedCount > 0 ? ` | ${area.blockedCount} blocked` : ""}`);
+      parts.push("");
+      for (const item of area.items) {
+        formatItemLine(parts, item, 0);
+      }
+      parts.push("");
+    }
+  }
+  if (report.driftItems.length > 0) {
+    parts.push(`## Status Drift (${report.driftItems.length} items)`);
+    for (const item of report.driftItems) {
+      const driftParts = [];
+      if (item.statusDrift) {
+        driftParts.push(`status: ${item.marvinStatus} \u2192 ${item.proposedMarvinStatus}`);
+      }
+      if (item.progressDrift && item.jiraSubtaskProgress !== null) {
+        driftParts.push(`progress: ${item.marvinProgress}% \u2192 ${item.jiraSubtaskProgress}%`);
+      }
+      parts.push(`  \u26A0 ${item.id} (${item.jiraKey}) \u2014 ${driftParts.join(", ")}`);
+    }
+    parts.push("");
+  }
+  if (report.blockers.length > 0) {
+    parts.push(`## Blockers (${report.blockers.length})`);
+    for (const item of report.blockers) {
+      const blockerSignals = item.commentSignals.filter((s) => s.type === "blocker");
+      parts.push(`  \u{1F6AB} ${item.id} \u2014 ${item.title}${item.jiraKey ? ` (${item.jiraKey})` : ""}`);
+      for (const signal of blockerSignals) {
+        parts.push(`     "${signal.snippet}"`);
+      }
+    }
+    parts.push("");
+  }
+  if (report.proposedUpdates.length > 0) {
+    parts.push(`## Proposed Updates (${report.proposedUpdates.length})`);
+    for (const update of report.proposedUpdates) {
+      parts.push(`  ${update.artifactId}.${update.field}: ${String(update.currentValue)} \u2192 ${String(update.proposedValue)}`);
+      parts.push(`    Reason: ${update.reason}`);
+    }
+    parts.push("");
+    parts.push("Run with applyUpdates=true to apply these changes.");
+    parts.push("");
+  }
+  if (report.appliedUpdates.length > 0) {
+    parts.push(`## Applied Updates (${report.appliedUpdates.length})`);
+    for (const update of report.appliedUpdates) {
+      parts.push(`  \u2713 ${update.artifactId}.${update.field}: ${String(update.currentValue)} \u2192 ${String(update.proposedValue)}`);
+    }
+    parts.push("");
+  }
+  if (report.errors.length > 0) {
+    parts.push(`## Errors`);
+    for (const err of report.errors) {
+      parts.push(`  ${err}`);
+    }
+    parts.push("");
+  }
+  return parts.join("\n");
+}
+function formatItemLine(parts, item, depth) {
+  const indent = "  ".repeat(depth + 1);
+  const statusIcon = DONE_STATUSES7.has(item.marvinStatus) ? "\u2713" : item.marvinStatus === "blocked" ? "\u{1F6AB}" : item.marvinStatus === "in-progress" ? "\u25B6" : "\u25CB";
+  const jiraLabel = item.jiraKey ? ` [${item.jiraKey}: ${item.jiraStatus}]` : "";
+  const driftFlag = item.statusDrift ? " \u26A0drift" : "";
+  const progressLabel = item.marvinProgress > 0 ? ` ${item.marvinProgress}%` : "";
+  parts.push(`${indent}${statusIcon} ${item.id} \u2014 ${item.title} [${item.marvinStatus}]${progressLabel}${jiraLabel}${driftFlag}`);
+  if (item.commentSummary) {
+    parts.push(`${indent}  \u{1F4AC} ${item.commentSummary}`);
+  }
+  for (const child of item.children) {
+    formatItemLine(parts, child, depth + 1);
+  }
+}
+function progressBar(pct) {
+  const filled = Math.round(pct / 10);
+  const empty = 10 - filled;
+  return `[${"\u2588".repeat(filled)}${"\u2591".repeat(empty)}]`;
+}
+
 // src/skills/builtin/jira/tools.ts
 var JIRA_TYPE = "jira-issue";
 function jiraNotConfiguredError() {
@@ -20530,6 +20949,36 @@ function createJiraTools(store, projectConfig) {
         };
       },
       { annotations: { readOnlyHint: true } }
+    ),
+    // --- Sprint progress assessment ---
+    tool20(
+      "assess_sprint_progress",
+      "Assess sprint progress by fetching live Jira statuses for all sprint-scoped items, detecting drift between Marvin and Jira, grouping by focus area with rollup progress, and extracting comment signals. Optionally applies updates and uses LLM for comment analysis.",
+      {
+        sprintId: external_exports.string().optional().describe("Sprint ID (e.g. 'SP-001'). Defaults to active sprint."),
+        analyzeComments: external_exports.boolean().optional().describe("Use LLM to summarize Jira comments for progress signals (default false)"),
+        applyUpdates: external_exports.boolean().optional().describe("Apply proposed status/progress updates to Marvin artifacts (default false)")
+      },
+      async (args) => {
+        const jira = createJiraClient(jiraUserConfig);
+        if (!jira) return jiraNotConfiguredError();
+        const report = await assessSprintProgress(
+          store,
+          jira.client,
+          jira.host,
+          {
+            sprintId: args.sprintId,
+            analyzeComments: args.analyzeComments ?? false,
+            applyUpdates: args.applyUpdates ?? false,
+            statusMap
+          }
+        );
+        return {
+          content: [{ type: "text", text: formatProgressReport(report) }],
+          isError: report.errors.length > 0 && report.itemReports.length === 0
+        };
+      },
+      { annotations: { readOnlyHint: false } }
     )
   ];
 }
@@ -20631,6 +21080,7 @@ var COMMON_TOOLS = `**Available tools:**
 - \`read_confluence_page\` \u2014 **read-only**: fetch and return the content of a Confluence page by URL or page ID. Use this to review Confluence content for updating tasks, generating contributions, or answering questions.
 - \`fetch_jira_status\` \u2014 **read-only**: fetch current Jira status, subtask progress, and linked issues for Jira-linked actions/tasks. Returns proposed changes without applying them.
 - \`fetch_jira_daily\` \u2014 **read-only**: fetch a daily/range summary of all Jira changes \u2014 status transitions, comments, linked Confluence pages, and cross-references with Marvin artifacts. Returns proposed actions (status updates, unlinked issues, question candidates, Confluence pages to review).
+- \`assess_sprint_progress\` \u2014 fetch live Jira statuses for all sprint-scoped items, detect drift, group by focus area with rollup progress, and extract comment signals. Use \`analyzeComments=true\` for LLM summaries, \`applyUpdates=true\` to apply changes.
 - \`fetch_jira_statuses\` \u2014 **read-only**: discover all Jira statuses in a project and show their Marvin mappings (mapped vs unmapped).
 - \`search_jira\` \u2014 **read-only**: search Jira via JQL and return results with Marvin cross-references. No documents created \u2014 use to preview before importing or find issues for linking.
 - \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import Jira issues as local JI-xxx documents (for Jira-originated items with no existing Marvin artifact).
@@ -20642,6 +21092,11 @@ var COMMON_WORKFLOW = `**Jira sync workflow:**
 2. Analyze the proposed changes (status transitions, subtask progress, blockers from linked issues)
 3. Use \`update_action\` / \`update_task\` to apply the changes you agree with
 
+**Sprint progress workflow:**
+1. Call \`assess_sprint_progress\` to get a comprehensive view of all sprint items with live Jira data
+2. Review focus area rollups, status drift, and blockers
+3. Optionally run with \`applyUpdates=true\` to bulk-sync statuses, or \`analyzeComments=true\` for LLM-powered comment summaries
+
 **Daily review workflow:**
 1. Call \`fetch_jira_daily\` (optionally with \`from\`/\`to\` date range) to get a summary of all Jira activity
 2. Review the proposed actions: status updates, unlinked issues to track, questions that may be answered, Confluence pages to review
@@ -20665,6 +21120,7 @@ ${COMMON_WORKFLOW}
 
 **As Product Owner, use Jira integration to:**
 - Use \`fetch_jira_daily\` for daily standups \u2014 review what changed, identify status drift, spot untracked work
+- Use \`assess_sprint_progress\` for sprint reviews \u2014 see overall progress by focus area, detect drift, and identify blockers
 - Pull stakeholder-reported issues for triage and prioritization
 - Push approved features as Stories for development tracking
 - Link decisions to Jira issues for audit trail and traceability
@@ -20677,6 +21133,7 @@ ${COMMON_WORKFLOW}
 
 **As Tech Lead, use Jira integration to:**
 - Use \`fetch_jira_daily\` to review technical progress \u2014 status transitions, new comments, Confluence design docs
+- Use \`assess_sprint_progress\` for sprint health checks \u2014 focus area rollups, Jira drift detection, blocker tracking
 - Pull technical issues and bugs for sprint planning and estimation
 - Push epics, tasks, and technical decisions to Jira for cross-team visibility
 - Use \`link_to_jira\` to connect Marvin tasks to existing Jira tickets
@@ -20690,6 +21147,8 @@ This is a third path for progress tracking alongside Contributions and Meetings.
 
 **As Delivery Manager, use Jira integration to:**
 - Use \`fetch_jira_daily\` for daily progress reports \u2014 track what moved, identify blockers, spot untracked work
+- Use \`assess_sprint_progress\` for sprint reviews and stakeholder updates \u2014 comprehensive progress by focus area with Jira enrichment
+- Use \`assess_sprint_progress\` with \`applyUpdates=true\` to bulk-sync Marvin statuses from Jira
 - Pull sprint issues for tracking progress and blockers
 - Push actions and tasks to Jira for stakeholder visibility
 - Use \`fetch_jira_daily\` with a date range for sprint retrospectives (e.g. \`from: "2026-03-10", to: "2026-03-21"\`)
@@ -21274,7 +21733,7 @@ ${fragment}`);
 import { tool as tool24 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
-import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/agent/mcp-server.ts
 import {
@@ -23425,7 +23884,7 @@ function personaPickerPage() {
 }
 
 // src/reports/sprint-summary/risk-assessment.ts
-import { query as query2 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
 var SYSTEM_PROMPT2 = `You are a delivery management assistant generating a data-driven risk assessment.
 
 IMPORTANT: All the data you need is provided in the user message below. Do NOT attempt to look up, search for, or request additional information. Analyze ONLY the data given and produce your assessment immediately.
@@ -23454,7 +23913,7 @@ async function generateRiskAssessment(data, riskId, store) {
   const risk = data.risks.find((r) => r.id === riskId);
   if (!risk) return "Risk not found in sprint data.";
   const prompt = buildSingleRiskPrompt(data, risk, store);
-  const result = query2({
+  const result = query3({
     prompt,
     options: {
       systemPrompt: SYSTEM_PROMPT2,
@@ -24084,7 +24543,7 @@ function buildHealthGauge(categories) {
 }
 
 // src/web/templates/pages/po/dashboard.ts
-var DONE_STATUSES7 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES8 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 var RESOLVED_DECISION_STATUSES = /* @__PURE__ */ new Set(["decided", "superseded", "dismissed"]);
 function poDashboardPage(ctx) {
   const overview = getOverviewData(ctx.store);
@@ -24129,7 +24588,7 @@ function poDashboardPage(ctx) {
       sprintTimelinePct = Math.min(100, Math.max(0, Math.round((Date.now() - startMs) / totalDays * 100)));
     }
   }
-  const featuresDone = features.filter((d) => DONE_STATUSES7.has(d.frontmatter.status)).length;
+  const featuresDone = features.filter((d) => DONE_STATUSES8.has(d.frontmatter.status)).length;
   const featuresOpen = features.filter((d) => d.frontmatter.status === "open").length;
   const featuresInProgress = features.filter((d) => d.frontmatter.status === "in-progress").length;
   const decisionsOpen = decisions.filter((d) => !RESOLVED_DECISION_STATUSES.has(d.frontmatter.status)).length;
@@ -24198,7 +24657,7 @@ function poDashboardPage(ctx) {
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const atRiskItems = [];
   for (const f of features) {
-    if (DONE_STATUSES7.has(f.frontmatter.status)) continue;
+    if (DONE_STATUSES8.has(f.frontmatter.status)) continue;
     const fEpics = featureToEpics.get(f.frontmatter.id) ?? [];
     const reasons = [];
     let blocked = 0;
@@ -24210,7 +24669,7 @@ function poDashboardPage(ctx) {
     if (blocked > 0) reasons.push(`${blocked} blocked task${blocked > 1 ? "s" : ""}`);
     for (const epic of fEpics) {
       const td = epic.frontmatter.targetDate;
-      if (td && td < today && !DONE_STATUSES7.has(epic.frontmatter.status)) {
+      if (td && td < today && !DONE_STATUSES8.has(epic.frontmatter.status)) {
         reasons.push(`${epic.frontmatter.id} overdue`);
       }
     }
@@ -24488,7 +24947,7 @@ function poBacklogPage(ctx) {
       }
     }
   }
-  const DONE_STATUSES16 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+  const DONE_STATUSES17 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
   function featureTaskStats(featureId) {
     const fEpics = featureToEpics.get(featureId) ?? [];
     let total = 0;
@@ -24497,7 +24956,7 @@ function poBacklogPage(ctx) {
     for (const epic of fEpics) {
       for (const t of epicToTasks.get(epic.frontmatter.id) ?? []) {
         total++;
-        if (DONE_STATUSES16.has(t.frontmatter.status)) done++;
+        if (DONE_STATUSES17.has(t.frontmatter.status)) done++;
         progressSum += getEffectiveProgress(t.frontmatter);
       }
     }
@@ -24851,7 +25310,7 @@ function renderWorkItemsTable(items, options) {
     { titleTag: "h3", defaultCollapsed }
   );
 }
-var DONE_STATUSES8 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled", "decided"]);
+var DONE_STATUSES9 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled", "decided"]);
 function computeOwnerCompletionPct(items, owner) {
   let total = 0;
   let progressSum = 0;
@@ -24859,7 +25318,7 @@ function computeOwnerCompletionPct(items, owner) {
     for (const w of list) {
       if (w.type !== "contribution" && w.owner === owner) {
         total++;
-        progressSum += w.progress ?? (DONE_STATUSES8.has(w.status) ? 100 : 0);
+        progressSum += w.progress ?? (DONE_STATUSES9.has(w.status) ? 100 : 0);
       }
       if (w.children) walk(w.children);
     }
@@ -24880,7 +25339,7 @@ function filterItemsByOwner(items, owner) {
 }
 
 // src/web/templates/pages/po/delivery.ts
-var DONE_STATUSES9 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES10 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 var priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
 var statusOrder = { "in-progress": 0, open: 1, draft: 2, blocked: 3, done: 4, closed: 5, resolved: 6 };
 function priorityClass2(p) {
@@ -24900,7 +25359,7 @@ var PO_CONTRIBUTION_TYPES = /* @__PURE__ */ new Set([
   "priority-change",
   "market-insight"
 ]);
-function progressBar(pct) {
+function progressBar2(pct) {
   return `<div class="sprint-progress-bar">
     <div class="sprint-progress-fill" style="width: ${pct}%"></div>
     <span class="sprint-progress-label">${pct}%</span>
@@ -25021,7 +25480,7 @@ function poDeliveryPage(ctx) {
     }
     return total > 0 ? Math.round(progressSum / total) : 0;
   }
-  const nonDoneFeatures = features.filter((f) => !DONE_STATUSES9.has(f.frontmatter.status)).sort((a, b) => {
+  const nonDoneFeatures = features.filter((f) => !DONE_STATUSES10.has(f.frontmatter.status)).sort((a, b) => {
     const pa = priorityOrder[a.frontmatter.priority?.toLowerCase()] ?? 99;
     const pb = priorityOrder[b.frontmatter.priority?.toLowerCase()] ?? 99;
     if (pa !== pb) return pa - pb;
@@ -25080,7 +25539,7 @@ function poDeliveryPage(ctx) {
       <div class="subtitle">Sprint progress and feature delivery tracking</div>
     </div>
     ${sprintHeader}
-    ${progressBar(data.workItems.completionPct)}
+    ${progressBar2(data.workItems.completionPct)}
     ${statsCards}
     ${workItemsSection}
     ${epicsSection}
@@ -25230,8 +25689,8 @@ registerPersonaPage("po", "delivery", poDeliveryPage);
 registerPersonaPage("po", "stakeholders", poStakeholdersPage);
 
 // src/web/templates/pages/dm/dashboard.ts
-var DONE_STATUSES10 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
-function progressBar2(pct) {
+var DONE_STATUSES11 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+function progressBar3(pct) {
   return `<div class="sprint-progress-bar">
     <div class="sprint-progress-fill" style="width: ${pct}%"></div>
     <span class="sprint-progress-label">${pct}%</span>
@@ -25241,7 +25700,7 @@ function dmDashboardPage(ctx) {
   const sprintData = getSprintSummaryData(ctx.store);
   const upcoming = getUpcomingData(ctx.store);
   const actions = ctx.store.list({ type: "action" });
-  const openActions = actions.filter((d) => !DONE_STATUSES10.has(d.frontmatter.status));
+  const openActions = actions.filter((d) => !DONE_STATUSES11.has(d.frontmatter.status));
   const overdueActions = upcoming.dueSoonActions.filter((a) => a.urgency === "overdue");
   const statsCards = `
     <div class="cards">
@@ -25279,7 +25738,7 @@ function dmDashboardPage(ctx) {
         <strong>${escapeHtml(sprintData.sprint.id)} \u2014 ${escapeHtml(sprintData.sprint.title)}</strong>
         ${sprintData.sprint.goal ? ` | ${escapeHtml(sprintData.sprint.goal)}` : ""}
       </div>
-      ${progressBar2(sprintData.workItems.completionPct)}` : "";
+      ${progressBar3(sprintData.workItems.completionPct)}` : "";
   const riskItems = [];
   if (overdueActions.length > 0) riskItems.push(`${overdueActions.length} overdue action(s)`);
   if ((sprintData?.blockers.length ?? 0) > 0) riskItems.push(`${sprintData.blockers.length} blocker(s)`);
@@ -25329,7 +25788,7 @@ function dmDashboardPage(ctx) {
 }
 
 // src/web/templates/pages/dm/sprint.ts
-function progressBar3(pct) {
+function progressBar4(pct) {
   return `<div class="sprint-progress-bar">
     <div class="sprint-progress-fill" style="width: ${pct}%"></div>
     <span class="sprint-progress-label">${pct}%</span>
@@ -25452,7 +25911,7 @@ function dmSprintPage(ctx) {
       <div class="subtitle">Sprint Execution ${dateRange}</div>
     </div>
     ${goalHtml}
-    ${progressBar3(data.timeline.percentComplete)}
+    ${progressBar4(data.timeline.percentComplete)}
     ${statsCards}
     ${workItemsSection}
     ${epicsSection}
@@ -25462,7 +25921,7 @@ function dmSprintPage(ctx) {
 }
 
 // src/web/templates/pages/dm/actions.ts
-var DONE_STATUSES11 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES12 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 function urgencyBadge(tier) {
   const labels = {
     overdue: "Overdue",
@@ -25482,7 +25941,7 @@ function urgencyRowClass(tier) {
 function dmActionsPage(ctx) {
   const upcoming = getUpcomingData(ctx.store);
   const allActions = ctx.store.list({ type: "action" });
-  const openActions = allActions.filter((d) => !DONE_STATUSES11.has(d.frontmatter.status));
+  const openActions = allActions.filter((d) => !DONE_STATUSES12.has(d.frontmatter.status));
   const overdueActions = upcoming.dueSoonActions.filter((a) => a.urgency === "overdue");
   const dueThisWeek = upcoming.dueSoonActions.filter((a) => a.urgency === "due-3d" || a.urgency === "due-7d");
   const unownedActions = openActions.filter((d) => !d.frontmatter.owner);
@@ -25567,7 +26026,7 @@ function dmActionsPage(ctx) {
 }
 
 // src/web/templates/pages/dm/risks.ts
-var DONE_STATUSES12 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES13 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 function dmRisksPage(ctx) {
   const allDocs = ctx.store.list();
   const upcoming = getUpcomingData(ctx.store);
@@ -25578,7 +26037,7 @@ function dmRisksPage(ctx) {
   const todayMs = new Date(today).getTime();
   const fourteenDaysMs = 14 * 864e5;
   const agingItems = allDocs.filter((d) => {
-    if (DONE_STATUSES12.has(d.frontmatter.status)) return false;
+    if (DONE_STATUSES13.has(d.frontmatter.status)) return false;
     if (!["action", "question"].includes(d.frontmatter.type)) return false;
     const createdMs = new Date(d.frontmatter.created).getTime();
     return todayMs - createdMs > fourteenDaysMs;
@@ -25692,7 +26151,7 @@ function dmRisksPage(ctx) {
 }
 
 // src/web/templates/pages/dm/meetings.ts
-var DONE_STATUSES13 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES14 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 function dmMeetingsPage(ctx) {
   const meetings = ctx.store.list({ type: "meeting" });
   const actions = ctx.store.list({ type: "action" });
@@ -25738,7 +26197,7 @@ function dmMeetingsPage(ctx) {
             ${sortedMeetings.map((m) => {
     const date5 = m.frontmatter.date ?? m.frontmatter.created;
     const relatedActions = meetingActionMap.get(m.frontmatter.id) ?? [];
-    const openCount = relatedActions.filter((a) => !DONE_STATUSES13.has(a.frontmatter.status)).length;
+    const openCount = relatedActions.filter((a) => !DONE_STATUSES14.has(a.frontmatter.status)).length;
     return `
             <tr>
               <td>${formatDate(date5)}</td>
@@ -25753,7 +26212,7 @@ function dmMeetingsPage(ctx) {
   const recentMeetingActions = [];
   for (const [mid, acts] of meetingActionMap) {
     for (const act of acts) {
-      if (!DONE_STATUSES13.has(act.frontmatter.status)) {
+      if (!DONE_STATUSES14.has(act.frontmatter.status)) {
         recentMeetingActions.push({ action: act, meetingId: mid });
       }
     }
@@ -25948,7 +26407,7 @@ registerPersonaPage("dm", "meetings", dmMeetingsPage);
 registerPersonaPage("dm", "governance", dmGovernancePage);
 
 // src/web/templates/pages/tl/dashboard.ts
-var DONE_STATUSES14 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES15 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 var RESOLVED_DECISION_STATUSES2 = /* @__PURE__ */ new Set(["decided", "superseded", "dismissed"]);
 function tlDashboardPage(ctx) {
   const epics = ctx.store.list({ type: "epic" });
@@ -25956,8 +26415,8 @@ function tlDashboardPage(ctx) {
   const decisions = ctx.store.list({ type: "decision" });
   const questions = ctx.store.list({ type: "question" });
   const diagrams = getDiagramData(ctx.store);
-  const openEpics = epics.filter((d) => !DONE_STATUSES14.has(d.frontmatter.status));
-  const openTasks = tasks.filter((d) => !DONE_STATUSES14.has(d.frontmatter.status));
+  const openEpics = epics.filter((d) => !DONE_STATUSES15.has(d.frontmatter.status));
+  const openTasks = tasks.filter((d) => !DONE_STATUSES15.has(d.frontmatter.status));
   const technicalDecisions = decisions.filter((d) => {
     const tags = d.frontmatter.tags ?? [];
     return tags.some((t) => {
@@ -26015,7 +26474,7 @@ function tlDashboardPage(ctx) {
 }
 
 // src/web/templates/pages/tl/backlog.ts
-var DONE_STATUSES15 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES16 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 function tlBacklogPage(ctx) {
   const epics = ctx.store.list({ type: "epic" });
   const tasks = ctx.store.list({ type: "task" });
@@ -26052,7 +26511,7 @@ function tlBacklogPage(ctx) {
           <tbody>
             ${sortedEpics.map((e) => {
     const eTasks = epicToTasks.get(e.frontmatter.id) ?? [];
-    const done = eTasks.filter((t) => DONE_STATUSES15.has(t.frontmatter.status)).length;
+    const done = eTasks.filter((t) => DONE_STATUSES16.has(t.frontmatter.status)).length;
     const featureIds = epicFeatureMap.get(e.frontmatter.id) ?? [];
     const featureLinks = featureIds.map((fid) => `<a href="/docs/feature/${escapeHtml(fid)}">${escapeHtml(fid)}</a>`).join(", ");
     return `
@@ -26072,7 +26531,7 @@ function tlBacklogPage(ctx) {
     for (const t of taskList) assignedTaskIds.add(t.frontmatter.id);
   }
   const unassignedTasks = tasks.filter(
-    (t) => !assignedTaskIds.has(t.frontmatter.id) && !DONE_STATUSES15.has(t.frontmatter.status)
+    (t) => !assignedTaskIds.has(t.frontmatter.id) && !DONE_STATUSES16.has(t.frontmatter.status)
   );
   const unassignedSection = unassignedTasks.length > 0 ? collapsibleSection(
     "tl-backlog-unassigned",
@@ -26133,7 +26592,7 @@ var TL_CONTRIBUTION_TYPES = /* @__PURE__ */ new Set([
   "technical-assessment",
   "architecture-review"
 ]);
-function progressBar4(pct) {
+function progressBar5(pct) {
   return `<div class="sprint-progress-bar">
     <div class="sprint-progress-fill" style="width: ${pct}%"></div>
     <span class="sprint-progress-label">${pct}%</span>
@@ -26237,7 +26696,7 @@ function tlSprintPage(ctx) {
       <div class="subtitle">Technical sprint items and contributions</div>
     </div>
     ${sprintHeader}
-    ${progressBar4(data.workItems.completionPct)}
+    ${progressBar5(data.workItems.completionPct)}
     ${statsCards}
     ${workItemsSection}
     ${epicsSection}
@@ -26572,7 +27031,7 @@ function upcomingPage(data) {
 }
 
 // src/web/templates/pages/sprint-summary.ts
-function progressBar5(pct) {
+function progressBar6(pct) {
   return `<div class="sprint-progress-bar">
     <div class="sprint-progress-fill" style="width: ${pct}%"></div>
     <span class="sprint-progress-label">${pct}%</span>
@@ -26694,7 +27153,7 @@ function sprintSummaryPage(data, cached2) {
       <div class="subtitle">Sprint Summary ${dateRange}</div>
     </div>
     ${goalHtml}
-    ${progressBar5(data.timeline.percentComplete)}
+    ${progressBar6(data.timeline.percentComplete)}
     ${statsCards}
     ${epicsTable}
     ${workItemsSection}
@@ -28045,7 +28504,7 @@ async function runSkillAction(action, userPrompt, context) {
   try {
     const mcpServer = createMarvinMcpServer(context.store);
     const allowedTools = action.allowGovernanceTools !== false ? GOVERNANCE_TOOL_NAMES : [];
-    const conversation = query3({
+    const conversation = query4({
       prompt: userPrompt,
       options: {
         systemPrompt: action.systemPrompt,