# `MingaKnowledgeGraph.Tracker`
[🔗](https://github.com/jsmestad/minga-knowledge-graph/blob/main/lib/minga_knowledge_graph/tracker.ex#L1)

Builds and persists the per-user familiarity graph.

Subscribes to buffer open/change/save events, accumulates per-file
activity (open and edit counts, recency), and pushes a 0..4 heat level
per path to `Minga.Extension.Badge` so the file tree tints by
familiarity. Briefings are explicit: the user invokes the knowledge briefing
command, and the tracker streams the result into a float panel.

State persists across sessions via `Minga.Extension.Storage`; on first
run it seeds from recent git history so the tree is not all-cold.

# `state`

```elixir
@type state() :: %{
  graph: %{required(String.t()) =&gt; stats()},
  levels: %{required(String.t()) =&gt; 0..4},
  briefings: %{required(reference()) =&gt; {String.t(), String.t()}},
  persist_timer: reference() | nil,
  stream_ai: ([Minga.Extension.AI.message()], Minga.Extension.AI.opts() -&gt;
                {:ok, reference()})
}
```

# `stats`

```elixir
@type stats() :: MingaKnowledgeGraph.Score.stats()
```

# `child_spec`

Returns a specification to start this module under a supervisor.

See `Supervisor`.

# `familiarity`

```elixir
@spec familiarity(GenServer.server(), String.t()) :: String.t()
```

Returns a short familiarity summary string for `path`.

# `refresh_heat`

```elixir
@spec refresh_heat(GenServer.server()) :: :ok
```

Re-pushes every tracked file's heat level to the badge registry.

# `request_briefing`

```elixir
@spec request_briefing(GenServer.server(), String.t()) :: :ok
```

Requests a briefing for `path` (always generated, even if familiar).

# `start_link`

```elixir
@spec start_link(keyword()) :: GenServer.on_start()
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
