Add lint workflow

.github/workflows/lint.yml

@@ -0,0 +1,36 @@
+name: "go-linter"
+
+on:
+  pull_request:
+  merge_group:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    strategy:
+      fail-fast: false
+    runs-on: ubuntu-latest-xl
+    env:
+      GOPROXY: https://goproxy.githubapp.com/mod,https://proxy.golang.org/,direct
+      GOPRIVATE: ""
+      GONOPROXY: ""
+      GONOSUMDB: github.com/github/*
+    steps:
+      - uses: actions/setup-go@v5
+        with:
+          go-version: ${{ vars.GOVERSION }}
+          check-latest: true
+      - uses: actions/checkout@v4
+      - name: Configure Go private module access
+        run: |
+          echo "machine goproxy.githubapp.com login nobody password ${{ secrets.GOPROXY_TOKEN }}" >> $HOME/.netrc
+      - name: Lint
+        # This also does checkout, setup-go, and proxy setup.
+        uses: github/go-linter@v1.2.1
+        with:
+          strict: true
+          go-version: ${{ vars.GOVERSION }}
+          goproxy-token: ${{secrets.GOPROXY_TOKEN}}

README.md

@@ -6,7 +6,7 @@ Use the GitHub Models service from the CLI!
 
 ### Prerequisites
 
-The extension requires the `gh` CLI to be installed and in the PATH. The extension also requires the user have authenticated via `gh auth`.
+The extension requires the [`gh` CLI](https://cli.github.com/) to be installed and in the `PATH`. The extension also requires the user have authenticated via `gh auth`.
 
 ### Installing
 
@@ -73,4 +73,4 @@ git tag v0.0.x main
 git push origin tag v0.0.x
 ```
 
-This will trigger the `release` action that runs the actual production build.
+This will trigger the `release` action that runs the actual production build.

cmd/list/list.go

@@ -1,14 +1,15 @@
+// Package list provides a gh command to list available models.
 package list
 
 import (
 	"fmt"
-	"io"
 
 	"github.com/cli/go-gh/v2/pkg/auth"
 	"github.com/cli/go-gh/v2/pkg/tableprinter"
 	"github.com/cli/go-gh/v2/pkg/term"
-	"github.com/github/gh-models/internal/azure_models"
+	"github.com/github/gh-models/internal/azuremodels"
 	"github.com/github/gh-models/internal/ux"
+	"github.com/github/gh-models/pkg/util"
 	"github.com/mgutz/ansi"
 	"github.com/spf13/cobra"
 )
@@ -17,6 +18,7 @@ var (
 	lightGrayUnderline = ansi.ColorFunc("white+du")
 )
 
+// NewListCommand returns a new command to list available GitHub models.
 func NewListCommand() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "list",
@@ -28,28 +30,29 @@ func NewListCommand() *cobra.Command {
 
 			token, _ := auth.TokenForHost("github.com")
 			if token == "" {
-				io.WriteString(out, "No GitHub token found. Please run 'gh auth login' to authenticate.\n")
+				util.WriteToOut(out, "No GitHub token found. Please run 'gh auth login' to authenticate.\n")
 				return nil
 			}
 
-			client := azure_models.NewClient(token)
+			client := azuremodels.NewClient(token)
+			ctx := cmd.Context()
 
-			models, err := client.ListModels()
+			models, err := client.ListModels(ctx)
 			if err != nil {
 				return err
 			}
 
 			// For now, filter to just chat models.
 			// Once other tasks are supported (like embeddings), update the list to show all models, with the task as a column.
-			models = ux.FilterToChatModels(models)
+			models = filterToChatModels(models)
 			ux.SortModels(models)
 
 			isTTY := terminal.IsTerminalOutput()
 
 			if isTTY {
-				io.WriteString(out, "\n")
-				io.WriteString(out, fmt.Sprintf("Showing %d available chat models\n", len(models)))
-				io.WriteString(out, "\n")
+				util.WriteToOut(out, "\n")
+				util.WriteToOut(out, fmt.Sprintf("Showing %d available chat models\n", len(models)))
+				util.WriteToOut(out, "\n")
 			}
 
 			width, _, _ := terminal.Size()
@@ -75,3 +78,13 @@ func NewListCommand() *cobra.Command {
 
 	return cmd
 }
+
+func filterToChatModels(models []*azuremodels.ModelSummary) []*azuremodels.ModelSummary {
+	var chatModels []*azuremodels.ModelSummary
+	for _, model := range models {
+		if ux.IsChatModel(model) {
+			chatModels = append(chatModels, model)
+		}
+	}
+	return chatModels
+}

cmd/root.go

@@ -1,13 +1,16 @@
+// Package cmd represents the base command when called without any subcommands.
 package cmd
 
 import (
+	"strings"
+
 	"github.com/github/gh-models/cmd/list"
 	"github.com/github/gh-models/cmd/run"
 	"github.com/github/gh-models/cmd/view"
 	"github.com/spf13/cobra"
-	"strings"
 )
 
+// NewRootCommand returns a new root command for the gh-models extension.
 func NewRootCommand() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "models",