Compare commits
16
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
4a5d02fd70 | ||
|
|
a9abf96a42 | ||
|
|
1d9092cdde | ||
|
|
540718dda7 | ||
|
|
8735e35db6 | ||
|
|
d89caf4af2 | ||
|
|
8e358185f4 | ||
|
|
8d446ed62b | ||
|
|
d45a8243c8 | ||
|
|
d0334434c5 | ||
|
|
5506daa5f5 | ||
|
|
9a4887a677 | ||
|
|
02fad53aa4 | ||
|
|
5a48fdd590 | ||
|
|
36a50b95ed | ||
|
|
9e699f3b4e |
@@ -6,7 +6,7 @@ teai 是 Gitea 的命令列(CLI)工具,以更完整、更可靠的方式
|
|||||||
|
|
||||||
- **語言:** Go(與 Gitea 本體一致),僅用標準庫,離線可建置
|
- **語言:** Go(與 Gitea 本體一致),僅用標準庫,離線可建置
|
||||||
- **目標站點:** `https://gitea.alterminal.com`
|
- **目標站點:** `https://gitea.alterminal.com`
|
||||||
- **狀態:** 基礎建設(#5:internal/gitea)、工作流命令(#6:whoami/orgs/members/mine/pulls/next)、日常操作命令(#8:issues/pulls/labels/milestones/releases/repos/api)與管理者巡邏命令(#7:stalled/xrefs)已實作
|
- **狀態:** 基礎建設(#5:internal/gitea)、工作流命令(#6:whoami/role/orgs/members/mine/pulls/next)、日常操作命令(#8:issues/pulls/labels/milestones/releases/repos/api)與管理者巡邏命令(#7:stalled/xrefs)已實作
|
||||||
- **範圍(#3):** 不避開 tea 已有的功能;單一工具涵蓋完整操作
|
- **範圍(#3):** 不避開 tea 已有的功能;單一工具涵蓋完整操作
|
||||||
|
|
||||||
## 安裝與建置
|
## 安裝與建置
|
||||||
@@ -17,30 +17,48 @@ teai 是 Gitea 的命令列(CLI)工具,以更完整、更可靠的方式
|
|||||||
- **git**
|
- **git**
|
||||||
- Gitea 帳號的 **API token**(設定階段使用;在 Gitea「設定 → 應用程式」產生)
|
- Gitea 帳號的 **API token**(設定階段使用;在 Gitea「設定 → 應用程式」產生)
|
||||||
|
|
||||||
### 從原始碼建置
|
### 以 go install 安裝(建議)
|
||||||
|
|
||||||
|
自 v0.1.0 起 module 已發佈 tag,可直接以版本安裝(二元檔裝進 `GOBIN`,預設 `~/go/bin`):
|
||||||
|
|
||||||
|
```sh
|
||||||
|
go install gitea.alterminal.com/alterminal/teai/cmd/teai@latest # 最新 tag(亦可 @v<版本> 指定)
|
||||||
|
teai version # 驗證:顯示安裝的 tag 版本(見下方說明)
|
||||||
|
```
|
||||||
|
|
||||||
|
本 module 為公開倉庫,預設 `GOPROXY`/`GOSUMDB` 即可解析(已於乾淨環境驗證)。
|
||||||
|
若所在網路環境無法經公用 proxy 抓取,可改設 `GOPRIVATE=gitea.alterminal.com`
|
||||||
|
(略過 proxy 與 checksum database,直接從 Gitea 抓取)。
|
||||||
|
|
||||||
|
`teai version` 顯示建入的 module 版本,即安裝指定的 tag(如 `v0.1.1`)。
|
||||||
|
注意:讀 build info 顯示安裝版本的支援,自包含該變更的 tag 起(v0.1.1)才生效——
|
||||||
|
v0.1.0 早於此變更,以 `@v0.1.0` 安裝(或此變更前的 `@latest`)仍顯示舊行為 `0.1.0-dev`。
|
||||||
|
|
||||||
|
### 從原始碼建置(開發用)
|
||||||
|
|
||||||
|
開發、離線或想鎖定特定 commit 時,clone 後自行建置:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
git clone https://gitea.alterminal.com/alterminal/teai.git
|
git clone https://gitea.alterminal.com/alterminal/teai.git
|
||||||
cd teai
|
cd teai
|
||||||
go build -o teai ./cmd/teai
|
go build -o teai ./cmd/teai
|
||||||
install -Dm755 teai ~/.local/bin/teai # 或複製到任何 PATH 內目錄
|
install -Dm755 teai ~/.local/bin/teai # 或複製到任何 PATH 內目錄
|
||||||
teai version # 驗證:teai version 0.1.0-dev
|
teai version # 驗證:teai version v0.1.1-0.<時間戳>-<commit>(見下方說明)
|
||||||
```
|
```
|
||||||
|
|
||||||
也可以直接裝進 `GOBIN`(預設 `~/go/bin`;該目錄已在 PATH 時最省事):
|
也可以在 clone 目錄內直接裝進 `GOBIN`:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
go install ./cmd/teai
|
go install ./cmd/teai
|
||||||
```
|
```
|
||||||
|
|
||||||
> **注意:** `go install gitea.alterminal.com/alterminal/teai/cmd/teai@latest` 目前**不可用**——
|
clone 建置時 Go 會把 VCS 狀態寫進 build info:位於 tag 上顯示該 tag、
|
||||||
> module 尚未發佈任何 tag,`@latest` 會解析到任意中繼 commit(且 #21 修復前 main 建置失敗)。
|
其後的 commit 顯示 pseudo-version(如 `v0.1.1-0.20260912160956-5a48fdd590b2`)、
|
||||||
> 請在 clone 目錄內以版本控制的方式建置;發佈 tag 後再提供 `teai@<version>` 安裝路徑。
|
工作樹有修改再附加 `+dirty`;無 VCS 資訊(如從 tarball 解壓建置)時
|
||||||
|
`Main.Version` 為 `(devel)`,此時退回開發版本號 `0.1.0-dev`。
|
||||||
|
|
||||||
### 登入設定(首次使用)
|
### 登入設定(首次使用)
|
||||||
|
|
||||||
teai 與 `tea` 共用同一份組態檔;若 `tea whoami` 已可正常輸出,可跳過本節。
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
teai login add --url https://gitea.alterminal.com
|
teai login add --url https://gitea.alterminal.com
|
||||||
# 未給 --token 時自 stdin 讀一行:貼上 token 後按 Enter(不會進 shell 歷史)
|
# 未給 --token 時自 stdin 讀一行:貼上 token 後按 Enter(不會進 shell 歷史)
|
||||||
@@ -48,8 +66,7 @@ teai whoami # 驗證:應輸出 {"username":"<你的帳號>"}
|
|||||||
```
|
```
|
||||||
|
|
||||||
- token 驗證失敗(HTTP 401)不會寫入組態,結束碼 3。
|
- token 驗證失敗(HTTP 401)不會寫入組態,結束碼 3。
|
||||||
- 組態檔:`--config`/`TEA_CONFIG` 指定,預設 `~/.config/tea/config.yml`;teai 採行級編輯,
|
- 組態檔:`--config`/`TEAI_CONFIG` 指定,預設 `~/.config/teai/config.yml`;檔案權限 `0600`。
|
||||||
不會改壞 tea 也在使用的欄位,檔案權限 `0600`。
|
|
||||||
- 多站台以 `--name` 區分、`teai login default <名稱>` 切換預設;詳見下方 [`teai login`](#teai-login--管理登入) 一節。
|
- 多站台以 `--name` 區分、`teai login default <名稱>` 切換預設;詳見下方 [`teai login`](#teai-login--管理登入) 一節。
|
||||||
|
|
||||||
## 指令設計
|
## 指令設計
|
||||||
@@ -63,12 +80,12 @@ teai whoami # 驗證:應輸出 {"username":"<你的帳號>"}
|
|||||||
2. **規則單一來源**:「最後一則留言不是自己」等工作流判定規則以 `AGENTS.md` 為準,teai 只實作、不改義。規則要變更,先改 AGENTS.md,teai 跟著改。
|
2. **規則單一來源**:「最後一則留言不是自己」等工作流判定規則以 `AGENTS.md` 為準,teai 只實作、不改義。規則要變更,先改 AGENTS.md,teai 跟著改。
|
||||||
3. **機器可讀優先**:預設輸出 JSON;`--output table` 僅供人工抽查。
|
3. **機器可讀優先**:預設輸出 JSON;`--output table` 僅供人工抽查。
|
||||||
4. **可直接替換原型**:`gitea.py` 的每個子命令在 teai 都有語義相同的對應命令,可交叉驗證、平滑遷移。
|
4. **可直接替換原型**:`gitea.py` 的每個子命令在 teai 都有語義相同的對應命令,可交叉驗證、平滑遷移。
|
||||||
5. **認證沿用 tea**:讀 `tea` 的登入組態(`TEA_CONFIG` 或 `~/.config/tea/config.yml`),不另建認證體系。
|
5. **自主認證組態**:登入資料寫在 teai 自己的組態(`TEAI_CONFIG` 或 `~/.config/teai/config.yml`),不依賴 tea。
|
||||||
6. **安全預設**:查詢類唯讀;寫入類命令(#8 起)一律要求明確 `--yes`,未確認時不發出任何請求、不產生任何遠端變更。
|
6. **安全預設**:查詢類唯讀;寫入類命令(#8 起)一律要求明確 `--yes`,未確認時不發出任何請求、不產生任何遠端變更。
|
||||||
|
|
||||||
### 日常操作(tea 對等指令;#3 不避開 tea 已有功能;#8 已實作)
|
### 日常操作(tea 對等指令;#3 不避開 tea 已有功能;#8 已實作)
|
||||||
|
|
||||||
issues/pulls/labels/milestones/releases/repos/api 的日常操作,自行實作、輸出一致 JSON、共用同一套認證與全域選項。介面語義以 `tea`/Gitea API 為相容參考。已實作:
|
issues/pulls/labels/milestones/releases/repos/organizations/api 的日常操作,自行實作、輸出一致 JSON、共用同一套認證與全域選項。介面語義以 `tea`/Gitea API 為相容參考。已實作:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# issues
|
# issues
|
||||||
@@ -97,11 +114,15 @@ teai milestones list --repo <owner>/<repo> [--state open|closed|all]
|
|||||||
teai milestones create --repo <owner>/<repo> --title … [--description …] [--due RFC3339] --yes
|
teai milestones create --repo <owner>/<repo> --title … [--description …] [--due RFC3339] --yes
|
||||||
teai releases list --repo <owner>/<repo>
|
teai releases list --repo <owner>/<repo>
|
||||||
teai repos list [--org <org>]
|
teai repos list [--org <org>]
|
||||||
|
# 組織管理(tea organizations 對等;#45)
|
||||||
|
teai organizations list # 列出自己可存取的組織(GET /user/orgs)
|
||||||
|
teai organizations create --name <org> [--full-name …] [--description …] [--website …] [--location …] [--visibility public|limited|private] --yes
|
||||||
|
teai organizations delete <org> --yes # 刪除組織(不可逆;DELETE /orgs/{org})
|
||||||
# 任意 API 呼叫(逃生口)
|
# 任意 API 呼叫(逃生口)
|
||||||
teai api <path> [--method GET|POST|PATCH|DELETE] [--data '<json>'] [--yes]
|
teai api <path> [--method GET|POST|PATCH|DELETE] [--data '<json>'] [--yes]
|
||||||
```
|
```
|
||||||
|
|
||||||
> `--yes` 閘門:所有寫入類命令(create/close/comment/merge/approve/labels create/milestones create/api 非 GET 動詞)未帶 `--yes` 時回 exit 2(用法錯誤),且不發出任何 HTTP 請求。
|
> `--yes` 閘門:所有寫入類命令(create/close/comment/merge/approve/labels create/milestones create/organizations create/delete/api 非 GET 動詞)未帶 `--yes` 時回 exit 2(用法錯誤),且不發出任何 HTTP 請求。
|
||||||
> `teai api` 的 path 內含查詢字串(如 `/repos/a/b/issues?state=closed`)時會正確傳遞。
|
> `teai api` 的 path 內含查詢字串(如 `/repos/a/b/issues?state=closed`)時會正確傳遞。
|
||||||
> `teai pulls checkout` 是本機唯讀輔助:同倉庫 head 在 `--dir`(預設當前目錄)的既有工作樹 `git fetch origin <ref> && git checkout -B <ref> FETCH_HEAD`;跨倉庫 head 需 `--dir`(新目錄)執行 `git clone --branch <ref> <clone_url>`。teai 不代管 git 認證,私有倉庫請自備 credential helper。
|
> `teai pulls checkout` 是本機唯讀輔助:同倉庫 head 在 `--dir`(預設當前目錄)的既有工作樹 `git fetch origin <ref> && git checkout -B <ref> FETCH_HEAD`;跨倉庫 head 需 `--dir`(新目錄)執行 `git clone --branch <ref> <clone_url>`。teai 不代管 git 認證,私有倉庫請自備 credential helper。
|
||||||
|
|
||||||
@@ -114,8 +135,8 @@ teai [全域選項] <命令> [參數]
|
|||||||
| 選項 | 說明 |
|
| 選項 | 說明 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| `--url <URL>` | Gitea 站點,預設 `https://gitea.alterminal.com` |
|
| `--url <URL>` | Gitea 站點,預設 `https://gitea.alterminal.com` |
|
||||||
| `--token <TOKEN>` | API token;未給則依序嘗試 `TEAI_TOKEN` 環境變數、tea 登入組態 |
|
| `--token <TOKEN>` | API token;未給則依序嘗試 `TEAI_TOKEN` 環境變數、teai 登入組態 |
|
||||||
| `--config <path>` | tea 組態檔路徑,等同 `TEA_CONFIG` |
|
| `--config <path>` | teai 組態檔路徑,等同 `TEAI_CONFIG` |
|
||||||
| `--output json\|table` | 輸出格式,預設 `json` |
|
| `--output json\|table` | 輸出格式,預設 `json` |
|
||||||
| `--timeout <dur>` | HTTP 請求逾時,預設 `30s` |
|
| `--timeout <dur>` | HTTP 請求逾時,預設 `30s` |
|
||||||
|
|
||||||
@@ -123,9 +144,11 @@ teai [全域選項] <命令> [參數]
|
|||||||
|
|
||||||
| 命令 | 對應 gitea.py | 說明 |
|
| 命令 | 對應 gitea.py | 說明 |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| `teai login list\|add\|default\|remove` | — | 管理 tea 相容登入組態(見下) |
|
| `teai login list\|add\|default\|remove` | — | 管理登入組態(見下) |
|
||||||
| `teai whoami` | `get_current_username` | 目前帳號 |
|
| `teai whoami` | `get_current_username` | 目前帳號 |
|
||||||
|
| `teai role` | — | 目前角色(Supervisor 團隊→supervisor,Agents 團隊→worker) |
|
||||||
| `teai orgs` | `for_all_organizations` | 我所屬的組織 |
|
| `teai orgs` | `for_all_organizations` | 我所屬的組織 |
|
||||||
|
| `teai organizations list\|create\|delete` | — | 組織管理(tea 對等日常操作;`orgs` 是工作流精簡版) |
|
||||||
| `teai members [--has-work]` | `members [--has-work]` | Agents 團隊成員;`--has-work` 只列有未完成工作者 |
|
| `teai members [--has-work]` | `members [--has-work]` | Agents 團隊成員;`--has-work` 只列有未完成工作者 |
|
||||||
| `teai mine` | `mine` | 分派給我、待跟進的 issues |
|
| `teai mine` | `mine` | 分派給我、待跟進的 issues |
|
||||||
| `teai pulls [--mine\|--reviewer] [--repo <owner>/<repo>]` | `pulls` 系列 | 跨倉庫 PR 跟進清單 |
|
| `teai pulls [--mine\|--reviewer] [--repo <owner>/<repo>]` | `pulls` 系列 | 跨倉庫 PR 跟進清單 |
|
||||||
@@ -164,9 +187,8 @@ teai next --output table # 人類可讀
|
|||||||
|
|
||||||
### `teai login` — 管理登入
|
### `teai login` — 管理登入
|
||||||
|
|
||||||
teai 與 tea 共用同一份組態檔(`--config`/`TEA_CONFIG`,預設 `~/.config/tea/config.yml`)。
|
登入組態由 teai 自行管理(`--config`/`TEAI_CONFIG`,預設 `~/.config/teai/config.yml`)。
|
||||||
寫入採行級編輯:只動目標項目的行,未知欄位(`ssh_*` 等)與 `preferences` 區段逐字保留,
|
寫入採行級編輯:只動目標項目的行,未知欄位與註解逐字保留;檔案權限 `0600`、暫存檔原子替換。
|
||||||
不改壞 tea 也在使用的檔案;檔案權限 `0600`、暫存檔原子替換。
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
teai login list # 列出登入(一律不含 token)
|
teai login list # 列出登入(一律不含 token)
|
||||||
@@ -215,6 +237,17 @@ PR 改帶 `author` 與 `reviewers` 欄位。`reason` 取值:
|
|||||||
- issue:`no-assignee`、`assignee-idle`、`no-commenter`、`waiting-outside`、`parent-tracking`
|
- issue:`no-assignee`、`assignee-idle`、`no-commenter`、`waiting-outside`、`parent-tracking`
|
||||||
- PR:`no-reviewer`、`author-idle`、`reviewer-idle`、`no-commenter`
|
- PR:`no-reviewer`、`author-idle`、`reviewer-idle`、`no-commenter`
|
||||||
|
|
||||||
|
`assignee-idle` 判定前會先檢查最後一則 assignee 留言是否為**交付報告**(agents #47):
|
||||||
|
逐項查核/驗收結果(結構訊號)∧ 回報他件/請他人確認關閉(交棒訊號)同時命中 →
|
||||||
|
改判 `waiting-outside`——已交付待發起人確認不是 assignee 停滯。認領/進度/預告式
|
||||||
|
留言(無交棒對象)維持 `assignee-idle`,不製造「認領後棄置永不被催」的新死角。
|
||||||
|
|
||||||
|
`author-idle` 判定前會先檢查 PR 作者的最後一則留言是否為**審核交棒**(agents #51):
|
||||||
|
@目前審核者帳號 ∧ 就緒語(已就緒/可審閱/請審閱)同時命中 → 改判 `reviewer-idle`
|
||||||
|
——作者已表明就緒並點名審核者,球在審核者,讓既有 reviewer 催促與 48 小時改派規則
|
||||||
|
自然適用。@的帳號必須在目前審核者清單且為完整匹配(@chenyunda218 不算提及
|
||||||
|
chenyunda);僅就緒語而無點名對象(進度回報、預告式)維持 `author-idle`。
|
||||||
|
|
||||||
### `teai milestones` — 跨倉庫里程碑總覽
|
### `teai milestones` — 跨倉庫里程碑總覽
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
@@ -280,13 +313,21 @@ teai pulls --repo alterminal/teai # 限定單一倉庫
|
|||||||
teai mine # 分派給我、最後一則留言不是自己的 open issues(跨所屬組織)
|
teai mine # 分派給我、最後一則留言不是自己的 open issues(跨所屬組織)
|
||||||
```
|
```
|
||||||
|
|
||||||
### `teai orgs` / `teai whoami`
|
### `teai orgs` / `teai whoami` / `teai role`
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
teai orgs # 我所屬的組織
|
teai orgs # 我所屬的組織
|
||||||
teai whoami # 目前帳號(讀 tea 組態)
|
teai whoami # 目前帳號
|
||||||
|
teai role # 目前角色
|
||||||
```
|
```
|
||||||
|
|
||||||
|
角色由所屬組織的團隊決定:
|
||||||
|
|
||||||
|
- 在 **Supervisor** 團隊 → `{"role":"supervisor"}`
|
||||||
|
- 在 **Agents** 團隊 → `{"role":"worker"}`
|
||||||
|
- 同時屬於兩者時以 supervisor 為準
|
||||||
|
- 兩者都不屬於 → 輸出 `null`,exit 0
|
||||||
|
|
||||||
### `teai xrefs <owner>/<repo> <number>` — 引用解析
|
### `teai xrefs <owner>/<repo> <number>` — 引用解析
|
||||||
|
|
||||||
解析該 issue/PR 內文與全部留言中的 `#N`、`repo#N`、`owner/repo#N` 引用,輸出解析後的目標清單(去重):
|
解析該 issue/PR 內文與全部留言中的 `#N`、`repo#N`、`owner/repo#N` 引用,輸出解析後的目標清單(去重):
|
||||||
@@ -305,7 +346,7 @@ teai whoami # 目前帳號(讀 tea 組態)
|
|||||||
|
|
||||||
| 碼 | 意義 |
|
| 碼 | 意義 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| 0 | 成功(含「沒有工作」→ 輸出 `null`/`[]`) |
|
| 0 | 成功(含「沒有結果」→ 清單類命令輸出 `[]`、`next`/`role` 輸出 `null`;#37 判決) |
|
||||||
| 2 | 用法錯誤(未知命令/參數) |
|
| 2 | 用法錯誤(未知命令/參數) |
|
||||||
| 3 | API 錯誤(連線失敗、401、403、5xx) |
|
| 3 | API 錯誤(連線失敗、401、403、5xx) |
|
||||||
|
|
||||||
@@ -324,8 +365,13 @@ teai whoami # 目前帳號(讀 tea 組態)
|
|||||||
已知輸出差異(刻意保留,機器可讀優先):
|
已知輸出差異(刻意保留,機器可讀優先):
|
||||||
|
|
||||||
- **空清單**:`gitea.py` 的 `_dump` 對空清單**不輸出任何內容**;teai 的清單類命令
|
- **空清單**:`gitea.py` 的 `_dump` 對空清單**不輸出任何內容**;teai 的清單類命令
|
||||||
(`mine`/`pulls`/`milestones` 總覽)空清單輸出 `[]`。對 JSON 消費者來說 `[]` 比「無輸出」更明確,
|
(`mine`/`pulls`/`stalled`/`milestones` 總覽)空清單一律輸出 `[]`(exit 0)。對 JSON
|
||||||
交叉驗證時以此差異為準。`next` 兩者語義相同(無工作 → `null`/「沒有未完成的工作」)。
|
消費者來說 `[]` 比「無輸出」更明確(可區分「沒有結果」與「查詢失敗無輸出」),交叉驗證時
|
||||||
|
以此差異為準。`next` 兩者語義相同:無工作時 teai 輸出 `null`(exit 0)、`gitea.py` 印
|
||||||
|
「沒有未完成的工作」。**判決 #37:維持 teai 現行 JSON 一致性(方向 2)**——消費端
|
||||||
|
(agents 倉庫巡邏提示與觸發腳本)應以「輸出 `[]`/`null` 且 exit 0」為「沒有」判據,
|
||||||
|
不得以「無輸出」判斷;`members [--has-work]` 維持逐行帳號、空時無輸出(兩者一致,不受影響)。
|
||||||
|
`teai role` 不在 Supervisor/Agents 時同樣輸出 `null`(exit 0)。
|
||||||
- **清單欄位集(`mine`/`pulls`)**:`gitea.py` 直接傾倒完整 Gitea API 物件
|
- **清單欄位集(`mine`/`pulls`)**:`gitea.py` 直接傾倒完整 Gitea API 物件
|
||||||
(`_dump` 的副作用,欄位集隨 Gitea 版本浮動);teai 輸出策展摘要欄位
|
(`_dump` 的副作用,欄位集隨 Gitea 版本浮動);teai 輸出策展摘要欄位
|
||||||
(`mine`:repo/number/title/url;`pulls`:number/title/state/author/
|
(`mine`:repo/number/title/url;`pulls`:number/title/state/author/
|
||||||
@@ -345,7 +391,7 @@ teai whoami # 目前帳號(讀 tea 組態)
|
|||||||
### 安全設計
|
### 安全設計
|
||||||
|
|
||||||
- 本期命令全部唯讀;寫入類命令未來加入時須 `--yes` 明確確認。
|
- 本期命令全部唯讀;寫入類命令未來加入時須 `--yes` 明確確認。
|
||||||
- token 不入輸出、不入日誌;建議用 `TEAI_TOKEN` 或 tea 組態,避免出現在命令列。
|
- token 不入輸出、不入日誌;建議用 `TEAI_TOKEN` 或 teai 組態,避免出現在命令列。
|
||||||
- 清單類 API 一律帶 `limit`(Gitea 預設上限 50),避免漏抓。
|
- 清單類 API 一律帶 `limit`(Gitea 預設上限 50),避免漏抓。
|
||||||
- 「有無實際產出」的判斷一律對照遠端實況(API 回傳),不信任回報文字。
|
- 「有無實際產出」的判斷一律對照遠端實況(API 回傳),不信任回報文字。
|
||||||
|
|
||||||
|
|||||||
+22
-5
@@ -15,6 +15,7 @@ import (
|
|||||||
"flag"
|
"flag"
|
||||||
"fmt"
|
"fmt"
|
||||||
"io"
|
"io"
|
||||||
|
"runtime/debug"
|
||||||
"sort"
|
"sort"
|
||||||
"strings"
|
"strings"
|
||||||
"time"
|
"time"
|
||||||
@@ -23,8 +24,24 @@ import (
|
|||||||
)
|
)
|
||||||
|
|
||||||
// Version 是目前開發中的版本號。採用語意化版本;正式發佈前以 0 開頭。
|
// Version 是目前開發中的版本號。採用語意化版本;正式發佈前以 0 開頭。
|
||||||
|
// 僅作為 fallback:以 `go install module@version` 或納入其他 module 建置時,
|
||||||
|
// buildVersion 會改用 build info 內的 module 版本(見 runVersion)。
|
||||||
var Version = "0.1.0-dev"
|
var Version = "0.1.0-dev"
|
||||||
|
|
||||||
|
// buildVersion 回傳應顯示的版本字串。go install pkg@tag 建置的二元檔
|
||||||
|
// 會在 Main.Version 帶入 tag(如 v0.1.0);clone 目錄內本機建置則帶
|
||||||
|
// pseudo-version(如 v0.1.1-0.<時間戳>-<commit>,工作樹有修改時再附加
|
||||||
|
// "+dirty"),同樣直接顯示。Main.Version 為 "(devel)" 或空(go test 環境、
|
||||||
|
// 無 VCS 資訊的 tarball 建置)時,才退回開發版本號 Version。
|
||||||
|
func buildVersion() string {
|
||||||
|
if info, ok := debug.ReadBuildInfo(); ok {
|
||||||
|
if v := info.Main.Version; v != "" && v != "(devel)" {
|
||||||
|
return v
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return Version
|
||||||
|
}
|
||||||
|
|
||||||
// ExitCode 是 Run 回傳的行程結束碼。
|
// ExitCode 是 Run 回傳的行程結束碼。
|
||||||
type ExitCode int
|
type ExitCode int
|
||||||
|
|
||||||
@@ -58,9 +75,9 @@ type command struct {
|
|||||||
type Globals struct {
|
type Globals struct {
|
||||||
// URL 是 Gitea 站點網址。
|
// URL 是 Gitea 站點網址。
|
||||||
URL string
|
URL string
|
||||||
// Token 來自 --token 旗標;空字串表示未提供(依序退回環境變數與 tea 組態)。
|
// Token 來自 --token 旗標;空字串表示未提供(依序退回環境變數與 teai 組態)。
|
||||||
Token string
|
Token string
|
||||||
// ConfigPath 是 tea 組態路徑(--config,等同 TEA_CONFIG)。
|
// ConfigPath 是 teai 組態路徑(--config,等同 TEAI_CONFIG)。
|
||||||
ConfigPath string
|
ConfigPath string
|
||||||
// Output 是輸出格式。
|
// Output 是輸出格式。
|
||||||
Output gitea.Format
|
Output gitea.Format
|
||||||
@@ -437,7 +454,7 @@ func runVersion(env *Env, args []string) error {
|
|||||||
if len(args) > 0 {
|
if len(args) > 0 {
|
||||||
return &ErrUsage{Msg: "version 不接受參數"}
|
return &ErrUsage{Msg: "version 不接受參數"}
|
||||||
}
|
}
|
||||||
fmt.Fprintf(env.Out, "teai version %s\n", Version)
|
fmt.Fprintf(env.Out, "teai version %s\n", buildVersion())
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -447,8 +464,8 @@ func printUsage(w io.Writer) {
|
|||||||
fmt.Fprintf(w, "用法:\n teai [全域選項] <命令> [參數]\n\n")
|
fmt.Fprintf(w, "用法:\n teai [全域選項] <命令> [參數]\n\n")
|
||||||
fmt.Fprintf(w, "全域選項:\n")
|
fmt.Fprintf(w, "全域選項:\n")
|
||||||
fmt.Fprintf(w, " --url <URL> Gitea 站點(預設 https://gitea.alterminal.com)\n")
|
fmt.Fprintf(w, " --url <URL> Gitea 站點(預設 https://gitea.alterminal.com)\n")
|
||||||
fmt.Fprintf(w, " --token <TOKEN> API token;未給則依序嘗試 TEAI_TOKEN、tea 登入組態\n")
|
fmt.Fprintf(w, " --token <TOKEN> API token;未給則依序嘗試 TEAI_TOKEN、teai 登入組態\n")
|
||||||
fmt.Fprintf(w, " --config <path> tea 組態檔路徑,等同 TEA_CONFIG\n")
|
fmt.Fprintf(w, " --config <path> teai 組態檔路徑,等同 TEAI_CONFIG\n")
|
||||||
fmt.Fprintf(w, " --output <format> 輸出格式 json|table(預設 json)\n")
|
fmt.Fprintf(w, " --output <format> 輸出格式 json|table(預設 json)\n")
|
||||||
fmt.Fprintf(w, " --timeout <dur> HTTP 逾時(預設 30s)\n\n")
|
fmt.Fprintf(w, " --timeout <dur> HTTP 逾時(預設 30s)\n\n")
|
||||||
fmt.Fprintf(w, "命令:\n")
|
fmt.Fprintf(w, "命令:\n")
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// dailyops_commands.go — 日常操作命令的 CLI 接線(#8):issues、pulls、
|
// dailyops_commands.go — 日常操作命令的 CLI 接線(#8):issues、pulls、
|
||||||
// labels、milestones、releases、repos、api(tea 對等指令)。
|
// labels、milestones、releases、repos、organizations、api(tea 對等指令)。
|
||||||
//
|
//
|
||||||
// 規則:
|
// 規則:
|
||||||
// - 寫入類命令(create/close/comment/merge…)一律要求 --yes,
|
// - 寫入類命令(create/close/comment/merge…)一律要求 --yes,
|
||||||
@@ -33,6 +33,7 @@ func init() {
|
|||||||
register(&command{name: "milestones", usage: "里程碑(跨倉庫總覽;list/create 管理單倉庫)", run: runMilestones})
|
register(&command{name: "milestones", usage: "里程碑(跨倉庫總覽;list/create 管理單倉庫)", run: runMilestones})
|
||||||
register(&command{name: "releases", usage: "發佈清單(list)", run: runReleases})
|
register(&command{name: "releases", usage: "發佈清單(list)", run: runReleases})
|
||||||
register(&command{name: "repos", usage: "倉庫查詢(list)", run: runRepos})
|
register(&command{name: "repos", usage: "倉庫查詢(list)", run: runRepos})
|
||||||
|
register(&command{name: "organizations", usage: "組織管理(list/create/delete;tea organizations 對等)", run: runOrganizations})
|
||||||
register(&command{name: "api", usage: "任意 API 呼叫(--method/--data;寫入動詞需 --yes)", run: runAPIDirect})
|
register(&command{name: "api", usage: "任意 API 呼叫(--method/--data;寫入動詞需 --yes)", run: runAPIDirect})
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1097,3 +1098,134 @@ func runAPIDirect(env *Env, args []string) error {
|
|||||||
}
|
}
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ---- organizations(#45,tea organizations 對等)----
|
||||||
|
|
||||||
|
// orgListFields 是 organizations 清單的欄位定義。
|
||||||
|
func orgListFields() []gitea.Field {
|
||||||
|
return []gitea.Field{
|
||||||
|
{Name: "name"}, {Name: "full_name"}, {Name: "website"},
|
||||||
|
{Name: "location"}, {Name: "description"}, {Name: "visibility"},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// runOrganizations:teai organizations [list|create|delete] …。
|
||||||
|
// tea 對等:organizations list 列出自己可存取的組織;create/delete 是
|
||||||
|
// 寫入操作,比照慣例要求 --yes。
|
||||||
|
func runOrganizations(env *Env, args []string) error {
|
||||||
|
if len(args) == 0 {
|
||||||
|
return &ErrUsage{Msg: "organizations 需要子命令:list | create | delete"}
|
||||||
|
}
|
||||||
|
sub, rest := args[0], args[1:]
|
||||||
|
switch sub {
|
||||||
|
case "list":
|
||||||
|
return runOrganizationsList(env, rest)
|
||||||
|
case "create":
|
||||||
|
return runOrganizationsCreate(env, rest)
|
||||||
|
case "delete":
|
||||||
|
return runOrganizationsDelete(env, rest)
|
||||||
|
default:
|
||||||
|
return &ErrUsage{Msg: fmt.Sprintf("organizations 未知子命令 %q(可用:list | create | delete)", sub)}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// runOrganizationsList:teai organizations list。
|
||||||
|
// GET /user/orgs(與 teai orgs 工作流命令同一端點,但輸出完整欄位)。
|
||||||
|
func runOrganizationsList(env *Env, args []string) error {
|
||||||
|
fs := flag.NewFlagSet("teai organizations list", flag.ContinueOnError)
|
||||||
|
fs.SetOutput(env.Err)
|
||||||
|
if err := parseFlags(fs, args); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if fs.NArg() != 0 {
|
||||||
|
return &ErrUsage{Msg: "organizations list 不接受位置參數"}
|
||||||
|
}
|
||||||
|
ops, err := newOpsClient(env)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
orgs, err := ops.ListMyOrganizations(context.Background())
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
p := printer(env)
|
||||||
|
rows := make([]gitea.Values, 0, len(orgs))
|
||||||
|
for i := range orgs {
|
||||||
|
org := &orgs[i]
|
||||||
|
rows = append(rows, gitea.Values{
|
||||||
|
org.Account(), org.FullName, org.Website,
|
||||||
|
org.Location, org.Description, org.Visibility,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
return p.PrintList(orgListFields(), rows)
|
||||||
|
}
|
||||||
|
|
||||||
|
// runOrganizationsCreate:teai organizations create --name … [--full-name …]
|
||||||
|
// [--description …] [--website …] [--location …] [--visibility public|limited|private] --yes。
|
||||||
|
// tea 以位置參數給組織名;teai 慣例用 --name(語義等價,命名與其他 create 一致)。
|
||||||
|
func runOrganizationsCreate(env *Env, args []string) error {
|
||||||
|
fs := flag.NewFlagSet("teai organizations create", flag.ContinueOnError)
|
||||||
|
fs.SetOutput(env.Err)
|
||||||
|
name := fs.String("name", "", "組織帳號名(必填,同 tea 的位置參數)")
|
||||||
|
fullName := fs.String("full-name", "", "顯示名稱")
|
||||||
|
desc := fs.String("description", "", "說明")
|
||||||
|
website := fs.String("website", "", "網站")
|
||||||
|
location := fs.String("location", "", "所在地")
|
||||||
|
visibility := fs.String("visibility", "", "可見度:public|limited|private(預設服務端決定)")
|
||||||
|
yes := fs.Bool("yes", false, "確認寫入")
|
||||||
|
if err := parseFlags(fs, args); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if strings.TrimSpace(*name) == "" {
|
||||||
|
return &ErrUsage{Msg: "organizations create 需要 --name"}
|
||||||
|
}
|
||||||
|
switch *visibility {
|
||||||
|
case "", "public", "limited", "private":
|
||||||
|
default:
|
||||||
|
return &ErrUsage{Msg: "organizations create 的 --visibility 需為 public|limited|private"}
|
||||||
|
}
|
||||||
|
if err := requireYes(*yes, "organizations create"); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
ops, err := newOpsClient(env)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
org, err := ops.CreateOrganization(context.Background(), *name, *fullName, *desc, *website, *location, *visibility)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return printer(env).PrintOne(orgListFields(), gitea.Values{
|
||||||
|
org.Account(), org.FullName, org.Website,
|
||||||
|
org.Location, org.Description, org.Visibility,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// runOrganizationsDelete:teai organizations delete <name> --yes。
|
||||||
|
// tea 相容:組織名作為位置參數。
|
||||||
|
func runOrganizationsDelete(env *Env, args []string) error {
|
||||||
|
fs := flag.NewFlagSet("teai organizations delete", flag.ContinueOnError)
|
||||||
|
fs.SetOutput(env.Err)
|
||||||
|
yes := fs.Bool("yes", false, "確認寫入")
|
||||||
|
if err := parseFlags(fs, args); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if fs.NArg() != 1 {
|
||||||
|
return &ErrUsage{Msg: "organizations delete 需要恰好一個組織名"}
|
||||||
|
}
|
||||||
|
orgName := strings.TrimSpace(fs.Arg(0))
|
||||||
|
if orgName == "" {
|
||||||
|
return &ErrUsage{Msg: "organizations delete 需要組織名"}
|
||||||
|
}
|
||||||
|
if err := requireYes(*yes, "organizations delete"); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
ops, err := newOpsClient(env)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if err := ops.DeleteOrganization(context.Background(), orgName); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return printer(env).PrintOne([]gitea.Field{{Name: "name"}, {Name: "state"}}, gitea.Values{orgName, "deleted"})
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
// login.go — teai login 指令:管理 tea 相容的登入組態。
|
// login.go — teai login 指令:管理 teai 自己的登入組態。
|
||||||
//
|
//
|
||||||
// teai 與 tea 共用同一份組態檔(README 設計原則 5),login 的職責是:
|
// 組態由 teai 自行讀寫(README 設計原則 5),不依賴 tea。login 的職責是:
|
||||||
// 以 token 向站點驗證(GET /user),成功後才寫入組態並記下帳號。
|
// 以 token 向站點驗證(GET /user),成功後才寫入組態並記下帳號。
|
||||||
// token 只走記憶體與組態檔,不進輸出、日誌或錯誤訊息。
|
// token 只走記憶體與組態檔,不進輸出、日誌或錯誤訊息。
|
||||||
//
|
//
|
||||||
@@ -25,20 +25,20 @@ import (
|
|||||||
// loginStdin 是讀 token 與確認的輸入(測試可替換)。
|
// loginStdin 是讀 token 與確認的輸入(測試可替換)。
|
||||||
var loginStdin io.Reader = os.Stdin
|
var loginStdin io.Reader = os.Stdin
|
||||||
|
|
||||||
// loginConfigPath 回傳組態檔路徑:--config/TEA_CONFIG 優先,其次
|
// loginConfigPath 回傳組態檔路徑:--config/TEAI_CONFIG 優先,其次
|
||||||
// ~/.config/tea/config.yml。找不到可用路徑回空字串。
|
// ~/.config/teai/config.yml。找不到可用路徑回空字串。
|
||||||
func loginConfigPath(g Globals) string {
|
func loginConfigPath(g Globals) string {
|
||||||
if p := strings.TrimSpace(g.ConfigPath); p != "" {
|
if p := strings.TrimSpace(g.ConfigPath); p != "" {
|
||||||
return expandHome(p)
|
return expandHome(p)
|
||||||
}
|
}
|
||||||
if p := os.Getenv("TEA_CONFIG"); strings.TrimSpace(p) != "" {
|
if p := os.Getenv("TEAI_CONFIG"); strings.TrimSpace(p) != "" {
|
||||||
return expandHome(strings.TrimSpace(p))
|
return expandHome(strings.TrimSpace(p))
|
||||||
}
|
}
|
||||||
home, err := os.UserHomeDir()
|
home, err := os.UserHomeDir()
|
||||||
if err != nil || home == "" {
|
if err != nil || home == "" {
|
||||||
return ""
|
return ""
|
||||||
}
|
}
|
||||||
return filepath.Join(home, ".config", "tea", "config.yml")
|
return filepath.Join(home, ".config", "teai", "config.yml")
|
||||||
}
|
}
|
||||||
|
|
||||||
// expandHome 展開路徑開頭的 ~。
|
// expandHome 展開路徑開頭的 ~。
|
||||||
@@ -178,7 +178,7 @@ func runLoginAdd(env *Env, args []string) error {
|
|||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if err := gitea.SaveTeaConfigFile(path, out); err != nil {
|
if err := gitea.SaveConfigFile(path, out); err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
p := gitea.Printer{Format: env.Globals.Output, Out: env.Out}
|
p := gitea.Printer{Format: env.Globals.Output, Out: env.Out}
|
||||||
@@ -329,7 +329,7 @@ func saveLoginConfig(env *Env, data []byte) error {
|
|||||||
if path == "" {
|
if path == "" {
|
||||||
return fmt.Errorf("cannot determine config path")
|
return fmt.Errorf("cannot determine config path")
|
||||||
}
|
}
|
||||||
return gitea.SaveTeaConfigFile(path, data)
|
return gitea.SaveConfigFile(path, data)
|
||||||
}
|
}
|
||||||
|
|
||||||
// findLoginByHost 在組態內容中找 URL 主機與 siteURL 相同的登入。
|
// findLoginByHost 在組態內容中找 URL 主機與 siteURL 相同的登入。
|
||||||
@@ -352,7 +352,7 @@ func findLogin(data []byte, name string) (gitea.LoginEntry, bool) {
|
|||||||
return gitea.LoginEntry{}, false
|
return gitea.LoginEntry{}, false
|
||||||
}
|
}
|
||||||
|
|
||||||
// defaultLoginName 以 URL 主機作為登入名稱(同 tea 的習慣)。
|
// defaultLoginName 以 URL 主機作為登入名稱。
|
||||||
func defaultLoginName(rawURL string) string {
|
func defaultLoginName(rawURL string) string {
|
||||||
s := rawURL
|
s := rawURL
|
||||||
if !strings.Contains(s, "://") {
|
if !strings.Contains(s, "://") {
|
||||||
|
|||||||
@@ -25,7 +25,7 @@ func loginTestEnv(t *testing.T, configContent string) (args []string, configPath
|
|||||||
t.Fatal(err)
|
t.Fatal(err)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
t.Setenv("TEA_CONFIG", configPath)
|
t.Setenv("TEAI_CONFIG", configPath)
|
||||||
return []string{"--config", configPath}, configPath
|
return []string{"--config", configPath}, configPath
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -117,6 +117,13 @@ func TestLoginAddVerifiesThenWrites(t *testing.T) {
|
|||||||
if info.Mode().Perm() != 0o600 {
|
if info.Mode().Perm() != 0o600 {
|
||||||
t.Fatalf("perm = %v", info.Mode().Perm())
|
t.Fatalf("perm = %v", info.Mode().Perm())
|
||||||
}
|
}
|
||||||
|
// 新項目只寫 teai 欄位,不含 tea 的 ssh_*/preferences。
|
||||||
|
s := string(data)
|
||||||
|
for _, ban := range []string{"ssh_", "insecure:", "version_check:", "preferences:"} {
|
||||||
|
if strings.Contains(s, ban) {
|
||||||
|
t.Fatalf("tea field leaked %q:\n%s", ban, s)
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
func TestLoginAddTokenFromStdin(t *testing.T) {
|
func TestLoginAddTokenFromStdin(t *testing.T) {
|
||||||
@@ -187,6 +194,7 @@ preferences:
|
|||||||
if strings.Contains(s, "old-tok") || !strings.Contains(s, "token: new-tok") {
|
if strings.Contains(s, "old-tok") || !strings.Contains(s, "token: new-tok") {
|
||||||
t.Fatalf("token not replaced:\n%s", s)
|
t.Fatalf("token not replaced:\n%s", s)
|
||||||
}
|
}
|
||||||
|
// 未知欄位與其他區段逐字保留(行級編輯,不整檔覆寫)。
|
||||||
if !strings.Contains(s, `ssh_key: "keep-me"`) || !strings.Contains(s, "editor: false") {
|
if !strings.Contains(s, `ssh_key: "keep-me"`) || !strings.Contains(s, "editor: false") {
|
||||||
t.Fatalf("unrelated content lost:\n%s", s)
|
t.Fatalf("unrelated content lost:\n%s", s)
|
||||||
}
|
}
|
||||||
@@ -290,3 +298,26 @@ func TestLoginRegisteredInUsage(t *testing.T) {
|
|||||||
t.Fatalf("usage should list login: %s", stdout)
|
t.Fatalf("usage should list login: %s", stdout)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func TestLoginConfigPathIndependentOfTea(t *testing.T) {
|
||||||
|
t.Setenv("TEA_CONFIG", "/from-tea.yml")
|
||||||
|
t.Setenv("TEAI_CONFIG", "")
|
||||||
|
g := defaultGlobals()
|
||||||
|
got := loginConfigPath(g)
|
||||||
|
if got == "/from-tea.yml" {
|
||||||
|
t.Fatal("TEA_CONFIG must not be used")
|
||||||
|
}
|
||||||
|
if !strings.HasSuffix(filepath.ToSlash(got), ".config/teai/config.yml") {
|
||||||
|
t.Fatalf("default path want ~/.config/teai/config.yml, got %q", got)
|
||||||
|
}
|
||||||
|
|
||||||
|
t.Setenv("TEAI_CONFIG", "/from-teai.yml")
|
||||||
|
if got := loginConfigPath(g); got != "/from-teai.yml" {
|
||||||
|
t.Fatalf("TEAI_CONFIG: got %q", got)
|
||||||
|
}
|
||||||
|
|
||||||
|
g.ConfigPath = "/explicit.yml"
|
||||||
|
if got := loginConfigPath(g); got != "/explicit.yml" {
|
||||||
|
t.Fatalf("--config: got %q", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -0,0 +1,169 @@
|
|||||||
|
// organizations_commands_test.go — #45 的驗收測試:tea organizations 對等指令
|
||||||
|
// list/create/delete。讀取 list 打對端點;寫入 create/delete 未帶 --yes
|
||||||
|
// 不得發出任何請求,帶 --yes 時打對端點與 payload。
|
||||||
|
package cli
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"net/http"
|
||||||
|
"strings"
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
// TestOrganizationsListGetsUserOrgs 驗證 organizations list:
|
||||||
|
// GET /user/orgs,輸出 name(username 優先)與 full_name 等欄位。
|
||||||
|
func TestOrganizationsListGetsUserOrgs(t *testing.T) {
|
||||||
|
var gotMethod, gotPath string
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
gotMethod, gotPath = r.Method, r.URL.Path
|
||||||
|
fmt.Fprint(w, `[{"username":"alterminal","name":"alterminal","full_name":"Alterminal Co., Ltd.","website":"","location":"","description":"","visibility":"public"},{"username":"","name":"fallback-org","full_name":"Fallback Org","visibility":"public"}]`)
|
||||||
|
})
|
||||||
|
stdout, _, code := run("organizations", "list")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("organizations list 應回 0,得到 %d", code)
|
||||||
|
}
|
||||||
|
if gotMethod != "GET" || !strings.HasSuffix(gotPath, "/user/orgs") {
|
||||||
|
t.Errorf("應 GET /user/orgs,得到 %s %s", gotMethod, gotPath)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stdout, `"name":"alterminal"`) || !strings.Contains(stdout, `"full_name":"Alterminal Co., Ltd."`) {
|
||||||
|
t.Errorf("輸出應含 name 與 full_name,得到:%s", stdout)
|
||||||
|
}
|
||||||
|
// username 缺漏時回退 name 欄位(同 workflow.Org.Account 取值順序)。
|
||||||
|
if !strings.Contains(stdout, `"name":"fallback-org"`) {
|
||||||
|
t.Errorf("username 缺漏時 name 应回退 name 欄位,得到:%s", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsListRejectsPositionalArgs 驗證 list 不接受位置參數(回 2)。
|
||||||
|
func TestOrganizationsListRejectsPositionalArgs(t *testing.T) {
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
t.Errorf("不應發出任何請求")
|
||||||
|
})
|
||||||
|
_, stderr, code := run("organizations", "list", "alterminal")
|
||||||
|
if code != 2 {
|
||||||
|
t.Errorf("list 帶位置參數應回 2,得到 %d", code)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stderr, "位置參數") {
|
||||||
|
t.Errorf("錯誤訊息應提及位置參數,得到:%s", stderr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsCreateRequiresYes 驗證 create 未帶 --yes:回 2 且不發請求。
|
||||||
|
func TestOrganizationsCreateRequiresYes(t *testing.T) {
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
t.Errorf("未帶 --yes 不得發出請求(%s %s)", r.Method, r.URL.Path)
|
||||||
|
})
|
||||||
|
_, stderr, code := run("organizations", "create", "--name", "neworg")
|
||||||
|
if code != 2 {
|
||||||
|
t.Errorf("create 未帶 --yes 應回 2,得到 %d", code)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stderr, "--yes") {
|
||||||
|
t.Errorf("錯誤訊息應提及 --yes,得到:%s", stderr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsCreateRequiresName 驗證 create 缺 --name:回 2(且在 --yes 閘門之前檢查)。
|
||||||
|
func TestOrganizationsCreateRequiresName(t *testing.T) {
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
t.Errorf("缺 --name 不應發出請求")
|
||||||
|
})
|
||||||
|
_, stderr, code := run("organizations", "create", "--yes")
|
||||||
|
if code != 2 {
|
||||||
|
t.Errorf("create 缺 --name 應回 2,得到 %d", code)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stderr, "--name") {
|
||||||
|
t.Errorf("錯誤訊息應提及 --name,得到:%s", stderr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsCreatePostsOrg 驗證 create --yes:
|
||||||
|
// POST /orgs,payload 帶 username 與 full_name;visibility 空時不傳。
|
||||||
|
func TestOrganizationsCreatePostsOrg(t *testing.T) {
|
||||||
|
var gotMethod, gotPath, gotBody string
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
gotMethod, gotPath = r.Method, r.URL.Path
|
||||||
|
buf := make([]byte, 1024)
|
||||||
|
n, _ := r.Body.Read(buf)
|
||||||
|
gotBody = string(buf[:n])
|
||||||
|
fmt.Fprint(w, `{"username":"neworg","name":"neworg","full_name":"New Org","website":"https://x","location":"TW","description":"d","visibility":"public"}`)
|
||||||
|
})
|
||||||
|
stdout, _, code := run("organizations", "create", "--yes", "--name", "neworg", "--full-name", "New Org", "--website", "https://x", "--location", "TW", "--description", "d")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("create --yes 應回 0,得到 %d", code)
|
||||||
|
}
|
||||||
|
if gotMethod != "POST" || !strings.HasSuffix(gotPath, "/orgs") {
|
||||||
|
t.Errorf("應 POST /orgs,得到 %s %s", gotMethod, gotPath)
|
||||||
|
}
|
||||||
|
for _, want := range []string{`"username":"neworg"`, `"full_name":"New Org"`, `"website":"https://x"`, `"location":"TW"`, `"description":"d"`} {
|
||||||
|
if !strings.Contains(gotBody, want) {
|
||||||
|
t.Errorf("body 應含 %s,得到:%s", want, gotBody)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if strings.Contains(gotBody, "visibility") {
|
||||||
|
t.Errorf("未指定 --visibility 時 body 不應含 visibility,得到:%s", gotBody)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stdout, `"name":"neworg"`) || !strings.Contains(stdout, `"full_name":"New Org"`) {
|
||||||
|
t.Errorf("輸出應含 name 與 full_name,得到:%s", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsCreateRejectsBadVisibility 驗證 --visibility 值域檢查(回 2,不發請求)。
|
||||||
|
func TestOrganizationsCreateRejectsBadVisibility(t *testing.T) {
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
t.Errorf("值域檢查失敗不應發出請求")
|
||||||
|
})
|
||||||
|
_, stderr, code := run("organizations", "create", "--yes", "--name", "neworg", "--visibility", "secret")
|
||||||
|
if code != 2 {
|
||||||
|
t.Errorf("--visibility secret 應回 2,得到 %d", code)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stderr, "visibility") {
|
||||||
|
t.Errorf("錯誤訊息應提及 visibility,得到:%s", stderr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsDeleteRequiresYes 驗證 delete 未帶 --yes:回 2 且不發請求。
|
||||||
|
func TestOrganizationsDeleteRequiresYes(t *testing.T) {
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
t.Errorf("未帶 --yes 不得發出請求(%s %s)", r.Method, r.URL.Path)
|
||||||
|
})
|
||||||
|
_, stderr, code := run("organizations", "delete", "oldorg")
|
||||||
|
if code != 2 {
|
||||||
|
t.Errorf("delete 未帶 --yes 應回 2,得到 %d", code)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stderr, "--yes") {
|
||||||
|
t.Errorf("錯誤訊息應提及 --yes,得到:%s", stderr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsDeleteOrg 驗證 delete --yes:DELETE /orgs/{org}。
|
||||||
|
func TestOrganizationsDeleteOrg(t *testing.T) {
|
||||||
|
var gotMethod, gotPath string
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
gotMethod, gotPath = r.Method, r.URL.Path
|
||||||
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
})
|
||||||
|
stdout, _, code := run("organizations", "delete", "--yes", "oldorg")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("delete --yes 應回 0,得到 %d", code)
|
||||||
|
}
|
||||||
|
if gotMethod != "DELETE" || !strings.HasSuffix(gotPath, "/orgs/oldorg") {
|
||||||
|
t.Errorf("應 DELETE /orgs/oldorg,得到 %s %s", gotMethod, gotPath)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stdout, `"state":"deleted"`) {
|
||||||
|
t.Errorf("輸出應含 state=deleted,得到:%s", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestOrganizationsUnknownSubcommand 驗證未知子命令回 2。
|
||||||
|
func TestOrganizationsUnknownSubcommand(t *testing.T) {
|
||||||
|
run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
t.Errorf("未知子命令不應發出請求")
|
||||||
|
})
|
||||||
|
_, stderr, code := run("organizations", "rename")
|
||||||
|
if code != 2 {
|
||||||
|
t.Errorf("未知子命令應回 2,得到 %d", code)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stderr, "organizations") {
|
||||||
|
t.Errorf("錯誤訊息應提及 organizations,得到:%s", stderr)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -117,6 +117,24 @@ func TestWiringStalled(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TestWiringStalledEmpty 驗證 stalled 無任何條目時輸出 []、exit 0(#37)。
|
||||||
|
func TestWiringStalledEmpty(t *testing.T) {
|
||||||
|
newStubStalledEnv(t, &stubStalledSource{
|
||||||
|
username: "ceo",
|
||||||
|
orgs: []string{"alterminal"},
|
||||||
|
repos: map[string][]workflow.Repo{"alterminal": {}},
|
||||||
|
issues: map[string]map[int64]workflow.Issue{},
|
||||||
|
comments: map[string][]workflow.Comment{},
|
||||||
|
}, time.Date(2026, 9, 10, 8, 0, 0, 0, time.UTC))
|
||||||
|
stdout, _, code := run("stalled")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("stalled 空情境應回 0,得到 %d(stdout=%q)", code, stdout)
|
||||||
|
}
|
||||||
|
if strings.TrimSpace(stdout) != "[]" {
|
||||||
|
t.Fatalf("stalled 無條目應輸出 [],得到 %q", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
// TestWiringStalledHoursFlag 驗證 --hours 覆寫門檻與非正數被攔。
|
// TestWiringStalledHoursFlag 驗證 --hours 覆寫門檻與非正數被攔。
|
||||||
func TestWiringStalledHoursFlag(t *testing.T) {
|
func TestWiringStalledHoursFlag(t *testing.T) {
|
||||||
freeze := time.Date(2026, 9, 10, 8, 0, 0, 0, time.UTC)
|
freeze := time.Date(2026, 9, 10, 8, 0, 0, 0, time.UTC)
|
||||||
|
|||||||
@@ -0,0 +1,33 @@
|
|||||||
|
// version_test.go 驗證版本字串解析:go test 環境 Main.Version 為 "(devel)"
|
||||||
|
// 時應退回開發版本號;tag 與 pseudo-version 行為由建置驗證涵蓋
|
||||||
|
// (go install pkg@tag 顯示 tag;clone 建置顯示 pseudo-version)。
|
||||||
|
package cli
|
||||||
|
|
||||||
|
import (
|
||||||
|
"strings"
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
// TestBuildVersionFallsBackToDev 確認本地測試環境(Main.Version == "(devel)")
|
||||||
|
// 退回 Version;同時確保輸出是可讀版本字串(非空、無括號)。
|
||||||
|
func TestBuildVersionFallsBackToDev(t *testing.T) {
|
||||||
|
v := buildVersion()
|
||||||
|
if v == "" {
|
||||||
|
t.Fatalf("buildVersion 不應為空")
|
||||||
|
}
|
||||||
|
if strings.ContainsAny(v, "()") {
|
||||||
|
t.Errorf("buildVersion 不應含內部佔位(括號),得到:%q", v)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestRunVersionUsesBuildVersion 確認 version 命令輸出 buildVersion 的結果。
|
||||||
|
func TestRunVersionUsesBuildVersion(t *testing.T) {
|
||||||
|
stdout, _, code := run("version")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("version 應回 0,得到 %d", code)
|
||||||
|
}
|
||||||
|
want := "teai version " + buildVersion()
|
||||||
|
if !strings.Contains(stdout, want) {
|
||||||
|
t.Errorf("version 輸出應含 %q,得到:%q", want, stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
// workflow_commands.go — gitea.py 工作流命令的 CLI 接線(#6):
|
// workflow_commands.go — gitea.py 工作流命令的 CLI 接線(#6):
|
||||||
// whoami、orgs、members [--has-work]、mine、pulls [--mine|--reviewer] [--repo]、next。
|
// whoami、role、orgs、members [--has-work]、mine、pulls [--mine|--reviewer] [--repo]、next。
|
||||||
//
|
//
|
||||||
// 輸出走 internal/gitea 的 Printer(--output json|table);錯誤經 cli.exitCodeFor
|
// 輸出走 internal/gitea 的 Printer(--output json|table);錯誤經 cli.exitCodeFor
|
||||||
// 映射結束碼(用法 2/API 3)。token 解析選序見 internal/gitea/auth.go。
|
// 映射結束碼(用法 2/API 3)。token 解析選序見 internal/gitea/auth.go。
|
||||||
@@ -20,6 +20,7 @@ func init() {
|
|||||||
commands[c.name] = c
|
commands[c.name] = c
|
||||||
}
|
}
|
||||||
register(&command{name: "whoami", usage: "目前帳號", run: runWhoami})
|
register(&command{name: "whoami", usage: "目前帳號", run: runWhoami})
|
||||||
|
register(&command{name: "role", usage: "目前角色(Supervisor→supervisor,Agents→worker)", run: runRole})
|
||||||
register(&command{name: "orgs", usage: "我所屬的組織", run: runOrgs})
|
register(&command{name: "orgs", usage: "我所屬的組織", run: runOrgs})
|
||||||
register(&command{name: "members", usage: "Agents 團隊成員;--has-work 只列有未完成工作者", run: runMembers})
|
register(&command{name: "members", usage: "Agents 團隊成員;--has-work 只列有未完成工作者", run: runMembers})
|
||||||
register(&command{name: "mine", usage: "分派給我、待跟進的 issues", run: runMine})
|
register(&command{name: "mine", usage: "分派給我、待跟進的 issues", run: runMine})
|
||||||
@@ -77,6 +78,29 @@ func runWhoami(env *Env, args []string) error {
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// runRole:teai role。不在 Supervisor/Agents 團隊時輸出 null(exit 0)。
|
||||||
|
func runRole(env *Env, args []string) error {
|
||||||
|
if len(args) != 0 {
|
||||||
|
return &ErrUsage{Msg: "role 不接受參數"}
|
||||||
|
}
|
||||||
|
s, err := newScannerFunc(env)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
role, err := s.Role()
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
p := printer(env)
|
||||||
|
if role == "" {
|
||||||
|
return p.PrintNull()
|
||||||
|
}
|
||||||
|
return p.PrintOne(
|
||||||
|
[]gitea.Field{{Name: "role"}},
|
||||||
|
gitea.Values{role},
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
// runOrgs:teai orgs。
|
// runOrgs:teai orgs。
|
||||||
func runOrgs(env *Env, args []string) error {
|
func runOrgs(env *Env, args []string) error {
|
||||||
if len(args) != 0 {
|
if len(args) != 0 {
|
||||||
|
|||||||
@@ -224,6 +224,71 @@ func TestWiringWhoamiOrgs(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TestWiringRoleWorker 驗證 Agents 成員的 role 輸出 worker。
|
||||||
|
func TestWiringRoleWorker(t *testing.T) {
|
||||||
|
newStubEnv(t, newStubData())
|
||||||
|
stdout, _, code := run("role")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("role 應回 0,得到 %d(stdout=%q)", code, stdout)
|
||||||
|
}
|
||||||
|
if strings.TrimSpace(stdout) != `{"role":"worker"}` {
|
||||||
|
t.Fatalf("Agents 成員 role 應輸出 worker,得到 %q", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestWiringRoleSupervisor 驗證 Supervisor 成員的 role 輸出 supervisor。
|
||||||
|
func TestWiringRoleSupervisor(t *testing.T) {
|
||||||
|
c := newStubData()
|
||||||
|
c.teams["alterminal"] = []workflow.Team{
|
||||||
|
{ID: 1, Name: "Agents"},
|
||||||
|
{ID: 2, Name: "Supervisor"},
|
||||||
|
}
|
||||||
|
c.members[2] = []string{"alex"}
|
||||||
|
newStubEnv(t, c)
|
||||||
|
stdout, _, code := run("role")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("role 應回 0,得到 %d(stdout=%q)", code, stdout)
|
||||||
|
}
|
||||||
|
if strings.TrimSpace(stdout) != `{"role":"supervisor"}` {
|
||||||
|
t.Fatalf("Supervisor 成員 role 應輸出 supervisor,得到 %q", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestWiringRoleNone 驗證不在任一角色團隊時輸出 null、exit 0。
|
||||||
|
func TestWiringRoleNone(t *testing.T) {
|
||||||
|
c := newStubData()
|
||||||
|
c.currentUser = "outsider"
|
||||||
|
newStubEnv(t, c)
|
||||||
|
stdout, _, code := run("role")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("role 無角色應回 0,得到 %d", code)
|
||||||
|
}
|
||||||
|
if strings.TrimSpace(stdout) != "null" {
|
||||||
|
t.Fatalf("role 無角色應輸出 null,得到 %q", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestWiringRoleRejectsArgs 驗證 role 不接受參數。
|
||||||
|
func TestWiringRoleRejectsArgs(t *testing.T) {
|
||||||
|
newStubEnv(t, newStubData())
|
||||||
|
_, _, code := run("role", "extra")
|
||||||
|
if code != int(ExitUsage) {
|
||||||
|
t.Fatalf("role extra 應回 ExitUsage(%d),得到 %d", int(ExitUsage), code)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestWiringRoleTable 驗證 teai role --output table。
|
||||||
|
func TestWiringRoleTable(t *testing.T) {
|
||||||
|
newStubEnv(t, newStubData())
|
||||||
|
stdout, _, code := run("role", "--output", "table")
|
||||||
|
if code != 0 {
|
||||||
|
t.Fatalf("role --output table 應回 0,得到 %d", code)
|
||||||
|
}
|
||||||
|
if !strings.Contains(stdout, "worker") {
|
||||||
|
t.Fatalf("role --output table 應含 worker,得到 %q", stdout)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
// TestWiringVersionRejectsArgs 驗證 version 不接受參數(新剖析語義下仍 exit 2)。
|
// TestWiringVersionRejectsArgs 驗證 version 不接受參數(新剖析語義下仍 exit 2)。
|
||||||
func TestWiringVersionRejectsArgs(t *testing.T) {
|
func TestWiringVersionRejectsArgs(t *testing.T) {
|
||||||
_, _, code := run("version", "--wat")
|
_, _, code := run("version", "--wat")
|
||||||
|
|||||||
@@ -470,3 +470,64 @@ func (o *Ops) CallAPIDirect(ctx context.Context, method, path, rawQuery string,
|
|||||||
}
|
}
|
||||||
return o.Client.DoRaw(ctx, method, path, rawQuery, data)
|
return o.Client.DoRaw(ctx, method, path, rawQuery, data)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ---- organizations(#45,tea organizations 對等)----
|
||||||
|
|
||||||
|
// Organization 是帳號所屬/可存取組織的精簡欄位
|
||||||
|
// (GET /user/orgs、POST /orgs 回應共用)。name 是帳號名、
|
||||||
|
// full_name 是顯示名稱(如 "Alterminal Co., Ltd."),兩者不同。
|
||||||
|
type Organization struct {
|
||||||
|
UserName string `json:"username"`
|
||||||
|
Name string `json:"name"`
|
||||||
|
FullName string `json:"full_name"`
|
||||||
|
Website string `json:"website"`
|
||||||
|
Location string `json:"location"`
|
||||||
|
Description string `json:"description"`
|
||||||
|
Visibility string `json:"visibility"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// Account 回傳組織帳號名:先 username,缺漏時回退 name
|
||||||
|
// (同 workflow.Org.Account 的取值順序)。
|
||||||
|
func (o *Organization) Account() string {
|
||||||
|
if o.UserName != "" {
|
||||||
|
return o.UserName
|
||||||
|
}
|
||||||
|
return o.Name
|
||||||
|
}
|
||||||
|
|
||||||
|
// ListMyOrganizations 列出自己可存取的組織(GET /user/orgs,分頁)。
|
||||||
|
// tea organizations list 的對等端點;teai orgs(工作流)輸出帳號清單,
|
||||||
|
// 本指令輸出完整欄位供日常操作使用。
|
||||||
|
func (o *Ops) ListMyOrganizations(ctx context.Context) ([]Organization, error) {
|
||||||
|
var orgs []Organization
|
||||||
|
if err := o.Client.ListAll(ctx, "/user/orgs", gitea.ListOptions{}, &orgs); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return orgs, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// CreateOrganization 建立組織(POST /orgs)。name 必填;其餘欄位可空。
|
||||||
|
// visibility:public|limited|private(空值交由服務端預設)。
|
||||||
|
func (o *Ops) CreateOrganization(ctx context.Context, name, fullName, description, website, location, visibility string) (*Organization, error) {
|
||||||
|
payload := map[string]any{
|
||||||
|
"username": name,
|
||||||
|
"full_name": fullName,
|
||||||
|
"description": description,
|
||||||
|
"website": website,
|
||||||
|
"location": location,
|
||||||
|
}
|
||||||
|
if visibility != "" {
|
||||||
|
payload["visibility"] = visibility
|
||||||
|
}
|
||||||
|
var org Organization
|
||||||
|
if err := o.Client.DoJSON(ctx, "POST", "/orgs", "", payload, &org); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return &org, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// DeleteOrganization 刪除組織(DELETE /orgs/{org})。
|
||||||
|
func (o *Ops) DeleteOrganization(ctx context.Context, org string) error {
|
||||||
|
path := "/orgs/" + url.PathEscape(org)
|
||||||
|
return o.Client.DoJSON(ctx, "DELETE", path, "", nil, nil)
|
||||||
|
}
|
||||||
|
|||||||
+28
-29
@@ -1,7 +1,7 @@
|
|||||||
// auth.go — 認證來源的解析與選序。
|
// auth.go — 認證來源的解析與選序。
|
||||||
//
|
//
|
||||||
// 選序(README「全域介面」):--token 旗標 → TEAI_TOKEN 環境變數 →
|
// 選序(README「全域介面」):--token 旗標 → TEAI_TOKEN 環境變數 →
|
||||||
// tea 登入組態(TEA_CONFIG 指定的路徑,或 ~/.config/tea/config.yml)。
|
// teai 登入組態(TEAI_CONFIG 指定的路徑,或 ~/.config/teai/config.yml)。
|
||||||
// token 一律只在記憶體傳遞,不寫入輸出、日誌或錯誤訊息。
|
// token 一律只在記憶體傳遞,不寫入輸出、日誌或錯誤訊息。
|
||||||
package gitea
|
package gitea
|
||||||
|
|
||||||
@@ -23,8 +23,8 @@ const (
|
|||||||
SourceFlag
|
SourceFlag
|
||||||
// SourceEnv 是 TEAI_TOKEN 環境變數。
|
// SourceEnv 是 TEAI_TOKEN 環境變數。
|
||||||
SourceEnv
|
SourceEnv
|
||||||
// SourceTeaConfig 是 tea 登入組態。
|
// SourceConfig 是 teai 登入組態。
|
||||||
SourceTeaConfig
|
SourceConfig
|
||||||
)
|
)
|
||||||
|
|
||||||
// String 回傳來源名稱(診斷用)。
|
// String 回傳來源名稱(診斷用)。
|
||||||
@@ -34,8 +34,8 @@ func (s TokenSource) String() string {
|
|||||||
return "flag"
|
return "flag"
|
||||||
case SourceEnv:
|
case SourceEnv:
|
||||||
return "env"
|
return "env"
|
||||||
case SourceTeaConfig:
|
case SourceConfig:
|
||||||
return "tea-config"
|
return "config"
|
||||||
default:
|
default:
|
||||||
return "none"
|
return "none"
|
||||||
}
|
}
|
||||||
@@ -62,12 +62,12 @@ func osReadFile(path string) ([]byte, error) {
|
|||||||
type AuthOptions struct {
|
type AuthOptions struct {
|
||||||
// FlagToken 是 --token 旗標值;空字串表示未提供。
|
// FlagToken 是 --token 旗標值;空字串表示未提供。
|
||||||
FlagToken string
|
FlagToken string
|
||||||
// SiteURL 是目標站點(用來比對 tea 組態中的 login url)。
|
// SiteURL 是目標站點(用來比對組態中的 login url)。
|
||||||
SiteURL string
|
SiteURL string
|
||||||
// Env 是環境變數查詢;nil 時用 os.LookupEnv。
|
// Env 是環境變數查詢;nil 時用 os.LookupEnv。
|
||||||
Env EnvLookup
|
Env EnvLookup
|
||||||
// ConfigPath 是 tea 組態的明確路徑(TEA_CONFIG 或 --config)。
|
// ConfigPath 是 teai 組態的明確路徑(TEAI_CONFIG 或 --config)。
|
||||||
// 空字串表示用預設 ~/.config/tea/config.yml。
|
// 空字串表示用預設 ~/.config/teai/config.yml。
|
||||||
ConfigPath string
|
ConfigPath string
|
||||||
// Home 是使用者家目錄(展開 ~ 用);空字串表示不展開。
|
// Home 是使用者家目錄(展開 ~ 用);空字串表示不展開。
|
||||||
Home string
|
Home string
|
||||||
@@ -75,7 +75,7 @@ type AuthOptions struct {
|
|||||||
ReadFile ReadFileFunc
|
ReadFile ReadFileFunc
|
||||||
}
|
}
|
||||||
|
|
||||||
// ResolveToken 依選序解析 token:flag → env(TEAI_TOKEN) → tea 組態。
|
// ResolveToken 依選序解析 token:flag → env(TEAI_TOKEN) → teai 組態。
|
||||||
//
|
//
|
||||||
// 找不到任何 token 時回傳 ("", SourceNone, nil)——查詢公開端點不需要
|
// 找不到任何 token 時回傳 ("", SourceNone, nil)——查詢公開端點不需要
|
||||||
// token,是否為錯由呼叫端依情境決定。組態檔存在但解析失敗(格式錯誤)
|
// token,是否為錯由呼叫端依情境決定。組態檔存在但解析失敗(格式錯誤)
|
||||||
@@ -93,8 +93,8 @@ func ResolveToken(opts AuthOptions) (string, TokenSource, error) {
|
|||||||
}
|
}
|
||||||
path := opts.ConfigPath
|
path := opts.ConfigPath
|
||||||
if path == "" {
|
if path == "" {
|
||||||
// --config 未給時,先看 TEA_CONFIG 環境變數。
|
// --config 未給時,先看 TEAI_CONFIG 環境變數。
|
||||||
if p, ok := env("TEA_CONFIG"); ok && strings.TrimSpace(p) != "" {
|
if p, ok := env("TEAI_CONFIG"); ok && strings.TrimSpace(p) != "" {
|
||||||
path = strings.TrimSpace(p)
|
path = strings.TrimSpace(p)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -110,7 +110,7 @@ func ResolveToken(opts AuthOptions) (string, TokenSource, error) {
|
|||||||
if home == "" {
|
if home == "" {
|
||||||
return "", SourceNone, nil
|
return "", SourceNone, nil
|
||||||
}
|
}
|
||||||
path = filepath.Join(home, ".config", "tea", "config.yml")
|
path = filepath.Join(home, ".config", "teai", "config.yml")
|
||||||
}
|
}
|
||||||
if path == "" {
|
if path == "" {
|
||||||
return "", SourceNone, nil
|
return "", SourceNone, nil
|
||||||
@@ -124,33 +124,32 @@ func ResolveToken(opts AuthOptions) (string, TokenSource, error) {
|
|||||||
// 組態不存在或讀不到:視為沒有這個來源,不是錯誤。
|
// 組態不存在或讀不到:視為沒有這個來源,不是錯誤。
|
||||||
return "", SourceNone, nil
|
return "", SourceNone, nil
|
||||||
}
|
}
|
||||||
login, err := parseTeaConfig(data, opts.SiteURL)
|
login, err := parseConfig(data, opts.SiteURL)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return "", SourceNone, fmt.Errorf("gitea: parse tea config %s: %w", path, err)
|
return "", SourceNone, fmt.Errorf("gitea: parse config %s: %w", path, err)
|
||||||
}
|
}
|
||||||
if login.Token == "" {
|
if login.Token == "" {
|
||||||
return "", SourceNone, nil
|
return "", SourceNone, nil
|
||||||
}
|
}
|
||||||
return login.Token, SourceTeaConfig, nil
|
return login.Token, SourceConfig, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
// teaLogin 是 tea 組態中一筆登入資料(只取 teai 需要的欄位)。
|
// configLogin 是組態中一筆登入資料(只取解析 token 需要的欄位)。
|
||||||
type teaLogin struct {
|
type configLogin struct {
|
||||||
Name string
|
Name string
|
||||||
URL string
|
URL string
|
||||||
Token string
|
Token string
|
||||||
Default bool
|
Default bool
|
||||||
}
|
}
|
||||||
|
|
||||||
// parseTeaConfig 從 tea 的 config.yml 內容挑出最匹配 siteURL 的登入:
|
// parseConfig 從 teai 的 config.yml 內容挑出最匹配 siteURL 的登入:
|
||||||
// url 主機相同者優先,其中 default: true 最優,否則取第一筆;
|
// url 主機相同者優先,其中 default: true 最優,否則取第一筆;
|
||||||
// 都不相同時退而取 default: true,再退第一筆。
|
// 都不相同時退而取 default: true,再退第一筆。
|
||||||
//
|
//
|
||||||
// 僅解析 tea 實際寫出的 YAML 子集:頂層 `logins:` 清單,項目為
|
// 僅解析 teai 寫出的 YAML 子集:頂層 `logins:` 清單,項目為
|
||||||
// `key: value` 的平面映射。不處理錨點、多文件、巢狀清單——tea 不會寫出
|
// `key: value` 的平面映射。不處理錨點、多文件、巢狀清單。
|
||||||
// 這些,遇到也不該默默誤讀。
|
func parseConfig(data []byte, siteURL string) (configLogin, error) {
|
||||||
func parseTeaConfig(data []byte, siteURL string) (teaLogin, error) {
|
var logins []configLogin
|
||||||
var logins []teaLogin
|
|
||||||
inLogins := false
|
inLogins := false
|
||||||
cur := -1 // 目前項目在 logins 的索引;-1 表示尚未開始任何項目
|
cur := -1 // 目前項目在 logins 的索引;-1 表示尚未開始任何項目
|
||||||
for lineNo, raw := range strings.Split(string(data), "\n") {
|
for lineNo, raw := range strings.Split(string(data), "\n") {
|
||||||
@@ -171,26 +170,26 @@ func parseTeaConfig(data []byte, siteURL string) (teaLogin, error) {
|
|||||||
}
|
}
|
||||||
if strings.HasPrefix(trimmed, "- ") || trimmed == "-" {
|
if strings.HasPrefix(trimmed, "- ") || trimmed == "-" {
|
||||||
// 新的清單項目;`- name: x` 形式同行帶鍵值。
|
// 新的清單項目;`- name: x` 形式同行帶鍵值。
|
||||||
logins = append(logins, teaLogin{})
|
logins = append(logins, configLogin{})
|
||||||
cur = len(logins) - 1
|
cur = len(logins) - 1
|
||||||
rest := strings.TrimSpace(strings.TrimPrefix(trimmed, "-"))
|
rest := strings.TrimSpace(strings.TrimPrefix(trimmed, "-"))
|
||||||
if rest != "" {
|
if rest != "" {
|
||||||
if err := applyLoginField(&logins[cur], rest, lineNo+1); err != nil {
|
if err := applyLoginField(&logins[cur], rest, lineNo+1); err != nil {
|
||||||
return teaLogin{}, err
|
return configLogin{}, err
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
if cur < 0 {
|
if cur < 0 {
|
||||||
// logins: 底下卻不是清單項目——不是預期的結構。
|
// logins: 底下卻不是清單項目——不是預期的結構。
|
||||||
return teaLogin{}, fmt.Errorf("line %d: expected list item under logins:", lineNo+1)
|
return configLogin{}, fmt.Errorf("line %d: expected list item under logins:", lineNo+1)
|
||||||
}
|
}
|
||||||
if err := applyLoginField(&logins[cur], trimmed, lineNo+1); err != nil {
|
if err := applyLoginField(&logins[cur], trimmed, lineNo+1); err != nil {
|
||||||
return teaLogin{}, err
|
return configLogin{}, err
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if len(logins) == 0 {
|
if len(logins) == 0 {
|
||||||
return teaLogin{}, nil
|
return configLogin{}, nil
|
||||||
}
|
}
|
||||||
wantHost := hostOf(siteURL)
|
wantHost := hostOf(siteURL)
|
||||||
// 第一輪:主機相符者,default 優先,否則第一筆。
|
// 第一輪:主機相符者,default 優先,否則第一筆。
|
||||||
@@ -219,7 +218,7 @@ func parseTeaConfig(data []byte, siteURL string) (teaLogin, error) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// applyLoginField 把 `key: value` 套用到 login;value 的引號會剝除。
|
// applyLoginField 把 `key: value` 套用到 login;value 的引號會剝除。
|
||||||
func applyLoginField(l *teaLogin, kv string, lineNo int) error {
|
func applyLoginField(l *configLogin, kv string, lineNo int) error {
|
||||||
key, value, ok := strings.Cut(kv, ":")
|
key, value, ok := strings.Cut(kv, ":")
|
||||||
if !ok {
|
if !ok {
|
||||||
return fmt.Errorf("line %d: expected key: value, got %q", lineNo, kv)
|
return fmt.Errorf("line %d: expected key: value, got %q", lineNo, kv)
|
||||||
|
|||||||
+41
-23
@@ -1,5 +1,5 @@
|
|||||||
// auth_test.go 驗證認證來源選序(--token → TEAI_TOKEN → tea 組態)
|
// auth_test.go 驗證認證來源選序(--token → TEAI_TOKEN → teai 組態)
|
||||||
// 與 tea 組態解析。
|
// 與組態解析。
|
||||||
package gitea
|
package gitea
|
||||||
|
|
||||||
import (
|
import (
|
||||||
@@ -25,7 +25,7 @@ func fakeReadFile(m map[string]string) ReadFileFunc {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
const sampleTeaConfig = `logins:
|
const sampleConfig = `logins:
|
||||||
- name: other.example.com
|
- name: other.example.com
|
||||||
url: https://other.example.com
|
url: https://other.example.com
|
||||||
token: other-token
|
token: other-token
|
||||||
@@ -43,7 +43,7 @@ func TestResolveTokenOrdering(t *testing.T) {
|
|||||||
SiteURL: "https://gitea.alterminal.com",
|
SiteURL: "https://gitea.alterminal.com",
|
||||||
Env: fakeEnv(nil),
|
Env: fakeEnv(nil),
|
||||||
ReadFile: fakeReadFile(map[string]string{
|
ReadFile: fakeReadFile(map[string]string{
|
||||||
"/cfg/config.yml": sampleTeaConfig,
|
"/cfg/config.yml": sampleConfig,
|
||||||
}),
|
}),
|
||||||
ConfigPath: "/cfg/config.yml",
|
ConfigPath: "/cfg/config.yml",
|
||||||
}
|
}
|
||||||
@@ -67,11 +67,11 @@ func TestResolveTokenOrdering(t *testing.T) {
|
|||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
t.Run("tea config used when flag and env absent", func(t *testing.T) {
|
t.Run("config used when flag and env absent", func(t *testing.T) {
|
||||||
opts := base
|
opts := base
|
||||||
tok, src, err := ResolveToken(opts)
|
tok, src, err := ResolveToken(opts)
|
||||||
if err != nil || tok != "site-token" || src != SourceTeaConfig {
|
if err != nil || tok != "site-token" || src != SourceConfig {
|
||||||
t.Fatalf("want site-token/tea-config, got %q/%v (err %v)", tok, src, err)
|
t.Fatalf("want site-token/config, got %q/%v (err %v)", tok, src, err)
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
@@ -88,8 +88,8 @@ func TestResolveTokenOrdering(t *testing.T) {
|
|||||||
opts := base
|
opts := base
|
||||||
opts.Env = fakeEnv(map[string]string{"TEAI_TOKEN": " "})
|
opts.Env = fakeEnv(map[string]string{"TEAI_TOKEN": " "})
|
||||||
tok, src, err := ResolveToken(opts)
|
tok, src, err := ResolveToken(opts)
|
||||||
if err != nil || tok != "site-token" || src != SourceTeaConfig {
|
if err != nil || tok != "site-token" || src != SourceConfig {
|
||||||
t.Fatalf("want site-token/tea-config, got %q/%v (err %v)", tok, src, err)
|
t.Fatalf("want site-token/config, got %q/%v (err %v)", tok, src, err)
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
@@ -103,36 +103,54 @@ func TestResolveTokenOrdering(t *testing.T) {
|
|||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
t.Run("TEA_CONFIG points config path", func(t *testing.T) {
|
t.Run("TEAI_CONFIG points config path", func(t *testing.T) {
|
||||||
opts := base
|
opts := base
|
||||||
opts.ConfigPath = "" // 不用 --config,改用 TEA_CONFIG
|
opts.ConfigPath = "" // 不用 --config,改用 TEAI_CONFIG
|
||||||
opts.Env = fakeEnv(map[string]string{
|
opts.Env = fakeEnv(map[string]string{
|
||||||
"TEA_CONFIG": "/cfg/config.yml",
|
"TEAI_CONFIG": "/cfg/config.yml",
|
||||||
})
|
})
|
||||||
tok, src, err := ResolveToken(opts)
|
tok, src, err := ResolveToken(opts)
|
||||||
if err != nil || tok != "site-token" || src != SourceTeaConfig {
|
if err != nil || tok != "site-token" || src != SourceConfig {
|
||||||
t.Fatalf("want site-token/tea-config via TEA_CONFIG, got %q/%v (err %v)", tok, src, err)
|
t.Fatalf("want site-token/config via TEAI_CONFIG, got %q/%v (err %v)", tok, src, err)
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
t.Run("explicit --config beats TEA_CONFIG", func(t *testing.T) {
|
t.Run("explicit --config beats TEAI_CONFIG", func(t *testing.T) {
|
||||||
opts := base // ConfigPath = /cfg/config.yml(有 site-token)
|
opts := base // ConfigPath = /cfg/config.yml(有 site-token)
|
||||||
opts.Env = fakeEnv(map[string]string{
|
opts.Env = fakeEnv(map[string]string{
|
||||||
"TEA_CONFIG": "/cfg/other.yml",
|
"TEAI_CONFIG": "/cfg/other.yml",
|
||||||
})
|
})
|
||||||
read := fakeReadFile(map[string]string{
|
read := fakeReadFile(map[string]string{
|
||||||
"/cfg/config.yml": sampleTeaConfig,
|
"/cfg/config.yml": sampleConfig,
|
||||||
"/cfg/other.yml": "logins:\n - name: x\n url: https://gitea.alterminal.com\n token: other\n default: true\n",
|
"/cfg/other.yml": "logins:\n - name: x\n url: https://gitea.alterminal.com\n token: other\n default: true\n",
|
||||||
})
|
})
|
||||||
opts.ReadFile = read
|
opts.ReadFile = read
|
||||||
tok, src, err := ResolveToken(opts)
|
tok, src, err := ResolveToken(opts)
|
||||||
if err != nil || tok != "site-token" || src != SourceTeaConfig {
|
if err != nil || tok != "site-token" || src != SourceConfig {
|
||||||
t.Fatalf("want site-token from explicit config, got %q/%v (err %v)", tok, src, err)
|
t.Fatalf("want site-token from explicit config, got %q/%v (err %v)", tok, src, err)
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
|
t.Run("TEA_CONFIG is ignored", func(t *testing.T) {
|
||||||
|
opts := AuthOptions{
|
||||||
|
SiteURL: "https://gitea.alterminal.com",
|
||||||
|
Env: fakeEnv(map[string]string{
|
||||||
|
"TEA_CONFIG": "/cfg/config.yml",
|
||||||
|
}),
|
||||||
|
ReadFile: fakeReadFile(map[string]string{
|
||||||
|
"/cfg/config.yml": sampleConfig,
|
||||||
|
"/home/.config/teai/config.yml": "logins:\n - name: x\n url: https://gitea.alterminal.com\n token: teai-token\n default: true\n",
|
||||||
|
}),
|
||||||
|
Home: "/home",
|
||||||
|
}
|
||||||
|
tok, src, err := ResolveToken(opts)
|
||||||
|
if err != nil || tok != "teai-token" || src != SourceConfig {
|
||||||
|
t.Fatalf("want teai-token from teai config, got %q/%v (err %v)", tok, src, err)
|
||||||
|
}
|
||||||
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
func TestParseTeaConfigPicksMatchingLogin(t *testing.T) {
|
func TestParseConfigPicksMatchingLogin(t *testing.T) {
|
||||||
t.Run("host match preferred over default", func(t *testing.T) {
|
t.Run("host match preferred over default", func(t *testing.T) {
|
||||||
cfg := `logins:
|
cfg := `logins:
|
||||||
- name: other
|
- name: other
|
||||||
@@ -144,7 +162,7 @@ func TestParseTeaConfigPicksMatchingLogin(t *testing.T) {
|
|||||||
token: right-token
|
token: right-token
|
||||||
default: false
|
default: false
|
||||||
`
|
`
|
||||||
login, err := parseTeaConfig([]byte(cfg), "https://gitea.alterminal.com")
|
login, err := parseConfig([]byte(cfg), "https://gitea.alterminal.com")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
t.Fatalf("parse error: %v", err)
|
t.Fatalf("parse error: %v", err)
|
||||||
}
|
}
|
||||||
@@ -155,7 +173,7 @@ func TestParseTeaConfigPicksMatchingLogin(t *testing.T) {
|
|||||||
|
|
||||||
t.Run("quoted token unquoted", func(t *testing.T) {
|
t.Run("quoted token unquoted", func(t *testing.T) {
|
||||||
cfg := "logins:\n - name: t\n url: https://gitea.alterminal.com\n token: \"quoted-token\"\n default: true\n"
|
cfg := "logins:\n - name: t\n url: https://gitea.alterminal.com\n token: \"quoted-token\"\n default: true\n"
|
||||||
login, err := parseTeaConfig([]byte(cfg), "https://gitea.alterminal.com")
|
login, err := parseConfig([]byte(cfg), "https://gitea.alterminal.com")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
t.Fatalf("parse error: %v", err)
|
t.Fatalf("parse error: %v", err)
|
||||||
}
|
}
|
||||||
@@ -166,14 +184,14 @@ func TestParseTeaConfigPicksMatchingLogin(t *testing.T) {
|
|||||||
|
|
||||||
t.Run("malformed login entry errors", func(t *testing.T) {
|
t.Run("malformed login entry errors", func(t *testing.T) {
|
||||||
cfg := "logins:\n - name: t\n url: https://gitea.alterminal.com\n oops\n"
|
cfg := "logins:\n - name: t\n url: https://gitea.alterminal.com\n oops\n"
|
||||||
if _, err := parseTeaConfig([]byte(cfg), ""); err == nil {
|
if _, err := parseConfig([]byte(cfg), ""); err == nil {
|
||||||
t.Fatal("malformed line should error")
|
t.Fatal("malformed line should error")
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
t.Run("no logins yields empty", func(t *testing.T) {
|
t.Run("no logins yields empty", func(t *testing.T) {
|
||||||
cfg := "preferences:\n editor: false\n"
|
cfg := "preferences:\n editor: false\n"
|
||||||
login, err := parseTeaConfig([]byte(cfg), "")
|
login, err := parseConfig([]byte(cfg), "")
|
||||||
if err != nil || login.Token != "" {
|
if err != nil || login.Token != "" {
|
||||||
t.Fatalf("want empty login, got %+v (err %v)", login, err)
|
t.Fatalf("want empty login, got %+v (err %v)", login, err)
|
||||||
}
|
}
|
||||||
|
|||||||
+11
-20
@@ -1,9 +1,8 @@
|
|||||||
// config.go — tea 相容登入組態的讀取與行級編輯。
|
// config.go — teai 登入組態的讀取與行級編輯。
|
||||||
//
|
//
|
||||||
// teai 與 tea 共用同一份組態檔(README 設計原則 5),因此寫入採「行級編輯」:
|
// 組態由 teai 自行管理(README 設計原則 5),不依賴 tea。寫入採「行級編輯」:
|
||||||
// 只修改目標登入項目的所屬行,其餘內容(未知欄位、註解、preferences 區段、
|
// 只修改目標登入項目的所屬行,其餘內容(未知欄位、註解、空行與縮排)逐字
|
||||||
// 空行與縮排)逐字保留,避免改壞 tea 也在使用的檔案。新增項目依 tea 實際
|
// 保留。新增項目只寫 teai 使用的欄位:name/url/token/default/user。
|
||||||
// 寫出的欄位順序輸出,讓檔案外觀與 tea 一致。
|
|
||||||
//
|
//
|
||||||
// token 值只會進出這個套件的資料結構與組態檔本身,永遠不出現在錯誤訊息。
|
// token 值只會進出這個套件的資料結構與組態檔本身,永遠不出現在錯誤訊息。
|
||||||
package gitea
|
package gitea
|
||||||
@@ -18,7 +17,7 @@ import (
|
|||||||
"strings"
|
"strings"
|
||||||
)
|
)
|
||||||
|
|
||||||
// LoginEntry 是組態檔中的一筆登入資料(編輯用,含 tea 的 user 欄位)。
|
// LoginEntry 是組態檔中的一筆登入資料(編輯用,含 user 欄位)。
|
||||||
type LoginEntry struct {
|
type LoginEntry struct {
|
||||||
Name string
|
Name string
|
||||||
URL string
|
URL string
|
||||||
@@ -43,7 +42,7 @@ type configDoc struct {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// parseConfigDoc 掃描組態內容,定位 logins 清單與各項目的行範圍。
|
// parseConfigDoc 掃描組態內容,定位 logins 清單與各項目的行範圍。
|
||||||
// 只認識 tea 實際寫出的格式:頂層 `logins:` 加縮排的 `- key: value` 項目;
|
// 只認識 teai 寫出的格式:頂層 `logins:` 加縮排的 `- key: value` 項目;
|
||||||
// 其餘行原樣保留在 lines 中。
|
// 其餘行原樣保留在 lines 中。
|
||||||
func parseConfigDoc(data []byte) configDoc {
|
func parseConfigDoc(data []byte) configDoc {
|
||||||
doc := configDoc{lines: splitLines(data), loginsHeader: -1, itemIndent: " "}
|
doc := configDoc{lines: splitLines(data), loginsHeader: -1, itemIndent: " "}
|
||||||
@@ -103,7 +102,7 @@ func (d configDoc) findItem(name string) int {
|
|||||||
return -1
|
return -1
|
||||||
}
|
}
|
||||||
|
|
||||||
// fieldIndent 回傳項目內屬性行的縮排(項目縮排 + 兩格,tea 的格式)。
|
// fieldIndent 回傳項目內屬性行的縮排(項目縮排 + 兩格)。
|
||||||
func (d configDoc) fieldIndent() string {
|
func (d configDoc) fieldIndent() string {
|
||||||
return d.itemIndent + " "
|
return d.itemIndent + " "
|
||||||
}
|
}
|
||||||
@@ -168,7 +167,7 @@ func ListLoginsFile(path string) ([]LoginEntry, error) {
|
|||||||
// UpsertLogin 新增或更新名為 e.Name 的登入。
|
// UpsertLogin 新增或更新名為 e.Name 的登入。
|
||||||
//
|
//
|
||||||
// 已存在則就地更新 url/token/user/default(保留其他欄位與行);不存在則
|
// 已存在則就地更新 url/token/user/default(保留其他欄位與行);不存在則
|
||||||
// 依 tea 的欄位順序插入新項目。makeDefault 為 true 時將其設為預設並取消
|
// 依 teai 的欄位順序插入新項目。makeDefault 為 true 時將其設為預設並取消
|
||||||
// 其他登入的預設旗標;新增後若成為唯一登入也自動成為預設。
|
// 其他登入的預設旗標;新增後若成為唯一登入也自動成為預設。
|
||||||
// 回傳新內容與最終生效的項目值。
|
// 回傳新內容與最終生效的項目值。
|
||||||
func UpsertLogin(data []byte, e LoginEntry, makeDefault bool) ([]byte, LoginEntry, error) {
|
func UpsertLogin(data []byte, e LoginEntry, makeDefault bool) ([]byte, LoginEntry, error) {
|
||||||
@@ -326,7 +325,7 @@ func setFieldInItem(lines []string, it loginItemSpan, key, value, fieldIndent st
|
|||||||
return append(out, lines[it.end:]...)
|
return append(out, lines[it.end:]...)
|
||||||
}
|
}
|
||||||
|
|
||||||
// newLoginBlock 產生 tea 格式的新登入項目(欄位順序與 tea 實際寫出的一致)。
|
// newLoginBlock 產生 teai 格式的新登入項目(name/url/token/default/user)。
|
||||||
func newLoginBlock(itemIndent, name, url, token string, isDefault bool, user string) []string {
|
func newLoginBlock(itemIndent, name, url, token string, isDefault bool, user string) []string {
|
||||||
f := itemIndent + " "
|
f := itemIndent + " "
|
||||||
return []string{
|
return []string{
|
||||||
@@ -334,15 +333,7 @@ func newLoginBlock(itemIndent, name, url, token string, isDefault bool, user str
|
|||||||
f + "url: " + yamlScalar(url),
|
f + "url: " + yamlScalar(url),
|
||||||
f + "token: " + yamlScalar(token),
|
f + "token: " + yamlScalar(token),
|
||||||
f + "default: " + strconv.FormatBool(isDefault),
|
f + "default: " + strconv.FormatBool(isDefault),
|
||||||
f + `ssh_host: ""`,
|
|
||||||
f + `ssh_key: ""`,
|
|
||||||
f + "insecure: false",
|
|
||||||
f + `ssh_certificate_principal: ""`,
|
|
||||||
f + "ssh_agent: false",
|
|
||||||
f + `ssh_key_agent_pub: ""`,
|
|
||||||
f + "version_check: false",
|
|
||||||
f + "user: " + yamlScalar(user),
|
f + "user: " + yamlScalar(user),
|
||||||
f + "created: 0",
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -385,9 +376,9 @@ func joinLines(lines []string) []byte {
|
|||||||
return []byte(s)
|
return []byte(s)
|
||||||
}
|
}
|
||||||
|
|
||||||
// SaveTeaConfigFile 把組態內容原子寫入 path:先寫同目錄暫存檔(0600),
|
// SaveConfigFile 把組態內容原子寫入 path:先寫同目錄暫存檔(0600),
|
||||||
// 再 rename 取代,避免半寫入狀態。必要時建立上層目錄(0700)。
|
// 再 rename 取代,避免半寫入狀態。必要時建立上層目錄(0700)。
|
||||||
func SaveTeaConfigFile(path string, data []byte) error {
|
func SaveConfigFile(path string, data []byte) error {
|
||||||
dir := filepath.Dir(path)
|
dir := filepath.Dir(path)
|
||||||
if err := os.MkdirAll(dir, 0o700); err != nil {
|
if err := os.MkdirAll(dir, 0o700); err != nil {
|
||||||
return fmt.Errorf("gitea: create config dir: %w", err)
|
return fmt.Errorf("gitea: create config dir: %w", err)
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
// config_test.go 驗證 tea 相容組態的行級編輯:新增、更新、設預設、
|
// config_test.go 驗證登入組態的行級編輯:新增、更新、設預設、
|
||||||
// 移除,以及「未知欄位與其他區段逐字保留」的關鍵性質。
|
// 移除,以及「未知欄位與其他區段逐字保留」的關鍵性質。
|
||||||
package gitea
|
package gitea
|
||||||
|
|
||||||
@@ -10,8 +10,8 @@ import (
|
|||||||
"testing"
|
"testing"
|
||||||
)
|
)
|
||||||
|
|
||||||
// realWorldTeaConfig 是 tea 實際寫出的組態(含 ssh_* 等未知欄位與 preferences)。
|
// extraFieldsConfig 含未知欄位與額外區段,用來驗證行級編輯不會改壞不相干內容。
|
||||||
const realWorldTeaConfig = `logins:
|
const extraFieldsConfig = `logins:
|
||||||
- name: alterminal
|
- name: alterminal
|
||||||
url: https://gitea.alterminal.com
|
url: https://gitea.alterminal.com
|
||||||
token: tok-1
|
token: tok-1
|
||||||
@@ -32,7 +32,7 @@ preferences:
|
|||||||
`
|
`
|
||||||
|
|
||||||
func TestListLoginsParsesAllEntries(t *testing.T) {
|
func TestListLoginsParsesAllEntries(t *testing.T) {
|
||||||
logins := ListLogins([]byte(realWorldTeaConfig))
|
logins := ListLogins([]byte(extraFieldsConfig))
|
||||||
if len(logins) != 1 {
|
if len(logins) != 1 {
|
||||||
t.Fatalf("want 1 login, got %d", len(logins))
|
t.Fatalf("want 1 login, got %d", len(logins))
|
||||||
}
|
}
|
||||||
@@ -43,7 +43,7 @@ func TestListLoginsParsesAllEntries(t *testing.T) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
func TestUpsertLoginUpdatesExistingPreservesRest(t *testing.T) {
|
func TestUpsertLoginUpdatesExistingPreservesRest(t *testing.T) {
|
||||||
out, final, err := UpsertLogin([]byte(realWorldTeaConfig), LoginEntry{
|
out, final, err := UpsertLogin([]byte(extraFieldsConfig), LoginEntry{
|
||||||
Name: "alterminal", URL: "https://gitea.alterminal.com", Token: "tok-2", User: "ceo",
|
Name: "alterminal", URL: "https://gitea.alterminal.com", Token: "tok-2", User: "ceo",
|
||||||
}, false)
|
}, false)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -74,7 +74,7 @@ func TestUpsertLoginUpdatesExistingPreservesRest(t *testing.T) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
func TestUpsertLoginAppendsNewAndMakesDefault(t *testing.T) {
|
func TestUpsertLoginAppendsNewAndMakesDefault(t *testing.T) {
|
||||||
out, final, err := UpsertLogin([]byte(realWorldTeaConfig), LoginEntry{
|
out, final, err := UpsertLogin([]byte(extraFieldsConfig), LoginEntry{
|
||||||
Name: "second", URL: "https://git.example.com", Token: "tok-b", User: "bob",
|
Name: "second", URL: "https://git.example.com", Token: "tok-b", User: "bob",
|
||||||
}, true)
|
}, true)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -93,10 +93,15 @@ func TestUpsertLoginAppendsNewAndMakesDefault(t *testing.T) {
|
|||||||
if !final.Default {
|
if !final.Default {
|
||||||
t.Fatalf("final should be default: %+v", final)
|
t.Fatalf("final should be default: %+v", final)
|
||||||
}
|
}
|
||||||
// tea 的欄位順序仍在。
|
// 新項目依 teai 欄位順序附加。
|
||||||
s := string(out)
|
s := string(out)
|
||||||
if !strings.Contains(s, " - name: second\n") {
|
if !strings.Contains(s, " - name: second\n") {
|
||||||
t.Fatalf("new item not appended in tea style:\n%s", s)
|
t.Fatalf("new item not appended:\n%s", s)
|
||||||
|
}
|
||||||
|
for _, ban := range []string{"ssh_", "insecure:", "version_check:", "created:"} {
|
||||||
|
if strings.Contains(s[strings.Index(s, "- name: second"):], ban) {
|
||||||
|
t.Fatalf("new item leaked tea field %q:\n%s", ban, s)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -117,6 +122,12 @@ func TestUpsertLoginFirstEverLoginCreatesSection(t *testing.T) {
|
|||||||
if !strings.HasPrefix(string(out), "logins:\n") {
|
if !strings.HasPrefix(string(out), "logins:\n") {
|
||||||
t.Fatalf("section not created:\n%s", out)
|
t.Fatalf("section not created:\n%s", out)
|
||||||
}
|
}
|
||||||
|
s := string(out)
|
||||||
|
for _, ban := range []string{"ssh_", "insecure:", "version_check:", "created:", "preferences:"} {
|
||||||
|
if strings.Contains(s, ban) {
|
||||||
|
t.Fatalf("new config leaked tea field %q:\n%s", ban, s)
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
func TestUpsertLoginRejectsBadInput(t *testing.T) {
|
func TestUpsertLoginRejectsBadInput(t *testing.T) {
|
||||||
@@ -158,7 +169,7 @@ func TestSetDefaultLoginSwitchesFlag(t *testing.T) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
func TestSetDefaultLoginUnknownNameErrors(t *testing.T) {
|
func TestSetDefaultLoginUnknownNameErrors(t *testing.T) {
|
||||||
if _, err := SetDefaultLogin([]byte(realWorldTeaConfig), "nope"); err == nil {
|
if _, err := SetDefaultLogin([]byte(extraFieldsConfig), "nope"); err == nil {
|
||||||
t.Fatal("unknown name should error")
|
t.Fatal("unknown name should error")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -195,7 +206,7 @@ preferences:
|
|||||||
}
|
}
|
||||||
|
|
||||||
func TestRemoveLoginLastOne(t *testing.T) {
|
func TestRemoveLoginLastOne(t *testing.T) {
|
||||||
out, promoted, err := RemoveLogin([]byte(realWorldTeaConfig), "alterminal")
|
out, promoted, err := RemoveLogin([]byte(extraFieldsConfig), "alterminal")
|
||||||
if err != nil || promoted != "" {
|
if err != nil || promoted != "" {
|
||||||
t.Fatalf("want clean removal, promoted=%q err=%v", promoted, err)
|
t.Fatalf("want clean removal, promoted=%q err=%v", promoted, err)
|
||||||
}
|
}
|
||||||
@@ -207,10 +218,10 @@ func TestRemoveLoginLastOne(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
func TestSaveTeaConfigFileAtomicAndMode(t *testing.T) {
|
func TestSaveConfigFileAtomicAndMode(t *testing.T) {
|
||||||
dir := t.TempDir()
|
dir := t.TempDir()
|
||||||
path := filepath.Join(dir, "tea", "config.yml")
|
path := filepath.Join(dir, "teai", "config.yml")
|
||||||
if err := SaveTeaConfigFile(path, []byte("logins: []\n")); err != nil {
|
if err := SaveConfigFile(path, []byte("logins: []\n")); err != nil {
|
||||||
t.Fatal(err)
|
t.Fatal(err)
|
||||||
}
|
}
|
||||||
info, err := os.Stat(path)
|
info, err := os.Stat(path)
|
||||||
@@ -221,7 +232,7 @@ func TestSaveTeaConfigFileAtomicAndMode(t *testing.T) {
|
|||||||
t.Fatalf("perm = %v, want 0600", info.Mode().Perm())
|
t.Fatalf("perm = %v, want 0600", info.Mode().Perm())
|
||||||
}
|
}
|
||||||
// 再寫一次(覆蓋既有檔),不留暫存殘檔。
|
// 再寫一次(覆蓋既有檔),不留暫存殘檔。
|
||||||
if err := SaveTeaConfigFile(path, []byte("logins: []\n# v2\n")); err != nil {
|
if err := SaveConfigFile(path, []byte("logins: []\n# v2\n")); err != nil {
|
||||||
t.Fatal(err)
|
t.Fatal(err)
|
||||||
}
|
}
|
||||||
entries, _ := os.ReadDir(filepath.Dir(path))
|
entries, _ := os.ReadDir(filepath.Dir(path))
|
||||||
|
|||||||
+139
-1
@@ -1,6 +1,10 @@
|
|||||||
package workflow
|
package workflow
|
||||||
|
|
||||||
import "sort"
|
import (
|
||||||
|
"regexp"
|
||||||
|
"sort"
|
||||||
|
"strings"
|
||||||
|
)
|
||||||
|
|
||||||
// sortComments 依 created_at 字典序穩定排序(ISO8601 字串字典序與時間序一致),
|
// sortComments 依 created_at 字典序穩定排序(ISO8601 字串字典序與時間序一致),
|
||||||
// 對應 gitea.py 各處的 comments.sort(key=created_at)。
|
// 對應 gitea.py 各處的 comments.sort(key=created_at)。
|
||||||
@@ -135,3 +139,137 @@ func LastCommentNotByAssignee(issue *Issue, comments []Comment) bool {
|
|||||||
func IssueNeedsWork(issue *Issue, comments []Comment, members []string) bool {
|
func IssueNeedsWork(issue *Issue, comments []Comment, members []string) bool {
|
||||||
return AssigneeOverlaps(issue, members) && LastCommentNotByAssignee(issue, comments)
|
return AssigneeOverlaps(issue, members) && LastCommentNotByAssignee(issue, comments)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ── 交付報告判定(agents #47,同步 gitea.py _is_delivery_report)──────────
|
||||||
|
//
|
||||||
|
// 最後一則 assignee 留言已把工作交棒給發起人/他人確認(逐項查核/驗收
|
||||||
|
// 結果+回報他件或請確認關閉)時,停滯點不在 assignee:stalled 分類由
|
||||||
|
// assignee-idle 改判 waiting-outside,管理者巡邏不再對已交付、待確認的
|
||||||
|
// 處理者觸發自動催促。
|
||||||
|
|
||||||
|
var (
|
||||||
|
// deliveryVerdictRe 對應 gitea.py _DELIVERY_VERDICT_RE:彙總 verdict 語。
|
||||||
|
deliveryVerdictRe = regexp.MustCompile(`(全數|全部|\d+\s*項)通過|項全過|不通過|未通過`)
|
||||||
|
// deliveryHandoffRe 對應 gitea.py _DELIVERY_HANDOFF_RE:交棒訊號。
|
||||||
|
deliveryHandoffRe = regexp.MustCompile(`回報\s*#\d+|關閉\s*#\d+|請[^\n。]{0,40}(確認|關閉)|可由[^\n。]{0,40}關閉|待[^\n。]{0,20}確認`)
|
||||||
|
// completionDefinitionRe 對應 _has_completion_definition:內文「完成定義」
|
||||||
|
// 段落(ATX 標題或行首字樣)。
|
||||||
|
completionDefinitionRe = regexp.MustCompile(`(?m)^#{1,6}\s*完成定義|^完成定義\s*[::]?`)
|
||||||
|
// simpleDeliveryRe 內文有「完成定義」時的簡式交付語。
|
||||||
|
simpleDeliveryRe = regexp.MustCompile(`已完成|已交付|已通過|已全數`)
|
||||||
|
)
|
||||||
|
|
||||||
|
// hasCompletionDefinition 內文是否含「完成定義」段落。
|
||||||
|
func hasCompletionDefinition(body string) bool {
|
||||||
|
return completionDefinitionRe.MatchString(body)
|
||||||
|
}
|
||||||
|
|
||||||
|
// IsDeliveryReport 判定最後一則 assignee 留言是否符合交付報告特徵
|
||||||
|
// (agents #47;gitea.py _is_delivery_report 的同語義實作)。
|
||||||
|
//
|
||||||
|
// 交付報告=「結構訊號」∧「交棒訊號」同時命中:
|
||||||
|
// - 結構訊號:逐項查核/驗收/測試結果、結論、或彙總 verdict 語;內文有
|
||||||
|
// 「完成定義」段落時,簡式交付語(已完成/已交付)也算。
|
||||||
|
// - 交棒訊號:回報/關閉他件(#N)、或請/可由/待他人確認關閉。
|
||||||
|
//
|
||||||
|
// 只命中結構訊號不算:認領/進度/預告式留言(「完成後逐項回報結果至此」)
|
||||||
|
// 沒有交棒對象,仍是 assignee 自己該做——保持 assignee-idle,修正不製造
|
||||||
|
// 「認領後棄置永不被催促」的新死角。
|
||||||
|
func IsDeliveryReport(issueBody string, last *Comment) bool {
|
||||||
|
if last == nil {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
body := last.Body
|
||||||
|
if body == "" {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
structural := false
|
||||||
|
for _, marker := range []string{"查核結果", "驗收結果", "測試結果", "逐項", "結論", "完成定義"} {
|
||||||
|
if strings.Contains(body, marker) {
|
||||||
|
structural = true
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if !structural && deliveryVerdictRe.MatchString(body) {
|
||||||
|
structural = true
|
||||||
|
}
|
||||||
|
if !structural && hasCompletionDefinition(issueBody) && simpleDeliveryRe.MatchString(body) {
|
||||||
|
structural = true
|
||||||
|
}
|
||||||
|
if !structural {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
return deliveryHandoffRe.MatchString(body)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── 審核交棒判定(agents #51,同步 gitea.py _is_review_handoff)──────────
|
||||||
|
//
|
||||||
|
// PR 作者的最後一則留言已把審核交棒給審核者(@審核者帳號+就緒語)時,
|
||||||
|
// 停滯點不在作者:stalled 分類由 author-idle 改判 reviewer-idle,既有
|
||||||
|
// 48 小時改派規則自然適用。案例:fox#60 作者留言「PR 已就緒,可審閱」
|
||||||
|
// 並 @chenyunda218,teai stalled 仍判 author-idle——作者已無待辦。
|
||||||
|
|
||||||
|
var (
|
||||||
|
// reviewReadyRe 對應 gitea.py _REVIEW_READY_RE:PR 端就緒語。
|
||||||
|
reviewReadyRe = regexp.MustCompile(`已就緒|可審閱|請審閱`)
|
||||||
|
)
|
||||||
|
|
||||||
|
// IsReviewHandoff 判定 PR 作者的最後一則留言是否已把審核交棒給審核者
|
||||||
|
// (agents #51;gitea.py _is_review_handoff 的同語義實作)。
|
||||||
|
//
|
||||||
|
// 審核交棒=「@審核者帳號」∧「就緒語」同時命中:作者已表明 PR 就緒、
|
||||||
|
// 明確點名目前指定的審核者,球在審核者——author-idle 改判 reviewer-idle。
|
||||||
|
//
|
||||||
|
// 只命中就緒語不算:進度回報(「快好了,即將就緒」)沒有點名對象,作者
|
||||||
|
// 仍可能有待辦——保持 author-idle,修正不製造「丟一句已就緒就永不被催」
|
||||||
|
// 的新死角。@的帳號不在目前審核者清單也不算:交棒對象需為實際審核者。
|
||||||
|
func IsReviewHandoff(last *Comment, reviewers []string) bool {
|
||||||
|
if last == nil {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
body := last.Body
|
||||||
|
if body == "" || len(reviewers) == 0 {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
if !reviewReadyRe.MatchString(body) {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
for _, r := range reviewers {
|
||||||
|
if mentionsUser(body, r) {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
// mentionsUser 判定 body 是否 @ 了指定帳號(agents #51)。
|
||||||
|
// 帳號字元後需為非帳號字元或文末,避免前綴碰撞——如 @chenyunda218
|
||||||
|
// 被誤判為提及帳號 chenyunda(兩者可在同一組織並存)。
|
||||||
|
func mentionsUser(body, name string) bool {
|
||||||
|
if name == "" {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
mention := "@" + name
|
||||||
|
for from := 0; ; {
|
||||||
|
idx := strings.Index(body[from:], mention)
|
||||||
|
if idx < 0 {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
end := from + idx + len(mention)
|
||||||
|
if end >= len(body) || !isUsernameByte(body[end]) {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
from = from + idx + 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// isUsernameByte 判定位元組是否屬於 Gitea 帳號字元(字母數字與 _ . -)。
|
||||||
|
func isUsernameByte(b byte) bool {
|
||||||
|
switch {
|
||||||
|
case b >= 'a' && b <= 'z', b >= 'A' && b <= 'Z', b >= '0' && b <= '9':
|
||||||
|
return true
|
||||||
|
case b == '_' || b == '.' || b == '-':
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|||||||
@@ -143,3 +143,73 @@ func TestFullNameFallbacks(t *testing.T) {
|
|||||||
t.Errorf("全缺 → 空,得到 %q", got)
|
t.Errorf("全缺 → 空,得到 %q", got)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TestIsDeliveryReport(agents #47):交付報告=結構訊號 ∧ 交棒訊號。
|
||||||
|
// 案例與 gitea.py _is_delivery_report 的離線驗證同集(bear#52 實例)。
|
||||||
|
func TestIsDeliveryReport(t *testing.T) {
|
||||||
|
body52 := "## 完成定義\n- 逐項回報查核結果至此 issue;\n- 全數通過 → 回報 #39 並由 #39 assignee 關閉"
|
||||||
|
claim := "認領。我來執行四項驗收查核,完成後逐項回報結果至此。"
|
||||||
|
report := "## 全階段驗收查核結果(#52)\n**結論:四項全數通過。** 逐項如下…\n四項全過,符合「完成定義」。回報 #39:全數驗收通過,可由 @ceo 關閉 #39 與里程碑。"
|
||||||
|
reportFail := "## 查核結果\n結論:第 2 項不通過。已開立修復 issue #60,請 @ceo 確認分配。"
|
||||||
|
cases := []struct {
|
||||||
|
name string
|
||||||
|
issueBody string
|
||||||
|
comment string
|
||||||
|
want bool
|
||||||
|
}{
|
||||||
|
{"交付報告+回報#39+@ceo 關閉", body52, report, true},
|
||||||
|
{"失敗型交付(開修復 issue+請確認)", body52, reportFail, true},
|
||||||
|
{"認領留言(逐項+回報 但無交棒)", body52, claim, false},
|
||||||
|
{"純進度留言", body52, "進行中,已看完 P1,預計今晚交付。", false},
|
||||||
|
{"已完成但無交棒", body52, "已完成,程式碼都在分支上。", false},
|
||||||
|
{"無完成定義內文+逐項交棒", "一般 issue 內文", "逐項測試結果全數通過,請 @ceo 確認後關閉。", true},
|
||||||
|
{"無完成定義+僅交棒(無結構)", "一般 issue 內文", "請 @ceo 確認後關閉。", false},
|
||||||
|
{"空留言", body52, "", false},
|
||||||
|
}
|
||||||
|
for _, tc := range cases {
|
||||||
|
var last *Comment
|
||||||
|
if tc.comment != "" {
|
||||||
|
last = &Comment{Body: tc.comment}
|
||||||
|
}
|
||||||
|
if got := IsDeliveryReport(tc.issueBody, last); got != tc.want {
|
||||||
|
t.Errorf("%s:IsDeliveryReport = %v,want %v", tc.name, got, tc.want)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if IsDeliveryReport(body52, nil) {
|
||||||
|
t.Error("nil 最後留言應為 false")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestIsReviewHandoff(agents #51):審核交棒=@審核者帳號 ∧ 就緒語。
|
||||||
|
// 案例與 gitea.py _is_review_handoff 的離線驗證同集(fox#60 實例)。
|
||||||
|
func TestIsReviewHandoff(t *testing.T) {
|
||||||
|
// fox#60 作者(alex)最後留言結尾(2026-09-16 08:05)。
|
||||||
|
fox60 := "狀態回報(作者端自查,分支無需再變更):\n\n- 已重新核對分支與 main 的差異…\n- PR 分支 CI 已通過(run 209)。\n\n@chenyunda218 PR 已就緒,可審閱。@ceo 已知悉管理者巡邏的備註;審核合併後,我會在下一個 main 部署 run 跑通時回 #58 驗收。"
|
||||||
|
cases := []struct {
|
||||||
|
name string
|
||||||
|
comment string
|
||||||
|
reviewers []string
|
||||||
|
want bool
|
||||||
|
}{
|
||||||
|
{"fox#60 實例(@審核者+已就緒,可審閱)", fox60, []string{"chenyunda218"}, true},
|
||||||
|
{"多位審核者命中其一", fox60, []string{"ceo", "chenyunda218"}, true},
|
||||||
|
{"前綴碰撞(@chenyunda218 ≠ chenyunda)", fox60, []string{"chenyunda"}, false},
|
||||||
|
{"就緒語但無 @(無點名對象)", fox60, []string{"dan"}, false},
|
||||||
|
{"進度回報(無就緒語)", "進行中:已改完兩步,CI 跑著,@chenyunda218 稍後再看。", []string{"chenyunda218"}, false},
|
||||||
|
{"預告式(即將就緒不算)", "@chenyunda218 快好了,即將整理完成。", []string{"chenyunda218"}, false},
|
||||||
|
{"無審核者", fox60, nil, false},
|
||||||
|
{"空留言", "", []string{"chenyunda218"}, false},
|
||||||
|
}
|
||||||
|
for _, tc := range cases {
|
||||||
|
var last *Comment
|
||||||
|
if tc.comment != "" {
|
||||||
|
last = &Comment{Body: tc.comment}
|
||||||
|
}
|
||||||
|
if got := IsReviewHandoff(last, tc.reviewers); got != tc.want {
|
||||||
|
t.Errorf("%s:IsReviewHandoff = %v,want %v", tc.name, got, tc.want)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if IsReviewHandoff(nil, []string{"chenyunda218"}) {
|
||||||
|
t.Error("nil 最後留言應為 false")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -9,8 +9,17 @@ import (
|
|||||||
"sort"
|
"sort"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
const (
|
||||||
// AgentsTeamName 是工作流團隊的名稱(AGENTS.md:調度成員由 Agents 團隊決定)。
|
// AgentsTeamName 是工作流團隊的名稱(AGENTS.md:調度成員由 Agents 團隊決定)。
|
||||||
const AgentsTeamName = "Agents"
|
AgentsTeamName = "Agents"
|
||||||
|
// SupervisorTeamName 是管理者團隊的名稱;成員角色為 supervisor。
|
||||||
|
SupervisorTeamName = "Supervisor"
|
||||||
|
|
||||||
|
// RoleSupervisor 是 Supervisor 團隊成員的角色值。
|
||||||
|
RoleSupervisor = "supervisor"
|
||||||
|
// RoleWorker 是 Agents 團隊成員的角色值。
|
||||||
|
RoleWorker = "worker"
|
||||||
|
)
|
||||||
|
|
||||||
// Client 抽象 teai 需要的 Gitea API 讀取操作(僅唯讀)。
|
// Client 抽象 teai 需要的 Gitea API 讀取操作(僅唯讀)。
|
||||||
// #5 的 internal/gitea HTTP 用戶端實作此介面;workflow 不依賴 HTTP 細節。
|
// #5 的 internal/gitea HTTP 用戶端實作此介面;workflow 不依賴 HTTP 細節。
|
||||||
@@ -49,7 +58,7 @@ type PullItem struct {
|
|||||||
Pull PullRequest
|
Pull PullRequest
|
||||||
}
|
}
|
||||||
|
|
||||||
// Scanner 在 Client 之上組合出各命令的資料(whoami/orgs/members/mine/pulls/next)。
|
// Scanner 在 Client 之上組合出各命令的資料(whoami/role/orgs/members/mine/pulls/next)。
|
||||||
type Scanner struct {
|
type Scanner struct {
|
||||||
Client Client
|
Client Client
|
||||||
}
|
}
|
||||||
@@ -59,6 +68,63 @@ func (s *Scanner) Whoami() (string, error) {
|
|||||||
return s.Client.CurrentUser()
|
return s.Client.CurrentUser()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Role 依目前帳號所屬團隊回傳角色:Supervisor 團隊為 supervisor,
|
||||||
|
// Agents 團隊為 worker。同時屬於兩者時以 supervisor 為準。
|
||||||
|
// 兩者都不屬於時回空字串(CLI 輸出 null)。
|
||||||
|
func (s *Scanner) Role() (string, error) {
|
||||||
|
username, err := s.Whoami()
|
||||||
|
if err != nil {
|
||||||
|
return "", err
|
||||||
|
}
|
||||||
|
orgs, err := s.Orgs()
|
||||||
|
if err != nil {
|
||||||
|
return "", err
|
||||||
|
}
|
||||||
|
inAgents := false
|
||||||
|
for _, org := range orgs {
|
||||||
|
teams, err := s.Client.ListTeams(org)
|
||||||
|
if err != nil {
|
||||||
|
return "", err
|
||||||
|
}
|
||||||
|
for _, team := range teams {
|
||||||
|
switch team.Name {
|
||||||
|
case SupervisorTeamName, AgentsTeamName:
|
||||||
|
default:
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
ok, err := s.usernameInTeam(team.ID, username)
|
||||||
|
if err != nil {
|
||||||
|
return "", err
|
||||||
|
}
|
||||||
|
if !ok {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if team.Name == SupervisorTeamName {
|
||||||
|
return RoleSupervisor, nil
|
||||||
|
}
|
||||||
|
inAgents = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if inAgents {
|
||||||
|
return RoleWorker, nil
|
||||||
|
}
|
||||||
|
return "", nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// usernameInTeam 檢查帳號是否為該團隊成員。
|
||||||
|
func (s *Scanner) usernameInTeam(teamID int64, username string) (bool, error) {
|
||||||
|
members, err := s.Client.ListTeamMembers(teamID)
|
||||||
|
if err != nil {
|
||||||
|
return false, err
|
||||||
|
}
|
||||||
|
for _, m := range members {
|
||||||
|
if m == username {
|
||||||
|
return true, nil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false, nil
|
||||||
|
}
|
||||||
|
|
||||||
// Orgs 回傳目前帳號所屬的組織(去重、排序)。
|
// Orgs 回傳目前帳號所屬的組織(去重、排序)。
|
||||||
func (s *Scanner) Orgs() ([]string, error) {
|
func (s *Scanner) Orgs() ([]string, error) {
|
||||||
names, err := s.Client.ListOrgs()
|
names, err := s.Client.ListOrgs()
|
||||||
@@ -136,7 +202,11 @@ func (s *Scanner) Members(hasWork bool) ([]string, error) {
|
|||||||
return out, nil
|
return out, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
// iterOrgRepos 產出 (org, repoName);空倉庫跳過(沒有內容可掃)。
|
// iterOrgRepos 產出 (org, repoName)。空倉庫(empty)**不**跳過:Gitea 允許
|
||||||
|
// 空倉庫持有 open issue(如「初始化項目」型工作),gitea.py 的
|
||||||
|
// for_all_repositories(list_my_followup_issues/for_all_organizations)
|
||||||
|
// 掃 issue 時不檢查 empty;只有 PR 掃描(iterOpenPulls)、stalled 與
|
||||||
|
// milestone overview 才跳過空倉庫。
|
||||||
func (s *Scanner) iterOrgRepos() ([][2]string, error) {
|
func (s *Scanner) iterOrgRepos() ([][2]string, error) {
|
||||||
orgs, err := s.Orgs()
|
orgs, err := s.Orgs()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -149,7 +219,7 @@ func (s *Scanner) iterOrgRepos() ([][2]string, error) {
|
|||||||
return nil, err
|
return nil, err
|
||||||
}
|
}
|
||||||
for _, repo := range repos {
|
for _, repo := range repos {
|
||||||
if repo.Name == "" || repo.Empty {
|
if repo.Name == "" {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
out = append(out, [2]string{org, repo.Name})
|
out = append(out, [2]string{org, repo.Name})
|
||||||
|
|||||||
@@ -164,6 +164,51 @@ func TestNextLayerFallbackToIssue(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TestNextPicksIssueInEmptyRepo 回歸測試(#43):空倉庫(empty=true)中
|
||||||
|
// 分派給目前帳號的 open issue 應被第三層拾取——gitea.py 的
|
||||||
|
// for_all_repositories 掃 issue 不跳過空倉庫(「初始化項目」型工作)。
|
||||||
|
func TestNextPicksIssueInEmptyRepo(t *testing.T) {
|
||||||
|
s, fc := newTestScanner()
|
||||||
|
fc.repos["alterminal"] = []Repo{
|
||||||
|
{Name: "teai"},
|
||||||
|
{Name: "colony-tick-demo", Empty: true},
|
||||||
|
}
|
||||||
|
fc.issues["alterminal/colony-tick-demo"] = []Issue{
|
||||||
|
{
|
||||||
|
Number: 1, Title: "初始化項目", UpdatedAt: "2026-09-08T00:00:00Z",
|
||||||
|
Assignees: []User{*mkUser("alex")},
|
||||||
|
Repository: &Repository{FullName: "alterminal/colony-tick-demo"},
|
||||||
|
HTMLURL: "https://gitea.alterminal.com/alterminal/colony-tick-demo/issues/1",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
work, err := s.Next()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if work == nil || work.Type != "issue" || work.Number != 1 || work.Repo != "alterminal/colony-tick-demo" {
|
||||||
|
t.Errorf("應拾取空倉庫中的 issue #1,得到 %+v", work)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestMineIncludesEmptyRepoIssues 回歸測試(#43):mine 同樣不因倉庫為空而漏列。
|
||||||
|
func TestMineIncludesEmptyRepoIssues(t *testing.T) {
|
||||||
|
s, fc := newTestScanner()
|
||||||
|
fc.repos["alterminal"] = []Repo{
|
||||||
|
{Name: "teai"},
|
||||||
|
{Name: "colony-tick-demo", Empty: true},
|
||||||
|
}
|
||||||
|
fc.issues["alterminal/colony-tick-demo"] = []Issue{
|
||||||
|
{Number: 1, Title: "初始化項目", UpdatedAt: "2026-09-08T00:00:00Z", Assignees: []User{*mkUser("alex")}},
|
||||||
|
}
|
||||||
|
issues, err := s.Mine()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if len(issues) != 1 || issues[0].Num() != 1 {
|
||||||
|
t.Errorf("mine 應列出空倉庫中的 issue #1,得到 %d 件", len(issues))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
func TestNextNone(t *testing.T) {
|
func TestNextNone(t *testing.T) {
|
||||||
s, _ := newTestScanner()
|
s, _ := newTestScanner()
|
||||||
work, err := s.Next()
|
work, err := s.Next()
|
||||||
@@ -243,6 +288,91 @@ func TestErrorPropagation(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func TestRoleWorker(t *testing.T) {
|
||||||
|
s, _ := newTestScanner()
|
||||||
|
got, err := s.Role()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if got != RoleWorker {
|
||||||
|
t.Errorf("Agents 團隊成員應為 worker,得到 %q", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestRoleSupervisor(t *testing.T) {
|
||||||
|
s, fc := newTestScanner()
|
||||||
|
fc.teams["alterminal"] = []Team{
|
||||||
|
{ID: 1, Name: "Agents"},
|
||||||
|
{ID: 2, Name: "Supervisor"},
|
||||||
|
}
|
||||||
|
fc.teamMembers[2] = []string{"alex"}
|
||||||
|
got, err := s.Role()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if got != RoleSupervisor {
|
||||||
|
t.Errorf("Supervisor 團隊成員應為 supervisor,得到 %q", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestRoleSupervisorTakesPrecedence(t *testing.T) {
|
||||||
|
s, fc := newTestScanner()
|
||||||
|
// alex 同時在 Agents(newTestScanner 預設)與 Supervisor。
|
||||||
|
fc.teams["alterminal"] = []Team{
|
||||||
|
{ID: 1, Name: "Agents"},
|
||||||
|
{ID: 2, Name: "Supervisor"},
|
||||||
|
}
|
||||||
|
fc.teamMembers[2] = []string{"alex", "ceo"}
|
||||||
|
got, err := s.Role()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if got != RoleSupervisor {
|
||||||
|
t.Errorf("同時屬於兩者時應為 supervisor,得到 %q", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestRoleNone(t *testing.T) {
|
||||||
|
s, fc := newTestScanner()
|
||||||
|
fc.currentUser = "outsider"
|
||||||
|
got, err := s.Role()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if got != "" {
|
||||||
|
t.Errorf("不在 Supervisor/Agents 應回空字串,得到 %q", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestRoleWorkerWhenSupervisorExists(t *testing.T) {
|
||||||
|
s, fc := newTestScanner()
|
||||||
|
fc.teams["alterminal"] = []Team{
|
||||||
|
{ID: 1, Name: "Agents"},
|
||||||
|
{ID: 2, Name: "Supervisor"},
|
||||||
|
}
|
||||||
|
fc.teamMembers[2] = []string{"ceo"}
|
||||||
|
got, err := s.Role()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if got != RoleWorker {
|
||||||
|
t.Errorf("只在 Agents、不在 Supervisor 應為 worker,得到 %q", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestRoleErrorPropagation(t *testing.T) {
|
||||||
|
s, fc := newTestScanner()
|
||||||
|
fc.failOn["teams"] = errors.New("boom")
|
||||||
|
if _, err := s.Role(); err == nil {
|
||||||
|
t.Errorf("ListTeams 錯誤應向上傳播")
|
||||||
|
}
|
||||||
|
delete(fc.failOn, "teams")
|
||||||
|
fc.failOn["members"] = errors.New("boom")
|
||||||
|
if _, err := s.Role(); err == nil {
|
||||||
|
t.Errorf("ListTeamMembers 錯誤應向上傳播")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
func TestPullsDefault(t *testing.T) {
|
func TestPullsDefault(t *testing.T) {
|
||||||
s, fc := newTestScanner()
|
s, fc := newTestScanner()
|
||||||
fc.pulls["alterminal/teai"] = []PullRequest{
|
fc.pulls["alterminal/teai"] = []PullRequest{
|
||||||
|
|||||||
@@ -526,11 +526,21 @@ func considerIssue(src Source, org, repo string, issue Issue, comments []Comment
|
|||||||
case len(assignees) == 0:
|
case len(assignees) == 0:
|
||||||
reason = "no-assignee"
|
reason = "no-assignee"
|
||||||
case lastCommentBy != "" && containsString(assignees, lastCommentBy):
|
case lastCommentBy != "" && containsString(assignees, lastCommentBy):
|
||||||
|
if IsDeliveryReport(issue.Body, last) {
|
||||||
|
// 交付報告待確認(agents #47):assignee 已交付並交棒(回報他件/
|
||||||
|
// 請發起人確認關閉),停滯點在等待外部確認,不是 assignee 停滯。
|
||||||
|
reason = "waiting-outside"
|
||||||
|
} else {
|
||||||
reason = "assignee-idle"
|
reason = "assignee-idle"
|
||||||
|
}
|
||||||
case lastCommentBy == "":
|
case lastCommentBy == "":
|
||||||
reason = "no-commenter"
|
reason = "no-commenter"
|
||||||
}
|
}
|
||||||
if len(children) > 0 && anyOpen(children) {
|
if len(children) > 0 {
|
||||||
|
// 父追蹤項一律標 parent-tracking(agents #44,與 gitea.py 同步):
|
||||||
|
// 有 open 子項在推進時,父項留言閒置屬等待子項;子項全關閉時只剩
|
||||||
|
// 父項收尾(回報驗收並關閉),兩者都不是 assignee 停滯。統一標記
|
||||||
|
// 讓「父項收尾」規則能正確匹配,不退回通用原因(如 assignee-idle)。
|
||||||
reason = "parent-tracking"
|
reason = "parent-tracking"
|
||||||
}
|
}
|
||||||
item := Item{
|
item := Item{
|
||||||
@@ -592,7 +602,14 @@ func considerPull(src Source, org, repo string, pr PullRequest, comments []Comme
|
|||||||
case len(reviewers) == 0:
|
case len(reviewers) == 0:
|
||||||
reason = "no-reviewer"
|
reason = "no-reviewer"
|
||||||
case lastCommentBy == author:
|
case lastCommentBy == author:
|
||||||
|
if IsReviewHandoff(last, reviewers) {
|
||||||
|
// 審核交棒(agents #51):作者已表明 PR 就緒並 @目前審核者,
|
||||||
|
// 停滯點在審核者,不是作者停滯——球在審核者,讓既有
|
||||||
|
// reviewer 催促與 48 小時改派規則自然適用。
|
||||||
|
reason = "reviewer-idle"
|
||||||
|
} else {
|
||||||
reason = "author-idle"
|
reason = "author-idle"
|
||||||
|
}
|
||||||
case lastCommentBy != "" && containsString(reviewers, lastCommentBy):
|
case lastCommentBy != "" && containsString(reviewers, lastCommentBy):
|
||||||
reason = "reviewer-idle"
|
reason = "reviewer-idle"
|
||||||
}
|
}
|
||||||
@@ -606,15 +623,6 @@ func considerPull(src Source, org, repo string, pr PullRequest, comments []Comme
|
|||||||
return item, true
|
return item, true
|
||||||
}
|
}
|
||||||
|
|
||||||
func anyOpen(children []Child) bool {
|
|
||||||
for _, c := range children {
|
|
||||||
if c.State == "open" {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// round1 舍入到小數一位(對應 Python round(x, 1))。
|
// round1 舍入到小數一位(對應 Python round(x, 1))。
|
||||||
// 經 strconv 的十進位正確舍入(半偶數),與 Python 的浮點 round 行為一致,
|
// 經 strconv 的十進位正確舍入(半偶數),與 Python 的浮點 round 行為一致,
|
||||||
// 避免 (x*10+0.5) 截斷在 .x5 邊界產生偏差。
|
// 避免 (x*10+0.5) 截斷在 .x5 邊界產生偏差。
|
||||||
|
|||||||
@@ -42,6 +42,9 @@ func (f *fakeSource) OrganizationRepositories(org string) ([]Repo, error) {
|
|||||||
func (f *fakeSource) OpenIssues(owner, repo string) ([]Issue, error) {
|
func (f *fakeSource) OpenIssues(owner, repo string) ([]Issue, error) {
|
||||||
var out []Issue
|
var out []Issue
|
||||||
for _, i := range f.issues[owner+"/"+repo] {
|
for _, i := range f.issues[owner+"/"+repo] {
|
||||||
|
if i.State == "closed" {
|
||||||
|
continue // 對齊真實 API:OpenIssues 只回 open;closed 條目僅供 TryGetIssue 解引用。
|
||||||
|
}
|
||||||
out = append(out, i)
|
out = append(out, i)
|
||||||
}
|
}
|
||||||
// 對齊真實 API:issues 依 id(=number)遞增回傳,消除 map 迭代隨機性。
|
// 對齊真實 API:issues 依 id(=number)遞增回傳,消除 map 迭代隨機性。
|
||||||
@@ -245,6 +248,46 @@ func TestScanStalledNudgeCooldown(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TestScanStalledParentWrapup(teai #47,同步 agents #44):子項全關閉的父追蹤項
|
||||||
|
// 不退回通用原因(assignee-idle),一律標 parent-tracking——「父項收尾」情境。
|
||||||
|
func TestScanStalledParentWrapup(t *testing.T) {
|
||||||
|
now := at(0)
|
||||||
|
// 父項 3 最後留言來自 assignee ceo(舊行為會誤標 assignee-idle);
|
||||||
|
// 唯一子項 7 已關閉,父子最後活動皆 5 小時前。
|
||||||
|
src := &fakeSource{
|
||||||
|
orgs: []string{"alterminal"},
|
||||||
|
repos: map[string][]Repo{"alterminal": repoWith("teai", true)},
|
||||||
|
issues: map[string]map[int64]Issue{
|
||||||
|
"alterminal/teai": {
|
||||||
|
3: {Number: 3, Title: "父", State: "open", Body: "子項:#7", CreatedAt: iso(-700), UpdatedAt: iso(-300), Assignees: []User{{UserName: "ceo"}}, Repository: &Repository{FullName: "alterminal/teai"}},
|
||||||
|
7: {Number: 7, Title: "子", State: "closed", CreatedAt: iso(-650), UpdatedAt: iso(-300), Repository: &Repository{FullName: "alterminal/teai"}},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
comments: map[string][]Comment{
|
||||||
|
"alterminal/teai/3": {{User: &User{UserName: "ceo"}, CreatedAt: iso(-300)}},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
got, err := ScanStalled(src, "admin", 4.0, now)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("ScanStalled: %v", err)
|
||||||
|
}
|
||||||
|
var parent *Item
|
||||||
|
for i := range got {
|
||||||
|
if got[i].Number == 3 {
|
||||||
|
parent = &got[i]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if parent == nil {
|
||||||
|
t.Fatalf("父項 3 應列入(5h 無活動),got %v", got)
|
||||||
|
}
|
||||||
|
if parent.Reason != "parent-tracking" {
|
||||||
|
t.Errorf("子項全關閉的父項 reason = %q, want parent-tracking", parent.Reason)
|
||||||
|
}
|
||||||
|
if len(parent.ChildActivity) == 0 {
|
||||||
|
t.Errorf("父項 3 應附 child_activity,got %v", parent.ChildActivity)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
// TestScanStalledParentTracking 父追蹤項:子項活動計入 last_activity、reason 標記。
|
// TestScanStalledParentTracking 父追蹤項:子項活動計入 last_activity、reason 標記。
|
||||||
func TestScanStalledParentTracking(t *testing.T) {
|
func TestScanStalledParentTracking(t *testing.T) {
|
||||||
now := at(0)
|
now := at(0)
|
||||||
@@ -371,12 +414,16 @@ func TestScanStalledPullReasons(t *testing.T) {
|
|||||||
{Number: 11, User: &User{UserName: "max"}, CreatedAt: iso(-600), UpdatedAt: iso(-300), RequestedReviewers: []User{{UserName: "ceo"}}},
|
{Number: 11, User: &User{UserName: "max"}, CreatedAt: iso(-600), UpdatedAt: iso(-300), RequestedReviewers: []User{{UserName: "ceo"}}},
|
||||||
{Number: 12, User: &User{UserName: "max"}, CreatedAt: iso(-600), UpdatedAt: iso(-300), RequestedReviewers: []User{{UserName: "ceo"}}},
|
{Number: 12, User: &User{UserName: "max"}, CreatedAt: iso(-600), UpdatedAt: iso(-300), RequestedReviewers: []User{{UserName: "ceo"}}},
|
||||||
{Number: 13, User: &User{UserName: "max"}, CreatedAt: iso(-600), UpdatedAt: iso(-300), RequestedReviewers: []User{{UserName: "ceo"}}},
|
{Number: 13, User: &User{UserName: "max"}, CreatedAt: iso(-600), UpdatedAt: iso(-300), RequestedReviewers: []User{{UserName: "ceo"}}},
|
||||||
|
// agents #51:作者最後留言含審核交棒(@審核者+就緒語)→ reviewer-idle。
|
||||||
|
{Number: 14, User: &User{UserName: "max"}, CreatedAt: iso(-600), UpdatedAt: iso(-300), RequestedReviewers: []User{{UserName: "chenyunda218"}}},
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
comments: map[string][]Comment{
|
comments: map[string][]Comment{
|
||||||
"alterminal/teai/11": {{User: &User{UserName: "max"}, CreatedAt: iso(-300)}}, // author-idle
|
"alterminal/teai/11": {{User: &User{UserName: "max"}, CreatedAt: iso(-300)}}, // author-idle
|
||||||
"alterminal/teai/12": {{User: &User{UserName: "ceo"}, CreatedAt: iso(-300)}}, // reviewer-idle
|
"alterminal/teai/12": {{User: &User{UserName: "ceo"}, CreatedAt: iso(-300)}}, // reviewer-idle
|
||||||
"alterminal/teai/13": {{User: &User{UserName: "dan"}, CreatedAt: iso(-300)}}, // no-commenter(外部留言)
|
"alterminal/teai/13": {{User: &User{UserName: "dan"}, CreatedAt: iso(-300)}}, // no-commenter(外部留言)
|
||||||
|
// fox#60 形態(agents #51):作者留言 @chenyunda218+「已就緒,可審閱」→ 審核交棒。
|
||||||
|
"alterminal/teai/14": {{User: &User{UserName: "max"}, CreatedAt: iso(-300), Body: "狀態回報:分支無需再變更,CI 已通過。@chenyunda218 PR 已就緒,可審閱。"}},
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
got, err := ScanStalled(src, "admin", 4.0, now)
|
got, err := ScanStalled(src, "admin", 4.0, now)
|
||||||
@@ -387,7 +434,7 @@ func TestScanStalledPullReasons(t *testing.T) {
|
|||||||
for _, it := range got {
|
for _, it := range got {
|
||||||
byNumber[it.Number] = it
|
byNumber[it.Number] = it
|
||||||
}
|
}
|
||||||
for n, wantReason := range map[int64]string{10: "no-reviewer", 11: "author-idle", 12: "reviewer-idle", 13: "no-commenter"} {
|
for n, wantReason := range map[int64]string{10: "no-reviewer", 11: "author-idle", 12: "reviewer-idle", 13: "no-commenter", 14: "reviewer-idle"} {
|
||||||
item, ok := byNumber[n]
|
item, ok := byNumber[n]
|
||||||
if !ok {
|
if !ok {
|
||||||
t.Fatalf("PR %d 應列入,got %v", n, got)
|
t.Fatalf("PR %d 應列入,got %v", n, got)
|
||||||
@@ -396,12 +443,15 @@ func TestScanStalledPullReasons(t *testing.T) {
|
|||||||
t.Errorf("PR %d reason = %q, want %q", n, item.Reason, wantReason)
|
t.Errorf("PR %d reason = %q, want %q", n, item.Reason, wantReason)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if len(got) != 4 {
|
if len(got) != 5 {
|
||||||
t.Fatalf("應 4 筆,got %d", len(got))
|
t.Fatalf("應 5 筆,got %d", len(got))
|
||||||
}
|
}
|
||||||
if byNumber[10].Author != "max" {
|
if byNumber[10].Author != "max" {
|
||||||
t.Errorf("PR 10 author 應為 max,got %q", byNumber[10].Author)
|
t.Errorf("PR 10 author 應為 max,got %q", byNumber[10].Author)
|
||||||
}
|
}
|
||||||
|
if byNumber[14].LastCommentBy != "max" {
|
||||||
|
t.Errorf("PR 14 last_comment_by 應為 max(作者留言後交棒),got %q", byNumber[14].LastCommentBy)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// TestScanStalledNoPullsFlag 停用 PR 的倉庫仍掃 issues,只跳過 PR。
|
// TestScanStalledNoPullsFlag 停用 PR 的倉庫仍掃 issues,只跳過 PR。
|
||||||
@@ -552,3 +602,39 @@ func TestRound1(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TestScanStalledDeliveryReport(agents #47):assignee 最後留言為交付報告
|
||||||
|
// (結構訊號+交棒訊號)→ waiting-outside,不是 assignee-idle;
|
||||||
|
// 同型認領留言(無交棒)維持 assignee-idle——修正不製造新死角。
|
||||||
|
func TestScanStalledDeliveryReport(t *testing.T) {
|
||||||
|
now := at(0)
|
||||||
|
defBody := "## 完成定義\n- 逐項回報查核結果至此 issue;\n- 全數通過 → 回報 #39 並由 #39 assignee 關閉"
|
||||||
|
src := &fakeSource{
|
||||||
|
orgs: []string{"alterminal"},
|
||||||
|
repos: map[string][]Repo{"alterminal": repoWith("bear", true)},
|
||||||
|
issues: map[string]map[int64]Issue{
|
||||||
|
"alterminal/bear": {
|
||||||
|
5: {Number: 5, Title: "驗收", State: "open", Body: defBody, CreatedAt: iso(-600), UpdatedAt: iso(-300), Assignees: []User{{UserName: "queena"}}, Repository: &Repository{FullName: "alterminal/bear"}},
|
||||||
|
6: {Number: 6, Title: "認領中", State: "open", Body: defBody, CreatedAt: iso(-600), UpdatedAt: iso(-300), Assignees: []User{{UserName: "dan"}}, Repository: &Repository{FullName: "alterminal/bear"}},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
comments: map[string][]Comment{
|
||||||
|
"alterminal/bear/5": {{User: &User{UserName: "queena"}, CreatedAt: iso(-300), Body: "## 查核結果\n結論:四項全數通過。回報 #39:可由 @ceo 關閉。"}},
|
||||||
|
"alterminal/bear/6": {{User: &User{UserName: "dan"}, CreatedAt: iso(-300), Body: "認領。完成後逐項回報結果至此。"}},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
got, err := ScanStalled(src, "admin", 4.0, now)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("ScanStalled: %v", err)
|
||||||
|
}
|
||||||
|
byNumber := map[int64]Item{}
|
||||||
|
for _, it := range got {
|
||||||
|
byNumber[it.Number] = it
|
||||||
|
}
|
||||||
|
if it, ok := byNumber[5]; !ok || it.Reason != "waiting-outside" {
|
||||||
|
t.Errorf("issue 5(交付報告)reason 應為 waiting-outside,got %+v", it)
|
||||||
|
}
|
||||||
|
if it, ok := byNumber[6]; !ok || it.Reason != "assignee-idle" {
|
||||||
|
t.Errorf("issue 6(認領留言)reason 應為 assignee-idle,got %+v", it)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user