todo-agent 0.3.5__tar.gz → 0.3.6__tar.gz

{todo_agent-0.3.5 → todo_agent-0.3.6}/PKG-INFO

@@ -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 → todo_agent-0.3.6}/tests/test_infrastructure/test_todo_shell.py

@@ -810,3 +810,16 @@ class TestTodoShell:
             # Should not duplicate +work, only add +new
             mock_replace.assert_called_once_with(1, "Test task +work +new @context")
             assert result == "Task updated"
+
+    def test_get_help_constructs_correct_command(self):
+        """Test getting help constructs the correct todo.sh command."""
+        with patch.object(
+            self.todo_shell, "execute", return_value="Todo.sh help output"
+        ) as mock_execute:
+            result = self.todo_shell.get_help()
+
+            # Verify the correct command was constructed
+            mock_execute.assert_called_once_with(
+                ["todo.sh", "help"], suppress_color=False
+            )
+            assert result == "Todo.sh help output"

{todo_agent-0.3.5 → todo_agent-0.3.6}/tests/test_interface/test_cli.py

@@ -377,6 +377,97 @@ class TestCLI:
                     expected_line in str(call) for call in mock_print.call_args_list
                 )
 
+    def test_todo_passthrough_command_success(self):
+        """Test successful todo.sh passthrough command execution."""
+        with patch("builtins.input", return_value="/add test task"), patch("sys.exit"):
+            # Mock the todo_shell execute method
+            mock_todo_shell = Mock()
+            mock_todo_shell.execute.return_value = "1 test task"
+
+            # Create CLI instance with mocked dependencies
+            with patch("todo_agent.interface.cli.Config"), patch(
+                "todo_agent.interface.cli.TodoShell", return_value=mock_todo_shell
+            ), patch("todo_agent.interface.cli.TodoManager"), patch(
+                "todo_agent.interface.cli.ToolCallHandler"
+            ), patch("todo_agent.interface.cli.Inference"), patch(
+                "todo_agent.interface.cli.Logger"
+            ), patch("todo_agent.interface.cli.Console") as mock_console:
+                CLI()
+
+                # Mock the console methods
+                mock_console.return_value.input.return_value = "/add test task"
+                mock_console.return_value.print = Mock()
+
+                # Test the passthrough logic directly
+                user_input = "/add test task"
+                if user_input.startswith("/"):
+                    todo_command = user_input[1:].strip()
+                    output = mock_todo_shell.execute(["todo.sh", *todo_command.split()])
+
+                    # Verify the command was executed correctly
+                    mock_todo_shell.execute.assert_called_once_with(
+                        ["todo.sh", "add", "test", "task"]
+                    )
+                    assert output == "1 test task"
+
+    def test_todo_passthrough_command_empty(self):
+        """Test todo.sh passthrough with empty command."""
+        with patch("builtins.input", return_value="/"), patch("sys.exit"):
+            # Mock the todo_shell execute method
+            mock_todo_shell = Mock()
+
+            # Create CLI instance with mocked dependencies
+            with patch("todo_agent.interface.cli.Config"), patch(
+                "todo_agent.interface.cli.TodoShell", return_value=mock_todo_shell
+            ), patch("todo_agent.interface.cli.TodoManager"), patch(
+                "todo_agent.interface.cli.ToolCallHandler"
+            ), patch("todo_agent.interface.cli.Inference"), patch(
+                "todo_agent.interface.cli.Logger"
+            ), patch("todo_agent.interface.cli.Console") as mock_console:
+                CLI()
+
+                # Mock the console methods
+                mock_console.return_value.input.return_value = "/"
+                mock_console.return_value.print = Mock()
+
+                # Test the passthrough logic with empty command
+                user_input = "/"
+                if user_input.startswith("/"):
+                    todo_command = user_input[1:].strip()
+                    if not todo_command:
+                        # Should handle empty command gracefully
+                        assert todo_command == ""
+
+    def test_todo_help_command(self):
+        """Test todo-help command execution."""
+        with patch("builtins.input", return_value="todo-help"), patch("sys.exit"):
+            # Mock the todo_shell get_help method
+            mock_todo_shell = Mock()
+            mock_todo_shell.get_help.return_value = "Todo.sh help output"
+
+            # Create CLI instance with mocked dependencies
+            with patch("todo_agent.interface.cli.Config"), patch(
+                "todo_agent.interface.cli.TodoShell", return_value=mock_todo_shell
+            ), patch("todo_agent.interface.cli.TodoManager"), patch(
+                "todo_agent.interface.cli.ToolCallHandler"
+            ), patch("todo_agent.interface.cli.Inference"), patch(
+                "todo_agent.interface.cli.Logger"
+            ), patch("todo_agent.interface.cli.Console") as mock_console:
+                CLI()
+
+                # Mock the console methods
+                mock_console.return_value.input.return_value = "todo-help"
+                mock_console.return_value.print = Mock()
+
+                # Test the todo-help command
+                user_input = "todo-help"
+                if user_input.lower() == "todo-help":
+                    help_output = mock_todo_shell.get_help()
+
+                    # Verify the help was retrieved
+                    mock_todo_shell.get_help.assert_called_once()
+                    assert help_output == "Todo.sh help output"
+
     def test_empty_input_handling(self):
         """Test that empty input is handled gracefully."""
         # This would be tested in the main run loop

{todo_agent-0.3.5 → todo_agent-0.3.6}/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 = 'g698d691a3'
+__commit_id__ = commit_id = 'g30b41eb2b'

{todo_agent-0.3.5 → todo_agent-0.3.6}/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-0.3.5 → todo_agent-0.3.6}/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-0.3.5 → todo_agent-0.3.6}/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-0.3.5 → todo_agent-0.3.6}/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-0.3.5 → todo_agent-0.3.6}/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-0.3.5 → todo_agent-0.3.6}/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 → todo_agent-0.3.6}/todo_agent.egg-info/PKG-INFO

@@ -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