chore(release): 0.2.1

Author: steipete

.golangci.yml

@@ -1,3 +1,5 @@
+version: "2"
+
 run:
   timeout: 3m
   tests: true
@@ -7,25 +9,19 @@ linters:
   enable:
     - govet
     - staticcheck
-    - gofmt
-    - goimports
     - revive
     - ineffassign
     - errcheck
-    - gosimple
 
 linters-settings:
   revive:
+    enable-all-rules: false
     severity: warning
     rules:
       - name: exported
         severity: warning
       - name: var-naming
         severity: warning
-  gofmt:
-    simplify: true
-  goimports:
-    local-prefixes: say11
 
 issues:
   exclude-use-default: false

CHANGELOG.md

@@ -1,6 +1,8 @@
 # Changelog
 
 ## Unreleased
+
+## 0.2.1 - 2026-01-01
 ### Fixed
 - `-o/--output` now disables speaker playback by default unless `--play` is explicitly set. Previously `-o` saved to file AND played through speakers, which was confusing.
 

cmd/doc.go

@@ -0,0 +1,2 @@
+// Package cmd wires up the `sag` CLI commands.
+package cmd

cmd/prompting.go

@@ -17,7 +17,7 @@ func init() {
 		Aliases: []string{"prompt", "guide", "tips"},
 		Short:   "Prompting guide for better ElevenLabs speech",
 		Long:    "Prints a practical prompting guide (model-specific tips, tags, and knobs) to improve voice quality and control.",
-		RunE: func(cmd *cobra.Command, args []string) error {
+		RunE: func(cmd *cobra.Command, _ []string) error {
 			out := strings.TrimSpace(promptingGuide)
 			_, err := fmt.Fprintln(cmd.OutOrStdout(), out)
 			return err

cmd/prompting_guide.md

@@ -48,7 +48,7 @@ Notes:
 - Tag effectiveness depends on the voice + training samples; not every voice reacts well.
 - Combine tags sparingly; more tags ≠ better audio.
 
-## Knobs in `sag` (0.2.0)
+## Knobs in `sag` (0.2.1)
 
 Voice sliders:
 - `--stability` (v3 presets: 0.0=Creative, 0.5=Natural, 1.0=Robust; v2/v2.5: 0..1)

cmd/root.go

@@ -21,8 +21,8 @@ var (
 		Short:   "🗣️ ElevenLabs speech, mac-style ease",
 		Long:    "Command-line ElevenLabs TTS with macOS playback. Call it like macOS 'say': if you skip the subcommand, text args are passed to 'speak' (e.g. `sag \"Hello\"`).\n\nTip: run `sag prompting` for model-specific prompting tips.\nModels: `eleven_v3` (default), `eleven_multilingual_v2` (stable), `eleven_flash_v2_5` (fast/cheap), `eleven_turbo_v2_5` (balanced).",
 		Example: "  sag \"Hi Peter\"\n  echo 'piped input' | sag\n  sag speak -v Roger --rate 200 \"Faster speech\"\n  sag prompting",
-		Version: "0.2.0",
-		PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
+		Version: "0.2.1",
+		PersistentPreRunE: func(cmd *cobra.Command, _ []string) error {
 			if versionFlag {
 				fmt.Println(cmd.Root().Name(), cmd.Root().Version)
 				os.Exit(0)

cmd/sag/main.go

@@ -1,3 +1,4 @@
+// sag is the command-line entry point.
 package main
 
 import "github.com/steipete/sag/cmd"

cmd/sag/main_test.go

@@ -5,7 +5,7 @@ import (
 	"testing"
 )
 
-func TestMainHelp(t *testing.T) {
+func TestMainHelp(_ *testing.T) {
 	orig := os.Args
 	defer func() { os.Args = orig }()
 	os.Args = []string{"sag", "--help"}

cmd/speak.go

@@ -58,7 +58,7 @@ func init() {
 		Short: "Speak the provided text using ElevenLabs TTS (default: stream to speakers)",
 		Long:  "If no text argument is provided, the command reads from stdin.\n\nTip: run `sag prompting` for model-specific prompting tips and recommended flag combinations.",
 		Args:  cobra.ArbitraryArgs,
-		PreRunE: func(cmd *cobra.Command, args []string) error {
+		PreRunE: func(_ *cobra.Command, _ []string) error {
 			return ensureAPIKey()
 		},
 		RunE: func(cmd *cobra.Command, args []string) error {

cmd/speak_test.go

@@ -117,7 +117,7 @@ func TestResolveTextEmptyFile(t *testing.T) {
 }
 
 func TestResolveVoiceDefaultsToFirst(t *testing.T) {
-	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
 		if _, err := w.Write([]byte(`{"voices":[{"voice_id":"id1","name":"Alpha","category":"premade"},{"voice_id":"id2","name":"Beta","category":"premade"}]}`)); err != nil {
 			t.Fatalf("write response: %v", err)
 		}
@@ -136,7 +136,7 @@ func TestResolveVoiceDefaultsToFirst(t *testing.T) {
 
 func TestResolveVoicePassThroughID(t *testing.T) {
 	// Should short-circuit without hitting the server when input looks like an ID.
-	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+	srv := httptest.NewServer(http.HandlerFunc(func(_ http.ResponseWriter, _ *http.Request) {
 		t.Fatalf("server should not be called for ID pass-through")
 	}))
 	defer srv.Close()
@@ -152,7 +152,7 @@ func TestResolveVoicePassThroughID(t *testing.T) {
 }
 
 func TestResolveVoiceClosestMatch(t *testing.T) {
-	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
 		if _, err := w.Write([]byte(`{"voices":[{"voice_id":"id1","name":"Near","category":"premade"}]}`)); err != nil {
 			t.Fatalf("write response: %v", err)
 		}
@@ -176,7 +176,7 @@ func TestResolveVoiceClosestMatch(t *testing.T) {
 }
 
 func TestResolveVoiceListOutputsTable(t *testing.T) {
-	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
 		if _, err := w.Write([]byte(`{"voices":[{"voice_id":"id1","name":"Alpha","category":"premade"}]}`)); err != nil {
 			t.Fatalf("write response: %v", err)
 		}
@@ -274,7 +274,7 @@ func TestStreamAndPlayWithPlayback(t *testing.T) {
 	})
 	defer restore()
 
-	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
 		_, _ = w.Write([]byte("stream-play"))
 	}))
 	defer srv.Close()
@@ -301,7 +301,7 @@ func TestConvertAndPlayWithPlayback(t *testing.T) {
 	})
 	defer restore()
 
-	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
 		_, _ = w.Write([]byte("convert-play"))
 	}))
 	defer srv.Close()
@@ -379,7 +379,7 @@ func TestResolveVoiceByName(t *testing.T) {
 func stubPlay(t *testing.T, fn func([]byte)) func() {
 	t.Helper()
 	orig := playToSpeakers
-	playToSpeakers = func(ctx context.Context, r io.Reader) error {
+	playToSpeakers = func(_ context.Context, r io.Reader) error {
 		b, _ := io.ReadAll(r)
 		fn(b)
 		return nil