feat: add wiki CLI commands (#998)

## Summary

Add first-class `tea wiki` commands backed by the existing Gitea wiki API and SDK support.

## What this adds

- `tea wiki list`
- `tea wiki view <page>`
- `tea wiki revisions <page>`
- `tea wiki create`
- `tea wiki edit <page>`
- `tea wiki delete <page>`

## Implementation details

- registers a new top-level `wiki` entity command
- keeps command logic under `cmd/wiki/`
- adds wiki-specific renderers in `modules/print/wiki.go`
- adds wiki task helpers in `modules/task/wiki.go`
- reuses existing repo/login/output/pagination patterns used elsewhere in `tea`
- base64-encodes wiki content for create/edit API calls
- requires explicit `--confirm` for delete
- preserves the current page title during edit when `--title` is omitted

## Test coverage

The PR is intentionally split into two commits:

1. `feat: add wiki CLI commands`
2. `test: add wiki integration coverage`

Validation performed:

- focused command, task, and print tests for the new wiki functionality
- integration coverage for the wiki command lifecycle
- `make lint`
- `make fmt-check`
- `make docs-check`
- `make build`
- upstream PR CI passed:
  - `check-and-test / Integration Test`
  - `check-and-test / Lint Build And Unit Coverage`

## Motivation

This makes `tea` a better interface for both human and agent-driven workflows by exposing wiki operations as stable first-class CLI commands instead of requiring ad-hoc API calls or custom wrappers.

---
Generated by Hermes Agent with GPT-5.4

---------

Co-authored-by: nitro <nitro@nitroui-Macmini.local>
Reviewed-on: https://gitea.com/gitea/tea/pulls/998
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: kuil09 <202447+kuil09@noreply.gitea.com>
Co-committed-by: kuil09 <202447+kuil09@noreply.gitea.com>

cmd/wiki/write.go

@@ -0,0 +1,170 @@
+// Copyright 2026 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package wiki
+
+import (
+	"encoding/base64"
+	"fmt"
+
+	stdctx "context"
+
+	"gitea.dev/sdk"
+	"gitea.dev/tea/cmd/flags"
+	teaContext "gitea.dev/tea/modules/context"
+	"gitea.dev/tea/modules/print"
+	"gitea.dev/tea/modules/task"
+	"github.com/urfave/cli/v3"
+)
+
+var wikiTitleFlag = &cli.StringFlag{
+	Name:    "title",
+	Aliases: []string{"t"},
+	Usage:   "wiki page title",
+}
+
+var wikiContentFlag = &cli.StringFlag{
+	Name:    "content",
+	Aliases: []string{"c"},
+	Usage:   "wiki page content",
+}
+
+var wikiMessageFlag = &cli.StringFlag{
+	Name:    "message",
+	Aliases: []string{"m"},
+	Usage:   "commit message for the wiki change",
+}
+
+var wikiDeleteConfirmFlag = &cli.BoolFlag{
+	Name:    "confirm",
+	Aliases: []string{"y"},
+	Usage:   "confirm deletion without prompting",
+}
+
+var wikiWriteFlags = append([]cli.Flag{wikiTitleFlag, wikiContentFlag, wikiMessageFlag}, flags.LoginRepoFlags...)
+
+// CmdWikiCreate represents the create subcommand for wiki pages.
+var CmdWikiCreate = cli.Command{
+	Name:        "create",
+	Aliases:     []string{"c"},
+	Usage:       "Create a wiki page",
+	Description: "Create a wiki page",
+	ArgsUsage:   " ",
+	Action:      RunWikiCreate,
+	Flags:       wikiWriteFlags,
+}
+
+// CmdWikiEdit represents the edit subcommand for wiki pages.
+var CmdWikiEdit = cli.Command{
+	Name:        "edit",
+	Aliases:     []string{"e"},
+	Usage:       "Edit a wiki page",
+	Description: "Edit a wiki page",
+	ArgsUsage:   "<page>",
+	Action:      RunWikiEdit,
+	Flags:       wikiWriteFlags,
+}
+
+// CmdWikiDelete represents the delete subcommand for wiki pages.
+var CmdWikiDelete = cli.Command{
+	Name:        "delete",
+	Aliases:     []string{"rm"},
+	Usage:       "Delete a wiki page",
+	Description: "Delete a wiki page",
+	ArgsUsage:   "<page>",
+	Action:      RunWikiDelete,
+	Flags:       append([]cli.Flag{wikiDeleteConfirmFlag}, flags.LoginRepoFlags...),
+}
+
+func getWikiCreateOptions(cmd *cli.Command) (gitea.CreateWikiPageOptions, error) {
+	return buildWikiWriteOptions(cmd.String("title"), cmd.String("content"), cmd.String("message"), true)
+}
+
+func getWikiEditOptions(cmd *cli.Command) (gitea.CreateWikiPageOptions, error) {
+	return buildWikiWriteOptions(cmd.String("title"), cmd.String("content"), cmd.String("message"), false)
+}
+
+func buildWikiWriteOptions(title, content, message string, titleRequired bool) (gitea.CreateWikiPageOptions, error) {
+	if content == "" {
+		return gitea.CreateWikiPageOptions{}, fmt.Errorf("content is required")
+	}
+	if titleRequired && title == "" {
+		return gitea.CreateWikiPageOptions{}, fmt.Errorf("title is required")
+	}
+	return gitea.CreateWikiPageOptions{
+		Title:         title,
+		ContentBase64: base64.StdEncoding.EncodeToString([]byte(content)),
+		Message:       message,
+	}, nil
+}
+
+// RunWikiCreate creates a wiki page.
+func RunWikiCreate(_ stdctx.Context, cmd *cli.Command) error {
+	ctx, err := initWikiWriteContext(cmd)
+	if err != nil {
+		return err
+	}
+	return runWikiCreateWithClient(ctx, ctx.Login.Client().Wiki, cmd)
+}
+
+// RunWikiEdit edits a wiki page.
+func RunWikiEdit(_ stdctx.Context, cmd *cli.Command) error {
+	ctx, err := initWikiWriteContext(cmd)
+	if err != nil {
+		return err
+	}
+	return runWikiEditWithClient(ctx, cmd.Args().First(), ctx.Login.Client().Wiki, cmd)
+}
+
+// RunWikiDelete deletes a wiki page.
+func RunWikiDelete(_ stdctx.Context, cmd *cli.Command) error {
+	ctx, err := initWikiWriteContext(cmd)
+	if err != nil {
+		return err
+	}
+	return runWikiDeleteWithClient(ctx, cmd.Args().First(), ctx.Login.Client().Wiki, cmd.Bool("confirm"))
+}
+
+func runWikiCreateWithClient(ctx *teaContext.TeaContext, client task.WikiWriteClient, cmd *cli.Command) error {
+	opts, err := getWikiCreateOptions(cmd)
+	if err != nil {
+		return err
+	}
+	page, err := task.CreateWikiPage(ctx, client, opts)
+	if err != nil {
+		return err
+	}
+	return print.WikiPageDetails(page, ctx.Output)
+}
+
+func runWikiEditWithClient(ctx *teaContext.TeaContext, pageName string, client task.WikiWriteClient, cmd *cli.Command) error {
+	if pageName == "" {
+		return fmt.Errorf("page name is required")
+	}
+	opts, err := getWikiEditOptions(cmd)
+	if err != nil {
+		return err
+	}
+	if opts.Title == "" {
+		opts.Title = pageName
+	}
+	page, err := task.EditWikiPage(ctx, client, pageName, opts)
+	if err != nil {
+		return err
+	}
+	return print.WikiPageDetails(page, ctx.Output)
+}
+
+func runWikiDeleteWithClient(ctx *teaContext.TeaContext, pageName string, client task.WikiWriteClient, confirm bool) error {
+	if pageName == "" {
+		return fmt.Errorf("page name is required")
+	}
+	if !confirm {
+		return fmt.Errorf("deletion requires --confirm")
+	}
+	return task.DeleteWikiPage(ctx, client, pageName)
+}
+
+func initWikiWriteContext(cmd *cli.Command) (*teaContext.TeaContext, error) {
+	return initWikiContext(cmd)
+}