@jaguilar87/gaia-ops 2.2.1 → 2.2.2

package/CHANGELOG.md

@@ -7,6 +7,80 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.2.2] - 2025-11-11
+
+### Added - Pre-generated Semantic Embeddings
+- **NEW:** Included pre-generated intent embeddings in package (74KB total)
+  - `config/intent_embeddings.json` (55KB) - Semantic vectors for intent matching
+  - `config/intent_embeddings.npy` (19KB) - Binary embeddings for fast loading
+  - `config/embeddings_info.json` (371B) - Metadata about embeddings
+
+### Changed - Semantic Routing Now Works Out-of-the-Box
+- **Semantic matching enabled by default:** No manual setup required
+- **Routing accuracy improved:** Ambiguous queries now route correctly using semantic similarity
+- **Example improvement:**
+  ```
+  Query: "puede decirme el estado de los servicios de tcm?"
+  Before: devops-developer (keyword "ci" - incorrect)
+  After: gitops-operator (semantic matching - correct)
+  ```
+
+### Fixed - Directory Structure Consistency
+- **Consolidated `configs/` into `config/`:** All configuration and data files now in single directory
+- **Updated tool references:**
+  - `tools/semantic_matcher.py`: Updated embeddings path (configs/ → config/)
+  - `tools/generate_embeddings.py`: Updated output path (configs/ → config/)
+  - All documentation updated to reference correct paths
+
+### Fixed - Test Suite (254 tests, 100% passing)
+- **tests/system/test_configuration_files.py:**
+  - Updated to validate `templates/settings.template.json` (package contains template, not installed settings.json)
+  - Tests now reflect npm package structure instead of installed project structure
+
+- **tests/system/test_directory_structure.py:**
+  - Completely rewritten for npm package validation
+  - Tests now verify package directories (agents/, tools/, config/, templates/, bin/)
+  - Removed tests for installed-project structure (session/, .claude/ name)
+  - Added comprehensive tests for all package subdirectories (agents, tools, hooks, config, speckit)
+
+- **tests/tools/test_clarify_engine.py:**
+  - Fixed import paths (tests/tools → gaia-ops/tools)
+  - Made emoji checks flexible (accepts any emoji, not just 📦)
+  - All 32 clarify_engine tests now pass
+
+- **tests/tools/test_context_provider.py:**
+  - Updated troubleshooter contract test (application_services is optional, not required)
+  - Fixed invalid_agent test expectation (now correctly exits with code 1)
+
+- **tools/context_provider.py:**
+  - Changed behavior for invalid agents: now exits with code 1 (was: warning + empty contract)
+  - Better error messages: "ERROR: Invalid agent" instead of "Warning: No contract found"
+
+### Benefits
+- ✅ **Zero configuration:** Semantic routing works immediately after installation
+- ✅ **Better routing:** Handles ambiguous queries with 6x higher confidence
+- ✅ **Consistent structure:** All config files in one place (`config/`)
+- ✅ **Smaller package:** Embeddings optimized for size (74KB vs 5MB unoptimized)
+- ✅ **Regeneration optional:** Users can regenerate with `python3 .claude/tools/generate_embeddings.py` if needed
+- ✅ **Test coverage:** 254 tests passing (0 failures)
+
+### Technical Details
+```
+config/ directory now contains:
+├── Documentation (markdown)
+│   ├── AGENTS.md, agent-catalog.md, context-contracts.md
+│   ├── git-standards.md, orchestration-workflow.md
+├── Provider Contracts (JSON)
+│   ├── context-contracts.gcp.json, context-contracts.aws.json
+│   └── git_standards.json
+└── Semantic Embeddings (JSON + binary) ← NEW
+    ├── intent_embeddings.json
+    ├── intent_embeddings.npy
+    └── embeddings_info.json
+```
+
+---
+
 ## [2.2.1] - 2025-11-10
 
 ### Fixed - Documentation Consistency

package/config/embeddings_info.json

@@ -0,0 +1,14 @@
+{
+  "model": "all-MiniLM-L6-v2",
+  "dimension": 384,
+  "intents": [
+    "infrastructure_creation",
+    "infrastructure_diagnosis",
+    "kubernetes_operations",
+    "application_development",
+    "infrastructure_validation"
+  ],
+  "total_examples": 40,
+  "timestamp": "1762547446.5981727",
+  "note": "Pre-computed offline. At runtime, load with numpy (no torch needed)."
+}