Repository navigation
Expand file tree
/
Copy pathMakefile
More file actions
182 lines (153 loc) · 8.63 KB
/
Copy pathMakefile
File metadata and controls
182 lines (153 loc) · 8.63 KB
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
# agentic-agile — developer & release entrypoint.
# Run `make` (no target) for help.
SHELL := bash
.DEFAULT_GOAL := help
PLUGIN := agentic-agile
MARKET := agentic-agile-marketplace
PLUGIN_DIR := plugin
CTX := plugin/tools/ctx-symbols
MDDB := plugin/tools/md-db
BIN_DIR ?= $(HOME)/.local/bin
REPO := $(CURDIR)
VERSION := $(shell python3 -c "import json;print(json.load(open('plugin/.claude-plugin/plugin.json'))['version'])")
TAG := v$(VERSION)
PKG_DIR := package
PKG := $(PKG_DIR)/agentic-agile-$(TAG).tar.gz
# Colors
C := \033[36m
B := \033[1m
R := \033[0m
.PHONY: help
help: ## Show this help
@printf "$(B)agentic-agile$(R) v$(VERSION)\n\n"
@printf "Usage: make $(C)<target>$(R)\n\n"
@grep -hE '^[a-zA-Z0-9_-]+:.*?## ' $(MAKEFILE_LIST) \
| sort | awk 'BEGIN{FS=":.*?## "}{printf " $(C)%-16s$(R) %s\n",$$1,$$2}'
# ── Build / install ────────────────────────────────────────────────
.PHONY: build
build: ## Build ctx-symbols + md-db (release)
cd $(CTX) && cargo build --release
cd $(MDDB) && cargo build --release
.PHONY: install
install: ## Build + install ctx-symbols and md-db to BIN_DIR
./plugin/tools/install.sh "$(BIN_DIR)"
.PHONY: link
link: ## Register THIS repo as a local marketplace and install the plugin (dev)
@command -v claude >/dev/null || { echo "claude CLI not found — install: curl -fsSL https://claude.ai/install.sh | bash -s stable"; exit 1; }
claude plugin marketplace add "$(REPO)"
claude plugin install "$(PLUGIN)@$(MARKET)"
.PHONY: unlink
unlink: ## Uninstall the plugin and remove the local marketplace
-claude plugin uninstall "$(PLUGIN)@$(MARKET)"
-claude plugin marketplace remove "$(MARKET)"
# ── Format / lint / test ───────────────────────────────────────────
.PHONY: fmt
fmt: ## Format ctx-symbols
cd $(CTX) && cargo fmt
.PHONY: fmt-check
fmt-check: ## Check formatting (no writes)
cd $(CTX) && cargo fmt --all -- --check
.PHONY: clippy
clippy: ## Clippy with warnings-as-errors
cd $(CTX) && cargo clippy --all-targets -- -D warnings
.PHONY: shellcheck
shellcheck: ## Lint gate scripts (skipped with a warning if shellcheck is absent)
@command -v shellcheck >/dev/null \
&& shellcheck -S error -e SC1091 plugin/bin/_gatelib.sh $$(grep -l "^#!/usr/bin/env bash" plugin/bin/gate-*) plugin/bin/log-execution \
plugin/bin/selfcheck plugin/bin/transcripts plugin/bin/worktree-create plugin/bin/worktree-remove \
plugin/bin/worktree-hygiene plugin/bin/ensure-tools plugin/bin/md-db plugin/bin/ctx-symbols \
plugin/bin/session-start plugin/bin/_paths.sh plugin/bin/agentic plugin/bin/bind plugin/bin/task-worktree \
|| echo "WARN: shellcheck not installed; skipping (CI enforces it)"
.PHONY: pycheck
pycheck: ## Byte-compile the Python hook scripts
@python3 -m py_compile plugin/bin/budget plugin/bin/stats plugin/bin/agentic-init plugin/bin/gate-commit-author plugin/bin/_paths.py \
plugin/bin/_usage.py plugin/bin/host-adapter plugin/bin/install \
&& rm -rf plugin/bin/__pycache__ && echo "python ok"
.PHONY: test-hosts
test-hosts: ## Budget/worktree regression + Codex hooks emulation + OpenCode plugin end-to-end (no network, no tokens)
@command -v node >/dev/null && node --check plugin/hosts/opencode/agentic-agile.js
python3 scripts/test/budget-worktree.test.py
python3 scripts/test/codex-hooks.test.py
@command -v node >/dev/null && node scripts/test/opencode-plugin.test.mjs || { echo "node not found — skipped OpenCode test (CI runs it)"; }
.PHONY: json
json: ## Validate plugin.json + marketplace.json
@python3 -c "import json;json.load(open('plugin/.claude-plugin/plugin.json'));json.load(open('.claude-plugin/marketplace.json'));print('JSON ok')"
.PHONY: lint
lint: clippy shellcheck pycheck json ## Run all linters
.PHONY: test
test: ## Run ctx-symbols + md-db unit tests
cd $(CTX) && cargo test --all-targets
cd $(MDDB) && cargo test --release
.PHONY: validate
validate: json ## claude plugin validate --strict
@command -v claude >/dev/null || { echo "claude CLI not found — install: curl -fsSL https://claude.ai/install.sh | bash -s stable"; exit 1; }
claude plugin validate ./plugin --strict
.PHONY: ci
ci: fmt-check lint test eval-validate test-hosts ## Run everything CI runs (except the live claude install)
# ── Evals ──────────────────────────────────────────────────────────
.PHONY: eval-validate
eval-validate: ## Validate every eval suite's JSON (no tokens)
@python3 scripts/eval/validate-suites.py
.PHONY: eval
eval: ## Run an eval suite: make eval SUITE=<evals.json> [YES=1] (YES spends tokens)
@test -n "$(SUITE)" || { echo "set SUITE=<path to evals.json> (see plugin/evals/ or the skill's evals/)"; exit 2; }
@./scripts/eval/run-evals.sh --suite "$(SUITE)" $(if $(YES),--yes,) $(if $(ITER),--iteration $(ITER),)
# ── Release / publish ──────────────────────────────────────────────
.PHONY: version
version: ## Print the current version
@echo "$(VERSION)"
.PHONY: version-check
version-check: ## Assert plugin.json, Cargo.toml, and CHANGELOG agree
@python3 scripts/version-check.py
.PHONY: release
release: ci validate version-check ## Verify, then create annotated git tag vX.Y.Z
@git rev-parse --git-dir >/dev/null 2>&1 || { echo "not a git repo — run: git init && git add -A && git commit -m init"; exit 1; }
@test -z "$$(git status --porcelain)" || { echo "working tree dirty — commit first"; exit 1; }
@git rev-parse "$(TAG)" >/dev/null 2>&1 && { echo "tag $(TAG) already exists"; exit 1; } || true
git tag -a "$(TAG)" -m "agentic-agile $(TAG)"
@echo "Tagged $(TAG). Run 'make publish' to push."
.PHONY: publish
publish: ## Push the current branch + tags to origin (run after `make release`)
@git rev-parse --git-dir >/dev/null 2>&1 || { echo "not a git repo"; exit 1; }
@git remote get-url origin >/dev/null 2>&1 || { echo "no 'origin' remote — git remote add origin <url>"; exit 1; }
git push origin HEAD
git push origin --tags
@echo "Published. Users: /plugin marketplace add <repo-url> && /plugin install $(PLUGIN)@$(MARKET)"
.PHONY: package
package: ## Bundle the release into package/ and publish it as the GitHub release for $(TAG)
@command -v gh >/dev/null || { echo "gh CLI not found — https://cli.github.com"; exit 1; }
@git rev-parse "$(TAG)" >/dev/null 2>&1 || { echo "tag $(TAG) missing — run 'make release && make publish' first"; exit 1; }
@mkdir -p $(PKG_DIR)
@rm -f "$(PKG)" "$(PKG).sha256" "$(PKG_DIR)/notes-$(TAG).md"
tar --no-xattrs \
--exclude='.git' --exclude='target' --exclude='.agentic' --exclude='.transcripts' \
--exclude='.DS_Store' --exclude='node_modules' --exclude='$(PKG_DIR)' \
-czf "$(PKG)" .claude-plugin plugin README.md CHANGELOG.md LICENSE
@cd $(PKG_DIR) && shasum -a 256 "$(notdir $(PKG))" > "$(notdir $(PKG)).sha256"
@awk -v v='$(VERSION)' 'BEGIN{p=0} $$0 ~ "^## \\["v"\\]"{p=1;next} /^## \[/{if(p)exit} p' CHANGELOG.md > "$(PKG_DIR)/notes-$(TAG).md"
@test -s "$(PKG_DIR)/notes-$(TAG).md" || echo "agentic-agile $(TAG)" > "$(PKG_DIR)/notes-$(TAG).md"
@echo "Built $(PKG)"
@if gh release view "$(TAG)" >/dev/null 2>&1; then \
gh release upload "$(TAG)" "$(PKG)" "$(PKG).sha256" --clobber; \
gh release edit "$(TAG)" --latest --notes-file "$(PKG_DIR)/notes-$(TAG).md"; \
else \
gh release create "$(TAG)" "$(PKG)" "$(PKG).sha256" --title "agentic-agile $(TAG)" \
--notes-file "$(PKG_DIR)/notes-$(TAG).md" --latest; \
fi
@echo "Published GitHub release $(TAG) with $(notdir $(PKG))."
# ── Hooks / housekeeping ───────────────────────────────────────────
.PHONY: hooks
hooks: ## Install the tracked git hooks (sets core.hooksPath)
git config core.hooksPath .githooks
chmod +x .githooks/* 2>/dev/null || true
@echo "git hooks installed (.githooks): pre-commit, pre-push"
.PHONY: smoke
smoke: build ## Quick offline gate smoke test (structural gate on a tmp tree)
@export PATH="$(BIN_DIR):$$PATH"; \
cp "$(CTX)/target/release/ctx-symbols" "$(BIN_DIR)/ctx-symbols" 2>/dev/null || true; \
T=$$(mktemp -d); printf 'pub fn a(){let x=1;}\npub fn caller(){a();}\n' > "$$T/a.rs"; \
REPO_DIR="$$T" CLAUDE_PLUGIN_ROOT="$(CURDIR)/plugin" plugin/bin/gate-structural-integrity; \
echo "structural gate exit=$$?"; rm -rf "$$T"
.PHONY: clean
clean: ## Remove build artifacts
cd $(CTX) && cargo clean