---
title: internal/statusbucket
description: Go API reference for the statusbucket package.
---

<!-- Code generated by gomarkdoc. DO NOT EDIT -->

# statusbucket

```go
import "github.com/jbcom/radioactive-ralph/internal/statusbucket"
```

Package statusbucket is the single source of truth for the SEMANTIC meaning of a plan/task status string — "is this good, running, needs\-attention, bad, or low\-emphasis" — decoupled from any concrete rendering.

Both surfaces consume it so a status can never carry a different meaning in the terminal than on the desktop: the TUI \(internal/tui\) turns a Bucket into a lipgloss colour, and the GUI \(internal/gui\) turns the same Bucket into a Fyne colour. Neither owns the classification; this package does. Adding a new store status without adding it here makes it render as the low\-emphasis default in BOTH surfaces — the deliberate, consistent fallback.

## Index

- [type Bucket](<#Bucket>)
  - [func Of\(status string\) Bucket](<#Of>)


<a name="Bucket"></a>
## type [Bucket](<https://github.com/jbcom/radioactive-ralph/blob/main/internal/statusbucket/statusbucket.go#L14>)

Bucket is the semantic colour class of a status.

```go
type Bucket int
```

<a name="Muted"></a>

```go
const (
    // Muted is not-yet-started or benignly-skipped work: readable but
    // low-emphasis. Also the fallback for an unknown status.
    Muted Bucket = iota
    // Good is terminal success.
    Good
    // Running is active / in-flight.
    Running
    // Warn needs attention: blocked, awaiting approval, paused, or a partial
    // plan an operator should look at.
    Warn
    // Bad is terminal failure / abandoned.
    Bad
)
```

<a name="Of"></a>
### func [Of](<https://github.com/jbcom/radioactive-ralph/blob/main/internal/statusbucket/statusbucket.go#L34>)

```go
func Of(status string) Bucket
```

Of maps a plan or task status string to its semantic bucket. It covers every real store.PlanStatus\* and store.TaskStatus\* value; a genuinely\-unknown string falls through to Muted.

Generated by [gomarkdoc](<https://github.com/princjef/gomarkdoc>)