v3.16.0

Add package.json to allow users to install Task using npm

.gitignore

@@ -30,3 +30,4 @@ tags
 !/bin/.keep
 /testdata/vars/v1
 /tmp
+node_modules

.goreleaser.yml

@@ -17,6 +17,9 @@ build:
       goarch: 386
   env:
     - CGO_ENABLED=0
+  mod_timestamp: '{{ .CommitTimestamp }}'
+  flags:
+    - -trimpath
   ldflags:
     - -s -w # Don't set main.version.
 

CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## v3.16.0 - 2022-09-29
+
+- Add `npm` as new installation method: `npm i -g @go-task/cli`
+  ([#870](https://github.com/go-task/task/issues/870), [#871](https://github.com/go-task/task/pull/871), [npm package](https://www.npmjs.com/package/@go-task/cli)).
+- Add support to marking tasks and includes as internal, which will hide them
+  from `--list` and `--list-all`
+  ([#818](https://github.com/go-task/task/pull/818)).
+
+## v3.15.2 - 2022-09-08
+
+- Fix error when using variable in `env:` introduced in the previous release
+  ([#858](https://github.com/go-task/task/issues/858), [#866](https://github.com/go-task/task/pull/866)).
+- Fix handling of `CLI_ARGS` (`--`) in Bash completion
+  ([#863](https://github.com/go-task/task/pull/863)).
+- On zsh completion, add ability to replace `--list-all` with `--list` as
+  already possible on the Bash completion
+  ([#861](https://github.com/go-task/task/pull/861)).
+
+## v3.15.0 - 2022-09-03
+
+- Add new special variables `ROOT_DIR` and `TASKFILE_DIR`. This was a highly
+  requested feature
+  ([#215](https://github.com/go-task/task/issues/215), [#857](https://github.com/go-task/task/pull/857), [Documentation](https://taskfile.dev/api/#special-variables)).
+- Follow symlinks on `sources`
+  ([#826](https://github.com/go-task/task/issues/826), [#831](https://github.com/go-task/task/pull/831)).
+- Improvements and fixes to Bash completion
+  ([#835](https://github.com/go-task/task/pull/835), [#844](https://github.com/go-task/task/pull/844)).
+
 ## v3.14.1 - 2022-08-03
 
 - Always resolve relative include paths relative to the including Taskfile

README.md

@@ -10,6 +10,6 @@
   </p>
 
   <p>
-    See <a href="https://taskfile.dev">taskfile.dev</a> for the documentation.
+    <a href="https://taskfile.dev/installation/">Installation</a> | <a href="https://taskfile.dev/usage/">Documentation</a> | <a href="https://twitter.com/taskfiledev">Twitter</a> | <a href="https://discord.gg/6TY36E39UK">Discord</a>
   </p>
 </div>

Taskfile.yml

@@ -80,6 +80,24 @@ tasks:
     cmds:
       - goreleaser --snapshot --rm-dist
 
+  docs:changelog:
+    desc: Copy CHANGELOG.md to the documentation website
+    vars:
+      FILE: docs/docs/changelog.md
+    cmds:
+      - rm {{.FILE}}
+      - 'echo "---" >> {{.FILE}}'
+      - 'echo "slug: /changelog/" >> {{.FILE}}'
+      - 'echo "sidebar_position: 6" >> {{.FILE}}'
+      - 'echo "---" >> {{.FILE}}'
+      - 'echo "" >> {{.FILE}}'
+      - 'cat CHANGELOG.md >> {{.FILE}}'
+
+  npm:publish:
+    desc: Publish release to npm
+    cmds:
+      - npm publish --access=public
+
   packages:
     cmds:
       - echo '{{.GO_PACKAGES}}'

completion/bash/task.bash

@@ -1,26 +1,55 @@
-#!/bin/bash
+# vim: set tabstop=2 shiftwidth=2 expandtab:
 
-GO_TASK_PROGNAME=task
+_GO_TASK_COMPLETION_LIST_OPTION='--list-all'
 
-_go_task_completion()
+function _task()
 {
-  local cur
-  _get_comp_words_by_ref -n : cur
+  local cur prev words cword
+  _init_completion -n : || return
 
-  case "$cur" in
-  --*)
-    local options
-    options="$(_parse_help task)"
-    mapfile -t COMPREPLY < <(compgen -W "$options" -- "$cur")
+  # Check for `--` within command-line and quit or strip suffix.
+  local i
+  for i in "${!words[@]}"; do
+    if [ "${words[$i]}" == "--" ]; then
+      # Do not complete words following `--` passed to CLI_ARGS.
+      [ $cword -gt $i ] && return
+      # Remove the words following `--` to not put --list in CLI_ARGS.
+      words=( "${words[@]:0:$i}" )
+      break
+    fi
+  done
+
+  # Handle special arguments of options.
+  case "$prev" in
+    -d|--dir)
+      _filedir -d
+      return $?
     ;;
-  *)
-    local tasks
-    tasks="$($GO_TASK_PROGNAME --list-all 2> /dev/null | awk 'NR>1 { sub(/:$/,"",$2); print $2 }')"
-    mapfile -t COMPREPLY < <(compgen -W "$tasks" -- "$cur")
+    -t|--taskfile)
+      _filedir yaml || return $?
+      _filedir yml
+      return $?
+    ;;
+    -o|--output)
+      COMPREPLY=( $( compgen -W "interleaved group prefixed" -- $cur ) )
+      return 0
     ;;
   esac
 
+  # Handle normal options.
+  case "$cur" in
+    -*)
+      COMPREPLY=( $( compgen -W "$(_parse_help $1)" -- $cur ) )
+      return 0
+    ;;
+  esac
+
+  # Prepare task name completions.
+  local tasks=( $( "${words[@]}" --silent $_GO_TASK_COMPLETION_LIST_OPTION 2> /dev/null ) )
+  COMPREPLY=( $( compgen -W "${tasks[*]}" -- "$cur" ) )
+
+  # Post-process because task names might contain colons.
   __ltrim_colon_completions "$cur"
 }
 
-complete -F _go_task_completion $GO_TASK_PROGNAME
+complete -F _task task

completion/zsh/_task

@@ -3,6 +3,8 @@
 local context state state_descr line
 typeset -A opt_args
 
+_GO_TASK_COMPLETION_LIST_OPTION="${GO_TASK_COMPLETION_LIST_OPTION:---list-all}"
+
 # Listing commands from Taskfile.yml
 function __task_list() {
     local -a scripts cmd
@@ -27,7 +29,7 @@ function __task_list() {
     (( enabled )) || return 0
 
     scripts=()
-    for item in "${(@)${(f)$("${cmd[@]}" --list-all)}[2,-1]#\* }"; do
+    for item in "${(@)${(f)$("${cmd[@]}" $_GO_TASK_COMPLETION_LIST_OPTION)}[2,-1]#\* }"; do
         task="${item%%:[[:space:]]*}"
         desc="${item##[^[:space:]]##[[:space:]]##}"
         scripts+=( "${task//:/\\:}:$desc" )

docs/Taskfile.yml

@@ -9,9 +9,10 @@ tasks:
   start:
     desc: Start website
     vars:
+      HOST: '{{default "localhost" .HOST}}'
       PORT: '{{default "3001" .PORT}}'
     cmds:
-      - npx docusaurus start --no-open --port={{.PORT}}
+      - npx docusaurus start --no-open --host={{.HOST}} --port={{.PORT}}
 
   build:
     desc: Build website

docs/docs/api_reference.md

@@ -44,6 +44,19 @@ variable
 |      | `--version` | `bool` | `false` | Show Task version. |
 | `-w` | `--watch` | `bool` | `false` | Enables watch of the given task. |
 
+## Special Variables
+
+There are some special variables that is available on the templating system:
+
+| Var | Description |
+| - | - |
+| `CLI_ARGS` | Contain all extra arguments passed after `--` when calling Task through the CLI. |
+| `TASK` | The name of the current task. |
+| `ROOT_DIR` | The absolute path of the root Taskfile. |
+| `TASKFILE_DIR` | The absolute path of the included Taskfile. |
+| `CHECKSUM` | The checksum of the files listed in `sources`. Only available within the `status` prop and if method is set to `checksum`. |
+| `TIMESTAMP` | The date object of the greatest timestamp of the files listes in `sources`. Only available within the `status` prop and if method is set to `timestamp`. |
+
 ## ENV
 
 Some environment variables can be overriden to adjust Task behavior.
@@ -84,6 +97,7 @@ Some environment variables can be overriden to adjust Task behavior.
 | `taskfile` | `string` | | The path for the Taskfile or directory to be included. If a directory, Task will look for files named `Taskfile.yml` or `Taskfile.yaml` inside that directory. If a relative path, resolved relative to the directory containing the including Taskfile. |
 | `dir` | `string` | The parent Taskfile directory | The working directory of the included tasks when run. |
 | `optional` | `bool` | `false` | If `true`, no errors will be thrown if the specified file does not exist. |
+| `internal` | `bool` | `false` | If `true`, tasks will be omitted from both `--list` and `--list-all`. |
 
 :::info
 
@@ -106,6 +120,7 @@ includes:
 | `dir` | `string` | | The current directory which this task should run. |
 | `method` | `string` | `checksum` | Method used by this task. Default to the one declared globally or `checksum`. Available options: `checksum`, `timestamp` and `none` |
 | `silent` | `bool` | `false` | Skips some output for this task. Note that STDOUT and STDERR of the commands will still be redirected. |
+| `internal` | `bool` | `false` | If `true`, omit this task from both `--list` and `--list-all`. |
 | `run` | `string` | The one declared globally in the Taskfile or `always` | Specifies whether the task should run again or not if called more than once. Available options: `always`, `once` and `when_changed`. |
 | `prefix` | `string` | | Allows to override the prefix print before the STDOUT. Only relevant when using the `prefixed` output mode. |
 | `ignore_error` | `bool` | `false` | Continue execution if errors happen while executing the commands. |

docs/docs/changelog.md

@@ -5,6 +5,42 @@ sidebar_position: 6
 
 # Changelog
 
+## v3.16.0 - 2022-09-29
+
+- Add `npm` as new installation method: `npm i -g @go-task/cli`
+  ([#870](https://github.com/go-task/task/issues/870), [#871](https://github.com/go-task/task/pull/871), [npm package](https://www.npmjs.com/package/@go-task/cli)).
+- Add support to marking tasks and includes as internal, which will hide them
+  from `--list` and `--list-all`
+  ([#818](https://github.com/go-task/task/pull/818)).
+
+## v3.15.2 - 2022-09-08
+
+- Fix error when using variable in `env:` introduced in the previous release
+  ([#858](https://github.com/go-task/task/issues/858), [#866](https://github.com/go-task/task/pull/866)).
+- Fix handling of `CLI_ARGS` (`--`) in Bash completion
+  ([#863](https://github.com/go-task/task/pull/863)).
+- On zsh completion, add ability to replace `--list-all` with `--list` as
+  already possible on the Bash completion
+  ([#861](https://github.com/go-task/task/pull/861)).
+
+## v3.15.0 - 2022-09-03
+
+- Add new special variables `ROOT_DIR` and `TASKFILE_DIR`. This was a highly
+  requested feature
+  ([#215](https://github.com/go-task/task/issues/215), [#857](https://github.com/go-task/task/pull/857), [Documentation](https://taskfile.dev/api/#special-variables)).
+- Follow symlinks on `sources`
+  ([#826](https://github.com/go-task/task/issues/826), [#831](https://github.com/go-task/task/pull/831)).
+- Improvements and fixes to Bash completion
+  ([#835](https://github.com/go-task/task/pull/835), [#844](https://github.com/go-task/task/pull/844)).
+
+## v3.14.1 - 2022-08-03
+
+- Always resolve relative include paths relative to the including Taskfile
+  ([#822](https://github.com/go-task/task/issues/822), [#823](https://github.com/go-task/task/pull/823)).
+- Fix ZSH and PowerShell completions to consider all tasks instead of just the
+  public ones (those with descriptions)
+  ([#803](https://github.com/go-task/task/pull/803)).
+
 ## v3.14.0 - 2022-07-08
 
 - Add ability to override the `.task` directory location with the

docs/docs/community.md

@@ -46,8 +46,8 @@ Some installation methods are maintained by third party:
 
 - [GitHub Actions](https://github.com/arduino/setup-task)
   by [@arduino](https://github.com/arduino)
-- [AUR](https://aur.archlinux.org/packages/taskfile-git)
-  by [@kovetskiy](https://github.com/kovetskiy)
+- [AUR](https://aur.archlinux.org/packages/go-task-bin)
+  by [@carlsmedstad](https://github.com/carlsmedstad)
 - [Scoop](https://github.com/lukesampson/scoop-extras/blob/master/bucket/task.json)
 - [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)
 - [NixOS](https://github.com/NixOS/nixpkgs/blob/master/pkgs/development/tools/go-task/default.nix)

docs/docs/installation.md

@@ -55,15 +55,23 @@ may take some time until it's available on Scoop.
 ### AUR
 
 If you're on Arch Linux you can install Task from
-[AUR](https://aur.archlinux.org/packages/taskfile-git) using your favorite
+[AUR](https://aur.archlinux.org/packages/go-task-bin) using your favorite
 package manager such as `yay`, `pacaur` or `yaourt`:
 
 ```cmd
-yay -S taskfile-git
+yay -S go-task-bin
 ```
 
-This installation method is community owned, but since it's `-git` version of
-the package, it's always latest available version based on the Git repository.
+Alternatively, there's
+[this package](https://aur.archlinux.org/packages/go-task) which installs from
+the source code instead of downloading the binary from the
+[releases page](https://github.com/go-task/task/releases):
+
+```cmd
+yay -S go-task
+```
+
+This installation method is community owned.
 
 ### Fedora
 
@@ -89,6 +97,15 @@ nix-env -iA nixpkgs.go-task
 This installation method is community owned. After a new release of Task, it
 may take some time until it's available in [nixpkgs](https://github.com/NixOS/nixpkgs).
 
+### npm
+
+You can also use Node and npm to install Task by installing
+[this package](https://www.npmjs.com/package/@go-task/cli).
+
+```bash
+npm install -g @go-task/cli
+```
+
 ## Get The Binary
 
 ### Binary

docs/docs/intro.md

@@ -41,7 +41,7 @@ guide to check the full schema documentation and Task features.
   `$PATH` and you're done! Or you can also install using [Homebrew][homebrew],
   [Snapcraft][snapcraft], or [Scoop][scoop] if you want.
 - Available on CIs: by adding [this simple command](installation.md#install-script)
-  to install on your CI script and you're done to use Task as part of your CI pipeline;
+  to install on your CI script and you're ready to use Task as part of your CI pipeline;
 - Truly cross-platform: while most build tools only work well on Linux or macOS,
   Task also supports Windows thanks to [this shell interpreter for Go][sh].
 - Great for code generation: you can easily [prevent a task from running](/usage#prevent-unnecessary-work)

docs/docs/releasing.md

@@ -13,17 +13,25 @@ the `test-release` task of the Taskfile.
 artifacts automatically when a new Git tag is pushed to master
 (raw executables and DEB and RPM packages).
 
+Since v3.15.0, raw executables can also be reproduced and verified locally by
+checking out a specific tag and calling `goreleaser build`, using the Go version
+defined in the above GitHub Actions.
+
 # Homebrew
 
-To release a new version on the [Homebrew tap][homebrewtap] edit the
-[Formula/go-task.rb][gotaskrb] file, updating with the new version, download
-URL and sha256.
+Goreleaser will automatically push a new commit to the
+[Formula/go-task.rb][gotaskrb] file in the [Homebrew tap][homebrewtap]
+repository to release the new version.
+
+# npm
+
+To release to npm update the version in the [`package.json`][packagejson] file
+and then run `task npm:publish` to push it.
 
 # Snapcraft
 
-The exception is the publishing of a new version of the
-[snap package][snappackage]. This current require two steps after publishing
-the binaries:
+The [snap package][snappackage] requires to manual steps to release a new
+version:
 
 * Updating the current version on [snapcraft.yaml][snapcraftyaml].
 * Moving both `amd64`, `armhf` and `arm64` new artifacts to the stable channel on
@@ -31,9 +39,9 @@ the [Snapcraft dashboard][snapcraftdashboard].
 
 # Scoop
 
-Scoop is a community owned installation method. Scoop owners usually take care
-of updating versions there by editing
-[this file](https://github.com/lukesampson/scoop-extras/blob/master/bucket/task.json).
+Scoop is a command-line package manager for the Windows operating system.
+Scoop package manifests are maintained by the community.
+Scoop owners usually take care of updating versions there by editing [this file](https://github.com/lukesampson/scoop-extras/blob/master/bucket/task.json).
 If you think its Task version is outdated, open an issue to let us know.
 
 # Nix
@@ -46,6 +54,7 @@ If you think its Task version is outdated, open an issue to let us know.
 [goreleaser]: https://goreleaser.com/
 [homebrewtap]: https://github.com/go-task/homebrew-tap
 [gotaskrb]: https://github.com/go-task/homebrew-tap/blob/master/Formula/go-task.rb
+[packagejson]: https://github.com/go-task/task/blob/master/package.json#L3
 [snappackage]: https://github.com/go-task/snap
 [snapcraftyaml]: https://github.com/go-task/snap/blob/master/snap/snapcraft.yaml#L2
 [snapcraftdashboard]: https://snapcraft.io/task/releases

docs/docs/usage.md

@@ -194,6 +194,22 @@ tasks:
       - echo "This command can still be successfully executed if ./tests/Taskfile.yml does not exist"
 ```
 
+### Internal includes
+
+Includes marked as internal will set all the tasks of the included file to be
+internal as well (see the [Internal tasks](#internal-tasks) section below).
+This is useful when including utility tasks that are not intended to be used
+directly by the user.
+
+```yaml
+version: '3'
+
+includes:
+  tests:
+    taskfile: ./taskfiles/Utils.yml
+    internal: true
+```
+
 ### Vars of included Taskfiles
 
 You can also specify variables when including a Taskfile. This may be useful
@@ -223,6 +239,29 @@ use the [default function](https://go-task.github.io/slim-sprig/defaults.html):
 
 :::
 
+## Internal tasks
+
+Internal tasks are tasks that cannot be called directly by the user. They will
+not appear in the output when running `task --list|--list-all`. Other tasks may
+call internal tasks in the usual way. This is useful for creating reusable,
+function-like tasks that have no useful purpose on the command line.
+
+```yaml
+version: '3'
+
+tasks:
+  build-image-1:
+    cmds:
+      - task: build-image
+        vars:
+          DOCKER_IMAGE: image-1
+
+  build-image:
+    internal: true
+    cmds:
+      - docker build -t {{.DOCKER_IMAGE}} .
+```
+
 ## Task directory
 
 By default, tasks will be executed in the directory where the Taskfile is

docs/docusaurus.config.js

@@ -1,8 +1,8 @@
 // @ts-check
 // Note: type annotations allow type checking and IDEs autocompletion
 
-const lightCodeTheme = require('prism-react-renderer/themes/github');
-const darkCodeTheme = require('prism-react-renderer/themes/dracula');
+const lightCodeTheme = require('./src/themes/prismLight');
+const darkCodeTheme = require('./src/themes/prismDark');
 
 const GITHUB_URL = 'https://github.com/go-task/task';
 const TWITTER_URL = 'https://twitter.com/taskfiledev';

docs/src/css/custom.css

@@ -1,4 +1,9 @@
+@import url('https://fonts.googleapis.com/css2?family=Roboto+Mono:ital,wght@0,400;0,700;1,400;1,700&family=Roboto:ital,wght@0,400;0,700;1,400;1,700&display=swap');
+
 :root {
+  --ifm-font-family-base: Roboto, system-ui, -apple-system, Segoe UI, Ubuntu, Cantarell, Noto Sans, sans-serif, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+  --ifm-font-family-monospace: 'Roboto Mono', SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;
+
   --ifm-color-primary: #43ABA2 ;
   --ifm-color-primary-dark: #3AB2A6;
   --ifm-color-primary-darker: #32B8AB;
@@ -11,13 +16,6 @@
 }
 
 [data-theme='dark'] {
-  --ifm-color-primary: #43ABA2 ;
-  --ifm-color-primary-dark: #3AB2A6;
-  --ifm-color-primary-darker: #32B8AB;
-  --ifm-color-primary-darkest: #29BEB0;
-  --ifm-color-primary-light: #4CA59D;
-  --ifm-color-primary-lighter: #559F98;
-  --ifm-color-primary-lightest: #5D9993;
   --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
 }
 

docs/src/themes/prismDark.js

@@ -0,0 +1,79 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+const darkTheme = require('prism-react-renderer/themes/vsDark/index.cjs.js');
+
+module.exports = {
+  plain: {
+    color: '#D4D4D4',
+    backgroundColor: '#212121'
+  },
+  styles: [
+    ...darkTheme.styles,
+    {
+      types: ['title'],
+      style: {
+        color: '#569CD6',
+        fontWeight: 'bold'
+      }
+    },
+    {
+      types: ['property', 'parameter'],
+      style: {
+        color: '#9CDCFE'
+      }
+    },
+    {
+      types: ['script'],
+      style: {
+        color: '#D4D4D4'
+      }
+    },
+    {
+      types: ['boolean', 'arrow', 'atrule', 'tag'],
+      style: {
+        color: '#569CD6'
+      }
+    },
+    {
+      types: ['number', 'color', 'unit'],
+      style: {
+        color: '#B5CEA8'
+      }
+    },
+    {
+      types: ['font-matter'],
+      style: {
+        color: '#CE9178'
+      }
+    },
+    {
+      types: ['keyword', 'rule'],
+      style: {
+        color: '#C586C0'
+      }
+    },
+    {
+      types: ['regex'],
+      style: {
+        color: '#D16969'
+      }
+    },
+    {
+      types: ['maybe-class-name'],
+      style: {
+        color: '#4EC9B0'
+      }
+    },
+    {
+      types: ['constant'],
+      style: {
+        color: '#4FC1FF'
+      }
+    }
+  ]
+};

docs/src/themes/prismLight.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+const lightTheme = require('prism-react-renderer/themes/github/index.cjs.js');
+
+module.exports = {
+  ...lightTheme,
+  styles: [
+    ...lightTheme.styles,
+    {
+      types: ['title'],
+      style: {
+        color: '#0550AE',
+        fontWeight: 'bold'
+      }
+    },
+    {
+      types: ['parameter'],
+      style: {
+        color: '#953800'
+      }
+    },
+    {
+      types: ['boolean', 'rule', 'color', 'number', 'constant', 'property'],
+      style: {
+        color: '#005CC5'
+      }
+    },
+    {
+      types: ['atrule', 'tag'],
+      style: {
+        color: '#22863A'
+      }
+    },
+    {
+      types: ['script'],
+      style: {
+        color: '#24292E'
+      }
+    },
+    {
+      types: ['operator', 'unit', 'rule'],
+      style: {
+        color: '#D73A49'
+      }
+    },
+    {
+      types: ['font-matter', 'string', 'attr-value'],
+      style: {
+        color: '#C6105F'
+      }
+    },
+    {
+      types: ['class-name'],
+      style: {
+        color: '#116329'
+      }
+    },
+    {
+      types: ['attr-name'],
+      style: {
+        color: '#0550AE'
+      }
+    },
+    {
+      types: ['keyword'],
+      style: {
+        color: '#CF222E'
+      }
+    },
+    {
+      types: ['function'],
+      style: {
+        color: '#8250DF'
+      }
+    },
+    {
+      types: ['selector'],
+      style: {
+        color: '#6F42C1'
+      }
+    },
+    {
+      types: ['variable'],
+      style: {
+        color: '#E36209'
+      }
+    },
+    {
+      types: ['comment'],
+      style: {
+        color: '#6B6B6B'
+      }
+    }
+  ]
+};

docs/static/js/carbon.js

@@ -1,6 +1,6 @@
 (function () {
   function attachAd() {
-    const el = document.createElement('script');
+    var el = document.createElement('script');
     el.setAttribute('type', 'text/javascript');
     el.setAttribute('id', '_carbonads_js');
     el.setAttribute(
@@ -9,7 +9,7 @@
     );
     el.setAttribute('async', 'async');
 
-    const wrapper = document.getElementById('sidebar-ads');
+    var wrapper = document.getElementById('sidebar-ads');
     wrapper.innerHTML = '';
     wrapper.appendChild(el);
   }
@@ -17,8 +17,13 @@
   setTimeout(function () {
     attachAd();
 
-    window.addEventListener('popstate', function () {
-      attachAd();
-    });
+    var currentPath = window.location.pathname;
+
+    setInterval(function () {
+      if (currentPath !== window.location.pathname) {
+        currentPath = window.location.pathname;
+        attachAd();
+      }
+    }, 1000);
   }, 1000);
 })();

errors.go

@@ -17,7 +17,15 @@ type taskNotFoundError struct {
 }
 
 func (err *taskNotFoundError) Error() string {
-	return fmt.Sprintf(`task: Task "%s" not found`, err.taskName)
+	return fmt.Sprintf(`task: Task %q not found`, err.taskName)
+}
+
+type taskInternalError struct {
+	taskName string
+}
+
+func (err *taskInternalError) Error() string {
+	return fmt.Sprintf(`task: Task "%s" is internal`, err.taskName)
 }
 
 type TaskRunError struct {
@@ -26,7 +34,7 @@ type TaskRunError struct {
 }
 
 func (err *TaskRunError) Error() string {
-	return fmt.Sprintf(`task: Failed to run task "%s": %v`, err.taskName, err.err)
+	return fmt.Sprintf(`task: Failed to run task %q: %v`, err.taskName, err.err)
 }
 
 func (err *TaskRunError) ExitCode() int {
@@ -46,7 +54,7 @@ type MaximumTaskCallExceededError struct {
 
 func (e *MaximumTaskCallExceededError) Error() string {
 	return fmt.Sprintf(
-		`task: maximum task call exceeded (%d) for task "%s": probably an cyclic dep or infinite loop`,
+		`task: maximum task call exceeded (%d) for task %q: probably an cyclic dep or infinite loop`,
 		MaximumTaskCall,
 		e.task,
 	)

help.go

@@ -52,7 +52,9 @@ func (e *Executor) printTasks(listAll bool) {
 func (e *Executor) allTaskNames() (tasks []*taskfile.Task) {
 	tasks = make([]*taskfile.Task, 0, len(e.Taskfile.Tasks))
 	for _, task := range e.Taskfile.Tasks {
-		tasks = append(tasks, task)
+		if !task.Internal {
+			tasks = append(tasks, task)
+		}
 	}
 	sort.Slice(tasks, func(i, j int) bool { return tasks[i].Task < tasks[j].Task })
 	return
@@ -61,7 +63,7 @@ func (e *Executor) allTaskNames() (tasks []*taskfile.Task) {
 func (e *Executor) tasksWithDesc() (tasks []*taskfile.Task) {
 	tasks = make([]*taskfile.Task, 0, len(e.Taskfile.Tasks))
 	for _, task := range e.Taskfile.Tasks {
-		if task.Desc != "" {
+		if !task.Internal && task.Desc != "" {
 			compiledTask, err := e.FastCompiledTask(taskfile.Call{Task: task.Task})
 			if err == nil {
 				task = compiledTask
@@ -92,7 +94,7 @@ func (e *Executor) ListTaskNames(allTasks bool) {
 	// create a string slice from all map values (*taskfile.Task)
 	s := make([]string, 0, len(e.Taskfile.Tasks))
 	for _, t := range e.Taskfile.Tasks {
-		if allTasks || t.Desc != "" {
+		if (allTasks || t.Desc != "") && !t.Internal {
 			s = append(s, strings.TrimRight(t.Task, ":"))
 		}
 	}

init.go

@@ -4,7 +4,8 @@ import (
 	"fmt"
 	"io"
 	"os"
-	"path/filepath"
+
+	"github.com/go-task/task/v3/internal/filepathext"
 )
 
 const defaultTaskfile = `# https://taskfile.dev
@@ -23,13 +24,13 @@ tasks:
 
 // InitTaskfile Taskfile creates a new Taskfile
 func InitTaskfile(w io.Writer, dir string) error {
-	f := filepath.Join(dir, "Taskfile.yaml")
+	f := filepathext.SmartJoin(dir, "Taskfile.yaml")
 
 	if _, err := os.Stat(f); err == nil {
 		return ErrTaskfileAlreadyExists
 	}
 
-	if err := os.WriteFile(f, []byte(defaultTaskfile), 0644); err != nil {
+	if err := os.WriteFile(f, []byte(defaultTaskfile), 0o644); err != nil {
 		return err
 	}
 	fmt.Fprintf(w, "Taskfile.yaml created in the current directory\n")

internal/compiler/v3/compiler_v3.go

@@ -4,12 +4,12 @@ import (
 	"bytes"
 	"context"
 	"fmt"
-	"path/filepath"
 	"strings"
 	"sync"
 
 	"github.com/go-task/task/v3/internal/compiler"
 	"github.com/go-task/task/v3/internal/execext"
+	"github.com/go-task/task/v3/internal/filepathext"
 	"github.com/go-task/task/v3/internal/logger"
 	"github.com/go-task/task/v3/internal/templater"
 	"github.com/go-task/task/v3/taskfile"
@@ -44,7 +44,13 @@ func (c *CompilerV3) FastGetVariables(t *taskfile.Task, call taskfile.Call) (*ta
 func (c *CompilerV3) getVariables(t *taskfile.Task, call *taskfile.Call, evaluateShVars bool) (*taskfile.Vars, error) {
 	result := compiler.GetEnviron()
 	if t != nil {
-		result.Set("TASK", taskfile.Var{Static: t.Task})
+		specialVars, err := c.getSpecialVars(t)
+		if err != nil {
+			return nil, err
+		}
+		for k, v := range specialVars {
+			result.Set(k, taskfile.Var{Static: v})
+		}
 	}
 
 	getRangeFunc := func(dir string) func(k string, v taskfile.Var) error {
@@ -83,9 +89,7 @@ func (c *CompilerV3) getVariables(t *taskfile.Task, call *taskfile.Call, evaluat
 		if err := tr.Err(); err != nil {
 			return nil, err
 		}
-		if !filepath.IsAbs(dir) {
-			dir = filepath.Join(c.Dir, dir)
-		}
+		dir = filepathext.SmartJoin(c.Dir, dir)
 		taskRangeFunc = getRangeFunc(dir)
 	}
 
@@ -167,3 +171,23 @@ func (c *CompilerV3) ResetCache() {
 
 	c.dynamicCache = nil
 }
+
+func (c *CompilerV3) getSpecialVars(t *taskfile.Task) (map[string]string, error) {
+	taskfileDir, err := c.getTaskfileDir(t)
+	if err != nil {
+		return nil, err
+	}
+
+	return map[string]string{
+		"TASK":         t.Task,
+		"ROOT_DIR":     c.Dir,
+		"TASKFILE_DIR": taskfileDir,
+	}, nil
+}
+
+func (c *CompilerV3) getTaskfileDir(t *taskfile.Task) (string, error) {
+	if t.IncludedTaskfile != nil {
+		return t.IncludedTaskfile.FullDirPath()
+	}
+	return c.Dir, nil
+}

internal/execext/exec.go

@@ -73,7 +73,7 @@ func IsExitError(err error) bool {
 // if available.
 func Expand(s string) (string, error) {
 	s = filepath.ToSlash(s)
-	s = strings.Replace(s, " ", `\ `, -1)
+	s = strings.ReplaceAll(s, " ", `\ `)
 	fields, err := shell.Fields(s, nil)
 	if err != nil {
 		return "", err

internal/filepathext/filepathext.go

@@ -0,0 +1,14 @@
+package filepathext
+
+import (
+	"path/filepath"
+)
+
+// SmartJoin joins two paths, but only if the second is not already an
+// absolute path.
+func SmartJoin(a, b string) string {
+	if filepath.IsAbs(b) {
+		return b
+	}
+	return filepath.Join(a, b)
+}

internal/status/checksum.go

@@ -8,6 +8,8 @@ import (
 	"path/filepath"
 	"regexp"
 	"strings"
+
+	"github.com/go-task/task/v3/internal/filepathext"
 )
 
 // Checksum validades if a task is up to date by calculating its source
@@ -43,8 +45,8 @@ func (c *Checksum) IsUpToDate() (bool, error) {
 	}
 
 	if !c.Dry {
-		_ = os.MkdirAll(filepath.Join(c.TempDir, "checksum"), 0755)
-		if err = os.WriteFile(checksumFile, []byte(newMd5+"\n"), 0644); err != nil {
+		_ = os.MkdirAll(filepathext.SmartJoin(c.TempDir, "checksum"), 0o755)
+		if err = os.WriteFile(checksumFile, []byte(newMd5+"\n"), 0o644); err != nil {
 			return false, err
 		}
 	}

internal/status/glob.go

@@ -2,12 +2,12 @@ package status
 
 import (
 	"os"
-	"path/filepath"
 	"sort"
 
 	"github.com/mattn/go-zglob"
 
 	"github.com/go-task/task/v3/internal/execext"
+	"github.com/go-task/task/v3/internal/filepathext"
 )
 
 func globs(dir string, globs []string) ([]string, error) {
@@ -25,17 +25,18 @@ func globs(dir string, globs []string) ([]string, error) {
 
 func Glob(dir string, g string) ([]string, error) {
 	files := make([]string, 0)
-	if !filepath.IsAbs(g) {
-		g = filepath.Join(dir, g)
-	}
+	g = filepathext.SmartJoin(dir, g)
+
 	g, err := execext.Expand(g)
 	if err != nil {
 		return nil, err
 	}
-	fs, err := zglob.Glob(g)
+
+	fs, err := zglob.GlobFollowSymlinks(g)
 	if err != nil {
 		return nil, err
 	}
+
 	for _, f := range fs {
 		info, err := os.Stat(f)
 		if err != nil {

internal/templater/funcs.go

@@ -19,11 +19,11 @@ func init() {
 		"OS":   func() string { return runtime.GOOS },
 		"ARCH": func() string { return runtime.GOARCH },
 		"catLines": func(s string) string {
-			s = strings.Replace(s, "\r\n", " ", -1)
-			return strings.Replace(s, "\n", " ", -1)
+			s = strings.ReplaceAll(s, "\r\n", " ")
+			return strings.ReplaceAll(s, "\n", " ")
 		},
 		"splitLines": func(s string) []string {
-			s = strings.Replace(s, "\r\n", "\n", -1)
+			s = strings.ReplaceAll(s, "\r\n", "\n")
 			return strings.Split(s, "\n")
 		},
 		"fromSlash": func(path string) string {

package-lock.json

@@ -0,0 +1,32 @@
+{
+  "name": "@go-task/cli",
+  "version": "3.16.0",
+  "lockfileVersion": 2,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@go-task/cli",
+      "version": "3.16.0",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "@go-task/go-npm": "^0.1.15"
+      }
+    },
+    "node_modules/@go-task/go-npm": {
+      "version": "0.1.15",
+      "resolved": "https://registry.npmjs.org/@go-task/go-npm/-/go-npm-0.1.15.tgz",
+      "integrity": "sha512-xG+6SsSQsa6MzWML1CABWHTwHrCrBqXc/D1POoMDGIgjsRE/PB1noSBGLFhvU5DWHdPksqbAt/w9VOjbqlXpYw==",
+      "bin": {
+        "go-npm": "bin/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@go-task/go-npm": {
+      "version": "0.1.15",
+      "resolved": "https://registry.npmjs.org/@go-task/go-npm/-/go-npm-0.1.15.tgz",
+      "integrity": "sha512-xG+6SsSQsa6MzWML1CABWHTwHrCrBqXc/D1POoMDGIgjsRE/PB1noSBGLFhvU5DWHdPksqbAt/w9VOjbqlXpYw=="
+    }
+  }
+}

package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@go-task/cli",
+  "version": "3.16.0",
+  "description": "A task runner / simpler Make alternative written in Go",
+  "scripts": {
+    "postinstall": "go-npm install",
+    "preuninstall": "go-npm uninstall"
+  },
+  "goBinary": {
+    "name": "task",
+    "path": "./bin",
+    "url": "https://github.com/go-task/task/releases/download/v{{version}}/task_{{platform}}_{{arch}}{{archive_ext}}"
+  },
+  "files": [],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/go-task/task.git"
+  },
+  "keywords": [
+    "task",
+    "taskfile",
+    "build-tool",
+    "task-runner"
+  ],
+  "author": "Andrey Nering",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/go-task/task/issues"
+  },
+  "homepage": "https://taskfile.dev",
+  "dependencies": {
+    "@go-task/go-npm": "^0.1.15"
+  }
+}

setup.go

@@ -12,6 +12,7 @@ import (
 	compilerv2 "github.com/go-task/task/v3/internal/compiler/v2"
 	compilerv3 "github.com/go-task/task/v3/internal/compiler/v3"
 	"github.com/go-task/task/v3/internal/execext"
+	"github.com/go-task/task/v3/internal/filepathext"
 	"github.com/go-task/task/v3/internal/logger"
 	"github.com/go-task/task/v3/internal/output"
 	"github.com/go-task/task/v3/taskfile"
@@ -19,6 +20,10 @@ import (
 )
 
 func (e *Executor) Setup() error {
+	if err := e.setCurrentDir(); err != nil {
+		return err
+	}
+
 	if err := e.readTaskfile(); err != nil {
 		return err
 	}
@@ -52,6 +57,23 @@ func (e *Executor) Setup() error {
 	return nil
 }
 
+func (e *Executor) setCurrentDir() error {
+	if e.Dir == "" {
+		wd, err := os.Getwd()
+		if err != nil {
+			return err
+		}
+		e.Dir = wd
+	} else if !filepath.IsAbs(e.Dir) {
+		abs, err := filepath.Abs(e.Dir)
+		if err != nil {
+			return err
+		}
+		e.Dir = abs
+	}
+	return nil
+}
+
 func (e *Executor) readTaskfile() error {
 	var err error
 	e.Taskfile, err = read.Taskfile(&read.ReaderNode{
@@ -69,7 +91,7 @@ func (e *Executor) setupTempDir() error {
 	}
 
 	if os.Getenv("TASK_TEMP_DIR") == "" {
-		e.TempDir = filepath.Join(e.Dir, ".task")
+		e.TempDir = filepathext.SmartJoin(e.Dir, ".task")
 	} else if filepath.IsAbs(os.Getenv("TASK_TEMP_DIR")) || strings.HasPrefix(os.Getenv("TASK_TEMP_DIR"), "~") {
 		tempDir, err := execext.Expand(os.Getenv("TASK_TEMP_DIR"))
 		if err != nil {
@@ -77,9 +99,9 @@ func (e *Executor) setupTempDir() error {
 		}
 		projectDir, _ := filepath.Abs(e.Dir)
 		projectName := filepath.Base(projectDir)
-		e.TempDir = filepath.Join(tempDir, projectName)
+		e.TempDir = filepathext.SmartJoin(tempDir, projectName)
 	} else {
-		e.TempDir = filepath.Join(e.Dir, os.Getenv("TASK_TEMP_DIR"))
+		e.TempDir = filepathext.SmartJoin(e.Dir, os.Getenv("TASK_TEMP_DIR"))
 	}
 
 	return nil

signals.go

@@ -9,7 +9,7 @@ import (
 )
 
 // NOTE(@andreynering): This function intercepts SIGINT and SIGTERM signals
-// so the Task process is not killed immediatelly and processes running have
+// so the Task process is not killed immediately and processes running have
 // time to do cleanup work.
 func (e *Executor) InterceptInterruptSignals() {
 	ch := make(chan os.Signal, 3)

task.go

@@ -64,11 +64,16 @@ type Executor struct {
 func (e *Executor) Run(ctx context.Context, calls ...taskfile.Call) error {
 	// check if given tasks exist
 	for _, c := range calls {
-		if _, ok := e.Taskfile.Tasks[c.Task]; !ok {
+		t, ok := e.Taskfile.Tasks[c.Task]
+		if !ok {
 			// FIXME: move to the main package
 			e.ListTasksWithDesc()
 			return &taskNotFoundError{taskName: c.Task}
 		}
+		if t.Internal {
+			e.ListTasksWithDesc()
+			return &taskInternalError{taskName: c.Task}
+		}
 	}
 
 	if e.Summary {
@@ -181,7 +186,7 @@ func (e *Executor) mkdir(t *taskfile.Task) error {
 	defer mutex.Unlock()
 
 	if _, err := os.Stat(t.Dir); os.IsNotExist(err) {
-		if err := os.MkdirAll(t.Dir, 0755); err != nil {
+		if err := os.MkdirAll(t.Dir, 0o755); err != nil {
 			return err
 		}
 	}

task_test.go

@@ -14,6 +14,7 @@ import (
 	"github.com/stretchr/testify/assert"
 
 	"github.com/go-task/task/v3"
+	"github.com/go-task/task/v3/internal/filepathext"
 	"github.com/go-task/task/v3/taskfile"
 )
 
@@ -37,12 +38,12 @@ func (fct fileContentTest) name(file string) string {
 
 func (fct fileContentTest) Run(t *testing.T) {
 	for f := range fct.Files {
-		_ = os.Remove(filepath.Join(fct.Dir, f))
+		_ = os.Remove(filepathext.SmartJoin(fct.Dir, f))
 	}
 
 	e := &task.Executor{
 		Dir:        fct.Dir,
-		TempDir:    filepath.Join(fct.Dir, ".task"),
+		TempDir:    filepathext.SmartJoin(fct.Dir, ".task"),
 		Entrypoint: fct.Entrypoint,
 		Stdout:     io.Discard,
 		Stderr:     io.Discard,
@@ -52,7 +53,7 @@ func (fct fileContentTest) Run(t *testing.T) {
 
 	for name, expectContent := range fct.Files {
 		t.Run(fct.name(name), func(t *testing.T) {
-			path := filepath.Join(fct.Dir, name)
+			path := filepathext.SmartJoin(fct.Dir, name)
 			b, err := os.ReadFile(path)
 			assert.NoError(t, err, "Error reading file")
 			s := string(b)
@@ -163,6 +164,39 @@ func TestMultilineVars(t *testing.T) {
 	}
 }
 
+func TestSpecialVars(t *testing.T) {
+	const dir = "testdata/special_vars"
+	const target = "default"
+
+	var buff bytes.Buffer
+	e := &task.Executor{
+		Dir:    dir,
+		Stdout: &buff,
+		Stderr: &buff,
+		Silent: true,
+	}
+	assert.NoError(t, e.Setup())
+	assert.NoError(t, e.Run(context.Background(), taskfile.Call{Task: target}))
+
+	toAbs := func(rel string) string {
+		abs, err := filepath.Abs(rel)
+		assert.NoError(t, err)
+		return abs
+	}
+
+	output := buff.String()
+
+	// Root Taskfile
+	assert.Contains(t, output, "root/TASK=print")
+	assert.Contains(t, output, "root/ROOT_DIR="+toAbs("testdata/special_vars"))
+	assert.Contains(t, output, "root/TASKFILE_DIR="+toAbs("testdata/special_vars"))
+
+	// Included Taskfile
+	assert.Contains(t, output, "included/TASK=included:print")
+	assert.Contains(t, output, "included/ROOT_DIR="+toAbs("testdata/special_vars"))
+	assert.Contains(t, output, "included/TASKFILE_DIR="+toAbs("testdata/special_vars/included"))
+}
+
 func TestVarsInvalidTmpl(t *testing.T) {
 	const (
 		dir         = "testdata/vars/v2"
@@ -235,7 +269,7 @@ func TestDeps(t *testing.T) {
 	}
 
 	for _, f := range files {
-		_ = os.Remove(filepath.Join(dir, f))
+		_ = os.Remove(filepathext.SmartJoin(dir, f))
 	}
 
 	e := &task.Executor{
@@ -247,7 +281,7 @@ func TestDeps(t *testing.T) {
 	assert.NoError(t, e.Run(context.Background(), taskfile.Call{Task: "default"}))
 
 	for _, f := range files {
-		f = filepath.Join(dir, f)
+		f = filepathext.SmartJoin(dir, f)
 		if _, err := os.Stat(f); err != nil {
 			t.Errorf("File %s should exist", f)
 		}
@@ -263,7 +297,7 @@ func TestStatus(t *testing.T) {
 	}
 
 	for _, f := range files {
-		path := filepath.Join(dir, f)
+		path := filepathext.SmartJoin(dir, f)
 		_ = os.Remove(path)
 		if _, err := os.Stat(path); err == nil {
 			t.Errorf("File should not exist: %v", err)
@@ -273,7 +307,7 @@ func TestStatus(t *testing.T) {
 	var buff bytes.Buffer
 	e := &task.Executor{
 		Dir:     dir,
-		TempDir: filepath.Join(dir, ".task"),
+		TempDir: filepathext.SmartJoin(dir, ".task"),
 		Stdout:  &buff,
 		Stderr:  &buff,
 		Silent:  true,
@@ -283,7 +317,7 @@ func TestStatus(t *testing.T) {
 	assert.NoError(t, e.Run(context.Background(), taskfile.Call{Task: "gen-bar"}))
 
 	for _, f := range files {
-		if _, err := os.Stat(filepath.Join(dir, f)); err != nil {
+		if _, err := os.Stat(filepathext.SmartJoin(dir, f)); err != nil {
 			t.Errorf("File should exist: %v", err)
 		}
 	}
@@ -360,10 +394,10 @@ func TestGenerates(t *testing.T) {
 		fileWithSpaces = "my text file.txt"
 	)
 
-	var srcFile = filepath.Join(dir, srcTask)
+	var srcFile = filepathext.SmartJoin(dir, srcTask)
 
 	for _, task := range []string{srcTask, relTask, absTask, fileWithSpaces} {
-		path := filepath.Join(dir, task)
+		path := filepathext.SmartJoin(dir, task)
 		_ = os.Remove(path)
 		if _, err := os.Stat(path); err == nil {
 			t.Errorf("File should not exist: %v", err)
@@ -379,7 +413,7 @@ func TestGenerates(t *testing.T) {
 	assert.NoError(t, e.Setup())
 
 	for _, theTask := range []string{relTask, absTask, fileWithSpaces} {
-		var destFile = filepath.Join(dir, theTask)
+		var destFile = filepathext.SmartJoin(dir, theTask)
 		var upToDate = fmt.Sprintf("task: Task \"%s\" is up to date\n", srcTask) +
 			fmt.Sprintf("task: Task \"%s\" is up to date\n", theTask)
 
@@ -416,16 +450,16 @@ func TestStatusChecksum(t *testing.T) {
 	}
 
 	for _, f := range files {
-		_ = os.Remove(filepath.Join(dir, f))
+		_ = os.Remove(filepathext.SmartJoin(dir, f))
 
-		_, err := os.Stat(filepath.Join(dir, f))
+		_, err := os.Stat(filepathext.SmartJoin(dir, f))
 		assert.Error(t, err)
 	}
 
 	var buff bytes.Buffer
 	e := task.Executor{
 		Dir:     dir,
-		TempDir: filepath.Join(dir, ".task"),
+		TempDir: filepathext.SmartJoin(dir, ".task"),
 		Stdout:  &buff,
 		Stderr:  &buff,
 	}
@@ -433,7 +467,7 @@ func TestStatusChecksum(t *testing.T) {
 
 	assert.NoError(t, e.Run(context.Background(), taskfile.Call{Task: "build"}))
 	for _, f := range files {
-		_, err := os.Stat(filepath.Join(dir, f))
+		_, err := os.Stat(filepathext.SmartJoin(dir, f))
 		assert.NoError(t, err)
 	}
 
@@ -577,13 +611,13 @@ func TestListCanListDescOnly(t *testing.T) {
 func TestStatusVariables(t *testing.T) {
 	const dir = "testdata/status_vars"
 
-	_ = os.RemoveAll(filepath.Join(dir, ".task"))
-	_ = os.Remove(filepath.Join(dir, "generated.txt"))
+	_ = os.RemoveAll(filepathext.SmartJoin(dir, ".task"))
+	_ = os.Remove(filepathext.SmartJoin(dir, "generated.txt"))
 
 	var buff bytes.Buffer
 	e := task.Executor{
 		Dir:     dir,
-		TempDir: filepath.Join(dir, ".task"),
+		TempDir: filepathext.SmartJoin(dir, ".task"),
 		Stdout:  &buff,
 		Stderr:  &buff,
 		Silent:  false,
@@ -594,7 +628,7 @@ func TestStatusVariables(t *testing.T) {
 
 	assert.Contains(t, buff.String(), "d41d8cd98f00b204e9800998ecf8427e")
 
-	inf, err := os.Stat(filepath.Join(dir, "source.txt"))
+	inf, err := os.Stat(filepathext.SmartJoin(dir, "source.txt"))
 	assert.NoError(t, err)
 	ts := fmt.Sprintf("%d", inf.ModTime().Unix())
 	tf := inf.ModTime().String()
@@ -605,7 +639,7 @@ func TestStatusVariables(t *testing.T) {
 
 func TestInit(t *testing.T) {
 	const dir = "testdata/init"
-	var file = filepath.Join(dir, "Taskfile.yaml")
+	var file = filepathext.SmartJoin(dir, "Taskfile.yaml")
 
 	_ = os.Remove(file)
 	if _, err := os.Stat(file); err == nil {
@@ -694,7 +728,7 @@ func TestExpand(t *testing.T) {
 func TestDry(t *testing.T) {
 	const dir = "testdata/dry"
 
-	file := filepath.Join(dir, "file.txt")
+	file := filepathext.SmartJoin(dir, "file.txt")
 	_ = os.Remove(file)
 
 	var buff bytes.Buffer
@@ -719,12 +753,12 @@ func TestDry(t *testing.T) {
 func TestDryChecksum(t *testing.T) {
 	const dir = "testdata/dry_checksum"
 
-	checksumFile := filepath.Join(dir, ".task/checksum/default")
+	checksumFile := filepathext.SmartJoin(dir, ".task/checksum/default")
 	_ = os.Remove(checksumFile)
 
 	e := task.Executor{
 		Dir:     dir,
-		TempDir: filepath.Join(dir, ".task"),
+		TempDir: filepathext.SmartJoin(dir, ".task"),
 		Stdout:  io.Discard,
 		Stderr:  io.Discard,
 		Dry:     true,
@@ -776,12 +810,6 @@ func TestIncludesMultiLevel(t *testing.T) {
 func TestIncludeCycle(t *testing.T) {
 	const dir = "testdata/includes_cycle"
 
-	wd, err := os.Getwd()
-	assert.Nil(t, err)
-
-	message := "task: include cycle detected between %s/%s/one/Taskfile.yml <--> %s/%s/Taskfile.yml"
-	expectedError := fmt.Sprintf(message, wd, dir, wd, dir)
-
 	var buff bytes.Buffer
 	e := task.Executor{
 		Dir:    dir,
@@ -790,7 +818,9 @@ func TestIncludeCycle(t *testing.T) {
 		Silent: true,
 	}
 
-	assert.EqualError(t, e.Setup(), expectedError)
+	err := e.Setup()
+	assert.Error(t, err)
+	assert.Contains(t, err.Error(), "task: include cycle detected between")
 }
 
 func TestIncorrectVersionIncludes(t *testing.T) {
@@ -928,6 +958,86 @@ func TestIncludesRelativePath(t *testing.T) {
 	assert.Contains(t, buff.String(), "testdata/includes_rel_path/common")
 }
 
+func TestIncludesInternal(t *testing.T) {
+	const dir = "testdata/internal_task"
+	tests := []struct {
+		name           string
+		task           string
+		expectedErr    bool
+		expectedOutput string
+	}{
+		{"included internal task via task", "task-1", false, "Hello, World!\n"},
+		{"included internal task via dep", "task-2", false, "Hello, World!\n"},
+		{
+			"included internal direct",
+			"included:task-3",
+			true,
+			"task: No tasks with description available. Try --list-all to list all tasks\n",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+			var buff bytes.Buffer
+			e := task.Executor{
+				Dir:    dir,
+				Stdout: &buff,
+				Stderr: &buff,
+				Silent: true,
+			}
+			assert.NoError(t, e.Setup())
+
+			err := e.Run(context.Background(), taskfile.Call{Task: test.task})
+			if test.expectedErr {
+				assert.Error(t, err, test.expectedErr)
+			} else {
+				assert.NoError(t, err)
+			}
+			assert.Equal(t, test.expectedOutput, buff.String())
+		})
+	}
+}
+
+func TestInternalTask(t *testing.T) {
+	const dir = "testdata/internal_task"
+	tests := []struct {
+		name           string
+		task           string
+		expectedErr    bool
+		expectedOutput string
+	}{
+		{"internal task via task", "task-1", false, "Hello, World!\n"},
+		{"internal task via dep", "task-2", false, "Hello, World!\n"},
+		{
+			"internal direct",
+			"task-3",
+			true,
+			"task: No tasks with description available. Try --list-all to list all tasks\n",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+			var buff bytes.Buffer
+			e := task.Executor{
+				Dir:    dir,
+				Stdout: &buff,
+				Stderr: &buff,
+				Silent: true,
+			}
+			assert.NoError(t, e.Setup())
+
+			err := e.Run(context.Background(), taskfile.Call{Task: test.task})
+			if test.expectedErr {
+				assert.Error(t, err, test.expectedErr)
+			} else {
+				assert.NoError(t, err)
+			}
+			assert.Equal(t, test.expectedOutput, buff.String())
+		})
+	}
+}
+
 func TestSupportedFileNames(t *testing.T) {
 	fileNames := []string{
 		"Taskfile.yml",
@@ -964,12 +1074,12 @@ func TestSummary(t *testing.T) {
 	assert.NoError(t, e.Setup())
 	assert.NoError(t, e.Run(context.Background(), taskfile.Call{Task: "task-with-summary"}, taskfile.Call{Task: "other-task-with-summary"}))
 
-	data, err := os.ReadFile(filepath.Join(dir, "task-with-summary.txt"))
+	data, err := os.ReadFile(filepathext.SmartJoin(dir, "task-with-summary.txt"))
 	assert.NoError(t, err)
 
 	expectedOutput := string(data)
 	if runtime.GOOS == "windows" {
-		expectedOutput = strings.Replace(expectedOutput, "\r\n", "\n", -1)
+		expectedOutput = strings.ReplaceAll(expectedOutput, "\r\n", "\n")
 	}
 
 	assert.Equal(t, expectedOutput, buff.String())
@@ -1337,3 +1447,36 @@ func TestErrorCode(t *testing.T) {
 	assert.True(t, ok, "cannot cast returned error to *task.TaskRunError")
 	assert.Equal(t, 42, casted.ExitCode(), "unexpected exit code from task")
 }
+
+func TestEvaluateSymlinksInPaths(t *testing.T) {
+	const dir = "testdata/evaluate_symlinks_in_paths"
+	var buff bytes.Buffer
+	e := &task.Executor{
+		Dir:    dir,
+		Stdout: &buff,
+		Stderr: &buff,
+		Silent: false,
+	}
+	assert.NoError(t, e.Setup())
+	err := e.Run(context.Background(), taskfile.Call{Task: "default"})
+	assert.NoError(t, err)
+	assert.NotEqual(t, `task: Task "default" is up to date`, strings.TrimSpace(buff.String()))
+	buff.Reset()
+	err = e.Run(context.Background(), taskfile.Call{Task: "test-sym"})
+	assert.NoError(t, err)
+	assert.NotEqual(t, `task: Task "test-sym" is up to date`, strings.TrimSpace(buff.String()))
+	buff.Reset()
+	err = e.Run(context.Background(), taskfile.Call{Task: "default"})
+	assert.NoError(t, err)
+	assert.NotEqual(t, `task: Task "default" is up to date`, strings.TrimSpace(buff.String()))
+	buff.Reset()
+	err = e.Run(context.Background(), taskfile.Call{Task: "default"})
+	assert.NoError(t, err)
+	assert.Equal(t, `task: Task "default" is up to date`, strings.TrimSpace(buff.String()))
+	buff.Reset()
+	err = e.Run(context.Background(), taskfile.Call{Task: "reset"})
+	assert.NoError(t, err)
+	buff.Reset()
+	err = os.RemoveAll(dir + "/.task")
+	assert.NoError(t, err)
+}

taskfile/included_taskfile.go

@@ -6,6 +6,7 @@ import (
 	"path/filepath"
 
 	"github.com/go-task/task/v3/internal/execext"
+	"github.com/go-task/task/v3/internal/filepathext"
 
 	"gopkg.in/yaml.v3"
 )
@@ -15,6 +16,7 @@ type IncludedTaskfile struct {
 	Taskfile       string
 	Dir            string
 	Optional       bool
+	Internal       bool
 	AdvancedImport bool
 	Vars           *Vars
 	BaseDir        string // The directory from which the including taskfile was loaded; used to resolve relative paths
@@ -100,6 +102,7 @@ func (it *IncludedTaskfile) UnmarshalYAML(unmarshal func(interface{}) error) err
 		Taskfile string
 		Dir      string
 		Optional bool
+		Internal bool
 		Vars     *Vars
 	}
 	if err := unmarshal(&includedTaskfile); err != nil {
@@ -108,6 +111,7 @@ func (it *IncludedTaskfile) UnmarshalYAML(unmarshal func(interface{}) error) err
 	it.Taskfile = includedTaskfile.Taskfile
 	it.Dir = includedTaskfile.Dir
 	it.Optional = includedTaskfile.Optional
+	it.Internal = includedTaskfile.Internal
 	it.AdvancedImport = true
 	it.Vars = includedTaskfile.Vars
 	return nil
@@ -133,7 +137,7 @@ func (it *IncludedTaskfile) resolvePath(path string) (string, error) {
 		return path, nil
 	}
 
-	result, err := filepath.Abs(filepath.Join(it.BaseDir, path))
+	result, err := filepath.Abs(filepathext.SmartJoin(it.BaseDir, path))
 	if err != nil {
 		return "", fmt.Errorf("task: error resolving path %s relative to %s: %w", path, it.BaseDir, err)
 	}

taskfile/merge.go

@@ -9,7 +9,7 @@ import (
 const NamespaceSeparator = ":"
 
 // Merge merges the second Taskfile into the first
-func Merge(t1, t2 *Taskfile, namespaces ...string) error {
+func Merge(t1, t2 *Taskfile, internal bool, namespaces ...string) error {
 	if t1.Version != t2.Version {
 		return fmt.Errorf(`task: Taskfiles versions should match. First is "%s" but second is "%s"`, t1.Version, t2.Version)
 	}
@@ -43,6 +43,8 @@ func Merge(t1, t2 *Taskfile, namespaces ...string) error {
 		// have serious side-effects in the future, since we're editing
 		// the original references instead of deep copying them.
 
+		v.Internal = v.Internal || internal
+
 		t1.Tasks[taskNameWithNamespace(k, namespaces...)] = v
 
 		for _, dep := range v.Deps {

taskfile/read/dotenv.go

@@ -2,11 +2,11 @@ package read
 
 import (
 	"os"
-	"path/filepath"
 
 	"github.com/joho/godotenv"
 
 	"github.com/go-task/task/v3/internal/compiler"
+	"github.com/go-task/task/v3/internal/filepathext"
 	"github.com/go-task/task/v3/internal/templater"
 	"github.com/go-task/task/v3/taskfile"
 )
@@ -27,10 +27,11 @@ func Dotenv(c compiler.Compiler, tf *taskfile.Taskfile, dir string) (*taskfile.V
 
 	for _, dotEnvPath := range tf.Dotenv {
 		dotEnvPath = tr.Replace(dotEnvPath)
-
-		if !filepath.IsAbs(dotEnvPath) {
-			dotEnvPath = filepath.Join(dir, dotEnvPath)
+		if dotEnvPath == "" {
+			continue
 		}
+		dotEnvPath = filepathext.SmartJoin(dir, dotEnvPath)
+
 		if _, err := os.Stat(dotEnvPath); os.IsNotExist(err) {
 			continue
 		}

taskfile/read/taskfile.go

@@ -9,6 +9,7 @@ import (
 
 	"gopkg.in/yaml.v3"
 
+	"github.com/go-task/task/v3/internal/filepathext"
 	"github.com/go-task/task/v3/internal/templater"
 	"github.com/go-task/task/v3/taskfile"
 )
@@ -44,7 +45,7 @@ func Taskfile(readerNode *ReaderNode) (*taskfile.Taskfile, error) {
 		readerNode.Dir = d
 	}
 
-	path, err := exists(filepath.Join(readerNode.Dir, readerNode.Entrypoint))
+	path, err := exists(filepathext.SmartJoin(readerNode.Dir, readerNode.Entrypoint))
 	if err != nil {
 		return nil, err
 	}
@@ -77,6 +78,7 @@ func Taskfile(readerNode *ReaderNode) (*taskfile.Taskfile, error) {
 				Taskfile:       tr.Replace(includedTask.Taskfile),
 				Dir:            tr.Replace(includedTask.Dir),
 				Optional:       includedTask.Optional,
+				Internal:       includedTask.Internal,
 				AdvancedImport: includedTask.AdvancedImport,
 				Vars:           includedTask.Vars,
 				BaseDir:        includedTask.BaseDir,
@@ -140,16 +142,14 @@ func Taskfile(readerNode *ReaderNode) (*taskfile.Taskfile, error) {
 			}
 
 			for _, task := range includedTaskfile.Tasks {
-				if !filepath.IsAbs(task.Dir) {
-					task.Dir = filepath.Join(dir, task.Dir)
-				}
-
+				task.Dir = filepathext.SmartJoin(dir, task.Dir)
 				task.IncludeVars = includedTask.Vars
 				task.IncludedTaskfileVars = includedTaskfile.Vars
+				task.IncludedTaskfile = &includedTask
 			}
 		}
 
-		if err = taskfile.Merge(t, includedTaskfile, namespace); err != nil {
+		if err = taskfile.Merge(t, includedTaskfile, includedTask.Internal, namespace); err != nil {
 			return err
 		}
 		return nil
@@ -159,13 +159,13 @@ func Taskfile(readerNode *ReaderNode) (*taskfile.Taskfile, error) {
 	}
 
 	if v < 3.0 {
-		path = filepath.Join(readerNode.Dir, fmt.Sprintf("Taskfile_%s.yml", runtime.GOOS))
+		path = filepathext.SmartJoin(readerNode.Dir, fmt.Sprintf("Taskfile_%s.yml", runtime.GOOS))
 		if _, err = os.Stat(path); err == nil {
 			osTaskfile, err := readTaskfile(path)
 			if err != nil {
 				return nil, err
 			}
-			if err = taskfile.Merge(t, osTaskfile); err != nil {
+			if err = taskfile.Merge(t, osTaskfile, false); err != nil {
 				return nil, err
 			}
 		}
@@ -191,29 +191,19 @@ func readTaskfile(file string) (*taskfile.Taskfile, error) {
 	return &t, yaml.NewDecoder(f).Decode(&t)
 }
 
-// exists finds a Taskfile at the stated location, returning a fully qualified path to the file
 func exists(path string) (string, error) {
 	fi, err := os.Stat(path)
 	if err != nil {
 		return "", err
 	}
 	if fi.Mode().IsRegular() {
-		// File exists, return a fully qualified path
-		result, err := filepath.Abs(path)
-		if err != nil {
-			return "", err
-		}
-		return result, nil
+		return path, nil
 	}
 
 	for _, n := range defaultTaskfiles {
-		fpath := filepath.Join(path, n)
+		fpath := filepathext.SmartJoin(path, n)
 		if _, err := os.Stat(fpath); err == nil {
-			result, err := filepath.Abs(fpath)
-			if err != nil {
-				return "", err
-			}
-			return result, nil
+			return fpath, nil
 		}
 	}
 
@@ -228,14 +218,14 @@ func checkCircularIncludes(node *ReaderNode) error {
 		return errors.New("task: failed to check for include cycle: node.Parent was nil")
 	}
 	var curNode = node
-	var basePath = filepath.Join(node.Dir, node.Entrypoint)
+	var basePath = filepathext.SmartJoin(node.Dir, node.Entrypoint)
 	for curNode.Parent != nil {
 		curNode = curNode.Parent
-		curPath := filepath.Join(curNode.Dir, curNode.Entrypoint)
+		curPath := filepathext.SmartJoin(curNode.Dir, curNode.Entrypoint)
 		if curPath == basePath {
 			return fmt.Errorf("task: include cycle detected between %s <--> %s",
 				curPath,
-				filepath.Join(node.Parent.Dir, node.Parent.Entrypoint),
+				filepathext.SmartJoin(node.Parent.Dir, node.Parent.Entrypoint),
 			)
 		}
 	}

taskfile/read/taskvars.go

@@ -3,11 +3,11 @@ package read
 import (
 	"fmt"
 	"os"
-	"path/filepath"
 	"runtime"
 
 	"gopkg.in/yaml.v3"
 
+	"github.com/go-task/task/v3/internal/filepathext"
 	"github.com/go-task/task/v3/taskfile"
 )
 
@@ -15,7 +15,7 @@ import (
 func Taskvars(dir string) (*taskfile.Vars, error) {
 	vars := &taskfile.Vars{}
 
-	path := filepath.Join(dir, "Taskvars.yml")
+	path := filepathext.SmartJoin(dir, "Taskvars.yml")
 	if _, err := os.Stat(path); err == nil {
 		vars, err = readTaskvars(path)
 		if err != nil {
@@ -23,7 +23,7 @@ func Taskvars(dir string) (*taskfile.Vars, error) {
 		}
 	}
 
-	path = filepath.Join(dir, fmt.Sprintf("Taskvars_%s.yml", runtime.GOOS))
+	path = filepathext.SmartJoin(dir, fmt.Sprintf("Taskvars_%s.yml", runtime.GOOS))
 	if _, err := os.Stat(path); err == nil {
 		osVars, err := readTaskvars(path)
 		if err != nil {

taskfile/task.go

@@ -20,12 +20,14 @@ type Task struct {
 	Env                  *Vars
 	Silent               bool
 	Interactive          bool
+	Internal             bool
 	Method               string
 	Prefix               string
 	IgnoreError          bool
 	Run                  string
 	IncludeVars          *Vars
 	IncludedTaskfileVars *Vars
+	IncludedTaskfile     *IncludedTaskfile
 }
 
 func (t *Task) Name() string {
@@ -63,6 +65,7 @@ func (t *Task) UnmarshalYAML(unmarshal func(interface{}) error) error {
 		Env           *Vars
 		Silent        bool
 		Interactive   bool
+		Internal      bool
 		Method        string
 		Prefix        string
 		IgnoreError   bool `yaml:"ignore_error"`
@@ -85,6 +88,7 @@ func (t *Task) UnmarshalYAML(unmarshal func(interface{}) error) error {
 	t.Env = task.Env
 	t.Silent = task.Silent
 	t.Interactive = task.Interactive
+	t.Internal = task.Internal
 	t.Method = task.Method
 	t.Prefix = task.Prefix
 	t.IgnoreError = task.IgnoreError

testdata/evaluate_symlinks_in_paths/Taskfile.yaml

@@ -0,0 +1,17 @@
+version: '3'
+
+tasks:
+  default:
+    sources:
+      - src/**/*
+    cmds:
+      - echo "some job"
+
+  test-sym:
+    cmds:
+      - echo "shared file source changed" > src/shared/b
+
+  reset:
+    cmds:
+      - echo "shared file source" > src/shared/b
+      - echo "file source" > src/a

testdata/evaluate_symlinks_in_paths/shared/b

@@ -0,0 +1 @@
+shared file source

testdata/evaluate_symlinks_in_paths/shared/inner_shared/c

@@ -0,0 +1 @@
+inner shared file source

testdata/evaluate_symlinks_in_paths/src/a

@@ -0,0 +1 @@
+file source

testdata/evaluate_symlinks_in_paths/src/shared

@@ -0,0 +1 @@
+../shared

testdata/includes_internal/Taskfile.yml

@@ -0,0 +1,15 @@
+version: '3'
+
+includes:
+  included:
+    taskfile: Taskfile2.yml
+    internal: true
+
+tasks:
+  task-1:
+    cmds:
+      - task: included:default
+
+  task-2:
+    deps:
+      - included:default

testdata/includes_internal/Taskfile2.yml

@@ -0,0 +1,6 @@
+version: '3'
+
+tasks:
+  task-3:
+    cmds:
+      - echo "Hello, World!"

testdata/internal_task/Taskfile.yml

@@ -0,0 +1,15 @@
+version: '3'
+
+tasks:
+  task-1:
+    cmds:
+      - task: task-3
+
+  task-2:
+    deps:
+      - task-3
+
+  task-3:
+    internal: true
+    cmds:
+      - echo "Hello, World!"

testdata/special_vars/Taskfile.yml

@@ -0,0 +1,18 @@
+version: '3'
+
+includes:
+  included:
+    taskfile: ./included
+    dir: ./included
+
+tasks:
+  default:
+    cmds:
+      - task: print
+      - task: included:print
+
+  print:
+    cmds:
+      - echo root/TASK={{.TASK}}
+      - echo root/ROOT_DIR={{.ROOT_DIR}}
+      - echo root/TASKFILE_DIR={{.TASKFILE_DIR}}

testdata/special_vars/included/Taskfile.yml

@@ -0,0 +1,8 @@
+version: '3'
+
+tasks:
+  print:
+    cmds:
+      - echo included/TASK={{.TASK}}
+      - echo included/ROOT_DIR={{.ROOT_DIR}}
+      - echo included/TASKFILE_DIR={{.TASKFILE_DIR}}

variables.go

@@ -1,10 +1,10 @@
 package task
 
 import (
-	"path/filepath"
 	"strings"
 
 	"github.com/go-task/task/v3/internal/execext"
+	"github.com/go-task/task/v3/internal/filepathext"
 	"github.com/go-task/task/v3/internal/status"
 	"github.com/go-task/task/v3/internal/templater"
 	"github.com/go-task/task/v3/taskfile"
@@ -57,6 +57,7 @@ func (e *Executor) compiledTask(call taskfile.Call, evaluateShVars bool) (*taskf
 		Env:                  nil,
 		Silent:               origTask.Silent,
 		Interactive:          origTask.Interactive,
+		Internal:             origTask.Internal,
 		Method:               r.Replace(origTask.Method),
 		Prefix:               r.Replace(origTask.Prefix),
 		IgnoreError:          origTask.IgnoreError,
@@ -68,8 +69,8 @@ func (e *Executor) compiledTask(call taskfile.Call, evaluateShVars bool) (*taskf
 	if err != nil {
 		return nil, err
 	}
-	if e.Dir != "" && !filepath.IsAbs(new.Dir) {
-		new.Dir = filepath.Join(e.Dir, new.Dir)
+	if e.Dir != "" {
+		new.Dir = filepathext.SmartJoin(e.Dir, new.Dir)
 	}
 	if new.Prefix == "" {
 		new.Prefix = new.Task