alterminal/teai
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
65 Commits 22 Branches 1 Tag
8ce8f410edba693b2a96b8b5be85cbbd59012af0
Commit Graph
26 Commits
Author SHA1 Message Date
ydc3148 540718dda7 feat: teai role 2026-09-14 16:13:02 +08:00
ceo 8d446ed62b feat：新增 organizations 指令（#45） 
tea organizations 對等的日常操作：
- organizations list：GET /user/orgs，輸出 name/full_name/website/
  location/description/visibility（與 teai orgs 工作流命令同一
  端點，但輸出完整欄位）
- organizations create：POST /orgs，--name 必填，可選 --full-name/
  --description/--website/--location/--visibility；寫入需 --yes
- organizations delete：DELETE /orgs/{org}，組織名為位置參數
  （tea 相容）；寫入需 --yes

驗收測試涵蓋端點、payload、--yes 閘門（未確認不發請求）與
值域檢查；並以本機建置對 Gitea 實測 list 輸出欄位與 tea 一致。
 2026-09-13 19:32:34 +08:00
alex 5506daa5f5 Merge pull request 'feat+docs：tag 安裝支援（#38）——version 讀 build info、README 安裝章節改以 go install 為主' (#42) from feat/issue38-versioned-install into main 2026-09-13 00:32:55 +08:00
ceo 9a4887a677 docs：修正安裝章節版本顯示說明（複審 #42）——@v0.1.0 仍顯示 0.1.0-dev、clone 建置為 pseudo-version 2026-09-13 00:28:40 +08:00
ceo 02fad53aa4 Merge pull request 'dailyops：補齊 tea 對等指令（#40）' (#41) from feat/issue40-tea-parity into main 2026-09-13 00:14:17 +08:00
ceo 5a48fdd590 feat+docs：tag 安裝支援（#38）——version 讀 build info、README 安裝章節改以 go install 為主 2026-09-13 00:09:56 +08:00
max 3470a96392 dailyops：補齊 tea 對等指令（#40）— pulls approve/close/checkout、通用 comment、issues list --labels 2026-09-13 00:00:40 +08:00
chenyunda218 9e699f3b4e docs+test：空輸出判決 #37——維持 []／null、補 stalled 空輸出測試 2026-09-12 23:43:29 +08:00
ceo e4212b9c90 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）。
 2026-09-12 15:10:31 +08:00
chenyunda218 1f6806ff99 dailyops：list 命令 --state all 明確帶 state=all（#33） 
issues／milestones 端點省略 state 時 API 預設 open，closed 項目漏列；
pulls 端點省略時雖回全部，仍明確帶上避免依賴端點預設。三處同修並補
回歸測試（TestStateAllSendsExplicitParam）。
 2026-09-11 11:29:00 +08:00
chenyunda218 744e7ad809 milestones：新增跨倉庫里程碑總覽命令（#31） 
- teai milestones（不帶 --repo）輸出跨所屬組織各倉庫 open 里程碑概況，
  對應 gitea.py milestones（管理者巡邏，agents AGENTS.md 10.1）：
  欄位 repo/id/title/url/open_issues/closed_issues/due_on/due_hours/
  overdue/unassigned/updated_at，排序期限近者在前、無期限最後。
- internal/workflow.MilestoneOverview：判定核心（Source 注入、離線可測）；
  MilestoneEntry 自訂 MarshalJSON，鍵集鍵序與 gitea.py 全等
  （null 表示、due_hours 定點一位、unassigned PR 條目帶 author）。
- internal/workflow.APIClient 增 OpenMilestones／MilestoneOpenIssues
  （issues 端點刻意不帶 type=issues，PR 條目保留供覆蓋檢查，同 gitea.py）。
- milestones --repo a/b 維持現行單倉庫 list 語義不變。
- 空清單輸出 []（gitea.py 無輸出；#26 慣例差異，README 已文件化）。
- 交叉驗證：同帳號同時跑 gitea.py milestones 與 teai milestones，
  含逾期／未到期／無期限里程碑與未分派 issue／PR 條目，輸出位元組全等。
 2026-09-10 21:20:19 +08:00
alex 3ed20b6aba internal/cli：允許命令旗標與位置參數交錯（#25） 
parseFlags 改為先分離旗標與位置參數、再剖析旗標串、最後以第二次
Parse 把位置參數設回 fs.Args；Go 標準 flag 遇位置參數即停止的問題
不再影響「位置參數在前、旗標在後」的用法（teai api --method、
issues/pulls view --comments 等照 README 範例可用了）。

- login.go／workflow_commands.go 直接呼叫 fs.Parse 的六處改走
  parseFlags，行為一致（login default/remove 的名稱也可與旗標交錯）。
- errHelp（命令 -h/--help）在 exitCodeFor 視為成功，與其既有註解
  宣稱一致；命令層 -h 結束碼由 1/2 修正為 0。
- 新增 interleaved_flags_test.go 回歸測試：api／issues view／
  pulls view／stalled／login default／login remove 的交錯組合。
 2026-09-10 15:35:16 +08:00
ceo ab94cdce9f internal/cli：stalled 與 xrefs 命令接線，完成 #7 CLI 層（堆疊於 #23） 
- workflow 新增 StalledSource 介面（Source＋CurrentUser＋GetIssue）與
  高階入口 RunStalled／ResolveIssueXrefs（xrefs 輸出附 source 出處）
- APIClient 補上 StalledSource 面向（GetIssue／TryGetIssue 等）
- CLI 新增 teai stalled [--hours N]（JSON 與 gitea.py 位元組相容：
  停用 HTML 轉義、縮排 2）與 teai xrefs <owner>/<repo> <number>
  （404 → exit 3）；table 模式 stalled_hours 定點一位小數
- 接線層與 workflow 層單元測試（注入假資料源、固定時刻）
- README 狀態行更新

驗證：go build／vet／test 全綠；對真實 API 並行掃描，stalled 輸出
與 gitea.py 位元組一致（2169 bytes）；xrefs 邊界案例（PR#50／
issue#49 略過、CJK 緊鄰、跨倉庫 owner/repo#N）與 Python 版一致。
 2026-09-10 12:20:39 +08:00
max 0ed6f262c8 合併 main（4a34def）並把 exitcode_test.go 四處 extractGlobals 呼叫補上第三參數 nil（#20） 2026-09-10 10:32:53 +08:00
max fb2990dc04 Merge remote-tracking branch 'origin/main' into fix/issue18-reserved-flags 2026-09-10 10:32:19 +08:00
ceo 4a34def1f5 Merge pull request 'gitea.py 工作流命令 Go 化：whoami/orgs/members/pulls/mine/next（#6）' (#13) from feature/issue6-workflow-commands into main 2026-09-10 10:24:21 +08:00
ceo 15c2d35935 合併 main（#16/#17）並解 cli.go 衝突 
衝突原因：#13（本分支 927855d）與 #16（main 7badd9e）各自實作了
同一問題（帶旗標命令被全域剖析攔下）的抽取式修正。採 main 現行
架構（dispatch 內 extractGlobals）為準，並保留本分支的：

- runVersion 參數檢查（version 不接受參數，TestWiringVersionRejectsArgs）
- workflow 命令與接線層測試（workflow_commands_test.go）

go build／vet／gofmt 綠；單元測試僅餘 main 既有回歸
（3 個 login 測試，#16 合併後即失敗，與本 PR 無關）。
 2026-09-10 10:22:42 +08:00
max c4fb641094 internal/cli：命令保留旗標機制，login add 的 --url/--token 不再被全域剖析搶走（#18） 2026-09-10 10:22:39 +08:00
chenyunda218 f481377b9a 測試改斷言具體結束碼數值，對照 README 規格（#10） 
cli_test、dailyops_commands_test、login_test、exitcode_test 原以
int(ExitUsage)/int(ExitAPI)/int(ExitInternal) 常數互比，常數若再
與 README 脫鉤測試仍會綠。改為直接斷言 0/2/3（內部錯誤 1）。

常數本體已隨 #5（6951817）改為明確數值，未知命令實測回 2。
 2026-09-10 10:12:35 +08:00
ceo c5d5c37eae Merge pull request '日常操作命令：issues/pulls/labels/milestones/releases/repos/api（#8）' (#16) from feature/issue8-dailyops into main 2026-09-10 09:54:23 +08:00
chenyunda218 927855d3ca cli：修正帶旗標命令被全域剖析攔下的阻斷問題（#13 審核） 
- parseGlobals 改為抽取式 extractGlobals：只取走已知全域選項，非全域
  選項（--has-work／--mine／--reviewer／--repo）原樣交回子命令 flagset，
  任何順序（含與全域選項交錯）皆可解析；-- 之後停止抽取。
- runVersion 補參數檢查：version --wat 仍回 exit 2。
- workflow：commentsFor 對 number<=0 視為無留言，不打 API（對齊 gitea.py
  在 number 缺漏時跳過留言檢查，避免 issues/0/comments 404 中斷掃描）。
- 新增 internal/cli/workflow_commands_test.go：以注入假 client 的接線層
  測試補上 workflow 單元測試覆蓋不到的分派路徑（members --has-work、
  pulls --mine/--reviewer/--repo、全域選項交錯、next null/table）。
- README：註明與 gitea.py 的已知輸出差異（空清單 [] vs 無輸出；
  全域選項可出現在命令前後）。

實機交叉驗證（alex）：members --has-work、pulls --mine/--reviewer、
pulls --repo、next、mine 兩者輸出一致；go vet／test 全綠。
 2026-09-10 09:41:53 +08:00
ceo f8fc16ae49 實現 login 指令（#14）：tea 相容組態管理 
- internal/gitea/config.go：tea 組態的行級編輯引擎（新增／更新／
  設預設／移除），未知欄位與 preferences 區段逐字保留；原子寫入
  （暫存檔 + rename，0600）。
- internal/cli/login.go：teai login list/add/default/remove。add 先以
  token 呼叫 GET /user 驗證，成功才寫入並記下帳號；未給 --token 時
  自 stdin 讀一行；401 結束碼 3。未給 --name 時同站既有項目就地更新。
- 輸出欄位 name/url/user/default，永不輸出 token。
- 測試：編輯引擎 12 項、指令層 11 項（httptest 假 API），並以真 tea
  驗證 teai 寫出的組態可互通（tea whoami 讀出同帳號）。

Closes #14
 2026-09-10 09:32:53 +08:00
alex 7badd9e46d internal/dailyops + cli：日常操作命令 issues/pulls/labels/milestones/releases/repos/api（#8） 
- internal/gitea：用戶端支援寫入動詞（DoJSON/DoRaw，共用 do 核心）
- internal/dailyops：七組日常操作的 API 層（issues/pulls/labels/milestones/releases/repos/api）
- internal/cli：子命令接線；寫入類一律 --yes 閘門（未確認不發請求、exit 2）
- teai pulls 相容 #6 工作流用法（無子命令）；有子命令走日常操作
- 修正 dispatch：命令旗標（如 --has-work、--comments）不再被誤判為未知全域選項
- teai api 支援 path 內含查詢字串
- 單元測試（httptest 假伺服器）＋真實站點交叉驗證（讀取命令輸出對照 Gitea API；寫入回路 create→comment→close 於 alex/.profile 驗證後清理）
 2026-09-10 09:19:03 +08:00
chenyunda218 5583a00bb5 internal/workflow + cli：gitea.py 工作流命令 Go 化（#6） 
- internal/workflow：Client 介面＋判定語義（最後留言、作者/審核者跟進、
  assignee 交集、最久未更新優先），含假 client 單元測試
- internal/workflow/giteaapi.go：以 internal/gitea（#5）實作 Client
- internal/cli：註冊 whoami/orgs/members/mine/pulls/next；全域選項允許
  出現在命令之後；結束碼 0/2/3
- 與 gitea.py 交叉驗證：next/mine/pulls/members(--has-work) 拾取一致
- 依 #5 分支 feature/issue5-gitea-client 為基底
 2026-09-10 08:39:35 +08:00
max 6951817313 internal/gitea：API 用戶端、認證與輸出基礎（#5） 
- internal/gitea：僅標準庫的 HTTP 用戶端；ListAll 以 limit=50 逐頁抓滿
- 認證選序 --token → TEAI_TOKEN → tea 組態（--config/TEA_CONFIG/預設路徑）；
  token 不入輸出、日誌與錯誤訊息
- 共用輸出 --output json|table（預設 json）、--timeout（預設 30s）
- CLI 結束碼 0/2/3：用法錯誤 → 2、API 錯誤（*gitea.ErrAPI）→ 3
- 單元測試：認證選序、tea 組態解析、分頁、逾時／401／5xx 錯誤映射、輸出

實作 issue #5
 2026-09-10 08:20:08 +08:00
ceoandchenyunda218 bc46620d04 初始化專案：Go 模組骨架、CLI 進入點、README、測試 
- go.mod（module gitea.alterminal.com/alterminal/teai，Go 1.26）
- cmd/teai/main.go：程式進入點，結束碼交由 internal/cli.Run 處理
- internal/cli：命令列架構（引數剖析、子命令分派、version 命令）
- internal/cli/cli_test.go：用法輸出、version、未知命令等基本測試
- README.md：專案說明、建置與開發慣例（繁體中文）
- .gitignore：建置產物、測試輸出、環境檔
- 僅使用標準庫，可離線建置；授權待維護者選定

Refs #1
 2026-09-09 23:06:39 +08:00