MingaKnowledgeGraph.Tracker (minga_knowledge_graph v0.1.0)

Copy Markdown View Source

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.

Summary

Functions

Returns a specification to start this module under a supervisor.

Returns a short familiarity summary string for path.

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

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

Types

state()

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

stats()

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

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

familiarity(server \\ __MODULE__, path)

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

Returns a short familiarity summary string for path.

refresh_heat(server \\ __MODULE__)

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

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

request_briefing(server \\ __MODULE__, path)

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

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

start_link(opts \\ [])

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