jira_get_assigned_issues

Instructions

Implementation Reference

• src/features/jira/issues/handlers/get-assigned-issues.handler.ts:20-89 (handler)

  GetAssignedIssuesHandler class: core implementation executing tool logic by invoking use case, formatting results, and handling specific JIRA errors with enhanced messages.

  export class GetAssignedIssuesHandler extends BaseToolHandler<
    GetAssignedIssuesParams,
    string
  > {
    private formatter: IssuesListFormatter;
  
    /**
     * Create a new GetAssignedIssuesHandler with use case
     *
     * @param getAssignedIssuesUseCase - Use case for retrieving assigned issues
     */
    constructor(
      private readonly getAssignedIssuesUseCase: GetAssignedIssuesUseCase,
    ) {
      super("JIRA", "Get Assigned Issues");
      this.formatter = new IssuesListFormatter();
    }
  
    /**
     * Execute the handler logic
     * Retrieves issues assigned to the current user and formats them
     */
    protected async execute(): Promise<string> {
      try {
        this.logger.info("Getting issues assigned to current user");
  
        // Get assigned issues using use case
        const assignedIssues = await this.getAssignedIssuesUseCase.execute();
  
        // Format the issues using the formatter
        return this.formatter.format(assignedIssues);
      } catch (error) {
        this.logger.error(`Failed to get assigned issues: ${error}`);
        throw this.enhanceError(error);
      }
    }
  
    /**
     * Enhance error messages for better user guidance
     */
    private enhanceError(error: unknown): Error {
      if (error instanceof JiraNotFoundError) {
        return new Error(
          "❌ **No Assigned Issues Found**\n\nNo issues are currently assigned to you.\n\n**Solutions:**\n- Verify you have JIRA issues assigned to your account\n- Check your JIRA permissions\n\n**Example:** `jira_get_assigned_issues`",
        );
      }
  
      if (error instanceof JiraPermissionError) {
        return new Error(
          `❌ **Permission Denied**\n\nYou don't have permission to search for issues.\n\n**Solutions:**\n- Check your JIRA permissions\n- Contact your JIRA administrator\n- Verify you have access to projects\n\n**Required Permissions:** Browse Projects`,
        );
      }
  
      if (error instanceof JiraApiError) {
        return new Error(
          `❌ **JIRA API Error**\n\n${error.message}\n\n**Solutions:**\n- Check your JIRA connection\n- Verify your user account is valid\n- Try again in a few moments\n\n**Note:** This searches for issues assigned to your user account`,
        );
      }
  
      if (error instanceof Error) {
        return new Error(
          `❌ **Search Failed**\n\n${error.message}\n\n**Solutions:**\n- Check your JIRA connection\n- Verify your permissions\n- Try again in a few moments\n\n**Note:** This searches for issues assigned to you`,
        );
      }
  
      return new Error(
        "❌ **Unknown Error**\n\nAn unknown error occurred while searching for assigned issues.\n\nPlease try again.",
      );
    }
  }

• src/features/jira/tools/configs/issue-tools.config.ts:42-47 (registration)

  Tool registration configuration: specifies name, description, empty input schema (params: {}), and binds the handler function.

  {
    name: "jira_get_assigned_issues",
    description: "Retrieves all JIRA issues assigned to the current user",
    params: {},
    handler: tools.jira_get_assigned_issues.handle.bind(tools.jira_get_assigned_issues),
  },

• src/features/jira/tools/factories/tool.factory.ts:101-103 (helper)

  Factory function creating the jira_get_assigned_issues ToolHandler wrapper that delegates calls to the instantiated GetAssignedIssuesHandler.

  jira_get_assigned_issues: {
    handle: async (args: unknown) => getAssignedIssuesHandler.handle(args),
  },

• src/features/jira/tools/registry/tool.registry.ts:66-73 (registration)

  Tool registry grouping: passes jira_get_assigned_issues to issue tools config factory as part of registration process.

  configs: createIssueToolsConfig({
    jira_get_issue: tools.jira_get_issue,
    jira_get_issue_comments: tools.jira_get_issue_comments,
    jira_get_assigned_issues: tools.jira_get_assigned_issues,
    jira_create_issue: tools.jira_create_issue,
    jira_update_issue: tools.jira_update_issue,
    jira_search_issues: tools.jira_search_issues,
  }),

• src/features/jira/tools/types/jira-tools.interface.ts:18-18 (schema)

  TypeScript interface defining the jira_get_assigned_issues tool handler signature.

  jira_get_assigned_issues: ToolHandler;