sqlew 3.2.5 → 3.5.3

package/docs/TASK_SYSTEM.md

@@ -763,10 +763,15 @@ Auto-stale detection automatically transitions idle tasks to prevent them from g
 
 The logic:
 1. Check if enabled via `task_auto_stale_enabled` config
-2. Get threshold hours from config (2h for in_progress, 24h for waiting_review)
+2. Get threshold hours/days from config
 3. Run SQL UPDATE to transition stale tasks based on `updated_ts`
 4. Return count of transitioned tasks
 
+**Transition Rules:**
+1. **`in_progress` → `waiting_review`** (>2 hours idle)
+2. **`waiting_review` → `todo`** (>24 hours idle)
+3. **`done` → `archived`** (>48 hours idle, weekend-aware) - **Auto-Archive**
+
 SQL Pattern:
 ```sql
 UPDATE t_tasks
@@ -779,38 +784,67 @@ WHERE status_id = ? AND updated_ts < unixepoch() - ?
 1. **Before `list` action**
    - Ensures stale tasks show correct status
    - Returns `stale_tasks_transitioned` count
+   - Returns `archived_tasks` count
 
 2. **Before `move` action**
    - Prevents moving already-stale tasks
    - Ensures status consistency
 
+3. **On database startup**
+   - Maintenance on initialization
+   - Cleans up stale/old tasks
+
 ### Configuration
 
-**Enable/Disable:**
+**Via MCP Tool (config):**
+```javascript
+// Update auto-archive threshold
+{
+  action: "update",
+  auto_archive_done_days: "3"  // Archive after 3 days instead of 2
+}
+
+// Enable weekend-aware mode (affects auto-archive, messages, files)
+{
+  action: "update",
+  autodelete_ignore_weekend: "1"
+}
+```
+
+**Via .sqlew/config.toml:**
+```toml
+[tasks]
+auto_archive_done_days = 3          # Archive after 3 days
+stale_hours_in_progress = 4         # in_progress → waiting_review after 4 hours
+stale_hours_waiting_review = 48     # waiting_review → todo after 48 hours
+auto_stale_enabled = true
+
+[autodelete]
+ignore_weekend = true               # Weekend-aware mode (shared setting)
+```
+
+**Via SQL (Advanced):**
 ```sql
+-- Enable/Disable
 UPDATE m_config SET value = '1' WHERE key = 'task_auto_stale_enabled';  -- Enable
 UPDATE m_config SET value = '0' WHERE key = 'task_auto_stale_enabled';  -- Disable
-```
 
-**Adjust Thresholds:**
-```sql
--- in_progress → waiting_review after 4 hours
-UPDATE m_config SET value = '4' WHERE key = 'task_stale_hours_in_progress';
+-- Adjust auto-archive threshold
+UPDATE m_config SET value = '3' WHERE key = 'auto_archive_done_days';  -- 3 days
 
--- waiting_review → todo after 48 hours
+-- Adjust stale detection thresholds
+UPDATE m_config SET value = '4' WHERE key = 'task_stale_hours_in_progress';
 UPDATE m_config SET value = '48' WHERE key = 'task_stale_hours_waiting_review';
-```
 
-**Check Current Config:**
-```sql
-SELECT key, value FROM m_config WHERE key LIKE 'task_%';
+-- Check current config
+SELECT key, value FROM m_config WHERE key LIKE 'task_%' OR key LIKE 'auto_%';
 ```
 
 ### Monitoring
 
 Track transitions via `t_activity_log` table:
 ```sql
--- Recent transitions
+-- Recent transitions (including auto-archive)
 SELECT * FROM t_activity_log
 WHERE entity_type = 'task' AND action_type = 'status_change'
 ORDER BY ts DESC LIMIT 20;
@@ -819,8 +853,44 @@ ORDER BY ts DESC LIMIT 20;
 SELECT task_id, COUNT(*) as stale_count FROM t_activity_log
 WHERE entity_type = 'task' AND json_extract(details, '$.new_status') = 3
 GROUP BY task_id HAVING stale_count > 2;
+
+-- Recently auto-archived tasks
+SELECT * FROM t_activity_log
+WHERE entity_type = 'task'
+  AND action_type = 'status_change'
+  AND json_extract(details, '$.new_status') = 6  -- ARCHIVED status
+ORDER BY ts DESC LIMIT 20;
+
+-- Count of archived tasks per day
+SELECT date(ts, 'unixepoch') as day, COUNT(*) as archived_count
+FROM t_activity_log
+WHERE entity_type = 'task'
+  AND action_type = 'status_change'
+  AND json_extract(details, '$.new_status') = 6
+GROUP BY day
+ORDER BY day DESC;
 ```
 
+### Weekend-Aware Behavior
+
+When `autodelete_ignore_weekend` is enabled (via config.toml or MCP tool):
+
+**Example 1 - Task Completed on Friday:**
+- Task marked `done`: Friday 5:00 PM
+- Default 48 hours: Would archive Sunday 5:00 PM
+- **Weekend-aware**: Archives Tuesday 5:00 PM (skips Sat/Sun)
+
+**Example 2 - Task Completed on Wednesday:**
+- Task marked `done`: Wednesday 2:00 PM
+- Default 48 hours: Would archive Friday 2:00 PM
+- **Weekend-aware**: Archives Friday 2:00 PM (no weekend in between)
+
+**Why Weekend-Aware Mode?**
+- Teams/AI agents may not work on weekends
+- Prevents premature archiving during weekend breaks
+- Consistent with message/file retention behavior
+- Configurable: Disable if you work 7 days/week
+
 ## Linking System
 
 ### Overview

package/docs/TOOL_REFERENCE.md

@@ -149,14 +149,19 @@
 
 | Action | Required | Optional |
 |--------|----------|----------|
-| **create** | action, title | description, acceptance_criteria, notes, priority, assigned_agent, created_by_agent, layer, tags, status |
-| **update** | action, task_id | title, priority, assigned_agent, layer, description, acceptance_criteria, notes |
-| **get** | action, task_id | - |
-| **list** | action | status, assigned_agent, layer, tags, limit, offset |
+| **create** | action, title | description, acceptance_criteria, notes, priority, assigned_agent, created_by_agent, layer, tags, status, **watch_files** (v3.4.1) |
+| **update** | action, task_id | title, priority, assigned_agent, layer, description, acceptance_criteria, notes, **watch_files** (v3.4.1) |
+| **get** | action, task_id | include_dependencies |
+| **list** | action | status, assigned_agent, layer, tags, limit, offset, include_dependency_counts |
 | **move** | action, task_id, new_status | - |
-| **link** | action, task_id, link_type, target_id | link_relation |
+| **link** | action, task_id, link_type, target_id | link_relation (⚠️ link_type="file" deprecated in v3.4.1) |
 | **archive** | action, task_id | - |
 | **batch_create** | action, tasks | atomic |
+| **add_dependency** | action, blocker_task_id, blocked_task_id | - |
+| **remove_dependency** | action, blocker_task_id, blocked_task_id | - |
+| **get_dependencies** | action, task_id | include_details |
+| **watch_files** (v3.4.1) | action, task_id, action (watch/unwatch/list) | file_paths |
+| **watcher** | action | subaction (status/list_files/list_tasks/help) |
 
 ---
 
@@ -323,6 +328,89 @@
 
 ---
 
+## File Watching with Tasks (v3.4.1)
+
+### New: watch_files Parameter
+
+**Replaces:** `task.link(link_type="file")` (deprecated in v3.4.1)
+
+Create tasks with automatic file monitoring in one step:
+
+```javascript
+{
+  action: "create",
+  title: "Implement user authentication",
+  watch_files: ["src/auth.ts", "src/auth.test.ts"],
+  acceptance_criteria: [
+    {type: "tests_pass", command: "npm test auth", expected_pattern: "passing"},
+    {type: "code_contains", file: "src/auth.ts", pattern: "export class AuthService"}
+  ],
+  priority: 3,
+  assigned_agent: "backend-dev"
+}
+```
+
+**Benefits:**
+- 75% fewer MCP calls (1 call vs 4 calls in v3.2.x)
+- 35% token reduction
+- Clearer intent
+- Atomic file registration
+
+### New: watch_files Action
+
+Manage file watches dynamically:
+
+```javascript
+// Watch files
+{
+  action: "watch_files",
+  task_id: 123,
+  action: "watch",
+  file_paths: ["src/auth.ts", "src/middleware/jwt.ts"]
+}
+
+// Unwatch files
+{
+  action: "watch_files",
+  task_id: 123,
+  action: "unwatch",
+  file_paths: ["src/middleware/jwt.ts"]
+}
+
+// List watched files
+{
+  action: "watch_files",
+  task_id: 123,
+  action: "list"
+}
+// Response: { files: ["src/auth.ts"], files_count: 1 }
+```
+
+### Migration from v3.2.x
+
+**Before (deprecated):**
+```javascript
+// Create task
+{action: "create", title: "Feature"}
+// Link files (separate calls)
+{action: "link", task_id: 123, link_type: "file", target_id: "src/file1.ts"}
+{action: "link", task_id: 123, link_type: "file", target_id: "src/file2.ts"}
+```
+
+**After (v3.4.1):**
+```javascript
+// Create task with files in one call
+{
+  action: "create",
+  title: "Feature",
+  watch_files: ["src/file1.ts", "src/file2.ts"]
+}
+```
+
+**See Also:** [MIGRATION_v3.3.md](./MIGRATION_v3.3.md) for complete migration guide.
+
+---
+
 ## Decision Context System (v3.2.2)
 
 ### What is Decision Context?
@@ -590,7 +678,7 @@ Quick reference:
 - **waiting_review**: Completed, awaiting review
 - **blocked**: Cannot proceed due to blocker
 - **done**: Completed successfully
-- **archived**: No longer relevant
+- **archived**: Completed and archived (auto-archived after 48 hours)
 
 ### Constraint Categories
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sqlew",
-  "version": "3.2.5",
-  "description": "MCP server for efficient context sharing between Claude Code sub-agents with Kanban Task Watcher, Decision Context, auto-file-tracking, and 60-75% token reduction in multi-session projects",
+  "version": "3.5.3",
+  "description": "MCP server for efficient context sharing between Claude Code sub-agents with Kanban Task Watcher, auto-pruning for non-existent files, Git-aware auto-complete, Decision Context, auto-file-tracking, and 60-75% token reduction in multi-session projects",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -55,13 +55,15 @@
   "author": "sin5ddd",
   "license": "AGPL-3.0",
   "dependencies": {
-    "better-sqlite3": "^11.0.0",
     "@modelcontextprotocol/sdk": "latest",
-    "chokidar": "^3.6.0"
+    "better-sqlite3": "^11.0.0",
+    "chokidar": "^4.0.3",
+    "ignore": "^7.0.5",
+    "smol-toml": "^1.4.2"
   },
   "devDependencies": {
-    "typescript": "^5.0.0",
     "@types/better-sqlite3": "^7.6.0",
-    "@types/node": "^20.0.0"
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
   }
 }