Skip to content

qtsone/learning / skills/tutor

tutor

Flagged

Turn this agent into a personal programming tutor with a versioned 0-to-expert curriculum (Go available; more languages coming). Use when the user wants to learn a programming language, start or resume lessons, get their exercise code graded, check learning progress, or contribute curriculum fixes — e.g. "/tutor go", "/tutor resume", "teach me Go", "continue my lessons", "grade my exercise".

FileKindSize
SKILL.mdskill md9.2 KB
curriculum/content/focus/cli-tooling/capstone/LESSON.mdmarkdown17.1 KB
curriculum/content/focus/cli-tooling/capstone/TUTOR.mdmarkdown5.4 KB
curriculum/content/focus/cli-tooling/capstone/exercise/app.goscript5.8 KB
curriculum/content/focus/cli-tooling/capstone/exercise/authors.goscript1.6 KB
curriculum/content/focus/cli-tooling/capstone/exercise/authors_test.goscript7.3 KB
curriculum/content/focus/cli-tooling/capstone/exercise/cli_test.goscript11.5 KB
curriculum/content/focus/cli-tooling/capstone/exercise/config_test.goscript11.5 KB
curriculum/content/focus/cli-tooling/capstone/exercise/go.modmanifest187 B
curriculum/content/focus/cli-tooling/capstone/exercise/go.summanifest900 B
curriculum/content/focus/cli-tooling/capstone/exercise/main.goscript2.0 KB
curriculum/content/focus/cli-tooling/capstone/exercise/render.goscript1.9 KB
curriculum/content/focus/cli-tooling/capstone/exercise/root.goscript2.4 KB
curriculum/content/focus/cli-tooling/capstone/exercise/scan.goscript2.5 KB
curriculum/content/focus/cli-tooling/capstone/exercise/scan_test.goscript4.0 KB
curriculum/content/focus/cli-tooling/capstone/exercise/signal_unix_test.goscript1.4 KB
curriculum/content/focus/cli-tooling/capstone/exercise/version.goscript942 B
curriculum/content/focus/cli-tooling/capstone/quiz.jsonconfig5.0 KB
curriculum/content/focus/cli-tooling/capstone/solution/app.goscript9.9 KB
curriculum/content/focus/cli-tooling/capstone/solution/authors.goscript2.9 KB
curriculum/content/focus/cli-tooling/capstone/solution/render.goscript2.6 KB
curriculum/content/focus/cli-tooling/capstone/solution/root.goscript4.7 KB
curriculum/content/focus/cli-tooling/capstone/solution/scan.goscript3.7 KB
curriculum/content/focus/cli-tooling/cobra/LESSON.mdmarkdown12.8 KB
curriculum/content/focus/cli-tooling/cobra/TUTOR.mdmarkdown5.9 KB
curriculum/content/focus/cli-tooling/cobra/exercise/app.goscript1.7 KB
curriculum/content/focus/cli-tooling/cobra/exercise/go.modmanifest193 B
curriculum/content/focus/cli-tooling/cobra/exercise/go.summanifest900 B
curriculum/content/focus/cli-tooling/cobra/exercise/main.goscript422 B
curriculum/content/focus/cli-tooling/cobra/exercise/notes_test.goscript9.8 KB
curriculum/content/focus/cli-tooling/cobra/exercise/root.goscript919 B
curriculum/content/focus/cli-tooling/cobra/exercise/store.goscript1.7 KB
curriculum/content/focus/cli-tooling/cobra/quiz.jsonconfig5.1 KB
curriculum/content/focus/cli-tooling/cobra/solution/app.goscript2.4 KB
curriculum/content/focus/cli-tooling/cobra/solution/root.goscript4.2 KB
curriculum/content/focus/cli-tooling/distribution/LESSON.mdmarkdown17.2 KB
curriculum/content/focus/cli-tooling/distribution/TUTOR.mdmarkdown7.0 KB
curriculum/content/focus/cli-tooling/distribution/exercise/check.shexecutablescript12.0 KB
curriculum/content/focus/cli-tooling/distribution/exercise/go.modmanifest35 B
curriculum/content/focus/cli-tooling/distribution/exercise/internal/buildinfo/buildinfo.goscript1.4 KB
curriculum/content/focus/cli-tooling/distribution/exercise/main.goscript1.2 KB
curriculum/content/focus/cli-tooling/distribution/quiz.jsonconfig5.0 KB
curriculum/content/focus/cli-tooling/distribution/solution/.goreleaser.yamlconfig2.1 KB
curriculum/content/focus/cli-tooling/distribution/solution/internal/buildinfo/buildinfo.goscript1.3 KB
curriculum/content/focus/cli-tooling/files-processes/LESSON.mdmarkdown18.8 KB
curriculum/content/focus/cli-tooling/files-processes/TUTOR.mdmarkdown7.8 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/atomicfile.goscript772 B
curriculum/content/focus/cli-tooling/files-processes/exercise/atomicfile_test.goscript2.6 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/exec.goscript3.8 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/exec_test.goscript10.7 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/go.modmanifest44 B
curriculum/content/focus/cli-tooling/files-processes/exercise/main.goscript1.9 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/paths.goscript1.6 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/paths_test.goscript3.1 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/signal.goscript1.6 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/signal_test.goscript1.6 KB
curriculum/content/focus/cli-tooling/files-processes/exercise/signal_unix_test.goscript2.4 KB
curriculum/content/focus/cli-tooling/files-processes/quiz.jsonconfig7.9 KB
curriculum/content/focus/cli-tooling/files-processes/solution/atomicfile.goscript2.1 KB
curriculum/content/focus/cli-tooling/files-processes/solution/exec.goscript5.4 KB
curriculum/content/focus/cli-tooling/files-processes/solution/paths.goscript2.2 KB
curriculum/content/focus/cli-tooling/files-processes/solution/signal.goscript2.1 KB
curriculum/content/focus/cli-tooling/flags-config/LESSON.mdmarkdown12.3 KB
curriculum/content/focus/cli-tooling/flags-config/TUTOR.mdmarkdown6.7 KB
curriculum/content/focus/cli-tooling/flags-config/exercise/config.goscript2.4 KB
curriculum/content/focus/cli-tooling/flags-config/exercise/config_test.goscript3.1 KB
curriculum/content/focus/cli-tooling/flags-config/exercise/flagvalue.goscript769 B
curriculum/content/focus/cli-tooling/flags-config/exercise/flagvalue_test.goscript1.9 KB
curriculum/content/focus/cli-tooling/flags-config/exercise/go.modmanifest41 B
curriculum/content/focus/cli-tooling/flags-config/exercise/loader.goscript5.5 KB
curriculum/content/focus/cli-tooling/flags-config/exercise/loader_test.goscript12.4 KB
curriculum/content/focus/cli-tooling/flags-config/exercise/main.goscript1.2 KB
curriculum/content/focus/cli-tooling/flags-config/quiz.jsonconfig5.3 KB
curriculum/content/focus/cli-tooling/flags-config/solution/config.goscript3.2 KB
curriculum/content/focus/cli-tooling/flags-config/solution/flagvalue.goscript957 B
curriculum/content/focus/cli-tooling/flags-config/solution/loader.goscript9.0 KB
curriculum/content/focus/cli-tooling/terminal-ux/LESSON.mdmarkdown14.8 KB
curriculum/content/focus/cli-tooling/terminal-ux/TUTOR.mdmarkdown6.2 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/color.goscript1.6 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/color_test.goscript2.3 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/go.modmanifest40 B
curriculum/content/focus/cli-tooling/terminal-ux/exercise/main.goscript3.6 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/progress.goscript1.9 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/progress_test.goscript1.9 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/prompt.goscript2.3 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/prompt_test.goscript4.7 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/render.goscript3.8 KB
curriculum/content/focus/cli-tooling/terminal-ux/exercise/render_test.goscript6.1 KB
curriculum/content/focus/cli-tooling/terminal-ux/quiz.jsonconfig5.9 KB
curriculum/content/focus/cli-tooling/terminal-ux/solution/color.goscript1.8 KB
curriculum/content/focus/cli-tooling/terminal-ux/solution/progress.goscript2.0 KB
curriculum/content/focus/cli-tooling/terminal-ux/solution/prompt.goscript2.2 KB
curriculum/content/focus/cli-tooling/terminal-ux/solution/render.goscript4.3 KB
curriculum/content/focus/containers/capstone/LESSON.mdmarkdown20.0 KB
curriculum/content/focus/containers/capstone/TUTOR.mdmarkdown6.7 KB
curriculum/content/focus/containers/capstone/exercise/.dockerignoreother190 B
curriculum/content/focus/containers/capstone/exercise/.github/workflows/release.ymlconfig2.4 KB
curriculum/content/focus/containers/capstone/exercise/Dockerfileother903 B
curriculum/content/focus/containers/capstone/exercise/RUNBOOK.mdmarkdown1.6 KB
curriculum/content/focus/containers/capstone/exercise/check.shscript62.6 KB
curriculum/content/focus/containers/capstone/exercise/deploy/base/deployment.yamlconfig2.8 KB
curriculum/content/focus/containers/capstone/exercise/deploy/base/kustomization.yamlconfig845 B
curriculum/content/focus/containers/capstone/exercise/deploy/base/service.yamlconfig316 B
curriculum/content/focus/containers/capstone/exercise/deploy/overlays/dev/kustomization.yamlconfig1.3 KB
curriculum/content/focus/containers/capstone/exercise/deploy/overlays/dev/resources-patch.yamlconfig906 B
curriculum/content/focus/containers/capstone/exercise/deploy/overlays/prod/kustomization.yamlconfig899 B
curriculum/content/focus/containers/capstone/exercise/deploy/overlays/prod/resources-patch.yamlconfig341 B
curriculum/content/focus/containers/capstone/exercise/go.modmanifest48 B
curriculum/content/focus/containers/capstone/exercise/main.goscript6.4 KB
curriculum/content/focus/containers/capstone/quiz.jsonconfig6.5 KB
curriculum/content/focus/containers/capstone/solution/.github/workflows/release.ymlconfig6.4 KB
curriculum/content/focus/containers/capstone/solution/Dockerfileother1.2 KB
curriculum/content/focus/containers/capstone/solution/RUNBOOK.mdmarkdown7.7 KB
curriculum/content/focus/containers/capstone/solution/deploy/overlays/prod/kustomization.yamlconfig1.4 KB
curriculum/content/focus/containers/capstone/solution/deploy/overlays/prod/resources-patch.yamlconfig1.1 KB
curriculum/content/focus/containers/compose/LESSON.mdmarkdown13.5 KB
curriculum/content/focus/containers/compose/TUTOR.mdmarkdown5.2 KB
curriculum/content/focus/containers/compose/exercise/.env.exampleother348 B
curriculum/content/focus/containers/compose/exercise/app/Dockerfileother962 B
curriculum/content/focus/containers/compose/exercise/app/go.modmanifest40 B
curriculum/content/focus/containers/compose/exercise/app/main.goscript2.2 KB
curriculum/content/focus/containers/compose/exercise/check.shscript24.5 KB
curriculum/content/focus/containers/compose/exercise/compose.yamlconfig877 B
curriculum/content/focus/containers/compose/quiz.jsonconfig4.5 KB
curriculum/content/focus/containers/compose/solution/.envconfig203 B
curriculum/content/focus/containers/compose/solution/compose.yamlconfig1.6 KB
curriculum/content/focus/containers/deploying-go/LESSON.mdmarkdown21.1 KB
curriculum/content/focus/containers/deploying-go/TUTOR.mdmarkdown6.5 KB
curriculum/content/focus/containers/deploying-go/exercise/.dockerignoreother150 B
curriculum/content/focus/containers/deploying-go/exercise/Dockerfileother851 B
curriculum/content/focus/containers/deploying-go/exercise/SHUTDOWN.mdmarkdown1.4 KB
curriculum/content/focus/containers/deploying-go/exercise/check.shscript43.5 KB
curriculum/content/focus/containers/deploying-go/exercise/configmap.yamlconfig526 B
curriculum/content/focus/containers/deploying-go/exercise/deployment.yamlconfig2.5 KB
curriculum/content/focus/containers/deploying-go/exercise/go.modmanifest41 B
curriculum/content/focus/containers/deploying-go/exercise/main.goscript6.1 KB
curriculum/content/focus/containers/deploying-go/exercise/service.yamlconfig347 B
curriculum/content/focus/containers/deploying-go/exercise/shutdown_test.goscript3.3 KB
curriculum/content/focus/containers/deploying-go/quiz.jsonconfig6.5 KB
curriculum/content/focus/containers/deploying-go/solution/SHUTDOWN.mdmarkdown5.4 KB
curriculum/content/focus/containers/deploying-go/solution/configmap.yamlconfig541 B
curriculum/content/focus/containers/deploying-go/solution/deployment.yamlconfig4.0 KB
curriculum/content/focus/containers/deploying-go/solution/main.goscript6.1 KB
curriculum/content/focus/containers/docker-fundamentals/LESSON.mdmarkdown14.4 KB
curriculum/content/focus/containers/docker-fundamentals/TUTOR.mdmarkdown5.4 KB
curriculum/content/focus/containers/docker-fundamentals/exercise/Dockerfileother261 B
curriculum/content/focus/containers/docker-fundamentals/exercise/NOTES.mdmarkdown1.4 KB
curriculum/content/focus/containers/docker-fundamentals/exercise/check.shscript10.7 KB
curriculum/content/focus/containers/docker-fundamentals/exercise/go.modmanifest38 B
curriculum/content/focus/containers/docker-fundamentals/exercise/local.envconfig218 B
curriculum/content/focus/containers/docker-fundamentals/exercise/main.goscript780 B
curriculum/content/focus/containers/docker-fundamentals/exercise/scratch/notes.mdmarkdown153 B
curriculum/content/focus/containers/docker-fundamentals/quiz.jsonconfig5.5 KB
curriculum/content/focus/containers/docker-fundamentals/solution/.dockerignoreother230 B
curriculum/content/focus/containers/docker-fundamentals/solution/Dockerfileother504 B
curriculum/content/focus/containers/docker-fundamentals/solution/NOTES.mdmarkdown3.8 KB
curriculum/content/focus/containers/dockerizing-go/LESSON.mdmarkdown14.0 KB
curriculum/content/focus/containers/dockerizing-go/TUTOR.mdmarkdown5.4 KB
curriculum/content/focus/containers/dockerizing-go/exercise/.dockerignoreother143 B
curriculum/content/focus/containers/dockerizing-go/exercise/Dockerfile.naiveother512 B
curriculum/content/focus/containers/dockerizing-go/exercise/NOTES.mdmarkdown1.1 KB
curriculum/content/focus/containers/dockerizing-go/exercise/check.shscript14.2 KB
curriculum/content/focus/containers/dockerizing-go/exercise/go.modmanifest43 B
curriculum/content/focus/containers/dockerizing-go/exercise/go.summanifest0 B
curriculum/content/focus/containers/dockerizing-go/exercise/main.goscript1.7 KB
curriculum/content/focus/containers/dockerizing-go/quiz.jsonconfig4.5 KB
curriculum/content/focus/containers/dockerizing-go/solution/Dockerfileother755 B
curriculum/content/focus/containers/dockerizing-go/solution/NOTES.mdmarkdown2.7 KB
curriculum/content/focus/containers/helm-kustomize/LESSON.mdmarkdown19.1 KB
curriculum/content/focus/containers/helm-kustomize/TUTOR.mdmarkdown9.5 KB
curriculum/content/focus/containers/helm-kustomize/exercise/NOTES.mdmarkdown1.5 KB
curriculum/content/focus/containers/helm-kustomize/exercise/chart/Chart.yamlconfig518 B
curriculum/content/focus/containers/helm-kustomize/exercise/chart/templates/_helpers.tplother1.8 KB
curriculum/content/focus/containers/helm-kustomize/exercise/chart/templates/configmap.yamlconfig392 B
curriculum/content/focus/containers/helm-kustomize/exercise/chart/templates/deployment.yamlconfig3.2 KB
curriculum/content/focus/containers/helm-kustomize/exercise/chart/templates/service.yamlconfig512 B
curriculum/content/focus/containers/helm-kustomize/exercise/chart/values.yamlconfig1.4 KB
curriculum/content/focus/containers/helm-kustomize/exercise/check.shscript55.4 KB
curriculum/content/focus/containers/helm-kustomize/exercise/kustomize/base/deployment.yamlconfig2.1 KB
curriculum/content/focus/containers/helm-kustomize/exercise/kustomize/base/kustomization.yamlconfig798 B
curriculum/content/focus/containers/helm-kustomize/exercise/kustomize/base/service.yamlconfig347 B
curriculum/content/focus/containers/helm-kustomize/exercise/kustomize/overlays/dev/kustomization.yamlconfig616 B
curriculum/content/focus/containers/helm-kustomize/exercise/kustomize/overlays/dev/resources-patch.yamlconfig506 B
curriculum/content/focus/containers/helm-kustomize/exercise/kustomize/overlays/prod/kustomization.yamlconfig477 B
curriculum/content/focus/containers/helm-kustomize/exercise/kustomize/overlays/prod/resources-patch.yamlconfig614 B
curriculum/content/focus/containers/helm-kustomize/quiz.jsonconfig7.4 KB
curriculum/content/focus/containers/helm-kustomize/solution/NOTES.mdmarkdown3.3 KB
curriculum/content/focus/containers/helm-kustomize/solution/chart/Chart.yamlconfig366 B
curriculum/content/focus/containers/helm-kustomize/solution/chart/templates/configmap.yamlconfig547 B
curriculum/content/focus/containers/helm-kustomize/solution/chart/templates/deployment.yamlconfig2.5 KB
curriculum/content/focus/containers/helm-kustomize/solution/chart/values.yamlconfig1.2 KB
curriculum/content/focus/containers/helm-kustomize/solution/kustomize/base/kustomization.yamlconfig915 B
curriculum/content/focus/containers/helm-kustomize/solution/kustomize/overlays/dev/kustomization.yamlconfig820 B
curriculum/content/focus/containers/helm-kustomize/solution/kustomize/overlays/dev/resources-patch.yamlconfig515 B
curriculum/content/focus/containers/helm-kustomize/solution/kustomize/overlays/prod/kustomization.yamlconfig267 B
curriculum/content/focus/containers/helm-kustomize/solution/kustomize/overlays/prod/resources-patch.yamlconfig649 B
curriculum/content/focus/containers/kubernetes-config/LESSON.mdmarkdown19.4 KB
curriculum/content/focus/containers/kubernetes-config/TUTOR.mdmarkdown6.3 KB
curriculum/content/focus/containers/kubernetes-config/exercise/NOTES.mdmarkdown1.3 KB
curriculum/content/focus/containers/kubernetes-config/exercise/app/Dockerfileother1.0 KB

curriculum/content/focus/cli-tooling/flags-config/exercise/loader_test.go

View on GitHub
package main

import (
	"bytes"
	"errors"
	"flag"
	"io"
	"io/fs"
	"os"
	"path/filepath"
	"reflect"
	"strings"
	"testing"
	"time"
)

const fileJSON = `{
  "endpoint": "https://file.example",
  "timeout": "1s",
  "retries": 1,
  "verbose": true,
  "tags": ["file-a", "file-b"]
}`

func writeConfig(t *testing.T, body string) string {
	t.Helper()
	path := filepath.Join(t.TempDir(), "toolkit.json")
	if err := os.WriteFile(path, []byte(body), 0o600); err != nil {
		t.Fatalf("writing config file: %v", err)
	}
	return path
}

// envFrom builds a LookupEnv function over a map, so no test ever depends on
// (or disturbs) the real process environment.
func envFrom(vars map[string]string) func(string) (string, bool) {
	return func(key string) (string, bool) {
		v, ok := vars[key]
		return v, ok
	}
}

func fullEnv() map[string]string {
	return map[string]string{
		"TOOLKIT_ENDPOINT": "https://env.example",
		"TOOLKIT_TIMEOUT":  "2s",
		"TOOLKIT_RETRIES":  "2",
		"TOOLKIT_VERBOSE":  "false",
		"TOOLKIT_TAGS":     "env-a, env-b",
	}
}

func fullArgs() []string {
	return []string{
		"-endpoint", "https://flag.example",
		"-timeout", "3s",
		"-retries", "4",
		"-verbose=true",
		"-tag", "flag-a",
		"-tag", "flag-b",
	}
}

func TestLoadPrecedence(t *testing.T) {
	cases := []struct {
		name        string
		withFile    bool
		env         map[string]string
		args        []string
		want        Config
		wantOrigins map[string]Source
	}{
		{
			name: "defaults when nothing else is present",
			want: Config{
				Endpoint: "https://api.example.com",
				Timeout:  5 * time.Second,
				Retries:  3,
			},
			wantOrigins: map[string]Source{
				"endpoint": SourceDefault, "timeout": SourceDefault,
				"retries": SourceDefault, "verbose": SourceDefault,
				"tags": SourceDefault,
			},
		},
		{
			name:     "config file beats defaults",
			withFile: true,
			want: Config{
				Endpoint: "https://file.example",
				Timeout:  time.Second,
				Retries:  1,
				Verbose:  true,
				Tags:     []string{"file-a", "file-b"},
			},
			wantOrigins: map[string]Source{
				"endpoint": SourceFile, "timeout": SourceFile,
				"retries": SourceFile, "verbose": SourceFile,
				"tags": SourceFile,
			},
		},
		{
			name: "environment beats defaults",
			env:  fullEnv(),
			want: Config{
				Endpoint: "https://env.example",
				Timeout:  2 * time.Second,
				Retries:  2,
				Verbose:  false,
				Tags:     []string{"env-a", "env-b"},
			},
			wantOrigins: map[string]Source{
				"endpoint": SourceEnv, "timeout": SourceEnv,
				"retries": SourceEnv, "verbose": SourceEnv,
				"tags": SourceEnv,
			},
		},
		{
			name: "flags beat defaults",
			args: fullArgs(),
			want: Config{
				Endpoint: "https://flag.example",
				Timeout:  3 * time.Second,
				Retries:  4,
				Verbose:  true,
				Tags:     []string{"flag-a", "flag-b"},
			},
			wantOrigins: map[string]Source{
				"endpoint": SourceFlag, "timeout": SourceFlag,
				"retries": SourceFlag, "verbose": SourceFlag,
				"tags": SourceFlag,
			},
		},
		{
			name:     "environment beats the config file",
			withFile: true,
			env: map[string]string{
				"TOOLKIT_ENDPOINT": "https://env.example",
				"TOOLKIT_RETRIES":  "2",
			},
			want: Config{
				Endpoint: "https://env.example",
				Timeout:  time.Second,
				Retries:  2,
				Verbose:  true,
				Tags:     []string{"file-a", "file-b"},
			},
			wantOrigins: map[string]Source{
				"endpoint": SourceEnv, "timeout": SourceFile,
				"retries": SourceEnv, "verbose": SourceFile,
				"tags": SourceFile,
			},
		},
		{
			name:     "flags beat the environment and the config file",
			withFile: true,
			env:      fullEnv(),
			args:     []string{"-timeout", "3s", "-verbose=true"},
			want: Config{
				Endpoint: "https://env.example",
				Timeout:  3 * time.Second,
				Retries:  2,
				Verbose:  true,
				Tags:     []string{"env-a", "env-b"},
			},
			wantOrigins: map[string]Source{
				"endpoint": SourceEnv, "timeout": SourceFlag,
				"retries": SourceEnv, "verbose": SourceFlag,
				"tags": SourceEnv,
			},
		},
		{
			name: "a value equal to the default still records its real origin",
			env:  map[string]string{"TOOLKIT_RETRIES": "3"},
			want: Config{
				Endpoint: "https://api.example.com",
				Timeout:  5 * time.Second,
				Retries:  3,
			},
			wantOrigins: map[string]Source{
				"endpoint": SourceDefault, "timeout": SourceDefault,
				"retries": SourceEnv, "verbose": SourceDefault,
				"tags": SourceDefault,
			},
		},
	}

	for _, c := range cases {
		t.Run(c.name, func(t *testing.T) {
			loader := Loader{
				Args:      c.args,
				LookupEnv: envFrom(c.env),
				Stderr:    io.Discard,
			}
			if c.withFile {
				loader.ConfigPath = writeConfig(t, fileJSON)
			}

			res, err := loader.Load()
			if err != nil {
				t.Fatalf("Load() = %v, want nil", err)
			}
			if !reflect.DeepEqual(res.Config, c.want) {
				t.Errorf("Config =\n  %+v\nwant\n  %+v", res.Config, c.want)
			}
			if !reflect.DeepEqual(res.Origins, c.wantOrigins) {
				t.Errorf("Origins = %v, want %v", res.Origins, c.wantOrigins)
			}
		})
	}
}

func TestLoadFlagCountsOnlyWhenPresent(t *testing.T) {
	path := writeConfig(t, `{"verbose": true, "retries": 7}`)

	// -verbose=false and -retries=0 carry the zero value, but they were typed,
	// so they must win over the config file.
	res, err := Loader{
		Args:       []string{"-verbose=false", "-retries=0"},
		ConfigPath: path,
		Stderr:     io.Discard,
	}.Load()
	if err != nil {
		t.Fatalf("Load() = %v, want nil", err)
	}
	if res.Config.Verbose {
		t.Error("Verbose = true, want false: -verbose=false must beat the config file")
	}
	if res.Origins["verbose"] != SourceFlag {
		t.Errorf("Origins[verbose] = %v, want %v", res.Origins["verbose"], SourceFlag)
	}
	if res.Config.Retries != 0 {
		t.Errorf("Retries = %d, want 0: -retries=0 must beat the config file", res.Config.Retries)
	}
	if res.Origins["retries"] != SourceFlag {
		t.Errorf("Origins[retries] = %v, want %v", res.Origins["retries"], SourceFlag)
	}

	// Without the flags, the same file wins.
	res, err = Loader{ConfigPath: path, Stderr: io.Discard}.Load()
	if err != nil {
		t.Fatalf("Load() = %v, want nil", err)
	}
	if !res.Config.Verbose || res.Config.Retries != 7 {
		t.Errorf("Config = %+v, want verbose true and retries 7 from the file", res.Config)
	}
}

func TestLoadTagsReplaceLowerLayers(t *testing.T) {
	path := writeConfig(t, `{"tags": ["file-a", "file-b"]}`)

	res, err := Loader{
		Args:       []string{"-tag", "only"},
		LookupEnv:  envFrom(map[string]string{"TOOLKIT_TAGS": "env-a,env-b"}),
		ConfigPath: path,
		Stderr:     io.Discard,
	}.Load()
	if err != nil {
		t.Fatalf("Load() = %v, want nil", err)
	}
	want := []string{"only"}
	if !reflect.DeepEqual(res.Config.Tags, want) {
		t.Errorf("Tags = %v, want %v (a higher layer replaces the list, it does not append)",
			res.Config.Tags, want)
	}
}

func TestLoadConfigFileMissing(t *testing.T) {
	missing := filepath.Join(t.TempDir(), "absent.json")

	// A default path that does not exist is not an error: the tool must run
	// with no config file at all.
	res, err := Loader{ConfigPath: missing, Stderr: io.Discard}.Load()
	if err != nil {
		t.Fatalf("Load() with a missing default config = %v, want nil", err)
	}
	if res.Origins["retries"] != SourceDefault {
		t.Errorf("Origins[retries] = %v, want %v", res.Origins["retries"], SourceDefault)
	}

	// A file the user explicitly named is different: silence would hide a typo.
	_, err = Loader{Args: []string{"-config", missing}, Stderr: io.Discard}.Load()
	if !errors.Is(err, fs.ErrNotExist) {
		t.Fatalf("Load() with -config pointing at a missing file = %v, want fs.ErrNotExist", err)
	}
}

func TestLoadConfigFlagSelectsFile(t *testing.T) {
	fallback := writeConfig(t, `{"retries": 1}`)
	chosen := writeConfig(t, `{"retries": 9}`)

	res, err := Loader{
		Args:       []string{"-config", chosen},
		ConfigPath: fallback,
		Stderr:     io.Discard,
	}.Load()
	if err != nil {
		t.Fatalf("Load() = %v, want nil", err)
	}
	if res.Config.Retries != 9 {
		t.Errorf("Retries = %d, want 9 from the file named by -config", res.Config.Retries)
	}
}

func TestLoadConfigFileUnknownKey(t *testing.T) {
	path := writeConfig(t, `{"retires": 2}`)

	_, err := Loader{ConfigPath: path, Stderr: io.Discard}.Load()
	if err == nil {
		t.Fatal("Load() = nil, want an error: a misspelled key must not be ignored")
	}
	if !strings.Contains(err.Error(), "retires") {
		t.Errorf("error %q does not name the offending key %q", err, "retires")
	}
}

func TestLoadInvalidValues(t *testing.T) {
	cases := []struct {
		name       string
		file       string
		env        map[string]string
		args       []string
		wantField  string
		wantSource Source
		wantRaw    string
		wantCause  error
	}{
		{
			name:       "retries from the environment is not a number",
			env:        map[string]string{"TOOLKIT_RETRIES": "abc"},
			wantField:  "retries",
			wantSource: SourceEnv,
			wantRaw:    "abc",
		},
		{
			name:       "timeout from the environment is not a duration",
			env:        map[string]string{"TOOLKIT_TIMEOUT": "5 secs"},
			wantField:  "timeout",
			wantSource: SourceEnv,
			wantRaw:    "5 secs",
		},
		{
			name:       "verbose from the environment is not a bool",
			env:        map[string]string{"TOOLKIT_VERBOSE": "yes-please"},
			wantField:  "verbose",
			wantSource: SourceEnv,
			wantRaw:    "yes-please",
		},
		{
			name:       "tags from the environment contain an empty item",
			env:        map[string]string{"TOOLKIT_TAGS": "a,,b"},
			wantField:  "tags",
			wantSource: SourceEnv,
			wantCause:  ErrEmpty,
		},
		{
			name:       "endpoint from the environment is empty",
			env:        map[string]string{"TOOLKIT_ENDPOINT": ""},
			wantField:  "endpoint",
			wantSource: SourceEnv,
			wantCause:  ErrEmpty,
		},
		{
			name:       "timeout in the file is not a duration",
			file:       `{"timeout": "soon"}`,
			wantField:  "timeout",
			wantSource: SourceFile,
			wantRaw:    "soon",
		},
		{
			name:       "endpoint in the file uses the wrong scheme",
			file:       `{"endpoint": "ftp://files.example"}`,
			wantField:  "endpoint",
			wantSource: SourceFile,
			wantCause:  ErrScheme,
		},
		{
			name:       "timeout in the file is zero",
			file:       `{"timeout": "0s"}`,
			wantField:  "timeout",
			wantSource: SourceFile,
			wantCause:  ErrRange,
		},
		{
			name:       "retries in the file is negative",
			file:       `{"retries": -1}`,
			wantField:  "retries",
			wantSource: SourceFile,
			wantCause:  ErrRange,
		},
		{
			name:       "retries flag is above the limit",
			args:       []string{"-retries", "11"},
			wantField:  "retries",
			wantSource: SourceFlag,
			wantCause:  ErrRange,
		},
	}

	for _, c := range cases {
		t.Run(c.name, func(t *testing.T) {
			loader := Loader{
				Args:      c.args,
				LookupEnv: envFrom(c.env),
				Stderr:    io.Discard,
			}
			if c.file != "" {
				loader.ConfigPath = writeConfig(t, c.file)
			}

			_, err := loader.Load()
			var ve *ValueError
			if !errors.As(err, &ve) {
				t.Fatalf("Load() = %v, want a *ValueError", err)
			}
			if ve.Field != c.wantField {
				t.Errorf("Field = %q, want %q", ve.Field, c.wantField)
			}
			if ve.Source != c.wantSource {
				t.Errorf("Source = %v, want %v", ve.Source, c.wantSource)
			}
			if c.wantRaw != "" && ve.Raw != c.wantRaw {
				t.Errorf("Raw = %q, want %q", ve.Raw, c.wantRaw)
			}
			if c.wantCause != nil && !errors.Is(err, c.wantCause) {
				t.Errorf("errors.Is(%v, %v) = false, want true", err, c.wantCause)
			}
			if !strings.Contains(err.Error(), c.wantField) {
				t.Errorf("error %q does not name the setting %q", err, c.wantField)
			}
		})
	}
}

func TestLoadFlagParseErrorIsReturned(t *testing.T) {
	var stderr bytes.Buffer

	_, err := Loader{Args: []string{"-retries", "abc"}, Stderr: &stderr}.Load()
	if err == nil {
		t.Fatal("Load() = nil, want an error for a malformed flag")
	}
	if stderr.Len() == 0 {
		t.Error("nothing was written to Loader.Stderr; flag output must go to the injected writer")
	}
	if !strings.Contains(stderr.String(), "-retries") {
		t.Errorf("stderr %q does not mention the offending flag", stderr.String())
	}
}

func TestLoadUsage(t *testing.T) {
	var stderr bytes.Buffer

	_, err := Loader{Args: []string{"-h"}, Stderr: &stderr}.Load()
	if !errors.Is(err, flag.ErrHelp) {
		t.Fatalf("Load() with -h = %v, want flag.ErrHelp", err)
	}
	for _, want := range []string{
		"-endpoint", "-timeout", "-retries", "-verbose", "-tag", "-config",
		"TOOLKIT_ENDPOINT", "TOOLKIT_TIMEOUT", "TOOLKIT_RETRIES",
		"TOOLKIT_VERBOSE", "TOOLKIT_TAGS",
		"defaults < config file < environment < flags",
	} {
		if !strings.Contains(stderr.String(), want) {
			t.Errorf("usage output does not mention %q; got:\n%s", want, stderr.String())
		}
	}
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall