--accent-bright: #828fff;

  --info: #4ea7fc;

  --success: #27a644;

  --done: #ab7df8; /* GitHub's closed-as-completed purple */

  --warning: #d4b144;

  --danger: #eb5757;

     hover/visited state rather than the resting one. */

  --accent: #5e6ad2;

  --accent-bright: #4a55b8;

  --done: #8250df; /* GitHub's light-theme closed-as-completed purple */

  --text-body: #3c4149;

  --text-muted: #62666d;

    --issue-tint: var(--info);

  }

  .issue-status[data-category="open"],

  .issue-group[data-category="open"] {

    --issue-tint: var(--success);

  }

  .issue-status[data-category="completed"],

  .issue-group[data-category="completed"] {

    --issue-tint: var(--success);

    --issue-tint: var(--done);

  }

  .issue-status {

`brand-*` name, and follow the attribution and trademark rules in

`priv/brand/README.md`.

## Octicons

Issue-state glyphs live in `priv/octicons`, vendored verbatim from

[Primer Octicons](https://github.com/primer/octicons) (MIT) at the commit

recorded in `priv/octicons/README.md`. They render through `icon/1` under

`octicon-*` names.

OpenAgents is a GitHub-compatible forge, so issue state is domain vocabulary:

open takes `octicon-issue-opened` and a completed close takes

`octicon-issue-closed`. Neither governed tier carries those concepts — the Apps

SDK set has no issue glyph, and Heroicons has no circle-dot. State color comes

from palette tokens at the call site (`--success` for open, `--done` for

closed), never from the file.

Adding or upgrading an octicon follows the same rule as every other tier:

copy the upstream file at the pinned commit, update the README's commit, date,

and count, and run `mix precommit`.

## Accessibility

A glyph beside visible words is decorative and needs no label. Put

  alias OpenAgentsWeb.UI

  alias Phoenix.LiveView.JS

  @categories [:triage, :backlog, :unstarted, :started, :completed, :canceled]

  @categories [:open, :triage, :backlog, :unstarted, :started, :completed, :canceled]

  @priorities [:none, :low, :medium, :high, :urgent]

  @tones [:neutral, :primary, :info, :success, :warning, :danger]

  @presences [:none, :online, :away, :offline]

    do: :canceled

  defp state_category("closed", _reason), do: :completed

  defp state_category(_state, _reason), do: :unstarted

  defp state_category(_state, _reason), do: :open

  defp state_label("closed", "not_planned"), do: "Closed as not planned"

  defp state_label("closed", "duplicate"), do: "Closed as duplicate"

  # opposing arrows in a disc, which `compare-arrows` says exactly; the dashed

  # gear it uses for backlog has no equivalent and `circle-dashed` carries the

  # same "not yet real" reading without vendoring a glyph for one state.

  # GitHub's issue-state glyphs. Open is the green circle-dot and a completed

  # close is the purple check-circle; the other categories keep the triage

  # glyphs because GitHub itself has no opinion about them.

  defp category_icon(:open), do: "octicon-issue-opened"

  defp category_icon(:triage), do: "compare-arrows"

  defp category_icon(:backlog), do: "circle-dashed"

  defp category_icon(:unstarted), do: "empty-circle"

  defp category_icon(:completed), do: "check-circle-filled"

  # :started draws the conic-gradient arc in CSS, never a glyph.

  defp category_icon(:completed), do: "octicon-issue-closed"

  defp category_icon(:canceled), do: "x-circle-filled"

  defp priority_name(:none), do: "No priority"

  end

  @doc """

  GitHub's two states, and nothing invented on top of them.

  GitHub's state iconography, and nothing invented on top of it.

  `not_planned` is the one close reason with a distinct reading, so it takes

  the cancelled glyph; every other close is a completion.

  An open issue takes the green circle-dot. `not_planned` is the one close

  reason with a distinct reading, so it keeps the cancelled glyph; every other

  close is the purple check-circle.

  """

  def category(%{state: "closed", state_reason: "not_planned"}), do: :canceled

  def category(%{state: "closed"}), do: :completed

  def category(_issue), do: :unstarted

  def category(_issue), do: :open

  @doc "The word beside the glyph, for assistive technology and for a label."

  def status_label(%{state: "closed", state_reason: "not_planned"}), do: "Closed as not planned"

  # generic icon library. They are namespaced `brand-*`. See priv/brand/README.md.

  @brand_dir Path.join([__DIR__, "..", "..", "priv", "brand"]) |> Path.expand()

  # Issue-state glyphs from Primer Octicons. See priv/octicons/README.md.

  @octicons_dir Path.join([__DIR__, "..", "..", "priv", "octicons"]) |> Path.expand()

  @paths (@icons_dir |> Path.join("*.svg") |> Path.wildcard()) ++

           (@brand_dir |> Path.join("*.svg") |> Path.wildcard())

           (@brand_dir |> Path.join("*.svg") |> Path.wildcard()) ++

           (@octicons_dir |> Path.join("*.svg") |> Path.wildcard())

  for path <- @paths do

    @external_resource path

  @icons Map.new(@paths, fn path ->

           base = Path.basename(path, ".svg")

           name = if Path.dirname(path) == @brand_dir, do: "brand-" <> base, else: base

           name =

             cond do

               Path.dirname(path) == @brand_dir -> "brand-" <> base

               Path.dirname(path) == @octicons_dir -> "octicon-" <> base

               true -> base

             end

           contents = path |> File.read!() |> String.trim()

           view_box =

  defp close_icon(%{state_reason: reason}) when reason in ["not_planned", "duplicate"],

    do: "x-circle-filled"

  defp close_icon(_issue), do: "check-circle-filled"

  defp close_icon(_issue), do: "octicon-issue-closed"

  defp close_tone(%{state_reason: reason}) when reason in ["not_planned", "duplicate"],

    do: :danger

# Octicons (vendored)

Generated files. **Do not edit these by hand.**

- Upstream: [primer/octicons](https://github.com/primer/octicons)

- Commit: `0e21a4c2d8449102f10e533d241f04797af0914c`

- License: MIT, Copyright GitHub, Inc. — see upstream repository

- Vendored: 2026-08-22

- Count: 2 glyphs

## Why this set exists

OpenAgents is a GitHub-compatible forge. Issue state iconography is a domain

contract — the green circle-dot for open and the purple check-circle for closed

are what users expect on an issues surface — and neither governed tier carries

it:

- The Apps SDK UI set (`priv/icons`) has no issue-state glyph.

- Heroicons (the `hero-*` fallback) has no circle-dot and its check-circle

  reads as success feedback, not issue state.

These two glyphs are vendored verbatim from Primer Octicons at the pinned

commit above. To add or upgrade one, copy the matching `*-16.svg` from the

upstream checkout, update the commit, date, and count here, update

`docs/ICONS.md`, and run `mix precommit`.

`OpenAgentsWeb.Icons` embeds these files under `octicon-*` names, so call

sites render `<.icon name="octicon-issue-opened" />`. State color comes from

palette tokens at the call site, never from the file.

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><path d="M11.28 6.78a.75.75 0 0 0-1.06-1.06L7.25 8.69 5.78 7.22a.75.75 0 0 0-1.06 1.06l2 2a.75.75 0 0 0 1.06 0l3.5-3.5Z"/><path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0Zm-1.5 0a6.5 6.5 0 1 0-13 0 6.5 6.5 0 0 0 13 0Z"/></svg>

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"/><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"/></svg>

    end

    test "every category resolves to a shape" do

      for category <- [:triage, :backlog, :unstarted, :started, :completed, :canceled] do

      for category <- [:open, :triage, :backlog, :unstarted, :started, :completed, :canceled] do

        rendered = status(category: category, label: "Any", progress: 50)

        assert query(rendered, ~s{.issue-status[data-category="#{category}"]}) != []

    # looks like.

    test "GitHub's two states, plus the one close reason that reads differently" do

      for {state, reason, category, label} <- [

            {"open", nil, "unstarted", "Open"},

            {"open", nil, "open", "Open"},

            {"closed", "completed", "completed", "Closed"},

            {"closed", nil, "completed", "Closed"},

            {"closed", "not_planned", "canceled", "Closed as not planned"},

    test "is present and complete" do

      # 755 vendored glyphs plus the brand marks, which live apart because a

      # logo cannot come from a generic set and because the vendoring task

      # clears priv/icons on every run.

      {brand, vendored} = Enum.split_with(Icons.names(), &String.starts_with?(&1, "brand-"))

      # clears priv/icons on every run, plus the octicon state glyphs in

      # priv/octicons, which are governed by their own pinned upstream.

      {brand, rest} = Enum.split_with(Icons.names(), &String.starts_with?(&1, "brand-"))

      {octicons, vendored} = Enum.split_with(rest, &String.starts_with?(&1, "octicon-"))

      assert length(vendored) == 755

      assert brand != []

      assert "brand-github" in brand

      assert octicons == ["octicon-issue-closed", "octicon-issue-opened"]

      assert length(Icons.names()) == Icons.count()

    end