@spec add_usage(String.t(), map() | nil) ::
  {:ok, Vibe.Goals.Goal.t()} | :ok | {:error, term()}

@spec blocked(String.t() | nil) :: {:ok, Vibe.Goals.Goal.t()} | {:error, term()}

@spec clear(String.t() | nil) :: :ok | {:error, term()}

@spec complete(String.t() | nil) :: {:ok, Vibe.Goals.Goal.t()} | {:error, term()}

@spec context_block(String.t()) :: String.t()

@spec get(String.t() | nil) :: Vibe.Goals.Goal.t() | nil

@spec pause(String.t() | nil) :: {:ok, Vibe.Goals.Goal.t()} | {:error, term()}

@spec resume(String.t() | nil) :: {:ok, Vibe.Goals.Goal.t()} | {:error, term()}

@spec set(String.t(), String.t(), keyword()) ::
  {:ok, Vibe.Goals.Goal.t()} | {:error, term()}

@spec summary(Vibe.Goals.Goal.t() | nil) :: String.t()

@spec update_status(String.t() | nil, Vibe.Goals.Goal.status() | String.t()) ::
  {:ok, Vibe.Goals.Goal.t()} | {:error, term()}

@spec validate_objective(String.t()) :: {:ok, String.t()} | {:error, term()}