Add VCS module publish command

.changes/unreleased/ENHANCEMENTS-20260823-222957.yaml

@@ -0,0 +1,3 @@
+kind: ENHANCEMENTS
+body: "Added `tfctl module publish` for publishing VCS-backed private registry modules from existing OAuth or GitHub App connections"
+time: 2026-08-23T22:29:57.000000-04:00

AGENTS.md

@@ -18,7 +18,7 @@
 ## Repository Architecture
 
 - `cmd/tfctl/main.go` is the process entry point. It creates I/O, logging, profiles, telemetry, the shared invocation, and the command tree.
-- `internal/commands/` contains command behavior. The top-level groups are `api`, `get`, `create`, `run`, `auth`, `variable`, `profile`, and `harness`.
+- `internal/commands/` contains command behavior. The top-level groups are `api`, `get`, `create`, `module`, `run`, `auth`, `variable`, `profile`, and `harness`.
 - `internal/pkg/` contains reusable infrastructure. Important packages include `cmd`, `client`, `format`, `iostreams`, `logging`, `telemetry`, `profile`, `openapi`, and `execsession`.
 - `internal/commands/*` can depend on `internal/pkg/*`. Do not add dependencies from infrastructure packages to command packages.
 - `skills/` contains embedded coding-agent skills.

internal/commands/module/module.go

@@ -0,0 +1,27 @@
+// Copyright IBM Corp. 2026
+// SPDX-License-Identifier: MPL-2.0
+
+// Package module implements the `module` command group.
+package module
+
+import (
+	"github.com/hashicorp/tfctl-cli/internal/pkg/cmd"
+	"github.com/hashicorp/tfctl-cli/internal/pkg/heredoc"
+	"github.com/hashicorp/tfctl-cli/version"
+)
+
+// NewCmdModule creates the `module` command group.
+func NewCmdModule(inv *cmd.Invocation) *cmd.Command {
+	c := &cmd.Command{
+		Name:      "module",
+		ShortHelp: "Manage private registry modules.",
+		LongHelp: heredoc.New(inv.IO).Mustf(`
+		The {{ template "mdCodeOrBold" "%s module" }} command group lets you manage
+		private registry modules in HCP Terraform and Terraform Enterprise.
+		`, version.Name),
+	}
+
+	c.AddChild(NewCmdPublish(inv))
+
+	return c
+}