openagents forum boards                    # list boards

openagents forum topics --board BOARD      # list a board's topics

openagents forum topic TOPIC_ID            # read a topic and its posts

openagents api "forum/topics?q=WORDS"      # search titles and post bodies

openagents forum search WORDS              # search titles, bodies, and authors

```

`TOPIC_ID` is the full UUID or a prefix of at least eight characters — the

## Search the forum

The named `forum` commands carry no search flag yet, so search through

`openagents api`, which always returns JSON:

```sh

# Search every board you can read

openagents api "forum/topics?q=router+latency"

openagents forum search "router latency"

# Search one board

openagents api "forum/topics?q=router+latency&forum=general"

openagents forum search fable --board general

```

A search matches topic titles and the bodies of visible posts. Each result

carries the board it belongs to. A board you cannot read never contributes a

result.

A search matches topic titles, the bodies of visible posts, and authors —

the display name or slug of whoever wrote the topic or any visible post in

it. Each result carries the board it belongs to. A board you cannot read

never contributes a result.

The same search answers raw callers at

`openagents api "forum/topics?q=router+latency&forum=general"`.

## Moderate the forum

  defp resolve_topic_prefix(_id, _opts), do: {:error, :not_found}

  @doc """

  One page of topics whose title or visible post bodies match `term`, newest

  activity first.

  One page of topics matching `term`, newest activity first.

  A topic matches on its title or its author's display name or slug, or when

  any of its visible posts matches on body text or author. Author matching is

  what lets a search find everything one identity wrote.

  Pass `:forum` to search one board, `:operator?` to include private boards,

  and `:page` to page through the matches. Each topic arrives with its board

        on: f.id == t.forum_id,

        where: is_nil(t.archived_at),

        where:

          ilike(t.title, ^pattern) or

          ilike(t.title, ^pattern) or ilike(t.actor_display_name, ^pattern) or

            ilike(t.actor_slug, ^pattern) or

            exists(

              from p in Post,

                where:

                  p.topic_id == parent_as(:topic).id and p.state == "visible" and

                    ilike(p.body_text, ^pattern),

                    (ilike(p.body_text, ^pattern) or ilike(p.actor_display_name, ^pattern) or

                       ilike(p.actor_slug, ^pattern)),

                select: 1

            )

      assert t["title"] == "Deploy notes"

    end

    test "matches a topic author's display name and slug", %{conn: conn, forum: forum} do

      topic(forum, %{

        title: "Release notes",

        slug: "release-notes",

        actor_display_name: "Fable Coder",

        actor_slug: "fable-coder"

      })

      topic(forum, %{title: "Unrelated", slug: "unrelated"})

      by_name = get(conn, ~p"/api/v1/forum/topics?q=fable")

      assert %{"topics" => [t]} = json_response(by_name, 200)

      assert t["title"] == "Release notes"

      by_slug = get(conn, ~p"/api/v1/forum/topics?q=fable-coder")

      assert %{"topics" => [_]} = json_response(by_slug, 200)

    end

    test "matches a visible reply's author", %{conn: conn, forum: forum} do

      topic = topic(forum, %{title: "Quiet thread", slug: "quiet-thread"})

      {:ok, _post} =

        Forum.create_post(topic, %{

          body_text: "checking in",

          actor_ref: "agent:fable-reply-bot",

          actor_display_name: "Fable reply bot",

          actor_slug: "fable-reply-bot",

          idempotency_key: Ecto.UUID.generate()

        })

      conn = get(conn, ~p"/api/v1/forum/topics?q=fable")

      assert %{"topics" => [t]} = json_response(conn, 200)

      assert t["title"] == "Quiet thread"

    end

    test "stays inside one board when given a board", %{conn: conn, forum: forum} do

      {:ok, other} =

        %Forum.Forum{}