leankg 0.19.10

Lightweight Knowledge Graph for AI-Assisted Development
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

# LeanKG Makefile

.PHONY: help build test lint run clean mcp-stdio mcp-http mcp-http-auth mcp-http-watch kill docker-build docker-push docker-run docker-reload docker-reload-tag docker-sync-binary docker-pull

DOCKER_IMAGE ?= freepeak/leankg
DOCKER_TAG ?= $(shell sed -n 's/^version = "\(.*\)"/\1/p' Cargo.toml | head -1)
HOST_DIR ?= $(PWD)

# Default target
help:
	@echo "LeanKG Makefile"
	@echo ""
	@echo "Targets:"
	@echo "  build           Build release binary"
	@echo "  test            Run tests"
	@echo "  lint            Run linter"
	@echo "  run             Run dev (stdio mode)"
	@echo "  clean           Clean build artifacts"
	@echo "  kill            Kill all leankg MCP processes"
	@echo ""
	@echo "Docker targets:"
	@echo "  docker-reload    Pull latest Hub image + recreate container (no build)"
	@echo "  docker-reload-tag Pull pinned version tag + recreate (interactive)"
	@echo "  docker-sync-binary  Build Linux binary + bind-mount onto Hub runtime"
	@echo "  docker-build    Build freepeak/leankg image (Dockerfile.rocksdb)"
	@echo "  docker-push     Push freepeak/leankg:VERSION and :latest"
	@echo "  docker-run      Run with HOST_DIR mounted at /workspace (default: \$$PWD)"
	@echo ""
	@echo "MCP Server targets (HTTP mode):"
	@echo "  mcp-http        Start MCP HTTP server on port 9699"
	@echo "  mcp-http-auth   Start MCP HTTP server with auth"
	@echo "  mcp-http-watch  Start MCP HTTP server with file watcher"
	@echo ""
	@echo "MCP Server targets (Stdio mode):"
	@echo "  mcp-stdio       Start MCP stdio server"
	@echo "  mcp-stdio-watch Start MCP stdio server with file watcher"

# Build release binary
build:
	cargo build --release

# Run tests
test:
	cargo test

# Run linter
lint:
	cargo clippy --all-targets --all-features -- -D warnings

# Run LeanKG (stdio mode for local dev)
run:
	cargo run --release

# Clean build artifacts
clean:
	cargo clean

# Kill all leankg processes (HTTP and stdio)
kill:
	pkill -9 -f "leankg.*mcp" 2>/dev/null || true
	@echo "All leankg MCP processes killed"

# === MCP Stdio Mode ===

mcp-stdio:
	cargo run --release -- mcp-stdio

mcp-stdio-watch:
	cargo run --release -- mcp-stdio --watch

# === MCP HTTP Mode ===

mcp-http:
	cargo run --release -- mcp-http

mcp-http-auth:
	cargo run --release -- mcp-http --auth "$(shell uuidgen 2>/dev/null || echo 'secret-token')"

mcp-http-watch:
	cargo run --release -- mcp-http --watch

# Start on custom port
mcp-http-port:
	@read -p "Enter port: " port; \
	cargo run --release -- mcp-http --port $$port

# === Development ===

dev:
	RUST_LOG=debug cargo run --release -- mcp-stdio --watch

# === Docker ===

docker-build:
	docker build -f Dockerfile.rocksdb \
		-t $(DOCKER_IMAGE):$(DOCKER_TAG) \
		-t $(DOCKER_IMAGE):latest \
		.

docker-push: docker-build
	docker push $(DOCKER_IMAGE):$(DOCKER_TAG)
	docker push $(DOCKER_IMAGE):latest

# One-line equivalent:
#   docker run -d --name leankg -p 9699:9699 -v "$$PWD:/workspace" -v leankg-rocksdb:/data/leankg-rocksdb freepeak/leankg:latest
docker-run:
	docker rm -f leankg 2>/dev/null || true
	docker run -d --name leankg -p 9699:9699 \
		-v "$(HOST_DIR):/workspace" \
		-v leankg-rocksdb:/data/leankg-rocksdb \
		$(DOCKER_IMAGE):latest
	@echo "LeanKG MCP listening on http://localhost:9699 (project: $(HOST_DIR))"
	@echo "Health: curl http://localhost:9699/health"

# Docker reload (no rebuild) — prefer these for version upgrades
docker-reload:
	./scripts/docker-reload.sh

docker-reload-tag:
	@read -p "Image tag (e.g., 0.19.4): " tag; \
	LEANKG_IMAGE=freepeak/leankg:$$tag ./scripts/docker-reload.sh

docker-sync-binary:
	./scripts/docker-sync-binary.sh

docker-pull:
	docker pull $(DOCKER_IMAGE):latest

# === Installation ===

install: build
	sudo cp target/release/leankg /usr/local/bin/

# === macOS LaunchAgent (auto-start on login) ===

mcp-http-launchd:
	./scripts/install-leankg-mcp-launchd.sh

mcp-http-launchd-unload:
	launchctl unload ~/Library/LaunchAgents/com.leankg.mcp-http.plist 2>/dev/null || true
	rm ~/Library/LaunchAgents/com.leankg.mcp-http.plist 2>/dev/null || true
	echo "LaunchAgent removed"

# === Auto-restart on rebuild ===

# Watch for binary changes and restart LaunchAgent service
# Run this in a separate terminal while developing
watch-build:
	./scripts/watch-leankg-build.sh

# Build and auto-reload (single command)
dev-watch: build
	./scripts/watch-and-reload.sh

# Kill and rebuild on next make
rebuild-mcp-http:
	launchctl stop com.leankg.mcp-http 2>/dev/null || true
	cargo build --release
	launchctl start com.leankg.mcp-http 2>/dev/null || true