|
| 1 | +# Release v0.0.3 - December 08, 2025 |
| 2 | + |
| 3 | +## 📊 Release Statistics |
| 4 | +- **6 commits** from **1 contributor** |
| 5 | +- Released on **December 08, 2025** |
| 6 | + |
| 7 | +## Key Highlights |
| 8 | +This release introduces **MCP (Model Context Protocol) server support**, enabling AI agents to interact with gydnc through standardized MCP tool calls. We've also improved developer experience with better CLI guidance, cleaner documentation, and installation script fixes. |
| 9 | + |
| 10 | +## ✨ Features |
| 11 | + |
| 12 | +### 🚀 MCP Server Support |
| 13 | +- **New `mcp-server` command**: Run gydnc as a Model Context Protocol server over stdio, allowing AI agents to interact with the guidance knowledge base through standardized MCP tool calls. ([caf8105](https://github.com/ofthemachine/gydnc/commit/caf81059c44877999a49b23ced81e58b368797f7)) |
| 14 | + - Exposes `gydnc_read` tool for listing and retrieving guidance entities |
| 15 | + - Exposes `gydnc_write` tool for creating and updating guidance entities |
| 16 | + - Supports both list/get operations (read) and create/update operations (write) |
| 17 | + - Includes comprehensive integration tests for all MCP operations |
| 18 | + |
| 19 | +### 📚 Enhanced Developer Experience |
| 20 | +- **New `gydnc llm` command**: Provides standardized interaction protocol documentation for LLMs working with gydnc, improving AI agent integration. ([e56ccb9](https://github.com/ofthemachine/gydnc/commit/e56ccb9ee6fdaad00006e6428c13a6cd3b9ba541)) |
| 21 | +- **Improved Cursor rule guidance**: Updated interaction framework rules to better guide AI agents in using gydnc effectively. ([e56ccb9](https://github.com/ofthemachine/gydnc/commit/e56ccb9ee6fdaad00006e6428c13a6cd3b9ba541)) |
| 22 | + |
| 23 | +## 🐛 Bug Fixes |
| 24 | +- **Installation script fixes**: Resolved issues in the install.sh script for more reliable binary installation. ([5d62fd6](https://github.com/ofthemachine/gydnc/commit/5d62fd68fabdb706aacaaa883dd5be1faf8291fb)) |
| 25 | + |
| 26 | +## 🔧 Improvements |
| 27 | +- **Documentation cleanup**: Streamlined gydnc guidance to be more concise and actionable, removing unnecessary verbosity. ([c4533e8](https://github.com/ofthemachine/gydnc/commit/c4533e8f7d7ac3adfaf27e2110ee2cfc60f9cd83)) |
| 28 | +- **Configuration path handling**: Enhanced `GetEffectiveConfigPath` to automatically append `config.yml` when a directory path is provided, improving usability. ([caf8105](https://github.com/ofthemachine/gydnc/commit/caf81059c44877999a49b23ced81e58b368797f7)) |
| 29 | +- **Cursor rule organization**: Cleaned up rule structure and temporary file location guidance for better maintainability. ([2fb1e9b](https://github.com/ofthemachine/gydnc/commit/2fb1e9bf96dc2f80548724725d9c0d3f5a96433d)) |
| 30 | + |
| 31 | +## 🎯 What's Next |
| 32 | + |
| 33 | +The MCP server support opens up new possibilities for AI agent integration. Agents can now discover, retrieve, and manage guidance through the standardized MCP protocol, making gydnc more accessible to AI-powered development workflows. |
| 34 | + |
| 35 | +## Quick Start |
| 36 | + |
| 37 | +### Using the CLI |
| 38 | +```bash |
| 39 | +# Initialize a guidance repository |
| 40 | +mkdir my-guidance && cd my-guidance |
| 41 | +gydnc init . |
| 42 | + |
| 43 | +# Set configuration |
| 44 | +export GYDNC_CONFIG="$(pwd)/.gydnc/config.yml" |
| 45 | + |
| 46 | +# Create guidance |
| 47 | +echo "# Safety Guidelines\nValidate all inputs." | \ |
| 48 | + gydnc create must/safety-first --title "Safety First" \ |
| 49 | + --tags "quality:safety" |
| 50 | + |
| 51 | +# List and retrieve guidance |
| 52 | +gydnc list |
| 53 | +gydnc get must/safety-first |
| 54 | +``` |
| 55 | + |
| 56 | +### Using the MCP Server |
| 57 | +```bash |
| 58 | +# Run gydnc as an MCP server (communicates via JSON-RPC over stdio) |
| 59 | +gydnc mcp-server |
| 60 | + |
| 61 | +# The server exposes two tools: |
| 62 | +# - gydnc_read: List and retrieve guidance entities |
| 63 | +# - gydnc_write: Create and update guidance entities |
| 64 | +``` |
| 65 | + |
| 66 | +### For AI Agents |
| 67 | +```bash |
| 68 | +# Get interaction protocol documentation |
| 69 | +gydnc llm |
| 70 | +``` |
| 71 | + |
| 72 | +## Download |
| 73 | + |
| 74 | +Download the latest release for your platform: |
| 75 | + |
| 76 | +- **Linux (x86_64)**: [gydnc-linux-amd64](https://github.com/ofthemachine/gydnc/releases/download/v0.0.3/gydnc-linux-amd64) |
| 77 | +- **macOS (Intel)**: [gydnc-darwin-amd64](https://github.com/ofthemachine/gydnc/releases/download/v0.0.3/gydnc-darwin-amd64) |
| 78 | +- **macOS (Apple Silicon)**: [gydnc-darwin-arm64](https://github.com/ofthemachine/gydnc/releases/download/v0.0.3/gydnc-darwin-arm64) |
| 79 | + |
| 80 | +**Verification**: SHA256 checksums are available in the [GitHub release page](https://github.com/ofthemachine/gydnc/releases/tag/v0.0.3). |
| 81 | + |
| 82 | +## Full Changelog |
| 83 | + |
| 84 | +- [b58d0a5](https://github.com/ofthemachine/gydnc/commit/b58d0a598b5f794b8074efd00a58876577d16a3b) - Remove dead code in handleCreateOperation |
| 85 | +- [caf8105](https://github.com/ofthemachine/gydnc/commit/caf81059c44877999a49b23ced81e58b368797f7) - gydnc mcp-server, support core operations via MCP |
| 86 | +- [c4533e8](https://github.com/ofthemachine/gydnc/commit/c4533e8f7d7ac3adfaf27e2110ee2cfc60f9cd83) - Keep gydnc concise |
| 87 | +- [e56ccb9](https://github.com/ofthemachine/gydnc/commit/e56ccb9ee6fdaad00006e6428c13a6cd3b9ba541) - Improve Cursor rule + `gydnc llm` command |
| 88 | +- [2fb1e9b](https://github.com/ofthemachine/gydnc/commit/2fb1e9bf96dc2f80548724725d9c0d3f5a96433d) - Clean up Rule and tmp file location |
| 89 | +- [5d62fd6](https://github.com/ofthemachine/gydnc/commit/5d62fd68fabdb706aacaaa883dd5be1faf8291fb) - Fix install.sh script |
| 90 | + |
| 91 | +--- |
| 92 | + |
| 93 | +**Note**: The filesystem backend works well with Git for version control, but Git is not required. All guidance is stored as human-readable Markdown files with YAML frontmatter. |
| 94 | + |
0 commit comments