Better naming

Author: dgageot

AGENTS.md

@@ -86,7 +86,7 @@ The Go toolchain version comes from `go.mod` (`go 1.26.2`). Tests run with
     (mirrors how `/bin/sh` resolves duplicates).
   - `app_test.go::newTestApp(t, dir, args...)` — builds an `App` wired to
     byte buffers; pass `dir = ""` to use the real `os.Getwd`.
-- Tests construct `Taskfile` literals directly when a YAML round-trip
+- Tests construct `taskfile.Config` literals directly when a YAML round-trip
   isn't part of the contract under test — this is the preferred style
   for runner-level tests. Use `Parse` / `LoadWithIncludes` only when the
   YAML/AST behavior matters.
@@ -96,7 +96,7 @@ The Go toolchain version comes from `go.mod` (`go 1.26.2`). Tests run with
 
 ## Configuration
 
-- **`gogo.yaml`** — repo's own taskfile (the project eats its own dog food).
+- **`gogo.yaml`** — repo's own task file (the project eats its own dog food).
   Edit when changing dev workflows.
 - **`.golangci.yml`** — single source of truth for lint config; keep
   `gci.sections` in sync if the module path ever changes.
@@ -120,7 +120,7 @@ The Go toolchain version comes from `go.mod` (`go 1.26.2`). Tests run with
   decide whether `UnmarshalYAML` needs string-shorthand support, thread
   it through `Runner.run` in the right phase (deps → vars → requires →
   env → preconditions → up-to-date → cmds), and cover it with a literal
-  `Taskfile` test in `run_test.go` plus a `Parse`-based test in
+  `taskfile.Config` test in `run_test.go` plus a `Parse`-based test in
   `parse_test.go` if YAML shape matters.
 - **Touching env/var resolution**: respect the existing precedence
   (`BaseEnv` < task dotenv < task vars < task env) and the rule that

README.md

@@ -63,7 +63,7 @@ gogo -n build
 - **Concurrent dependencies** with automatic deduplication
 - **Variables** with template expansion and shell commands
 - **Dotenv** support (global and per-task)
-- **Includes** for splitting taskfiles across subdirectories
+- **Includes** for splitting task files across subdirectories
 - **Platform filtering** to restrict tasks to specific OS/arch
 - **Required variables** validation before execution
 - **1Password secrets** integration via `op://` references

app_test.go

@@ -20,7 +20,7 @@ func writeFile(t *testing.T, path, content string) {
 }
 
 // newTestApp builds an App wired to byte buffers, with Getwd pinned to dir.
-// Pass an empty dir to fall back to os.Getwd (useful for tests that don't need a taskfile).
+// Pass an empty dir to fall back to os.Getwd (useful for tests that don't need a task file).
 func newTestApp(t *testing.T, dir string, cliArgs ...string) (*App, *bytes.Buffer, *bytes.Buffer) {
 	t.Helper()
 	var stdout, stderr bytes.Buffer
@@ -45,7 +45,7 @@ func TestIsInternalTask(t *testing.T) {
 }
 
 func TestVisibleTaskNames(t *testing.T) {
-	tf := &taskfile.Taskfile{
+	tf := &taskfile.Config{
 		Tasks: map[string]taskfile.Task{
 			"build":       {},
 			"_internal":   {},
@@ -168,15 +168,15 @@ tasks:
 	assert.Equal(t, "build\ntest\n", stdout.String())
 }
 
-func TestAppCompleteSilentOnMissingTaskfile(t *testing.T) {
+func TestAppCompleteSilentOnMissingFile(t *testing.T) {
 	app, stdout, stderr := newTestApp(t, t.TempDir(), "--complete")
 
 	require.NoError(t, app.Run(t.Context()))
 	assert.Empty(t, stdout.String())
 	assert.Empty(t, stderr.String())
 }
 
-func TestAppListFailsWhenNoTaskfileFound(t *testing.T) {
+func TestAppListFailsWhenNoFileFound(t *testing.T) {
 	app, _, _ := newTestApp(t, t.TempDir(), "--list")
 
 	err := app.Run(t.Context())

docs/_data/nav.yml

@@ -7,8 +7,8 @@
 
 - section: Features
   items:
-    - title: Taskfile Syntax
-      url: /features/taskfile-syntax/
+    - title: Task File Syntax
+      url: /features/task-file-syntax/
     - title: Variables
       url: /features/variables/
     - title: Dependencies

docs/features/cli/index.md

@@ -51,6 +51,6 @@ gogo -w test
 gogo test -- -v -run TestFoo
 ```
 
-## Taskfile Discovery
+## Task File Discovery
 
-gogo walks up the directory tree to find the topmost directory containing a `gogo.yaml` file. This means you can run gogo from any subdirectory and it will find the root taskfile.
+gogo walks up the directory tree to find the topmost directory containing a `gogo.yaml` file. This means you can run gogo from any subdirectory and it will find the root task file.

docs/features/dotenv/index.md

@@ -55,10 +55,10 @@ DB_PASSWORD='s3cret'
 - Per-task dotenv values override global dotenv values
 - Existing environment variables are never overridden
 - Missing files are silently skipped
-- Global dotenv paths are relative to the taskfile directory
+- Global dotenv paths are relative to the task file directory
 - Per-task dotenv paths are relative to the task's working directory
 - `~/` is expanded to the home directory
 
 ## With Includes
 
-When using [includes](../includes/), each included taskfile can define its own `dotenv` files. Files are deduplicated by absolute path — the same `.env` file is never loaded twice.
+When using [includes](../includes/), each included task file can define its own `dotenv` files. Files are deduplicated by absolute path — the same `.env` file is never loaded twice.

docs/features/includes/index.md

@@ -4,7 +4,7 @@ title: Includes
 
 # Includes
 
-Split your taskfile into multiple files across subdirectories. Each included directory must contain its own `gogo.yaml`.
+Split your task file into multiple files across subdirectories. Each included directory must contain its own `gogo.yaml`.
 
 ## Basic Setup
 
@@ -54,4 +54,4 @@ gogo build      # resolves to backend:build
 
 ## Dotenv Deduplication
 
-Each included taskfile can define its own `dotenv` files. If multiple includes reference the same `.env` file (by absolute path), it's loaded only once.
+Each included task file can define its own `dotenv` files. If multiple includes reference the same `.env` file (by absolute path), it's loaded only once.

docs/features/sources-checksums/index.md

@@ -60,7 +60,7 @@ Patterns containing `**` are matched recursively across all subdirectories (hidd
 
 ## Checksum Storage
 
-Checksums are stored in `.gogo/checksum/` relative to the taskfile directory. You should add `.gogo/` to your `.gitignore`:
+Checksums are stored in `.gogo/checksum/` relative to the task file directory. You should add `.gogo/` to your `.gitignore`:
 
 ```
 # .gitignore

docs/features/taskfile-syntax/index.md docs/features/task-file-syntax/index.mddocs/features/taskfile-syntax/index.md renamed to docs/features/task-file-syntax/index.md

@@ -1,8 +1,8 @@
 ---
-title: Taskfile Syntax
+title: Task File Syntax
 ---
 
-# Taskfile Syntax
+# Task File Syntax
 
 gogo reads task definitions from a `gogo.yaml` file in the current directory.
 
@@ -11,7 +11,7 @@ gogo reads task definitions from a `gogo.yaml` file in the current directory.
 | Field | Type | Description |
 |-------|------|-------------|
 | `version` | string | Optional version identifier |
-| `includes` | list of strings | Subdirectories containing other taskfiles |
+| `includes` | list of strings | Subdirectories containing other task files |
 | `dotenv` | list of strings | Paths to `.env` files to load |
 | `vars` | map | Global variables |
 | `interval` | string | Default polling interval for watch mode (e.g. `500ms`) |

docs/features/variables/index.md

@@ -8,7 +8,7 @@ gogo supports variables that can be used in commands via `{{ "{{" }}.VAR}}` temp
 
 ## Global Variables
 
-Define variables at the top level of your taskfile:
+Define variables at the top level of your task file:
 
 ```yaml
 vars:
@@ -55,7 +55,7 @@ tasks:
 
 | Variable | Description |
 |----------|-------------|
-| `TASKFILE_DIR` | The working directory for the task (defaults to the taskfile directory) |
+| `TASK_FILE_DIR` | The working directory for the task (defaults to the task file directory) |
 | `CLI_ARGS` | Extra arguments passed after `--` |
 
 ## CLI Arguments
@@ -74,15 +74,15 @@ gogo test -- -v -run TestFoo
 
 ## Environment Variable Expansion
 
-Variables in the taskfile are expanded from environment variables using `{{ "{{" }}.VAR}}` syntax at parse time:
+Variables in the task file are expanded from environment variables using `{{ "{{" }}.VAR}}` syntax at parse time:
 
 ```yaml
 tasks:
   deploy:
     cmd: deploy --region {{ "{{" }}.AWS_REGION}}
 ```
 
-If `AWS_REGION` is set in the environment, it will be substituted before the taskfile is processed.
+If `AWS_REGION` is set in the environment, it will be substituted before the task file is processed.
 
 ## Task Environment