CMDCRAGArcana.Graph.BuildRun (cmdc_rag_arcana v0.5.0)

Graph 索引生命周期运行记录契约。

生产平台可把该 struct 映射为 Ecto schema 或 Oban job metadata。扩展包只提供稳定事件/状态形状,不持有企业控制面数据库。

Summary

Types

operation()

status()

t()

Functions

complete(run, result)

标记完成。

fail(run, reason)

标记失败。

start(operation, attrs \\ [])

创建 running build run。

Types

operation()

@type operation() ::
  :rebuild_graph
  | :embed_entities
  | :detect_communities
  | :summarize_communities

status()

@type status() :: :queued | :running | :completed | :failed

t()

@type t() :: %CMDCRAGArcana.Graph.BuildRun{
  collection: String.t() | nil,
  completed_at_ms: integer() | nil,
  error: String.t() | nil,
  id: String.t(),
  metadata: map(),
  operation: operation(),
  result: map(),
  started_at_ms: integer(),
  status: status(),
  tenant_id: String.t() | nil
}

Functions

complete(run, result)

@spec complete(t(), map()) :: t()

标记完成。

fail(run, reason)

@spec fail(t(), term()) :: t()

标记失败。

start(operation, attrs \\ [])

@spec start(operation(), keyword() | map()) :: t()

创建 running build run。