taolib.symphony.tracker.models

Tracker 领域模型 — Issue 实体与配置定义。

Classes

Issue	规范化后的 Issue 领域模型。
TrackerConfig	Tracker 客户端配置。

Module Contents

class taolib.symphony.tracker.models.Issue

Bases: pydantic.BaseModel

规范化后的 Issue 领域模型。

由 Linear 等外部 tracker 返回的原始数据经 normalize 后得到统一结构， 供编排层、模板渲染和可观测性输出使用。

id: str

identifier: str

title: str

description: str | None = None

priority: int | None

url: str | None = None

state: str

labels: list[str]

blocked_by: list[str]

branch_name: str | None = None

created_at: datetime.datetime | None = None

updated_at: datetime.datetime | None = None

class taolib.symphony.tracker.models.TrackerConfig

Bases: pydantic.BaseModel

Tracker 客户端配置。

从 WORKFLOW.md front matter 的 tracker 段解析而来， 也可由环境变量覆盖。

kind: str = 'linear'

Tracker 类型，当前仅支持 linear。

api_key: str

Linear API Key，通常以 lin_api_ 开头。

endpoint: str = 'https://api.linear.app/graphql'

GraphQL 端点地址。

project_slug: str

项目 slug，用于候选 issue 的过滤条件。

active_states: list[str]

timeout: float = 30.0

HTTP 请求超时（秒）。

max_retries: int = 3

传输层最大重试次数。