# LibreFang Registry — Development Tooling # Usage: make help .DEFAULT_GOAL := help SHELL := /bin/bash TEMPLATES_DIR := templates AGENTS_DIR := agents HANDS_DIR := hands INTEGRATIONS_DIR := integrations SKILLS_DIR := skills PROVIDERS_DIR := providers # ── Validation ──────────────────────────────────────────────────────────────── .PHONY: validate validate: ## Run registry validation python3 scripts/validate.py .PHONY: validate-strict validate-strict: ## Run validation treating warnings as errors python3 scripts/validate.py --strict # ── Formatting ──────────────────────────────────────────────────────────────── .PHONY: fmt fmt: ## Format all TOML files with taplo (skips if not installed) @if command -v taplo >/dev/null 2>&1; then \ echo "Formatting TOML files..."; \ find . -name '*.toml' -not -path './.git/*' -exec taplo fmt {} +; \ echo "Done."; \ else \ echo "taplo not found — skipping TOML formatting."; \ echo "Install: cargo install taplo-cli or brew install taplo"; \ fi .PHONY: fmt-check fmt-check: ## Check TOML formatting without modifying @if command -v taplo >/dev/null 2>&1; then \ taplo fmt --check $$(find . -name '*.toml' -not -path './.git/*'); \ else \ echo "taplo not found — skipping format check."; \ echo "Install: cargo install taplo-cli or brew install taplo"; \ fi # ── Scaffolding ─────────────────────────────────────────────────────────────── .PHONY: new-agent new-agent: ## Scaffold a new agent (usage: make new-agent NAME=my-agent) @if [ -z "$(NAME)" ]; then echo "ERROR: NAME is required. Usage: make new-agent NAME=my-agent"; exit 1; fi @if [ -d "$(AGENTS_DIR)/$(NAME)" ]; then echo "ERROR: Agent '$(NAME)' already exists."; exit 1; fi @mkdir -p "$(AGENTS_DIR)/$(NAME)" @sed 's/{{NAME}}/$(NAME)/g' "$(TEMPLATES_DIR)/agent.toml" > "$(AGENTS_DIR)/$(NAME)/agent.toml" @echo "Created $(AGENTS_DIR)/$(NAME)/agent.toml" @echo "Next: edit the agent.toml to fill in TODO placeholders." .PHONY: new-hand new-hand: ## Scaffold a new hand (usage: make new-hand NAME=my-hand) @if [ -z "$(NAME)" ]; then echo "ERROR: NAME is required. Usage: make new-hand NAME=my-hand"; exit 1; fi @if [ -d "$(HANDS_DIR)/$(NAME)" ]; then echo "ERROR: Hand '$(NAME)' already exists."; exit 1; fi @mkdir -p "$(HANDS_DIR)/$(NAME)" @sed 's/{{NAME}}/$(NAME)/g' "$(TEMPLATES_DIR)/HAND.toml" > "$(HANDS_DIR)/$(NAME)/HAND.toml" @echo "Created $(HANDS_DIR)/$(NAME)/HAND.toml" @echo "Next: edit the HAND.toml to fill in TODO placeholders." .PHONY: new-integration new-integration: ## Scaffold a new integration (usage: make new-integration NAME=my-service) @if [ -z "$(NAME)" ]; then echo "ERROR: NAME is required. Usage: make new-integration NAME=my-service"; exit 1; fi @if [ -f "$(INTEGRATIONS_DIR)/$(NAME).toml" ]; then echo "ERROR: Integration '$(NAME)' already exists."; exit 1; fi @sed 's/{{NAME}}/$(NAME)/g' "$(TEMPLATES_DIR)/integration.toml" > "$(INTEGRATIONS_DIR)/$(NAME).toml" @echo "Created $(INTEGRATIONS_DIR)/$(NAME).toml" @echo "Next: edit the file to fill in TODO placeholders." .PHONY: new-skill new-skill: ## Scaffold a new skill (usage: make new-skill NAME=my-skill) @if [ -z "$(NAME)" ]; then echo "ERROR: NAME is required. Usage: make new-skill NAME=my-skill"; exit 1; fi @if [ -d "$(SKILLS_DIR)/$(NAME)" ]; then echo "ERROR: Skill '$(NAME)' already exists."; exit 1; fi @mkdir -p "$(SKILLS_DIR)/$(NAME)" @sed 's/{{NAME}}/$(NAME)/g' "$(TEMPLATES_DIR)/skill.toml" > "$(SKILLS_DIR)/$(NAME)/skill.toml" @echo "Created $(SKILLS_DIR)/$(NAME)/skill.toml" @echo "Next: edit the skill.toml to fill in TODO placeholders." .PHONY: new-provider new-provider: ## Scaffold a new provider (usage: make new-provider NAME=my-provider) @if [ -z "$(NAME)" ]; then echo "ERROR: NAME is required. Usage: make new-provider NAME=my-provider"; exit 1; fi @if [ -f "$(PROVIDERS_DIR)/$(NAME).toml" ]; then echo "ERROR: Provider '$(NAME)' already exists."; exit 1; fi @sed 's/{{NAME}}/$(NAME)/g' "$(TEMPLATES_DIR)/provider.toml" > "$(PROVIDERS_DIR)/$(NAME).toml" @echo "Created $(PROVIDERS_DIR)/$(NAME).toml" @echo "Next: edit the file to fill in TODO placeholders." # ── Help ────────────────────────────────────────────────────────────────────── .PHONY: help help: ## Show this help @echo "LibreFang Registry — Available targets:" @echo "" @grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \ awk 'BEGIN {FS = ":.*?## "}; {printf " \033[36m%-20s\033[0m %s\n", $$1, $$2}' @echo "" @echo "Scaffold examples:" @echo " make new-agent NAME=my-agent" @echo " make new-hand NAME=my-hand" @echo " make new-integration NAME=my-service" @echo " make new-skill NAME=my-skill" @echo " make new-provider NAME=my-provider"