sqlew 2.1.0 → 2.1.2

package/CHANGELOG.md

@@ -5,6 +5,69 @@ All notable changes to sqlew 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).
 
+## [2.1.2] - 2025-10-15
+
+### Fixed
+- **v2.1.0 Migration Bug:** Fixed initialization order issue preventing v2.0.0 databases from migrating to v2.1.0
+  - **Problem:** Schema validation ran before v2.1.0 migration check, causing v2.0.0 databases to fail validation and exit
+  - **Solution:** Moved v2.1.0 migration check to run before schema validation (src/database.ts:96-113)
+  - **Impact:** v2.0.0 databases now automatically migrate to v2.1.0 on startup without errors
+  - Database components added by migration: `t_activity_log`, `t_decision_templates`, 4 activity logging triggers
+
+### Changed
+- **Batch Operations Help Documentation:** Enhanced help text for all batch operations with AI agent guidance
+  - Added detailed ATOMIC MODE behavior explanation (all-or-nothing transaction with rollback)
+  - Added detailed NON-ATOMIC MODE behavior explanation (best-effort processing with partial results)
+  - Added RECOMMENDATION FOR AI AGENTS section suggesting `atomic:false` by default
+  - Applies to: `set_batch` (decision tool), `send_batch` (message tool), `record_batch` (file tool)
+  - **Zero token impact:** Help text is on-demand only (called with `action: "help"`)
+  - Helps prevent "cannot start a transaction within a transaction" errors from incorrect usage
+
+### Technical Details
+- v2.1.0 migration now runs before schema validation to ensure all required components exist
+- Help documentation improvements have no effect on MCP tool schema (zero upfront token cost)
+- Batch operation help text expanded from ~150 to ~350 characters per action
+
+### Migration from v2.1.0/v2.1.1
+- No breaking changes
+- Existing v2.0.0 databases will now migrate successfully on first startup
+- No action required for v2.1.0+ users
+
+## [2.1.1] - 2025-10-15
+
+### Fixed
+- **Bin Command Configuration:** Fixed `npx sqlew` to launch MCP server by default instead of CLI
+  - Changed `package.json` bin mapping: `sqlew` now points to MCP server (`dist/index.js`)
+  - CLI mode moved to `sqlew-cli` command (`dist/cli.js`)
+  - **Before:** `npx sqlew` → CLI mode
+  - **After:** `npx sqlew` → MCP server (default), `sqlew-cli` → CLI mode (after installing the package)
+  - Fixes user experience issue where MCP server launch required non-intuitive command
+
+- **Batch Operations Nested Transaction Bug:** Fixed `set_batch` failing with "cannot start a transaction within a transaction" error
+  - Root cause: `setDecision()` wraps logic in `transaction()`, but `setDecisionBatch()` also wraps calls in `transaction()` for atomic mode
+  - Solution: Created `setDecisionInternal()` helper function with core logic but no transaction wrapper
+  - `setDecision()` now calls `setDecisionInternal()` wrapped in transaction
+  - `setDecisionBatch()` now calls `setDecisionInternal()` directly (batch manages its own transaction)
+  - All batch operations verified working: `set_batch`, `send_batch`, `record_batch`
+  - Location: `src/tools/context.ts:40-152` (setDecisionInternal), `context.ts:154-174` (setDecision), `context.ts:883` (setDecisionBatch)
+
+### Changed
+- **Documentation Improvements:**
+  - **README Benefits Section:** Rewrote to emphasize organizational memory for AI agents as the core value proposition
+    - Added comparison table: Git history (WHAT) vs Code comments (HOW) vs sqlew decisions (WHY)
+    - Added real-world example showing cross-session context survival
+    - Highlighted 4 key LLM benefits: context survival, prevents regression, historical reasoning, knowledge discovery
+  - **README Token Savings:** Replaced internal architecture metrics with honest real-world token reduction analysis
+    - Shows concrete scenario: 5 agents, 10 sessions, 20,000 → 7,400 tokens (63% reduction)
+    - Explains 4 savings mechanisms: selective retrieval, structured vs unstructured, cross-session persistence, search vs scan
+    - Provides realistic ranges: Conservative (50-65%), Realistic (60-75%), Optimal (70-85%)
+    - Clarified that 96%/67% metrics are internal v1.0→v2.0 improvements, not usage benefits
+
+### Migration Notes
+- No breaking changes for MCP tool API
+- Users who relied on `npx sqlew` for CLI should install the package and use `sqlew-cli` command
+- MCP server configuration unchanged (still uses stdio transport)
+
 ## [2.1.0] - 2025-10-14
 
 ### 🎉 Feature Release
@@ -437,6 +500,8 @@ First production release of sqlew - MCP server for efficient context sharing bet
 - Full type safety
 - Comprehensive error handling
 
+[2.1.2]: https://github.com/sin5ddd/mcp-sqlew/releases/tag/v2.1.2
+[2.1.1]: https://github.com/sin5ddd/mcp-sqlew/releases/tag/v2.1.1
 [2.1.0]: https://github.com/sin5ddd/mcp-sqlew/releases/tag/v2.1.0
 [2.0.0]: https://github.com/sin5ddd/mcp-sqlew/releases/tag/v2.0.0
 [1.1.2]: https://github.com/sin5ddd/mcp-sqlew/releases/tag/v1.1.2