sequant 1.20.3 → 2.0.1

package/dist/src/commands/stats.js

@@ -89,10 +89,13 @@ function calculateStats(logs) {
                 existing.total += phase.durationSeconds;
                 existing.count++;
                 phaseDurations.set(phase.phase, existing);
-                // Track failure patterns
-                if (phase.status === "failure" && phase.error) {
-                    // Normalize error message (truncate and clean)
-                    const errorKey = `${phase.phase}: ${phase.error.slice(0, 100)}`;
+                // Track failure patterns — prefer errorContext category (#447 AC-4)
+                if (phase.status === "failure") {
+                    const errorKey = phase.errorContext?.category
+                        ? `${phase.phase}: [${phase.errorContext.category}]`
+                        : phase.error
+                            ? `${phase.phase}: ${phase.error.slice(0, 100)}`
+                            : `${phase.phase}: unknown`;
                     commonFailures.set(errorKey, (commonFailures.get(errorKey) ?? 0) + 1);
                 }
             }
@@ -424,6 +427,145 @@ function displayMetricsAnalytics(analytics) {
     console.log(colors.muted("\n  Data stored locally in .sequant/metrics.json"));
     console.log("");
 }
+/**
+ * Calculate detailed analytics from run logs
+ */
+function calculateDetailedAnalytics(logs) {
+    const allIssues = logs.flatMap((l) => l.issues);
+    // QA verdict distribution
+    const qaVerdictDistribution = {};
+    let totalQaPhases = 0;
+    for (const issue of allIssues) {
+        for (const phase of issue.phases) {
+            if (phase.phase === "qa") {
+                totalQaPhases++;
+                const verdict = phase.verdict ?? "no_verdict";
+                qaVerdictDistribution[verdict] =
+                    (qaVerdictDistribution[verdict] ?? 0) + 1;
+            }
+        }
+    }
+    // First-pass QA rate: group by issue, check if first QA attempt was READY_FOR_MERGE
+    const qaByIssue = new Map();
+    for (const issue of allIssues) {
+        const issueQa = issue.phases
+            .filter((p) => p.phase === "qa")
+            .map((p) => ({ verdict: p.verdict, startTime: p.startTime }));
+        if (issueQa.length > 0) {
+            const existing = qaByIssue.get(issue.issueNumber) ?? [];
+            existing.push(...issueQa);
+            qaByIssue.set(issue.issueNumber, existing);
+        }
+    }
+    let firstPassSuccess = 0;
+    let totalIssuesWithQa = 0;
+    for (const [, phases] of qaByIssue) {
+        totalIssuesWithQa++;
+        const sorted = phases.sort((a, b) => a.startTime.localeCompare(b.startTime));
+        if (sorted[0]?.verdict === "READY_FOR_MERGE") {
+            firstPassSuccess++;
+        }
+    }
+    // Weekly trends
+    const weekBuckets = new Map();
+    for (const log of logs) {
+        const d = new Date(log.startTime);
+        const day = d.getUTCDay();
+        const diff = d.getUTCDate() - day + (day === 0 ? -6 : 1);
+        const monday = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), diff));
+        const week = monday.toISOString().slice(0, 10);
+        const existing = weekBuckets.get(week) ?? {
+            runs: 0,
+            issues: 0,
+            successes: 0,
+        };
+        existing.runs++;
+        existing.issues += log.issues.length;
+        existing.successes += log.issues.filter((i) => i.status === "success").length;
+        weekBuckets.set(week, existing);
+    }
+    const weeklyTrends = [...weekBuckets.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([week, data]) => ({
+        week,
+        runs: data.runs,
+        issues: data.issues,
+        successRate: data.issues > 0 ? (data.successes / data.issues) * 100 : 0,
+    }));
+    // Label segmentation
+    const labelAcc = new Map();
+    for (const issue of allIssues) {
+        for (const label of issue.labels) {
+            const existing = labelAcc.get(label) ?? { issues: 0, successes: 0 };
+            existing.issues++;
+            if (issue.status === "success")
+                existing.successes++;
+            labelAcc.set(label, existing);
+        }
+    }
+    const labelSegments = [...labelAcc.entries()]
+        .map(([label, data]) => ({
+        label,
+        issues: data.issues,
+        successRate: data.issues > 0 ? (data.successes / data.issues) * 100 : 0,
+    }))
+        .sort((a, b) => b.issues - a.issues)
+        .slice(0, 10);
+    return {
+        qaVerdictDistribution,
+        firstPassQaRate: totalIssuesWithQa > 0 ? (firstPassSuccess / totalIssuesWithQa) * 100 : 0,
+        totalQaPhases,
+        weeklyTrends,
+        labelSegments,
+    };
+}
+/**
+ * Display detailed analytics
+ */
+function displayDetailedAnalytics(detailed) {
+    // QA Verdicts
+    console.log(ui.sectionHeader("QA Verdicts"));
+    console.log(`  First-pass QA rate: ${colors.accent(detailed.firstPassQaRate.toFixed(1) + "%")}`);
+    console.log(`  Total QA phases:    ${detailed.totalQaPhases}\n`);
+    for (const [verdict, count] of Object.entries(detailed.qaVerdictDistribution).sort((a, b) => b[1] - a[1])) {
+        const pct = detailed.totalQaPhases > 0
+            ? ((count / detailed.totalQaPhases) * 100).toFixed(1)
+            : "0";
+        const bar = ui.progressBar(count, detailed.totalQaPhases, 10);
+        console.log(`  ${verdict.padEnd(26)} ${String(count).padStart(3)}  (${pct}%)  ${bar}`);
+    }
+    // Weekly Trends
+    if (detailed.weeklyTrends.length > 0) {
+        console.log(ui.sectionHeader("Weekly Trends"));
+        const rows = detailed.weeklyTrends.map((w) => [
+            w.week,
+            String(w.runs),
+            String(w.issues),
+            `${w.successRate.toFixed(0)}%`,
+        ]);
+        console.log(ui.table(rows, {
+            columns: [
+                { header: "Week", width: 12 },
+                { header: "Runs", width: 6 },
+                { header: "Issues", width: 8 },
+                { header: "Success", width: 9 },
+            ],
+        }));
+    }
+    // Label Segmentation
+    if (detailed.labelSegments.length > 0) {
+        console.log(ui.sectionHeader("Success by Label"));
+        for (const seg of detailed.labelSegments) {
+            const bar = ui.progressBar(Math.round(seg.successRate), 100, 10);
+            const rateStr = seg.successRate >= 80
+                ? colors.success(`${seg.successRate.toFixed(0)}%`)
+                : seg.successRate >= 60
+                    ? colors.warning(`${seg.successRate.toFixed(0)}%`)
+                    : colors.error(`${seg.successRate.toFixed(0)}%`);
+            console.log(`  ${seg.label.padEnd(20)} ${String(seg.issues).padStart(3)} issues  ${rateStr}  ${bar}`);
+        }
+    }
+}
 /**
  * Main stats command
  */
@@ -517,29 +659,46 @@ export async function statsCommand(options) {
     if (metrics && metrics.runs.length > 0) {
         const analytics = calculateMetricsAnalytics(metrics);
         displayMetricsAnalytics(analytics);
-        return;
     }
-    // Fall back to run logs display
-    const logDir = resolveLogPath(options.path);
-    const logFiles = listLogFiles(logDir);
-    if (logFiles.length === 0) {
-        console.log(ui.headerBox("SEQUANT ANALYTICS"));
-        console.log(colors.muted("\n  Local data only - no telemetry\n"));
-        console.log(colors.warning("  No data found."));
-        console.log(colors.muted("  Run `npx sequant run <issues>` to collect metrics."));
-        console.log("");
-        return;
+    else {
+        // Fall back to run logs display
+        const logDir = resolveLogPath(options.path);
+        const logFiles = listLogFiles(logDir);
+        if (logFiles.length === 0) {
+            console.log(ui.headerBox("SEQUANT ANALYTICS"));
+            console.log(colors.muted("\n  Local data only - no telemetry\n"));
+            console.log(colors.warning("  No data found."));
+            console.log(colors.muted("  Run `npx sequant run <issues>` to collect metrics."));
+            console.log("");
+            return;
+        }
+        const logs = logFiles
+            .map((filename) => {
+            const filePath = path.join(logDir, filename);
+            return parseLogFile(filePath);
+        })
+            .filter((log) => log !== null);
+        if (logs.length === 0) {
+            console.log(colors.warning("\n  No valid log files found.\n"));
+            return;
+        }
+        const stats = calculateStats(logs);
+        displayStats(stats, logDir);
     }
-    const logs = logFiles
-        .map((filename) => {
-        const filePath = path.join(logDir, filename);
-        return parseLogFile(filePath);
-    })
-        .filter((log) => log !== null);
-    if (logs.length === 0) {
-        console.log(colors.warning("\n  No valid log files found.\n"));
-        return;
+    // Detailed analytics from run logs (--detailed flag)
+    if (options.detailed) {
+        const logDir = resolveLogPath(options.path);
+        const logFiles = listLogFiles(logDir);
+        const logs = logFiles
+            .map((filename) => {
+            const filePath = path.join(logDir, filename);
+            return parseLogFile(filePath);
+        })
+            .filter((log) => log !== null);
+        if (logs.length > 0) {
+            const detailed = calculateDetailedAnalytics(logs);
+            displayDetailedAnalytics(detailed);
+            console.log("");
+        }
     }
-    const stats = calculateStats(logs);
-    displayStats(stats, logDir);
 }

package/dist/src/commands/status.d.ts

@@ -18,5 +18,7 @@ export interface StatusCommandOptions {
     maxAge?: number;
     /** Remove all orphaned entries (both merged and abandoned) in one step */
     all?: boolean;
+    /** Skip GitHub API queries (offline mode) */
+    offline?: boolean;
 }
 export declare function statusCommand(options?: StatusCommandOptions): Promise<void>;

package/dist/src/commands/status.js

@@ -7,27 +7,54 @@ import { getManifest, getPackageVersion } from "../lib/manifest.js";
 import { fileExists } from "../lib/fs.js";
 import { readdir } from "fs/promises";
 import { StateManager } from "../lib/workflow/state-manager.js";
-import { rebuildStateFromLogs, cleanupStaleEntries, checkPRMergeStatus, } from "../lib/workflow/state-utils.js";
+import { rebuildStateFromLogs, cleanupStaleEntries, } from "../lib/workflow/state-utils.js";
+import { reconcileState, getNextActionHint, formatRelativeTime, } from "../lib/workflow/reconcile.js";
 /**
- * Auto-detect merged PRs and update state for issues stuck at ready_for_merge.
- * Queries GitHub for each ready_for_merge issue that has a PR number.
+ * Run reconciliation and display warnings.
+ * Returns the reconcile result for use in display.
  */
-async function refreshMergedStatuses(stateManager, issues) {
-    const readyIssues = issues.filter((i) => i.status === "ready_for_merge" && i.pr?.number);
-    if (readyIssues.length === 0)
-        return;
-    for (const issue of readyIssues) {
-        const prStatus = checkPRMergeStatus(issue.pr.number);
-        if (prStatus === "MERGED") {
-            issue.status = "merged";
-            await stateManager.updateIssueStatus(issue.number, "merged");
+async function runReconciliation(stateManager, options) {
+    const result = await reconcileState({
+        offline: options.offline,
+        stateManager,
+    });
+    if (!options.json) {
+        // Show reconciliation warnings
+        if (result.warnings.length > 0) {
+            console.log(chalk.yellow("\n  ⚠️  Drift detected:"));
+            for (const w of result.warnings) {
+                console.log(chalk.yellow(`    #${w.issueNumber}: ${w.description}`));
+            }
+        }
+        // Show healed drift
+        if (result.healed.length > 0) {
+            for (const h of result.healed) {
+                console.log(chalk.gray(`  ✓ Auto-healed: ${h.description}`));
+            }
+        }
+        if (!result.githubReachable && !options.offline) {
+            console.log(chalk.yellow("\n  ⚠️  GitHub unreachable — showing cached data. Use --offline to suppress this warning."));
         }
     }
+    return result;
+}
+/**
+ * Format age in days from an ISO timestamp
+ */
+function formatAgeDays(isoTimestamp) {
+    if (!isoTimestamp)
+        return "";
+    const age = Date.now() - new Date(isoTimestamp).getTime();
+    const days = Math.floor(age / 86_400_000);
+    if (days < 1)
+        return "today";
+    return `${days}d ago`;
 }
 /**
- * Color-code issue status
+ * Color-code issue status, with age indicator for resolved issues
  */
-function colorStatus(status) {
+function colorStatus(status, resolvedAt) {
+    const age = resolvedAt ? ` (${formatAgeDays(resolvedAt)})` : "";
     switch (status) {
         case "not_started":
             return chalk.gray(status);
@@ -38,11 +65,11 @@ function colorStatus(status) {
         case "ready_for_merge":
             return chalk.green(status);
         case "merged":
-            return chalk.green(status);
+            return chalk.green(status + age);
         case "blocked":
             return chalk.yellow(status);
         case "abandoned":
-            return chalk.red(status);
+            return chalk.red(status + age);
         default:
             return status;
     }
@@ -76,7 +103,7 @@ function formatIssueState(issue) {
     // Issue header
     lines.push(chalk.bold(`  #${issue.number}: ${issue.title.substring(0, 50)}${issue.title.length > 50 ? "..." : ""}`));
     // Status and current phase
-    const status = colorStatus(issue.status);
+    const status = colorStatus(issue.status, issue.resolvedAt);
     const currentPhase = issue.currentPhase
         ? chalk.cyan(issue.currentPhase)
         : chalk.gray("none");
@@ -105,31 +132,10 @@ function formatIssueState(issue) {
         lines.push(chalk.gray(`    Worktree: ${issue.worktree}`));
     }
     // Last activity
-    const lastActivity = new Date(issue.lastActivity);
-    const relativeTime = getRelativeTime(lastActivity);
+    const relativeTime = formatRelativeTime(issue.lastActivity);
     lines.push(chalk.gray(`    Last activity: ${relativeTime}`));
     return lines.join("\n");
 }
-/**
- * Get relative time string
- */
-function getRelativeTime(date) {
-    const now = new Date();
-    const diffMs = now.getTime() - date.getTime();
-    const diffSec = Math.floor(diffMs / 1000);
-    const diffMin = Math.floor(diffSec / 60);
-    const diffHour = Math.floor(diffMin / 60);
-    const diffDay = Math.floor(diffHour / 24);
-    if (diffSec < 60)
-        return "just now";
-    if (diffMin < 60)
-        return `${diffMin} minute${diffMin > 1 ? "s" : ""} ago`;
-    if (diffHour < 24)
-        return `${diffHour} hour${diffHour > 1 ? "s" : ""} ago`;
-    if (diffDay < 7)
-        return `${diffDay} day${diffDay > 1 ? "s" : ""} ago`;
-    return date.toLocaleDateString();
-}
 /**
  * Display issue state summary table
  */
@@ -170,11 +176,16 @@ function displayIssueSummary(issues) {
             const title = issue.title.length > 30
                 ? issue.title.substring(0, 27) + "..."
                 : issue.title;
+            const hint = getNextActionHint(issue);
+            const hintDisplay = hint
+                ? chalk.gray(`→ ${hint.length > 30 ? hint.substring(0, 27) + "..." : hint}`)
+                : "";
             rows.push([
                 `#${issue.number}`,
                 title,
-                colorStatus(issue.status),
+                colorStatus(issue.status, issue.resolvedAt),
                 issue.currentPhase || "-",
+                hintDisplay,
             ]);
         }
     }
@@ -186,6 +197,7 @@ function displayIssueSummary(issues) {
                 { header: "Title", width: 32 },
                 { header: "Status", width: 20 },
                 { header: "Phase", width: 10 },
+                { header: "Next", width: 34 },
             ],
         }));
     // Summary counts
@@ -220,7 +232,7 @@ export async function statusCommand(options = {}) {
         return;
     }
     // If --issues or --issue flag, focus on issue state
-    if (options.issues || options.issue !== undefined) {
+    if (options.issues || options.issue !== undefined || options.all) {
         await displayIssueState(options);
         return;
     }
@@ -263,12 +275,21 @@ export async function statusCommand(options = {}) {
     const stateManager = new StateManager();
     if (stateManager.stateExists()) {
         try {
+            // Reconcile state with GitHub before displaying
+            const reconcileResult = await runReconciliation(stateManager, options);
+            // Re-read state after reconciliation (may have been updated)
+            stateManager.clearCache();
             const allIssues = await stateManager.getAllIssueStates();
             const issues = Object.values(allIssues);
             if (issues.length > 0) {
-                await refreshMergedStatuses(stateManager, issues);
                 displayIssueSummary(issues);
             }
+            // Last synced footer
+            if (reconcileResult.lastSynced) {
+                const syncedAgo = formatRelativeTime(reconcileResult.lastSynced);
+                const offlineNote = options.offline ? " (offline)" : "";
+                console.log(chalk.gray(`\n  Last synced: ${syncedAgo}${offlineNote}`));
+            }
         }
         catch {
             // Ignore state read errors
@@ -293,34 +314,62 @@ async function displayIssueState(options) {
         return;
     }
     try {
+        // Reconcile state with GitHub before displaying
+        const reconcileResult = await runReconciliation(stateManager, options);
+        stateManager.clearCache();
         if (options.issue !== undefined) {
             // Show single issue details
             const issueState = await stateManager.getIssueState(options.issue);
-            if (issueState) {
-                await refreshMergedStatuses(stateManager, [issueState]);
-            }
             if (options.json) {
-                console.log(JSON.stringify(issueState, null, 2));
+                const jsonData = issueState
+                    ? {
+                        ...issueState,
+                        nextAction: getNextActionHint(issueState),
+                        lastSynced: reconcileResult.lastSynced,
+                    }
+                    : null;
+                console.log(JSON.stringify(jsonData, null, 2));
             }
             else if (issueState) {
                 console.log(chalk.bold(`\n📊 Issue #${options.issue} State\n`));
                 console.log(formatIssueState(issueState));
+                const hint = getNextActionHint(issueState);
+                if (hint) {
+                    console.log(chalk.cyan(`\n    Next: ${hint}`));
+                }
             }
             else {
                 console.log(chalk.yellow(`\nIssue #${options.issue} not found in state.`));
             }
         }
         else {
-            // Show all issues
-            const allIssues = await stateManager.getAllIssueStates();
+            // Show all issues (--all bypasses TTL filtering)
+            const allIssues = options.all
+                ? await stateManager.getAllIssueStatesUnfiltered()
+                : await stateManager.getAllIssueStates();
             const issues = Object.values(allIssues);
-            await refreshMergedStatuses(stateManager, issues);
             if (options.json) {
-                console.log(JSON.stringify({ issues: allIssues }, null, 2));
+                // Enrich JSON output with next-action hints and lastSynced
+                const enriched = {};
+                for (const [key, issue] of Object.entries((await stateManager.getState()).issues)) {
+                    enriched[key] = {
+                        ...issue,
+                        nextAction: getNextActionHint(issue),
+                    };
+                }
+                console.log(JSON.stringify({
+                    issues: enriched,
+                    lastSynced: reconcileResult.lastSynced,
+                    githubReachable: reconcileResult.githubReachable,
+                }, null, 2));
             }
             else {
                 console.log(chalk.bold("\n📊 Workflow State\n"));
                 displayIssueSummary(issues);
+                // Last synced footer
+                const syncedAgo = formatRelativeTime(reconcileResult.lastSynced);
+                const offlineNote = options.offline ? " (offline)" : "";
+                console.log(chalk.gray(`\n  Last synced: ${syncedAgo}${offlineNote}`));
             }
         }
     }

package/dist/src/index.d.ts

@@ -28,5 +28,5 @@ export { analyzeTitleForPhases, analyzeBodyForPhases, analyzeContentForPhases, i
 export type { ContentSignal, ContentAnalysisResult, } from "./lib/content-analyzer.js";
 export { mergePhaseSignals, signalFromLabel, signalsFromLabels, formatMergedPhases, SIGNAL_PRIORITY, } from "./lib/phase-signal.js";
 export type { SignalSource, SignalConfidence, PhaseSignal, MergedPhaseResult, } from "./lib/phase-signal.js";
-export { isSolveComment, findSolveComment, parseSolveWorkflow, solveWorkflowToSignals, solveCoversIssue, } from "./lib/solve-comment-parser.js";
-export type { SolveWorkflowResult, IssueComment, } from "./lib/solve-comment-parser.js";
+export { isAssessComment, findAssessComment, parseAssessMarkers, parseAssessWorkflow, assessWorkflowToSignals, assessCoversIssue, isSolveComment, findSolveComment, parseSolveMarkers, parseSolveWorkflow, solveWorkflowToSignals, solveCoversIssue, } from "./lib/assess-comment-parser.js";
+export type { AssessWorkflowResult, AssessMarkers, AssessAction, SolveWorkflowResult, SolveMarkers, IssueComment, } from "./lib/assess-comment-parser.js";

package/dist/src/index.js

@@ -21,4 +21,7 @@ export { rebuildStateFromLogs, cleanupStaleEntries, } from "./lib/workflow/state
 // Content analysis exports
 export { analyzeTitleForPhases, analyzeBodyForPhases, analyzeContentForPhases, isTrivialWork, formatContentAnalysis, } from "./lib/content-analyzer.js";
 export { mergePhaseSignals, signalFromLabel, signalsFromLabels, formatMergedPhases, SIGNAL_PRIORITY, } from "./lib/phase-signal.js";
-export { isSolveComment, findSolveComment, parseSolveWorkflow, solveWorkflowToSignals, solveCoversIssue, } from "./lib/solve-comment-parser.js";
+// Assess comment parser exports (unified from solve + assess)
+export { isAssessComment, findAssessComment, parseAssessMarkers, parseAssessWorkflow, assessWorkflowToSignals, assessCoversIssue, 
+// Backward-compatible aliases (deprecated)
+isSolveComment, findSolveComment, parseSolveMarkers, parseSolveWorkflow, solveWorkflowToSignals, solveCoversIssue, } from "./lib/assess-comment-parser.js";

package/dist/src/lib/ac-parser.d.ts

@@ -4,6 +4,7 @@
  * Extracts acceptance criteria from GitHub issue markdown.
  * Supports checkbox format: `- [ ] **AC-1:** Description`
  * Also supports alternate formats: `- [ ] **B2:** Description`
+ * And bold-wrapped format: `- [ ] **AC-1: Description**`
  *
  * @example
  * ```typescript
@@ -37,6 +38,7 @@ export declare function inferVerificationMethod(description: string): ACVerifica
  * Supports multiple formats:
  * - `- [ ] **AC-1:** Description`
  * - `- [ ] **B2:** Description`
+ * - `- [ ] **AC-1: Description**` (bold wraps ID + description)
  * - `- [ ] AC-1: Description`
  *
  * @param issueBody - The full GitHub issue body markdown

package/dist/src/lib/ac-parser.js

@@ -4,6 +4,7 @@
  * Extracts acceptance criteria from GitHub issue markdown.
  * Supports checkbox format: `- [ ] **AC-1:** Description`
  * Also supports alternate formats: `- [ ] **B2:** Description`
+ * And bold-wrapped format: `- [ ] **AC-1: Description**`
  *
  * @example
  * ```typescript
@@ -31,13 +32,16 @@ import { createAcceptanceCriterion, createAcceptanceCriteria, } from "./workflow
  * - `- [x] **AC-1:** Description`
  * - `- [ ] **B2:** Description`
  * - `- [ ] **AC1:** Description`
+ * - `- [ ] **AC-1: Description**` (bold wraps ID + description)
  */
 const AC_PATTERNS = [
     // Pattern 1: `- [ ] **AC-1:** Description` or `- [x] **AC-1:** Description`
     /^-\s*\[[x\s]\]\s*\*\*([A-Za-z]+-?\d+):\*\*\s*(.+)$/gim,
     // Pattern 2: `- [ ] **B2:** Description` (letter + number without hyphen)
     /^-\s*\[[x\s]\]\s*\*\*([A-Za-z]\d+):\*\*\s*(.+)$/gim,
-    // Pattern 3: `- [ ] AC-1: Description` (no bold)
+    // Pattern 3: `- [ ] **AC-1: Description.** optional text` (bold wraps ID + description)
+    /^-\s*\[[x\s]\]\s*\*\*([A-Za-z]+-?\d+):\s*(.+?)\*\*\s*(.*)$/gim,
+    // Pattern 4: `- [ ] AC-1: Description` (no bold)
     /^-\s*\[[x\s]\]\s*([A-Za-z]+-?\d+):\s*(.+)$/gim,
 ];
 /**
@@ -97,9 +101,14 @@ function parseACLine(line) {
         pattern.lastIndex = 0;
         const match = pattern.exec(line);
         if (match) {
+            // Combine groups 2 and 3 for bold-wrapped format (Pattern 3)
+            // where group 3 captures optional text after closing **
+            const description = match[3]
+                ? `${match[2].trim()} ${match[3].trim()}`.trim()
+                : match[2].trim();
             return {
                 id: match[1].toUpperCase(),
-                description: match[2].trim(),
+                description,
             };
         }
     }
@@ -112,6 +121,7 @@ function parseACLine(line) {
  * Supports multiple formats:
  * - `- [ ] **AC-1:** Description`
  * - `- [ ] **B2:** Description`
+ * - `- [ ] **AC-1: Description**` (bold wraps ID + description)
  * - `- [ ] AC-1: Description`
  *
  * @param issueBody - The full GitHub issue body markdown