refactor: replace makefile and taskfile with justflle

Author: indaco

.tool-versions

@@ -1 +1 @@
-just 1.41.0
+just 1.46.0

CONTRIBUTING.md

@@ -24,62 +24,64 @@ To set up a development environment for this repository, you can use [devbox](ht
 
 If you prefer not to use Devbox, ensure you have the following tools installed:
 
-- [golangci-lint](https://golangci-lint.run/): For linting Go code.
-- [go-task](https://taskfile.dev/) or `make`: For running project tasks.
-- [modernize](https://pkg.go.dev/golang.org/x/tools/gopls/internal/analysis/modernize): Run the modernizer analyzer to simplify code by using modern constructs.
+- [Go](https://go.dev/dl/) (1.25 or later)
+- [just](https://github.com/casey/just): Command runner for project tasks
+- [golangci-lint](https://golangci-lint.run/): For linting Go code
+- [modernize](https://pkg.go.dev/golang.org/x/tools/gopls/internal/analysis/modernize): Run the modernizer analyzer to simplify code
+- [govulncheck](https://pkg.go.dev/golang.org/x/vuln/cmd/govulncheck): Reports known vulnerabilities that affect Go code
+
+Optional tools:
+
+- [goreportcard-cli](https://github.com/gojp/goreportcard): For local code quality reports (requires manual installation via git clone + make)
+- [prek](https://github.com/indaco/prek): For Git hooks management
 
 ## Setting Up Git Hooks
 
-Git hooks are used to enforce code quality and streamline the workflow. Follow these steps to set them up:
+Git hooks are used to enforce code quality and streamline the workflow.
 
 ### Using Devbox
 
-If using `devbox`, Git hooks are automatically installed when you run `devbox shell`. No further action is required.
+If using `devbox`, Git hooks are automatically installed when you run `devbox shell`. The hooks are managed by [prek](https://github.com/indaco/prek).
 
 ### Manual Setup
 
-For users not using `devbox`, follow the steps below to manually install the Git hooks:
-
-1. Clone the repository:
-
-   ```bash
-   git clone https://github.com/indaco/tempo.git
-   cd tempo
-   ```
-
-2. Install the Git Hooks
+For users not using `devbox`, install prek and run:
 
-   **Unix-based systems (Linux, macOS):**
+```bash
+pip install prek
+prek install -- --workspace
+```
 
-   ```bash
-   sh .scripts/setup-hooks.sh
-   ```
+This installs the commit-msg hook that validates conventional commit messages.
 
-   **Windows systems:**
+## Running Tasks
 
-   ```cmd
-   .scripts\setup-hooks.bat
-   ```
+This project uses [just](https://github.com/casey/just) for running tasks.
 
-## Running Tasks
+### View all available recipes
 
-This project provides both a `Makefile` and a `Taskfile` for running various tasks. You can use either `make` or `task` to execute the tasks, depending on your preference.
+```bash
+just help
+```
 
-### View all available tasks
+### Available Recipes
 
-- _Makefile_: `make help`
-- _Taskfile_: `task --list-all`
+| Recipe            | Description                                |
+| ----------------- | ------------------------------------------ |
+| `just help`       | Print help message                         |
+| `just all`        | Clean and build                            |
+| `just clean`      | Clean the build directory and Go cache     |
+| `just test`       | Run all tests and generate coverage report |
+| `just test-force` | Clean go tests cache and run all tests     |
+| `just modernize`  | Run go-modernize with auto-fix             |
+| `just check`      | Run modernize, lint, and test              |
+| `just lint`       | Run golangci-lint                          |
+| `just build`      | Build the binary to build/tempo            |
+| `just install`    | Install the binary using Go install        |
 
-#### Common tasks
+### Quick Start
 
 ```bash
-build:               # Build the binary
-clean:               # Clean the build directory and Go cache
-default:             # Run clean and build tasks
-install:             # Install the binary using Go install
-lint:                # Run golangci-lint
-modernize:           # Run go-modernize
-test:                # Run all tests and generate coverage report
-test/coverage:       # Run go tests and use go tool cover
-test/force:          # Clean go tests cache and run all tests
+# Run all quality checks before submitting a PR
+just check
 ```