@md2do/core 0.2.3 → 0.4.0

package/dist/index.d.mts

@@ -21,6 +21,9 @@ interface ParsingContext {
     person?: string;
     currentDate?: Date;
     currentHeading?: string;
+    workdayStartTime?: string;
+    workdayEndTime?: string;
+    defaultDueTime?: 'start' | 'end';
 }
 interface TaskFilterCriteria {
     assignee?: string | string[];
@@ -47,11 +50,20 @@ interface ScanResult {
         parseErrors: number;
     };
 }
+type WarningSeverity = 'info' | 'warning' | 'error';
+type WarningCode = 'unsupported-bullet' | 'malformed-checkbox' | 'missing-space-after' | 'missing-space-before' | 'relative-date-no-context' | 'missing-due-date' | 'missing-completed-date' | 'duplicate-todoist-id' | 'file-read-error';
 interface Warning {
     file: string;
     line: number;
-    text: string;
-    reason: string;
+    column?: number;
+    severity: WarningSeverity;
+    source: 'md2do';
+    ruleId: WarningCode;
+    message: string;
+    text?: string;
+    url?: string;
+    /** @deprecated Use message instead */
+    reason?: string;
 }
 
 /**
@@ -113,10 +125,10 @@ declare function extractCompletedDate(text: string): Date | undefined;
  * Extract due date from task text with context awareness
  *
  * Handles both absolute dates ([due: 2026-01-25]) and relative dates
- * ([due: tomorrow]) which require context.
+ * ([due: tomorrow]) which require context. Supports optional time ([due: 2026-01-25 17:00]).
  *
  * @param text - Task text
- * @param context - Parsing context (for relative dates)
+ * @param context - Parsing context (for relative dates and workday config)
  * @returns Object with parsed date and optional warning
  */
 declare function extractDueDate(text: string, context: ParsingContext): {
@@ -223,15 +235,17 @@ declare const PRIORITY_HIGH: RegExp;
  */
 declare const PRIORITY_NORMAL: RegExp;
 /**
- * Matches absolute due date in ISO format [due: YYYY-MM-DD]
+ * Matches absolute due date in ISO format [due: YYYY-MM-DD] with optional time [due: YYYY-MM-DD HH:MM]
  *
  * Examples:
- *   "[due: 2026-01-25]" → "2026-01-25"
- *   "[due:2026-01-25]" → "2026-01-25" (spaces optional)
- *   "[due:  2026-01-25  ]" → "2026-01-25" (whitespace allowed)
+ *   "[due: 2026-01-25]" → "2026-01-25", undefined
+ *   "[due: 2026-01-25 17:00]" → "2026-01-25", "17:00"
+ *   "[due: 2026-01-25 9:00]" → "2026-01-25", "9:00"
+ *   "[due:2026-01-25]" → "2026-01-25", undefined (spaces optional)
  *
  * Groups:
  *   [1] - Date string in YYYY-MM-DD format
+ *   [2] - Optional time string in H:MM or HH:MM format (24-hour)
  */
 declare const DUE_DATE_ABSOLUTE: RegExp;
 /**
@@ -391,9 +405,14 @@ declare class MarkdownScanner {
      *
      * @param filePath - Relative file path (for context extraction)
      * @param content - File content as string
+     * @param options - Optional scanner options including workday config
      * @returns Object containing tasks and warnings
      */
-    scanFile(filePath: string, content: string): {
+    scanFile(filePath: string, content: string, options?: {
+        workdayStartTime?: string;
+        workdayEndTime?: string;
+        defaultDueTime?: 'start' | 'end';
+    }): {
         tasks: Task[];
         warnings: Warning[];
     };
@@ -812,8 +831,75 @@ declare namespace index {
   export { type index_TaskComparator as TaskComparator, index_byAssignee as byAssignee, index_byCompletionStatus as byCompletionStatus, index_byCreatedDate as byCreatedDate, index_byDueDate as byDueDate, index_byFile as byFile, index_byPerson as byPerson, index_byPriority as byPriority, index_byProject as byProject, index_combineComparators as combineComparators, index_reverse as reverse };
 }
 
+interface WarningFilterConfig {
+    enabled?: boolean | undefined;
+    rules?: Record<string, 'error' | 'warn' | 'info' | 'off'> | undefined;
+}
+/**
+ * Filter warnings based on configuration rules
+ *
+ * This function applies warning configuration rules to filter out disabled warnings
+ * and optionally all warnings if globally disabled.
+ *
+ * @param warnings - Array of warnings to filter
+ * @param config - Warning configuration with enabled flag and rule overrides
+ * @returns Filtered array of warnings
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   enabled: true,
+ *   rules: {
+ *     'missing-due-date': 'off',
+ *     'duplicate-todoist-id': 'error',
+ *   },
+ * };
+ *
+ * const filtered = filterWarnings(allWarnings, config);
+ * // Returns warnings except those with ruleId 'missing-due-date'
+ * ```
+ */
+declare function filterWarnings(warnings: Warning[], config?: WarningFilterConfig): Warning[];
+/**
+ * Group warnings by severity
+ *
+ * Useful for displaying warnings in order of importance or
+ * treating errors differently from warnings.
+ *
+ * @param warnings - Array of warnings to group
+ * @returns Object with warnings grouped by severity level
+ *
+ * @example
+ * ```typescript
+ * const grouped = groupWarningsBySeverity(warnings);
+ * console.log(`${grouped.error.length} errors`);
+ * console.log(`${grouped.warning.length} warnings`);
+ * console.log(`${grouped.info.length} info messages`);
+ * ```
+ */
+declare function groupWarningsBySeverity(warnings: Warning[]): {
+    error: Warning[];
+    warning: Warning[];
+    info: Warning[];
+};
+
+/**
+ * Parse a time string in HH:MM or H:MM format
+ *
+ * @param timeStr - Time string to parse (e.g., "17:00", "9:00")
+ * @returns Object with hours and minutes, or null if invalid
+ *
+ * @example
+ * parseTime("17:00") // => { hours: 17, minutes: 0 }
+ * parseTime("9:30") // => { hours: 9, minutes: 30 }
+ * parseTime("25:00") // => null (invalid hour)
+ */
+declare function parseTime(timeStr: string): {
+    hours: number;
+    minutes: number;
+} | null;
 /**
- * Parse an absolute date string in various formats
+ * Parse an absolute date string in various formats, with optional time
  *
  * Supported formats:
  *   - ISO: 2026-01-25
@@ -821,9 +907,14 @@ declare namespace index {
  *   - US full: 1/25/2026
  *
  * @param dateStr - Date string to parse
+ * @param timeStr - Optional time string in HH:MM or H:MM format
  * @returns Parsed Date object or null if invalid
+ *
+ * @example
+ * parseAbsoluteDate("2026-01-25") // => Date at midnight
+ * parseAbsoluteDate("2026-01-25", "17:00") // => Date at 5 PM
  */
-declare function parseAbsoluteDate(dateStr: string): Date | null;
+declare function parseAbsoluteDate(dateStr: string, timeStr?: string): Date | null;
 /**
  * Resolve a relative date keyword against a base date
  *
@@ -876,4 +967,4 @@ declare function extractDateFromHeading(line: string): Date | null;
  */
 declare function generateTaskId(file: string, line: number, text: string): string;
 
-export { ASSIGNEE, COMPLETED_DATE, DUE_DATE_ABSOLUTE, DUE_DATE_RELATIVE, DUE_DATE_SHORT, HEADING_DATE_ISO, HEADING_DATE_NATURAL, HEADING_DATE_SLASH, MarkdownScanner, PATTERNS, PRIORITY_HIGH, PRIORITY_NORMAL, PRIORITY_URGENT, type ParsingContext, type Priority, type ScanResult, TAG, TASK_CHECKBOX, TODOIST_ID, type Task, type TaskFilterCriteria, type UpdateTaskOptions, type Warning, type WriteTaskResult, addTask, cleanTaskText, extractAssignee, extractCompletedDate, extractDateFromHeading, extractDueDate, extractPersonFromFilename, extractPriority, extractProjectFromPath, extractTags, extractTodoistId, index$1 as filters, generateTaskId, parseAbsoluteDate, parseTask, resolveRelativeDate, index as sorting, updateTask, updateTasks };
+export { ASSIGNEE, COMPLETED_DATE, DUE_DATE_ABSOLUTE, DUE_DATE_RELATIVE, DUE_DATE_SHORT, HEADING_DATE_ISO, HEADING_DATE_NATURAL, HEADING_DATE_SLASH, MarkdownScanner, PATTERNS, PRIORITY_HIGH, PRIORITY_NORMAL, PRIORITY_URGENT, type ParsingContext, type Priority, type ScanResult, TAG, TASK_CHECKBOX, TODOIST_ID, type Task, type TaskFilterCriteria, type UpdateTaskOptions, type Warning, type WarningCode, type WarningFilterConfig, type WarningSeverity, type WriteTaskResult, addTask, cleanTaskText, extractAssignee, extractCompletedDate, extractDateFromHeading, extractDueDate, extractPersonFromFilename, extractPriority, extractProjectFromPath, extractTags, extractTodoistId, filterWarnings, index$1 as filters, generateTaskId, groupWarningsBySeverity, parseAbsoluteDate, parseTask, parseTime, resolveRelativeDate, index as sorting, updateTask, updateTasks };

package/dist/index.d.ts

@@ -21,6 +21,9 @@ interface ParsingContext {
     person?: string;
     currentDate?: Date;
     currentHeading?: string;
+    workdayStartTime?: string;
+    workdayEndTime?: string;
+    defaultDueTime?: 'start' | 'end';
 }
 interface TaskFilterCriteria {
     assignee?: string | string[];
@@ -47,11 +50,20 @@ interface ScanResult {
         parseErrors: number;
     };
 }
+type WarningSeverity = 'info' | 'warning' | 'error';
+type WarningCode = 'unsupported-bullet' | 'malformed-checkbox' | 'missing-space-after' | 'missing-space-before' | 'relative-date-no-context' | 'missing-due-date' | 'missing-completed-date' | 'duplicate-todoist-id' | 'file-read-error';
 interface Warning {
     file: string;
     line: number;
-    text: string;
-    reason: string;
+    column?: number;
+    severity: WarningSeverity;
+    source: 'md2do';
+    ruleId: WarningCode;
+    message: string;
+    text?: string;
+    url?: string;
+    /** @deprecated Use message instead */
+    reason?: string;
 }
 
 /**
@@ -113,10 +125,10 @@ declare function extractCompletedDate(text: string): Date | undefined;
  * Extract due date from task text with context awareness
  *
  * Handles both absolute dates ([due: 2026-01-25]) and relative dates
- * ([due: tomorrow]) which require context.
+ * ([due: tomorrow]) which require context. Supports optional time ([due: 2026-01-25 17:00]).
  *
  * @param text - Task text
- * @param context - Parsing context (for relative dates)
+ * @param context - Parsing context (for relative dates and workday config)
  * @returns Object with parsed date and optional warning
  */
 declare function extractDueDate(text: string, context: ParsingContext): {
@@ -223,15 +235,17 @@ declare const PRIORITY_HIGH: RegExp;
  */
 declare const PRIORITY_NORMAL: RegExp;
 /**
- * Matches absolute due date in ISO format [due: YYYY-MM-DD]
+ * Matches absolute due date in ISO format [due: YYYY-MM-DD] with optional time [due: YYYY-MM-DD HH:MM]
  *
  * Examples:
- *   "[due: 2026-01-25]" → "2026-01-25"
- *   "[due:2026-01-25]" → "2026-01-25" (spaces optional)
- *   "[due:  2026-01-25  ]" → "2026-01-25" (whitespace allowed)
+ *   "[due: 2026-01-25]" → "2026-01-25", undefined
+ *   "[due: 2026-01-25 17:00]" → "2026-01-25", "17:00"
+ *   "[due: 2026-01-25 9:00]" → "2026-01-25", "9:00"
+ *   "[due:2026-01-25]" → "2026-01-25", undefined (spaces optional)
  *
  * Groups:
  *   [1] - Date string in YYYY-MM-DD format
+ *   [2] - Optional time string in H:MM or HH:MM format (24-hour)
  */
 declare const DUE_DATE_ABSOLUTE: RegExp;
 /**
@@ -391,9 +405,14 @@ declare class MarkdownScanner {
      *
      * @param filePath - Relative file path (for context extraction)
      * @param content - File content as string
+     * @param options - Optional scanner options including workday config
      * @returns Object containing tasks and warnings
      */
-    scanFile(filePath: string, content: string): {
+    scanFile(filePath: string, content: string, options?: {
+        workdayStartTime?: string;
+        workdayEndTime?: string;
+        defaultDueTime?: 'start' | 'end';
+    }): {
         tasks: Task[];
         warnings: Warning[];
     };
@@ -812,8 +831,75 @@ declare namespace index {
   export { type index_TaskComparator as TaskComparator, index_byAssignee as byAssignee, index_byCompletionStatus as byCompletionStatus, index_byCreatedDate as byCreatedDate, index_byDueDate as byDueDate, index_byFile as byFile, index_byPerson as byPerson, index_byPriority as byPriority, index_byProject as byProject, index_combineComparators as combineComparators, index_reverse as reverse };
 }
 
+interface WarningFilterConfig {
+    enabled?: boolean | undefined;
+    rules?: Record<string, 'error' | 'warn' | 'info' | 'off'> | undefined;
+}
+/**
+ * Filter warnings based on configuration rules
+ *
+ * This function applies warning configuration rules to filter out disabled warnings
+ * and optionally all warnings if globally disabled.
+ *
+ * @param warnings - Array of warnings to filter
+ * @param config - Warning configuration with enabled flag and rule overrides
+ * @returns Filtered array of warnings
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   enabled: true,
+ *   rules: {
+ *     'missing-due-date': 'off',
+ *     'duplicate-todoist-id': 'error',
+ *   },
+ * };
+ *
+ * const filtered = filterWarnings(allWarnings, config);
+ * // Returns warnings except those with ruleId 'missing-due-date'
+ * ```
+ */
+declare function filterWarnings(warnings: Warning[], config?: WarningFilterConfig): Warning[];
+/**
+ * Group warnings by severity
+ *
+ * Useful for displaying warnings in order of importance or
+ * treating errors differently from warnings.
+ *
+ * @param warnings - Array of warnings to group
+ * @returns Object with warnings grouped by severity level
+ *
+ * @example
+ * ```typescript
+ * const grouped = groupWarningsBySeverity(warnings);
+ * console.log(`${grouped.error.length} errors`);
+ * console.log(`${grouped.warning.length} warnings`);
+ * console.log(`${grouped.info.length} info messages`);
+ * ```
+ */
+declare function groupWarningsBySeverity(warnings: Warning[]): {
+    error: Warning[];
+    warning: Warning[];
+    info: Warning[];
+};
+
+/**
+ * Parse a time string in HH:MM or H:MM format
+ *
+ * @param timeStr - Time string to parse (e.g., "17:00", "9:00")
+ * @returns Object with hours and minutes, or null if invalid
+ *
+ * @example
+ * parseTime("17:00") // => { hours: 17, minutes: 0 }
+ * parseTime("9:30") // => { hours: 9, minutes: 30 }
+ * parseTime("25:00") // => null (invalid hour)
+ */
+declare function parseTime(timeStr: string): {
+    hours: number;
+    minutes: number;
+} | null;
 /**
- * Parse an absolute date string in various formats
+ * Parse an absolute date string in various formats, with optional time
  *
  * Supported formats:
  *   - ISO: 2026-01-25
@@ -821,9 +907,14 @@ declare namespace index {
  *   - US full: 1/25/2026
  *
  * @param dateStr - Date string to parse
+ * @param timeStr - Optional time string in HH:MM or H:MM format
  * @returns Parsed Date object or null if invalid
+ *
+ * @example
+ * parseAbsoluteDate("2026-01-25") // => Date at midnight
+ * parseAbsoluteDate("2026-01-25", "17:00") // => Date at 5 PM
  */
-declare function parseAbsoluteDate(dateStr: string): Date | null;
+declare function parseAbsoluteDate(dateStr: string, timeStr?: string): Date | null;
 /**
  * Resolve a relative date keyword against a base date
  *
@@ -876,4 +967,4 @@ declare function extractDateFromHeading(line: string): Date | null;
  */
 declare function generateTaskId(file: string, line: number, text: string): string;
 
-export { ASSIGNEE, COMPLETED_DATE, DUE_DATE_ABSOLUTE, DUE_DATE_RELATIVE, DUE_DATE_SHORT, HEADING_DATE_ISO, HEADING_DATE_NATURAL, HEADING_DATE_SLASH, MarkdownScanner, PATTERNS, PRIORITY_HIGH, PRIORITY_NORMAL, PRIORITY_URGENT, type ParsingContext, type Priority, type ScanResult, TAG, TASK_CHECKBOX, TODOIST_ID, type Task, type TaskFilterCriteria, type UpdateTaskOptions, type Warning, type WriteTaskResult, addTask, cleanTaskText, extractAssignee, extractCompletedDate, extractDateFromHeading, extractDueDate, extractPersonFromFilename, extractPriority, extractProjectFromPath, extractTags, extractTodoistId, index$1 as filters, generateTaskId, parseAbsoluteDate, parseTask, resolveRelativeDate, index as sorting, updateTask, updateTasks };
+export { ASSIGNEE, COMPLETED_DATE, DUE_DATE_ABSOLUTE, DUE_DATE_RELATIVE, DUE_DATE_SHORT, HEADING_DATE_ISO, HEADING_DATE_NATURAL, HEADING_DATE_SLASH, MarkdownScanner, PATTERNS, PRIORITY_HIGH, PRIORITY_NORMAL, PRIORITY_URGENT, type ParsingContext, type Priority, type ScanResult, TAG, TASK_CHECKBOX, TODOIST_ID, type Task, type TaskFilterCriteria, type UpdateTaskOptions, type Warning, type WarningCode, type WarningFilterConfig, type WarningSeverity, type WriteTaskResult, addTask, cleanTaskText, extractAssignee, extractCompletedDate, extractDateFromHeading, extractDueDate, extractPersonFromFilename, extractPriority, extractProjectFromPath, extractTags, extractTodoistId, filterWarnings, index$1 as filters, generateTaskId, groupWarningsBySeverity, parseAbsoluteDate, parseTask, parseTime, resolveRelativeDate, index as sorting, updateTask, updateTasks };

package/dist/index.js

@@ -57,10 +57,13 @@ __export(index_exports, {
   extractProjectFromPath: () => extractProjectFromPath,
   extractTags: () => extractTags,
   extractTodoistId: () => extractTodoistId,
+  filterWarnings: () => filterWarnings,
   filters: () => filters_exports,
   generateTaskId: () => generateTaskId,
+  groupWarningsBySeverity: () => groupWarningsBySeverity,
   parseAbsoluteDate: () => parseAbsoluteDate,
   parseTask: () => parseTask,
+  parseTime: () => parseTime,
   resolveRelativeDate: () => resolveRelativeDate,
   sorting: () => sorting_exports,
   updateTask: () => updateTask,
@@ -74,7 +77,7 @@ var ASSIGNEE = /@([\w-]+)/;
 var PRIORITY_URGENT = /!!!/;
 var PRIORITY_HIGH = /!!/;
 var PRIORITY_NORMAL = /(?<!!)!(?!!)/;
-var DUE_DATE_ABSOLUTE = /\[due:\s*(\d{4}-\d{2}-\d{2})\s*\]/i;
+var DUE_DATE_ABSOLUTE = /\[due:\s*(\d{4}-\d{2}-\d{2})(?:\s+(\d{1,2}:\d{2}))?\s*\]/i;
 var DUE_DATE_RELATIVE = /\[due:\s*(tomorrow|today|next\s+week|next\s+month)\]/i;
 var DUE_DATE_SHORT = /\[due:\s*(\d{1,2}\/\d{1,2}(?:\/\d{2,4})?)\]/i;
 var TAG = /#([\w-]+)/g;
@@ -102,15 +105,34 @@ var PATTERNS = {
 
 // src/utils/dates.ts
 var import_date_fns = require("date-fns");
-function parseAbsoluteDate(dateStr) {
+function parseTime(timeStr) {
+  const match = timeStr.match(/^(\d{1,2}):(\d{2})$/);
+  if (!match || !match[1] || !match[2]) return null;
+  const hours = parseInt(match[1], 10);
+  const minutes = parseInt(match[2], 10);
+  if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59) {
+    return null;
+  }
+  return { hours, minutes };
+}
+function parseAbsoluteDate(dateStr, timeStr) {
   const referenceDate = /* @__PURE__ */ new Date();
   let date = (0, import_date_fns.parse)(dateStr, "yyyy-MM-dd", referenceDate);
-  if ((0, import_date_fns.isValid)(date)) return date;
-  date = (0, import_date_fns.parse)(dateStr, "M/d/yy", referenceDate);
-  if ((0, import_date_fns.isValid)(date)) return date;
-  date = (0, import_date_fns.parse)(dateStr, "M/d/yyyy", referenceDate);
-  if ((0, import_date_fns.isValid)(date)) return date;
-  return null;
+  if (!(0, import_date_fns.isValid)(date)) {
+    date = (0, import_date_fns.parse)(dateStr, "M/d/yy", referenceDate);
+  }
+  if (!(0, import_date_fns.isValid)(date)) {
+    date = (0, import_date_fns.parse)(dateStr, "M/d/yyyy", referenceDate);
+  }
+  if (!(0, import_date_fns.isValid)(date)) return null;
+  if (timeStr) {
+    const time = parseTime(timeStr);
+    if (time) {
+      date = (0, import_date_fns.setHours)(date, time.hours);
+      date = (0, import_date_fns.setMinutes)(date, time.minutes);
+    }
+  }
+  return date;
 }
 function resolveRelativeDate(relative, baseDate) {
   const normalized = relative.toLowerCase().trim();
@@ -202,12 +224,29 @@ function extractCompletedDate(text) {
 function extractDueDate(text, context) {
   const absoluteMatch = text.match(PATTERNS.DUE_DATE_ABSOLUTE);
   if (absoluteMatch?.[1]) {
-    const date = parseAbsoluteDate(absoluteMatch[1]);
+    const dateStr = absoluteMatch[1];
+    let timeStr = absoluteMatch[2];
+    if (!timeStr && context.defaultDueTime) {
+      if (context.defaultDueTime === "start" && context.workdayStartTime) {
+        timeStr = context.workdayStartTime;
+      } else if (context.defaultDueTime === "end" && context.workdayEndTime) {
+        timeStr = context.workdayEndTime;
+      }
+    }
+    const date = parseAbsoluteDate(dateStr, timeStr);
     return { date: date ?? void 0 };
   }
   const shortMatch = text.match(PATTERNS.DUE_DATE_SHORT);
   if (shortMatch?.[1]) {
-    const date = parseAbsoluteDate(shortMatch[1]);
+    let timeStr;
+    if (context.defaultDueTime) {
+      if (context.defaultDueTime === "start" && context.workdayStartTime) {
+        timeStr = context.workdayStartTime;
+      } else if (context.defaultDueTime === "end" && context.workdayEndTime) {
+        timeStr = context.workdayEndTime;
+      }
+    }
+    const date = parseAbsoluteDate(shortMatch[1], timeStr);
     return { date: date ?? void 0 };
   }
   const relativeMatch = text.match(PATTERNS.DUE_DATE_RELATIVE);
@@ -216,11 +255,15 @@ function extractDueDate(text, context) {
       return {
         date: void 0,
         warning: {
+          severity: "warning",
+          source: "md2do",
+          ruleId: "relative-date-no-context",
           file: "",
           // Will be filled in by caller
           line: 0,
           // Will be filled in by caller
           text: text.trim(),
+          message: "Relative due date without context date from heading. Add a heading with a date above this task.",
           reason: "Relative due date without context date from heading. Add a heading with a date above this task."
         }
       };
@@ -237,36 +280,52 @@ function parseTask(line, lineNumber, file, context) {
   const warnings = [];
   if (/^\s*[*+]\s+\[[ xX]\]/.test(line)) {
     warnings.push({
+      severity: "warning",
+      source: "md2do",
+      ruleId: "unsupported-bullet",
       file,
       line: lineNumber,
       text: line.trim(),
+      message: "Unsupported bullet marker (* or +). Use dash (-) for task lists.",
       reason: "Unsupported bullet marker (* or +). Use dash (-) for task lists."
     });
     return { task: null, warnings };
   }
   if (/^\s*-\s+\[[xX]\s+\]/.test(line) || /^\s*-\s+\[\s+[xX]\]/.test(line)) {
     warnings.push({
+      severity: "warning",
+      source: "md2do",
+      ruleId: "malformed-checkbox",
       file,
       line: lineNumber,
       text: line.trim(),
+      message: "Malformed checkbox with extra spaces. Use [x] or [ ] without extra spaces.",
       reason: "Malformed checkbox with extra spaces. Use [x] or [ ] without extra spaces."
     });
     return { task: null, warnings };
   }
   if (/^\s*-\s+\[[ xX]\][^\s]/.test(line)) {
     warnings.push({
+      severity: "warning",
+      source: "md2do",
+      ruleId: "missing-space-after",
       file,
       line: lineNumber,
       text: line.trim(),
+      message: 'Missing space after checkbox. Use "- [x] Task" format.',
       reason: 'Missing space after checkbox. Use "- [x] Task" format.'
     });
     return { task: null, warnings };
   }
   if (/^\s*-\[[ xX]\]/.test(line)) {
     warnings.push({
+      severity: "warning",
+      source: "md2do",
+      ruleId: "missing-space-before",
       file,
       line: lineNumber,
       text: line.trim(),
+      message: 'Missing space before checkbox. Use "- [x] Task" format.',
       reason: 'Missing space before checkbox. Use "- [x] Task" format.'
     });
     return { task: null, warnings };
@@ -292,17 +351,25 @@ function parseTask(line, lineNumber, file, context) {
   }
   if (!completed && !dueDateResult.date && !context.currentDate) {
     warnings.push({
+      severity: "info",
+      source: "md2do",
+      ruleId: "missing-due-date",
       file,
       line: lineNumber,
       text: fullText.trim(),
+      message: "Task has no due date. Add [due: YYYY-MM-DD] or place under a heading with a date.",
       reason: "Task has no due date. Add [due: YYYY-MM-DD] or place under a heading with a date."
     });
   }
   if (completed && !completedDate) {
     warnings.push({
+      severity: "info",
+      source: "md2do",
+      ruleId: "missing-completed-date",
       file,
       line: lineNumber,
       text: fullText.trim(),
+      message: "Completed task missing completion date. Add [completed: YYYY-MM-DD].",
       reason: "Completed task missing completion date. Add [completed: YYYY-MM-DD]."
     });
   }
@@ -346,9 +413,10 @@ var MarkdownScanner = class {
    *
    * @param filePath - Relative file path (for context extraction)
    * @param content - File content as string
+   * @param options - Optional scanner options including workday config
    * @returns Object containing tasks and warnings
    */
-  scanFile(filePath, content) {
+  scanFile(filePath, content, options) {
     const tasks = [];
     const warnings = [];
     const todoistIds = /* @__PURE__ */ new Map();
@@ -357,6 +425,15 @@ var MarkdownScanner = class {
     if (project !== void 0) context.project = project;
     const person = extractPersonFromFilename(filePath);
     if (person !== void 0) context.person = person;
+    if (options?.workdayStartTime) {
+      context.workdayStartTime = options.workdayStartTime;
+    }
+    if (options?.workdayEndTime) {
+      context.workdayEndTime = options.workdayEndTime;
+    }
+    if (options?.defaultDueTime) {
+      context.defaultDueTime = options.defaultDueTime;
+    }
     const lines = content.split("\n");
     for (let i = 0; i < lines.length; i++) {
       const line = lines[i];
@@ -375,9 +452,13 @@ var MarkdownScanner = class {
           const existing = todoistIds.get(result.task.todoistId);
           if (existing) {
             warnings.push({
+              severity: "error",
+              source: "md2do",
+              ruleId: "duplicate-todoist-id",
               file: filePath,
               line: lineNumber,
               text: result.task.text,
+              message: `Duplicate Todoist ID [todoist:${result.task.todoistId}]. Also found at ${existing.file}:${existing.line}.`,
               reason: `Duplicate Todoist ID [todoist:${result.task.todoistId}]. Also found at ${existing.file}:${existing.line}.`
             });
           } else {
@@ -416,9 +497,13 @@ var MarkdownScanner = class {
           const existing = todoistIds.get(task.todoistId);
           if (existing && existing.file !== task.file) {
             allWarnings.push({
+              severity: "error",
+              source: "md2do",
+              ruleId: "duplicate-todoist-id",
               file: task.file,
               line: task.line,
               text: task.text,
+              message: `Duplicate Todoist ID [todoist:${task.todoistId}] across files. Also found at ${existing.file}:${existing.line}.`,
               reason: `Duplicate Todoist ID [todoist:${task.todoistId}] across files. Also found at ${existing.file}:${existing.line}.`
             });
           } else if (!existing) {
@@ -867,6 +952,32 @@ function combineComparators(comparators) {
 function reverse(comparator) {
   return (a, b) => -comparator(a, b);
 }
+
+// src/warnings/filter.ts
+function filterWarnings(warnings, config = {}) {
+  if (config.enabled === false) {
+    return [];
+  }
+  if (!config.rules) {
+    return warnings;
+  }
+  return warnings.filter((warning) => {
+    const level = config.rules?.[warning.ruleId];
+    if (level === void 0) {
+      return true;
+    }
+    return level !== "off";
+  });
+}
+function groupWarningsBySeverity(warnings) {
+  return warnings.reduce(
+    (acc, warning) => {
+      acc[warning.severity].push(warning);
+      return acc;
+    },
+    { error: [], warning: [], info: [] }
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ASSIGNEE,
@@ -896,10 +1007,13 @@ function reverse(comparator) {
   extractProjectFromPath,
   extractTags,
   extractTodoistId,
+  filterWarnings,
   filters,
   generateTaskId,
+  groupWarningsBySeverity,
   parseAbsoluteDate,
   parseTask,
+  parseTime,
   resolveRelativeDate,
   sorting,
   updateTask,