feat(tasks): add mise task validate command for task validation

[jdx]

Summary

Adds a comprehensive mise task validate command that validates tasks for common errors and issues.

Validation Checks

The command performs 11 types of validation:

1. Circular Dependencies - Detects dependency cycles between tasks
2. Missing Task References - Finds dependencies that reference non-existent tasks
3. Usage Spec Parsing - Validates #USAGE and #MISE directives
4. Timeout Format - Checks timeout values are valid durations
5. Alias Conflicts - Detects duplicate aliases across tasks
6. File Existence - Verifies file-based tasks exist and warns if not executable
7. Directory Templates - Validates directory paths and template rendering
8. Shell Commands - Checks shell executables exist (for absolute paths)
9. Source Glob Patterns - Validates glob patterns for task sources
10. Output Glob Patterns - Validates glob patterns for task outputs
11. Run Entry Validation - Ensures tasks reference valid dependencies and have content

Features

• Human-readable output with colored error/warning indicators
• JSON output format for CI/CD integration (--json)
• Filter by severity (--errors-only)
• Validate specific tasks or all tasks
• Support for hidden tasks (--hidden)
• Smart detection of meta-tasks (tasks with only dependencies)

Exit Codes

• 0: All validations passed (or only warnings)
• 1: One or more errors found

Examples

# Validate all tasks
mise task validate

# Validate specific tasks
mise task validate build test

# JSON output for CI integration
mise task validate --json

# Only show errors (skip warnings)
mise task validate --errors-only

Test Coverage

• Comprehensive e2e test suite (e2e/tasks/test_task_validate)
• Tests all validation rules
• Tests output formats (human-readable and JSON)
• Tests filtering options

🤖 Generated with Claude Code

---

Note

Adds mise tasks validate to validate tasks (human/JSON output, errors-only), with docs, manpage, completions, and e2e tests.

• CLI/Backend:
  • Implement src/cli/tasks/validate.rs and wire into src/cli/tasks/mod.rs as validate subcommand.
  • Performs 11 validations (circular deps, missing refs, usage parsing, timeout, alias conflicts, file/dir, shell, glob patterns, run entries) with human and --json output and --errors-only filter.
• Docs/Specs:
  • Add docs/cli/tasks/validate.md and list command in docs/cli/index.md, docs/cli/tasks.md.
  • Update man page man/man1/mise.1 and usage spec mise.usage.kdl.
  • Expose in VitePress command map docs/.vitepress/cli_commands.ts.
• Completions:
  • Update Fig spec xtasks/fig/src/mise.ts to include tasks validate with options and args.
• Tests:
  • Add e2e coverage e2e/tasks/test_task_validate exercising success, failures, JSON output, and flags.

^{Written by Cursor Bugbot for commit 6e376f9. This will update automatically on new commits. Configure here.}

[Copilot]

Pull Request Overview

This PR introduces a new mise task validate command that performs comprehensive validation of task configurations to detect common errors and issues before runtime.

Key changes:

• Implements 11 validation checks including circular dependencies, missing references, timeout formats, alias conflicts, file existence, glob patterns, and more
• Supports both human-readable and JSON output formats for CI/CD integration
• Includes filtering options (--errors-only, --hidden) and specific task validation

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
src/cli/tasks/validate.rs	New module implementing the task validation command with 11 validation checks
src/cli/tasks/mod.rs	Registers the new validate subcommand in the tasks CLI module
e2e/tasks/test_task_validate	Comprehensive end-to-end test suite covering all validation scenarios

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The suggestion mentions 'hide=false' but should be 'hide=true' since the default is hide=false and executable files without this flag would typically be auto-discovered as tasks.

Suggested change

	"Consider making the file executable or setting 'hide=false'".to_string(),
	"Consider making the file executable or setting 'hide=true'".to_string(),

[cursor]

Bug: Incorrect Validation Flags Platform-Specific Execution

The no-execution validation incorrectly fails tasks that have platform-specific run entries. The check uses task.run().is_empty() which returns different fields based on platform (either run or run_windows). A task with only run_windows defined will fail validation on non-Windows platforms even though it's valid, and vice versa. The validation should check both task.run and task.run_windows are empty instead of using the platform-dependent task.run() method.

 

[github-actions]

Hyperfine Performance

mise x -- echo

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.3 x -- echo	19.5 ± 0.8	18.3	24.3	1.00
mise x -- echo	19.7 ± 0.7	18.5	25.9	1.01 ± 0.06

mise env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.3 env	18.8 ± 0.6	18.0	24.6	1.00
mise env	19.3 ± 0.9	18.2	25.4	1.02 ± 0.06

mise hook-env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.3 hook-env	19.2 ± 0.8	18.1	24.7	1.00
mise hook-env	20.4 ± 1.0	18.9	28.5	1.06 ± 0.07

mise ls

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.3 ls	16.7 ± 0.6	15.6	21.0	1.00
mise ls	16.8 ± 0.7	15.8	21.6	1.01 ± 0.06

xtasks/test/perf

Command	mise-2025.11.3	mise	Variance
install (cached)	108ms	109ms	+0%
ls (cached)	65ms	65ms	+0%
bin-paths (cached)	74ms	74ms	+0%
task-ls (cached)	436ms	445ms	-2%