@md2do/core 0.3.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @md2do/core
 
+## 0.5.1
+
+### Patch Changes
+
+- [#47](https://github.com/TeamNickHart/md2do/pull/47) [`ce65eaf`](https://github.com/TeamNickHart/md2do/commit/ce65eaf588c702254fb564f748a5841241cc5c97) Thanks [@nickhart](https://github.com/nickhart)! - Documentation improvements and standardization
+  - Standardized bracket syntax across all docs (use space after colon: `[due: ...]`)
+  - Marked semantic/relative dates as experimental with clear warnings
+  - Clarified Todoist sync is one-way (pull only), not bidirectional
+  - Documented context extraction limitation (must run from repo root)
+  - Updated code examples in READMEs to match best practices
+  - Removed unhelpful parentheses syntax warning
+
+## 0.4.0
+
+### Minor Changes
+
+- 8e0f80a: Add time support to due dates with workday configuration
+
+  **New Features:**
+  - Support optional time component in due dates: `[due: 2026-02-06 17:00]`
+  - Parse both 24-hour format times (H:MM and HH:MM)
+  - Added `parseTime()` utility for time validation
+  - New workday config schema with `startTime`, `endTime`, and `defaultDueTime`
+  - When no time specified in due date, applies default from config (defaults to 17:00 end of workday)
+  - Prevents "due 8 hours ago" issues for dates without explicit times
+
+  **Configuration:**
+
+  ```json
+  {
+    "workday": {
+      "startTime": "08:00",
+      "endTime": "17:00",
+      "defaultDueTime": "end"
+    }
+  }
+  ```
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -66,15 +66,15 @@ Parse markdown content and extract all tasks.
 import { parseMarkdown } from '@md2do/core';
 
 const content = `
-- [ ] Fix bug @nick !!! #backend (2026-01-25)
-- [x] Write docs @jane !! #docs
+- [ ] Fix bug @nick !!! #backend [due: 2026-01-25]
+- [x] Write docs @jane !! #docs [completed: 2026-01-20]
 `;
 
 const tasks = parseMarkdown(content, 'tasks.md');
 // [
 //   {
 //     id: 'abc123',
-//     text: 'Fix bug @nick !!! #backend (2026-01-25)',
+//     text: 'Fix bug',
 //     completed: false,
 //     file: 'tasks.md',
 //     line: 2,
@@ -96,7 +96,7 @@ Parse a single markdown task line.
 import { parseTaskLine } from '@md2do/core';
 
 const task = parseTaskLine(
-  '- [ ] Fix bug @nick !!! #backend (2026-01-25)',
+  '- [ ] Fix bug @nick !!! #backend [due: 2026-01-25]',
   5,
   'tasks.md',
 );
@@ -262,7 +262,7 @@ await updateTask({
   line: 5,
   updates: {
     completed: true,
-    text: 'Fix bug @nick !!! #backend (2026-01-25) [todoist:123456]',
+    text: 'Fix bug @nick !!! #backend [due: 2026-01-25] [todoist: 123456] [completed: 2026-01-26]',
   },
 });
 ```
@@ -501,7 +501,7 @@ pnpm test:coverage
 
 - **[@md2do/cli](../cli)** - Command-line interface (uses this package)
 - **[@md2do/config](../config)** - Configuration management
-- **[@md2do/todoist](../todoist)** - Todoist API integration (uses this package)
+- **[@md2do/todoist](../todoist)** - [Todoist](https://www.todoist.com) API integration (uses this package)
 - **[@md2do/mcp](../mcp)** - MCP server for AI integration (uses this package)
 
 ## Documentation

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[];
@@ -122,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): {
@@ -232,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;
 /**
@@ -400,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[];
     };
@@ -874,7 +884,22 @@ declare function groupWarningsBySeverity(warnings: Warning[]): {
 };
 
 /**
- * Parse an absolute date string in various formats
+ * 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, with optional time
  *
  * Supported formats:
  *   - ISO: 2026-01-25
@@ -882,9 +907,14 @@ declare function groupWarningsBySeverity(warnings: Warning[]): {
  *   - 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
  *
@@ -937,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 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, 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[];
@@ -122,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): {
@@ -232,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;
 /**
@@ -400,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[];
     };
@@ -874,7 +884,22 @@ declare function groupWarningsBySeverity(warnings: Warning[]): {
 };
 
 /**
- * Parse an absolute date string in various formats
+ * 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, with optional time
  *
  * Supported formats:
  *   - ISO: 2026-01-25
@@ -882,9 +907,14 @@ declare function groupWarningsBySeverity(warnings: Warning[]): {
  *   - 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
  *
@@ -937,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 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, 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

@@ -63,6 +63,7 @@ __export(index_exports, {
   groupWarningsBySeverity: () => groupWarningsBySeverity,
   parseAbsoluteDate: () => parseAbsoluteDate,
   parseTask: () => parseTask,
+  parseTime: () => parseTime,
   resolveRelativeDate: () => resolveRelativeDate,
   sorting: () => sorting_exports,
   updateTask: () => updateTask,
@@ -76,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;
@@ -104,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();
@@ -204,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);
@@ -376,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();
@@ -387,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];
@@ -966,6 +1013,7 @@ function groupWarningsBySeverity(warnings) {
   groupWarningsBySeverity,
   parseAbsoluteDate,
   parseTask,
+  parseTime,
   resolveRelativeDate,
   sorting,
   updateTask,

package/dist/index.mjs

@@ -10,7 +10,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;
@@ -43,17 +43,38 @@ import {
   addDays,
   addWeeks,
   addMonths,
-  startOfWeek
+  startOfWeek,
+  setHours,
+  setMinutes
 } from "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 = parse(dateStr, "yyyy-MM-dd", referenceDate);
-  if (isValid(date)) return date;
-  date = parse(dateStr, "M/d/yy", referenceDate);
-  if (isValid(date)) return date;
-  date = parse(dateStr, "M/d/yyyy", referenceDate);
-  if (isValid(date)) return date;
-  return null;
+  if (!isValid(date)) {
+    date = parse(dateStr, "M/d/yy", referenceDate);
+  }
+  if (!isValid(date)) {
+    date = parse(dateStr, "M/d/yyyy", referenceDate);
+  }
+  if (!isValid(date)) return null;
+  if (timeStr) {
+    const time = parseTime(timeStr);
+    if (time) {
+      date = setHours(date, time.hours);
+      date = setMinutes(date, time.minutes);
+    }
+  }
+  return date;
 }
 function resolveRelativeDate(relative, baseDate) {
   const normalized = relative.toLowerCase().trim();
@@ -145,12 +166,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);
@@ -317,9 +355,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();
@@ -328,6 +367,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];
@@ -906,6 +954,7 @@ export {
   groupWarningsBySeverity,
   parseAbsoluteDate,
   parseTask,
+  parseTime,
   resolveRelativeDate,
   sorting_exports as sorting,
   updateTask,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@md2do/core",
-  "version": "0.3.0",
+  "version": "0.5.1",
   "description": "Core parsing, filtering, scanning, and file writing for md2do",
   "keywords": [
     "markdown",

package/src/parser/index.ts

@@ -94,27 +94,50 @@ export 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
  */
 export function extractDueDate(
   text: string,
   context: ParsingContext,
 ): { date: Date | undefined; warning?: Warning } {
-  // Try absolute date first
+  // Try absolute date first (with optional time)
   const absoluteMatch = text.match(PATTERNS.DUE_DATE_ABSOLUTE);
   if (absoluteMatch?.[1]) {
-    const date = parseAbsoluteDate(absoluteMatch[1]);
+    const dateStr = absoluteMatch[1];
+    let timeStr = absoluteMatch[2]; // May be undefined
+
+    // If no time specified, apply default from workday config
+    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 ?? undefined };
   }
 
   // Try short format (M/D or M/D/YY)
   const shortMatch = text.match(PATTERNS.DUE_DATE_SHORT);
   if (shortMatch?.[1]) {
-    const date = parseAbsoluteDate(shortMatch[1]);
+    let timeStr: string | undefined;
+
+    // Apply default time from workday config
+    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 ?? undefined };
   }
 

package/src/parser/patterns.ts

@@ -63,17 +63,20 @@ export const PRIORITY_HIGH = /!!/;
 export const PRIORITY_NORMAL = /(?<!!)!(?!!)/;
 
 /**
- * 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)
  */
-export const DUE_DATE_ABSOLUTE = /\[due:\s*(\d{4}-\d{2}-\d{2})\s*\]/i;
+export const DUE_DATE_ABSOLUTE =
+  /\[due:\s*(\d{4}-\d{2}-\d{2})(?:\s+(\d{1,2}:\d{2}))?\s*\]/i;
 
 /**
  * Matches relative due date keywords