gitea.tea/cmd
Bo-Yi Wu 53e53e1067 feat(workflows): add dispatch, view, enable and disable subcommands (#952)
## Summary

- Add `tea actions workflows dispatch` to trigger `workflow_dispatch` events with `--ref`, `--input key=value`, and `--follow` for log tailing
- Add `tea actions workflows view` to show workflow details
- Add `tea actions workflows enable` and `disable` to toggle workflow state
- Rewrite `workflows list` to use the Workflow API instead of file listing
- Remove dead `WorkflowsList` print function that used `ContentsResponse`
- Update `CLI.md` and `example-workflows.md` with usage documentation and examples

## Motivation

Enable re-triggering specific workflows from the CLI, which is essential for AI-driven PR flows where a specific workflow needs to be re-run after pushing changes.

Leverages the 5 workflow API endpoints already supported by the Go SDK (v0.24.1) from go-gitea/gitea#33545:
- `ListRepoActionWorkflows`
- `GetRepoActionWorkflow`
- `DispatchRepoActionWorkflow` (with `returnRunDetails` support)
- `EnableRepoActionWorkflow`
- `DisableRepoActionWorkflow`

## New commands

\`\`\`
tea actions workflows
├── list          (rewritten to use Workflow API)
├── view <id>     (new)
├── dispatch <id> (new)
├── enable <id>   (new)
└── disable <id>  (new)
\`\`\`

### Usage examples

\`\`\`bash
# Dispatch workflow on current branch
tea actions workflows dispatch deploy.yml

# Dispatch with specific ref and inputs
tea actions workflows dispatch deploy.yml --ref main --input env=staging --input version=1.2.3

# Dispatch and follow logs
tea actions workflows dispatch ci.yml --ref feature/my-pr --follow

# View workflow details
tea actions workflows view deploy.yml

# Enable/disable workflows
tea actions workflows enable deploy.yml
tea actions workflows disable deploy.yml --confirm
\`\`\`

## Test plan

- [x] `go build ./...` passes
- [x] `go test ./...` passes
- [x] `go vet ./...` passes
- [x] `make lint` — 0 issues
- [x] `make docs-check` — CLI.md is up to date
- [x] Manual test: `tea actions workflows list` shows workflows from API
- [x] Manual test: `tea actions workflows dispatch <workflow> --ref main` triggers a run
- [x] Manual test: `tea actions workflows view <workflow>` shows details

---------

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Reviewed-on: https://gitea.com/gitea/tea/pulls/952
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: Bo-Yi Wu <appleboy.tw@gmail.com>
Co-committed-by: Bo-Yi Wu <appleboy.tw@gmail.com>
2026-04-09 20:03:33 +00:00
..
actions feat(workflows): add dispatch, view, enable and disable subcommands (#952) 2026-04-09 20:03:33 +00:00
admin/users replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
attachments refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
branches replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
flags refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
issues replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
labels replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
login refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
milestones replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
notifications replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
organizations replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
pulls feat(pulls): add resolve, unresolve and review-comments subcommands (#948) 2026-04-08 03:36:09 +00:00
releases refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
repos refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
times refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
webhooks replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
actions.go Add tea actions runs and workflows commands (#880) 2026-02-11 00:40:06 +00:00
admin.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
api.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
api_test.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
attachments.go migrate tea to urfave v3 (#760) 2025-06-10 05:19:59 +00:00
branches.go migrate tea to urfave v3 (#760) 2025-06-10 05:19:59 +00:00
categories.go spdx (#581) 2023-09-08 01:40:02 +00:00
clone.go refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
cmd.go Move versions/filelocker into dedicated subpackages, and consistent headers in http requests (#888) 2026-02-05 18:05:43 +00:00
comment.go refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
detail_json.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
issues.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
issues_test.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
labels.go refactor: code cleanup across codebase (#947) 2026-04-08 03:38:49 +00:00
login.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
logout.go migrate tea to urfave v3 (#760) 2025-06-10 05:19:59 +00:00
man.go generate man page (#811) 2025-09-14 00:17:28 +00:00
milestones.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
notifications.go migrate tea to urfave v3 (#760) 2025-06-10 05:19:59 +00:00
open.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
organizations.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
pulls.go feat(pulls): add resolve, unresolve and review-comments subcommands (#948) 2026-04-08 03:36:09 +00:00
releases.go migrate tea to urfave v3 (#760) 2025-06-10 05:19:59 +00:00
repos.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
times.go migrate tea to urfave v3 (#760) 2025-06-10 05:19:59 +00:00
webhooks.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00
whoami.go replace log.Fatal/os.Exit with error returns (#941) 2026-03-27 03:36:44 +00:00