ulu issues

Issue tracking and management. Query, update, close, and annotate validation issues.

Alias: ulu i

14 commands

issues list

List issues for a project with filtering options.

Arguments

projectrequired

Project name

Options

-s, --status <status>

Filter by status

opencompleteddeferredwontfix

-p, --priority <priority>

Filter by priority

criticalsuggestedbacklog

--severity <severity>

Filter by severity

criticalhighmediumlowinfo

-a, --agent <name>

Filter by agent name

-d, --domain <domain>

Filter by failure domain

STRSEMPRAEPI

-l, --limit <number>

Maximum number of issues

Default: 50

--include-resolved

Include resolved issues

ulu issues list <project>

Examples

# Open critical issues
ulu issues list my-project --status open --priority critical

# Epistemic issues from a specific agent
ulu issues list my-project --domain EPI --agent epictetus-analyst

issues get

Get issue details.

Arguments

idrequired

Issue ID

Options

--full

Include occurrences and notes

ulu issues get <id>

issues search

Search issues across all projects.

Options

--query <text>

Search query

-p, --projects <names>

Filter by project names (comma-separated)

-s, --status <status>

Filter by status

--priority <priority>

Filter by priority

-l, --limit <number>

Maximum results

Default: 20

ulu issues search

Examples

# Search for auth-related open issues
ulu issues search --query "authentication" --status open

issues create

Create a user-submitted issue.

Options

-p, --project <name>

Project name

-t, --title <text>

Issue title

--priority <priority>

Priority

criticalsuggestedbacklog

--severity <severity>

Severity

criticalhighmediumlowinfo

-a, --agent <name>

Agent name

--category <category>

Issue category

--description <text>

Detailed description

--file-path <path>

File path where issue was found

--line <number>

Line number in file

--failure-code <code>

Failure code (e.g., STR-OMI/H)

--domain <domain>

Failure domain

STRSEMPRAEPI

--type <type>

Issue type

bugfeaturerefactorconfigdocsinfrasecuritytest

ulu issues create

Examples

# Create a critical security issue
ulu issues create --project my-project --title "SQL injection in login" --priority critical --severity critical --type security --file-path src/auth/login.ts --line 45

issues update

Update issue status.

Arguments

idrequired

Issue ID

Options

-s, --status <status>

New status

opencompleteddeferredwontfix

-r, --reason <text>

Reason for status change

ulu issues update <id>

issues close

Close an issue (mark as completed).

Arguments

idrequired

Issue ID

Options

-r, --reason <text>

Reason for closing

ulu issues close <id>

Examples

# Close with resolution reason
ulu issues close abc123 --reason "Fixed in PR #42"

issues edit

Edit issue metadata (title, severity, priority, etc.).

Arguments

idrequired

Issue ID

Options

-t, --title <text>

New title

--severity <severity>

New severity

criticalhighmediumlowinfo

--priority <priority>

New priority

criticalsuggestedbacklog

--category <category>

New category

--file-path <path>

New file path

--line <number>

New line number

--failure-code <code>

New failure code

--domain <domain>

New failure domain

STRSEMPRAEPI

--type <type>

New issue type

ulu issues edit <id>

issues add-note

Add a note to an issue.

Arguments

idrequired

Issue ID

Options

-m, --message <text>

Note content

-t, --type <type>

Note type

contextresolutionblocker

Default: context

ulu issues add-note <id>

Examples

# Add a resolution note
ulu issues add-note abc123 --message "Root cause: race condition" --type resolution

issues history

Show issue status change history.

Arguments

idrequired

Issue ID

ulu issues history <id>

issues undo

Undo the last status change.

Arguments

idrequired

Issue ID

ulu issues undo <id>

issues restore

Restore a soft-deleted issue.

Arguments

idrequired

Issue ID

ulu issues restore <id>

issues bulk-update

Bulk update issue statuses.

Options

-i, --ids <ids>

Comma-separated issue IDs

-s, --status <status>

New status

opencompleteddeferredwontfix

-r, --reason <text>

Reason for status change

ulu issues bulk-update

Examples

# Bulk close multiple issues
ulu issues bulk-update --ids id1,id2,id3 --status completed --reason "Batch fix"

issues by-fingerprint

Get issue by SHA-256 fingerprint.

Arguments

fingerprintrequired

SHA-256 fingerprint

Options

--full

Include occurrences and notes

ulu issues by-fingerprint <fingerprint>

issues update-by-fingerprint

Update issue status by fingerprint.

Arguments

fingerprintrequired

SHA-256 fingerprint

Options

-s, --status <status>

New status

opencompleteddeferredwontfix

-r, --reason <text>

Reason for status change

ulu issues update-by-fingerprint <fingerprint>