develop

.gitignore

@@ -7,3 +7,20 @@
 /spec/reports/
 /tmp/
 .aigcm_msg
+
+# Local tooling and generated files
+/.claude/
+/.serena/
+/site/
+/Gemfile.lock
+*.gem
+
+# Local scratch files
+CLAUDE.md
+fix_problems_plan.md
+more_tool_ideas.md
+self_agency.md
+temp.md
+workflow_tool_gaps.md
+screenshot_*.png
+examples/.workflows/

CHANGELOG.md

@@ -1,22 +1,52 @@
 # Changelog
 
-## Unreleased
-
 ## Released
-### [0.3.1] 2025-12-17
-
-- added ClipboardTool for cross-platform clipboard read/write operations
-- added CronTool for cron expression parsing and scheduling
-- added CurrentDateTimeTool for date/time retrieval with timezone support
-- added DnsTool for DNS lookups and resolution
-- added SystemInfoTool for system information retrieval
-- updated gem dependencies and Zeitwerk configuration
-- improved BrowserTool, ComputerTool, and DatabaseTool implementations
-- updated GitHub Pages deployment workflow
-- fixed a problem with eager loading when used with the `aia` gem
-
-### [0.3.0] 2025-11-08
-- changed focus of shared_tools to only support the ruby_llm and ruby_llm-mcp ecosystem
+
+### [0.4.1] - 2026-03-26
+
+#### MCP Clients
+- Added `SharedTools.mcp_status` — prints a formatted table of loaded vs. skipped clients
+- Added `SharedTools.mcp_loaded` — returns array of successfully loaded client names
+- Added `SharedTools.mcp_failed` — returns hash of skipped client names mapped to their error messages
+- Added `SharedTools.record_mcp_result` — thread-safe internal method used by `mcp.rb` to record each client's load outcome
+- Fixed `mcp.rb` thread exception handling: changed `rescue => e` to `rescue Exception => e` so `LoadError` (a `ScriptError`, not a `StandardError`) is caught and the thread does not terminate with an unhandled exception
+- Added SSE line-ending normalization patch (`mcp/streamable_http_patch.rb`) for MCP servers that mix `\n` and `\r\n` line endings in SSE responses (e.g. Tavily), fixing a 30-second `tools/list` timeout
+- Added brew-installed MCP clients: Notion (`notion_client.rb`), Slack (`slack_client.rb`), Hugging Face (`hugging_face_client.rb`)
+- All `package_install` methods now raise `LoadError` on failure (consistent with `verify_envars`)
+- Added demo scripts: `examples/mcp/notion_demo.rb`, `examples/mcp/slack_demo.rb`, `examples/mcp/hugging_face_demo.rb`
+
+#### Tests
+- Added `test/shared_tools/utilities_test.rb` — 28 tests covering `verify_envars`, `brew_install`, `npm_install`, `gem_install`, `package_install`, and MCP load tracking methods
+- Added `test/shared_tools/mcp/streamable_http_patch_test.rb` — 15 tests covering SSE buffer normalization for all line-ending variants (`\n\n`, `\r\n\r\n`, mixed `\n\r\n`, bare `\r`)
+
+#### Documentation
+- Updated `README.md` with MCP Clients section covering all three transport categories
+- Updated `examples/README.md` with entries for all 10 `examples/mcp/` demos and expanded environment variables table
+- Updated `docs/getting-started/installation.md` with MCP client setup section
+- Updated `docs/index.md` and `lib/shared_tools/mcp/README.md` with Notion, Slack, and Hugging Face client details
+
+### [0.4.0] - 2026-03-25
+
+#### MCP Clients
+- Added Tavily MCP client (`mcp/tavily_client.rb`) — AI-optimized web search via remote HTTP transport
+- Added GitHub MCP client (`mcp/github_client.rb`) — repos, issues, PRs, code search via brew-installed binary
+- Added Memory MCP client (`mcp/memory_client.rb`) — persistent knowledge graph via npx
+- Added Sequential Thinking MCP client (`mcp/sequential_thinking_client.rb`) — chain-of-thought reasoning via npx
+- Added Chart MCP client (`mcp/chart_client.rb`) — chart generation via npx
+- Added Brave Search MCP client (`mcp/brave_search_client.rb`) — web/news search via npx
+- Added `mcp.rb` bulk loader — requires all available clients concurrently in parallel threads; missing-key clients silently skipped
+- Added `SharedTools.verify_envars` — raises `LoadError` listing missing environment variable names
+- Added `SharedTools.package_install`, `brew_install`, `apt_install`, `dnf_install`, `npm_install`, `gem_install` in `utilities.rb`
+
+#### Tools
+- Added `NotificationTool` — cross-platform desktop notifications (`notify`), modal alert dialogs (`alert`), and text-to-speech (`speak`) for macOS and Linux
+- Added screenshot capability to `BrowserTool`
+- Added array argument support to `Docker::ComposeRunTool`
+
+#### Examples
+- Added `examples/mcp/` subdirectory with individual demo scripts for each MCP client
+- Added `examples/mcp/common.rb` shared helper for MCP demos
+
 
 ### [0.2.1] 2025-07-03
 - iMCP server app for MacOS is noisy logger so redirect stderr to /dev/null

Gemfile

@@ -6,4 +6,5 @@ source "https://rubygems.org"
 gemspec
 
 # Development dependencies
-gem "simplecov", require: false
+gem "simplecov",    require: false
+gem "minitest-mock", require: false   # stub/mock support for Minitest 6 (removed from core)