Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/onenot8/issueLoop/llms.txt

Use this file to discover all available pages before exploring further.

The query functions let you inspect the ticket database without modifying any state. They are safe to call from dashboards, CI gating scripts, reports, and monitoring loops. Every function accepts an optional repo parameter — pass None or omit it to query across all repositories.

get_all_bugs

Returns every ticket in the database regardless of status or age.
all_tickets = issueloop.get_all_bugs()
all_tickets_for_repo = issueloop.get_all_bugs(repo="myrepo")
repo
str
Optional repository filter. None returns tickets from all repos.
Returns a list of ticket dicts. See Ticket object shape.

get_unresolved_bugs

Returns tickets whose status is pending, in_progress, blocked, or needs_human — everything except done and failed.
unresolved = issueloop.get_unresolved_bugs(repo="myrepo")
repo
str
Optional repository filter.
Returns a list of ticket dicts.

get_resolved_bugs

Returns tickets whose status is done.
resolved = issueloop.get_resolved_bugs(repo="myrepo")
repo
str
Optional repository filter.
Returns a list of ticket dicts.

get_failed_bugs

Returns tickets whose status is failed.
failed = issueloop.get_failed_bugs(repo="myrepo")
repo
str
Optional repository filter.
Returns a list of ticket dicts.

get_bugs_needing_human

Returns tickets whose status is needs_human — tickets that were escalated and require manual attention.
needs_human = issueloop.get_bugs_needing_human(repo="myrepo")
repo
str
Optional repository filter.
Returns a list of ticket dicts, each containing an escalation_summary explaining why the ticket was escalated.

get_bugs_by_status

Returns tickets matching a specific status string. Use this when the convenience wrappers above don’t cover the status you need (e.g. blocked or in_progress).
in_progress = issueloop.get_bugs_by_status("in_progress")
blocked = issueloop.get_bugs_by_status("blocked", repo="myrepo")
status
str
required
One of: pending, in_progress, blocked, done, failed, needs_human.
repo
str
Optional repository filter.
Returns a list of ticket dicts.

get_bugs_by_priority

Returns tickets matching a specific priority level.
blocking = issueloop.get_bugs_by_priority("blocking")
low_priority = issueloop.get_bugs_by_priority("low", repo="myrepo")
priority
str
required
One of: blocking, high, normal, low.
repo
str
Optional repository filter.
Returns a list of ticket dicts.

get_bug

Returns a single ticket by its UUID, or None if the ticket is not found.
ticket = issueloop.get_bug("550e8400-e29b-41d4-a716-446655440000")
ticket_id
str
required
UUID of the ticket to retrieve.
Returns a single ticket dict or None.

get_bug_count

Returns the total number of tickets in the database, optionally scoped to one repository.
total = issueloop.get_bug_count()
repo_total = issueloop.get_bug_count(repo="myrepo")
repo
str
Optional repository filter.
Returns an int.

get_bug_count_by_status

Returns a dict mapping each status to the number of tickets currently in that state. All status keys are always present in the returned dict even if their count is zero.
counts = issueloop.get_bug_count_by_status()
# {"pending": 3, "in_progress": 1, "blocked": 0, "done": 12, "failed": 2, "needs_human": 1}
repo
str
Optional repository filter.
Returns a dict with keys pending, in_progress, blocked, done, failed, needs_human and int values.

search_bugs

Performs a case-insensitive substring search against the error_summary field of all tickets.
results = issueloop.search_bugs("ImportError")
results_in_repo = issueloop.search_bugs("TypeError", repo="myrepo")
query
str
required
Substring to search for in error_summary. Case-insensitive.
repo
str
Optional repository filter.
Returns a list of matching ticket dicts.

get_oldest_bug

Returns the ticket with the earliest created_at timestamp.
oldest = issueloop.get_oldest_bug()
repo
str
Optional repository filter.
Returns a single ticket dict or None if there are no tickets.

get_newest_bug

Returns the ticket with the most recent created_at timestamp.
newest = issueloop.get_newest_bug(repo="myrepo")
repo
str
Optional repository filter.
Returns a single ticket dict or None if there are no tickets.
Pair get_oldest_bug() with get_newest_bug() to get a quick sense of the age spread of open issues in a repo — a large gap often indicates tickets that are being created but not resolved.

Build docs developers (and LLMs) love