Skip to main content

Check tq Command Output

Use tqstory to review tq command output without starting services, creating databases, or calling the issue-tracker API. Each scenario uses fixed data and calls the same output renderers as the CLI.

Run a scenario from the repository root:

go run ./cmd/tqstory <scenario>

go run requires the ./ package prefix in a Go module.

Scenarios

ScenarioOutput to review
tq_issue_listIssue list with project and status colors.
tq_issue_detailFull issue detail fields.
tq_issue_actionSuccessful issue action followed by issue detail.
tq_project_listProject table and identifier colors.
tq_emptyEmpty project-list message.
tq_project_checkPASS and FAIL project checks.
tq_service_statusRunning and stopped service states.
tq_migration_statusApplied and pending migration states.
tq_service_start_successSuccessful service-start result.
tq_service_stop_successSuccessful service-stop result.
tq_project_remove_successSuccessful project-removal result.
tq_workflow_remove_successSuccessful workflow-override removal result.
tq_project_remove_cancelledCancelled project-removal result.
tq_project_remove_confirmationProject-removal warning and confirmation prompt.
tq_warningDestructive-operation warning.
tq_service_start_failText-mode service-start failure.
tq_json_successSuccessful JSON output without ANSI escape sequences.
tq_json_errorJSON error output without ANSI escape sequences.
allEvery scenario, with a heading before each result.

Check Command Results

Use these scenarios when reviewing success, cancellation, and confirmation output from commands:

go run ./cmd/tqstory tq_service_start_success
go run ./cmd/tqstory tq_service_stop_success
go run ./cmd/tqstory tq_project_remove_success
go run ./cmd/tqstory tq_workflow_remove_success
go run ./cmd/tqstory tq_project_remove_cancelled
go run ./cmd/tqstory tq_project_remove_confirmation

The confirmation scenario only renders the prompt; it does not read input or remove a project.

Check Lists, Statuses, and Errors

go run ./cmd/tqstory tq_issue_list
go run ./cmd/tqstory tq_service_status
go run ./cmd/tqstory tq_migration_status
go run ./cmd/tqstory tq_service_start_fail
go run ./cmd/tqstory tq_json_error

Failure scenarios are visual previews and exit with status 0. This makes them suitable for manual checks and screenshots. JSON scenarios do not include ANSI escape sequences.

Review Every Scenario

Run all scenarios, with a heading before each result:

go run ./cmd/tqstory all

Pass an unknown scenario, or omit the scenario, to print the available scenario names and exit with status 2.