internal/workflow：directLastActivity 排除跨 issue 引用事件（#34）
同步 agents #34/#38/#40 三個停滯判定修補到 Go 端：
- Source 介面新增 IssueTimeline（GET /repos/{o}/{r}/issues/{n}/timeline，分頁），
giteaapi.go 與 cmd/xcheck 同步實作
- 新增 directLastActivity：updated_at 晚於全部已知直接活動時拉 timeline 核對，
排除 comment_ref／issue_ref 引用事件後取最晚；全為引用事件回退已知直接活動
最晚時刻（agents #40）；timeline 失敗保守沿用 updated_at
- considerIssue／considerPull 對自身 updated_at、childActivity 對子項 updated_at
（含子項 created_at 入已知活動）套用同一排除邏輯（agents #38）
- 回歸測試：子項 updated_at 被引用刷新（TestRunStalledChildXrefRefresh）、
timeline 全引用事件回退與拉取失敗保守路徑（TestRunStalledTimelineAllXrefFallback）
- 修正 workflow_test.go：timelines 須在 ScanStalled 呼叫前設定
驗證：go build／vet／test 全綠；xcheck 對真實 API 掃描，
stalled 輸出與 gitea.py（agents @ 78769ec）位元組一致（5833 bytes）。
This commit is contained in:
+115
-16
@@ -30,6 +30,11 @@ const (
|
||||
NudgeCooldownHours = 24.0
|
||||
)
|
||||
|
||||
// xrefTimelineTypes 對應 gitea.py 的 XREF_TIMELINE_TYPES：他處留言／issue
|
||||
// 提及本編號時產生的 timeline 引用事件。這類事件會刷新 updated_at，但不是
|
||||
// 本 issue 的直接活動，directLastActivity 會予以排除（agents issue #34）。
|
||||
var xrefTimelineTypes = map[string]bool{"comment_ref": true, "issue_ref": true}
|
||||
|
||||
// xrefPattern 對應 gitea.py 的 XREF_PATTERN：#N、repo#N、owner/repo#N。
|
||||
//
|
||||
// 前面不得是文數字／底線／斜線（避免切進 alterminal/bear#47 的後半段）；
|
||||
@@ -149,6 +154,9 @@ type Source interface {
|
||||
IssueComments(owner, repo string, number int64) ([]Comment, error)
|
||||
// TryGetIssue 寬容版單一 issue 查詢：失敗（含 404）回 (零值, false, nil)。
|
||||
TryGetIssue(owner, repo string, number int64) (Issue, bool, error)
|
||||
// IssueTimeline 回傳 issue 的 timeline 事件（GET /repos/{o}/{r}/issues/{n}/timeline，
|
||||
// 分頁）。directLastActivity 用來排除跨 issue 引用事件（agents issue #34）。
|
||||
IssueTimeline(owner, repo string, number int64) ([]TimelineEvent, error)
|
||||
}
|
||||
|
||||
// iterXrefs 產出文字中的 (prefix, number) 配對（對應 _iter_issue_xrefs）。
|
||||
@@ -268,8 +276,11 @@ func childActivity(src Source, org, repo string, parent Issue, comments []Commen
|
||||
if pcOK && ccOK && !childCreated.After(parentCreated) {
|
||||
continue // 上行引用（父項回指更早或同時的 issue）；時間未知則不排除
|
||||
}
|
||||
// 子項的直接活動：created_at、state 變更（closed_at）、留言（agents #32）。
|
||||
// 原始 updated_at 不放入已知活動，另經 directLastActivity 核對後採計
|
||||
//（與 considerIssue／considerPull 對本 issue 自身的處理同構）。
|
||||
var ms []time.Time
|
||||
if m, ok := parseMoment(child.UpdatedAt); ok {
|
||||
if m, ok := parseMoment(child.CreatedAt); ok {
|
||||
ms = append(ms, m)
|
||||
}
|
||||
if m, ok := parseMoment(child.ClosedAt); ok {
|
||||
@@ -282,6 +293,14 @@ func childActivity(src Source, org, repo string, parent Issue, comments []Commen
|
||||
}
|
||||
}
|
||||
}
|
||||
if childUpdated, ok := parseMoment(child.UpdatedAt); ok {
|
||||
// 子項 updated_at 可能被 comment_ref／issue_ref 引用事件刷新
|
||||
//（agents #38）：走與本 issue 自身相同的 directLastActivity 排除
|
||||
// 邏輯（同源判定，不漂移）；timeline 失敗時保守沿用 updated_at。
|
||||
if d, ok := directLastActivity(src, t.Owner, t.Repo, t.Number, childUpdated, true, ms); ok {
|
||||
ms = append(ms, d)
|
||||
}
|
||||
}
|
||||
var last *string
|
||||
if len(ms) > 0 {
|
||||
latest := maxTime(ms)
|
||||
@@ -302,6 +321,71 @@ func childActivity(src Source, org, repo string, parent Issue, comments []Commen
|
||||
return moments, children
|
||||
}
|
||||
|
||||
// TimelineEvent 是 issue timeline 的單一事件（僅取判斷所需欄位；
|
||||
// 對應 gitea.py _direct_last_activity 讀取的 timeline 物件）。
|
||||
type TimelineEvent struct {
|
||||
Type string `json:"type"`
|
||||
CreatedAt string `json:"created_at"`
|
||||
}
|
||||
|
||||
// directLastActivity 排除跨 issue 引用事件後，本 issue 的最後直接活動時刻
|
||||
// （對應 gitea.py 的 _direct_last_activity；agents issues #34/#38/#40）。
|
||||
//
|
||||
// 他處留言／issue 提及本編號（comment_ref／issue_ref）也會刷新 updated_at，
|
||||
// 直接採用會虛假刷新停滯時鐘（false negative）並低估 stalled_hours。
|
||||
// updated_at 不晚於已知直接活動（留言、created_at、#32 納入的子項活動）時，
|
||||
// updated_at 本身可信，不必多打一次 timeline API；只有 updated_at 晚於全部
|
||||
// 已知活動時才拉 timeline 核對：排除引用類事件後取最晚事件時刻；若最晚的
|
||||
// 都是引用事件（本 issue 無直接活動可對應 updated_at），則回退已知直接活動
|
||||
// 的最晚時刻（agents #40）。timeline 拉取失敗時沿用 updated_at（不中斷掃描、
|
||||
// 寧可少報不誤報缺失活動）。
|
||||
func directLastActivity(src Source, org, repo string, number int64, updatedAt time.Time, hasUpdated bool, known []time.Time) (time.Time, bool) {
|
||||
if !hasUpdated {
|
||||
return time.Time{}, false
|
||||
}
|
||||
var knownMax *time.Time
|
||||
for i := range known {
|
||||
if known[i].IsZero() {
|
||||
continue
|
||||
}
|
||||
if knownMax == nil || known[i].After(*knownMax) {
|
||||
m := known[i]
|
||||
knownMax = &m
|
||||
}
|
||||
}
|
||||
if knownMax == nil || !updatedAt.After(*knownMax) {
|
||||
return updatedAt, true
|
||||
}
|
||||
timeline, err := src.IssueTimeline(org, repo, number)
|
||||
if err != nil {
|
||||
return updatedAt, true
|
||||
}
|
||||
var moments []time.Time
|
||||
for _, e := range timeline {
|
||||
if xrefTimelineTypes[e.Type] {
|
||||
continue
|
||||
}
|
||||
if m, ok := parseMoment(e.CreatedAt); ok {
|
||||
moments = append(moments, m)
|
||||
}
|
||||
}
|
||||
if len(moments) == 0 {
|
||||
// timeline 全為引用事件：updated_at 完全由他處提及刷新，本 issue 沒有
|
||||
// 可對應的直接活動。回退已知直接活動的最晚時刻，避免把被刷新的
|
||||
// updated_at 當活動、低估停滯時數（agents #40）；連已知活動都沒有時才
|
||||
// 保守沿用 updated_at（不中斷掃描、寧可少報不誤報缺失活動）。
|
||||
if knownMax != nil {
|
||||
return *knownMax, true
|
||||
}
|
||||
return updatedAt, true
|
||||
}
|
||||
latest := maxTime(moments)
|
||||
if latest.Before(updatedAt) {
|
||||
return latest, true
|
||||
}
|
||||
return updatedAt, true
|
||||
}
|
||||
|
||||
func maxTime(ts []time.Time) time.Time {
|
||||
best := ts[0]
|
||||
for _, t := range ts[1:] {
|
||||
@@ -382,7 +466,7 @@ func ScanStalled(src Source, username string, threshold float64, now time.Time)
|
||||
if err != nil {
|
||||
continue
|
||||
}
|
||||
if item, ok := considerPull(pr, comments, username, threshold, now); ok {
|
||||
if item, ok := considerPull(src, org, r.Name, pr, comments, username, threshold, now); ok {
|
||||
items = append(items, item)
|
||||
}
|
||||
}
|
||||
@@ -398,19 +482,27 @@ func ScanStalled(src Source, username string, threshold float64, now time.Time)
|
||||
func considerIssue(src Source, org, repo string, issue Issue, comments []Comment, username string, threshold float64, now time.Time, myOrgs map[string]bool, orgRepos func(string) ([]string, error)) (Item, bool) {
|
||||
childMoments, children := childActivity(src, org, repo, issue, comments, myOrgs, orgRepos)
|
||||
assignees := AssigneeNames(&issue)
|
||||
var moments []time.Time
|
||||
if m, ok := parseMoment(issue.UpdatedAt); ok {
|
||||
moments = append(moments, m)
|
||||
}
|
||||
// 已知直接活動：留言、created_at、#32 納入的子項活動。
|
||||
var known []time.Time
|
||||
if m, ok := parseMoment(issue.CreatedAt); ok {
|
||||
moments = append(moments, m)
|
||||
known = append(known, m)
|
||||
}
|
||||
for _, c := range comments {
|
||||
if m, ok := parseMoment(c.CreatedAt); ok {
|
||||
moments = append(moments, m)
|
||||
known = append(known, m)
|
||||
}
|
||||
}
|
||||
moments = append(moments, childMoments...)
|
||||
known = append(known, childMoments...)
|
||||
// 跨 issue 引用（comment_ref／issue_ref）也會刷新 updated_at（agents #34）：
|
||||
// updated_at 晚於全部已知直接活動時，先排除引用事件核對後才採用，
|
||||
// 避免停滯時鐘被虛假刷新或低估 stalled_hours。
|
||||
var moments []time.Time
|
||||
if m, ok := parseMoment(issue.UpdatedAt); ok {
|
||||
if d, ok2 := directLastActivity(src, org, repo, issue.issueNumber(), m, ok, known); ok2 {
|
||||
moments = append(moments, d)
|
||||
}
|
||||
}
|
||||
moments = append(moments, known...)
|
||||
if len(moments) == 0 {
|
||||
return Item{}, false
|
||||
}
|
||||
@@ -455,21 +547,28 @@ func considerIssue(src Source, org, repo string, issue Issue, comments []Comment
|
||||
}
|
||||
|
||||
// considerPull 對單一 PR 套用停滯判定（對應 _consider 的 pull 分支）。
|
||||
func considerPull(pr PullRequest, comments []Comment, username string, threshold float64, now time.Time) (Item, bool) {
|
||||
func considerPull(src Source, org, repo string, pr PullRequest, comments []Comment, username string, threshold float64, now time.Time) (Item, bool) {
|
||||
reviewers := ReviewerNames(&pr)
|
||||
author := pr.Author()
|
||||
var moments []time.Time
|
||||
if m, ok := parseMoment(pr.UpdatedAt); ok {
|
||||
moments = append(moments, m)
|
||||
}
|
||||
// 已知直接活動：留言、created_at。
|
||||
var known []time.Time
|
||||
if m, ok := parseMoment(pr.CreatedAt); ok {
|
||||
moments = append(moments, m)
|
||||
known = append(known, m)
|
||||
}
|
||||
for _, c := range comments {
|
||||
if m, ok := parseMoment(c.CreatedAt); ok {
|
||||
moments = append(moments, m)
|
||||
known = append(known, m)
|
||||
}
|
||||
}
|
||||
// 跨 issue 引用也會刷新 PR 的 updated_at（agents #34）：與 issue 同一道
|
||||
// directLastActivity 排除邏輯（同源判定，不漂移）。
|
||||
var moments []time.Time
|
||||
if m, ok := parseMoment(pr.UpdatedAt); ok {
|
||||
if d, ok2 := directLastActivity(src, org, repo, pr.Number, m, ok, known); ok2 {
|
||||
moments = append(moments, d)
|
||||
}
|
||||
}
|
||||
moments = append(moments, known...)
|
||||
if len(moments) == 0 {
|
||||
return Item{}, false
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user