fixup! jira

wip

Author: bgaidioz

examples/jira/config.yml

@@ -8,9 +8,8 @@ projects:
     profiles:
       default:
         secrets:
-          # JIRA credentials - using "python" type to see DuckDB injection failure
           - name: "jira"
-            type: "python"  # This will cause DuckDB injection to fail
+            type: "python"
             parameters:
               url: "https://your-domain.atlassian.net"
               username: "your-email@example.com"

examples/jira/tools/get_issue.yml

@@ -4,10 +4,10 @@ tool:
   name: get_issue
   description: |
     Get detailed information for a specific JIRA issue by its key.
-    Returns comprehensive issue data including status, assignee, description, and metadata.
+    Returns comprehensive issue information including all fields, assignee, reporter, etc.
   type: tool
   annotations:
-    title: Get Issue Details
+    title: Get Issue
     readOnlyHint: true
     destructiveHint: false
     idempotentHint: true
@@ -19,100 +19,99 @@ tool:
     - name: issue_key
       type: string
       description: |
-        The JIRA issue key to retrieve. This is the unique identifier for the issue
-        (e.g., 'RD-123', 'TEST-456', 'PROJ-789').
-        Issue keys are typically in the format: PROJECT_KEY-NUMBER.
+        The issue key (e.g., 'RD-123', 'TEST-456').
+        This is the unique identifier for the issue visible in the Jira UI.
       examples: [
         "RD-123",
-        "TEST-456", 
-        "PROJ-789",
-        "DEV-42"
+        "TEST-456",
+        "PROJ-789"
       ]
   return:
     type: object
     properties:
       key:
         type: string
-        description: The issue key (e.g., "RD-123")
+        description: The issue key
       id:
         type: string
-        description: Internal numeric ID of the issue
+        description: The issue ID
       summary:
         type: string
-        description: Issue title/summary
+        description: The issue summary
       description:
         type: string
-        description: Detailed description of the issue
+        description: The issue description
       status:
         type: string
-        description: Current status (e.g., "To Do", "In Progress", "Done")
+        description: The current status
       assignee:
         type: string
-        description: Display name of the person assigned to this issue
+        description: The assignee display name
       assignee_account_id:
         type: string
-        description: Account ID of the assignee
+        description: The assignee account ID
       reporter:
         type: string
-        description: Display name of the person who reported this issue
+        description: The reporter display name
       reporter_account_id:
         type: string
-        description: Account ID of the reporter
+        description: The reporter account ID
       issue_type:
         type: string
-        description: Type of issue (e.g., "Bug", "Story", "Task", "Epic")
+        description: The issue type
       priority:
         type: string
-        description: Priority level (e.g., "High", "Medium", "Low")
+        description: The priority level
       resolution:
         type: string
-        description: Resolution status if resolved (e.g., "Fixed", "Won't Fix")
+        description: The resolution
       resolution_date:
         type: string
-        description: Date when the issue was resolved (ISO format)
+        description: The resolution date
       created:
         type: string
-        description: Date when the issue was created (ISO format)
+        description: The creation date
       updated:
         type: string
-        description: Date when the issue was last updated (ISO format)
+        description: The last update date
       due_date:
         type: string
-        description: Due date for the issue (ISO format)
+        description: The due date
       labels:
         type: array
         items:
           type: string
-        description: Labels/tags associated with the issue
+        description: The issue labels
       components:
         type: array
         items:
           type: string
-        description: Components this issue belongs to
+        description: The issue components
       fix_versions:
         type: array
         items:
           type: string
-        description: Versions where this issue will be/was fixed
+        description: The fix versions
       project:
         type: object
         properties:
           key:
             type: string
-            description: Project key (e.g., "RD")
           name:
             type: string
-            description: Project name
-        description: Project information
+        description: The project information
       parent:
         type: string
-        description: Parent issue key if this is a subtask
+        description: The parent issue key
       url:
         type: string
-        description: Direct URL to view the issue in JIRA web UI
+        description: The issue URL
       self:
         type: string
-        description: REST API URL for this issue resource
-    description: |
-      Comprehensive issue information including all key fields, metadata, and relationships.
-      Raises an error if the issue key is invalid or not accessible. 
+        description: The API self link
+  tests:
+    - name: "Get issue by key"
+      description: "Verify issue retrieval returns expected structure"
+      arguments:
+        - key: issue_key
+          value: "RD-15333"

examples/jira/tools/get_project.yml

@@ -3,11 +3,11 @@ mxcp: 1
 tool:
   name: get_project
   description: |
-    Get details for a specific project in your Jira instance by its project key.
-    Returns comprehensive project information including configuration and metadata.
+    Get details for a specific project by its key.
+    Returns comprehensive project information including description, settings, and lead.
   type: tool
   annotations:
-    title: Get Project Details
+    title: Get Project
     readOnlyHint: true
     destructiveHint: false
     idempotentHint: true
@@ -19,15 +19,58 @@ tool:
     - name: project_key
       type: string
       description: |
-        The project key to search for. This is the short identifier for the project (e.g., 'TEST' for project TEST).
-        Project keys are typically uppercase and contain only letters and numbers.
+        The project key (e.g., 'TEST' for project TEST).
+        This is the short identifier for the project.
       examples: [
         "TEST",
         "PROJ",
         "DEV"
       ]
   return:
     type: object
-    description: |
-      Project details object containing comprehensive information about the Jira project.
-      Raises an error if project is not found or access is denied. 
+    properties:
+      key:
+        type: string
+        description: The project key
+      name:
+        type: string
+        description: The project name
+      description:
+        type: string
+        description: The project description
+      projectTypeKey:
+        type: string
+        description: The project type key
+      simplified:
+        type: boolean
+        description: Whether the project is simplified
+      style:
+        type: string
+        description: The project style
+      isPrivate:
+        type: boolean
+        description: Whether the project is private
+      archived:
+        type: boolean
+        description: Whether the project is archived
+      lead:
+        type: object
+        properties:
+          displayName:
+            type: string
+          emailAddress:
+            type: string
+          accountId:
+            type: string
+          active:
+            type: boolean
+        description: The project lead information
+      url:
+        type: string
+        description: The project URL
+  tests:
+    - name: "Get project by key"
+      description: "Verify project retrieval returns expected structure"
+      arguments:
+        - key: project_key
+          value: "RD"

examples/jira/tools/get_project_role_users.yml

@@ -3,8 +3,8 @@ mxcp: 1
 tool:
   name: get_project_role_users
   description: |
-    Get users and groups assigned to a specific role in a JIRA project.
-    Returns detailed information about users and groups for the specified role.
+    Get users and groups for a specific role in a project.
+    Returns detailed information about users and groups assigned to the role.
   type: tool
   annotations:
     title: Get Project Role Users
@@ -19,8 +19,8 @@ tool:
     - name: project_key
       type: string
       description: |
-        The project key to get role users for. This is the short identifier for the project (e.g., 'TEST' for project TEST).
-        Project keys are typically uppercase and contain only letters and numbers.
+        The project key (e.g., 'TEST' for project TEST).
+        This is the short identifier for the project.
       examples: [
         "TEST",
         "PROJ",
@@ -29,13 +29,12 @@ tool:
     - name: role_name
       type: string
       description: |
-        The name of the role to get users for. This should be an exact match for one of the roles in the project.
-        Use get_project_roles to see available roles.
+        The name of the role to get users for.
+        Common roles include 'Administrators', 'Developers', 'Users'.
       examples: [
         "Administrators",
-        "Developers", 
-        "Service Desk Team",
-        "CI"
+        "Developers",
+        "Users"
       ]
   return:
     type: object
@@ -48,37 +47,32 @@ tool:
         description: The role name
       role_id:
         type: string
-        description: The unique role ID
+        description: The role ID
       users:
         type: array
         items:
           type: object
           properties:
             accountId:
               type: string
-              description: Unique account identifier for the user
             displayName:
               type: string
-              description: Display name of the user
-            emailAddress:
-              type: string
-              description: Email address of the user
-            active:
-              type: boolean
-              description: Whether the user account is active
-        description: List of users assigned to this role
+        description: List of users in the role
       groups:
         type: array
         items:
           type: object
           properties:
             name:
               type: string
-              description: Name of the group
             groupId:
               type: string
-              description: Unique group identifier
-        description: List of groups assigned to this role
-    description: |
-      Users and groups assigned to the specified role in the project.
-      Raises an error if project or role is not found, or access is denied. 
+        description: List of groups in the role
+  tests:
+    - name: "Get role users"
+      description: "Verify role users returns expected structure"
+      arguments:
+        - key: project_key
+          value: "RD"
+        - key: role_name
+          value: "Administrators"

examples/jira/tools/get_project_roles.yml

@@ -3,8 +3,8 @@ mxcp: 1
 tool:
   name: get_project_roles
   description: |
-    Get all roles available in a JIRA project.
-    Returns a list of roles with their names, IDs, and URLs.
+    Get all roles available in a project.
+    Returns a list of roles with their IDs and URLs.
   type: tool
   annotations:
     title: Get Project Roles
@@ -19,8 +19,8 @@ tool:
     - name: project_key
       type: string
       description: |
-        The project key to get roles for. This is the short identifier for the project (e.g., 'TEST' for project TEST).
-        Project keys are typically uppercase and contain only letters and numbers.
+        The project key (e.g., 'TEST' for project TEST).
+        This is the short identifier for the project.
       examples: [
         "TEST",
         "PROJ",
@@ -33,13 +33,16 @@ tool:
       properties:
         name:
           type: string
-          description: The name of the role (e.g., "Administrators", "Developers")
+          description: The role name
         id:
           type: string
-          description: The unique ID of the role
+          description: The role ID
         url:
           type: string
-          description: The REST API URL for this role
-    description: |
-      List of roles available in the project. Each role contains name, ID, and URL information.
-      Raises an error if project is not found or access is denied. 
+          description: The role URL
+  tests:
+    - name: "Get project roles"
+      description: "Verify project roles returns array of roles"
+      arguments:
+        - key: project_key
+          value: "RD"