graph-agent 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8feb3586679e9f720ecba6e24a00e616a6f093ca54959b0956b1c62eb5d93b4a
+  data.tar.gz: 6e6e28e26ae5f5f3437492f0ce0f74ffade68c764a490112c614aaff889f6dc0
+SHA512:
+  metadata.gz: 52b306b0a913a88a4f4eaa7a1e1a5d851c3a3cb5e533560c5e425d2575efbde112acbf16598ed928c952e697de1dae1939e204ff5945a6dd5584bec9d5686c28
+  data.tar.gz: 3eacf28616617bdd2e85ca178088ad864485860fa81d809bb1cb2eee97ee103d391d9ad8032edf018e872b8e2a275d807c7ccdc5877933eeb9f2b831c1141622

data/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        ruby-version: ['3.1', '3.2', '3.3', '3.4', '4.0']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Ruby ${{ matrix.ruby-version }}
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true
+
+    - name: Run tests
+      run: bundle exec rspec
+
+    - name: Run RuboCop
+      run: bundle exec rubocop
+      continue-on-error: true
+  
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.4'
+        bundler-cache: true
+    
+    - name: Build gem
+      run: gem build graph-agent.gemspec
+    
+    - name: Verify gem can be installed
+      run: gem install graph-agent-*.gem

data/.github/workflows/release.yml

@@ -0,0 +1,49 @@
+name: Release Gem
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.4'
+        bundler-cache: true
+    
+    - name: Run tests
+      run: bundle exec rspec
+    
+    - name: Build gem
+      run: gem build graph-agent.gemspec
+    
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p ~/.gem
+        echo ":rubygems_api_key: ${{ secrets.RUBYGEMS_API_KEY }}" > ~/.gem/credentials
+        chmod 0600 ~/.gem/credentials
+        gem push *.gem
+      env:
+        RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
+    
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v2
+      with:
+        files: "*.gem"
+        body: |
+          Changes in this Release
+          - Check CHANGELOG.md for details
+        draft: false
+        prerelease: false
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle/
+pkg/
+tmp/
+.rspec_status
+coverage/

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,126 @@
+require: []
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.1
+  SuggestExtensions: false
+  Exclude:
+    - "vendor/**/*"
+    - "tmp/**/*"
+    - "pkg/**/*"
+
+# ── Style ──
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Style/GuardClause:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/Next:
+  Enabled: false
+
+Style/RaiseArgs:
+  EnforcedStyle: compact
+
+Style/RescueStandardError:
+  EnforcedStyle: implicit
+
+Style/StringConcatenation:
+  Enabled: false
+
+Style/IdenticalConditionalBranches:
+  Enabled: false
+
+Style/SymbolProc:
+  Enabled: false
+
+Style/ConditionalAssignment:
+  Enabled: false
+
+# ── Metrics ──
+
+Metrics/MethodLength:
+  Max: 30
+  Exclude:
+    - "spec/**/*"
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*"
+    - "*.gemspec"
+
+Metrics/AbcSize:
+  Max: 35
+  Exclude:
+    - "spec/**/*"
+
+Metrics/CyclomaticComplexity:
+  Max: 12
+
+Metrics/PerceivedComplexity:
+  Max: 12
+
+Metrics/ClassLength:
+  Max: 250
+
+Metrics/ParameterLists:
+  Max: 8
+
+# ── Layout ──
+
+Layout/LineLength:
+  Max: 120
+  Exclude:
+    - "spec/**/*"
+
+Layout/FirstArrayElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent
+
+# ── Naming ──
+
+Naming/AccessorMethodName:
+  Enabled: false
+
+Naming/MethodParameterName:
+  Enabled: false
+
+Naming/PredicateMethod:
+  Enabled: false
+
+# ── Lint ──
+
+Lint/UnusedBlockArgument:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+Lint/UnderscorePrefixedVariableName:
+  Enabled: false
+
+Lint/SharedMutableDefault:
+  Enabled: false
+
+# ── Gemspec ──
+
+Gemspec/RequireMFA:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-02-10
+
+### Added
+- Initial release of GraphAgent Ruby SDK
+- Graph-based workflow engine with Pregel execution model
+- State management with Schema and typed fields
+- Built-in reducers: ADD, APPEND, MERGE, REPLACE, add_messages
+- StateGraph and MessageGraph for building workflows
+- Conditional edges with dynamic routing
+- Send (map-reduce) and Command (routing + state update) patterns
+- Checkpoint system with InMemorySaver for persistence
+- Human-in-the-loop support with interrupt_before/interrupt_after
+- Streaming execution with :values and :updates modes
+- Retry policies with exponential backoff and jitter
+- Mermaid diagram visualization for graph structures
+- Comprehensive error handling (GraphRecursionError, InvalidUpdateError, etc.)
+- Full test suite with RSpec

data/CLAUDE.md

@@ -0,0 +1,128 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 项目概述
+
+GraphAgent 是 LangGraph 的 Ruby 移植版，是一个用于构建有状态、多参与者代理工作流的 Ruby 框架。框架实现了 Pregel 执行模型（整体同步并行计算模型）。
+
+## 常用命令
+
+```bash
+# 安装依赖
+make install
+# 或
+bundle install
+
+# 运行测试
+make test
+# 或运行特定测试文件
+make test TEST=spec/graph/state_graph_spec.rb
+
+# 代码检查
+make lint        # 只检查不修复
+make format      # 自动修复格式问题
+
+# 构建 gem
+make build
+
+# 清理构建产物
+make clean
+
+# 交互式控制台（加载 gem）
+make console
+# 或
+bundle exec irb -r graph_agent
+
+# 发布流程
+make tag                    # 自动递增补丁版本并打 tag
+make tag VERSION=1.2.3      # 指定版本号打 tag
+make release                # tag + 推送到 RubyGems
+```
+
+## 核心架构
+
+### 目录结构
+
+```
+lib/graph_agent/
+├── graph/               # 图相关核心类
+│   ├── state_graph.rb       # StateGraph - 用于构建有向图的 DSL
+│   ├── compiled_state_graph.rb  # CompiledStateGraph - 编译后可执行的图
+│   ├── message_graph.rb     # MessageGraph - 预配置消息状态的便捷封装
+│   ├── node.rb              # Node - 图节点包装器
+│   ├── edge.rb              # Edge - 有向边
+│   ├── conditional_edge.rb  # ConditionalEdge - 条件边
+│   └── mermaid_visualizer.rb # Mermaid 图表可视化
+├── state/
+│   └── schema.rb            # Schema - 状态 schema 定义
+├── channels/                # Channel 抽象（当前主要是 last_value、binary_operator_aggregate 等）
+├── checkpoint/              # 状态持久化
+│   ├── base_saver.rb        # 检查点保存器基类
+│   └── in_memory_saver.rb   # 内存检查点实现
+├── types/
+│   ├── send.rb              # Send - 动态创建并行任务（map-reduce 模式）
+│   ├── command.rb           # Command - 状态更新 + 路由决策的组合
+│   ├── retry_policy.rb      # RetryPolicy - 节点重试策略
+│   ├── cache_policy.rb      # CachePolicy - 缓存策略
+│   ├── interrupt.rb         # Interrupt - 中断信号
+│   └── state_snapshot.rb    # StateSnapshot - 状态快照
+├── reducers.rb              # 内置 reducer 函数（ADD, APPEND, MERGE, REPLACE 等）
+├── errors.rb                # 异常类定义
+├── constants.rb             # 常量（START, END_NODE）
+└── version.rb               # 版本号
+```
+
+### 核心概念
+
+1. **State（状态）**: 共享数据结构，通过 Schema 定义。每个字段可以指定 reducer 来控制状态合并行为。
+   - 无 reducer 的字段使用 "last-value" 语义（直接替换）
+   - 有 reducer 的字段使用 reducer 定义的语义（如 ADD、MERGE）
+
+2. **Node（节点）**: 处理状态的函数，接收 state 和可选的 config 参数，返回状态更新（Hash）、Command 或 Send。
+
+3. **Edge（边）**: 定义节点间的流转
+   - 普通边：固定从 A 到 B
+   - 条件边：根据状态动态路由
+   - 等待边：多个源节点都执行完后才到目标节点
+
+4. **Pregel 执行流程**: PLAN → EXECUTE → UPDATE → CHECKPOINT → REPEAT
+
+### 关键类关系
+
+```
+StateGraph (builder)  →  CompiledStateGraph (executable)
+    ↓                      ↓
+  schema                 invoke/stream
+  nodes                  checkpointer
+  edges                  interrupt_before/after
+  branches
+```
+
+### Send 和 Command 的区别
+
+- **Send**: 用于条件边返回，动态创建并行执行任务，可传递独立参数
+- **Command**: 节点返回值，同时更新状态并指定下一个跳转的节点
+
+## 开发注意事项
+
+1. **Ruby 版本**: 最低要求 3.1.0
+
+2. **代码风格**: 使用 Rubocop 进行检查和格式化（`make format`）
+
+3. **测试**: 使用 RSpec，所有测试文件位于 `spec/` 目录
+
+4. **命名约定**:
+   - 内部方法以 `_` 前缀开头（如 `_normalize_schema`）
+   - 节点名称转换为字符串存储
+   - 所有配置键使用 Symbol
+
+5. **保留节点名**: `START` 和 `END_NODE`（实际字符串 "__start__" 和 "__end__"）是保留的入口/出口哨兵
+
+6. **状态更新**: 节点返回的 Hash 会通过 Schema 中定义的 reducer 进行合并
+
+7. **错误处理**:
+   - `GraphRecursionError`: 超过最大递归步数
+   - `InvalidUpdateError`: 无效的状态更新
+   - `NodeExecutionError`: 节点执行错误（包装原始错误）
+   - `GraphInterrupt`: 人为中断（用于 human-in-the-loop）

data/Gemfile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "rake", "~> 13.0"
+  gem "rspec", "~> 3.12"
+  gem "rubocop", "~> 1.50"
+end

data/Gemfile.lock

@@ -0,0 +1,94 @@
+PATH
+  remote: .
+  specs:
+    graph-agent (0.1.0)
+      concurrent-ruby (~> 1.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    concurrent-ruby (1.3.6)
+    diff-lcs (1.6.2)
+    json (2.18.1)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.10.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.84.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+
+PLATFORMS
+  arm64-darwin-23
+  ruby
+
+DEPENDENCIES
+  graph-agent!
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  rubocop (~> 1.50)
+
+CHECKSUMS
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  graph-agent (0.1.0)
+  json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  parser (3.3.10.1) sha256=06f6a725d2cd91e5e7f2b7c32ba143631e1f7c8ae2fb918fc4cebec187e6a688
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
+  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.7) sha256=0979034e64b1d7a838aaaddf12bf065ea4dc40ef3d4c39f01f93ae2c66c62b1c
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+  rubocop (1.84.1) sha256=14cc626f355141f5a2ef53c10a68d66b13bb30639b26370a76559096cc6bcc1a
+  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+
+BUNDLED WITH
+  4.0.3

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 GraphAgent Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/Makefile

@@ -0,0 +1,114 @@
+.PHONY: all install format lint test test_watch clean build console tag release help
+
+all: help
+
+######################
+# SETUP
+######################
+
+install: ## Install dependencies
+	bundle install
+
+######################
+# TESTING AND COVERAGE
+######################
+
+TEST ?= .
+
+test: ## Run the test suite (TEST=path/to/spec.rb to run a specific file)
+	bundle exec rspec $(if $(filter-out .,$(TEST)),$(TEST),)
+
+test_watch: ## Run tests in watch mode (requires guard-rspec)
+	bundle exec guard
+
+######################
+# LINTING AND FORMATTING
+######################
+
+format: ## Run code formatters
+	bundle exec rubocop -a
+
+lint: ## Run linters
+	bundle exec rubocop
+
+######################
+# BUILD AND RELEASE
+######################
+
+build: ## Build the gem
+	bundle exec rake build
+
+clean: ## Remove build artifacts
+	rm -f *.gem
+	rm -f graph-agent-*.gem
+	rm -rf pkg/ tmp/ coverage/ .rspec_status
+
+console: ## Start an interactive console with the gem loaded
+	bundle exec irb -r graph_agent
+
+tag: ## Create and push a version tag. Usage: make tag [VERSION=x.y.z]
+	@git fetch --tags; \
+	if [ -z "$(VERSION)" ]; then \
+		LATEST=$$(git tag -l 'v[0-9]*' --sort=-v:refname | head -n1); \
+		if [ -z "$$LATEST" ]; then \
+			NEW_TAG="v0.0.1"; \
+		else \
+			MAJOR=$$(echo $$LATEST | sed 's/^v//' | cut -d. -f1); \
+			MINOR=$$(echo $$LATEST | sed 's/^v//' | cut -d. -f2); \
+			PATCH=$$(echo $$LATEST | sed 's/^v//' | cut -d. -f3); \
+			PATCH=$$((PATCH + 1)); \
+			NEW_TAG="v$$MAJOR.$$MINOR.$$PATCH"; \
+		fi; \
+	else \
+		NEW_TAG="v$(VERSION)"; \
+		LATEST=$$(git tag -l 'v[0-9]*' --sort=-v:refname | head -n1); \
+		if [ "$$LATEST" = "$$NEW_TAG" ]; then \
+			echo "Tag $$NEW_TAG already exists on remote, deleting and re-pushing..."; \
+			git tag -d "$$NEW_TAG" 2>/dev/null || true; \
+			git push origin --delete "$$NEW_TAG" 2>/dev/null || true; \
+		elif git tag -l "$$NEW_TAG" | grep -q "$$NEW_TAG"; then \
+			echo "Error: Tag $$NEW_TAG exists but is not the latest tag (latest: $$LATEST). Aborting."; \
+			exit 1; \
+		fi; \
+	fi; \
+	NEW_VERSION=$$(echo $$NEW_TAG | sed 's/^v//'); \
+	echo "Updating version to $$NEW_VERSION ..."; \
+	sed -i '' "s/VERSION = [\"'].*[\"']/VERSION = '$$NEW_VERSION'/" lib/graph_agent/version.rb; \
+	git add lib/graph_agent/version.rb; \
+	git commit -m "Release $$NEW_TAG" --allow-empty; \
+	git tag "$$NEW_TAG"; \
+	echo "Pushing tag $$NEW_TAG ..."; \
+	git push origin HEAD; \
+	git push origin "$$NEW_TAG"; \
+	echo "Done! Tagged and pushed $$NEW_TAG"
+
+release: tag ## Release the gem (tag + push to RubyGems)
+	bundle exec rake release_gem
+
+######################
+# HELP
+######################
+
+help: ## Show this help
+	@echo '=========================='
+	@echo '  GraphAgent — Makefile'
+	@echo '=========================='
+	@echo ''
+	@echo 'SETUP'
+	@echo '  make install              — install dependencies'
+	@echo ''
+	@echo 'TESTING'
+	@echo '  make test                 — run the full test suite'
+	@echo '  make test TEST=spec/...   — run a specific test file'
+	@echo ''
+	@echo 'LINTING & FORMATTING'
+	@echo '  make format               — run code formatters'
+	@echo '  make lint                 — run linters'
+	@echo ''
+	@echo 'BUILD & RELEASE'
+	@echo '  make build                — build the gem'
+	@echo '  make clean                — remove build artifacts'
+	@echo '  make console              — start interactive console'
+	@echo '  make tag                  — auto-increment patch version, tag & push'
+	@echo '  make tag VERSION=x.y.z    — tag a specific version & push'
+	@echo '  make release              — tag + release gem to RubyGems'