Skip to content

build: add repository taskfile#68

Merged
rian-be merged 1 commit into
mainfrom
develop
Jul 2, 2026
Merged

build: add repository taskfile#68
rian-be merged 1 commit into
mainfrom
develop

Conversation

@rian-be

@rian-be rian-be commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR adds a root repository Taskfile.yml for common local workflows, so contributors can build, test, verify dependencies, and run focused test commands through a single discoverable entrypoint.

Highlights

Repository task entrypoint

  • Add a root Taskfile.yml with direct, thin wrappers around the repository's existing dotnet, Python, and DocFX commands.
  • Add first-class tasks for restore, clean, build, test, format, deps, docs, and verify.
  • Add targeted test tasks for core, governance, governance Redis, smoke tests, and a parameterized test:project workflow for focused test runs.

Repo-facing documentation

  • Document the task entrypoint in the root README.md.
  • Add the same local workflow guidance to Docs/Home.md so the task layer is visible from the documentation surface as well.
  • Keep the task names short and explicit so the command surface stays easy to discover from the repository root.

Build workflow hardening

  • Exclude generated obj/**/*.cs and bin/**/*.cs sources from src/ModularityKit.Mutator.csproj.
  • Fix duplicate assembly attribute failures that were surfacing during normal repository builds.
  • Keep the task definitions thin by fixing the underlying build input issue rather than adding special handling in the task layer.

Why

Issue #49 is about reducing command drift in a repository that already has several build, test, docs, and validation workflows. Contributors should not need to memorize long solution paths and repeated dotnet invocations for common tasks.

This PR adds the root task entrypoint while keeping the implementation low ceremony and aligned with the commands the repository already uses in README guidance and CI.

Checks

  • task --list-all
  • task --dry build CONFIGURATION=Debug
  • task --dry test:project PROJECT=Tests/ModularityKit.Mutator.Tests/ModularityKit.Mutator.Tests.csproj FILTER=MutationBase CONFIGURATION=Debug
  • task build
  • task test:project PROJECT=Tests/ModularityKit.Mutator.Tests/ModularityKit.Mutator.Tests.csproj FILTER=MutationBase
  • task deps
  • task test

Closes

@github-actions github-actions Bot added the documentation Documentation updates and additions label Jul 2, 2026
@rian-be rian-be marked this pull request as ready for review July 2, 2026 20:32
@rian-be rian-be merged commit 30736d5 into main Jul 2, 2026
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation updates and additions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Task]: Add repository Taskfile for common workflows

1 participant