sqlew 3.6.2 → 3.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,403 +1,441 @@
1
- # Changelog
2
-
3
- All notable changes to sqlew will be documented in this file.
4
-
5
- The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
- and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
-
8
- ## [3.6.2] - 2025-10-27
9
-
10
- ### Changed - Migration System Modernization
11
-
12
- **Simplified to Knex-only migrations with organized directory structure**
13
-
14
- #### Migration System Cleanup
15
- - **Removed custom migration system** (14 obsolete files from `src/migrations/`)
16
- - **Pure Knex migrations** - Standardized on Knex.js migration framework
17
- - **Organized structure** - 22 migrations grouped into 3 logical subdirectories:
18
- - `upgrades/` (7 files) - Version upgrade paths (v1.0 → v3.6)
19
- - `bootstrap/` (5 files) - Fresh install foundation
20
- - `enhancements/` (10 files) - v3.6.0+ feature additions
21
-
22
- #### Testing & CI/CD
23
- - **Migration tests updated** - Converted to use Knex migrations exclusively
24
- - **Comprehensive test coverage** - 8/9 versions migrate successfully (89% backward compatibility)
25
- - **Husky git hooks** - Pre-commit (build + tests), pre-push (migration tests)
26
- - **GitHub Actions workflow** - CI/CD pipeline for Node 18.x/20.x
27
-
28
- #### Benefits
29
- - **Better maintainability** - Clear organization, standard tooling
30
- - **Easier onboarding** - Knex is industry-standard
31
- - **Faster development** - 56% time efficiency via parallel execution
32
-
33
- ---
34
-
35
- ## [3.6.0] - 2025-10-25
36
-
37
- ### Added - Help System Optimization
38
-
39
- **Database-driven help system with 60-70% token efficiency improvement**
40
-
41
- #### Key Achievements
42
- - **60-70% Token Reduction** - Average help query: ~200 tokens (vs ~2,150 legacy)
43
- - **95.8% Schema Reduction** - MCP InputSchemas: 350 tokens (vs 8,400 legacy)
44
- - **6 New Help Actions** - Granular queries for actions, parameters, tools, use-cases
45
- - **41 Use-Cases** - Comprehensive workflow examples across 6 categories
46
- - **100% Test Coverage** - 38/38 tests passing
47
-
48
- #### New MCP Actions (stats tool)
49
- - `help_action` - Query single action with parameters and examples
50
- - `help_params` - Query parameter list for an action
51
- - `help_tool` - Query tool overview + all actions
52
- - `help_use_case` - Get single use-case with full workflow
53
- - `help_list_use_cases` - List/filter use-cases by category/complexity
54
- - `help_next_actions` - Suggest common next actions
55
-
56
- #### Database Schema
57
- 7 new tables: `m_help_tools`, `m_help_actions`, `m_help_use_case_categories`, `t_help_action_params`, `t_help_action_examples`, `t_help_use_cases`, `t_help_action_sequences`
58
-
59
- #### Migration from v3.5.x
60
- - Automatic migration on startup
61
- - Backward compatible - all existing MCP actions unchanged
62
- - Zero downtime
63
-
64
- ---
65
-
66
- ## [3.5.2] - 2025-10-24
67
-
68
- ### Added - Two-Step Git-Aware Task Workflow
69
-
70
- **Automatic task completion and archiving based on Git staging and committing**
71
-
72
- #### Features
73
- - **Step 1 - Staging** (`git add`): `waiting_review` → `done` (work complete)
74
- - **Step 2 - Committing** (`git commit`): `done` → `archived` (work finalized)
75
- - **VCS Support**: Git, Mercurial, and SVN
76
- - **Zero Token Cost**: Fully automated, no manual MCP calls needed
77
-
78
- #### Configuration
79
- - `git_auto_complete_on_stage` (default: `'1'`)
80
- - `git_auto_archive_on_commit` (default: `'1'`)
81
- - `require_all_files_staged` (default: `'1'`)
82
- - `require_all_files_committed_for_archive` (default: `'1'`)
83
-
84
- ---
85
-
86
- ## [3.5.1] - 2025-10-24
87
-
88
- ### Fixed - File Watcher WSL Compatibility
89
-
90
- **Upgraded chokidar from v3 to v4 + Fixed path normalization bug**
91
-
92
- #### Changes
93
- - **chokidar**: `^3.6.0` → `^4.0.3` (automatic WSL support)
94
- - Fixed path normalization: chokidar reports absolute paths, database stores relative
95
- - Removed manual WSL detection and polling configuration
96
-
97
- ---
98
-
99
- ## [3.5.0] - 2025-10-22
100
-
101
- ### Added - Non-Existent File Auto-Pruning
102
-
103
- **Automatic removal of non-existent watched files with audit trail**
104
-
105
- #### Features
106
- - New table: `t_task_pruned_files` - Audit trail for pruned files
107
- - Auto-pruning during `in_progress → waiting_review` transition
108
- - Safety check: blocks if ALL files non-existent
109
- - New MCP actions: `get_pruned_files`, `link_pruned_file`
110
-
111
- #### Documentation
112
- - `TASK_PRUNING.md` - Comprehensive guide with examples and best practices
113
-
114
- ---
115
-
116
- ## [3.4.1] - 2025-10-22
117
-
118
- ### Fixed - File Watcher Immediate Detection
119
-
120
- **Fixed chokidar configuration for instant file change detection**
121
-
122
- #### Changes
123
- - Removed 5-second aggregation delay
124
- - Added `awaitWriteFinish` for write completion detection
125
- - Immediate auto-transition on file save
126
-
127
- ---
128
-
129
- ## [3.4.0] - 2025-10-22
130
-
131
- ### Added - VCS-Aware File Watching
132
-
133
- **Automatic task transitions based on Git commit detection**
134
-
135
- #### Features
136
- - Auto-transition: `waiting_review` → `done` when watched files committed
137
- - Multi-VCS support: Git, Mercurial, SVN
138
- - VCS adapter pattern with pluggable implementations
139
- - Whitelist exemption: Skip auto-transition for critical files (package.json, migrations)
140
- - Configuration: `git_auto_complete_tasks`, `git_require_all_files_committed`, `git_file_whitelist`
141
-
142
- #### Database Schema
143
- - New table: `m_git_file_whitelist` - Exempt files from auto-completion
144
-
145
- ---
146
-
147
- ## [3.2.6] - 2025-10-21
148
-
149
- ### Fixed - File Watcher Test Stability
150
-
151
- **Improved debouncing and async handling in file watcher tests**
152
-
153
- ---
154
-
155
- ## [3.2.5] - 2025-10-21
156
-
157
- ### Fixed - File Watcher Error Handling
158
-
159
- **Enhanced error handling and logging for file watcher operations**
160
-
161
- ---
162
-
163
- ## [3.2.4] - 2025-10-20
164
-
165
- ### Fixed - File Watcher Path Resolution
166
-
167
- **Fixed absolute path resolution for file watching**
168
-
169
- ---
170
-
171
- ## [3.2.3] - 2025-10-20 [DEPRECATED]
172
-
173
- ### Changed - File Watcher Implementation (Deprecated)
174
-
175
- This version was replaced by v3.2.4. Use v3.2.4 or later.
176
-
177
- ---
178
-
179
- ## [3.2.2] - 2025-10-18
180
-
181
- ### Added - Decision Context
182
-
183
- **Rich decision documentation with rationale, alternatives, tradeoffs**
184
-
185
- #### Features
186
- - New table: `t_decision_context` - Attach context to decisions
187
- - New actions: `add_decision_context`, `list_decision_contexts`
188
- - Enhanced `get` action with `include_context` parameter
189
-
190
- #### Documentation
191
- - `DECISION_CONTEXT.md` - Comprehensive guide for decision documentation
192
-
193
- ---
194
-
195
- ## [3.2.0] - 2025-10-18
196
-
197
- ### Added - Task Dependencies
198
-
199
- **Task dependency management with blocking relationships**
200
-
201
- #### Features
202
- - New table: `t_task_dependencies` - Track blocking relationships
203
- - Circular dependency detection
204
- - New actions: `add_dependency`, `remove_dependency`, `get_dependencies`
205
-
206
- ---
207
-
208
- ## [3.1.2] - 2025-10-18
209
-
210
- ### Fixed - Task Linking Validation
211
-
212
- **Fixed validation for task-decision-constraint-file links**
213
-
214
- ---
215
-
216
- ## [3.1.1] - 2025-10-18
217
-
218
- ### Fixed - File Watcher Initialization
219
-
220
- **Fixed file watcher startup sequence and error handling**
221
-
222
- ---
223
-
224
- ## [3.0.2] - 2025-10-17
225
-
226
- ### Fixed - Task State Machine
227
-
228
- **Enhanced task status transition validation**
229
-
230
- #### Changes
231
- - Fixed state machine transitions for task lifecycle
232
- - Improved validation for blocked/unblocked transitions
233
-
234
- ---
235
-
236
- ## [3.0.1] - 2025-10-17
237
-
238
- ### Fixed - Task Timestamps
239
-
240
- **Fixed task timestamp updates on status changes**
241
-
242
- ---
243
-
244
- ## [3.0.0] - 2025-10-17
245
-
246
- ### Added - Kanban Task Watcher
247
-
248
- **AI-optimized task management with auto-stale detection**
249
-
250
- #### Features
251
- - Task management with metadata: status, priority, assignee, tags, layer
252
- - Auto-stale detection: `in_progress` >2h → `waiting_review`, `waiting_review` >24h → `todo`
253
- - File watching with `chokidar`: auto-transition `todo` → `in_progress` on file edit
254
- - Link tasks to decisions, constraints, files
255
- - 70% token reduction vs decision tool (~100 bytes/task vs ~332 bytes/decision)
256
- - Flat hierarchy (no subtasks) for AI simplicity
257
-
258
- #### Database Schema
259
- - New tables: `t_tasks`, `t_task_details`, `t_task_tags`, `t_task_decision_links`, `t_task_constraint_links`, `t_task_file_links`
260
- - New triggers: `trg_log_task_create`, `trg_log_task_status_change`, `trg_update_task_timestamp`
261
-
262
- #### MCP Actions (task tool)
263
- - `create`, `update`, `get`, `list`, `move`, `link`, `archive`, `batch_create`
264
- - `watch_files` - Start file watching for auto-transitions
265
-
266
- #### Documentation
267
- - `TASK_OVERVIEW.md` - Lifecycle, status transitions
268
- - `TASK_ACTIONS.md` - All action references with examples
269
- - `TASK_LINKING.md` - Link tasks to decisions/constraints/files
270
- - `TASK_MIGRATION.md` - Migrate from decision-based tracking
271
-
272
- ---
273
-
274
- ## [2.1.4] - 2025-10-15
275
-
276
- ### Fixed - Action Validation
277
-
278
- **Enhanced parameter validation for all MCP actions**
279
-
280
- ---
281
-
282
- ## [2.1.3] - 2025-10-15
283
-
284
- ### Fixed - Message Priority Handling
285
-
286
- **Fixed message priority enum conversion**
287
-
288
- ---
289
-
290
- ## [2.1.2] - 2025-10-15
291
-
292
- ### Fixed - File Change Tracking
293
-
294
- **Fixed file change timestamp handling**
295
-
296
- ---
297
-
298
- ## [2.1.1] - 2025-10-15
299
-
300
- ### Fixed - Constraint Deactivation
301
-
302
- **Fixed constraint soft delete logic**
303
-
304
- ---
305
-
306
- ## [2.1.0] - 2025-10-14
307
-
308
- ### Added - Template System
309
-
310
- **Decision and batch operation templates**
311
-
312
- #### Features
313
- - New actions: `set_from_template`, `create_template`, `list_templates`
314
- - Template-based decision creation
315
- - Batch operation support with `set_batch`, `send_batch`, `record_batch`
316
-
317
- ---
318
-
319
- ## [2.0.0] - 2025-10-11
320
-
321
- ### Changed - Action-Based Tool Consolidation
322
-
323
- **96% token reduction through action-based API**
324
-
325
- #### Breaking Changes
326
- - 20 tools → 6 tools (action-based routing)
327
- - All tools use `action` parameter for routing
328
- - Tool names changed: `context` → `decision`, `utils` → `stats`
329
-
330
- #### Token Efficiency
331
- - Tool definitions: 12,848 → 481 tokens (96% reduction)
332
- - MCP context: ~13,730 → ~4,482 tokens (67% reduction)
333
- - Help actions provide on-demand documentation
334
-
335
- #### New Tool Structure
336
- - `decision` - Context Management (9 actions)
337
- - `message` - Agent Messaging (4 actions)
338
- - `file` - File Change Tracking (4 actions)
339
- - `constraint` - Constraint Management (4 actions)
340
- - `stats` - Statistics & Utilities (4 actions)
341
- - `config` - Configuration (3 actions)
342
-
343
- ---
344
-
345
- ## [1.1.2] - 2025-10-11
346
-
347
- ### Fixed - Database Migration
348
-
349
- **Fixed v1.2.0 → v1.3.0 table prefix migration**
350
-
351
- ---
352
-
353
- ## [1.1.1] - 2025-10-11
354
-
355
- ### Fixed - Auto-Cleanup
356
-
357
- **Fixed weekend-aware cleanup trigger timing**
358
-
359
- ---
360
-
361
- ## [1.1.0] - 2025-10-11
362
-
363
- ### Added - Weekend-Aware Auto-Deletion
364
-
365
- **Configurable retention with weekend-aware logic**
366
-
367
- #### Features
368
- - Configuration keys: `autodelete_ignore_weekend`, `autodelete_message_hours`, `autodelete_file_history_days`
369
- - CLI arguments for startup override
370
- - Manual cleanup via `clear_old_data` action
371
-
372
- ---
373
-
374
- ## [1.0.1] - 2025-10-11
375
-
376
- ### Fixed - Schema Initialization
377
-
378
- **Fixed initial database schema creation**
379
-
380
- ---
381
-
382
- ## [1.0.0] - 2025-01-10
383
-
384
- ### Added - Initial Release
385
-
386
- **MCP Shared Context Server for efficient context sharing**
387
-
388
- #### Core Features
389
- - Decision tracking with metadata (tags, layers, scopes, versions)
390
- - Agent messaging with priority levels
391
- - File change tracking with layer integration
392
- - Constraint management with priorities
393
- - Statistics and utilities
394
- - SQLite-based persistence with better-sqlite3
395
-
396
- #### Database Schema
397
- - Master tables: agents, files, context_keys, layers, tags, scopes, etc.
398
- - Transaction tables: decisions, messages, file_changes, constraints
399
- - Views for token-efficient queries
400
- - Automatic version history tracking
401
-
402
- #### MCP Tools
403
- Initial implementation with 20 separate tools (consolidated to 6 in v2.0.0)
1
+ # Changelog
2
+
3
+ All notable changes to sqlew will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [3.6.3] - 2025-10-27
9
+
10
+ ### Fixed - Critical Bug Fixes & Git Add Detection
11
+
12
+ **Transaction pool exhaustion and VCS-aware auto-complete implementation**
13
+
14
+ #### Bug Fixes
15
+ - **Task Move Transaction Bug** - Fixed `moveTask` using base `knex` instead of transaction `trx` (line 880)
16
+ - Caused "Knex: Timeout acquiring a connection" errors
17
+ - Now properly uses transaction object for `logTaskStatusChange`
18
+ - **Task Link Transaction Bug** - Fixed `linkTask` using base `knex` instead of transaction `trx` (line 948)
19
+ - Same connection pool exhaustion issue
20
+ - Now properly uses transaction object for decision link insertion
21
+
22
+ #### Features
23
+ - **Git Add Detection** - Implemented `detectAndCompleteOnStaging()` for VCS-aware workflow
24
+ - Detects `git add` operations and auto-completes tasks (`waiting_review` `done`)
25
+ - Supports Git, Mercurial, and SVN
26
+ - Configurable via `git_auto_complete_on_stage` and `require_all_files_staged`
27
+ - **VCS Configuration** - Added comprehensive settings documentation to `config.example.toml`
28
+ - `git_auto_complete_on_stage` (default: true)
29
+ - `git_auto_archive_on_commit` (default: true)
30
+ - `require_all_files_staged` (default: true)
31
+ - `require_all_files_committed_for_archive` (default: true)
32
+
33
+ #### Infrastructure
34
+ - **Line Ending Fix** - Added `.gitattributes` to enforce LF endings for shell scripts
35
+ - Prevents CRLF issues in Husky hooks on Windows/WSL
36
+ - Applies to `*.sh` and `.husky/*` files
37
+ - **Husky Hooks** - Fixed pre-commit/pre-push hooks (added shebang, normalized line endings)
38
+
39
+ #### Impact
40
+ - ✅ Task operations no longer fail with connection pool timeouts
41
+ - Git add detection now functional (was stubbed in v3.5.2)
42
+ - Cross-platform compatibility for git hooks (Windows/WSL/Linux/macOS)
43
+
44
+ ---
45
+
46
+ ## [3.6.2] - 2025-10-27
47
+
48
+ ### Changed - Migration System Modernization
49
+
50
+ **Simplified to Knex-only migrations with organized directory structure**
51
+
52
+ #### Migration System Cleanup
53
+ - **Removed custom migration system** (14 obsolete files from `src/migrations/`)
54
+ - **Pure Knex migrations** - Standardized on Knex.js migration framework
55
+ - **Organized structure** - 22 migrations grouped into 3 logical subdirectories:
56
+ - `upgrades/` (7 files) - Version upgrade paths (v1.0 → v3.6)
57
+ - `bootstrap/` (5 files) - Fresh install foundation
58
+ - `enhancements/` (10 files) - v3.6.0+ feature additions
59
+
60
+ #### Testing & CI/CD
61
+ - **Migration tests updated** - Converted to use Knex migrations exclusively
62
+ - **Comprehensive test coverage** - 8/9 versions migrate successfully (89% backward compatibility)
63
+ - **Husky git hooks** - Pre-commit (build + tests), pre-push (migration tests)
64
+ - **GitHub Actions workflow** - CI/CD pipeline for Node 18.x/20.x
65
+
66
+ #### Benefits
67
+ - **Better maintainability** - Clear organization, standard tooling
68
+ - **Easier onboarding** - Knex is industry-standard
69
+ - **Faster development** - 56% time efficiency via parallel execution
70
+
71
+ ---
72
+
73
+ ## [3.6.0] - 2025-10-25
74
+
75
+ ### Added - Help System Optimization
76
+
77
+ **Database-driven help system with 60-70% token efficiency improvement**
78
+
79
+ #### Key Achievements
80
+ - **60-70% Token Reduction** - Average help query: ~200 tokens (vs ~2,150 legacy)
81
+ - **95.8% Schema Reduction** - MCP InputSchemas: 350 tokens (vs 8,400 legacy)
82
+ - **6 New Help Actions** - Granular queries for actions, parameters, tools, use-cases
83
+ - **41 Use-Cases** - Comprehensive workflow examples across 6 categories
84
+ - **100% Test Coverage** - 38/38 tests passing
85
+
86
+ #### New MCP Actions (stats tool)
87
+ - `help_action` - Query single action with parameters and examples
88
+ - `help_params` - Query parameter list for an action
89
+ - `help_tool` - Query tool overview + all actions
90
+ - `help_use_case` - Get single use-case with full workflow
91
+ - `help_list_use_cases` - List/filter use-cases by category/complexity
92
+ - `help_next_actions` - Suggest common next actions
93
+
94
+ #### Database Schema
95
+ 7 new tables: `m_help_tools`, `m_help_actions`, `m_help_use_case_categories`, `t_help_action_params`, `t_help_action_examples`, `t_help_use_cases`, `t_help_action_sequences`
96
+
97
+ #### Migration from v3.5.x
98
+ - Automatic migration on startup
99
+ - Backward compatible - all existing MCP actions unchanged
100
+ - Zero downtime
101
+
102
+ ---
103
+
104
+ ## [3.5.2] - 2025-10-24
105
+
106
+ ### Added - Two-Step Git-Aware Task Workflow
107
+
108
+ **Automatic task completion and archiving based on Git staging and committing**
109
+
110
+ #### Features
111
+ - **Step 1 - Staging** (`git add`): `waiting_review` → `done` (work complete)
112
+ - **Step 2 - Committing** (`git commit`): `done` `archived` (work finalized)
113
+ - **VCS Support**: Git, Mercurial, and SVN
114
+ - **Zero Token Cost**: Fully automated, no manual MCP calls needed
115
+
116
+ #### Configuration
117
+ - `git_auto_complete_on_stage` (default: `'1'`)
118
+ - `git_auto_archive_on_commit` (default: `'1'`)
119
+ - `require_all_files_staged` (default: `'1'`)
120
+ - `require_all_files_committed_for_archive` (default: `'1'`)
121
+
122
+ ---
123
+
124
+ ## [3.5.1] - 2025-10-24
125
+
126
+ ### Fixed - File Watcher WSL Compatibility
127
+
128
+ **Upgraded chokidar from v3 to v4 + Fixed path normalization bug**
129
+
130
+ #### Changes
131
+ - **chokidar**: `^3.6.0` `^4.0.3` (automatic WSL support)
132
+ - Fixed path normalization: chokidar reports absolute paths, database stores relative
133
+ - Removed manual WSL detection and polling configuration
134
+
135
+ ---
136
+
137
+ ## [3.5.0] - 2025-10-22
138
+
139
+ ### Added - Non-Existent File Auto-Pruning
140
+
141
+ **Automatic removal of non-existent watched files with audit trail**
142
+
143
+ #### Features
144
+ - New table: `t_task_pruned_files` - Audit trail for pruned files
145
+ - Auto-pruning during `in_progress → waiting_review` transition
146
+ - Safety check: blocks if ALL files non-existent
147
+ - New MCP actions: `get_pruned_files`, `link_pruned_file`
148
+
149
+ #### Documentation
150
+ - `TASK_PRUNING.md` - Comprehensive guide with examples and best practices
151
+
152
+ ---
153
+
154
+ ## [3.4.1] - 2025-10-22
155
+
156
+ ### Fixed - File Watcher Immediate Detection
157
+
158
+ **Fixed chokidar configuration for instant file change detection**
159
+
160
+ #### Changes
161
+ - Removed 5-second aggregation delay
162
+ - Added `awaitWriteFinish` for write completion detection
163
+ - Immediate auto-transition on file save
164
+
165
+ ---
166
+
167
+ ## [3.4.0] - 2025-10-22
168
+
169
+ ### Added - VCS-Aware File Watching
170
+
171
+ **Automatic task transitions based on Git commit detection**
172
+
173
+ #### Features
174
+ - Auto-transition: `waiting_review` → `done` when watched files committed
175
+ - Multi-VCS support: Git, Mercurial, SVN
176
+ - VCS adapter pattern with pluggable implementations
177
+ - Whitelist exemption: Skip auto-transition for critical files (package.json, migrations)
178
+ - Configuration: `git_auto_complete_tasks`, `git_require_all_files_committed`, `git_file_whitelist`
179
+
180
+ #### Database Schema
181
+ - New table: `m_git_file_whitelist` - Exempt files from auto-completion
182
+
183
+ ---
184
+
185
+ ## [3.2.6] - 2025-10-21
186
+
187
+ ### Fixed - File Watcher Test Stability
188
+
189
+ **Improved debouncing and async handling in file watcher tests**
190
+
191
+ ---
192
+
193
+ ## [3.2.5] - 2025-10-21
194
+
195
+ ### Fixed - File Watcher Error Handling
196
+
197
+ **Enhanced error handling and logging for file watcher operations**
198
+
199
+ ---
200
+
201
+ ## [3.2.4] - 2025-10-20
202
+
203
+ ### Fixed - File Watcher Path Resolution
204
+
205
+ **Fixed absolute path resolution for file watching**
206
+
207
+ ---
208
+
209
+ ## [3.2.3] - 2025-10-20 [DEPRECATED]
210
+
211
+ ### Changed - File Watcher Implementation (Deprecated)
212
+
213
+ This version was replaced by v3.2.4. Use v3.2.4 or later.
214
+
215
+ ---
216
+
217
+ ## [3.2.2] - 2025-10-18
218
+
219
+ ### Added - Decision Context
220
+
221
+ **Rich decision documentation with rationale, alternatives, tradeoffs**
222
+
223
+ #### Features
224
+ - New table: `t_decision_context` - Attach context to decisions
225
+ - New actions: `add_decision_context`, `list_decision_contexts`
226
+ - Enhanced `get` action with `include_context` parameter
227
+
228
+ #### Documentation
229
+ - `DECISION_CONTEXT.md` - Comprehensive guide for decision documentation
230
+
231
+ ---
232
+
233
+ ## [3.2.0] - 2025-10-18
234
+
235
+ ### Added - Task Dependencies
236
+
237
+ **Task dependency management with blocking relationships**
238
+
239
+ #### Features
240
+ - New table: `t_task_dependencies` - Track blocking relationships
241
+ - Circular dependency detection
242
+ - New actions: `add_dependency`, `remove_dependency`, `get_dependencies`
243
+
244
+ ---
245
+
246
+ ## [3.1.2] - 2025-10-18
247
+
248
+ ### Fixed - Task Linking Validation
249
+
250
+ **Fixed validation for task-decision-constraint-file links**
251
+
252
+ ---
253
+
254
+ ## [3.1.1] - 2025-10-18
255
+
256
+ ### Fixed - File Watcher Initialization
257
+
258
+ **Fixed file watcher startup sequence and error handling**
259
+
260
+ ---
261
+
262
+ ## [3.0.2] - 2025-10-17
263
+
264
+ ### Fixed - Task State Machine
265
+
266
+ **Enhanced task status transition validation**
267
+
268
+ #### Changes
269
+ - Fixed state machine transitions for task lifecycle
270
+ - Improved validation for blocked/unblocked transitions
271
+
272
+ ---
273
+
274
+ ## [3.0.1] - 2025-10-17
275
+
276
+ ### Fixed - Task Timestamps
277
+
278
+ **Fixed task timestamp updates on status changes**
279
+
280
+ ---
281
+
282
+ ## [3.0.0] - 2025-10-17
283
+
284
+ ### Added - Kanban Task Watcher
285
+
286
+ **AI-optimized task management with auto-stale detection**
287
+
288
+ #### Features
289
+ - Task management with metadata: status, priority, assignee, tags, layer
290
+ - Auto-stale detection: `in_progress` >2h → `waiting_review`, `waiting_review` >24h → `todo`
291
+ - File watching with `chokidar`: auto-transition `todo` → `in_progress` on file edit
292
+ - Link tasks to decisions, constraints, files
293
+ - 70% token reduction vs decision tool (~100 bytes/task vs ~332 bytes/decision)
294
+ - Flat hierarchy (no subtasks) for AI simplicity
295
+
296
+ #### Database Schema
297
+ - New tables: `t_tasks`, `t_task_details`, `t_task_tags`, `t_task_decision_links`, `t_task_constraint_links`, `t_task_file_links`
298
+ - New triggers: `trg_log_task_create`, `trg_log_task_status_change`, `trg_update_task_timestamp`
299
+
300
+ #### MCP Actions (task tool)
301
+ - `create`, `update`, `get`, `list`, `move`, `link`, `archive`, `batch_create`
302
+ - `watch_files` - Start file watching for auto-transitions
303
+
304
+ #### Documentation
305
+ - `TASK_OVERVIEW.md` - Lifecycle, status transitions
306
+ - `TASK_ACTIONS.md` - All action references with examples
307
+ - `TASK_LINKING.md` - Link tasks to decisions/constraints/files
308
+ - `TASK_MIGRATION.md` - Migrate from decision-based tracking
309
+
310
+ ---
311
+
312
+ ## [2.1.4] - 2025-10-15
313
+
314
+ ### Fixed - Action Validation
315
+
316
+ **Enhanced parameter validation for all MCP actions**
317
+
318
+ ---
319
+
320
+ ## [2.1.3] - 2025-10-15
321
+
322
+ ### Fixed - Message Priority Handling
323
+
324
+ **Fixed message priority enum conversion**
325
+
326
+ ---
327
+
328
+ ## [2.1.2] - 2025-10-15
329
+
330
+ ### Fixed - File Change Tracking
331
+
332
+ **Fixed file change timestamp handling**
333
+
334
+ ---
335
+
336
+ ## [2.1.1] - 2025-10-15
337
+
338
+ ### Fixed - Constraint Deactivation
339
+
340
+ **Fixed constraint soft delete logic**
341
+
342
+ ---
343
+
344
+ ## [2.1.0] - 2025-10-14
345
+
346
+ ### Added - Template System
347
+
348
+ **Decision and batch operation templates**
349
+
350
+ #### Features
351
+ - New actions: `set_from_template`, `create_template`, `list_templates`
352
+ - Template-based decision creation
353
+ - Batch operation support with `set_batch`, `send_batch`, `record_batch`
354
+
355
+ ---
356
+
357
+ ## [2.0.0] - 2025-10-11
358
+
359
+ ### Changed - Action-Based Tool Consolidation
360
+
361
+ **96% token reduction through action-based API**
362
+
363
+ #### Breaking Changes
364
+ - 20 tools → 6 tools (action-based routing)
365
+ - All tools use `action` parameter for routing
366
+ - Tool names changed: `context` → `decision`, `utils` → `stats`
367
+
368
+ #### Token Efficiency
369
+ - Tool definitions: 12,848 481 tokens (96% reduction)
370
+ - MCP context: ~13,730 ~4,482 tokens (67% reduction)
371
+ - Help actions provide on-demand documentation
372
+
373
+ #### New Tool Structure
374
+ - `decision` - Context Management (9 actions)
375
+ - `message` - Agent Messaging (4 actions)
376
+ - `file` - File Change Tracking (4 actions)
377
+ - `constraint` - Constraint Management (4 actions)
378
+ - `stats` - Statistics & Utilities (4 actions)
379
+ - `config` - Configuration (3 actions)
380
+
381
+ ---
382
+
383
+ ## [1.1.2] - 2025-10-11
384
+
385
+ ### Fixed - Database Migration
386
+
387
+ **Fixed v1.2.0 → v1.3.0 table prefix migration**
388
+
389
+ ---
390
+
391
+ ## [1.1.1] - 2025-10-11
392
+
393
+ ### Fixed - Auto-Cleanup
394
+
395
+ **Fixed weekend-aware cleanup trigger timing**
396
+
397
+ ---
398
+
399
+ ## [1.1.0] - 2025-10-11
400
+
401
+ ### Added - Weekend-Aware Auto-Deletion
402
+
403
+ **Configurable retention with weekend-aware logic**
404
+
405
+ #### Features
406
+ - Configuration keys: `autodelete_ignore_weekend`, `autodelete_message_hours`, `autodelete_file_history_days`
407
+ - CLI arguments for startup override
408
+ - Manual cleanup via `clear_old_data` action
409
+
410
+ ---
411
+
412
+ ## [1.0.1] - 2025-10-11
413
+
414
+ ### Fixed - Schema Initialization
415
+
416
+ **Fixed initial database schema creation**
417
+
418
+ ---
419
+
420
+ ## [1.0.0] - 2025-01-10
421
+
422
+ ### Added - Initial Release
423
+
424
+ **MCP Shared Context Server for efficient context sharing**
425
+
426
+ #### Core Features
427
+ - Decision tracking with metadata (tags, layers, scopes, versions)
428
+ - Agent messaging with priority levels
429
+ - File change tracking with layer integration
430
+ - Constraint management with priorities
431
+ - Statistics and utilities
432
+ - SQLite-based persistence with better-sqlite3
433
+
434
+ #### Database Schema
435
+ - Master tables: agents, files, context_keys, layers, tags, scopes, etc.
436
+ - Transaction tables: decisions, messages, file_changes, constraints
437
+ - Views for token-efficient queries
438
+ - Automatic version history tracking
439
+
440
+ #### MCP Tools
441
+ Initial implementation with 20 separate tools (consolidated to 6 in v2.0.0)