mrvn-cli 0.5.13 → 0.5.14

package/dist/index.js

@@ -223,9 +223,9 @@ var DocumentStore = class {
       }
     }
   }
-  list(query9) {
+  list(query10) {
     const results = [];
-    const types = query9?.type ? [query9.type] : Object.keys(this.typeDirs);
+    const types = query10?.type ? [query10.type] : Object.keys(this.typeDirs);
     for (const type of types) {
       const dirName = this.typeDirs[type];
       if (!dirName) continue;
@@ -236,9 +236,9 @@ var DocumentStore = class {
         const filePath = path3.join(dir, file2);
         const raw = fs3.readFileSync(filePath, "utf-8");
         const doc = parseDocument(raw, filePath);
-        if (query9?.status && doc.frontmatter.status !== query9.status) continue;
-        if (query9?.owner && doc.frontmatter.owner !== query9.owner) continue;
-        if (query9?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query9.tag)))
+        if (query10?.status && doc.frontmatter.status !== query10.status) continue;
+        if (query10?.owner && doc.frontmatter.owner !== query10.owner) continue;
+        if (query10?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query10.tag)))
           continue;
         results.push(doc);
       }
@@ -19443,7 +19443,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;
@@ -19452,7 +19452,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);
       }
     }
@@ -25110,6 +25110,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(
@@ -25492,10 +25497,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)
@@ -25719,6 +25724,420 @@ function generateProposedActions(issues) {
   return actions;
 }
 
+// src/skills/builtin/jira/sprint-progress.ts
+import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
+var DONE_STATUSES16 = /* @__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_STATUSES16.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 = query3({
+    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 = progressBar6(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_STATUSES16.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 progressBar6(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() {
@@ -26484,6 +26903,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 } }
     )
   ];
 }
@@ -26585,6 +27034,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).
@@ -26596,6 +27046,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
@@ -26619,6 +27074,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
@@ -26631,6 +27087,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
@@ -26644,6 +27101,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"\`)
@@ -28148,7 +28607,7 @@ import * as readline from "readline";
 import chalk from "chalk";
 import ora from "ora";
 import {
-  query as query4
+  query as query5
 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/storage/session-store.ts
@@ -28219,11 +28678,11 @@ var SessionStore = class {
 };
 
 // src/agent/session-namer.ts
-import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
 async function generateSessionName(turns) {
   try {
     const transcript = turns.slice(-20).map((t) => `${t.role}: ${t.content.slice(0, 200)}`).join("\n");
-    const result = query3({
+    const result = query4({
       prompt: `Summarize this conversation in 3-5 words as a kebab-case name suitable for a filename. Output ONLY the name, nothing else.
 
 ${transcript}`,
@@ -28501,7 +28960,7 @@ Marvin \u2014 ${persona.name}
   if (existingSession) {
     queryOptions.resume = existingSession.id;
   }
-  const conversation = query4({
+  const conversation = query5({
     prompt,
     options: queryOptions
   });
@@ -28593,7 +29052,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { tool as tool24 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
-import { query as query5 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query6 } from "@anthropic-ai/claude-agent-sdk";
 var GOVERNANCE_TOOL_NAMES2 = [
   "mcp__marvin-governance__list_decisions",
   "mcp__marvin-governance__get_decision",
@@ -28615,7 +29074,7 @@ async function runSkillAction(action, userPrompt, context) {
   try {
     const mcpServer = createMarvinMcpServer(context.store);
     const allowedTools = action.allowGovernanceTools !== false ? GOVERNANCE_TOOL_NAMES2 : [];
-    const conversation = query5({
+    const conversation = query6({
       prompt: userPrompt,
       options: {
         systemPrompt: action.systemPrompt,
@@ -29409,7 +29868,7 @@ import * as fs13 from "fs";
 import * as path13 from "path";
 import chalk7 from "chalk";
 import ora2 from "ora";
-import { query as query6 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query7 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/sources/prompts.ts
 function buildIngestSystemPrompt(persona, projectConfig, isDraft) {
@@ -29542,7 +30001,7 @@ async function ingestFile(options) {
   const spinner = ora2({ text: `Analyzing ${fileName}...`, color: "cyan" });
   spinner.start();
   try {
-    const conversation = query6({
+    const conversation = query7({
       prompt: userPrompt,
       options: {
         systemPrompt,
@@ -30763,7 +31222,7 @@ import chalk13 from "chalk";
 // src/analysis/analyze.ts
 import chalk12 from "chalk";
 import ora4 from "ora";
-import { query as query7 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query8 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/analysis/prompts.ts
 function buildAnalyzeSystemPrompt(persona, projectConfig, isDraft) {
@@ -30893,7 +31352,7 @@ async function analyzeMeeting(options) {
   const spinner = ora4({ text: `Analyzing meeting ${meetingId}...`, color: "cyan" });
   spinner.start();
   try {
-    const conversation = query7({
+    const conversation = query8({
       prompt: userPrompt,
       options: {
         systemPrompt,
@@ -31020,7 +31479,7 @@ import chalk15 from "chalk";
 // src/contributions/contribute.ts
 import chalk14 from "chalk";
 import ora5 from "ora";
-import { query as query8 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query9 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/contributions/prompts.ts
 function buildContributeSystemPrompt(persona, contributionType, projectConfig, isDraft) {
@@ -31274,7 +31733,7 @@ async function contributeFromPersona(options) {
       "mcp__marvin-governance__get_action",
       "mcp__marvin-governance__get_question"
     ];
-    const conversation = query8({
+    const conversation = query9({
       prompt: userPrompt,
       options: {
         systemPrompt,
@@ -32113,7 +32572,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.5.13");
+  ).version("0.5.14");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });