codee-agent 0.1.0__py3-none-any.whl

codee/templates/skills/story-planner/assets/readme-template.md

@@ -0,0 +1,43 @@
+# {STORY_ID}: {STORY_TITLE}
+
+**Issue Tracker:** {ISSUE_URL}
+**Created:** {DATE}
+
+## Background
+
+{Describe the problem, its impact, and the expected outcome.}
+
+## Technical Approach
+
+{Describe the proposed approach and the affected projects.}
+
+| Project | Changes |
+|---------|---------|
+| {project} | {brief description} |
+
+## Subtasks
+
+| # | ID | Title | Estimate | Dependencies |
+|---|----|-------|----------|--------------|
+| 1 | {ID} | {title} | {hours}h | None |
+
+### 1. {Subtask Title}
+
+**ID:** {SUBTASK_ID}
+**Estimate:** {hours}h
+
+{Describe the implementation scope and approach.}
+
+**Acceptance Criteria:**
+
+- [ ] {criterion}
+
+## Coverage
+
+| Story Acceptance Criterion | Covered By |
+|----------------------------|------------|
+| {criterion} | {subtask IDs} |
+
+## Open Questions
+
+- None

codee/templates/skills/story-qa/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: story-qa
+description: Validate one subtask from an Issue Tracker story against its acceptance criteria.
+disable-model-invocation: true
+x-codee-trigger: issue
+x-codee-issue-status: ['[AI] Ready for QA']
+x-codee-issue-type: story
+argument-hint: <STORY_ID>
+---
+
+# Story QA
+
+Validate one subtask per invocation. QA is read-only: do not modify the implementation or merge its merge request.
+
+## Workflow
+
+1. Read the story, acceptance criteria, attachments, comments, subtasks, and `story-spec/{STORY_ID}/README.md` when present.
+2. Select one delivered subtask that needs verification and locate its merge request and test environment.
+3. Read project instructions and relevant implementation details.
+4. Create a QA plan mapping every applicable acceptance criterion to a scenario, environment, method, and expected result.
+5. Execute each scenario and record the actual result.
+6. For UI work, test important paths, edge cases, responsive layout, keyboard behavior, and browser console output. Capture screenshots for static evidence and video for dynamic interactions.
+7. For service work, test success, validation, authorization, and edge cases. Record requests, responses, HTTP codes, and relevant side effects.
+8. Mark each criterion pass or fail and separate blocking defects from non-blocking observations.
+9. Post a concise Issue Tracker report with the results, evidence, environment, and actionable reproduction steps for failures.
+10. Update the story specification with a short QA summary when useful.
+
+Create a separate Issue Tracker item for unrelated defects instead of expanding the subtask.

codee/templates/skills/task-developer/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: task-developer
+description: Implement a standalone Issue Tracker task and submit a merge request.
+disable-model-invocation: true
+x-codee-trigger: issue
+x-codee-issue-status: ['[AI] Ready for development', '[AI] In Progress', Reopened]
+x-codee-issue-type: task
+argument-hint: <TASK_ID> [continue]
+---
+
+# Task Developer
+
+## Workflow
+
+1. Read the task, acceptance criteria, attachments, and comments in the Issue Tracker. With `continue`, also read new merge request feedback.
+2. Read the affected projects' `CLAUDE.md`, `AGENTS.md`, and relevant local skills.
+3. For bugs and regressions, reproduce the problem and identify the root cause before editing code. Report evidence when the issue cannot be reproduced or the root cause remains unclear.
+4. Create or reuse a dedicated worktree and branch according to repository conventions.
+5. Install dependencies and implement the smallest complete change that satisfies the acceptance criteria.
+6. Run focused tests, the project build, and browser validation for UI work.
+7. Review the complete diff for correctness, security, regressions, and missing tests.
+8. Commit, push, and create or update the merge request. Do not merge it unless explicitly requested.
+9. Add a concise Issue Tracker comment describing the change, validation, merge request, and any remaining risk.
+
+For UI work, include screenshots or video evidence when appropriate. On continued work, always refresh the Issue Tracker item and merge request before acting.

codee/templates/skills/task-qa/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: task-qa
+description: Validate a standalone Issue Tracker task against its acceptance criteria.
+disable-model-invocation: true
+x-codee-trigger: issue
+x-codee-issue-status: ['[AI] Ready for QA']
+x-codee-issue-type: task
+argument-hint: <TASK_ID>
+---
+
+# Task QA Engineer
+
+QA is read-only: do not modify the implementation or merge its merge request.
+
+## Workflow
+
+1. Read the task, acceptance criteria, attachments, and comments in the Issue Tracker.
+2. Locate the merge request and test environment, then read relevant project instructions and implementation details.
+3. Create a QA plan mapping every acceptance criterion to a scenario, environment, method, and expected result.
+4. Execute each scenario and record the actual result.
+5. For UI work, test important paths, edge cases, responsive layout, keyboard behavior, and browser console output. Capture screenshots for static evidence and video for dynamic interactions.
+6. For service work, test success, validation, authorization, and edge cases. Record requests, responses, HTTP codes, and relevant side effects.
+7. Mark each criterion pass or fail and separate blocking defects from non-blocking observations.
+8. Post a concise Issue Tracker report with the results, evidence, environment, and actionable reproduction steps for failures.
+
+Create a separate Issue Tracker item for unrelated defects instead of expanding the task.

codee/test_admin_api.py

@@ -0,0 +1,64 @@
+import unittest
+from unittest.mock import patch
+
+from starlette.testclient import TestClient
+
+from codee import admin_api
+
+
+class AzureDevOpsCallbackTest(unittest.TestCase):
+    """The OAuth callback route: never renders, always bounces back to /settings."""
+
+    def setUp(self) -> None:
+        # follow_redirects off: the 303 target is the thing under test.
+        self.client = TestClient(admin_api.api_app, follow_redirects=False)
+
+    def _location(self, response) -> str:
+        self.assertEqual(response.status_code, 303)
+        return response.headers["location"]
+
+    def test_successful_callback_redirects_with_the_outcome(self) -> None:
+        with patch.object(admin_api._service, "complete_azure_authorization",
+                          return_value=(True, "Connected to Azure DevOps as dev@acme.com")) as complete:
+            response = self.client.get(
+                admin_api.CALLBACK_PATH, params={"code": "code-1", "state": "state-1"})
+
+        complete.assert_called_once_with("code-1", "state-1")
+        location = self._location(response)
+        self.assertTrue(location.startswith("/settings?"))
+        self.assertIn("azure=connected", location)
+        self.assertIn("dev%40acme.com", location)
+
+    def test_failed_exchange_redirects_as_an_error(self) -> None:
+        with patch.object(admin_api._service, "complete_azure_authorization",
+                          return_value=(False, "Invalid client secret.")):
+            response = self.client.get(
+                admin_api.CALLBACK_PATH, params={"code": "code-1", "state": "state-1"})
+
+        self.assertIn("azure=error", self._location(response))
+
+    def test_refused_consent_reports_azures_own_message(self) -> None:
+        with patch.object(admin_api._service, "complete_azure_authorization") as complete:
+            response = self.client.get(admin_api.CALLBACK_PATH, params={
+                "error": "access_denied",
+                "error_description": "AADSTS65004: User declined.\r\nTrace ID: abc",
+            })
+
+        complete.assert_not_called()
+        location = self._location(response)
+        self.assertIn("azure=error", location)
+        self.assertIn("User+declined.", location)
+        # The trace id lines are noise in a toast.
+        self.assertNotIn("Trace", location)
+
+    def test_callback_without_a_code_is_rejected(self) -> None:
+        with patch.object(admin_api._service, "complete_azure_authorization") as complete:
+            response = self.client.get(
+                admin_api.CALLBACK_PATH, params={"state": "state-1"})
+
+        complete.assert_not_called()
+        self.assertIn("azure=error", self._location(response))
+
+
+if __name__ == "__main__":
+    unittest.main()

codee/test_admin_cli.py

@@ -0,0 +1,63 @@
+import os
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+from unittest.mock import patch
+
+from codee.admin_cli import RXCONFIG, _runtime_directory, main
+
+
+class AdminCliTest(unittest.TestCase):
+    def test_runtime_directory_writes_reflex_config(self) -> None:
+        with tempfile.TemporaryDirectory() as temporary_directory:
+            root = Path(temporary_directory)
+            with patch("codee.admin_cli.data_dir", return_value=root / ".codee"):
+                runtime = _runtime_directory(root)
+
+            self.assertEqual(runtime, root / ".codee" / "reflex")
+            self.assertEqual((runtime / "rxconfig.py").read_text(), RXCONFIG)
+
+    def test_main_launches_single_port_reflex(self) -> None:
+        original_directory = Path.cwd()
+        with tempfile.TemporaryDirectory() as temporary_directory:
+            root = Path(temporary_directory)
+            try:
+                with (
+                    patch("codee.admin_cli.project_root", return_value=root),
+                    patch("codee.admin_cli.data_dir",
+                          return_value=root / ".codee"),
+                    patch("reflex.reflex.cli") as reflex_cli,
+                    patch.object(
+                        sys, "argv", ["codee-admin", "--port", "8502"]),
+                ):
+                    self.assertEqual(main(), 0)
+                    launched_argv = sys.argv.copy()
+
+                reflex_cli.assert_called_once_with()
+                self.assertEqual(
+                    launched_argv,
+                    [
+                        "reflex",
+                        "run",
+                        "--env",
+                        "prod",
+                        "--single-port",
+                        "--frontend-port",
+                        "8502",
+                    ],
+                )
+                self.assertEqual(Path.cwd().resolve(),
+                                 (root / ".codee" / "reflex").resolve())
+                self.assertEqual(
+                    Path(os.environ["CODEE_PROJECT_ROOT"]
+                         ).resolve(), root.resolve()
+                )
+                self.assertEqual(
+                    os.environ["REFLEX_API_URL"], "http://127.0.0.1:8502")
+            finally:
+                os.chdir(original_directory)
+
+
+if __name__ == "__main__":
+    unittest.main()