sqlew 4.3.1 → 5.0.0

package/dist/watcher/queue-watcher.js

@@ -15,10 +15,6 @@ import { dirname } from 'path';
 import { existsSync, mkdirSync } from 'fs';
 import { BaseWatcher } from './base-watcher.js';
 import { getQueuePath, hasQueueItems, processQueue } from '../utils/hook-queue.js';
-import { quickSetDecision } from '../tools/context/actions/quick-set.js';
-import { setDecision } from '../tools/context/actions/set.js';
-import { addConstraint } from '../tools/constraints/actions/add.js';
-import { activateConstraintsByTag } from '../tools/constraints/actions/activate.js';
 import { debugLog } from '../utils/debug-logger.js';
 /**
  * QueueWatcher - Singleton for monitoring hook queue
@@ -26,21 +22,23 @@ import { debugLog } from '../utils/debug-logger.js';
 export class QueueWatcher extends BaseWatcher {
     static instance = null;
     projectRoot;
+    backend;
     processing = false;
     currentCallId = '';
-    constructor(projectRoot) {
+    constructor(projectRoot, backend) {
         super('QueueWatcher', 500); // 500ms debounce for queue changes
         this.projectRoot = projectRoot;
+        this.backend = backend;
     }
     /**
      * Get singleton instance
      */
-    static getInstance(projectRoot) {
+    static getInstance(projectRoot, backend) {
         if (!QueueWatcher.instance) {
-            if (!projectRoot) {
-                throw new Error('QueueWatcher: projectRoot required for first initialization');
+            if (!projectRoot || !backend) {
+                throw new Error('QueueWatcher: projectRoot and backend required for first initialization');
             }
-            QueueWatcher.instance = new QueueWatcher(projectRoot);
+            QueueWatcher.instance = new QueueWatcher(projectRoot, backend);
         }
         return QueueWatcher.instance;
     }
@@ -161,6 +159,7 @@ export class QueueWatcher extends BaseWatcher {
     }
     /**
      * Process a decision queue item
+     * Uses Backend abstraction to support both local DB and SaaS
      */
     async processDecisionItem(item) {
         const { action, data } = item;
@@ -169,7 +168,7 @@ export class QueueWatcher extends BaseWatcher {
             key: data.key,
         });
         if (action === 'create') {
-            await quickSetDecision({
+            await this.backend.execute('decision', 'quick_set', {
                 key: data.key,
                 value: data.value,
                 status: data.status,
@@ -178,7 +177,7 @@ export class QueueWatcher extends BaseWatcher {
             });
         }
         else if (action === 'update') {
-            await setDecision({
+            await this.backend.execute('decision', 'set', {
                 key: data.key,
                 value: data.value || `Updated: ${data.key}`,
                 status: data.status,
@@ -189,6 +188,7 @@ export class QueueWatcher extends BaseWatcher {
     }
     /**
      * Process a constraint queue item
+     * Uses Backend abstraction to support both local DB and SaaS
      * @since v4.2.1
      */
     async processConstraintItem(item) {
@@ -200,22 +200,22 @@ export class QueueWatcher extends BaseWatcher {
             timestamp: item.timestamp,
         });
         if (action === 'create') {
-            const priority = data.priority;
-            debugLog('INFO', `${this.watcherName}: Calling addConstraint`, {
+            const priority = data.priority || 'medium';
+            debugLog('INFO', `${this.watcherName}: Calling constraint.add via backend`, {
                 callId: this.currentCallId,
                 text: data.text?.slice(0, 30),
                 category: data.category || 'architecture',
-                priority: priority || 'medium',
+                priority,
             });
-            const result = await addConstraint({
+            const result = await this.backend.execute('constraint', 'add', {
                 constraint_text: data.text,
                 category: data.category || 'architecture',
-                priority: priority || 'medium',
+                priority,
                 layer: data.layer,
                 tags: data.tags,
                 active: data.active ?? true,
             });
-            debugLog('INFO', `${this.watcherName}: addConstraint returned`, {
+            debugLog('INFO', `${this.watcherName}: constraint.add returned`, {
                 callId: this.currentCallId,
                 success: result.success,
                 constraint_id: result.constraint_id,
@@ -225,7 +225,7 @@ export class QueueWatcher extends BaseWatcher {
             // Activate constraints by plan_id tag
             if (data.plan_id) {
                 const tag = data.plan_id.slice(0, 8); // Short form of plan_id
-                const result = await activateConstraintsByTag(tag);
+                const result = await this.backend.execute('constraint', 'activate_by_tag', { tag });
                 debugLog('INFO', `${this.watcherName}: Activated constraints`, {
                     callId: this.currentCallId,
                     activated_count: result.activated_count,
@@ -246,10 +246,13 @@ export class QueueWatcher extends BaseWatcher {
 }
 /**
  * Start the queue watcher
- * Called from MCP server setup after DB initialization
+ * Called from MCP server setup after backend initialization
+ *
+ * @param projectRoot - Project root directory
+ * @param backend - ToolBackend instance (local or SaaS)
  */
-export async function startQueueWatcher(projectRoot) {
-    const watcher = QueueWatcher.getInstance(projectRoot);
+export async function startQueueWatcher(projectRoot, backend) {
+    const watcher = QueueWatcher.getInstance(projectRoot, backend);
     await watcher.start();
 }
 /**

package/dist/watcher/queue-watcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue-watcher.js","sourceRoot":"","sources":["../../src/watcher/queue-watcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"queue-watcher.js","sourceRoot":"","sources":["../../src/watcher/queue-watcher.ts"],"names":[],"mappings":"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"}

package/docs/CONFIGURATION.md

@@ -61,7 +61,7 @@ message_hours = 24
 
 ```bash
 # CLI overrides config file
-npx sqlew --autodelete-message-hours=48
+sqlew --autodelete-message-hours=48
 
 # Result: message_hours = 48 (CLI wins)
 ```
@@ -80,7 +80,7 @@ npx sqlew --autodelete-message-hours=48
 
 **Custom path:** Specify via `--config-path` CLI argument
 ```bash
-npx sqlew --config-path=config/custom.toml
+sqlew --config-path=config/custom.toml
 ```
 
 ### TOML Structure
@@ -204,7 +204,7 @@ path = ".sqlew/prod.db"   # production
 
 **CLI Override:**
 ```bash
-npx sqlew /path/to/database.db
+sqlew /path/to/database.db
 ```
 
 ---
@@ -242,8 +242,8 @@ message_hours = 24
 
 **CLI Override:**
 ```bash
-npx sqlew --autodelete-ignore-weekend
-npx sqlew --autodelete-ignore-weekend=true
+sqlew --autodelete-ignore-weekend
+sqlew --autodelete-ignore-weekend=true
 ```
 
 #### `autodelete.message_hours`
@@ -267,7 +267,7 @@ message_hours = 720   # 30 days (max)
 
 **CLI Override:**
 ```bash
-npx sqlew --autodelete-message-hours=48
+sqlew --autodelete-message-hours=48
 ```
 
 #### `autodelete.file_history_days`
@@ -291,7 +291,7 @@ file_history_days = 365  # 1 year (max)
 
 **CLI Override:**
 ```bash
-npx sqlew --autodelete-file-history-days=30
+sqlew --autodelete-file-history-days=30
 ```
 
 ---
@@ -534,10 +534,10 @@ echo ".sqlew/config.toml" >> .gitignore
 
 ```bash
 # Uses .sqlew/config.toml automatically
-npx sqlew
+sqlew
 
 # Or specify custom config path
-npx sqlew --config-path=config/custom.toml
+sqlew --config-path=config/custom.toml
 ```
 
 ### 5. Verify Configuration
@@ -621,10 +621,10 @@ Use CLI arguments for one-time overrides or environment-specific settings:
 
 ```bash
 # Override specific settings at startup
-npx sqlew --autodelete-message-hours=48 --autodelete-ignore-weekend
+sqlew --autodelete-message-hours=48 --autodelete-ignore-weekend
 
 # Multiple arguments can be combined
-npx sqlew \
+sqlew \
   --db-path=.sqlew/prod.db \
   --autodelete-ignore-weekend \
   --autodelete-message-hours=168 \
@@ -772,10 +772,10 @@ file_history_days = 30
 **Usage:**
 ```bash
 # Development
-npx sqlew --config-path=.sqlew/dev.toml
+sqlew --config-path=.sqlew/dev.toml
 
 # Production
-npx sqlew --config-path=.sqlew/prod.toml
+sqlew --config-path=.sqlew/prod.toml
 ```
 
 ---
@@ -832,7 +832,7 @@ npx sqlew --config-path=.sqlew/prod.toml
 1. **Check priority:** CLI args override config file
    ```bash
    # CLI wins over config file
-   npx sqlew --autodelete-message-hours=24
+   sqlew --autodelete-message-hours=24
    ```
 
 2. **Verify config loading:**

package/docs/DATABASE_AUTH.md

@@ -119,7 +119,7 @@ password = "db-password"
 
 ## Future Authentication Methods
 
-> **Status**: Planned for future releases. If you need these features, please [open an issue](https://github.com/sin5ddd/mcp-sqlew/issues) - we'll prioritize based on demand!
+> **Status**: Planned for future releases. If you need these features, please [open an issue](https://github.com/sqlew-io/sqlew/issues) - we'll prioritize based on demand!
 
 ### SSL/TLS Client Certificates
 

package/docs/HOOKS_GUIDE.md

@@ -33,15 +33,24 @@ This architecture ensures zero latency on code edits.
 
 ## Installation
 
+As of v5.0.0, hooks are managed by the **sqlew-plugin** (Claude Code Plugin).
+
 ```bash
-# Initialize hooks in your project
-sqlew init --hooks
+# 1. Add the marketplace
+/plugin marketplace add sqlew-io/sqlew-plugin
+
+# 2. Install the plugin (user-level recommended)
+/plugin install sqlew-plugin
 
-# Without Git hooks (MCP hooks only)
-sqlew init --hooks --no-git
+# 3. Restart Claude Code to apply changes
 ```
 
-This creates `.claude/settings.local.json` with hook configuration.
+The plugin automatically configures:
+- ✅ MCP server settings (`.mcp.json`)
+- ✅ Claude Code Hooks (PreToolUse/PostToolUse)
+- ✅ Claude Code Skills (Plan Mode guidance)
+
+> **Note:** Global Rules are automatically created at `~/.claude/rules/sqlew/` when the MCP server starts.
 
 ## Hook Commands
 
@@ -67,48 +76,6 @@ This creates `.claude/settings.local.json` with hook configuration.
 | post-merge | `sqlew mark-done` | Mark decisions as complete after merge |
 | post-rewrite | `sqlew mark-done` | Mark decisions as complete after rebase |
 
-## Configuration
-
-Generated configuration in `.claude/settings.local.json`:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Task",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "sqlew suggest"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "sqlew save"
-          }
-        ]
-      },
-      {
-        "matcher": "TodoWrite",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "sqlew check-completion"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-
 ## Queue File Format
 
 `.sqlew/queue/pending.json`:
@@ -134,16 +101,27 @@ Generated configuration in `.claude/settings.local.json`:
 
 ### Hooks not triggering
 
-1. Check `.claude/settings.local.json` exists
-2. Verify hook configuration format
+1. Verify plugin is installed: `/plugin list`
+2. Check plugin status for errors
 3. Restart Claude Code to reload hooks
 
 ### Queue not processing
 
 1. Ensure MCP server is running
-2. Check `.sqlew/queue/pending.json` for items
+2. Use `queue { action: "list" }` to check pending items
 3. Verify QueueWatcher is active (check debug logs)
 
+### Items stuck in queue (High Similarity)
+
+Items may remain in queue if they have 60%+ similarity to existing decisions:
+
+1. **Check queue**: `queue { action: "list" }`
+2. **Search existing**: `/sqlew search for <topic>`
+3. **Remove if duplicate**: `queue { action: "remove", index: N }`
+4. **Or clear all**: `queue { action: "clear" }`
+
+See `~/.claude/rules/sqlew/queue-monitoring.md` for details.
+
 ### Debug logging
 
 Enable debug logging in `.sqlew/config.toml`:
@@ -156,4 +134,6 @@ log_level = "debug"
 
 ## Version History
 
+- **v5.0.0**: Hooks managed by sqlew-plugin (Claude Code Plugin)
+- **v4.3.0**: Plan-to-ADR - Automatic ADR from Plan Mode
 - **v4.1.0**: Initial Claude Code Hooks integration with File Queue Architecture

package/docs/HOW_TO_UNINSTALL.md

@@ -0,0 +1,199 @@
+# How to Uninstall sqlew
+
+This guide explains how to completely remove sqlew from your system.
+
+---
+
+## All Clients (Common Steps)
+
+These steps apply to all MCP clients (Claude Code, Codex, Gemini CLI, etc.).
+
+### 1. Remove SaaS Configuration (if using cloud mode)
+
+If you configured sqlew for SaaS/cloud mode, remove the environment file:
+
+```bash
+# Windows
+del %USERPROFILE%\.sqlew.env
+
+# macOS / Linux
+rm ~/.sqlew.env
+```
+
+### 2. Remove Project-Local Data
+
+Each project may have a `.sqlew/` directory containing:
+- `sqlew.db` - Local SQLite database
+- `config.toml` - Project configuration
+- `queue/` - Hook queue files (pending.json, failed.json)
+
+```bash
+# In each project directory
+rm -rf .sqlew/
+```
+
+---
+
+## Claude Code
+
+### 1. Remove sqlew-plugin (if installed)
+
+```bash
+# List installed plugins
+/plugin list
+
+# Remove sqlew plugin
+/plugin remove sqlew
+
+# Remove from marketplace (if added)
+/plugin marketplace remove sqlew-io/sqlew-plugin
+```
+
+### 2. Remove Plugin Repository (if cloned)
+
+If you cloned the plugin repository locally:
+
+```bash
+# Windows
+rmdir /s /q %USERPROFILE%\.claude\plugins\sqlew-plugin
+
+# macOS / Linux
+rm -rf ~/.claude/plugins/sqlew-plugin
+```
+
+### 3. Remove MCP Server Configuration
+
+Edit your Claude Code MCP settings file:
+
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+Remove the sqlew entry from `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "sqlew": { ... }  // ← Delete this entire block
+  }
+}
+```
+
+### 4. Remove Injected CLAUDE.md Section
+
+sqlew automatically injects a section into `~/.claude/CLAUDE.md`. Remove it manually:
+
+1. Open `~/.claude/CLAUDE.md` in your editor
+2. Find and delete the section between these markers:
+
+```markdown
+<!-- sqlew:auto-injected:start -->
+...
+<!-- sqlew:auto-injected:end -->
+```
+
+**Quick removal (Unix/macOS/WSL):**
+
+```bash
+# Backup first
+cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak
+
+# Remove injected section using sed
+sed -i '/<!-- sqlew:auto-injected:start -->/,/<!-- sqlew:auto-injected:end -->/d' ~/.claude/CLAUDE.md
+```
+
+**Quick removal (Windows PowerShell):**
+
+```powershell
+# Backup first
+Copy-Item "$env:USERPROFILE\.claude\CLAUDE.md" "$env:USERPROFILE\.claude\CLAUDE.md.bak"
+
+# Remove injected section
+$content = Get-Content "$env:USERPROFILE\.claude\CLAUDE.md" -Raw
+$content = $content -replace '(?s)<!-- sqlew:auto-injected:start -->.*?<!-- sqlew:auto-injected:end -->\r?\n?', ''
+Set-Content "$env:USERPROFILE\.claude\CLAUDE.md" $content
+```
+
+### 5. Remove Global Rules (Legacy v5.0.0)
+
+If you used sqlew v5.0.0 (before v5.0.0), rules were copied to `~/.claude/rules/sqlew/`:
+
+```bash
+# Windows
+rmdir /s /q %USERPROFILE%\.claude\rules\sqlew
+
+# macOS / Linux
+rm -rf ~/.claude/rules/sqlew
+```
+
+---
+
+## Codex / Gemini CLI / Other Clients
+
+### 1. Remove MCP Server Configuration
+
+Remove sqlew from your client's MCP configuration file. The location varies by client:
+
+- **Codex**: Check Codex documentation for MCP config location
+- **Gemini CLI**: Check Gemini CLI documentation for MCP config location
+
+### 2. Remove Client-Specific Injections (if any)
+
+Future versions may inject into client-specific configuration files. Check for sqlew markers:
+
+```
+<!-- sqlew:auto-injected:start -->
+...
+<!-- sqlew:auto-injected:end -->
+```
+
+---
+
+## npm Package Removal
+
+### Uninstall Global Package
+
+If installed globally:
+
+```bash
+npm uninstall -g sqlew
+# or
+npm uninstall -g mcp-sqlew
+```
+
+### Remove npm link (Development)
+
+If you used `npm link` for local development:
+
+```bash
+# In the mcp-sqlew project directory
+npm unlink
+
+# Remove global symlink
+npm unlink -g sqlew
+```
+
+---
+
+## Verification
+
+After uninstalling, verify removal:
+
+```bash
+# Check if sqlew command is available (should fail)
+sqlew --version
+
+# Check if MCP server is removed
+# Restart your MCP client and verify no sqlew tools appear
+```
+
+---
+
+## Reinstallation
+
+To reinstall sqlew:
+
+1. **Recommended (Plugin)**: `/plugin marketplace add sqlew-io/sqlew-plugin`
+2. **Manual (MCP)**: Add sqlew to your MCP configuration
+
+See [README.md](../README.md) for installation instructions.