titan-cli 0.1.5__py3-none-any.whl → 0.1.7__py3-none-any.whl

titan_plugin_jira/steps/list_versions_step.py

@@ -0,0 +1,133 @@
+"""
+List available versions (fixVersions) for a JIRA project
+"""
+
+from titan_cli.engine import WorkflowContext, WorkflowResult, Success, Error
+from ..exceptions import JiraAPIError
+
+
+def list_versions_step(ctx: WorkflowContext) -> WorkflowResult:
+    """
+    List unreleased versions for a JIRA project.
+
+    Filters and returns only versions that are not yet released,
+    sorted by name in descending order (most recent first).
+
+    Inputs (from ctx.data):
+        project_key (str, optional): Project key. If not provided, uses default_project from JIRA plugin config.
+
+    Outputs (saved to ctx.data):
+        versions (list): List of unreleased version names
+        versions_full (list): List of full unreleased version objects
+
+    Returns:
+        Success: Unreleased versions listed
+        Error: Failed to fetch versions or project_key not configured
+
+    Example usage in workflow:
+        ```yaml
+        - id: list_versions
+          plugin: jira
+          step: list_versions
+          params:
+            project_key: "MYPROJECT"
+        ```
+    """
+    if not ctx.textual:
+        return Error("Textual UI context is not available for this step.")
+
+    if not ctx.jira:
+        return Error("JIRA client not available in context")
+
+    # Begin step container
+    ctx.textual.begin_step("List Project Versions")
+
+    # Get project key from context or fall back to default_project from JIRA client
+    project_key = ctx.get("project_key")
+    if not project_key:
+        # Try to use default project from JIRA client config
+        if hasattr(ctx.jira, 'project_key') and ctx.jira.project_key:
+            project_key = ctx.jira.project_key
+            ctx.textual.dim_text(f"Using default project from JIRA config: {project_key}")
+        else:
+            ctx.textual.error_text("project_key is required but not provided")
+            ctx.textual.dim_text("Set project_key in workflow params or configure default_project in JIRA plugin")
+            ctx.textual.end_step("error")
+            return Error("project_key is required. Provide it in workflow params or configure default_project in JIRA plugin.")
+
+    # Show fetching message
+    ctx.textual.dim_text(f"Fetching versions for project: {project_key}")
+    ctx.textual.text("")
+
+    try:
+        # Get project details which includes versions
+        project = ctx.jira.get_project(project_key)
+        versions = project.get("versions", [])
+
+        if not versions:
+            ctx.textual.panel(
+                f"No versions found for project {project_key}", panel_type="info"
+            )
+            ctx.textual.end_step("skip")
+            return Success(
+                "No versions found", metadata={"versions": [], "versions_full": []}
+            )
+
+        # Filter only unreleased versions for release notes workflow
+        unreleased_versions = [v for v in versions if not v.get("released", False)]
+
+        # Sort unreleased by name descending (most recent first)
+        unreleased_versions.sort(key=lambda v: v.get("name", ""), reverse=True)
+
+        # Use only unreleased versions
+        sorted_versions = unreleased_versions
+
+        # Extract version names
+        version_names = [v.get("name", "") for v in sorted_versions]
+
+        # Show success panel
+        ctx.textual.text("")
+        ctx.textual.panel(
+            f"Found {len(sorted_versions)} unreleased versions",
+            panel_type="success",
+        )
+
+        # Show versions list
+        ctx.textual.text("")
+        ctx.textual.bold_primary_text("Unreleased Versions:")
+        ctx.textual.text("")
+
+        for v in sorted_versions[:20]:  # Show first 20
+            name = v.get("name", "")
+            description = v.get("description", "")
+            desc_text = f" - {description[:50]}" if description else ""
+            ctx.textual.primary_text(f"  • {name}{desc_text}")
+
+        if len(sorted_versions) > 20:
+            ctx.textual.dim_text(
+                f"  ... and {len(sorted_versions) - 20} more"
+            )
+        ctx.textual.text("")
+
+        ctx.textual.end_step("success")
+        return Success(
+            f"Found {len(sorted_versions)} unreleased versions",
+            metadata={"versions": version_names, "versions_full": sorted_versions},
+        )
+
+    except JiraAPIError as e:
+        error_msg = f"Failed to fetch versions: {e}"
+        ctx.textual.panel(error_msg, panel_type="error")
+        ctx.textual.end_step("error")
+        return Error(error_msg)
+    except Exception as e:
+        import traceback
+
+        error_detail = traceback.format_exc()
+        error_msg = f"Unexpected error: {e}\n\nTraceback:\n{error_detail}"
+        ctx.textual.panel(error_msg, panel_type="error")
+        ctx.textual.end_step("error")
+        return Error(error_msg)
+
+
+__all__ = ["list_versions_step"]

titan_plugin_jira/steps/prompt_select_issue_step.py

@@ -26,12 +26,12 @@ def prompt_select_issue_step(ctx: WorkflowContext) -> WorkflowResult:
     # Get issues from previous search
     issues = ctx.get("jira_issues")
     if not issues:
-        ctx.textual.text(msg.Steps.PromptSelectIssue.NO_ISSUES_AVAILABLE, markup="red")
+        ctx.textual.error_text(msg.Steps.PromptSelectIssue.NO_ISSUES_AVAILABLE)
         ctx.textual.end_step("error")
         return Error(msg.Steps.PromptSelectIssue.NO_ISSUES_AVAILABLE)
 
     if len(issues) == 0:
-        ctx.textual.text(msg.Steps.PromptSelectIssue.NO_ISSUES_AVAILABLE, markup="red")
+        ctx.textual.error_text(msg.Steps.PromptSelectIssue.NO_ISSUES_AVAILABLE)
         ctx.textual.end_step("error")
         return Error(msg.Steps.PromptSelectIssue.NO_ISSUES_AVAILABLE)
 
@@ -46,7 +46,7 @@ def prompt_select_issue_step(ctx: WorkflowContext) -> WorkflowResult:
         )
 
         if not response or not response.strip():
-            ctx.textual.text(msg.Steps.PromptSelectIssue.NO_ISSUE_SELECTED, markup="red")
+            ctx.textual.error_text(msg.Steps.PromptSelectIssue.NO_ISSUE_SELECTED)
             ctx.textual.end_step("error")
             return Error(msg.Steps.PromptSelectIssue.NO_ISSUE_SELECTED)
 
@@ -54,13 +54,13 @@ def prompt_select_issue_step(ctx: WorkflowContext) -> WorkflowResult:
         try:
             selected_index = int(response.strip())
         except ValueError:
-            ctx.textual.text(f"Invalid input: '{response}' is not a number", markup="red")
+            ctx.textual.error_text(f"Invalid input: '{response}' is not a number")
             ctx.textual.end_step("error")
             return Error(f"Invalid input: '{response}' is not a number")
 
         # Validate it's in range
         if selected_index < 1 or selected_index > len(issues):
-            ctx.textual.text(f"Invalid selection: must be between 1 and {len(issues)}", markup="red")
+            ctx.textual.error_text(f"Invalid selection: must be between 1 and {len(issues)}")
             ctx.textual.end_step("error")
             return Error(f"Invalid selection: must be between 1 and {len(issues)}")
 
@@ -68,12 +68,11 @@ def prompt_select_issue_step(ctx: WorkflowContext) -> WorkflowResult:
         selected_issue = issues[selected_index - 1]
 
         ctx.textual.text("")
-        ctx.textual.text(
+        ctx.textual.success_text(
             msg.Steps.PromptSelectIssue.ISSUE_SELECTION_CONFIRM.format(
                 key=selected_issue.key,
                 summary=selected_issue.summary
-            ),
-            markup="green"
+            )
         )
 
         ctx.textual.end_step("success")
@@ -85,7 +84,7 @@ def prompt_select_issue_step(ctx: WorkflowContext) -> WorkflowResult:
             }
         )
     except (KeyboardInterrupt, EOFError):
-        ctx.textual.text("User cancelled issue selection", markup="red")
+        ctx.textual.error_text("User cancelled issue selection")
         ctx.textual.end_step("error")
         return Error("User cancelled issue selection")
 

titan_plugin_jira/steps/search_jql_step.py

@@ -0,0 +1,191 @@
+"""
+Search JIRA issues using custom JQL query
+"""
+
+from titan_cli.engine import WorkflowContext, WorkflowResult, Success, Error
+from titan_cli.ui.tui.widgets import Table
+from ..exceptions import JiraAPIError
+from ..messages import msg
+from ..utils import IssueSorter
+
+
+def search_jql_step(ctx: WorkflowContext) -> WorkflowResult:
+    """
+    Search JIRA issues using a custom JQL query.
+
+    This is a generic search step that accepts raw JQL and allows variable substitution.
+    Use this when you need a specific query that isn't covered by saved queries.
+
+    Inputs (from ctx.data):
+        jql (str): JQL query string (supports variable substitution with ${var_name})
+        max_results (int, optional): Maximum number of results (default: 100)
+
+    Outputs (saved to ctx.data):
+        jira_issues (list): List of JiraTicket objects
+        jira_issue_count (int): Number of issues found
+
+    Returns:
+        Success: Issues found
+        Error: Search failed or JQL not provided
+
+    Variable substitution:
+        You can use ${variable_name} in the JQL and it will be replaced with values from ctx.data.
+        Example: "project = ${project_key} AND fixVersion = ${fix_version}"
+
+    Example usage in workflow:
+        ```yaml
+        - id: search_issues
+          plugin: jira
+          step: search_jql
+          params:
+            jql: "project = MYPROJECT AND status = 'In Progress' ORDER BY created DESC"
+            max_results: 50
+
+        # With variable substitution:
+        - id: search_release
+          plugin: jira
+          step: search_jql
+          params:
+            jql: "project = ${project_key} AND fixVersion = ${fix_version} ORDER BY created DESC"
+        ```
+    """
+    if not ctx.textual:
+        return Error("Textual UI context is not available for this step.")
+
+    # Begin step container
+    ctx.textual.begin_step("Search JIRA Issues")
+
+    if not ctx.jira:
+        ctx.textual.error_text(msg.Plugin.CLIENT_NOT_AVAILABLE_IN_CONTEXT)
+        ctx.textual.end_step("error")
+        return Error(msg.Plugin.CLIENT_NOT_AVAILABLE_IN_CONTEXT)
+
+    # Get JQL query
+    jql = ctx.get("jql")
+    if not jql:
+        error_msg = "JQL query is required but not provided"
+        ctx.textual.error_text(error_msg)
+        ctx.textual.dim_text("Provide 'jql' parameter in workflow step")
+        ctx.textual.end_step("error")
+        return Error(error_msg)
+
+    # Perform variable substitution: replace ${var} with ctx.data values
+    # This allows dynamic queries like "project = ${project_key}"
+    import re
+
+    def replace_var(match):
+        var_name = match.group(1)
+        value = ctx.get(var_name)
+        if value is None:
+            # Variable not found in context, keep original placeholder
+            return match.group(0)
+        return str(value)
+
+    # Replace ${variable} patterns
+    jql = re.sub(r'\$\{([^}]+)\}', replace_var, jql)
+
+    # Show which query is being executed
+    ctx.textual.text("")
+    ctx.textual.bold_text("Executing JQL Query:")
+    ctx.textual.dim_text(f"  {jql}")
+    ctx.textual.text("")
+
+    # Get max results
+    max_results = ctx.get("max_results", 100)
+
+    try:
+        # Execute search with loading indicator
+        # Request ALL fields including custom fields
+        with ctx.textual.loading("Searching JIRA issues..."):
+            issues = ctx.jira.search_tickets(jql=jql, max_results=max_results, fields=["*all"])
+
+        if not issues:
+            ctx.textual.dim_text("No issues found")
+            ctx.textual.end_step("success")
+            return Success(
+                "No issues found",
+                metadata={
+                    "jira_issues": [],
+                    "issues": [],  # Alias for compatibility
+                    "jira_issue_count": 0
+                }
+            )
+
+        # Show results
+        ctx.textual.text("")  # spacing
+        ctx.textual.success_text(f"Found {len(issues)} issues")
+        ctx.textual.text("")
+
+        # Show detailed table
+        ctx.textual.bold_text("Found Issues:")
+        ctx.textual.text("")
+
+        try:
+            # Sort issues intelligently
+            sorter = IssueSorter()
+            sorted_issues = sorter.sort(issues)
+
+            # Prepare table data with row numbers for selection
+            headers = ["#", "Key", "Status", "Summary", "Assignee", "Type", "Priority"]
+            rows = []
+            for i, issue in enumerate(sorted_issues, 1):
+                assignee = issue.assignee or "Unassigned"
+                status = issue.status or "Unknown"
+                priority = issue.priority or "Unknown"
+                issue_type = issue.issue_type or "Unknown"
+                summary = (issue.summary or "No summary")[:60]
+
+                rows.append([
+                    str(i),
+                    issue.key,
+                    status,
+                    summary,
+                    assignee,
+                    issue_type,
+                    priority
+                ])
+
+            # Render table using textual widget
+            ctx.textual.mount(
+                Table(
+                    headers=headers,
+                    rows=rows,
+                    title=f"Issues (sorted by {sorter.get_sort_description()})"
+                )
+            )
+
+            # Use sorted issues for downstream steps
+            issues = sorted_issues
+        except Exception as e:
+            # If table rendering fails, show error but continue with raw issue list
+            ctx.textual.error_text(f"Error rendering table: {e}")
+            ctx.textual.primary_text(f"Found {len(issues)} issues (showing raw data)")
+            for i, issue in enumerate(issues, 1):
+                ctx.textual.text(f"{i}. {issue.key} - {getattr(issue, 'summary', 'N/A')}")
+            ctx.textual.text("")
+
+        ctx.textual.end_step("success")
+        return Success(
+            f"Found {len(issues)} issues",
+            metadata={
+                "jira_issues": issues,
+                "issues": issues,  # Alias for compatibility
+                "jira_issue_count": len(issues)
+            }
+        )
+
+    except JiraAPIError as e:
+        error_msg = f"JIRA search failed: {e}"
+        ctx.textual.error_text(error_msg)
+        ctx.textual.end_step("error")
+        return Error(error_msg)
+    except Exception as e:
+        import traceback
+        error_detail = traceback.format_exc()
+        error_msg = f"Unexpected error: {e}\n\nTraceback:\n{error_detail}"
+        ctx.textual.error_text(error_msg)
+        ctx.textual.end_step("error")
+        return Error(error_msg)
+
+
+__all__ = ["search_jql_step"]

titan_plugin_jira/steps/search_saved_query_step.py

@@ -61,14 +61,14 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
     ctx.textual.begin_step("Search Open Issues")
 
     if not ctx.jira:
-        ctx.textual.text(msg.Plugin.CLIENT_NOT_AVAILABLE_IN_CONTEXT, markup="red")
+        ctx.textual.error_text(msg.Plugin.CLIENT_NOT_AVAILABLE_IN_CONTEXT)
         ctx.textual.end_step("error")
         return Error(msg.Plugin.CLIENT_NOT_AVAILABLE_IN_CONTEXT)
 
     # Get query name
     query_name = ctx.get("query_name")
     if not query_name:
-        ctx.textual.text(msg.Steps.Search.QUERY_NAME_REQUIRED, markup="red")
+        ctx.textual.error_text(msg.Steps.Search.QUERY_NAME_REQUIRED)
         ctx.textual.end_step("error")
         return Error(msg.Steps.Search.QUERY_NAME_REQUIRED)
 
@@ -107,7 +107,7 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
             error_msg += "\n\n" + msg.Steps.Search.ADD_CUSTOM_HINT + "\n"
             error_msg += msg.Steps.Search.CUSTOM_QUERY_EXAMPLE
 
-        ctx.textual.text(error_msg, markup="red")
+        ctx.textual.error_text(error_msg)
         ctx.textual.end_step("error")
         return Error(error_msg)
 
@@ -125,7 +125,7 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
 
         if not project:
             error_msg = msg.Steps.Search.PROJECT_REQUIRED.format(query_name=query_name, jql=jql)
-            ctx.textual.text(error_msg, markup="red")
+            ctx.textual.error_text(error_msg)
             ctx.textual.end_step("error")
             return Error(error_msg)
 
@@ -136,8 +136,8 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
     source_label = "Custom" if is_custom else "Predefined"
 
     ctx.textual.text("")
-    ctx.textual.text(f"Using {source_label} Query: {query_name}", markup="bold")
-    ctx.textual.text(f"  JQL: {jql}", markup="dim")
+    ctx.textual.bold_text(f"Using {source_label} Query: {query_name}")
+    ctx.textual.dim_text(f"  JQL: {jql}")
     ctx.textual.text("")
 
     # Get max results
@@ -149,7 +149,7 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
             issues = ctx.jira.search_tickets(jql=jql, max_results=max_results)
 
         if not issues:
-            ctx.textual.text(f"No issues found for query: {query_name}", markup="dim")
+            ctx.textual.dim_text(f"No issues found for query: {query_name}")
             ctx.textual.end_step("success")
             return Success(
                 "No issues found",
@@ -162,11 +162,11 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
 
         # Show results
         ctx.textual.text("")  # spacing
-        ctx.textual.text(f"Found {len(issues)} issues", markup="green")
+        ctx.textual.success_text(f"Found {len(issues)} issues")
         ctx.textual.text("")
 
         # Show detailed table
-        ctx.textual.text("Found Issues:", markup="bold")
+        ctx.textual.bold_text("Found Issues:")
         ctx.textual.text("")
 
         try:
@@ -207,8 +207,8 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
             issues = sorted_issues
         except Exception as e:
             # If table rendering fails, show error but continue with raw issue list
-            ctx.textual.text(f"Error rendering table: {e}", markup="red")
-            ctx.textual.text(f"Found {len(issues)} issues (showing raw data)", markup="cyan")
+            ctx.textual.error_text(f"Error rendering table: {e}")
+            ctx.textual.primary_text(f"Found {len(issues)} issues (showing raw data)")
             for i, issue in enumerate(issues, 1):
                 ctx.textual.text(f"{i}. {issue.key} - {getattr(issue, 'summary', 'N/A')}")
             ctx.textual.text("")
@@ -225,14 +225,14 @@ def search_saved_query_step(ctx: WorkflowContext) -> WorkflowResult:
 
     except JiraAPIError as e:
         error_msg = f"JIRA search failed: {e}"
-        ctx.textual.text(error_msg, markup="red")
+        ctx.textual.error_text(error_msg)
         ctx.textual.end_step("error")
         return Error(error_msg)
     except Exception as e:
         import traceback
         error_detail = traceback.format_exc()
         error_msg = f"Unexpected error: {e}\n\nTraceback:\n{error_detail}"
-        ctx.textual.text(error_msg, markup="red")
+        ctx.textual.error_text(error_msg)
         ctx.textual.end_step("error")
         return Error(error_msg)
 

titan_plugin_jira/utils/__init__.py

@@ -9,5 +9,5 @@ __all__ = [
     "SavedQueries",
     "SAVED_QUERIES",
     "IssueSorter",
-    "IssueSortConfig"
+    "IssueSortConfig",
 ]