architecture/Makefile at main · konflux-ci/architecture · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# Konflux Architecture Makefile
# Provides targets for linting, validation, and development tasks

.PHONY: help build serve install lint lint-mermaid lint-adr-status lint-adr-numbers lint-eleventy-headers install-mermaid-cli clean

help:
	@echo "Available targets:"
	@echo "  help              - Show this help message"
	@echo "  build             - Build the site locally"
	@echo "  serve             - Build and serve the site with live reload"
	@echo "  install           - Install npm dependencies"
	@echo "  lint              - Run all linting and validation"
	@echo "  lint-mermaid      - Validate Mermaid diagrams in markdown files"
	@echo "  lint-adr-status   - Validate ADR statuses in all ADR files"
	@echo "  lint-adr-numbers  - Check for duplicate ADR numeric identifiers"
	@echo "  lint-eleventy-headers - Validate Eleventy front matter in markdown files"
	@echo "  install-mermaid-cli - Install Mermaid CLI tool locally"
	@echo "  clean             - Clean up generated files"

# Install dependencies
install:
	npm install

# Build the site
build: install
	@./hack/util/generate-adr-table > ADR/index.md
	npm run build

# Serve the site with live reload
serve: install
	npm run serve

# Main lint target - runs all validation
lint: lint-mermaid lint-adr-status lint-adr-numbers lint-eleventy-headers

# Mermaid diagram validation
lint-mermaid: install-mermaid-cli
	@./hack/lint-mermaid

# ADR status validation
lint-adr-status:
	@./hack/lint-adr-status

# ADR number uniqueness validation
lint-adr-numbers:
	@./hack/lint-adr-numbers

# Eleventy front matter validation
lint-eleventy-headers:
	@./hack/lint-eleventy-headers

# Install Mermaid CLI locally to user's home directory
install-mermaid-cli:
	@./hack/install-mermaid-cli

# Clean up generated files
clean:
	npm run clean
	@./hack/clean