Add a `Makefile`

[ruancomelli]

Is your improvement request related to a problem? Please describe.

It is currently hard to discover and execute the development scripts. They are inside the scripts/ directory, but discoverability could be even simpler.

Describe the improvement you'd like

Create a Makefile at the root of the project with the following rules:

.PHONY: init
init:
    bash scripts/init.sh

.PHONY: lint
lint:
    bash scripts/lint.sh src/

.PHONY: format
format:
    bash scripts/format.sh src/

.PHONY: type-check
type-check:
    bash scripts/type-check.sh src/

.PHONY: test
test:
    bash scripts/test.sh

.PHONY: test-cov
test-cov:
    bash scripts/test-cov.sh

Describe alternatives you've considered

I also considered:

• doing nothing (i.e. relying on the scripts/ directory directly)
• using the just task runner, which is better suited to this but is not as well-known and documented
• using the mise task runner, which is also better suited to this but is not as well-known and documented; it also allows us to control other tools like uv, cargo etc. from a unified mise.toml config file

Benefits

1. Easier discoverability: all development commands live in the Makefile
2. Easy extendability: soon, when we add docs, we can very easily add doc-building commands to the Makefile
3. Popularity: among the alternatives, make is much more widely known and documented, making it easier for anyone to contribute to this project

Additional context
None.

[ruancomelli]

@aninhasalesp would you like to take over this task?

[ruancomelli]

@sourcery-ai plan

[sourcery-ai]

Objectives

• Create a Makefile at the root of the project
• Define a phony target for init that runs scripts/init.sh
• Define a phony target for lint that runs scripts/lint.sh src/
• Define a phony target for format that runs scripts/format.sh src/
• Define a phony target for type-check that runs scripts/type-check.sh src/
• Define a phony target for test that runs scripts/test.sh
• Define a phony target for test-cov that runs scripts/test-cov.sh
• Fix the target names in the Makefile (all targets are currently named lint in the issue description)
• Ensure all targets are properly marked as .PHONY
• Verify the Makefile works correctly with the existing scripts

File changes

Makefile

• Create a new Makefile at the root of the project
• Add a .PHONY declaration for all targets at the top
• Add an init target that runs bash scripts/init.sh
• Add a lint target that runs bash scripts/lint.sh src/
• Add a format target that runs bash scripts/format.sh src/
• Add a type-check target that runs bash scripts/type-check.sh src/
• Add a test target that runs bash scripts/test.sh
• Add a test-cov target that runs bash scripts/test-cov.sh
• Ensure each target has the correct name (fix the issue description where all targets were named lint)
• Add comments explaining what each target does

Verify changes

• cat Makefile
• make -n init
• make -n lint
• make -n format
• make -n type-check
• make -n test
• make -n test-cov

---

This plan was automatically generated.
Please review the plan carefully and make any necessary adjustments.