Merge pull request '日常操作命令：issues/pulls/labels/milestones/releases/repos/api（#8）' (#16) from feature/issue8-dailyops into main

2026-09-10 09:54:23 +08:00
parent a2be70ea7d c311f02e0f
commit c5d5c37eae
14 changed files with 3320 additions and 32 deletions
@@ -150,6 +150,78 @@ var globalFlags = map[string]bool{
 	"--timeout": true,
 }

+// extractGlobals 從 args 中「抽取」全域選項（可出現在命令之後、與命令
+// 旗標交錯），其餘引數依原順序保留給子命令剖析。未知的選項一律留給
+// 子命令處理（可能是命令旗標，如 --has-work），不在這裡報錯。
+func extractGlobals(g *Globals, args []string) ([]string, error) {
+	rest := make([]string, 0, len(args))
+	applyGlobal := func(name, value string) error {
+		switch name {
+		case "--url":
+			if strings.TrimSpace(value) == "" {
+				return &ErrUsage{Msg: "--url must not be empty"}
+			}
+			g.URL = value
+		case "--token":
+			g.Token = value
+		case "--config":
+			if strings.TrimSpace(value) == "" {
+				return &ErrUsage{Msg: "--config must not be empty"}
+			}
+			g.ConfigPath = value
+		case "--output":
+			f, err := gitea.ParseFormat(value)
+			if err != nil {
+				return &ErrUsage{Msg: err.Error()}
+			}
+			g.Output = f
+		case "--timeout":
+			d, err := time.ParseDuration(value)
+			if err != nil || d <= 0 {
+				return &ErrUsage{Msg: fmt.Sprintf("invalid --timeout %q (want e.g. 30s)", value)}
+			}
+			g.Timeout = d
+		}
+		return nil
+	}
+	i := 0
+	for i < len(args) {
+		arg := args[i]
+		if arg == "--" {
+			rest = append(rest, args[i+1:]...)
+			return rest, nil
+		}
+		if !strings.HasPrefix(arg, "--") {
+			rest = append(rest, arg)
+			i++
+			continue
+		}
+		name, inline, hasInline := strings.Cut(arg, "=")
+		_, ok := globalFlags[name]
+		if !ok {
+			// 不是全域選項：留給子命令（可能是 --has-work 這類命令旗標）。
+			rest = append(rest, arg)
+			i++
+			continue
+		}
+		var value string
+		if hasInline {
+			value = inline
+		} else {
+			if i+1 >= len(args) {
+				return nil, &ErrUsage{Msg: fmt.Sprintf("global option %q requires a value", name)}
+			}
+			i++
+			value = args[i]
+		}
+		if err := applyGlobal(name, value); err != nil {
+			return nil, err
+		}
+		i++
+	}
+	return rest, nil
+}
+
 // parseGlobals 從 args 前端取走全域選項，回傳剩餘引數（命令與其參數）。
 // 遇到第一個非選項引數即停；不認得的選項或缺少值都回 ErrUsage。
 func parseGlobals(g *Globals, args []string) ([]string, error) {
@@ -218,20 +290,43 @@ func parseGlobals(g *Globals, args []string) ([]string, error) {
 }

 // dispatch 執行已註冊的子命令，把錯誤轉成結束碼並輸出。
+// 旗標剖析交由各命令自行處理（不同命令有不同旗標，如 pulls --mine）；
+// 全域選項允許出現在命令之後（README 範例：teai next --output table），
+// dispatch 先從 args 剝離全域選項併入 Globals，其餘（含命令自己的旗標，
+// 如 --has-work）原樣交給命令，不會誤判為未知全域選項。
 func dispatch(env *Env, name string, args []string) int {
 	cmd := commands[name]
-	fs := flag.NewFlagSet("teai "+name, flag.ContinueOnError)
-	fs.SetOutput(env.Err)
-	if err := fs.Parse(args); err != nil {
+	g := env.Globals
+	rest, err := extractGlobals(&g, args)
+	if err != nil {
+		fmt.Fprintf(env.Err, "teai: %v\n\n", err)
+		printUsage(env.Err)
 		return int(ExitUsage)
 	}
-	if err := cmd.run(env, fs.Args()); err != nil {
+	env.Globals = g
+	if err := cmd.run(env, rest); err != nil {
 		fmt.Fprintf(env.Err, "teai %s: %v\n", name, err)
 		return int(exitCodeFor(err))
 	}
 	return int(ExitOK)
 }

+// errHelp 表示使用者要求該命令的說明（-h/--help）；FlagSet 已自行印出
+// 用法，靜默成功結束即可。
+var errHelp = errors.New("help requested")
+
+// parseFlags 剖析命令旗標：-h/--help 回 errHelp（由 exitCodeFor 視為成功），
+// 其他剖析錯誤回 ErrUsage。
+func parseFlags(fs *flag.FlagSet, args []string) error {
+	if err := fs.Parse(args); err != nil {
+		if errors.Is(err, flag.ErrHelp) {
+			return errHelp
+		}
+		return &ErrUsage{Msg: err.Error()}
+	}
+	return nil
+}
+
 // exitCodeFor 把命令錯誤映射到結束碼：用法錯誤 → 2，API 錯誤 → 3，
 // 其他（內部）→ 1。
 func exitCodeFor(err error) ExitCode {
@@ -0,0 +1,866 @@
+// dailyops_commands.go — 日常操作命令的 CLI 接線（#8）：issues、pulls、
+// labels、milestones、releases、repos、api（tea 對等指令）。
+//
+// 規則：
+//   - 寫入類命令（create／close／comment／merge…）一律要求 --yes，
+//     未帶 --yes 時不產生任何遠端變更（exit 2，用法錯誤）。
+//   - `teai pulls` 相容 #6 的工作流用法（無子命令＝工作流清單 --mine/--reviewer）；
+//     有子命令（list/create/view/merge/comment）時走日常操作。
+//   - 輸出走 internal/gitea 的 Printer（--output json|table）。
+package cli
+
+import (
+	"context"
+	"encoding/json"
+	"flag"
+	"fmt"
+	"strconv"
+	"strings"
+
+	"gitea.alterminal.com/alterminal/teai/internal/dailyops"
+	"gitea.alterminal.com/alterminal/teai/internal/gitea"
+)
+
+func init() {
+	register := func(c *command) { commands[c.name] = c }
+	register(&command{name: "issues", usage: "issues 管理（list/view/create/close/comment）", run: runIssues})
+	register(&command{name: "pulls", usage: "PR 管理（list/view/create/merge/comment；無子命令＝工作流清單）", run: runPullsDaily})
+	register(&command{name: "labels", usage: "標籤管理（list/create）", run: runLabels})
+	register(&command{name: "milestones", usage: "里程碑管理（list/create）", run: runMilestones})
+	register(&command{name: "releases", usage: "發佈清單（list）", run: runReleases})
+	register(&command{name: "repos", usage: "倉庫查詢（list）", run: runRepos})
+	register(&command{name: "api", usage: "任意 API 呼叫（--method/--data；寫入動詞需 --yes）", run: runAPIDirect})
+}
+
+// requireYes 檢查寫入閘門：未帶 --yes 回 ErrUsage（exit 2），不觸發任何請求。
+func requireYes(yes bool, what string) error {
+	if !yes {
+		return &ErrUsage{Msg: what + " 是寫入操作，需 --yes 明確確認（未確認，未產生任何遠端變更）"}
+	}
+	return nil
+}
+
+// splitRepoFlag 把 --repo owner/repo 拆成兩段；空值回 ("", "", nil)。
+func splitRepoFlag(v string) (string, string, error) {
+	if v == "" {
+		return "", "", nil
+	}
+	parts := strings.SplitN(v, "/", 2)
+	if len(parts) != 2 || parts[0] == "" || parts[1] == "" {
+		return "", "", &ErrUsage{Msg: errNoRepoFlag.Error()}
+	}
+	return parts[0], parts[1], nil
+}
+
+// newOpsClient 依全域選項建立 dailyops 用戶端。
+func newOpsClient(env *Env) (*dailyops.Ops, error) {
+	token, _, err := gitea.ResolveToken(gitea.AuthOptions{
+		FlagToken:  env.Globals.Token,
+		SiteURL:    env.Globals.URL,
+		ConfigPath: env.Globals.ConfigPath,
+	})
+	if err != nil {
+		return nil, err
+	}
+	client, err := gitea.New(env.Globals.URL, token, env.Globals.Timeout)
+	if err != nil {
+		return nil, err
+	}
+	return &dailyops.Ops{Client: client}, nil
+}
+
+// parseNumber 把位置參數解析為 issue／PR 編號。
+func parseNumber(s string) (int64, error) {
+	n, err := strconv.ParseInt(s, 10, 64)
+	if err != nil || n <= 0 {
+		return 0, &ErrUsage{Msg: fmt.Sprintf("無效的編號 %q", s)}
+	}
+	return n, nil
+}
+
+// joinOrEmpty 把清單型欄位格式化為逗號分隔（table 用）。
+func joinOrEmpty(v any) string {
+	switch x := v.(type) {
+	case string:
+		return x
+	case []string:
+		return strings.Join(x, ",")
+	default:
+		return fmt.Sprint(x)
+	}
+}
+
+// issueRowsFields 是 issues 清單的欄位定義（與值順序對應）。
+func issueListFields() []gitea.Field {
+	return []gitea.Field{
+		{Name: "number"}, {Name: "title"}, {Name: "state"},
+		{Name: "author"}, {Name: "assignees", ValueFmt: joinOrEmpty}, {Name: "updated_at"},
+	}
+}
+
+// ---- issues ----
+
+// runIssues：teai issues [list|view|create|close|comment] …
+func runIssues(env *Env, args []string) error {
+	if len(args) == 0 {
+		return &ErrUsage{Msg: "issues 需要子命令：list | view | create | close | comment"}
+	}
+	sub, rest := args[0], args[1:]
+	switch sub {
+	case "list":
+		return runIssuesList(env, rest)
+	case "view":
+		return runIssuesView(env, rest)
+	case "create":
+		return runIssuesCreate(env, rest)
+	case "close":
+		return runIssuesClose(env, rest)
+	case "comment":
+		return runComment(env, rest, false)
+	default:
+		return &ErrUsage{Msg: fmt.Sprintf("issues 未知子命令 %q（可用：list | view | create | close | comment）", sub)}
+	}
+}
+
+// runIssuesList：teai issues list --repo owner/repo [--state open|closed|all]
+func runIssuesList(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai issues list", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	state := fs.String("state", "open", "狀態：open|closed|all")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	if fs.NArg() != 0 {
+		return &ErrUsage{Msg: "issues list 不接受位置參數"}
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "issues list 需要 --repo owner/repo"}
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	issues, err := ops.ListIssues(context.Background(), owner, name, *state)
+	if err != nil {
+		return err
+	}
+	p := printer(env)
+	rows := make([]gitea.Values, 0, len(issues))
+	for i := range issues {
+		it := &issues[i]
+		rows = append(rows, gitea.Values{
+			it.Number, it.Title, it.State, it.Author(),
+			it.AssigneeNames(), it.UpdatedAt,
+		})
+	}
+	return p.PrintList(issueListFields(), rows)
+}
+
+// runIssuesView：teai issues view --repo owner/repo <number> [--comments]
+func runIssuesView(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai issues view", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	withComments := fs.Bool("comments", false, "連留言一起輸出")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "issues view 需要 --repo owner/repo"}
+	}
+	if fs.NArg() != 1 {
+		return &ErrUsage{Msg: "issues view 需要恰好一個編號"}
+	}
+	num, err := parseNumber(fs.Arg(0))
+	if err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	it, err := ops.GetIssue(context.Background(), owner, name, num)
+	if err != nil {
+		return err
+	}
+	p := printer(env)
+	fields := []gitea.Field{
+		{Name: "number"}, {Name: "title"}, {Name: "state"},
+		{Name: "author"}, {Name: "assignees", ValueFmt: joinOrEmpty},
+		{Name: "labels", ValueFmt: joinOrEmpty}, {Name: "body"},
+		{Name: "url"}, {Name: "updated_at"},
+	}
+	row := gitea.Values{
+		it.Number, it.Title, it.State, it.Author(),
+		it.AssigneeNames(), it.LabelNames(), it.Body,
+		it.HTMLURL, it.UpdatedAt,
+	}
+	if err := p.PrintOne(fields, row); err != nil {
+		return err
+	}
+	if !*withComments {
+		return nil
+	}
+	return printComments(env, ops, owner, name, num)
+}
+
+// printComments 輸出 issue／PR 的留言清單（view --comments 共用）。
+func printComments(env *Env, ops *dailyops.Ops, owner, repo string, number int64) error {
+	comments, err := ops.ListComments(context.Background(), owner, repo, number)
+	if err != nil {
+		return err
+	}
+	p := printer(env)
+	rows := make([]gitea.Values, 0, len(comments))
+	for i := range comments {
+		c := &comments[i]
+		rows = append(rows, gitea.Values{c.Author(), c.CreatedAt, c.Body})
+	}
+	return p.PrintList([]gitea.Field{
+		{Name: "author"}, {Name: "created_at"}, {Name: "body"},
+	}, rows)
+}
+
+// runIssuesCreate：teai issues create --repo owner/repo --title … [--body …] [--assignees a,b] --yes
+func runIssuesCreate(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai issues create", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	title := fs.String("title", "", "標題（必填）")
+	body := fs.String("body", "", "內文")
+	assignees := fs.String("assignees", "", "assignees（逗號分隔，可選）")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "issues create 需要 --repo owner/repo"}
+	}
+	if strings.TrimSpace(*title) == "" {
+		return &ErrUsage{Msg: "issues create 需要 --title"}
+	}
+	if err := requireYes(*yes, "issues create"); err != nil {
+		return err
+	}
+	var assigneeList []string
+	if strings.TrimSpace(*assignees) != "" {
+		for _, a := range strings.Split(*assignees, ",") {
+			if a = strings.TrimSpace(a); a != "" {
+				assigneeList = append(assigneeList, a)
+			}
+		}
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	issue, err := ops.CreateIssue(context.Background(), owner, name, *title, *body, assigneeList)
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintOne([]gitea.Field{
+		{Name: "number"}, {Name: "title"}, {Name: "url"},
+	}, gitea.Values{issue.Number, issue.Title, issue.HTMLURL})
+}
+
+// runIssuesClose：teai issues close --repo owner/repo <number> --yes
+func runIssuesClose(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai issues close", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "issues close 需要 --repo owner/repo"}
+	}
+	if fs.NArg() != 1 {
+		return &ErrUsage{Msg: "issues close 需要恰好一個編號"}
+	}
+	num, err := parseNumber(fs.Arg(0))
+	if err != nil {
+		return err
+	}
+	if err := requireYes(*yes, "issues close"); err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	issue, err := ops.SetIssueState(context.Background(), owner, name, num, "closed")
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintOne([]gitea.Field{
+		{Name: "number"}, {Name: "title"}, {Name: "state"}, {Name: "url"},
+	}, gitea.Values{issue.Number, issue.Title, issue.State, issue.HTMLURL})
+}
+
+// runComment：teai issues comment / teai pulls comment 共用。
+func runComment(env *Env, args []string, isPR bool) error {
+	name := "issues comment"
+	if isPR {
+		name = "pulls comment"
+	}
+	fs := flag.NewFlagSet("teai "+name, flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	body := fs.String("body", "", "留言內容（必填）")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, rname, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: name + " 需要 --repo owner/repo"}
+	}
+	if strings.TrimSpace(*body) == "" {
+		return &ErrUsage{Msg: name + " 需要 --body"}
+	}
+	if fs.NArg() != 1 {
+		return &ErrUsage{Msg: name + " 需要恰好一個編號"}
+	}
+	num, err := parseNumber(fs.Arg(0))
+	if err != nil {
+		return err
+	}
+	if err := requireYes(*yes, name); err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	comment, err := ops.AddComment(context.Background(), owner, rname, num, *body)
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintOne([]gitea.Field{
+		{Name: "author"}, {Name: "created_at"}, {Name: "body"},
+	}, gitea.Values{comment.Author(), comment.CreatedAt, comment.Body})
+}
+
+// ---- pulls ----
+
+// runPullsDaily：teai pulls [list|view|create|merge|comment] …；
+// 無子命令時沿用 #6 的工作流清單（teai pulls [--mine|--reviewer] [--repo]）。
+func runPullsDaily(env *Env, args []string) error {
+	if len(args) == 0 || strings.HasPrefix(args[0], "-") {
+		// 相容 #6：teai pulls / teai pulls --mine …（工作流清單）。
+		return runPulls(env, args)
+	}
+	sub, rest := args[0], args[1:]
+	switch sub {
+	case "list":
+		return runPullsList(env, rest)
+	case "view":
+		return runPullsView(env, rest)
+	case "create":
+		return runPullsCreate(env, rest)
+	case "merge":
+		return runPullsMerge(env, rest)
+	case "comment":
+		return runComment(env, rest, true)
+	default:
+		return &ErrUsage{Msg: fmt.Sprintf("pulls 未知子命令 %q（可用：list | view | create | merge | comment；或無子命令＝工作流清單）", sub)}
+	}
+}
+
+// runPullsList：teai pulls list --repo owner/repo [--state open|closed|all]
+func runPullsList(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai pulls list", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	state := fs.String("state", "open", "狀態：open|closed|all")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "pulls list 需要 --repo owner/repo"}
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	pulls, err := ops.ListPulls(context.Background(), owner, name, *state)
+	if err != nil {
+		return err
+	}
+	p := printer(env)
+	rows := make([]gitea.Values, 0, len(pulls))
+	for i := range pulls {
+		pr := &pulls[i]
+		rows = append(rows, gitea.Values{
+			pr.Number, pr.Title, pr.State, pr.Author(),
+			pr.HeadRef(), pr.BaseRef(), pr.UpdatedAt,
+		})
+	}
+	return p.PrintList([]gitea.Field{
+		{Name: "number"}, {Name: "title"}, {Name: "state"},
+		{Name: "author"}, {Name: "head"}, {Name: "base"}, {Name: "updated_at"},
+	}, rows)
+}
+
+// runPullsView：teai pulls view --repo owner/repo <number> [--comments]
+func runPullsView(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai pulls view", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	withComments := fs.Bool("comments", false, "連留言一起輸出")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "pulls view 需要 --repo owner/repo"}
+	}
+	if fs.NArg() != 1 {
+		return &ErrUsage{Msg: "pulls view 需要恰好一個編號"}
+	}
+	num, err := parseNumber(fs.Arg(0))
+	if err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	pr, err := ops.GetPull(context.Background(), owner, name, num)
+	if err != nil {
+		return err
+	}
+	p := printer(env)
+	fields := []gitea.Field{
+		{Name: "number"}, {Name: "title"}, {Name: "state"},
+		{Name: "author"}, {Name: "head"}, {Name: "base"}, {Name: "body"},
+		{Name: "url"}, {Name: "updated_at"},
+	}
+	row := gitea.Values{
+		pr.Number, pr.Title, pr.State, pr.Author(),
+		pr.HeadRef(), pr.BaseRef(), pr.Body, pr.HTMLURL, pr.UpdatedAt,
+	}
+	if err := p.PrintOne(fields, row); err != nil {
+		return err
+	}
+	if !*withComments {
+		return nil
+	}
+	return printComments(env, ops, owner, name, num)
+}
+
+// runPullsCreate：teai pulls create --repo owner/repo --head <branch> --base <branch> --title … [--body …] --yes
+func runPullsCreate(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai pulls create", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	head := fs.String("head", "", "來源分支（必填）")
+	base := fs.String("base", "main", "目標分支（預設 main）")
+	title := fs.String("title", "", "標題（必填）")
+	body := fs.String("body", "", "說明")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "pulls create 需要 --repo owner/repo"}
+	}
+	if *head == "" || *title == "" {
+		return &ErrUsage{Msg: "pulls create 需要 --head 與 --title"}
+	}
+	if err := requireYes(*yes, "pulls create"); err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	pr, err := ops.CreatePull(context.Background(), owner, name, *title, *body, *head, *base)
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintOne([]gitea.Field{
+		{Name: "number"}, {Name: "title"}, {Name: "url"},
+	}, gitea.Values{pr.Number, pr.Title, pr.HTMLURL})
+}
+
+// runPullsMerge：teai pulls merge --repo owner/repo <number> [--style merge|rebase|squash] --yes
+func runPullsMerge(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai pulls merge", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	style := fs.String("style", "merge", "合併方式：merge|rebase|rebase-merge|squash")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "pulls merge 需要 --repo owner/repo"}
+	}
+	if fs.NArg() != 1 {
+		return &ErrUsage{Msg: "pulls merge 需要恰好一個編號"}
+	}
+	num, err := parseNumber(fs.Arg(0))
+	if err != nil {
+		return err
+	}
+	switch *style {
+	case "merge", "rebase", "rebase-merge", "squash":
+	default:
+		return &ErrUsage{Msg: "pulls merge 的 --style 需為 merge|rebase|rebase-merge|squash"}
+	}
+	if err := requireYes(*yes, "pulls merge"); err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	if err := ops.MergePull(context.Background(), owner, name, num, *style); err != nil {
+		return err
+	}
+	return printer(env).PrintOne([]gitea.Field{
+		{Name: "number"}, {Name: "state"},
+	}, gitea.Values{num, "merged"})
+}
+
+// ---- labels ----
+
+// runLabels：teai labels list --repo owner/repo｜teai labels create … --yes
+func runLabels(env *Env, args []string) error {
+	if len(args) == 0 {
+		return &ErrUsage{Msg: "labels 需要子命令：list | create"}
+	}
+	sub, rest := args[0], args[1:]
+	switch sub {
+	case "list":
+		return runLabelsList(env, rest)
+	case "create":
+		return runLabelsCreate(env, rest)
+	default:
+		return &ErrUsage{Msg: fmt.Sprintf("labels 未知子命令 %q（可用：list | create）", sub)}
+	}
+}
+
+// runLabelsList：teai labels list --repo owner/repo
+func runLabelsList(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai labels list", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "labels list 需要 --repo owner/repo"}
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	labels, err := ops.ListLabels(context.Background(), owner, name)
+	if err != nil {
+		return err
+	}
+	rows := make([]gitea.Values, 0, len(labels))
+	for _, l := range labels {
+		rows = append(rows, gitea.Values{l.Name, l.Color, l.Description})
+	}
+	return printer(env).PrintList([]gitea.Field{
+		{Name: "name"}, {Name: "color"}, {Name: "description"},
+	}, rows)
+}
+
+// runLabelsCreate：teai labels create --repo owner/repo --name … [--color …] [--description …] --yes
+func runLabelsCreate(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai labels create", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	labelName := fs.String("name", "", "標籤名（必填）")
+	color := fs.String("color", "#ffffff", "顏色（#RRGGBB，預設 #ffffff）")
+	desc := fs.String("description", "", "說明")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "labels create 需要 --repo owner/repo"}
+	}
+	if *labelName == "" {
+		return &ErrUsage{Msg: "labels create 需要 --name"}
+	}
+	if err := requireYes(*yes, "labels create"); err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	label, err := ops.CreateLabel(context.Background(), owner, name, *labelName, *color, *desc)
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintOne([]gitea.Field{
+		{Name: "name"}, {Name: "color"}, {Name: "description"},
+	}, gitea.Values{label.Name, label.Color, label.Description})
+}
+
+// ---- milestones ----
+
+// runMilestones：teai milestones list｜create …
+func runMilestones(env *Env, args []string) error {
+	if len(args) == 0 {
+		return &ErrUsage{Msg: "milestones 需要子命令：list | create"}
+	}
+	sub, rest := args[0], args[1:]
+	switch sub {
+	case "list":
+		return runMilestonesList(env, rest)
+	case "create":
+		return runMilestonesCreate(env, rest)
+	default:
+		return &ErrUsage{Msg: fmt.Sprintf("milestones 未知子命令 %q（可用：list | create）", sub)}
+	}
+}
+
+// runMilestonesList：teai milestones list --repo owner/repo [--state open|closed|all]
+func runMilestonesList(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai milestones list", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	state := fs.String("state", "open", "狀態：open|closed|all")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "milestones list 需要 --repo owner/repo"}
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	ms, err := ops.ListMilestones(context.Background(), owner, name, *state)
+	if err != nil {
+		return err
+	}
+	rows := make([]gitea.Values, 0, len(ms))
+	for _, m := range ms {
+		rows = append(rows, gitea.Values{m.Title, m.State, m.Description, m.DueOn})
+	}
+	return printer(env).PrintList([]gitea.Field{
+		{Name: "title"}, {Name: "state"}, {Name: "description"}, {Name: "due_on"},
+	}, rows)
+}
+
+// runMilestonesCreate：teai milestones create --repo owner/repo --title … [--description …] [--due …] --yes
+func runMilestonesCreate(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai milestones create", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	title := fs.String("title", "", "標題（必填）")
+	desc := fs.String("description", "", "說明")
+	due := fs.String("due", "", "截止日（RFC3339，可選）")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "milestones create 需要 --repo owner/repo"}
+	}
+	if *title == "" {
+		return &ErrUsage{Msg: "milestones create 需要 --title"}
+	}
+	if err := requireYes(*yes, "milestones create"); err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	m, err := ops.CreateMilestone(context.Background(), owner, name, *title, *desc, *due)
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintOne([]gitea.Field{
+		{Name: "id"}, {Name: "title"}, {Name: "state"}, {Name: "due_on"},
+	}, gitea.Values{m.ID, m.Title, m.State, m.DueOn})
+}
+
+// ---- releases / repos / api ----
+
+// runReleases：teai releases list --repo owner/repo
+func runReleases(env *Env, args []string) error {
+	if len(args) == 0 || args[0] != "list" {
+		return &ErrUsage{Msg: "releases 目前支援子命令：list"}
+	}
+	fs := flag.NewFlagSet("teai releases list", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	repo := fs.String("repo", "", "倉庫（owner/repo，必填）")
+	if err := parseFlags(fs, args[1:]); err != nil {
+		return err
+	}
+	owner, name, err := splitRepoFlag(*repo)
+	if err != nil {
+		return err
+	}
+	if owner == "" {
+		return &ErrUsage{Msg: "releases list 需要 --repo owner/repo"}
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	releases, err := ops.ListReleases(context.Background(), owner, name)
+	if err != nil {
+		return err
+	}
+	rows := make([]gitea.Values, 0, len(releases))
+	for _, r := range releases {
+		rows = append(rows, gitea.Values{r.TagName, r.Name, r.Draft, r.Prerelease, r.PublishedAt})
+	}
+	return printer(env).PrintList([]gitea.Field{
+		{Name: "tag_name"}, {Name: "name"}, {Name: "draft"}, {Name: "prerelease"}, {Name: "published_at"},
+	}, rows)
+}
+
+// runRepos：teai repos list [--org <org>]（未指定 --org 則列自己可存的倉庫）
+func runRepos(env *Env, args []string) error {
+	if len(args) == 0 || args[0] != "list" {
+		return &ErrUsage{Msg: "repos 目前支援子命令：list"}
+	}
+	fs := flag.NewFlagSet("teai repos list", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	org := fs.String("org", "", "組織（未指定則列自己可存取的倉庫）")
+	if err := parseFlags(fs, args[1:]); err != nil {
+		return err
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	var repos []dailyops.Repo
+	if *org != "" {
+		repos, err = ops.ListOrgRepos(context.Background(), *org)
+	} else {
+		repos, err = ops.ListMyRepos(context.Background())
+	}
+	if err != nil {
+		return err
+	}
+	rows := make([]gitea.Values, 0, len(repos))
+	for _, r := range repos {
+		rows = append(rows, gitea.Values{r.FullName, r.Private, r.Empty, r.UpdatedAt, r.HTMLURL})
+	}
+	return printer(env).PrintList([]gitea.Field{
+		{Name: "full_name"}, {Name: "private"}, {Name: "empty"}, {Name: "updated_at"}, {Name: "url"},
+	}, rows)
+}
+
+// runAPIDirect：teai api <path> [--method GET|POST|…] [--data <json>] [--yes]
+func runAPIDirect(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai api", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	method := fs.String("method", "GET", "HTTP 動詞（GET 預設；非 GET 需 --yes）")
+	data := fs.String("data", "", "請求 body（JSON 字串，可選）")
+	yes := fs.Bool("yes", false, "確認寫入")
+	if err := parseFlags(fs, args); err != nil {
+		return err
+	}
+	if fs.NArg() != 1 {
+		return &ErrUsage{Msg: "api 需要恰好一個 path（相對 api/v1，以 / 開頭）"}
+	}
+	path := fs.Arg(0)
+	// path 內含查詢字串（如 /repos/x?state=closed）時剝離到 rawQuery，
+	// 不可併進 URL path（會 404）。
+	rawQuery := ""
+	if q := strings.IndexByte(path, '?'); q >= 0 {
+		rawQuery = path[q+1:]
+		path = path[:q]
+	}
+	if path == "" || path[0] != '/' {
+		return &ErrUsage{Msg: "api path 必須以 / 開頭（相對 api/v1）"}
+	}
+	upper := strings.ToUpper(strings.TrimSpace(*method))
+	if upper == "" {
+		upper = "GET"
+	}
+	switch upper {
+	case "GET", "HEAD", "OPTIONS":
+	default:
+		if err := requireYes(*yes, "api "+upper); err != nil {
+			return err
+		}
+	}
+	var payload []byte
+	if strings.TrimSpace(*data) != "" {
+		if !json.Valid([]byte(*data)) {
+			return &ErrUsage{Msg: "--data 必須是合法 JSON"}
+		}
+		payload = []byte(*data)
+	}
+	ops, err := newOpsClient(env)
+	if err != nil {
+		return err
+	}
+	resp, err := ops.CallAPIDirect(context.Background(), upper, path, rawQuery, payload)
+	if err != nil {
+		return err
+	}
+	// 原樣輸出（teai api 是逃生口，不做欄位挑選）。
+	_, err = env.Out.Write(resp)
+	if len(resp) > 0 && resp[len(resp)-1] != '\n' {
+		fmt.Fprintln(env.Out)
+	}
+	return err
+}
@@ -0,0 +1,289 @@
+// dailyops_commands_test.go — #8 的驗收測試：以 httptest 假伺服器驗證
+// issues/pulls/labels/milestones/releases/repos/api 的讀取行為，與
+// 寫入命令的 --yes 閘門（未帶 --yes 不得發出任何請求）。
+package cli
+
+import (
+	"fmt"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+)
+
+// opsTestServer 建立假 Gitea API 伺服器與對應的執行輔助。
+func opsTestServer(t *testing.T, handler http.HandlerFunc) func(args ...string) (string, string, int) {
+	t.Helper()
+	srv := httptest.NewServer(handler)
+	t.Cleanup(srv.Close)
+	return func(args ...string) (string, string, int) {
+		full := append([]string{"--url", srv.URL}, args...)
+		return runCLI(full...) // 套件級輔助（見下）
+	}
+}
+
+// runCLI 是 cli_test.go `run` 的別名，避免與各測試內的區域變數 run 混淆。
+func runCLI(args ...string) (string, string, int) {
+	return run(args...)
+}
+
+// TestIssuesListReadsOpenIssuesOnly 驗證 issues list 帶 state=open 與
+// type=issues（排除 PR），輸出 JSON 陣列。
+func TestIssuesListReadsOpenIssuesOnly(t *testing.T) {
+	var gotQuery string
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		gotQuery = r.URL.RawQuery
+		fmt.Fprint(w, `[{"number":8,"title":"日常操作","state":"open","user":{"login":"ceo"},"assignees":[{"login":"alex"}],"updated_at":"2026-09-10T08:13:00Z"}]`)
+	})
+	stdout, _, code := run("issues", "list", "--repo", "alterminal/teai")
+	if code != 0 {
+		t.Fatalf("issues list 應回 0，得到 %d", code)
+	}
+	if !strings.Contains(gotQuery, "state=open") || !strings.Contains(gotQuery, "type=issues") {
+		t.Errorf("查詢參數應含 state=open 與 type=issues，得到 %q", gotQuery)
+	}
+	if !strings.Contains(stdout, `"number":8`) || !strings.Contains(stdout, `"author":"ceo"`) {
+		t.Errorf("輸出應含 number 與 author 欄位，得到：%s", stdout)
+	}
+}
+
+// TestIssuesListRequiresRepo 驗證 --repo 必填。
+func TestIssuesListRequiresRepo(t *testing.T) {
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		t.Errorf("不應發出任何請求")
+	})
+	_, stderr, code := run("issues", "list")
+	if code != int(ExitUsage) {
+		t.Errorf("缺 --repo 應回 ExitUsage，得到 %d", code)
+	}
+	if !strings.Contains(stderr, "--repo") {
+		t.Errorf("錯誤訊息應提及 --repo，得到：%s", stderr)
+	}
+}
+
+// TestIssuesViewWithComments 驗證 view --comments 連留言輸出。
+func TestIssuesViewWithComments(t *testing.T) {
+	var paths []string
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		paths = append(paths, r.URL.Path)
+		switch {
+		case strings.HasSuffix(r.URL.Path, "/issues/8"):
+			fmt.Fprint(w, `{"number":8,"title":"日常操作","state":"open","user":{"login":"ceo"},"body":"內文","html_url":"https://x/8","labels":[],"updated_at":"t"}`)
+		case strings.HasSuffix(r.URL.Path, "/comments"):
+			fmt.Fprint(w, `[{"body":"開始處理","created_at":"t1","user":{"login":"alex"}}]`)
+		default:
+			fmt.Fprint(w, `[]`)
+		}
+	})
+	stdout, _, code := run("issues", "view", "--repo", "alterminal/teai", "--comments", "8")
+	if code != 0 {
+		t.Fatalf("view --comments 應回 0，得到 %d", code)
+	}
+	if len(paths) != 2 || !strings.HasSuffix(paths[1], "/issues/8/comments") {
+		t.Errorf("應依序呼叫 issue 與 comments 端點，得到 %v", paths)
+	}
+	if !strings.Contains(stdout, `"body":"開始處理"`) {
+		t.Errorf("輸出應含留言內容，得到：%s", stdout)
+	}
+}
+
+// TestWriteCommandsRequireYes 驗證所有寫入命令未帶 --yes 時：
+// 回 ExitUsage 且不發出任何 HTTP 請求（issue 驗收條件）。
+func TestWriteCommandsRequireYes(t *testing.T) {
+	cases := []struct {
+		name string
+		args []string
+	}{
+		{"issues create", []string{"issues", "create", "--repo", "a/b", "--title", "t"}},
+		{"issues close", []string{"issues", "close", "--repo", "a/b", "1"}},
+		{"issues comment", []string{"issues", "comment", "--repo", "a/b", "--body", "x", "1"}},
+		{"pulls create", []string{"pulls", "create", "--repo", "a/b", "--head", "h", "--title", "t"}},
+		{"pulls merge", []string{"pulls", "merge", "--repo", "a/b", "1"}},
+		{"pulls comment", []string{"pulls", "comment", "--repo", "a/b", "--body", "x", "1"}},
+		{"labels create", []string{"labels", "create", "--repo", "a/b", "--name", "n"}},
+		{"milestones create", []string{"milestones", "create", "--repo", "a/b", "--title", "t"}},
+		{"api POST", []string{"api", "--method", "POST", "/repos/a/b/issues"}},
+	}
+	for _, tc := range cases {
+		t.Run(tc.name, func(t *testing.T) {
+			run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+				t.Errorf("%s：未帶 --yes 不得發出請求（%s %s）", tc.name, r.Method, r.URL.Path)
+			})
+			_, stderr, code := run(tc.args...)
+			if code != int(ExitUsage) {
+				t.Errorf("%s 未帶 --yes 應回 ExitUsage(2)，得到 %d", tc.name, code)
+			}
+			if !strings.Contains(stderr, "--yes") {
+				t.Errorf("%s 錯誤訊息應提及 --yes，得到：%s", tc.name, stderr)
+			}
+		})
+	}
+}
+
+// TestIssuesCreateWithYes 驗證帶 --yes 時 POST 正確 payload。
+func TestIssuesCreateWithYes(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, 512)
+		n, _ := r.Body.Read(buf)
+		gotBody = string(buf[:n])
+		fmt.Fprint(w, `{"number":15,"title":"新 issue","html_url":"https://x/15"}`)
+	})
+	stdout, _, code := run("issues", "create", "--repo", "alterminal/teai", "--title", "新 issue", "--body", "說明", "--assignees", "alex,ceo", "--yes")
+	if code != 0 {
+		t.Fatalf("create --yes 應回 0，得到 %d", code)
+	}
+	if gotMethod != "POST" || !strings.HasSuffix(gotPath, "/repos/alterminal/teai/issues") {
+		t.Errorf("應 POST /repos/alterminal/teai/issues，得到 %s %s", gotMethod, gotPath)
+	}
+	if !strings.Contains(gotBody, `"assignees":["alex","ceo"]`) {
+		t.Errorf("body 應含 assignees，得到：%s", gotBody)
+	}
+	if !strings.Contains(stdout, `"number":15`) {
+		t.Errorf("輸出應含新 issue 編號，得到：%s", stdout)
+	}
+}
+
+// TestPullsListAndSubcommands 驗證 pulls list 與 pulls（無子命令）可並存。
+func TestPullsListAndSubcommands(t *testing.T) {
+	var gotPath string
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		gotPath = r.URL.Path
+		fmt.Fprint(w, `[{"number":13,"title":"PR","state":"open","user":{"login":"alex"},"head":{"ref":"feat"},"base":{"ref":"main"},"updated_at":"t"}]`)
+	})
+	stdout, _, code := run("pulls", "list", "--repo", "alterminal/teai")
+	if code != 0 {
+		t.Fatalf("pulls list 應回 0，得到 %d", code)
+	}
+	if !strings.HasSuffix(gotPath, "/repos/alterminal/teai/pulls") {
+		t.Errorf("應呼叫 /repos/alterminal/teai/pulls，得到 %s", gotPath)
+	}
+	if !strings.Contains(stdout, `"head":"feat"`) || !strings.Contains(stdout, `"base":"main"`) {
+		t.Errorf("輸出應含 head/base 欄位，得到：%s", stdout)
+	}
+}
+
+// TestLabelsMilestonesReleasesList 驗證三個清單命令打對端點並輸出。
+func TestLabelsMilestonesReleasesList(t *testing.T) {
+	cases := []struct {
+		args    []string
+		path    string
+		resp    string
+		wantOut string
+	}{
+		{
+			args:    []string{"labels", "list", "--repo", "a/b"},
+			path:    "/api/v1/repos/a/b/labels",
+			resp:    `[{"name":"enhancement","color":"#84b6eb","description":""}]`,
+			wantOut: `"name":"enhancement"`,
+		},
+		{
+			args:    []string{"milestones", "list", "--repo", "a/b"},
+			path:    "/api/v1/repos/a/b/milestones",
+			resp:    `[{"title":"v1","state":"open","description":"","due_on":""}]`,
+			wantOut: `"title":"v1"`,
+		},
+		{
+			args:    []string{"releases", "list", "--repo", "a/b"},
+			path:    "/api/v1/repos/a/b/releases",
+			resp:    `[{"tag_name":"v1.0.0","name":"首個發佈","draft":false,"prerelease":false,"published_at":"t"}]`,
+			wantOut: `"tag_name":"v1.0.0"`,
+		},
+		{
+			args:    []string{"repos", "list", "--org", "alterminal"},
+			path:    "/api/v1/orgs/alterminal/repos",
+			resp:    `[{"full_name":"alterminal/teai","private":false,"empty":false,"updated_at":"t","html_url":"u"}]`,
+			wantOut: `"full_name":"alterminal/teai"`,
+		},
+	}
+	for _, tc := range cases {
+		t.Run(strings.Join(tc.args, " "), func(t *testing.T) {
+			var gotPath string
+			run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+				gotPath = r.URL.Path
+				fmt.Fprint(w, tc.resp)
+			})
+			stdout, _, code := run(tc.args...)
+			if code != 0 {
+				t.Fatalf("%v 應回 0，得到 %d", tc.args, code)
+			}
+			if gotPath != tc.path {
+				t.Errorf("應呼叫 %s，得到 %s", tc.path, gotPath)
+			}
+			if !strings.Contains(stdout, tc.wantOut) {
+				t.Errorf("輸出應含 %s，得到：%s", tc.wantOut, stdout)
+			}
+		})
+	}
+}
+
+// TestAPIDirectPassthrough 驗證 teai api 原樣輸出、GET 免 --yes、
+// POST 未帶 --yes 被擋。
+func TestAPIDirectPassthrough(t *testing.T) {
+	var gotMethod string
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		gotMethod = r.Method
+		fmt.Fprint(w, `{"version":"1.27.0"}`)
+	})
+	stdout, _, code := run("api", "/version")
+	if code != 0 || gotMethod != "GET" {
+		t.Fatalf("GET /version 應回 0，得到 %d (%s)", code, gotMethod)
+	}
+	if strings.TrimSpace(stdout) != `{"version":"1.27.0"}` {
+		t.Errorf("api 應原樣輸出，得到：%s", stdout)
+	}
+
+	_, stderr, code := run("api", "--method", "POST", "/version")
+	if code != int(ExitUsage) || !strings.Contains(stderr, "--yes") {
+		t.Errorf("POST 未帶 --yes 應回 2 並提及 --yes，得到 %d：%s", code, stderr)
+	}
+}
+
+// TestAPIDirectQueryInPath 驗證 path 內含 ?query 時查詢字串正確傳遞。
+func TestAPIDirectQueryInPath(t *testing.T) {
+	var gotQuery, gotPath string
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		gotPath, gotQuery = r.URL.Path, r.URL.RawQuery
+		fmt.Fprint(w, `[]`)
+	})
+	_, _, code := run("api", "/repos/a/b/issues?state=closed&limit=10")
+	if code != 0 {
+		t.Fatalf("api 帶查詢字串應回 0，得到 %d", code)
+	}
+	if gotPath != "/api/v1/repos/a/b/issues" || gotQuery != "state=closed&limit=10" {
+		t.Errorf("應剝離查詢字串，得到 path=%s query=%s", gotPath, gotQuery)
+	}
+}
+
+// TestIssuesCommentPostsBody 驗證 comment --yes 送出 body。
+func TestIssuesCommentPostsBody(t *testing.T) {
+	var gotPath, gotBody string
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		buf := make([]byte, 512)
+		n, _ := r.Body.Read(buf)
+		gotPath, gotBody = r.URL.Path, string(buf[:n])
+		fmt.Fprint(w, `{"body":"留言","created_at":"t","user":{"login":"alex"}}`)
+	})
+	_, _, code := run("issues", "comment", "--repo", "alterminal/teai", "--body", "留言", "--yes", "8")
+	if code != 0 {
+		t.Fatalf("comment --yes 應回 0，得到 %d", code)
+	}
+	if !strings.HasSuffix(gotPath, "/issues/8/comments") || !strings.Contains(gotBody, `"body":"留言"`) {
+		t.Errorf("應 POST comments 端點帶 body，得到 %s %s", gotPath, gotBody)
+	}
+}
+
+// TestExtractGlobalsAllowsCommandFlags 驗證命令旗標與全域選項可交錯。
+func TestExtractGlobalsAllowsCommandFlags(t *testing.T) {
+	run := opsTestServer(t, func(w http.ResponseWriter, r *http.Request) {
+		fmt.Fprint(w, `{"login":"alex"}`)
+	})
+	stdout, _, code := run("whoami", "--output", "table")
+	if code != 0 {
+		t.Fatalf("whoami --output table 應回 0，得到 %d", code)
+	}
+	if !strings.Contains(stdout, "alex") {
+		t.Errorf("table 輸出應含 alex，得到：%s", stdout)
+	}
+}
@@ -0,0 +1,243 @@
+// workflow_commands.go — gitea.py 工作流命令的 CLI 接線（#6）：
+// whoami、orgs、members [--has-work]、mine、pulls [--mine|--reviewer] [--repo]、next。
+//
+// 輸出走 internal/gitea 的 Printer（--output json|table）；錯誤經 cli.exitCodeFor
+// 映射結束碼（用法 2／API 3）。token 解析選序見 internal/gitea/auth.go。
+package cli
+
+import (
+	"errors"
+	"flag"
+	"fmt"
+	"strings"
+
+	"gitea.alterminal.com/alterminal/teai/internal/gitea"
+	"gitea.alterminal.com/alterminal/teai/internal/workflow"
+)
+
+func init() {
+	register := func(c *command) {
+		commands[c.name] = c
+	}
+	register(&command{name: "whoami", usage: "目前帳號", run: runWhoami})
+	register(&command{name: "orgs", usage: "我所屬的組織", run: runOrgs})
+	register(&command{name: "members", usage: "Agents 團隊成員；--has-work 只列有未完成工作者", run: runMembers})
+	register(&command{name: "mine", usage: "分派給我、待跟進的 issues", run: runMine})
+	// pulls 由 dailyops_commands.go 註冊（#8）：無子命令時走本檔的 runPulls
+	// 工作流清單，有子命令（list/view/create/merge/comment）走日常操作。
+	register(&command{name: "next", usage: "下一件該做的事", run: runNext})
+}
+
+// errNoRepoFlag 是 --repo 值格式錯誤。
+var errNoRepoFlag = errors.New("--repo 需為 owner/repo 形式")
+
+// newWorkflowClient 依全域選項建立 workflow 所需的 API client。
+func newWorkflowClient(env *Env) (*workflow.Scanner, error) {
+	token, _, err := gitea.ResolveToken(gitea.AuthOptions{
+		FlagToken:  env.Globals.Token,
+		SiteURL:    env.Globals.URL,
+		ConfigPath: env.Globals.ConfigPath,
+	})
+	if err != nil {
+		return nil, err
+	}
+	client, err := gitea.New(env.Globals.URL, token, env.Globals.Timeout)
+	if err != nil {
+		return nil, err
+	}
+	return &workflow.Scanner{Client: &workflow.APIClient{Client: client}}, nil
+}
+
+// printer 依全域選項建立輸出器。
+func printer(env *Env) gitea.Printer {
+	return gitea.Printer{Format: env.Globals.Output, Out: env.Out}
+}
+
+// runWhoami：teai whoami。
+func runWhoami(env *Env, args []string) error {
+	if len(args) != 0 {
+		return &ErrUsage{Msg: "whoami 不接受參數"}
+	}
+	s, err := newWorkflowClient(env)
+	if err != nil {
+		return err
+	}
+	name, err := s.Whoami()
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintOne(
+		[]gitea.Field{{Name: "username"}},
+		gitea.Values{name},
+	)
+}
+
+// runOrgs：teai orgs。
+func runOrgs(env *Env, args []string) error {
+	if len(args) != 0 {
+		return &ErrUsage{Msg: "orgs 不接受參數"}
+	}
+	s, err := newWorkflowClient(env)
+	if err != nil {
+		return err
+	}
+	orgs, err := s.Orgs()
+	if err != nil {
+		return err
+	}
+	rows := make([]gitea.Values, 0, len(orgs))
+	for _, o := range orgs {
+		rows = append(rows, gitea.Values{o})
+	}
+	return printer(env).PrintList(
+		[]gitea.Field{{Name: "username"}},
+		rows,
+	)
+}
+
+// runMembers：teai members [--has-work]。輸出每行一個帳號（同 gitea.py）。
+func runMembers(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai members", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	hasWork := fs.Bool("has-work", false, "只列出有未完成工作的成員")
+	if err := fs.Parse(args); err != nil {
+		return &ErrUsage{Msg: err.Error()}
+	}
+	if fs.NArg() != 0 {
+		return &ErrUsage{Msg: "members 不接受位置參數"}
+	}
+	s, err := newWorkflowClient(env)
+	if err != nil {
+		return err
+	}
+	names, err := s.Members(*hasWork)
+	if err != nil {
+		return err
+	}
+	// gitea.py members 每行輸出一個帳號（非 JSON）；保持一致以便交叉驗證。
+	for _, name := range names {
+		fmt.Fprintln(env.Out, name)
+	}
+	return nil
+}
+
+// runMine：teai mine。
+func runMine(env *Env, args []string) error {
+	if len(args) != 0 {
+		return &ErrUsage{Msg: "mine 不接受參數"}
+	}
+	s, err := newWorkflowClient(env)
+	if err != nil {
+		return err
+	}
+	issues, err := s.Mine()
+	if err != nil {
+		return err
+	}
+	return printer(env).PrintList(
+		[]gitea.Field{
+			{Name: "repo"}, {Name: "number"}, {Name: "title"}, {Name: "url"},
+		},
+		issueRows(issues),
+	)
+}
+
+// runPulls：teai pulls [--mine|--reviewer] [--repo owner/repo]。
+func runPulls(env *Env, args []string) error {
+	fs := flag.NewFlagSet("teai pulls", flag.ContinueOnError)
+	fs.SetOutput(env.Err)
+	mine := fs.Bool("mine", false, "限定作者是目前帳號")
+	reviewer := fs.Bool("reviewer", false, "限定自己是 requested reviewer")
+	repo := fs.String("repo", "", "限定單一倉庫（owner/repo）")
+	if err := fs.Parse(args); err != nil {
+		return &ErrUsage{Msg: err.Error()}
+	}
+	if fs.NArg() != 0 {
+		return &ErrUsage{Msg: "pulls 不接受位置參數"}
+	}
+	if *mine && *reviewer {
+		return &ErrUsage{Msg: "--mine 與 --reviewer 不能併用"}
+	}
+	var owner, name string
+	if *repo != "" {
+		parts := strings.SplitN(*repo, "/", 2)
+		if len(parts) != 2 || parts[0] == "" || parts[1] == "" {
+			return &ErrUsage{Msg: errNoRepoFlag.Error()}
+		}
+		owner, name = parts[0], parts[1]
+	}
+	s, err := newWorkflowClient(env)
+	if err != nil {
+		return err
+	}
+	items, err := s.Pulls(*mine, *reviewer)
+	if err != nil {
+		return err
+	}
+	rows := make([]gitea.Values, 0, len(items))
+	for _, item := range items {
+		if *repo != "" && (item.Owner != owner || item.Repo != name) {
+			continue
+		}
+		rows = append(rows, gitea.Values{
+			item.Owner + "/" + item.Repo,
+			item.Pull.Number,
+			item.Pull.Title,
+			item.Pull.WebURL(),
+		})
+	}
+	return printer(env).PrintList(
+		[]gitea.Field{
+			{Name: "repo"}, {Name: "number"}, {Name: "title"}, {Name: "url"},
+		},
+		rows,
+	)
+}
+
+// runNext：teai next。無工作輸出 null（exit 0）。
+func runNext(env *Env, args []string) error {
+	if len(args) != 0 {
+		return &ErrUsage{Msg: "next 不接受參數"}
+	}
+	s, err := newWorkflowClient(env)
+	if err != nil {
+		return err
+	}
+	work, err := s.Next()
+	if err != nil {
+		return err
+	}
+	p := printer(env)
+	if work == nil {
+		return p.PrintNull()
+	}
+	// gitea.py 的 _work_dict：role 僅 pull 帶（issue 不輸出 role 欄位）。
+	fields := []gitea.Field{
+		{Name: "type"}, {Name: "role"}, {Name: "repo"},
+		{Name: "number"}, {Name: "title"}, {Name: "url"},
+	}
+	row := gitea.Values{work.Type, work.Role, work.Repo, work.Number, work.Title, work.URL}
+	if work.Role == "" {
+		fields = []gitea.Field{
+			{Name: "type"}, {Name: "repo"},
+			{Name: "number"}, {Name: "title"}, {Name: "url"},
+		}
+		row = gitea.Values{work.Type, work.Repo, work.Number, work.Title, work.URL}
+	}
+	return p.PrintOne(fields, row)
+}
+
+// issueRows 把 issues 轉成輸出列（repo 欄位由掃描脈絡補齊）。
+func issueRows(issues []workflow.Issue) []gitea.Values {
+	rows := make([]gitea.Values, 0, len(issues))
+	for i := range issues {
+		issue := &issues[i]
+		rows = append(rows, gitea.Values{
+			issue.FullName(),
+			issue.Num(),
+			issue.Title,
+			issue.WebURL(),
+		})
+	}
+	return rows
+}