todo-agent 0.3.5__py3-none-any.whl → 0.3.6__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.3.5'
-__version_tuple__ = version_tuple = (0, 3, 5)
+__version__ = version = '0.3.6'
+__version_tuple__ = version_tuple = (0, 3, 6)
 
 __commit_id__ = commit_id = None

todo_agent/infrastructure/prompts/system_prompt.txt

@@ -104,23 +104,28 @@ Example: add_task(description='Put out trash and recycling', project='weekly', c
 
 **Parent Task Format**: `(A) Child task description +project @context due:YYYY-MM-DD duration:2h parent:12`
 
-### Task Completion Protocol  
+### Task Completion Protocol 
+NOTE: use complete_task() for existing non-recurring tasks
 1. **Discovery**: Use `list_tasks()` to search semantically in active tasks
-2. **For Recurring Tasks** (containing +daily, +weekly, +monthly, +weekdays, etc.):
+2. **For Non-Recurring Tasks**:
+   - The task will NOT have the tag "rec:"
+   - Single match → use `complete_task(task_number='XX')` to mark existing active tasks complete
+   - Multiple/fuzzy → show options
+   - No match → suggest alternatives
+3. **For Recurring Tasks** (containing +daily, +weekly, +monthly, +weekdays, etc.):
+   - The task will have the tag "rec:"
    - **USE** `create_completed_task()` with the original task number as parent_number
    - **PRESERVE** the original recurring task for future occurrences. **IMPORTANT** DO NOT MARK COMPLETE! DO NOT MODIFY!
    - **TOOL CALL**: `create_completed_task(description='Task description', parent_number='XX', completion_date='YYYY-MM-DD', context='context', project='project')`
-3. **For Non-Recurring Tasks**:
-   - Single match → use `complete_task(task_number='XX')`
-   - Multiple/fuzzy → show options
-   - No match → suggest alternatives
+
 
 ### Recurring Task Completion Examples
+NOTE: ONLY USE create_completed_task() for RECURRING TASKS!
 - **User says**: "I put out the trash" → Find `(B) Put out trash and recycling +weekly +thursday @home duration:5m`
-  - **Tool Call**: `create_completed_task(description='Put out trash and recycling', parent_number='B', completion_date='YYYY-MM-DD', context='home', project='weekly')`
+  - **Tool Call**: ONLY FOR EXISTING TASKS! `create_completed_task(description='Put out trash and recycling', parent_number='B', completion_date='YYYY-MM-DD', context='home', project='weekly')`
   - **Result**: Original task remains active for next Thursday
 - **User says**: "Done with standup" → Find `Standup meeting at 9:00AM +daily +weekdays @office duration:10m`
-  - **Tool Call**: `create_completed_task(description='Standup meeting at 9:00AM', parent_number='XX', completion_date='YYYY-MM-DD', context='office', project='daily')`
+  - **Tool Call**: ONLY FOR EXISTING TASKS! `create_completed_task(description='Standup meeting at 9:00AM', parent_number='XX', completion_date='YYYY-MM-DD', context='office', project='daily')`
   - **Result**: Original task remains active for next weekday
 
 ### Task Suggestions

todo_agent/infrastructure/todo_shell.py

@@ -182,6 +182,10 @@ class TodoShell:
         """Archive completed tasks."""
         return self.execute(["todo.sh", "-f", "archive"])
 
+    def get_help(self) -> str:
+        """Get todo.sh help output."""
+        return self.execute(["todo.sh", "help"], suppress_color=False)
+
     def set_due_date(self, task_number: int, due_date: str) -> str:
         """
         Set or update due date for a task by intelligently rewriting it.

todo_agent/interface/cli.py

@@ -225,6 +225,23 @@ class CLI:
         self.console.print(table)
         self.console.print("Or just type your request naturally!", style="italic green")
 
+    def _print_todo_help(self) -> None:
+        """Print todo.sh help information."""
+        try:
+            # Get todo.sh help output
+            help_output = self.todo_shell.get_help()
+            formatted_output = TaskFormatter.format_task_list(help_output)
+            help_panel = PanelFormatter.create_task_panel(
+                formatted_output, title="📋 Todo.sh Help"
+            )
+            self.console.print(help_panel)
+        except Exception as e:
+            self.logger.error(f"Error getting todo.sh help: {e!s}")
+            error_msg = ResponseFormatter.format_error(
+                f"Failed to get todo.sh help: {e!s}"
+            )
+            self.console.print(error_msg)
+
     def _print_about(self) -> None:
         """Print about information in a formatted panel."""
         about_panel = PanelFormatter.create_about_panel()
@@ -280,6 +297,37 @@ class CLI:
                 if not user_input:
                     continue
 
+                # Handle todo.sh passthrough commands (starting with /)
+                if user_input.startswith("/"):
+                    self.logger.debug(
+                        f"Processing todo.sh passthrough command: {user_input}"
+                    )
+                    try:
+                        # Remove the leading / and execute as todo.sh command
+                        todo_command = user_input[1:].strip()
+                        if not todo_command:
+                            self.console.print(
+                                ResponseFormatter.format_error("Empty todo.sh command")
+                            )
+                            continue
+
+                        # Execute the todo.sh command directly
+                        output = self.todo_shell.execute(
+                            ["todo.sh", *todo_command.split()]
+                        )
+                        formatted_output = TaskFormatter.format_task_list(output)
+                        task_panel = PanelFormatter.create_task_panel(
+                            formatted_output, title="📋 Todo.sh Output"
+                        )
+                        self.console.print(task_panel)
+                    except Exception as e:
+                        self.logger.error(f"Error executing todo.sh command: {e!s}")
+                        error_msg = ResponseFormatter.format_error(
+                            f"Todo.sh command failed: {e!s}"
+                        )
+                        self.console.print(error_msg)
+                    continue
+
                 # Handle special commands
                 if user_input.lower() == "clear":
                     self.logger.info("User requested conversation clear")
@@ -302,6 +350,11 @@ class CLI:
                     self._print_help()
                     continue
 
+                if user_input.lower() == "todo-help":
+                    self.logger.debug("User requested todo.sh help")
+                    self._print_todo_help()
+                    continue
+
                 if user_input.lower() == "about":
                     self.logger.debug("User requested about information")
                     self._print_about()

todo_agent/interface/formatters.py

@@ -357,6 +357,7 @@ class TableFormatter:
             ("clear", "Clear conversation history"),
             ("stats", "Show conversation statistics"),
             ("help", "Show this help message"),
+            ("todo-help", "Show todo.sh help"),
             ("about", "Show application information"),
             ("list", "List all tasks (no LLM interaction)"),
             ("done", "List completed tasks (no LLM interaction)"),

todo_agent/interface/tools.py

@@ -626,13 +626,14 @@ class ToolCallHandler:
                     "name": "create_completed_task",
                     "description": (
                         "Create a task and immediately mark it as completed. "
-                        "USE CASE: Call this when user says they completed something on a specific date (e.g., 'I did the laundry today', 'I finished the report yesterday', 'I cleaned the garage last week') "
+                        "USE CASE: WHEN NO MATCH IS FOUND! Call this when user says they completed something on a specific date (e.g., 'I did the laundry today', 'I finished the report yesterday', 'I cleaned the garage last week') "
                         "and you have already researched existing tasks to determine no match exists. "
-                        "WORKFLOW: 1) Use list_tasks() to search for existing tasks, 2) Use list_completed_tasks() to verify it's not already done, "
-                        "3) If no match found, call this tool to create and complete the task in one operation. "
+                        "WORKFLOW: 1) Use list_tasks() to search for existing tasks, "
+                        "2) Use list_completed_tasks() to verify it's not already done, "
+                        "3) If a match is found, use complete_task() to mark it complete, "
+                        "4) If no match found, call this tool to create and complete the task in one operation. "
                         "STRATEGIC CONTEXT: This is a convenience tool for the common pattern of 'I did X on [date]' - "
-                        "it creates a task with the specified completion date and immediately marks it complete. "
-                        "The LLM should handle the research and decision-making about whether to use this tool."
+                        "when no task match is found, it creates a task with the specified completion date and immediately marks it complete. "
                     ),
                     "parameters": {
                         "type": "object",

todo_agent/main.py

@@ -12,7 +12,7 @@ from .interface.cli import CLI
 def main() -> None:
     """Main application entry point."""
     from ._version import __version__
-    
+
     parser = argparse.ArgumentParser(
         description=f"Todo.sh LLM Agent - Natural language task management (v{__version__})",
         formatter_class=argparse.RawDescriptionHelpFormatter,
@@ -27,18 +27,20 @@ Examples:
     )
 
     parser.add_argument(
-        "--version", "-v",
+        "--version",
+        "-v",
         action="version",
         version=f"%(prog)s {__version__}",
         help="Show version information and exit",
     )
-    
+
     parser.add_argument(
-        "--help", "-h",
+        "--help",
+        "-h",
         action="help",
         help="Show this help message and exit",
     )
-    
+
     parser.add_argument(
         "command",
         nargs="?",
@@ -53,11 +55,28 @@ Examples:
         if args.command:
             # Single command mode
             # Handle special commands that don't need LLM processing
-            if args.command.lower() in ["help", "about"]:
+            if args.command.lower() in ["help", "about", "todo-help"]:
                 if args.command.lower() == "help":
                     cli._print_help()
                 elif args.command.lower() == "about":
                     cli._print_about()
+                elif args.command.lower() == "todo-help":
+                    cli._print_todo_help()
+            elif args.command.startswith("/"):
+                # Handle todo.sh passthrough commands
+                try:
+                    # Remove the leading / and execute as todo.sh command
+                    todo_command = args.command[1:].strip()
+                    if not todo_command:
+                        print("Error: Empty todo.sh command")
+                        sys.exit(1)
+
+                    # Execute the todo.sh command directly
+                    output = cli.todo_shell.execute(["todo.sh", *todo_command.split()])
+                    print(output)
+                except Exception as e:
+                    print(f"Error: Todo.sh command failed: {e}")
+                    sys.exit(1)
             else:
                 # Process through LLM
                 response = cli.run_single_request(args.command)

{todo_agent-0.3.5.dist-info → todo_agent-0.3.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: todo-agent
-Version: 0.3.5
+Version: 0.3.6
 Summary: A natural language interface for todo.sh task management
 Author: codeprimate
 Maintainer: codeprimate

{todo_agent-0.3.5.dist-info → todo_agent-0.3.6.dist-info}/RECORD

@@ -1,6 +1,6 @@
 todo_agent/__init__.py,sha256=RUowhd14r3tqB_7rl83unGV8oBjra3UOIl7jix-33fk,254
-todo_agent/_version.py,sha256=UAb2Toi6SAdScDfq1uKRRv5QpMUuRtJqqwNxTMGe5Q4,704
-todo_agent/main.py,sha256=DfcZuTsHkmpm6kw0coB0-B677K3hyRwutWIuO4noQ3w,2026
+todo_agent/_version.py,sha256=DPG4bRRG7SLMPQyCzFx7koj75iQndn-UI-ENmNbYVCQ,704
+todo_agent/main.py,sha256=3kFRat2mG_57z1JR6UzsWDGLZ8G8EYuw9h9F8Xpo_mc,2857
 todo_agent/core/__init__.py,sha256=QAZ4it63pXv5-DxtNcuSAmg7ZnCY5ackI5yycvKHr9I,365
 todo_agent/core/conversation_manager.py,sha256=9aAWogswZe9Cs7wKT47RG-cLh1LQ5D9RbhUHJVUyTS8,13549
 todo_agent/core/exceptions.py,sha256=ilVL5hyPHGYQXsLm0pYivMbhbamupG77r8TbiQr2tAU,2034
@@ -14,17 +14,17 @@ todo_agent/infrastructure/llm_client_factory.py,sha256=-tktnVOIF7B45WR7AuLoi7MKn
 todo_agent/infrastructure/logger.py,sha256=2ykG_0lyzmEGxDF6ZRl1qiTUGDuFeQgzv4Na6vRmXcM,4110
 todo_agent/infrastructure/ollama_client.py,sha256=V_zAeBjIEzB8PZXyzFeiLMLA5qf3y4WV2_6Vqxn1ujc,5629
 todo_agent/infrastructure/openrouter_client.py,sha256=0pxIKvHItwVijFz8l4loOeCa4HUpMvTYROcwYJh3iyI,6748
-todo_agent/infrastructure/todo_shell.py,sha256=2iPPhsLsTcjVx8Wv2mJJBu11kLJOK9Tk5KBAyVQ3Yjs,20596
+todo_agent/infrastructure/todo_shell.py,sha256=ft7wKWykMKEHD1ZD_k1R8a_Zje7vLnG1yD8770TNVBQ,20738
 todo_agent/infrastructure/token_counter.py,sha256=PCKheOVJbp1s89yhh_i6iKgURMt9mVoYkwjQJCc2xCE,4958
-todo_agent/infrastructure/prompts/system_prompt.txt,sha256=ZHGYgd7lCuWaSX5io3IYWFhdjcGbdqKXf2uhEWdbzQ8,12380
+todo_agent/infrastructure/prompts/system_prompt.txt,sha256=DwvuXoSZY5-lRk1WcinU57PIqGH-omy1oC5P5FBEOog,12670
 todo_agent/interface/__init__.py,sha256=vDD3rQu4qDkpvVwGVtkDzE1M4IiSHYzTif4GbYSFWaI,457
-todo_agent/interface/cli.py,sha256=Ikh5AYoOZnNUVXzHjfv2bsE33yK3VhCdzza83HOzFp8,16460
-todo_agent/interface/formatters.py,sha256=a9PW-5DbY8K5QYZjBXFZSdzlCmy263kwBI9nXgP8LXI,20081
+todo_agent/interface/cli.py,sha256=opVubVwLlcU5ImUyGlS21Es49xuzNjkivPiEsxRiLj0,18922
+todo_agent/interface/formatters.py,sha256=Kcm8-E9OkvjnqaUvQuwrYKqUmknduAUP5z0A6rOaeG8,20129
 todo_agent/interface/progress.py,sha256=EpPa20Hrnjv_TBIp0tzViVciThqsOvAHuYO4v2rc8eI,1751
-todo_agent/interface/tools.py,sha256=Q6h2zpe1yRUwJOZZFArjXgBN6WPDI56CDQQJcdF1I5M,54448
-todo_agent-0.3.5.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-todo_agent-0.3.5.dist-info/METADATA,sha256=eP-pVo55MQvK1G9b9vaoOhir6fQnjOr4CD-D8n29Ha0,10056
-todo_agent-0.3.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-todo_agent-0.3.5.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
-todo_agent-0.3.5.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
-todo_agent-0.3.5.dist-info/RECORD,,
+todo_agent/interface/tools.py,sha256=U3LF7VZy27n2aLbxDD7uIEt8OPeXgXCz0I83ins4WdM,54507
+todo_agent-0.3.6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+todo_agent-0.3.6.dist-info/METADATA,sha256=iqTh--OWn4ocfSIVeK3F35RC7SoFc4nASidx8K67Bos,10056
+todo_agent-0.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+todo_agent-0.3.6.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
+todo_agent-0.3.6.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
+todo_agent-0.3.6.dist-info/RECORD,,