htm 0.0.15 → 0.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ae4db5f168c495f5afef19f740f16ee9b39136cd54403f54090921cb6952275
-  data.tar.gz: 454816f53e620a72efeae7bd8b6c0a30c459403b4f1b6a3d0ca7adf30f3cda7c
+  metadata.gz: 964868a160989db5a7f8baa524e89d82552166f5d065f30685a17597ddec627b
+  data.tar.gz: 963b4d21d30ee51d08c34af26a1d2d1284b17d03ac39734ad81be0d0b3cd1a45
 SHA512:
-  metadata.gz: 52adbf798f4004961936f9112878d245c6872bf812611efa47bc9b7808ba39510d79d0902f109db8169e1cd0d5420338094edd7719f995f67c1b3def07a2a4d2
-  data.tar.gz: 7ac9e6a8913b9b836ddfdfdb909857ac62bdd2c5d6c6c904c2a257224fc80499a118afd3d63a3a14d0daed838e11c02b2f2149eddb8c0385ebb2d5be9ab258f8
+  metadata.gz: 2c061077debb17b3bcee1c70e1136cdf8d1248ca100815adb75eb522aa39c40ac1a8863c07684d89da36a7c8df37f6b22b3c98669939cfaf177ea37d51716435
+  data.tar.gz: 49b6ec15849051d17c85261d7529374d7d5f95be381b96415c10e0e883b08c3f52c5b3303c04ae850376dd23682dd4f387218eed1c6a5b1fab28c2f8eac2c183

data/.envrc

@@ -2,6 +2,7 @@
 
 export RR=`pwd`
 
+export RAILS_ENV=development
 export HTM_EXTRACT_PROPOSITIONS=true
 
 # Database connection - Localhost PostgreSQL

data/CHANGELOG.md

@@ -7,6 +7,73 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.17] - 2025-12-18
+
+### Added
+- **HTM_ENV environment variable** - Non-Rails users can now use `HTM_ENV` instead of `RAILS_ENV`
+  - Priority: `HTM_ENV` > `RAILS_ENV` > `RACK_ENV` > `'development'`
+  - `HTM.env` returns the current environment name
+  - `HTM.test?`, `HTM.development?`, `HTM.production?` helper methods
+  - Example: `HTM_ENV=test htm_mcp setup`
+- **MCP CLI subcommands** - `bin/htm_mcp` now supports multiple commands for database management
+  - `htm_mcp setup` / `htm_mcp init` - Initialize database schema
+  - `htm_mcp verify` - Verify database connection, extensions, and migration status
+  - `htm_mcp stats` - Show memory statistics including database size and file sources
+  - `htm_mcp version` - Show HTM version
+  - `htm_mcp help` - Comprehensive help with all environment variables
+  - `htm_mcp` / `htm_mcp server` / `htm_mcp stdio` - Start MCP server (default behavior)
+- **Migration status display** - `htm_mcp verify` now shows applied/pending migrations with +/- indicators
+- **Database size in stats** - `htm_mcp stats` displays database size via `pg_size_pretty`
+- **Error suggestions** - CLI provides helpful suggestions for common database errors (connection refused, missing database, auth failures, missing extensions)
+- **Rails demo application** - Full-featured web UI for exploring HTM capabilities
+  - Located in `examples/rails_app/` - minimal Rails 7.2 application
+  - **Dashboard** - Overview of memories, robots, tags, and files with quick stats
+  - **Memories** - Browse, create, edit, delete, and restore memories with tag filtering
+  - **Search** - Semantic search with vector/fulltext/hybrid strategies and strategy comparison mode
+  - **Tags** - Hierarchical tag browser with memory counts
+  - **Robots** - View robots, switch active robot, see memory associations
+  - **Files** - Load markdown files via path or native file picker, directory uploads, sync tracking
+  - Dark theme UI using Tailwind CSS
+  - Upload progress overlay with stage indicators
+  - Error handling with graceful degradation for search failures
+- **FileSource#needs_sync? default argument** - Now works without argument by reading file mtime from filesystem
+- **RobotGroup MCP tools** - 12 new tools for high-availability robot coordination
+  - `CreateGroupTool` - Create a new robot group with shared working memory
+  - `ListGroupsTool` - List all active robot groups in the session
+  - `GetGroupStatusTool` - Get detailed status of a robot group
+  - `JoinGroupTool` - Add a robot to an existing group
+  - `LeaveGroupTool` - Remove a robot from a group
+  - `GroupRememberTool` - Store memory shared across group members
+  - `GroupRecallTool` - Recall memories from a group's shared context
+  - `GetGroupWorkingMemoryTool` - Get a group's working memory contents
+  - `PromoteRobotTool` - Promote a passive robot to active role
+  - `FailoverTool` - Trigger failover to next available robot
+  - `SyncGroupTool` - Synchronize group state across members
+  - `ShutdownGroupTool` - Gracefully shutdown a robot group
+- **RobotGroups MCP resource** - `htm://groups` returns active robot groups and their status
+- **MCPGroupSession module** - Session state management for robot groups in MCP server
+- **MCP server test suite** - 59 tests with 174 assertions covering all tools and resources
+
+### Changed
+- **Renamed `bin/htm_mcp.rb` to `bin/htm_mcp`** - Cleaner executable name without extension
+- **MCP server refactored into modules** - Code moved from monolithic file to `lib/htm/mcp/`:
+  - `lib/htm/mcp/cli.rb` - CLI command handling
+  - `lib/htm/mcp/server.rb` - Server setup and lifecycle
+  - `lib/htm/mcp/tools.rb` - Individual MCP tools (11 tools)
+  - `lib/htm/mcp/group_tools.rb` - Robot group tools (12 tools)
+  - `lib/htm/mcp/resources.rb` - MCP resources (4 resources)
+- **README.md MCP section** - Reorganized tools by category (Session & Memory, Robot Group)
+- **docs/guides/mcp-server.md** - Comprehensive RobotGroup tools documentation with examples, updated for CLI commands
+
+### Fixed
+- **MCP server direct execution** - Added `require 'bundler/setup'` to `bin/htm_mcp` for execution without `bundle exec`
+  - Fixes timeout issues when MCP clients invoke the server directly
+  - Server now loads gems correctly from Gemfile when run as `./bin/htm_mcp`
+- **ontology_test.rb** - Added `configure_htm_with_mocks` to prevent real LLM calls during tests
+  - `test_node_creation_without_tags` and `test_empty_tag_array_no_topics` now pass
+- **job_adapter_test.rb** - Fixed environment detection test to properly handle `HTM_ENV` priority
+  - Test now saves and restores all relevant environment variables (`HTM_ENV`, `RAILS_ENV`, `RACK_ENV`)
+
 ## [0.0.15] - 2025-12-06
 
 ### Added