todo-agent 0.2.8__py3-none-any.whl → 0.2.9__py3-none-any.whl

todo_agent/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.2.8'
-__version_tuple__ = version_tuple = (0, 2, 8)
+__version__ = version = '0.2.9'
+__version_tuple__ = version_tuple = (0, 2, 9)
 
 __commit_id__ = commit_id = None

todo_agent/core/todo_manager.py

@@ -78,7 +78,9 @@ class TodoManager:
                     if interval < 1:
                         raise ValueError("Interval must be at least 1.")
                 except ValueError:
-                    raise ValueError(f"Invalid interval '{parts[2]}'. Must be a positive integer.")
+                    raise ValueError(
+                        f"Invalid interval '{parts[2]}'. Must be a positive integer."
+                    )
 
         # Build the full task description with priority, project, and context
         full_description = description
@@ -167,6 +169,114 @@ class TodoManager:
         result = self.todo_shell.remove_priority(task_number)
         return f"Removed priority from task {task_number}: {result}"
 
+    def set_due_date(self, task_number: int, due_date: str) -> str:
+        """
+        Set or update due date for a task by intelligently rewriting it.
+
+        Args:
+            task_number: The task number to modify
+            due_date: Due date in YYYY-MM-DD format, or empty string to remove due date
+
+        Returns:
+            Confirmation message with the updated task
+        """
+        # Validate due date format only if not empty
+        if due_date.strip():
+            try:
+                datetime.strptime(due_date, "%Y-%m-%d")
+            except ValueError:
+                raise ValueError(
+                    f"Invalid due date format '{due_date}'. Must be YYYY-MM-DD."
+                )
+
+        result = self.todo_shell.set_due_date(task_number, due_date)
+        if due_date.strip():
+            return f"Set due date {due_date} for task {task_number}: {result}"
+        else:
+            return f"Removed due date from task {task_number}: {result}"
+
+    def set_context(self, task_number: int, context: str) -> str:
+        """
+        Set or update context for a task by intelligently rewriting it.
+
+        Args:
+            task_number: The task number to modify
+            context: Context name (without @ symbol), or empty string to remove context
+
+        Returns:
+            Confirmation message with the updated task
+        """
+        # Validate context name if not empty
+        if context.strip():
+            # Remove any existing @ symbols to prevent duplication
+            clean_context = context.strip().lstrip("@")
+            if not clean_context:
+                raise ValueError(
+                    "Context name cannot be empty after removing @ symbol."
+                )
+
+        result = self.todo_shell.set_context(task_number, context)
+        if context.strip():
+            clean_context = context.strip().lstrip("@")
+            return f"Set context @{clean_context} for task {task_number}: {result}"
+        else:
+            return f"Removed context from task {task_number}: {result}"
+
+    def set_project(self, task_number: int, projects: list) -> str:
+        """
+        Set or update projects for a task by intelligently rewriting it.
+
+        Args:
+            task_number: The task number to modify
+            projects: List of project operations. Each item can be:
+                     - "project" (add project)
+                     - "-project" (remove project)
+                     - Empty string removes all projects
+
+        Returns:
+            Confirmation message with the updated task
+        """
+        # Validate project names if not empty
+        if projects:
+            for project in projects:
+                if project.strip() and not project.startswith("-"):
+                    # Remove any existing + symbols to prevent duplication
+                    clean_project = project.strip().lstrip("+")
+                    if not clean_project:
+                        raise ValueError(
+                            "Project name cannot be empty after removing + symbol."
+                        )
+                elif project.startswith("-"):
+                    clean_project = project[1:].strip().lstrip("+")
+                    if not clean_project:
+                        raise ValueError(
+                            "Project name cannot be empty after removing - and + symbols."
+                        )
+
+        result = self.todo_shell.set_project(task_number, projects)
+
+        if not projects:
+            return f"No project changes made to task {task_number}: {result}"
+        else:
+            # Build operation description
+            operations = []
+            for project in projects:
+                if not project.strip():
+                    # Empty string is a NOOP - skip
+                    continue
+                elif project.startswith("-"):
+                    clean_project = project[1:].strip().lstrip("+")
+                    operations.append(f"removed +{clean_project}")
+                else:
+                    clean_project = project.strip().lstrip("+")
+                    operations.append(f"added +{clean_project}")
+
+            if not operations:
+                return f"No project changes made to task {task_number}: {result}"
+            else:
+                operation_desc = ", ".join(operations)
+                return f"Updated projects for task {task_number} ({operation_desc}): {result}"
+
     def list_projects(self, **kwargs: Any) -> str:
         """List all available projects in todo.txt."""
         result = self.todo_shell.list_projects()

todo_agent/infrastructure/openrouter_client.py

@@ -72,26 +72,32 @@ class OpenRouterClient(LLMClient):
             f"Token usage - Prompt: {prompt_tokens}, Completion: {completion_tokens}, Total: {total_tokens}"
         )
 
-        # Log tool call details if present
-        if response.get("choices"):
-            choice = response["choices"][0]
-            if "message" in choice and "tool_calls" in choice["message"]:
-                tool_calls = choice["message"]["tool_calls"]
-                self.logger.info(f"Response contains {len(tool_calls)} tool calls")
-
-                # Log thinking content (response body) if present
-                content = choice["message"].get("content", "")
-                if content and content.strip():
-                    self.logger.info(f"LLM thinking before tool calls: {content}")
-
-                for i, tool_call in enumerate(tool_calls):
-                    tool_name = tool_call.get("function", {}).get("name", "unknown")
-                    self.logger.info(f"  Tool call {i + 1}: {tool_name}")
-            elif "message" in choice and "content" in choice["message"]:
-                content = choice["message"]["content"]
-                self.logger.debug(
-                    f"Response contains content: {content[:100]}{'...' if len(content) > 100 else ''}"
-                )
+        # Extract and log choice details
+        choices = response.get("choices", [])
+        if not choices:
+            return
+            
+        choice = choices[0]
+        message = choice.get("message", {})
+        
+        # Always log reasoning and content if present
+        reasoning = message.get("reasoning", "")
+        if reasoning:
+            self.logger.info(f"LLM reasoning: {reasoning}")
+            
+        content = message.get("content", "")
+        if content:
+            self.logger.info(f"LLM content: {content}")
+        
+        # Handle tool calls
+        tool_calls = message.get("tool_calls", [])
+        if tool_calls:
+            self.logger.info(f"Response contains {len(tool_calls)} tool calls")
+            
+            # Log each tool call
+            for i, tool_call in enumerate(tool_calls, 1):
+                tool_name = tool_call.get("function", {}).get("name", "unknown")
+                self.logger.info(f"  Tool call {i}: {tool_name}")
 
         self.logger.debug(f"Raw response: {json.dumps(response, indent=2)}")
 

todo_agent/infrastructure/prompts/system_prompt.txt

@@ -10,7 +10,7 @@ CORE PRINCIPLES
 - Present in natural language with strategic insights, never raw todo.txt format
 - Include concise reasoning for all decisions and suggestions
 - Make confident and specific recommendations
-- Lead with the answer then follow with minimal supporting information afterward
+- Lead with the answer or description of actions then follow with minimal supporting information afterward
 - Prose is always preferred to formatted lists or formatting in general
 
 OUTPUT FORMATTING
@@ -66,17 +66,20 @@ Gate 3: Execution Protocols
 Task Creation Protocol:
 DISCOVER: Current tasks + completed tasks
 ANALYZE: Semantic duplicates? (similar intent/keywords)
-INFER: High confidence context/timing from:
+INFER: Context/timing from:
   - Explicit temporal: "tomorrow", "by Friday" 
   - Task nature: bills->payment cycles, work->business hours
   - Existing patterns: match similar task contexts
   - Calendar context: work days, weekends, holidays
-  - ACTIVATE Completion Date Intelligence Engine for date inference
+  - Project inference: ALWAYS infer and add unambiguous +project tags
+  - Context inference: ALWAYS infer and add unambiguous @context tag
+  - Duration inference: ALWAYS infer and add appropriate duration: tag
+  - ACTIVATE Completion Date Intelligence Engine for due date inference
 DECIDE:
   - Clear intent + high confidence -> Create immediately
   - Semantic duplicate found -> "Similar task exists: [task]. Add anyway or modify existing?"
   - Ambiguous context -> Ask specific clarification
-  - Low confidence inference -> Verify before acting
+  - Low confidence inference -> Ask before acting
 
 Completion Date Intelligence Engine
 When inferring convenient and realistic completion dates:
@@ -124,7 +127,7 @@ MATCH:
   - Single clear match -> Complete immediately + suggest next steps
   - Multiple candidates -> Show numbered options with context
   - Fuzzy match -> "Did you mean: [closest match]?"
-  - No match -> "No matching active tasks found. Recent completions?"
+  - No match -> "No matching active tasks found. Relax filters? Recent completions?"
 
 STRATEGIC INTELLIGENCE MODULES
 
@@ -269,6 +272,56 @@ When encountering "rec:" syntax in task descriptions or the user indicates repea
 - Preserve all task metadata (priority, project, context) in new instances
 - Handle edge cases: leap years, month boundaries, weekday patterns
 
+DURATION INTELLIGENCE ENGINE
+When encountering duration: syntax in task descriptions:
+- Parse duration patterns: duration:15m, duration:2h, duration:1d
+- Apply reasonable defaults for tasks without duration tags
+- Validate duration ranges (1m to 8h for most tasks)
+- Use duration for task organization and prioritization
+
+AUTOMATIC PROJECT AND CONTEXT INFERENCE:
+When creating tasks, ALWAYS infer and add unambiguous project and context tags based on:
+- Task description keywords and semantic patterns
+- Existing project and context usage patterns in current and completed tasks
+- Task nature and typical locations/contexts
+- User's historical task organization
+
+Project Inference Patterns:
+- Health/medical: +health (dentist, doctor, pharmacy, exercise, vitamins)
+- Work/business: +work (meetings, reports, presentations, emails, calls)
+- Financial: +bills (payments, invoices, banking, taxes, expenses)
+- Home maintenance: +chores (cleaning, repairs, maintenance, organization)
+- Personal development: +learning (reading, courses, skills, education)
+- Social: +social (calls, meetings, events, family, friends)
+- Errands: +errands (shopping, appointments, deliveries, services)
+- Work in Progress: +wip (work tasks, projects, tasks pending dependencies)
+
+Context Inference Patterns:
+- @phone: calls, appointments, customer service, scheduling
+- @computer: work, research, writing, online tasks, emails
+- @office: work meetings, in-person work, office tasks
+- @home: chores, maintenance, personal tasks, relaxation
+- @errands: shopping, appointments, deliveries, services
+- @grocery: food shopping, household supplies
+- @post-office: mail, packages, shipping, government services
+
+AUTOMATIC DURATION INFERENCE:
+When creating tasks, ALWAYS infer and add appropriate duration tags based on:
+- Task description keywords and context
+- Project and context patterns
+- Task complexity and scope
+- User's existing task patterns
+
+Default Duration Patterns:
+- Quick tasks: duration:15m (calls, emails, simple errands, quick checks)
+- Medium tasks: duration:1h (meetings, focused work, moderate chores)
+- Long tasks: duration:2h (deep work, complex projects, major errands)
+- Context-specific defaults:
+  - @phone tasks: duration:15m (calls, appointments)
+  - @computer tasks: duration:1h (work, research, writing)
+  - @errands tasks: duration:45m (shopping, appointments)
+  - @home tasks: duration:30m (chores, maintenance)
+
 Recurring Task Completion Protocol:
 1. Detect when user completes a recurring task
 2. Find the original recurring task in active tasks
@@ -299,6 +352,7 @@ CORE BEHAVIORAL RULES (Hierarchical)
 TODO.TXT FORMAT COMPLIANCE
 Priority: (A) (B) (C) | Projects: +name | Contexts: @location
 Due dates: due:YYYY-MM-DD | Completion: x YYYY-MM-DD description
+Duration: duration:XX (e.g., duration:30m, duration:2h, duration:1d)
 Recurring tasks: rec:frequency[:interval] (e.g., rec:daily, rec:weekly:2, rec:monthly)
 Single symbols only (never ++project or @@context)
 Do not duplicate elements such as +context or (PRIORITY) within a single task description.
@@ -306,6 +360,31 @@ Do not duplicate elements such as +context or (PRIORITY) within a single task de
 Example recurring task format:
 (A) Take vitamins +health @home rec:daily due:2025-01-15
 
+Example task with duration:
+(A) Review quarterly report +work @office duration:2h due:2025-01-20
+
+TOOL SELECTION STRATEGY
+
+CRITICAL TOOL CHOICE GUIDELINES:
+1. **For Adding Project Tags (+project)**: ALWAYS use set_project()
+2. **For Adding Context Tags (@context)**: ALWAYS use set_context()
+3. **For Adding Due Dates** (due:YYYY-MM-DD): ALWAYS use set_due_date()
+4. **For Task Discovery**: Use list_tasks() once with appropriate filters, not multiple calls
+5. **For Task Completion**: Use list_tasks() + list_completed_tasks() + complete_task() sequence
+6. **For Task Addition**: Use list_tasks() + list_completed_tasks() + add_task() sequence
+
+EXAMPLE CORRECT WORKFLOW:
+User: "Add exercise and outdoors projects to mow lawn"
+CORRECT: list_tasks() → set_project(task_number=15, projects=["exercise", "outdoors"])
+INCORRECT: list_tasks(filter="+exercise") → list_tasks(filter="+outdoors") → append_to_task()
+
+EFFICIENT DISCOVERY PRINCIPLES:
+- Use list_tasks() once with NO filters to understand the full context
+- Use list_completed_tasks() once with NO filters to understand historical patterns
+- Avoid multiple discovery calls unless absolutely necessary for disambiguation
+- When adding tags/projects/contexts, first discover the target task, then use the appropriate set_* tool
+- Prefer single comprehensive discovery over multiple targeted searches
+
 TOOL CALL FORMAT
 
 IMPORTANT: Include concise reasoning in the content field when using tools. 

todo_agent/infrastructure/todo_shell.py

@@ -142,12 +142,335 @@ class TodoShell:
         """Archive completed tasks."""
         return self.execute(["todo.sh", "-f", "archive"])
 
-    def deduplicate(self) -> str:
-        """Remove duplicate tasks."""
-        try:
-            return self.execute(["todo.sh", "-f", "deduplicate"])
-        except TodoShellError as e:
-            # Handle the case where no duplicates are found (not really an error)
-            if "No duplicate tasks found" in str(e):
-                return "No duplicate tasks found"
-            raise
+    def set_due_date(self, task_number: int, due_date: str) -> str:
+        """
+        Set or update due date for a task by intelligently rewriting it.
+
+        Args:
+            task_number: The task number to modify
+            due_date: Due date in YYYY-MM-DD format, or empty string to remove due date
+
+        Returns:
+            The updated task description
+        """
+        # First, get the current task to parse its components
+        tasks_output = self.list_tasks()
+        task_lines = tasks_output.strip().split("\n")
+
+        # Find the task by its actual number (not array index)
+        current_task = None
+        for line in task_lines:
+            if line.strip():
+                # Extract task number from the beginning of the line (handling ANSI codes)
+                extracted_number = self._extract_task_number(line)
+                if extracted_number == task_number:
+                    current_task = line
+                    break
+
+        if not current_task:
+            raise TodoShellError(f"Task number {task_number} not found")
+
+        # Parse the current task components
+        components = self._parse_task_components(current_task)
+
+        # Update the due date (empty string removes it)
+        if due_date.strip():
+            components["due"] = due_date
+        else:
+            components["due"] = None
+
+        # Reconstruct the task
+        new_description = self._reconstruct_task(components)
+
+        # Replace the task with the new description
+        return self.replace(task_number, new_description)
+
+    def set_context(self, task_number: int, context: str) -> str:
+        """
+        Set or update context for a task by intelligently rewriting it.
+
+        Args:
+            task_number: The task number to modify
+            context: Context name (without @ symbol), or empty string to remove context
+
+        Returns:
+            The updated task description
+        """
+        # First, get the current task to parse its components
+        tasks_output = self.list_tasks()
+        task_lines = tasks_output.strip().split("\n")
+
+        # Find the task by its actual number (not array index)
+        current_task = None
+        for line in task_lines:
+            if line.strip():
+                # Extract task number from the beginning of the line (handling ANSI codes)
+                extracted_number = self._extract_task_number(line)
+                if extracted_number == task_number:
+                    current_task = line
+                    break
+
+        if not current_task:
+            raise TodoShellError(f"Task number {task_number} not found")
+
+        # Parse the current task components
+        components = self._parse_task_components(current_task)
+
+        # Update the context (empty string removes it)
+        if context.strip():
+            # Remove any existing @ symbols to prevent duplication
+            clean_context = context.strip().lstrip("@")
+            if not clean_context:
+                raise TodoShellError(
+                    "Context name cannot be empty after removing @ symbol."
+                )
+            context_tag = f"@{clean_context}"
+            # Only add if not already present (deduplication)
+            if context_tag not in components["contexts"]:
+                components["contexts"] = [context_tag]
+            else:
+                # Context already exists, no change needed
+                return self._reconstruct_task(components)
+        else:
+            components["contexts"] = []
+
+        # Reconstruct the task
+        new_description = self._reconstruct_task(components)
+
+        # Replace the task with the new description
+        return self.replace(task_number, new_description)
+
+    def _extract_task_number(self, line: str) -> Optional[int]:
+        """
+        Extract task number from a line that may contain ANSI color codes.
+        
+        Args:
+            line: Task line that may contain ANSI color codes
+            
+        Returns:
+            Task number if found, None otherwise
+        """
+        from rich.text import Text
+        
+        # Use rich to properly handle ANSI color codes
+        text = Text.from_ansi(line)
+        clean_line = text.plain
+        
+        # Split on first space and check if first part is a number
+        parts = clean_line.split(" ", 1)
+        if parts and parts[0].isdigit():
+            return int(parts[0])
+        return None
+
+    def set_project(self, task_number: int, projects: list) -> str:
+        """
+        Set or update projects for a task by intelligently rewriting it.
+
+        Args:
+            task_number: The task number to modify
+            projects: List of project operations. Each item can be:
+                     - "project" (add project)
+                     - "-project" (remove project)
+                     - Empty string is a NOOP
+
+        Returns:
+            The updated task description
+        """
+        # First, get the current task to parse its components
+        tasks_output = self.list_tasks()
+        task_lines = tasks_output.strip().split("\n")
+
+        # Find the task by its actual number (not array index)
+        current_task = None
+        for line in task_lines:
+            if line.strip():
+                # Extract task number from the beginning of the line (handling ANSI codes)
+                extracted_number = self._extract_task_number(line)
+                if extracted_number == task_number:
+                    current_task = line
+                    break
+
+        if not current_task:
+            raise TodoShellError(f"Task number {task_number} not found")
+
+        # Parse the current task components
+        components = self._parse_task_components(current_task)
+
+        # Store original projects to check if any changes were made
+        original_projects = components["projects"].copy()
+
+        # Handle project operations
+        if not projects:
+            # Empty list is a NOOP - return original task unchanged
+            return self._reconstruct_task(components)
+        else:
+            # Process each project operation
+            for project in projects:
+                if not project.strip():
+                    # Empty string is a NOOP - skip this operation
+                    continue
+                elif project.startswith("-"):
+                    # Remove project
+                    clean_project = project[1:].strip().lstrip("+")
+                    if not clean_project:
+                        raise TodoShellError(
+                            "Project name cannot be empty after removing - and + symbols."
+                        )
+                    # Remove the project if it exists (with or without + prefix)
+                    project_to_remove = f"+{clean_project}"
+                    components["projects"] = [
+                        p for p in components["projects"] 
+                        if p != project_to_remove and p != clean_project
+                    ]
+                else:
+                    # Add project
+                    clean_project = project.strip().lstrip("+")
+                    if not clean_project:
+                        raise TodoShellError(
+                            "Project name cannot be empty after removing + symbol."
+                        )
+                    project_tag = f"+{clean_project}"
+                    # Only add if not already present (deduplication)
+                    if project_tag not in components["projects"]:
+                        components["projects"].append(project_tag)
+
+        # Check if any changes were actually made
+        if components["projects"] == original_projects:
+            # No changes made - return original task unchanged
+            return self._reconstruct_task(components)
+
+        # Reconstruct the task
+        new_description = self._reconstruct_task(components)
+
+        # Replace the task with the new description
+        return self.replace(task_number, new_description)
+
+    def _parse_task_components(self, task_line: str) -> dict:
+        """
+        Parse a todo.txt task line into its components.
+
+        Args:
+            task_line: Raw task line from todo.txt
+
+        Returns:
+            Dictionary with parsed components
+        """
+        # Remove ANSI color codes first using rich
+        from rich.text import Text
+        text = Text.from_ansi(task_line)
+        task_line = text.plain
+        
+        # Remove task number prefix if present (e.g., "1 " or "1. ")
+        # First try the format without dot (standard todo.sh format)
+        if " " in task_line and task_line.split(" ")[0].isdigit():
+            task_line = task_line.split(" ", 1)[1]
+        # Fallback to dot format if present
+        elif ". " in task_line:
+            task_line = task_line.split(". ", 1)[1]
+
+        components = {
+            "priority": None,
+            "description": "",
+            "projects": [],
+            "contexts": [],
+            "due": None,
+            "recurring": None,
+            "other_tags": [],
+        }
+
+        # Use sets to automatically deduplicate projects and contexts
+        projects_set = set()
+        contexts_set = set()
+        other_tags_set = set()
+
+        # Split by spaces to process each word
+        words = task_line.split()
+
+        for word in words:
+            # Priority: (A), (B), etc.
+            if word.startswith("(") and word.endswith(")") and len(word) == 3:
+                priority = word[1]
+                if priority.isalpha() and priority.isupper():
+                    components["priority"] = priority
+                    continue
+
+            # Projects: +project
+            if word.startswith("+"):
+                projects_set.add(word)
+                continue
+
+            # Contexts: @context
+            if word.startswith("@"):
+                contexts_set.add(word)
+                continue
+
+            # Due date: due:YYYY-MM-DD
+            if word.startswith("due:"):
+                components["due"] = word[4:]  # Remove 'due:' prefix
+                continue
+
+            # Recurring: rec:frequency[:interval]
+            if word.startswith("rec:"):
+                components["recurring"] = word
+                continue
+
+            # Other tags (like custom tags)
+            if (
+                ":" in word
+                and not word.startswith("due:")
+                and not word.startswith("rec:")
+            ):
+                other_tags_set.add(word)
+                continue
+
+            # Regular description text
+            if components["description"]:
+                components["description"] += " " + word
+            else:
+                components["description"] = word
+
+        # Convert sets back to sorted lists for consistent ordering
+        components["projects"] = sorted(list(projects_set))
+        components["contexts"] = sorted(list(contexts_set))
+        components["other_tags"] = sorted(list(other_tags_set))
+
+        return components
+
+    def _reconstruct_task(self, components: dict) -> str:
+        """
+        Reconstruct a task description from parsed components.
+
+        Args:
+            components: Dictionary with task components
+
+        Returns:
+            Reconstructed task description
+        """
+        parts = []
+
+        # Add priority if present
+        if components["priority"]:
+            parts.append(f"({components['priority']})")
+
+        # Add description
+        if components["description"]:
+            parts.append(components["description"])
+
+        # Add projects
+        parts.extend(components["projects"])
+
+        # Add contexts
+        parts.extend(components["contexts"])
+
+        # Add due date
+        if components["due"]:
+            parts.append(f"due:{components['due']}")
+
+        # Add recurring pattern
+        if components["recurring"]:
+            parts.append(components["recurring"])
+
+        # Add other tags
+        parts.extend(components["other_tags"])
+
+        return " ".join(parts)

todo_agent/interface/cli.py

@@ -166,7 +166,7 @@ class CLI:
         while True:
             try:
                 # Print prompt character on separate line to prevent deletion
-                self.console.print("\n[bold cyan]▶[/bold cyan]", end="\n")
+                self.console.print("\n[bold cyan]▶[/bold cyan]", end=" ")
                 user_input = self.console.input().strip()
 
                 if user_input.lower() in ["quit", "exit", "q"]:
@@ -244,8 +244,10 @@ class CLI:
                 # Format the response and create a panel
                 formatted_response = ResponseFormatter.format_response(response)
 
-                # Get memory usage
-                memory_usage = self._get_memory_usage()
+                # Get memory usage 
+                # DISABLED FOR NOW
+                # memory_usage = self._get_memory_usage()
+                memory_usage = None 
 
                 # Create response panel with memory usage
                 response_panel = PanelFormatter.create_response_panel(

todo_agent/interface/tools.py

@@ -10,7 +10,7 @@ Discovery Tools (Call FIRST):
 - list_completed_tasks(filter?, project?, context?, text_search?, date_from?, date_to?) - List completed tasks with optional filtering
 
 Task Management Tools:
-- add_task(description, priority?, project?, context?, due?) - Add new task to todo.txt
+- add_task(description, priority?, project?, context?, due?, recurring?) - Add new task to todo.txt
 - complete_task(task_number) - Mark task as complete by line number
 - replace_task(task_number, new_description) - Replace entire task content
 - append_to_task(task_number, text) - Add text to end of existing task
@@ -20,12 +20,16 @@ Task Management Tools:
 Priority Management Tools:
 - set_priority(task_number, priority) - Set or change task priority (A-Z)
 - remove_priority(task_number) - Remove priority from task
+- set_due_date(task_number, due_date) - Set or update due date for a task by intelligently rewriting it (use empty string to remove due date)
+- set_context(task_number, context) - Set or update context for a task by intelligently rewriting it (use empty string to remove context)
+- set_project(task_number, projects) - Set or update projects for a task by intelligently rewriting it (handles array of projects with add/remove operations)
 
 Utility Tools:
 - get_overview() - Show task statistics and summary
 - move_task(task_number, destination, source?) - Move task between files
 - archive_tasks() - Archive completed tasks from todo.txt to done.txt
 - get_calendar(month, year) - Get calendar for specific month and year
+- parse_date(date_expression) - Convert natural language date expressions to YYYY-MM-DD format
 """
 
 import subprocess
@@ -296,7 +300,11 @@ class ToolCallHandler:
                     "name": "append_to_task",
                     "description": (
                         "Add text to the end of an existing task. Use this when user wants "
-                        "to add additional information to a task without replacing it entirely."
+                        "to add additional information to a task without replacing it entirely. "
+                        "CRITICAL: DO NOT use this for adding project tags (+project) or context tags (@context) - "
+                        "use set_project() or set_context() instead. "
+                        "DO NOT use this for adding due dates - use set_due_date() instead. "
+                        "This tool is for adding descriptive text, notes, or comments to tasks."
                     ),
                     "parameters": {
                         "type": "object",
@@ -411,6 +419,97 @@ class ToolCallHandler:
                     },
                 },
             },
+            {
+                "type": "function",
+                "function": {
+                    "name": "set_due_date",
+                    "description": (
+                        "Set or update the due date for a task by intelligently rewriting it. "
+                        "This preserves all existing task components (priority, projects, contexts, etc.) "
+                        "while updating or adding the due date. Use empty string to remove the due date. "
+                        "IMPORTANT: Use list_tasks() first "
+                        "to find the correct task number if user doesn't specify it. "
+                        "Use parse_date() tool to convert natural language expressions like 'tomorrow', "
+                        "'next week', 'by Friday' to YYYY-MM-DD format."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the task to modify (required)",
+                            },
+                            "due_date": {
+                                "type": "string",
+                                "description": "Due date in YYYY-MM-DD format, or empty string to remove due date (required). Use parse_date() tool to convert natural language expressions.",
+                            },
+                        },
+                        "required": ["task_number", "due_date"],
+                    },
+                },
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "set_context",
+                    "description": (
+                        "Set or update the context for a task by intelligently rewriting it. "
+                        "This preserves all existing task components (priority, projects, due date, etc.) "
+                        "while updating or adding the context. Use empty string to remove the context. "
+                        "PREFERRED METHOD: Use this instead of append_to_task() when adding context tags (@context). "
+                        "This tool properly manages context organization and prevents formatting issues. "
+                        "IMPORTANT: Use list_tasks() first "
+                        "to find the correct task number if user doesn't specify it."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the task to modify (required)",
+                            },
+                            "context": {
+                                "type": "string",
+                                "description": "Context to set for the task (required). Use empty string to remove context.",
+                            },
+                        },
+                        "required": ["task_number", "context"],
+                    },
+                },
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "set_project",
+                    "description": (
+                        "Set or update projects for a task by intelligently rewriting it. "
+                        "This preserves all existing task components and manages projects intelligently. "
+                        "Supports multiple projects, prevents duplicates, and groups them together. "
+                        "Empty array or empty strings are NOOPs (no changes). "
+                        "Use '-project' syntax to remove specific projects. "
+                        "PREFERRED METHOD: Use this instead of append_to_task() when adding project tags (+project). "
+                        "This tool properly manages project organization and prevents formatting issues. "
+                        "IMPORTANT: Use list_tasks() first "
+                        "to find the correct task number if user doesn't specify it. "
+                        "Project names should be provided without the + symbol (e.g., 'work' not '+work')."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the task to modify (required)",
+                            },
+                            "projects": {
+                                "type": "array",
+                                "items": {"type": "string"},
+                                "description": "Array of project operations. Each item can be: project name (add), '-project' (remove), or empty string (remove all) (required).",
+                            },
+                        },
+                        "required": ["task_number", "projects"],
+                    },
+                },
+            },
             {
                 "type": "function",
                 "function": {
@@ -724,10 +823,12 @@ class ToolCallHandler:
             "delete_task": self.todo_manager.delete_task,
             "set_priority": self.todo_manager.set_priority,
             "remove_priority": self.todo_manager.remove_priority,
+            "set_due_date": self.todo_manager.set_due_date,
+            "set_context": self.todo_manager.set_context,
+            "set_project": self.todo_manager.set_project,
             "get_overview": self.todo_manager.get_overview,
             "move_task": self.todo_manager.move_task,
             "archive_tasks": self.todo_manager.archive_tasks,
-            "deduplicate_tasks": self.todo_manager.deduplicate_tasks,
             "parse_date": self._parse_date,
             "get_calendar": self._get_calendar,
         }

{todo_agent-0.2.8.dist-info → todo_agent-0.2.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: todo-agent
-Version: 0.2.8
+Version: 0.2.9
 Summary: A natural language interface for todo.sh task management
 Author: codeprimate
 Maintainer: codeprimate
@@ -51,7 +51,7 @@ A natural language interface for [todo.sh](https://github.com/todotxt/todo.txt-c
 
 ## What it does
 
-Transform natural language into todo.sh commands:
+Transform natural language into todo.sh commands with intelligent task management:
 
 ```bash
 # Use interactively
@@ -62,91 +62,43 @@ todo-agent "add buy groceries to shopping list"
 todo-agent "show my work tasks"
 ```
 
-## Quick Start
-
-### 1. Install
+## Why Todo Agent?
 
-#### Prerequisites
+**Speak naturally** instead of memorizing commands. Todo Agent understands "add dentist appointment next Monday" and automatically sets the right date, project, and context.
 
-**Install todo.sh (required)**
+**Get intelligent insights** beyond basic task lists. It organizes tasks strategically, suggests priorities, and recommends optimal timing based on your patterns.
 
-todo.sh is the underlying task management system that todo-agent interfaces with.
+**Work smarter** with automatic duplicate detection, recurring task handling, and calendar-aware scheduling.
 
-**macOS:**
-```bash
-# Using Homebrew
-brew install todo-txt
-# Or using MacPorts
-sudo port install todo-txt
-```
+**Choose your privacy** - use cloud AI (OpenRouter) or run locally (Ollama).
 
-**Linux:**
-```bash
-# Ubuntu/Debian
-sudo apt-get install todo-txt-cli
-# CentOS/RHEL/Fedora
-sudo yum install todo-txt-cli
-# or
-sudo dnf install todo-txt-cli
-# Arch Linux
-sudo pacman -S todo-txt-cli
-```
+## Quick Start
 
-**Windows:**
-```bash
-# Using Chocolatey
-choco install todo-txt-cli
-# Using Scoop
-scoop install todo-txt-cli
-```
+### 1. Install
 
-**From source:**
-```bash
-git clone https://github.com/todotxt/todo.txt-cli.git
-cd todo.txt-cli
-make
-sudo make install
-```
+#### Install todo.sh (required)
 
-#### Configure todo.sh
+**macOS:** `brew install todo-txt`  
+**Linux:** `sudo apt-get install todo-txt-cli` (Ubuntu/Debian) or `sudo pacman -S todo-txt-cli` (Arch)  
+**Windows:** `choco install todo-txt-cli` (Chocolatey) or `scoop install todo-txt-cli` (Scoop)
 
-After installing todo.sh, you need to set up your todo.txt repository:
+#### Set up todo.sh
 
 ```bash
-# Create a directory for your todo files
-mkdir ~/todo
-cd ~/todo
-
-# Initialize todo.sh (this creates the initial todo.txt file)
+# Create and initialize your todo directory
+mkdir ~/todo && cd ~/todo
 todo.sh init
 
-# Verify installation
-todo.sh version
-```
-
-**Important:** Set the `TODO_DIR` environment variable to point to your todo.txt repository:
-
-```bash
+# Add to your shell profile (.bashrc, .zshrc, etc.)
 export TODO_DIR="$HOME/todo"
 ```
 
-You can add this to your shell profile (`.bashrc`, `.zshrc`, etc.) to make it permanent.
-
 #### Install todo-agent
 
 ```bash
-# Clone and install from source
 git clone https://github.com/codeprimate/todo-agent.git
 cd todo_agent
-
-# Option 1: Install built package locally
 make install
-
-# Option 2: Install in development mode with dev dependencies
-make install-dev
-
-# Option 3: Install in development mode (basic)
-pip install -e .
 ```
 
 ### 2. Set up your LLM provider
@@ -200,6 +152,22 @@ todo-agent "show completed tasks"
 todo-agent "list my contexts"
 ```
 
+### Strategic Planning
+```bash
+todo-agent "what should I do next?"
+todo-agent "organize my tasks by priority"
+todo-agent "show me everything due this week"
+todo-agent "what tasks are blocking other work?"
+```
+
+### Natural Language Intelligence
+```bash
+todo-agent "add dentist appointment next Monday"
+todo-agent "set up recurring daily vitamin reminder"
+todo-agent "move all completed tasks to archive"
+todo-agent "show me tasks I can do from home"
+```
+
 ## Configuration
 
 

{todo_agent-0.2.8.dist-info → todo_agent-0.2.9.dist-info}/RECORD

@@ -1,10 +1,10 @@
 todo_agent/__init__.py,sha256=RUowhd14r3tqB_7rl83unGV8oBjra3UOIl7jix-33fk,254
-todo_agent/_version.py,sha256=NCr4lkV1m1Jmisv_F-sazmV2gGdDIaVwqLyPwmjayqM,704
+todo_agent/_version.py,sha256=051on7ZmwGNyKvbO1AXKoElw7RjLuRmeJqVOApytNd4,704
 todo_agent/main.py,sha256=-ryhMm4c4sz4e4anXI8B-CYnpEh5HIkmnYcnGxcWHDk,1628
 todo_agent/core/__init__.py,sha256=QAZ4it63pXv5-DxtNcuSAmg7ZnCY5ackI5yycvKHr9I,365
 todo_agent/core/conversation_manager.py,sha256=nRFcDMqZtumVipggzVe94Hwz9HDbc2CrTssk_HImwEI,13548
 todo_agent/core/exceptions.py,sha256=cPvvkIbKdI7l51wC7cE-ZxUi54P3nf2m7x2lMNMRFYM,399
-todo_agent/core/todo_manager.py,sha256=ZiCXfgS4kor3tdojwEKwD2G1lX-W9XuaoYvER82PHNM,10438
+todo_agent/core/todo_manager.py,sha256=wT82Wpwby6LR9VacLXhdDiGiMNoQbovXmU9943e5X2M,14908
 todo_agent/infrastructure/__init__.py,sha256=SGbHXgzq6U1DMgOfWPMsWEK99zjPSF-6gzy7xqc5fsI,284
 todo_agent/infrastructure/calendar_utils.py,sha256=HmF0ykXF_6GbdoJvZLIv6fKwT6ipixoywdTMkIXmkGU,1871
 todo_agent/infrastructure/config.py,sha256=zyp6qOlg1nN_awphivlgGNBE6fL0Hf66YgvWxR8ldyQ,2117
@@ -13,17 +13,17 @@ todo_agent/infrastructure/llm_client.py,sha256=ZoObyqaRP6i_eqGYGfJWGeWTJ-VNxpY70
 todo_agent/infrastructure/llm_client_factory.py,sha256=-tktnVOIF7B45WR7AuLoi7MKnEyuM8lgg1jjc4T1FhM,1929
 todo_agent/infrastructure/logger.py,sha256=2ykG_0lyzmEGxDF6ZRl1qiTUGDuFeQgzv4Na6vRmXcM,4110
 todo_agent/infrastructure/ollama_client.py,sha256=RVgHqX37k7q5xEaEXdhcCv2HYQiszs1QV39RxFFMIas,5902
-todo_agent/infrastructure/openrouter_client.py,sha256=7qusHuOH-zMKMrQw98v3MKwSWUJwL0mZsdShSjeoti0,7121
-todo_agent/infrastructure/todo_shell.py,sha256=z6kqUKDX-i4DfYJKoOLiPLCp8y6m1HdTDLHTvmLpzMc,5801
+todo_agent/infrastructure/openrouter_client.py,sha256=FV240sQxoJ8j_Umh0qc6IorHkwk3LAFTSekGHKxuFwk,7000
+todo_agent/infrastructure/todo_shell.py,sha256=kYS0UwDZU1OpUVpWMkVsnsxnHINoWliRqzDRD8VTXJQ,17375
 todo_agent/infrastructure/token_counter.py,sha256=PCKheOVJbp1s89yhh_i6iKgURMt9mVoYkwjQJCc2xCE,4958
-todo_agent/infrastructure/prompts/system_prompt.txt,sha256=j7N8GhMbyRR7QqfkokbCJiElv6CdAhc22PVzY6vrucE,15880
+todo_agent/infrastructure/prompts/system_prompt.txt,sha256=HTv7Yl2oQi-AbQgdBzZKNKnmAMdOuOVRlbi75L-w-5g,19962
 todo_agent/interface/__init__.py,sha256=vDD3rQu4qDkpvVwGVtkDzE1M4IiSHYzTif4GbYSFWaI,457
-todo_agent/interface/cli.py,sha256=C746b83dQTiyUfthcC-pngwsJlmXZAu10_hxsSOMzdM,12022
+todo_agent/interface/cli.py,sha256=9DUKTrxTwKx5Go0cA8nNCKDuM6QDmAG8jzK4_v_1WS8,12096
 todo_agent/interface/formatters.py,sha256=DiQLemndiuFWjLcBRPpu1wVnJcoYAFP8t_fJstOgaDs,18918
-todo_agent/interface/tools.py,sha256=_GlZwX09dYpqPB2Q-EsgGguA1PVl8_mRCdks6ucaJgU,39686
-todo_agent-0.2.8.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-todo_agent-0.2.8.dist-info/METADATA,sha256=ynVrlFUs89Qfgp6R3YnbvZGykjHD4CjNnJaLNm-oz1w,10047
-todo_agent-0.2.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-todo_agent-0.2.8.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
-todo_agent-0.2.8.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
-todo_agent-0.2.8.dist-info/RECORD,,
+todo_agent/interface/tools.py,sha256=OE9qOwWo7itqmNc85tZSCqWHCvValMa4fQE-EygnNNQ,45929
+todo_agent-0.2.9.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+todo_agent-0.2.9.dist-info/METADATA,sha256=OPm-ho33qlhnZqrnNlqRR2p4tLqlXzkNk-fgcY73Dg0,10134
+todo_agent-0.2.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+todo_agent-0.2.9.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
+todo_agent-0.2.9.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
+todo_agent-0.2.9.dist-info/RECORD,,