feat: Add foundation for Jira issue creation workflow

plugins/titan-plugin-git/titan_plugin_git/steps/create_branch_step.py

@@ -2,8 +2,10 @@
 Create a new Git branch.
 """
 
+import traceback
+
 from titan_cli.engine import WorkflowContext, WorkflowResult, Success, Error
-from titan_plugin_git.exceptions import GitError
+from titan_cli.core.result import ClientSuccess, ClientError
 from ..operations import (
     check_branch_exists,
     determine_safe_checkout_target,
@@ -54,46 +56,63 @@ def create_branch_step(ctx: WorkflowContext) -> WorkflowResult:
         ctx.textual.dim_text(f"From: {start_point}")
 
         # Check if branch exists using operations
-        all_branches = ctx.git.get_branches()
-        branch_names = [b.name for b in all_branches]
-        branch_exists = check_branch_exists(new_branch, branch_names)
+        branches_result = ctx.git.get_branches()
+
+        match branches_result:
+            case ClientSuccess(data=all_branches):
+                branch_names = [b.name for b in all_branches]
+                branch_exists = check_branch_exists(new_branch, branch_names)
+            case ClientError(error_message=err):
+                ctx.textual.error_text(f"Failed to get branches: {err}")
+                ctx.textual.end_step("error")
+                return Error(f"Failed to get branches: {err}")
 
         # Delete if exists and requested using operations
         if should_delete_before_create(branch_exists, delete_if_exists):
             ctx.textual.text("")
             ctx.textual.warning_text(f"Branch {new_branch} exists, deleting...")
 
             # If we're on the branch, checkout another one first using operations
-            current_branch = ctx.git.get_current_branch()
-            safe_target = determine_safe_checkout_target(
-                current_branch=current_branch,
-                branch_to_delete=new_branch,
-                main_branch=ctx.git.main_branch,
-                all_branches=branch_names
-            )
-
-            if safe_target:
-                try:
-                    ctx.git.checkout(safe_target)
-                    ctx.textual.dim_text(f"Switched to {safe_target}")
-                except GitError as e:
-                    ctx.textual.error_text(f"Failed to checkout {safe_target}: {str(e)}")
+            current_branch_result = ctx.git.get_current_branch()
+
+            match current_branch_result:
+                case ClientSuccess(data=current_branch):
+                    safe_target = determine_safe_checkout_target(
+                        current_branch=current_branch,
+                        branch_to_delete=new_branch,
+                        main_branch=ctx.git.main_branch,
+                        all_branches=branch_names
+                    )
+
+                    if safe_target:
+                        checkout_result = ctx.git.checkout(safe_target)
+                        match checkout_result:
+                            case ClientSuccess():
+                                ctx.textual.dim_text(f"Switched to {safe_target}")
+                            case ClientError(error_message=err):
+                                ctx.textual.error_text(f"Failed to checkout {safe_target}: {err}")
+                                ctx.textual.end_step("error")
+                                return Error(f"Cannot checkout {safe_target}: {err}")
+                    elif current_branch == new_branch:
+                        # Cannot delete current branch and no safe target available
+                        ctx.textual.error_text(f"Cannot delete current branch {new_branch}")
+                        ctx.textual.end_step("error")
+                        return Error("Cannot delete current branch")
+
+                    # Delete the branch
+                    delete_result = ctx.git.safe_delete_branch(new_branch, force=True)
+                    match delete_result:
+                        case ClientSuccess():
+                            ctx.textual.success_text(f"✓ Deleted existing branch {new_branch}")
+                        case ClientError(error_message=err):
+                            ctx.textual.error_text(f"Failed to delete {new_branch}: {err}")
+                            ctx.textual.end_step("error")
+                            return Error(f"Failed to delete branch: {err}")
+
+                case ClientError(error_message=err):
+                    ctx.textual.error_text(f"Failed to get current branch: {err}")
                     ctx.textual.end_step("error")
-                    return Error(f"Cannot checkout {safe_target}: {str(e)}")
-            elif current_branch == new_branch:
-                # Cannot delete current branch and no safe target available
-                ctx.textual.error_text(f"Cannot delete current branch {new_branch}")
-                ctx.textual.end_step("error")
-                return Error("Cannot delete current branch")
-
-            # Delete the branch
-            try:
-                ctx.git.safe_delete_branch(new_branch, force=True)
-                ctx.textual.success_text(f"✓ Deleted existing branch {new_branch}")
-            except GitError as e:
-                ctx.textual.error_text(f"Failed to delete {new_branch}: {str(e)}")
-                ctx.textual.end_step("error")
-                return Error(f"Failed to delete branch: {str(e)}")
+                    return Error(f"Failed to get current branch: {err}")
 
         elif branch_exists:
             ctx.textual.error_text(f"Branch {new_branch} already exists")
@@ -103,21 +122,23 @@ def create_branch_step(ctx: WorkflowContext) -> WorkflowResult:
 
         # Create the branch
         ctx.textual.text("")
-        try:
-            ctx.git.create_branch(new_branch, start_point=start_point)
-            ctx.textual.success_text(f"✓ Created branch {new_branch}")
-        except GitError as e:
-            ctx.textual.error_text(f"Failed to create {new_branch}: {str(e)}")
-            ctx.textual.end_step("error")
-            return Error(f"Failed to create branch: {str(e)}")
+        create_result = ctx.git.create_branch(new_branch, start_point=start_point)
+        match create_result:
+            case ClientSuccess():
+                ctx.textual.success_text(f"✓ Created branch {new_branch}")
+            case ClientError(error_message=err):
+                ctx.textual.error_text(f"Failed to create {new_branch}: {err}")
+                ctx.textual.end_step("error")
+                return Error(f"Failed to create branch: {err}")
 
         # Checkout if requested
         if checkout:
-            try:
-                ctx.git.checkout(new_branch)
-                ctx.textual.success_text(f"✓ Checked out {new_branch}")
-            except GitError as e:
-                ctx.textual.warning_text(f"Branch created but failed to checkout: {str(e)}")
+            checkout_result = ctx.git.checkout(new_branch)
+            match checkout_result:
+                case ClientSuccess():
+                    ctx.textual.success_text(f"✓ Checked out {new_branch}")
+                case ClientError(error_message=err):
+                    ctx.textual.warning_text(f"Branch created but failed to checkout: {err}")
 
         ctx.textual.text("")
         ctx.textual.end_step("success")
@@ -131,9 +152,13 @@ def create_branch_step(ctx: WorkflowContext) -> WorkflowResult:
         )
 
     except Exception as e:
+        tb = traceback.format_exc()
         ctx.textual.text("")
         ctx.textual.error_text(f"Failed to create branch: {str(e)}")
         ctx.textual.text("")
+        ctx.textual.dim_text("Full traceback:")
+        for line in tb.split('\n'):
+            ctx.textual.dim_text(line)
         ctx.textual.end_step("error")
         return Error(f"Failed to create branch: {str(e)}")
 

plugins/titan-plugin-jira/docs/custom-templates.md

@@ -0,0 +1,167 @@
+# Custom Templates for Issues
+
+The **Create JIRA Issue** workflow allows using custom templates to generate issue descriptions.
+
+## Template Locations
+
+### Project Template (Recommended)
+
+Create your custom template at:
+
+```
+.titan/templates/issue_templates/default.md.j2
+```
+
+This template will be automatically used when you run the workflow.
+
+### Plugin Default Template
+
+If no project template exists, the plugin's default template is used:
+
+```
+plugins/titan-plugin-jira/titan_plugin_jira/config/templates/generic_issue.md.j2
+```
+
+## Template Format
+
+Templates use **Jinja2** and receive the following variables from the AI:
+
+| Variable | Type | Description |
+|----------|------|-------------|
+| `description` | string | Extended task description |
+| `objective` | string | Issue objective |
+| `acceptance_criteria` | string | Acceptance criteria (checkboxes) |
+| `technical_notes` | string or None | Technical notes (optional) |
+| `dependencies` | string or None | Dependencies (optional) |
+
+## Custom Template Example
+
+```jinja2
+## 📋 Description
+
+{{ description }}
+
+## 🎯 Objective
+
+{{ objective }}
+
+## ✅ Acceptance Criteria
+
+{{ acceptance_criteria }}
+
+{% if technical_notes %}
+---
+
+### 🔧 Technical Notes
+
+{{ technical_notes }}
+{% endif %}
+
+{% if dependencies %}
+---
+
+### 🔗 Dependencies
+
+{{ dependencies }}
+{% endif %}
+
+---
+
+*Created with Titan CLI*
+```
+
+## Creating Your Custom Template
+
+1. **Create the directory** (if it doesn't exist):
+
+```bash
+mkdir -p .titan/templates/issue_templates
+```
+
+2. **Create the template**:
+
+```bash
+cat > .titan/templates/issue_templates/default.md.j2 << 'EOF'
+## Description
+
+{{ description }}
+
+## Objective
+
+{{ objective }}
+
+## Acceptance Criteria
+
+{{ acceptance_criteria }}
+
+{% if technical_notes %}
+### Technical Notes
+
+{{ technical_notes }}
+{% endif %}
+EOF
+```
+
+3. **Run the workflow**:
+
+The workflow will automatically detect and use your template.
+
+## Tips
+
+- **Use Markdown**: Templates support full Markdown
+- **Optional sections**: Use `{% if variable %}` for conditional content
+- **Clean format**: The AI generates the content, your template structures it
+- **Emojis**: Add emojis for better readability (optional)
+- **Commits**: Version your template with Git to share it with the team
+
+## Advanced Example: Template with QA Checklist
+
+```jinja2
+## 📋 Description
+
+{{ description }}
+
+## 🎯 Objective
+
+{{ objective }}
+
+## ✅ Acceptance Criteria
+
+{{ acceptance_criteria }}
+
+{% if technical_notes %}
+---
+
+### 🔧 Implementation
+
+{{ technical_notes }}
+{% endif %}
+
+{% if dependencies %}
+---
+
+### 🔗 Dependencies
+
+{{ dependencies }}
+{% endif %}
+
+---
+
+## 🧪 QA Checklist
+
+- [ ] Unit tests implemented
+- [ ] Integration tests passing
+- [ ] Documentation updated
+- [ ] Code review approved
+- [ ] Works in staging
+
+---
+
+*Automatically generated by Titan CLI*
+```
+
+## Hooks and Extensibility
+
+This workflow is extensible via hooks in Titan. You can add custom steps before or after any workflow step.
+
+Refer to Titan documentation for more information about hooks.