Execution System MCP Server

"""Tests for ProjectCompleter class.""" import pytest from pathlib import Path from datetime import date from execution_system_mcp.completer import ProjectCompleter from execution_system_mcp.config import ConfigManager class TestProjectCompleterFindActiveProject: """Tests for ProjectCompleter.find_active_project method.""" def test_finds_project_in_area_subdirectory(self, tmp_path): """ Given a project file exists in active/health/ When find_active_project is called with the title Then the project path and area are returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [ {"name": "Health", "kebab": "health"} ] }""" % str(tmp_path)) active_health = tmp_path / "docs/execution_system/10k-projects/active/health" active_health.mkdir(parents=True) project_file = active_health / "upgrade-anbernic-sd-cards.md" project_file.write_text("""--- area: Health title: Upgrade Anbernic SD Cards type: standard created: 2025-10-20 started: 2025-10-20 last_reviewed: 2025-10-20 --- # Content """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.find_active_project("Upgrade Anbernic SD Cards") # Then assert result == (project_file, "health") def test_returns_none_for_nonexistent_project(self, tmp_path): """ Given no project file exists with the title When find_active_project is called Then None and error message are returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [ {"name": "Health", "kebab": "health"} ] }""" % str(tmp_path)) active_health = tmp_path / "docs/execution_system/10k-projects/active/health" active_health.mkdir(parents=True) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.find_active_project("Nonexistent Project") # Then assert result[0] is None assert "not found" in result[1].lower() def test_returns_error_for_project_in_completed(self, tmp_path): """ Given a project file exists in completed/health/ When find_active_project is called Then None and error message are returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [ {"name": "Health", "kebab": "health"} ] }""" % str(tmp_path)) completed_health = tmp_path / "docs/execution_system/10k-projects/completed/health" completed_health.mkdir(parents=True) project_file = completed_health / "old-project.md" project_file.write_text("""--- area: Health title: Old Project --- """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.find_active_project("Old Project") # Then assert result[0] is None assert "already completed" in result[1].lower() or "not active" in result[1].lower() def test_returns_error_for_project_in_incubator(self, tmp_path): """ Given a project file exists in incubator/health/ When find_active_project is called Then None and error message are returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [ {"name": "Health", "kebab": "health"} ] }""" % str(tmp_path)) incubator_health = tmp_path / "docs/execution_system/10k-projects/incubator/health" incubator_health.mkdir(parents=True) project_file = incubator_health / "future-project.md" project_file.write_text("""--- area: Health title: Future Project --- """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.find_active_project("Future Project") # Then assert result[0] is None assert "not active" in result[1].lower() or "incubating" in result[1].lower() def test_handles_multiple_areas(self, tmp_path): """ Given projects exist in multiple area subdirectories When find_active_project is called with a title Then the correct project is found in its area """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [ {"name": "Health", "kebab": "health"}, {"name": "Career", "kebab": "career"} ] }""" % str(tmp_path)) active_health = tmp_path / "docs/execution_system/10k-projects/active/health" active_health.mkdir(parents=True) health_project = active_health / "health-project.md" health_project.write_text("""--- area: Health title: Health Project --- """) active_career = tmp_path / "docs/execution_system/10k-projects/active/career" active_career.mkdir(parents=True) career_project = active_career / "career-project.md" career_project.write_text("""--- area: Career title: Career Project --- """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.find_active_project("Career Project") # Then assert result == (career_project, "career") class TestProjectCompleterCheck0kBlockers: """Tests for ProjectCompleter.check_0k_blockers method.""" def test_no_blockers_returns_empty_list(self, tmp_path): """ Given no 0k files contain the project tag When check_0k_blockers is called Then an empty list is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) waiting_file = next_actions_dir / "@waiting.md" waiting_file.write_text("""--- title: Waiting For --- - [ ] 2025-10-22 Someone to do something +other-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert result == [] def test_finds_blocker_in_waiting(self, tmp_path): """ Given @waiting.md contains an open item with the project tag When check_0k_blockers is called Then a list with the blocking item is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) waiting_file = next_actions_dir / "@waiting.md" waiting_file.write_text("""--- title: Waiting For --- - [ ] 2025-10-22 Tina to receive Amazon package +my-project - [ ] 2025-10-21 Something else +other-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert len(result) == 1 assert result[0]["file"] == "@waiting.md" assert "Tina to receive Amazon package" in result[0]["line"] def test_finds_blocker_in_incubating(self, tmp_path): """ Given @incubating.md contains an open item with the project tag When check_0k_blockers is called Then a list with the blocking item is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) incubating_file = next_actions_dir / "@incubating.md" incubating_file.write_text("""--- title: Incubating --- - [ ] 2025-09-12 Text Samarth to get coffee +my-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert len(result) == 1 assert result[0]["file"] == "@incubating.md" assert "Text Samarth" in result[0]["line"] def test_finds_blocker_in_deferred(self, tmp_path): """ Given @deferred.md contains an open item with the project tag When check_0k_blockers is called Then a list with the blocking item is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) deferred_file = next_actions_dir / "@deferred.md" deferred_file.write_text("""--- title: Deferred --- - [ ] 2025-10-23 Pick up dry cleaning +my-project defer:2025-10-28 """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert len(result) == 1 assert result[0]["file"] == "@deferred.md" assert "Pick up dry cleaning" in result[0]["line"] def test_finds_blocker_in_context_file(self, tmp_path): """ Given a contexts/*.md file contains an open item with the project tag When check_0k_blockers is called Then a list with the blocking item is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) contexts_dir = tmp_path / "docs/execution_system/00k-next-actions/contexts" contexts_dir.mkdir(parents=True) personal_file = contexts_dir / "personal.md" personal_file.write_text("""--- title: Personal Context --- - [ ] 2025-10-20 Do the thing @home +my-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert len(result) == 1 assert result[0]["file"] == "contexts/personal.md" assert "Do the thing" in result[0]["line"] def test_finds_multiple_blockers_across_files(self, tmp_path): """ Given multiple 0k files contain open items with the project tag When check_0k_blockers is called Then a list with all blocking items is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) waiting_file = next_actions_dir / "@waiting.md" waiting_file.write_text("""--- title: Waiting For --- - [ ] 2025-10-22 Wait for thing +my-project """) deferred_file = next_actions_dir / "@deferred.md" deferred_file.write_text("""--- title: Deferred --- - [ ] 2025-10-23 Deferred task +my-project """) contexts_dir = next_actions_dir / "contexts" contexts_dir.mkdir(parents=True) personal_file = contexts_dir / "personal.md" personal_file.write_text("""--- title: Personal --- - [ ] 2025-10-20 Next action +my-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert len(result) == 3 def test_ignores_completed_items(self, tmp_path): """ Given completed.md contains items with the project tag When check_0k_blockers is called Then those items are not included in the result """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) completed_file = next_actions_dir / "completed.md" completed_file.write_text("""--- title: Completed --- - [ ] 2025-10-20 Completed task +my-project - [x] 2025-10-19 Another completed task +my-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert result == [] def test_ignores_checked_items(self, tmp_path): """ Given @waiting.md contains a checked item with the project tag When check_0k_blockers is called Then the checked item is not included in the result """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) waiting_file = next_actions_dir / "@waiting.md" waiting_file.write_text("""--- title: Waiting For --- - [x] 2025-10-22 Done waiting +my-project - [ ] 2025-10-21 Still waiting +other-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.check_0k_blockers("my-project") # Then assert result == [] class TestProjectCompleterParseFrontmatter: """Tests for ProjectCompleter.parse_frontmatter method.""" def test_parses_all_fields(self, tmp_path): """ Given a project file with all frontmatter fields When parse_frontmatter is called Then all fields are returned in a dict """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) project_file = tmp_path / "project.md" project_file.write_text("""--- area: Health title: Test Project type: standard created: 2025-10-20 started: 2025-10-20 last_reviewed: 2025-10-22 due: 2025-12-31 --- # Content """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.parse_frontmatter(project_file) # Then assert result["area"] == "Health" assert result["title"] == "Test Project" assert result["type"] == "standard" assert str(result["created"]) == "2025-10-20" assert str(result["started"]) == "2025-10-20" assert str(result["last_reviewed"]) == "2025-10-22" assert str(result["due"]) == "2025-12-31" def test_handles_missing_optional_fields(self, tmp_path): """ Given a project file without due and started fields When parse_frontmatter is called Then the dict includes only present fields """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) project_file = tmp_path / "project.md" project_file.write_text("""--- area: Health title: Incubating Project type: standard created: 2025-10-20 last_reviewed: 2025-10-22 --- # Content """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.parse_frontmatter(project_file) # Then assert result["area"] == "Health" assert result["title"] == "Incubating Project" assert "started" not in result assert "due" not in result def test_preserves_field_order(self, tmp_path): """ Given a project file with frontmatter fields When parse_frontmatter is called Then the returned dict preserves insertion order """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) project_file = tmp_path / "project.md" project_file.write_text("""--- area: Health title: Test Project type: standard created: 2025-10-20 started: 2025-10-20 last_reviewed: 2025-10-22 --- # Content """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.parse_frontmatter(project_file) # Then keys = list(result.keys()) assert keys == ["area", "title", "type", "created", "started", "last_reviewed"] class TestProjectCompleterAddCompletedDate: """Tests for ProjectCompleter.add_completed_date method.""" def test_adds_completed_with_todays_date(self, tmp_path): """ Given a frontmatter dict When add_completed_date is called Then a completed field with today's date is added """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) frontmatter = { "area": "Health", "title": "Test Project", "type": "standard", "created": "2025-10-20", "started": "2025-10-20", "last_reviewed": "2025-10-22" } config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.add_completed_date(frontmatter) # Then assert "completed" in result assert result["completed"] == str(date.today()) def test_preserves_all_existing_fields(self, tmp_path): """ Given a frontmatter dict with all fields When add_completed_date is called Then all original fields are preserved """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) frontmatter = { "area": "Health", "title": "Test Project", "type": "standard", "created": "2025-10-20", "started": "2025-10-20", "last_reviewed": "2025-10-22", "due": "2025-12-31" } config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.add_completed_date(frontmatter) # Then assert result["area"] == "Health" assert result["title"] == "Test Project" assert result["type"] == "standard" assert result["created"] == "2025-10-20" assert result["started"] == "2025-10-20" assert result["last_reviewed"] == "2025-10-22" assert result["due"] == "2025-12-31" def test_maintains_field_order_with_due(self, tmp_path): """ Given a frontmatter dict with due field When add_completed_date is called Then completed is placed after due """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) frontmatter = { "area": "Health", "title": "Test Project", "type": "standard", "created": "2025-10-20", "started": "2025-10-20", "last_reviewed": "2025-10-22", "due": "2025-12-31" } config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.add_completed_date(frontmatter) # Then keys = list(result.keys()) assert keys == ["area", "title", "type", "created", "started", "last_reviewed", "due", "completed"] def test_maintains_field_order_without_due(self, tmp_path): """ Given a frontmatter dict without due field When add_completed_date is called Then completed is placed after last_reviewed """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) frontmatter = { "area": "Health", "title": "Test Project", "type": "standard", "created": "2025-10-20", "started": "2025-10-20", "last_reviewed": "2025-10-22" } config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.add_completed_date(frontmatter) # Then keys = list(result.keys()) assert keys == ["area", "title", "type", "created", "started", "last_reviewed", "completed"] class TestProjectCompleterGenerateFrontmatterYaml: """Tests for ProjectCompleter.generate_frontmatter_yaml method.""" def test_generates_valid_yaml_with_all_fields(self, tmp_path): """ Given a frontmatter dict with all fields When generate_frontmatter_yaml is called Then valid YAML frontmatter is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) frontmatter = { "area": "Health", "title": "Test Project", "type": "standard", "created": "2025-10-20", "started": "2025-10-20", "last_reviewed": "2025-10-22", "due": "2025-12-31", "completed": "2025-10-23" } config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.generate_frontmatter_yaml(frontmatter) # Then assert result.startswith("---\n") assert result.endswith("---\n") assert "area: Health" in result assert "title: Test Project" in result assert "completed: 2025-10-23" in result def test_maintains_correct_field_order(self, tmp_path): """ Given a frontmatter dict When generate_frontmatter_yaml is called Then fields appear in the correct order """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) frontmatter = { "area": "Health", "title": "Test Project", "type": "standard", "created": "2025-10-20", "started": "2025-10-20", "last_reviewed": "2025-10-22", "completed": "2025-10-23" } config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.generate_frontmatter_yaml(frontmatter) # Then lines = result.strip().split("\n") assert lines[0] == "---" assert lines[1] == "area: Health" assert lines[2] == "title: Test Project" assert lines[3] == "type: standard" assert lines[-2] == "completed: 2025-10-23" assert lines[-1] == "---" def test_formats_dates_as_strings(self, tmp_path): """ Given a frontmatter dict with date values When generate_frontmatter_yaml is called Then dates are formatted as string values """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) frontmatter = { "area": "Health", "title": "Test Project", "type": "standard", "created": "2025-10-20", "completed": "2025-10-23" } config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.generate_frontmatter_yaml(frontmatter) # Then assert "created: 2025-10-20" in result assert "completed: 2025-10-23" in result class TestProjectCompleterCompleteProject: """Tests for ProjectCompleter.complete_project method.""" def test_successfully_completes_project_with_no_blockers(self, tmp_path): """ Given an active project with no 0k blockers When complete_project is called Then the project is moved to completed with completed date added """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) active_health = tmp_path / "docs/execution_system/10k-projects/active/health" active_health.mkdir(parents=True) project_file = active_health / "test-project.md" project_file.write_text("""--- area: Health title: Test Project type: standard created: 2025-10-20 started: 2025-10-20 last_reviewed: 2025-10-22 --- # Content here """) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) waiting_file = next_actions_dir / "@waiting.md" waiting_file.write_text("---\ntitle: Waiting\n---\n\n- [ ] Something else +other-project\n") config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.complete_project("Test Project") # Then completed_file = tmp_path / "docs/execution_system/10k-projects/completed/health/test-project.md" assert completed_file.exists() assert not project_file.exists() assert "completed: " + str(date.today()) in completed_file.read_text() assert "Successfully completed" in result def test_creates_completed_subdirectory_if_missing(self, tmp_path): """ Given the completed/health subdirectory doesn't exist When complete_project is called Then the directory is created """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) active_health = tmp_path / "docs/execution_system/10k-projects/active/health" active_health.mkdir(parents=True) project_file = active_health / "test-project.md" project_file.write_text("""--- area: Health title: Test Project type: standard created: 2025-10-20 started: 2025-10-20 last_reviewed: 2025-10-22 --- # Content """) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.complete_project("Test Project") # Then completed_health = tmp_path / "docs/execution_system/10k-projects/completed/health" assert completed_health.exists() assert completed_health.is_dir() def test_returns_error_for_nonexistent_project(self, tmp_path): """ Given no project exists with the title When complete_project is called Then an error message is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) active_health = tmp_path / "docs/execution_system/10k-projects/active/health" active_health.mkdir(parents=True) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.complete_project("Nonexistent Project") # Then assert "not found" in result.lower() def test_returns_error_with_blocking_items(self, tmp_path): """ Given an active project with open 0k items When complete_project is called Then an error message listing blockers is returned """ # Given config_file = tmp_path / "config.json" config_file.write_text("""{ "execution_system_repo_path": "%s", "areas": [{"name": "Health", "kebab": "health"}] }""" % str(tmp_path)) active_health = tmp_path / "docs/execution_system/10k-projects/active/health" active_health.mkdir(parents=True) project_file = active_health / "test-project.md" project_file.write_text("""--- area: Health title: Test Project type: standard created: 2025-10-20 started: 2025-10-20 last_reviewed: 2025-10-22 --- # Content """) next_actions_dir = tmp_path / "docs/execution_system/00k-next-actions" next_actions_dir.mkdir(parents=True) waiting_file = next_actions_dir / "@waiting.md" waiting_file.write_text("""--- title: Waiting --- - [ ] 2025-10-22 Wait for something +test-project """) config = ConfigManager(str(config_file)) completer = ProjectCompleter(config) # When result = completer.complete_project("Test Project") # Then assert "cannot complete" in result.lower() or "open items" in result.lower() assert "@waiting.md" in result assert project_file.exists() # Project not moved