@ginkoai/cli 2.0.6 → 2.1.0

package/dist/lib/sprint-loader.d.ts

@@ -1,21 +1,49 @@
 /**
  * @fileType: utility
  * @status: current
- * @updated: 2025-11-21
- * @tags: [sprint, task-checklist, epic-001, session-context]
- * @related: [charter-loader.ts, start-reflection.ts, context-loader-events.ts]
+ * @updated: 2026-01-19
+ * @tags: [sprint, task-content, epic-015, session-context]
+ * @related: [charter-loader.ts, start-reflection.ts, context-loader-events.ts, task-extractor.ts]
  * @priority: high
  * @complexity: medium
  * @dependencies: [fs-extra, path]
  */
 /**
- * Task state enumeration
+ * Task state enumeration (kept for backward compatibility)
+ * NOTE: As of EPIC-015 Sprint 2, status comes from the graph API.
+ * File parsing defaults all tasks to 'todo'. Merge with graph status at runtime.
  * - todo: [ ] Not started
  * - in_progress: [@] Currently being worked on
  * - paused: [Z] Temporarily on hold (sleeping)
  * - complete: [x] Finished
  */
 export type TaskState = 'todo' | 'in_progress' | 'paused' | 'complete';
+/**
+ * Task content extracted from sprint markdown (no status)
+ * Status comes from graph API and is merged at runtime.
+ */
+export interface TaskContent {
+    id: string;
+    title: string;
+    files?: string[];
+    effort?: string;
+    priority?: string;
+    relatedADRs?: string[];
+    relatedPatterns?: string[];
+    relatedGotchas?: string[];
+    acceptanceCriteria?: AcceptanceCriterion[];
+    dependsOn?: string[];
+}
+/**
+ * Sprint content extracted from markdown (no status-based progress)
+ * Status/progress comes from graph API and is merged at runtime.
+ */
+export interface SprintContent {
+    name: string;
+    file: string;
+    tasks: TaskContent[];
+    dependencyWarnings?: string[];
+}
 /**
  * Acceptance criterion type - auto-detected from description (EPIC-004 Sprint 3)
  * - test: Unit tests, specs, test suites
@@ -37,7 +65,9 @@ export interface AcceptanceCriterion {
     command?: string;
 }
 /**
- * Individual task from sprint checklist
+ * Individual task from sprint checklist (backward compatible interface)
+ * NOTE: As of EPIC-015 Sprint 2, state defaults to 'todo' from file parsing.
+ * Actual status should be merged from graph API at runtime.
  */
 export interface Task {
     id: string;
@@ -54,7 +84,9 @@ export interface Task {
     dependsOn?: string[];
 }
 /**
- * Sprint checklist with task states and progress
+ * Sprint checklist with task states and progress (backward compatible interface)
+ * NOTE: As of EPIC-015 Sprint 2, progress values will be zeroed from file parsing.
+ * Actual progress should be calculated from graph API status at runtime.
  */
 export interface SprintChecklist {
     name: string;
@@ -75,11 +107,12 @@ export interface SprintChecklist {
  * Find active sprint file
  *
  * Priority:
- * 1. Check CURRENT-SPRINT.md for "Between Sprints" status → return null
- * 2. Check CURRENT-SPRINT.md for sprint reference → return that file
- * 3. Fall back to scanning SPRINT-*.md files for first incomplete one
+ * 1. Scan SPRINT-*.md files for first incomplete one
  *    - Respects frontmatter `status` field: active > not_started > (skip paused/complete)
  *
+ * EPIC-015 Sprint 3: CURRENT-SPRINT.md is deprecated. Sprint state now comes from
+ * the graph API, not from a local file. This function only scans actual sprint files.
+ *
  * Valid status values:
  * - active: Currently being worked on
  * - not_started: Planned but not yet started
@@ -93,25 +126,57 @@ export interface SprintChecklist {
  */
 export declare function findActiveSprint(projectRoot?: string): Promise<string | null>;
 /**
- * Parse sprint markdown into task checklist
+ * Parse sprint markdown into task checklist (backward compatible)
+ *
+ * EPIC-015 Sprint 2: Status parsing removed. All tasks default to 'todo'.
+ * Status should be merged from graph API at runtime.
  *
  * Looks for:
  * - Sprint name from title (# SPRINT: ...)
  * - Tasks from ## Sprint Tasks or ### TASK-N sections
- * - Checkbox states: [ ], [@], [Z], [x]
- * - Task metadata (files, priority, effort)
+ * - Task metadata (files, priority, effort, dependencies)
+ * - Related knowledge (ADRs, patterns, gotchas)
+ * - Acceptance criteria
  *
  * @param markdown - Sprint markdown content
  * @param filePath - Path to sprint file
- * @returns Parsed sprint checklist
+ * @returns Parsed sprint checklist (all tasks with state: 'todo')
  */
 export declare function parseSprintChecklist(markdown: string, filePath: string): SprintChecklist;
 /**
- * Load active sprint checklist
+ * Parse sprint markdown into content-only structure (no status)
+ *
+ * EPIC-015 Sprint 2: New content-focused parsing function.
+ * Extracts task content (ID, title, metadata, relationships) without status.
+ * Status should be fetched from graph API and merged separately.
+ *
+ * @param markdown - Sprint markdown content
+ * @param filePath - Path to sprint file
+ * @returns Parsed sprint content (no status information)
+ */
+export declare function parseSprintContent(markdown: string, filePath: string): SprintContent;
+/**
+ * Load active sprint content (no status)
+ *
+ * EPIC-015 Sprint 2: New content-focused loading function.
+ * Finds active sprint file and parses content without status.
+ * Status should be fetched from graph API and merged separately.
+ *
+ * @param projectRoot - Project root directory (defaults to git root)
+ * @param sprintFilePath - Optional specific sprint file path
+ * @returns Parsed sprint content or null if no sprint found
+ */
+export declare function loadSprintContent(projectRoot?: string, sprintFilePath?: string): Promise<SprintContent | null>;
+/**
+ * Load active sprint checklist (backward compatible)
+ *
+ * EPIC-015 Sprint 2: This function maintained for backward compatibility.
+ * All tasks will have state: 'todo'. Merge with graph API status at runtime.
  *
  * Finds active sprint file and parses into structured checklist
  *
  * @param projectRoot - Project root directory (defaults to git root)
+ * @param sprintFilePath - Optional specific sprint file path
  * @returns Parsed sprint checklist or null if no sprint found
  */
 export declare function loadSprintChecklist(projectRoot?: string, sprintFilePath?: string): Promise<SprintChecklist | null>;
@@ -146,6 +211,13 @@ export interface SprintProgressionInfo {
     totalSprints: number;
     completedSprints: number;
 }
+/**
+ * Find sprint file by ID
+ * @param sprintId - Sprint ID (e.g., 'e011_s01' or 'e016_s03')
+ * @param projectRoot - Project root directory
+ * @returns Path to sprint file or null if not found
+ */
+export declare function findSprintFileById(sprintId: string, projectRoot: string): Promise<string | null>;
 /**
  * Detect sprint progression and epic completion status
  *

package/dist/lib/sprint-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprint-loader.d.ts","sourceRoot":"","sources":["../../src/lib/sprint-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sprint-loader.d.ts","sourceRoot":"","sources":["../../src/lib/sprint-loader.ts"],"names":[],"mappings":"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"}

package/dist/lib/sprint-loader.js

@@ -1,24 +1,30 @@
 /**
  * @fileType: utility
  * @status: current
- * @updated: 2025-11-21
- * @tags: [sprint, task-checklist, epic-001, session-context]
- * @related: [charter-loader.ts, start-reflection.ts, context-loader-events.ts]
+ * @updated: 2026-01-19
+ * @tags: [sprint, task-content, epic-015, session-context]
+ * @related: [charter-loader.ts, start-reflection.ts, context-loader-events.ts, task-extractor.ts]
  * @priority: high
  * @complexity: medium
  * @dependencies: [fs-extra, path]
  */
 /**
- * Sprint Loader (EPIC-001 TASK-5)
+ * Sprint Loader (EPIC-001 TASK-5, EPIC-015 Sprint 2)
  *
  * Loads active sprint from filesystem (docs/sprints/SPRINT-*.md)
- * and parses into task checklist with [@] symbol support.
+ * and parses task content (ID, title, metadata).
+ *
+ * EPIC-015 Sprint 2 Changes:
+ * - Status now comes from graph API, not file parsing
+ * - Removed checkbox status parsing ([x], [ ], [@], [Z])
+ * - Added content-only interfaces (TaskContent, SprintContent)
+ * - Backward compatibility: existing functions default state to 'todo'
  *
  * Provides AI partners with:
- * - Clear task progress ([ ] / [@] / [x] states)
- * - Current task identification (first [@] or [ ])
- * - Progress visibility (N/M complete, X in progress)
- * - Eliminates task priority ambiguity
+ * - Task identification (ID, title)
+ * - Task metadata (effort, priority, files, dependencies)
+ * - Related knowledge (ADRs, patterns, gotchas)
+ * - Acceptance criteria
  */
 import fs from 'fs-extra';
 import path from 'path';
@@ -61,15 +67,28 @@ function parseFrontmatter(content) {
     }
     return frontmatter;
 }
+/**
+ * Warn about deprecated CURRENT-SPRINT.md file
+ * EPIC-015 Sprint 3: CURRENT-SPRINT.md is deprecated in favor of graph-authoritative state
+ */
+function warnDeprecatedCurrentSprint(sprintsDir) {
+    const currentSprintPath = path.join(sprintsDir, 'CURRENT-SPRINT.md');
+    if (fs.existsSync(currentSprintPath)) {
+        console.warn('\n⚠️  DEPRECATED: CURRENT-SPRINT.md detected');
+        console.warn('   This file is no longer used. Sprint state now comes from the graph.');
+        console.warn('   You can safely delete: docs/sprints/CURRENT-SPRINT.md\n');
+    }
+}
 /**
  * Find active sprint file
  *
  * Priority:
- * 1. Check CURRENT-SPRINT.md for "Between Sprints" status → return null
- * 2. Check CURRENT-SPRINT.md for sprint reference → return that file
- * 3. Fall back to scanning SPRINT-*.md files for first incomplete one
+ * 1. Scan SPRINT-*.md files for first incomplete one
  *    - Respects frontmatter `status` field: active > not_started > (skip paused/complete)
  *
+ * EPIC-015 Sprint 3: CURRENT-SPRINT.md is deprecated. Sprint state now comes from
+ * the graph API, not from a local file. This function only scans actual sprint files.
+ *
  * Valid status values:
  * - active: Currently being worked on
  * - not_started: Planned but not yet started
@@ -88,52 +107,10 @@ export async function findActiveSprint(projectRoot) {
         if (!fs.existsSync(sprintsDir)) {
             return null;
         }
-        // Check CURRENT-SPRINT.md first (source of truth)
-        const currentSprintPath = path.join(sprintsDir, 'CURRENT-SPRINT.md');
-        if (fs.existsSync(currentSprintPath)) {
-            const currentContent = await fs.readFile(currentSprintPath, 'utf-8');
-            // Check for "Between Sprints" or "No active sprint" status
-            if (currentContent.includes('Between Sprints') ||
-                currentContent.includes('No active sprint') ||
-                currentContent.match(/\*\*Status\*\*:\s*Between Sprints/i)) {
-                return null; // Explicitly between sprints
-            }
-            // Look for sprint reference: See: SPRINT-YYYY-MM-DD-name.md
-            const sprintRefMatch = currentContent.match(/See:\s*(SPRINT-[\w-]+\.md)/i);
-            if (sprintRefMatch) {
-                const referencedPath = path.join(sprintsDir, sprintRefMatch[1]);
-                if (fs.existsSync(referencedPath)) {
-                    // Validate referenced sprint isn't complete before returning
-                    const referencedContent = await fs.readFile(referencedPath, 'utf-8');
-                    const refFrontmatter = parseFrontmatter(referencedContent);
-                    const refStatus = refFrontmatter.status?.toLowerCase();
-                    // If referenced sprint is complete, don't return it - fall through to scanning
-                    if (refStatus !== 'complete') {
-                        // Also check progress percentage
-                        const refProgressMatch = referencedContent.match(/\*\*Progress:?\*\*:?\s*(\d+)%/);
-                        const refProgress = refProgressMatch ? parseInt(refProgressMatch[1]) : 0;
-                        if (refProgress < 100) {
-                            return referencedPath;
-                        }
-                    }
-                    // Fall through to scan for next active sprint
-                }
-            }
-            // Look for **Last Completed**: SPRINT-XXX pattern (means between sprints)
-            if (currentContent.match(/\*\*Last Completed\*\*:/)) {
-                return null;
-            }
-            // NEW: Check if CURRENT-SPRINT.md contains actual sprint content
-            // (not just a reference to another file)
-            // This supports the pattern where CURRENT-SPRINT.md IS the sprint file
-            const hasSprintContent = currentContent.includes('## Sprint Tasks') ||
-                currentContent.includes('### TASK-') ||
-                currentContent.match(/\*\*Sprint Goal\*\*:/);
-            if (hasSprintContent) {
-                return currentSprintPath;
-            }
-        }
-        // Fall back: Get all sprint files sorted by date (newest first)
+        // EPIC-015 Sprint 3: Warn about deprecated CURRENT-SPRINT.md
+        warnDeprecatedCurrentSprint(sprintsDir);
+        // Get all sprint files sorted by date (newest first)
+        // Skip CURRENT-SPRINT.md as it's deprecated
         const sprintFiles = (await fs.readdir(sprintsDir))
             .filter(f => f.startsWith('SPRINT-') && f.endsWith('.md') && f !== 'CURRENT-SPRINT.md')
             .sort()
@@ -195,22 +172,8 @@ export async function findActiveSprint(projectRoot) {
         return null;
     }
 }
-/**
- * Parse task state from checkbox symbol
- *
- * @param symbol - Checkbox content: ' ', '@', 'Z', or 'x'
- * @returns Task state enum
- */
-function parseTaskState(symbol) {
-    const trimmed = symbol.trim();
-    if (trimmed === 'x' || trimmed === 'X')
-        return 'complete';
-    if (trimmed === '@')
-        return 'in_progress';
-    if (trimmed === 'Z' || trimmed === 'z')
-        return 'paused';
-    return 'todo';
-}
+// NOTE: parseTaskState function removed in EPIC-015 Sprint 2
+// Status now comes from graph API, not markdown checkbox parsing
 /**
  * Detect acceptance criterion type from description (EPIC-004 Sprint 3 TASK-1)
  *
@@ -334,17 +297,21 @@ function parseAcceptanceCriteria(lines, startIndex) {
     return criteria;
 }
 /**
- * Parse sprint markdown into task checklist
+ * Parse sprint markdown into task checklist (backward compatible)
+ *
+ * EPIC-015 Sprint 2: Status parsing removed. All tasks default to 'todo'.
+ * Status should be merged from graph API at runtime.
  *
  * Looks for:
  * - Sprint name from title (# SPRINT: ...)
  * - Tasks from ## Sprint Tasks or ### TASK-N sections
- * - Checkbox states: [ ], [@], [Z], [x]
- * - Task metadata (files, priority, effort)
+ * - Task metadata (files, priority, effort, dependencies)
+ * - Related knowledge (ADRs, patterns, gotchas)
+ * - Acceptance criteria
  *
  * @param markdown - Sprint markdown content
  * @param filePath - Path to sprint file
- * @returns Parsed sprint checklist
+ * @returns Parsed sprint checklist (all tasks with state: 'todo')
  */
 export function parseSprintChecklist(markdown, filePath) {
     const lines = markdown.split('\n');
@@ -363,20 +330,20 @@ export function parseSprintChecklist(markdown, filePath) {
             if (parsingTask?.id && parsingTask?.title) {
                 tasks.push(parsingTask);
             }
-            // Start new task
+            // Start new task - state defaults to 'todo' (status comes from graph API)
             parsingTask = {
                 id: taskHeaderMatch[1],
                 title: taskHeaderMatch[2].trim(),
                 effort: taskHeaderMatch[3]?.trim(),
-                state: 'todo', // Default, will update from Status line
+                state: 'todo', // EPIC-015: Status comes from graph API, not file
                 files: [],
             };
             continue;
         }
-        // Match task status: **Status:** [@] In Progress
-        const statusMatch = line.match(/\*\*Status:\*\*\s*\[([x@\s])\]\s*(.+)/i);
-        if (statusMatch && parsingTask) {
-            parsingTask.state = parseTaskState(statusMatch[1]);
+        // NOTE: Status line parsing removed in EPIC-015 Sprint 2
+        // Status now comes from graph API, not markdown checkboxes
+        // Skip **Status:** lines but don't parse them
+        if (line.match(/\*\*Status:\*\*/i)) {
             continue;
         }
         // Match task priority: **Priority:** HIGH
@@ -488,18 +455,20 @@ export function parseSprintChecklist(markdown, filePath) {
     if (parsingTask?.id && parsingTask?.title) {
         tasks.push(parsingTask);
     }
-    // Calculate progress
-    const complete = tasks.filter(t => t.state === 'complete').length;
-    const inProgress = tasks.filter(t => t.state === 'in_progress').length;
-    const paused = tasks.filter(t => t.state === 'paused').length;
-    const todo = tasks.filter(t => t.state === 'todo').length;
-    // Find current task: first [@], or first [ ] if no [@] exists
-    const firstInProgress = tasks.find(t => t.state === 'in_progress');
-    const firstTodo = tasks.find(t => t.state === 'todo');
-    const currentTask = firstInProgress || firstTodo;
-    // Recent completions: last 3 completed tasks
-    const completedTasks = tasks.filter(t => t.state === 'complete');
-    const recentCompletions = completedTasks.slice(-3).reverse();
+    // EPIC-015 Sprint 2: Progress calculation removed from file parsing
+    // All tasks default to 'todo' - actual status comes from graph API
+    // Progress should be calculated at runtime after merging with graph status
+    const complete = 0; // Will be calculated from graph status
+    const inProgress = 0; // Will be calculated from graph status
+    const paused = 0; // Will be calculated from graph status
+    const todo = tasks.length; // All tasks default to todo
+    // EPIC-015 Sprint 2: Current task selection simplified
+    // Without status, we just pick the first task (or undefined if none)
+    // Actual current task should be determined from graph status at runtime
+    const currentTask = tasks.length > 0 ? tasks[0] : undefined;
+    // EPIC-015 Sprint 2: Recent completions empty from file parsing
+    // Should be populated from graph status at runtime
+    const recentCompletions = [];
     // Validate dependencies (EPIC-004 Sprint 4)
     const dependencyWarnings = [];
     const taskIds = new Set(tasks.map(t => t.id));
@@ -565,12 +534,235 @@ export function parseSprintChecklist(markdown, filePath) {
         dependencyWarnings: dependencyWarnings.length > 0 ? dependencyWarnings : undefined,
     };
 }
+// ============================================================================
+// Content-Only Functions (EPIC-015 Sprint 2)
+// These functions extract content without status - status comes from graph API
+// ============================================================================
+/**
+ * Parse sprint markdown into content-only structure (no status)
+ *
+ * EPIC-015 Sprint 2: New content-focused parsing function.
+ * Extracts task content (ID, title, metadata, relationships) without status.
+ * Status should be fetched from graph API and merged separately.
+ *
+ * @param markdown - Sprint markdown content
+ * @param filePath - Path to sprint file
+ * @returns Parsed sprint content (no status information)
+ */
+export function parseSprintContent(markdown, filePath) {
+    const lines = markdown.split('\n');
+    const tasks = [];
+    // Extract sprint name from title
+    const titleMatch = markdown.match(/^#\s+SPRINT:\s*(.+?)$/m);
+    const sprintName = titleMatch ? titleMatch[1].trim() : path.basename(filePath, '.md');
+    let parsingTask = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match task headers: ### TASK-N: Title OR ### e008_s02_t01: Title (ADR-052)
+        const taskHeaderMatch = line.match(/^###\s+((?:TASK-\d+|e\d+_s\d+_t\d+|adhoc_\d+_s\d+_t\d+)):\s*(.+?)(?:\s*\((.+?)\))?$/i);
+        if (taskHeaderMatch) {
+            // Save previous task if exists
+            if (parsingTask?.id && parsingTask?.title) {
+                tasks.push(parsingTask);
+            }
+            // Start new task (content only - no status)
+            parsingTask = {
+                id: taskHeaderMatch[1],
+                title: taskHeaderMatch[2].trim(),
+                effort: taskHeaderMatch[3]?.trim(),
+                files: [],
+            };
+            continue;
+        }
+        // Skip status lines - status comes from graph API
+        if (line.match(/\*\*Status:\*\*/i)) {
+            continue;
+        }
+        // Match task priority
+        const priorityMatch = line.match(/\*\*Priority:\*\*\s*(.+)/i);
+        if (priorityMatch && parsingTask) {
+            parsingTask.priority = priorityMatch[1].trim();
+            continue;
+        }
+        // Match task dependencies
+        const dependsMatch = line.match(/\*\*Depends:\*\*\s*(.+)/i);
+        if (dependsMatch && parsingTask) {
+            const depsString = dependsMatch[1].trim();
+            const deps = depsString.split(/[,\s]+/)
+                .map(d => d.trim())
+                .filter(d => /^(?:TASK-\d+|t\d+|e\d+_s\d+_t\d+|adhoc_\d+_s\d+_t\d+)$/i.test(d));
+            if (deps.length > 0) {
+                parsingTask.dependsOn = deps;
+            }
+            continue;
+        }
+        // Match files section
+        if (line.match(/^\*\*Files:\*\*/) && parsingTask) {
+            let j = i + 1;
+            while (j < lines.length && lines[j].match(/^-\s+(Create|Modify):/)) {
+                const fileMatch = lines[j].match(/^-\s+(?:Create|Modify):\s+`([^`]+)`/);
+                if (fileMatch) {
+                    parsingTask.files = parsingTask.files || [];
+                    parsingTask.files.push(fileMatch[1]);
+                }
+                j++;
+            }
+            continue;
+        }
+        // Match acceptance criteria section
+        if (line.match(/^\*\*Acceptance:\*\*/) && parsingTask) {
+            const criteria = parseAcceptanceCriteria(lines, i + 1);
+            if (criteria.length > 0) {
+                parsingTask.acceptanceCriteria = criteria;
+            }
+            continue;
+        }
+        // Extract ADR references
+        if (parsingTask) {
+            const adrMatches = line.matchAll(/ADR-(\d+)/gi);
+            for (const match of adrMatches) {
+                const adrId = `ADR-${match[1].padStart(3, '0')}`;
+                parsingTask.relatedADRs = parsingTask.relatedADRs || [];
+                if (!parsingTask.relatedADRs.includes(adrId)) {
+                    parsingTask.relatedADRs.push(adrId);
+                }
+            }
+            // Extract pattern references
+            const patternFromFileMatches = line.matchAll(/(?:use|apply|see|follow)\s+(?:the\s+)?(?:pattern|example)\s+(?:from|in)\s+[`"]?([a-zA-Z0-9_\-./]+\.[a-zA-Z]+)[`"]?/gi);
+            for (const match of patternFromFileMatches) {
+                const patternId = match[1];
+                parsingTask.relatedPatterns = parsingTask.relatedPatterns || [];
+                if (!parsingTask.relatedPatterns.includes(patternId)) {
+                    parsingTask.relatedPatterns.push(patternId);
+                }
+            }
+            const explicitPatternMatches = line.matchAll(/\b([a-z][a-z0-9]*(?:-[a-z0-9]+)*-pattern)\b/gi);
+            for (const match of explicitPatternMatches) {
+                const patternId = match[1].toLowerCase();
+                parsingTask.relatedPatterns = parsingTask.relatedPatterns || [];
+                if (!parsingTask.relatedPatterns.includes(patternId)) {
+                    parsingTask.relatedPatterns.push(patternId);
+                }
+            }
+            // Extract gotcha references
+            const explicitGotchaMatches = line.matchAll(/\b([a-z][a-z0-9]*(?:-[a-z0-9]+)*-gotcha)\b/gi);
+            for (const match of explicitGotchaMatches) {
+                const gotchaId = match[1].toLowerCase();
+                parsingTask.relatedGotchas = parsingTask.relatedGotchas || [];
+                if (!parsingTask.relatedGotchas.includes(gotchaId)) {
+                    parsingTask.relatedGotchas.push(gotchaId);
+                }
+            }
+            if (!line.match(/[a-z][a-z0-9]*(?:-[a-z0-9]+)*-gotcha/i)) {
+                const gotchaWarningMatches = line.matchAll(/(?:avoid|watch out for|beware of|gotcha:)\s+[`"]?([^`".\n]+)[`"]?/gi);
+                for (const match of gotchaWarningMatches) {
+                    if (match[1].toLowerCase().includes('gotcha'))
+                        continue;
+                    const gotchaId = match[1].trim().toLowerCase().replace(/\s+/g, '-');
+                    if (gotchaId.length <= 40) {
+                        parsingTask.relatedGotchas = parsingTask.relatedGotchas || [];
+                        if (!parsingTask.relatedGotchas.includes(gotchaId)) {
+                            parsingTask.relatedGotchas.push(gotchaId);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // Save last task
+    if (parsingTask?.id && parsingTask?.title) {
+        tasks.push(parsingTask);
+    }
+    // Validate dependencies
+    const dependencyWarnings = [];
+    const taskIds = new Set(tasks.map(t => t.id));
+    for (const task of tasks) {
+        if (task.dependsOn) {
+            for (const depId of task.dependsOn) {
+                if (!taskIds.has(depId)) {
+                    dependencyWarnings.push(`${task.id} depends on non-existent task: ${depId}`);
+                }
+            }
+        }
+    }
+    // Check for circular dependencies
+    const visited = new Set();
+    const inStack = new Set();
+    function detectCycle(taskId, pathArr) {
+        if (inStack.has(taskId)) {
+            const cycleStart = pathArr.indexOf(taskId);
+            return [...pathArr.slice(cycleStart), taskId];
+        }
+        if (visited.has(taskId))
+            return null;
+        visited.add(taskId);
+        inStack.add(taskId);
+        pathArr.push(taskId);
+        const task = tasks.find(t => t.id === taskId);
+        if (task?.dependsOn) {
+            for (const depId of task.dependsOn) {
+                if (taskIds.has(depId)) {
+                    const cycle = detectCycle(depId, pathArr);
+                    if (cycle)
+                        return cycle;
+                }
+            }
+        }
+        pathArr.pop();
+        inStack.delete(taskId);
+        return null;
+    }
+    for (const task of tasks) {
+        if (!visited.has(task.id)) {
+            const cycle = detectCycle(task.id, []);
+            if (cycle) {
+                dependencyWarnings.push(`Circular dependency: ${cycle.join(' -> ')}`);
+                break;
+            }
+        }
+    }
+    return {
+        name: sprintName,
+        file: filePath,
+        tasks,
+        dependencyWarnings: dependencyWarnings.length > 0 ? dependencyWarnings : undefined,
+    };
+}
 /**
- * Load active sprint checklist
+ * Load active sprint content (no status)
+ *
+ * EPIC-015 Sprint 2: New content-focused loading function.
+ * Finds active sprint file and parses content without status.
+ * Status should be fetched from graph API and merged separately.
+ *
+ * @param projectRoot - Project root directory (defaults to git root)
+ * @param sprintFilePath - Optional specific sprint file path
+ * @returns Parsed sprint content or null if no sprint found
+ */
+export async function loadSprintContent(projectRoot, sprintFilePath) {
+    try {
+        const sprintFile = sprintFilePath || await findActiveSprint(projectRoot);
+        if (!sprintFile) {
+            return null;
+        }
+        const content = await fs.readFile(sprintFile, 'utf-8');
+        return parseSprintContent(content, sprintFile);
+    }
+    catch (error) {
+        console.error('Failed to load sprint content:', error.message);
+        return null;
+    }
+}
+/**
+ * Load active sprint checklist (backward compatible)
+ *
+ * EPIC-015 Sprint 2: This function maintained for backward compatibility.
+ * All tasks will have state: 'todo'. Merge with graph API status at runtime.
  *
  * Finds active sprint file and parses into structured checklist
  *
  * @param projectRoot - Project root directory (defaults to git root)
+ * @param sprintFilePath - Optional specific sprint file path
  * @returns Parsed sprint checklist or null if no sprint found
  */
 export async function loadSprintChecklist(projectRoot, sprintFilePath) {
@@ -760,8 +952,11 @@ function parseSprintTable(content) {
 }
 /**
  * Find sprint file by ID
+ * @param sprintId - Sprint ID (e.g., 'e011_s01' or 'e016_s03')
+ * @param projectRoot - Project root directory
+ * @returns Path to sprint file or null if not found
  */
-async function findSprintFileById(sprintId, projectRoot) {
+export async function findSprintFileById(sprintId, projectRoot) {
     const sprintsDir = path.join(projectRoot, 'docs', 'sprints');
     if (!fs.existsSync(sprintsDir)) {
         return null;