@ginkoai/cli 2.0.6 → 2.1.1

package/dist/lib/task-parser.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-19
+ * @tags: [task-parser, sprint, epic-015, sprint-0a]
+ * @related: [sprint-parser.ts, task-graph-sync.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra]
+ */
+/**
+ * Task status values (aligned with Status API)
+ */
+export type TaskStatus = 'not_started' | 'in_progress' | 'blocked' | 'complete' | 'paused';
+/**
+ * Parsed task from sprint markdown
+ */
+export interface ParsedTask {
+    /** Task ID (e.g., e015_s00a_t01, TASK-1, adhoc_260119_s01_t01) */
+    id: string;
+    /** Derived sprint ID (e.g., e015_s00a, adhoc_260119_s01) */
+    sprint_id: string;
+    /** Derived epic ID (e.g., e015, adhoc_260119) */
+    epic_id: string;
+    /** Task title */
+    title: string;
+    /** Estimated effort (e.g., "3h", "4-6h") */
+    estimate: string | null;
+    /** Priority level */
+    priority: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    /** Assignee email or null */
+    assignee: string | null;
+    /** Initial status from checkbox (used only on CREATE) */
+    initial_status: TaskStatus;
+    /** Task goal/description */
+    goal: string | null;
+    /** Approach/implementation notes (e014_s02_t04) */
+    approach: string | null;
+    /** Acceptance criteria list */
+    acceptance_criteria: string[];
+    /** Referenced files */
+    files: string[];
+    /** Related ADR references */
+    related_adrs: string[];
+}
+/**
+ * Sprint metadata extracted alongside tasks
+ */
+export interface ParsedSprint {
+    /** Sprint ID (derived from filename or content) */
+    id: string;
+    /** Sprint name */
+    name: string;
+    /** Epic ID */
+    epic_id: string;
+    /** Sprint file path */
+    file_path: string;
+}
+/**
+ * Result of parsing a sprint file
+ */
+export interface SprintParseResult {
+    sprint: ParsedSprint;
+    tasks: ParsedTask[];
+}
+/**
+ * Parse task hierarchy from task ID
+ *
+ * @param taskId - Task ID in various formats
+ * @returns Object with sprint_id and epic_id, or null if invalid
+ */
+export declare function parseTaskHierarchy(taskId: string): {
+    sprint_id: string;
+    epic_id: string;
+} | null;
+/**
+ * Parse a single task block
+ *
+ * @param blockText - Raw markdown text for one task
+ * @param sprintContext - Sprint context for legacy TASK-N format
+ * @returns ParsedTask or null if invalid
+ */
+export declare function parseTaskBlock(blockText: string, sprintContext?: {
+    sprint_id: string;
+    epic_id: string;
+}): ParsedTask | null;
+/**
+ * Parse sprint markdown file to extract all tasks
+ *
+ * @param content - Raw sprint markdown content
+ * @param filePath - Path to sprint file (for metadata extraction)
+ * @returns SprintParseResult with sprint metadata and parsed tasks
+ */
+export declare function parseSprintTasks(content: string, filePath: string): SprintParseResult;
+/**
+ * Parse sprint file from filesystem
+ *
+ * @param filePath - Absolute path to sprint markdown file
+ * @returns SprintParseResult or null if file not found
+ */
+export declare function parseSprintFile(filePath: string): Promise<SprintParseResult | null>;
+/**
+ * Parse all sprint files in a directory
+ *
+ * @param sprintsDir - Path to sprints directory
+ * @returns Array of SprintParseResult
+ */
+export declare function parseAllSprints(sprintsDir: string): Promise<SprintParseResult[]>;
+//# sourceMappingURL=task-parser.d.ts.map

package/dist/lib/task-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../src/lib/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qBAAqB;IACrB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,cAAc,EAAE,UAAU,CAAC;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+BAA+B;IAC/B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,uBAAuB;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8BhG;AAqID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD,UAAU,GAAG,IAAI,CAoGnB;AAgFD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAwBrF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAazF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyBtF"}

package/dist/lib/task-parser.js

@@ -0,0 +1,407 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-19
+ * @tags: [task-parser, sprint, epic-015, sprint-0a]
+ * @related: [sprint-parser.ts, task-graph-sync.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra]
+ */
+/**
+ * Task Parser for Sprint Markdown (EPIC-015 Sprint 0a Task 1)
+ *
+ * Parses task definitions from sprint markdown files into structured data
+ * for syncing to Neo4j graph. Handles multiple task ID formats:
+ * - Standard: e{NNN}_s{NN}_t{NN} (e.g., e015_s00a_t01)
+ * - Legacy: TASK-N (e.g., TASK-1)
+ * - Ad-hoc: adhoc_{YYMMDD}_s{NN}_t{NN} (e.g., adhoc_260119_s01_t01)
+ *
+ * Key principle (ADR-060): Content from Git, State from Graph.
+ * Parser extracts CONTENT fields only (title, goal, priority, estimate).
+ * Status in markdown is only used for initial creation, not updates.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Parse task hierarchy from task ID
+ *
+ * @param taskId - Task ID in various formats
+ * @returns Object with sprint_id and epic_id, or null if invalid
+ */
+export function parseTaskHierarchy(taskId) {
+    // Standard format: e015_s00a_t01 or e015_s00_t01
+    const standardMatch = taskId.match(/^(e\d{3})_(s\d{2}[a-z]?)_(t\d{2})$/i);
+    if (standardMatch) {
+        const epicId = standardMatch[1].toLowerCase();
+        const sprintSuffix = standardMatch[2].toLowerCase();
+        return {
+            sprint_id: `${epicId}_${sprintSuffix}`,
+            epic_id: epicId,
+        };
+    }
+    // Ad-hoc format: adhoc_260119_s01_t01
+    const adhocMatch = taskId.match(/^(adhoc_\d{6})_(s\d{2})_(t\d{2})$/i);
+    if (adhocMatch) {
+        const adhocId = adhocMatch[1].toLowerCase();
+        const sprintSuffix = adhocMatch[2].toLowerCase();
+        return {
+            sprint_id: `${adhocId}_${sprintSuffix}`,
+            epic_id: adhocId,
+        };
+    }
+    // Legacy TASK-N format - derive from context (requires sprint info)
+    // For legacy format, we cannot derive hierarchy without sprint context
+    if (taskId.match(/^TASK-\d+$/i)) {
+        return null; // Caller must provide sprint context
+    }
+    return null;
+}
+/**
+ * Map checkbox character to task status
+ *
+ * @param checkbox - Single character from checkbox ([x], [@], [ ], [Z])
+ * @returns TaskStatus value
+ */
+function mapCheckboxToStatus(checkbox) {
+    if (!checkbox)
+        return 'not_started';
+    const char = checkbox.trim().toLowerCase();
+    switch (char) {
+        case 'x':
+            return 'complete';
+        case '@':
+            return 'in_progress';
+        case 'z':
+            return 'paused';
+        case ' ':
+        default:
+            return 'not_started';
+    }
+}
+/**
+ * Normalize priority value
+ */
+function normalizePriority(priority) {
+    if (!priority)
+        return 'MEDIUM';
+    const upper = priority.trim().toUpperCase();
+    if (['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'].includes(upper)) {
+        return upper;
+    }
+    return 'MEDIUM';
+}
+/**
+ * Extract approach/implementation notes from task block (e014_s02_t04)
+ *
+ * Parses the **Approach:** section which contains 2-3 sentences describing
+ * how to implement the task.
+ */
+function extractApproach(blockText) {
+    // Match: **Approach:** followed by text until next section
+    const approachMatch = blockText.match(/\*\*Approach:\*\*\s+([\s\S]*?)(?=\n\*\*(?!Approach)|\n###|\n---|\n##|$)/i);
+    if (!approachMatch)
+        return null;
+    // Clean up the approach text - join lines and trim
+    const approach = approachMatch[1]
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line.length > 0)
+        .join(' ')
+        .trim();
+    return approach.length > 0 ? approach : null;
+}
+/**
+ * Extract acceptance criteria from task block
+ */
+function extractAcceptanceCriteria(blockText) {
+    const criteria = [];
+    // Find acceptance criteria section
+    const sectionMatch = blockText.match(/\*\*Acceptance Criteria:\*\*\s*([\s\S]*?)(?=\n\*\*|\n###|\n---|\n##|$)/i);
+    if (!sectionMatch)
+        return criteria;
+    // Extract checkbox items: - [ ] or - [x]
+    const checkboxMatches = sectionMatch[1].matchAll(/^-\s+\[.\]\s+(.+?)$/gm);
+    for (const match of checkboxMatches) {
+        criteria.push(match[1].trim());
+    }
+    // Also extract plain bullets if no checkboxes found
+    if (criteria.length === 0) {
+        const bulletMatches = sectionMatch[1].matchAll(/^-\s+(.+?)$/gm);
+        for (const match of bulletMatches) {
+            criteria.push(match[1].trim());
+        }
+    }
+    return criteria;
+}
+/**
+ * Extract file paths from task block
+ */
+function extractFiles(blockText) {
+    const files = new Set();
+    // Pattern: **Files:** section with bullet list
+    const filesSection = blockText.match(/\*\*Files(?:\sto\s(?:Create|Modify))?:\*\*\s*([\s\S]*?)(?=\n\*\*|\n###|\n---|\n##|$)/i);
+    if (filesSection) {
+        // Match: - Create: `path/to/file.ts` or - Modify: `path/to/file.ts` or just `path`
+        const pathMatches = filesSection[1].matchAll(/`([^`]+\.[a-z]+)`/gi);
+        for (const match of pathMatches) {
+            files.add(match[1]);
+        }
+    }
+    // Pattern: inline code paths that look like file paths
+    const inlineMatches = blockText.matchAll(/`((?:packages|dashboard|src|docs)\/[^`]+\.[a-z]+)`/gi);
+    for (const match of inlineMatches) {
+        files.add(match[1]);
+    }
+    return Array.from(files).sort();
+}
+/**
+ * Extract related ADR references
+ */
+function extractRelatedADRs(blockText) {
+    const adrs = new Set();
+    // Match ADR-XXX patterns
+    const adrMatches = blockText.matchAll(/ADR-(\d+)/gi);
+    for (const match of adrMatches) {
+        adrs.add(`ADR-${match[1]}`);
+    }
+    return Array.from(adrs).sort();
+}
+/**
+ * Parse a single task block
+ *
+ * @param blockText - Raw markdown text for one task
+ * @param sprintContext - Sprint context for legacy TASK-N format
+ * @returns ParsedTask or null if invalid
+ */
+export function parseTaskBlock(blockText, sprintContext) {
+    // Extract task header - multiple formats supported
+    // Standard: ### e015_s00a_t01: Title (3h)
+    // Legacy: ### TASK-1: Title (4-6h)
+    // Ad-hoc: ### adhoc_260119_s01_t01 - Title
+    // Without time: ### e015_s00a_t01: Title
+    const headerPatterns = [
+        // Standard with colon and optional time
+        /^###\s+([a-z0-9_]+):\s+(.+?)\s*(?:\(([0-9]+(?:-[0-9]+)?h?)\))?$/im,
+        // With dash separator (ad-hoc style)
+        /^###\s+([a-z0-9_]+)\s+-\s+(.+?)$/im,
+        // Legacy TASK-N format
+        /^###\s+(TASK-\d+):\s+(.+?)\s*(?:\(([0-9]+(?:-[0-9]+)?h?)\))?$/im,
+    ];
+    let taskId = null;
+    let title = null;
+    let estimate = null;
+    for (const pattern of headerPatterns) {
+        const match = blockText.match(pattern);
+        if (match) {
+            taskId = match[1];
+            title = match[2].trim();
+            estimate = match[3] || null;
+            break;
+        }
+    }
+    if (!taskId || !title) {
+        return null;
+    }
+    // Parse hierarchy
+    let hierarchy = parseTaskHierarchy(taskId);
+    // For legacy TASK-N format, use sprint context
+    if (!hierarchy && sprintContext) {
+        hierarchy = {
+            sprint_id: sprintContext.sprint_id,
+            epic_id: sprintContext.epic_id,
+        };
+    }
+    if (!hierarchy) {
+        // Cannot determine hierarchy, skip task
+        console.warn(`Cannot determine hierarchy for task: ${taskId}`);
+        return null;
+    }
+    // Extract status from checkbox: **Status:** [x]
+    const statusMatch = blockText.match(/\*\*Status:\*\*\s+\[(.)\]/i);
+    const initialStatus = mapCheckboxToStatus(statusMatch?.[1]);
+    // Extract priority
+    const priorityMatch = blockText.match(/\*\*Priority:\*\*\s+([A-Z_]+)/i);
+    const priority = normalizePriority(priorityMatch?.[1]);
+    // Extract assignee (accepts both Assignee and Owner)
+    const assigneeMatch = blockText.match(/\*\*(?:Assignee|Owner):\*\*\s+([^\n]+)/i);
+    let assignee = null;
+    if (assigneeMatch) {
+        const value = assigneeMatch[1].trim();
+        // Filter out "TBD", "None", empty values
+        if (value && !['tbd', 'none', 'n/a', '-'].includes(value.toLowerCase())) {
+            assignee = value;
+        }
+    }
+    // Extract goal
+    const goalMatch = blockText.match(/\*\*Goal:\*\*\s+([^\n]+)/i);
+    const goal = goalMatch ? goalMatch[1].trim() : null;
+    // Extract approach (e014_s02_t04)
+    const approach = extractApproach(blockText);
+    // Extract acceptance criteria
+    const acceptanceCriteria = extractAcceptanceCriteria(blockText);
+    // Extract files
+    const files = extractFiles(blockText);
+    // Extract related ADRs
+    const relatedADRs = extractRelatedADRs(blockText);
+    return {
+        id: taskId.toLowerCase(),
+        sprint_id: hierarchy.sprint_id,
+        epic_id: hierarchy.epic_id,
+        title,
+        estimate,
+        priority,
+        assignee,
+        initial_status: initialStatus,
+        goal,
+        approach,
+        acceptance_criteria: acceptanceCriteria,
+        files,
+        related_adrs: relatedADRs,
+    };
+}
+/**
+ * Extract sprint metadata from sprint file
+ *
+ * @param content - Sprint file content
+ * @param filePath - Path to sprint file
+ * @returns ParsedSprint metadata
+ */
+function extractSprintMetadata(content, filePath) {
+    const filename = path.basename(filePath, '.md');
+    // Try to extract sprint ID from filename
+    // Pattern: SPRINT-2026-01-e015-s00a-... → e015_s00a
+    const filenameMatch = filename.match(/SPRINT-\d{4}-\d{2}-(e\d{3})-(s\d{2}[a-z]?)-/i);
+    if (filenameMatch) {
+        const epicId = filenameMatch[1].toLowerCase();
+        const sprintSuffix = filenameMatch[2].toLowerCase();
+        const sprintId = `${epicId}_${sprintSuffix}`;
+        // Extract sprint name from title
+        const titleMatch = content.match(/^#\s+(?:SPRINT:\s+)?(.+?)(?:\s+\(|$)/m);
+        const name = titleMatch ? titleMatch[1].trim() : filename;
+        return {
+            id: sprintId,
+            name,
+            epic_id: epicId,
+            file_path: filePath,
+        };
+    }
+    // Ad-hoc pattern: SPRINT-adhoc_260119-...
+    const adhocMatch = filename.match(/SPRINT-(adhoc_\d{6})-/i);
+    if (adhocMatch) {
+        const adhocId = adhocMatch[1].toLowerCase();
+        const sprintId = `${adhocId}_s01`; // Default to s01 for adhoc
+        const titleMatch = content.match(/^#\s+(.+?)(?:\s+\(|$)/m);
+        const name = titleMatch ? titleMatch[1].trim() : filename;
+        return {
+            id: sprintId,
+            name,
+            epic_id: adhocId,
+            file_path: filePath,
+        };
+    }
+    // Legacy pattern from content: # SPRINT: Name (EPIC-XXX Sprint N)
+    const legacyMatch = content.match(/^#\s+SPRINT:\s+(.+?)\s+\(EPIC-(\d+)\s+Sprint\s+(\d+)\)/m);
+    if (legacyMatch) {
+        const name = legacyMatch[1].trim();
+        const epicNum = legacyMatch[2];
+        const sprintNum = legacyMatch[3];
+        const epicId = `e${epicNum.padStart(3, '0')}`;
+        const sprintId = `${epicId}_s${sprintNum.padStart(2, '0')}`;
+        return {
+            id: sprintId,
+            name,
+            epic_id: epicId,
+            file_path: filePath,
+        };
+    }
+    // Fallback: generate from filename
+    const fallbackId = filename
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^sprint_/, '');
+    return {
+        id: fallbackId,
+        name: filename,
+        epic_id: 'unknown',
+        file_path: filePath,
+    };
+}
+/**
+ * Parse sprint markdown file to extract all tasks
+ *
+ * @param content - Raw sprint markdown content
+ * @param filePath - Path to sprint file (for metadata extraction)
+ * @returns SprintParseResult with sprint metadata and parsed tasks
+ */
+export function parseSprintTasks(content, filePath) {
+    // Extract sprint metadata
+    const sprint = extractSprintMetadata(content, filePath);
+    // Split content by task headers (### followed by task ID pattern)
+    // Match: ### e015_s00a_t01:, ### TASK-1:, ### adhoc_..._t01
+    const taskSections = content.split(/(?=^###\s+(?:e\d{3}_s\d{2}[a-z]?_t\d{2}|TASK-\d+|adhoc_\d{6}_s\d{2}_t\d{2})[\s:-])/im);
+    const tasks = [];
+    const sprintContext = {
+        sprint_id: sprint.id,
+        epic_id: sprint.epic_id,
+    };
+    for (const section of taskSections) {
+        if (!section.trim().startsWith('###'))
+            continue;
+        const task = parseTaskBlock(section, sprintContext);
+        if (task) {
+            tasks.push(task);
+        }
+    }
+    return { sprint, tasks };
+}
+/**
+ * Parse sprint file from filesystem
+ *
+ * @param filePath - Absolute path to sprint markdown file
+ * @returns SprintParseResult or null if file not found
+ */
+export async function parseSprintFile(filePath) {
+    try {
+        if (!await fs.pathExists(filePath)) {
+            console.warn(`Sprint file not found: ${filePath}`);
+            return null;
+        }
+        const content = await fs.readFile(filePath, 'utf-8');
+        return parseSprintTasks(content, filePath);
+    }
+    catch (error) {
+        console.error(`Failed to parse sprint file ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Parse all sprint files in a directory
+ *
+ * @param sprintsDir - Path to sprints directory
+ * @returns Array of SprintParseResult
+ */
+export async function parseAllSprints(sprintsDir) {
+    const results = [];
+    try {
+        if (!await fs.pathExists(sprintsDir)) {
+            console.warn(`Sprints directory not found: ${sprintsDir}`);
+            return results;
+        }
+        const files = await fs.readdir(sprintsDir);
+        const sprintFiles = files.filter(f => f.startsWith('SPRINT-') && f.endsWith('.md'));
+        for (const file of sprintFiles) {
+            const filePath = path.join(sprintsDir, file);
+            const result = await parseSprintFile(filePath);
+            if (result) {
+                results.push(result);
+            }
+        }
+        return results;
+    }
+    catch (error) {
+        console.error(`Failed to parse sprints directory ${sprintsDir}:`, error);
+        return results;
+    }
+}
+//# sourceMappingURL=task-parser.js.map

package/dist/lib/task-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.js","sourceRoot":"","sources":["../../src/lib/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AA6DxB;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,iDAAiD;IACjD,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC1E,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACpD,OAAO;YACL,SAAS,EAAE,GAAG,MAAM,IAAI,YAAY,EAAE;YACtC,OAAO,EAAE,MAAM;SAChB,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACtE,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO;YACL,SAAS,EAAE,GAAG,OAAO,IAAI,YAAY,EAAE;YACvC,OAAO,EAAE,OAAO;SACjB,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,uEAAuE;IACvE,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,CAAC,qCAAqC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,QAA4B;IACvD,IAAI,CAAC,QAAQ;QAAE,OAAO,aAAa,CAAC;IAEpC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG;YACN,OAAO,UAAU,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,aAAa,CAAC;QACvB,KAAK,GAAG;YACN,OAAO,QAAQ,CAAC;QAClB,KAAK,GAAG,CAAC;QACT;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAA4B;IACrD,IAAI,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE/B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,KAA+B,CAAC;IACzC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,SAAiB;IACxC,2DAA2D;IAC3D,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CACnC,0EAA0E,CAC3E,CAAC;IAEF,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAEhC,mDAAmD;IACnD,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC;SAC9B,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,IAAI,CAAC,GAAG,CAAC;SACT,IAAI,EAAE,CAAC;IAEV,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,SAAiB;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,mCAAmC;IACnC,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAClC,yEAAyE,CAC1E,CAAC;IAEF,IAAI,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC;IAEnC,yCAAyC;IACzC,MAAM,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAC1E,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAChE,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,SAAiB;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,+CAA+C;IAC/C,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC9H,IAAI,YAAY,EAAE,CAAC;QACjB,mFAAmF;QACnF,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QACpE,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,sDAAsD,CAAC,CAAC;IACjG,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,yBAAyB;IACzB,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,aAAsD;IAEtD,mDAAmD;IACnD,0CAA0C;IAC1C,mCAAmC;IACnC,2CAA2C;IAC3C,yCAAyC;IACzC,MAAM,cAAc,GAAG;QACrB,wCAAwC;QACxC,mEAAmE;QACnE,qCAAqC;QACrC,oCAAoC;QACpC,uBAAuB;QACvB,iEAAiE;KAClE,CAAC;IAEF,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IAEnC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAClB,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACxB,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YAC5B,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,IAAI,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3C,+CAA+C;IAC/C,IAAI,CAAC,SAAS,IAAI,aAAa,EAAE,CAAC;QAChC,SAAS,GAAG;YACV,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,OAAO,EAAE,aAAa,CAAC,OAAO;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,wCAAwC;QACxC,OAAO,CAAC,IAAI,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5D,mBAAmB;IACnB,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvD,qDAAqD;IACrD,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACjF,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,yCAAyC;QACzC,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACxE,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpD,kCAAkC;IAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAE5C,8BAA8B;IAC9B,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAEhE,gBAAgB;IAChB,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAEtC,uBAAuB;IACvB,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAElD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE;QACxB,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,KAAK;QACL,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,cAAc,EAAE,aAAa;QAC7B,IAAI;QACJ,QAAQ;QACR,mBAAmB,EAAE,kBAAkB;QACvC,KAAK;QACL,YAAY,EAAE,WAAW;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,OAAe,EAAE,QAAgB;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEhD,yCAAyC;IACzC,oDAAoD;IACpD,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACrF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC;QAE7C,iCAAiC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE1D,OAAO;YACL,EAAE,EAAE,QAAQ;YACZ,IAAI;YACJ,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,GAAG,OAAO,MAAM,CAAC,CAAC,2BAA2B;QAE9D,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE1D,OAAO;YACL,EAAE,EAAE,QAAQ;YACZ,IAAI;YACJ,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7F,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,GAAG,MAAM,KAAK,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAE5D,OAAO;YACL,EAAE,EAAE,QAAQ;YACZ,IAAI;YACJ,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,QAAQ;SACxB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE3B,OAAO;QACL,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,QAAgB;IAChE,0BAA0B;IAC1B,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAExD,kEAAkE;IAClE,4DAA4D;IAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAE3H,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,aAAa,GAAG;QACpB,SAAS,EAAE,MAAM,CAAC,EAAE;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,SAAS;QAEhD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACpD,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACtD,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;YAC3D,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAEpF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;QACzE,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}

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

@@ -18,6 +18,21 @@ export interface UserSprintAssignment {
     sprintName: string;
     assignedAt: string;
     assignedBy: 'auto' | 'manual';
+    isAdhoc?: boolean;
+    consecutiveAdhocSessions?: number;
+    lastAdhocSessionAt?: string;
+}
+/**
+ * Result of checking user's work structure status (EPIC-016 Sprint 4 t01)
+ * Used by start command to determine if planning menu should be shown
+ */
+export interface WorkStructureStatus {
+    hasStructuredWork: boolean;
+    sprintId: string | null;
+    incompleteTasks: number;
+    consecutiveAdhocSessions: number;
+    shouldShowPlanningMenu: boolean;
+    reason: 'has_sprint' | 'no_sprint' | 'all_tasks_complete' | 'adhoc_pattern';
 }
 /**
  * Get user's current sprint assignment
@@ -56,4 +71,42 @@ export declare function validateUserSprint(assignment: UserSprintAssignment): Pr
  * Get sprint file path from user assignment
  */
 export declare function getSprintFileFromAssignment(assignment: UserSprintAssignment): Promise<string>;
+/**
+ * Check if user has structured work (sprint with incomplete tasks)
+ *
+ * Decision matrix:
+ * | Has Sprint | Has Tasks | Consecutive Adhoc | Result |
+ * |------------|-----------|-------------------|--------|
+ * | Yes        | Yes       | Any               | Has structured work |
+ * | Yes        | No (100%) | Any               | No structure (complete) |
+ * | No         | N/A       | <= 1              | No structure (new) |
+ * | No         | N/A       | > 1               | No structure (adhoc pattern) |
+ *
+ * @param userSprint - User's current sprint assignment
+ * @param sprintChecklist - Sprint task data from graph/file (with progress info)
+ * @returns WorkStructureStatus with decision
+ */
+export declare function checkWorkStructure(userSprint: UserSprintAssignment | null, sprintChecklist: {
+    progress?: {
+        total: number;
+        complete: number;
+    };
+    tasks?: Array<{
+        state: string;
+    }>;
+} | null): WorkStructureStatus;
+/**
+ * Increment ad-hoc session counter
+ * Called when user chooses ad-hoc work in planning menu
+ */
+export declare function incrementAdhocSessionCount(): Promise<number>;
+/**
+ * Reset ad-hoc session counter
+ * Called when user starts structured work (creates/selects epic/sprint)
+ */
+export declare function resetAdhocSessionCount(): Promise<void>;
+/**
+ * Create sprint assignment from sprint ID (for graph-based sprints)
+ */
+export declare function createAssignmentFromSprintId(sprintId: string, sprintName: string, assignedBy?: 'auto' | 'manual'): UserSprintAssignment;
 //# sourceMappingURL=user-sprint.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"user-sprint.d.ts","sourceRoot":"","sources":["../../src/lib/user-sprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC/B;AAaD;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAoBjF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM5D;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4BzG;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAM,GAAG,QAAiB,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkBtC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"user-sprint.d.ts","sourceRoot":"","sources":["../../src/lib/user-sprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAG9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,OAAO,CAAC;IAChC,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,oBAAoB,GAAG,eAAe,CAAC;CAC7E;AAaD;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAoBjF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM5D;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4BzG;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAM,GAAG,QAAiB,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkBtC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,oBAAoB,GAAG,IAAI,EACvC,eAAe,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,IAAI,GAC3G,mBAAmB,CA2DrB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAqBlE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAa5D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAM,GAAG,QAAiB,GACrC,oBAAoB,CAatB"}