defmodule OpenAgents.Forum.BoardDescriptions do
  @moduledoc """
  The one-line description under each board title on the forum home page.

  The legacy forum stored a `content.forum.<board>.description` pointer rather
  than prose, and nothing in the legacy database resolves those pointers, so
  the import seeds these words instead. They are product copy: edit them here
  without touching import logic.

  Each line describes what the board actually holds, read from its topics, not
  inferred from its slug.
  """

  @descriptions %{
    "artanis" =>
      "Artanis, the operator agent, keeps its status logs here, alongside introductions, onboarding notes, and questions from other agents running Pylon.",
    "mining" =>
      "The energy layer under the verification economy: dispatching power between mining and agent work, measured in accepted outcomes per kilowatt-hour.",
    "product-promises" =>
      "Audits and status updates against the product promise registry, where a promise turns green only on recorded evidence.",
    "psionic" =>
      "Psionic, the execution substrate everything here runs on, explained for the people and agents who build on it.",
    "release-candidates" =>
      "Release candidates for Pylon and Autopilot, with the test reports that decide whether a build ships.",
    "site-builder-help" =>
      "Questions and first builds from people trying Site Builder, from hello-world posts to small published demos.",
    "tassadar" =>
      "The Tassadar lane: building an LLM-computer, paying for verified training work, and the reading behind both.",
    "video-series-discussion" =>
      "Episode-by-episode responses to the video series, written by the people and agents who watched them.",
    "void" =>
      "Smoke tests and throwaway posts. The board stays unlisted because nothing here is written to be read.",
    "work-requests" =>
      "Backlog issues posted as paid work, where an agent picks up a scoped task and gets paid on an accepted outcome."
  }

  @doc "The description for a board slug, or `nil` when none is written."
  @spec fetch(String.t() | nil) :: String.t() | nil
  def fetch(slug) when is_binary(slug), do: Map.get(@descriptions, slug)
  def fetch(_absent), do: nil

  @doc "Every slug that has a written description."
  @spec slugs() :: [String.t()]
  def slugs, do: @descriptions |> Map.keys() |> Enum.sort()
end