sqlew 4.1.2 → 4.3.1

package/dist/watcher/queue-watcher.js

@@ -17,6 +17,8 @@ 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
@@ -25,6 +27,7 @@ export class QueueWatcher extends BaseWatcher {
     static instance = null;
     projectRoot;
     processing = false;
+    currentCallId = '';
     constructor(projectRoot) {
         super('QueueWatcher', 500); // 500ms debounce for queue changes
         this.projectRoot = projectRoot;
@@ -98,9 +101,15 @@ export class QueueWatcher extends BaseWatcher {
         if (!path.endsWith('pending.json')) {
             return;
         }
-        debugLog('INFO', `${this.watcherName}: Queue file changed`);
+        const eventId = Math.random().toString(36).slice(2, 6);
+        debugLog('INFO', `${this.watcherName}: Queue file changed`, {
+            eventId,
+            path,
+            hasDebounceTimer: this.debounceTimers.has('queue-process'),
+        });
         // Debounce to avoid processing during rapid writes
         this.debounce('queue-process', async () => {
+            debugLog('INFO', `${this.watcherName}: Debounce callback fired`, { eventId });
             await this.processQueueIfNeeded();
         });
     }
@@ -108,33 +117,57 @@ export class QueueWatcher extends BaseWatcher {
      * Process queue if items exist
      */
     async processQueueIfNeeded() {
-        // Prevent concurrent processing
+        const callId = Math.random().toString(36).slice(2, 8);
+        this.currentCallId = callId; // Store for use in item processors
+        // CRITICAL: Set processing flag IMMEDIATELY to prevent race conditions
+        // Multiple calls can arrive before the first one finishes checking hasQueueItems
         if (this.processing) {
+            debugLog('WARN', `${this.watcherName}: Skipping - already processing`, { callId });
             return;
         }
-        if (!hasQueueItems(this.projectRoot)) {
-            return;
-        }
-        this.processing = true;
+        this.processing = true; // SET IMMEDIATELY after check!
+        debugLog('INFO', `${this.watcherName}: processQueueIfNeeded called`, {
+            callId,
+            processing: true,
+        });
         try {
-            const count = await processQueue(this.projectRoot, this.processItem.bind(this));
-            if (count > 0) {
-                debugLog('INFO', `${this.watcherName}: Processed ${count} queue items`);
+            if (!hasQueueItems(this.projectRoot)) {
+                debugLog('INFO', `${this.watcherName}: Queue is empty, nothing to process`, { callId });
+                return;
             }
+            debugLog('INFO', `${this.watcherName}: Starting queue processing`, { callId });
+            const count = await processQueue(this.projectRoot, this.processItem.bind(this), callId);
+            debugLog('INFO', `${this.watcherName}: Processed ${count} queue items`, { callId });
         }
         catch (error) {
-            debugLog('ERROR', `${this.watcherName}: Error processing queue`, { error });
+            debugLog('ERROR', `${this.watcherName}: Error processing queue`, { callId, error });
         }
         finally {
             this.processing = false;
+            debugLog('INFO', `${this.watcherName}: Processing flag reset`, { callId });
         }
     }
     /**
-     * Process a single queue item
+     * Process a single queue item (decision or constraint)
+     * @since v4.2.1 - Added constraint support
      */
     async processItem(item) {
+        if (item.type === 'decision') {
+            await this.processDecisionItem(item);
+        }
+        else if (item.type === 'constraint') {
+            await this.processConstraintItem(item);
+        }
+    }
+    /**
+     * Process a decision queue item
+     */
+    async processDecisionItem(item) {
         const { action, data } = item;
-        debugLog('INFO', `${this.watcherName}: Processing ${action}`, { key: data.key });
+        debugLog('INFO', `${this.watcherName}: Processing decision ${action}`, {
+            callId: this.currentCallId,
+            key: data.key,
+        });
         if (action === 'create') {
             await quickSetDecision({
                 key: data.key,
@@ -154,6 +187,53 @@ export class QueueWatcher extends BaseWatcher {
             });
         }
     }
+    /**
+     * Process a constraint queue item
+     * @since v4.2.1
+     */
+    async processConstraintItem(item) {
+        const { action, data } = item;
+        debugLog('INFO', `${this.watcherName}: Processing constraint ${action}`, {
+            callId: this.currentCallId,
+            text: data.text?.slice(0, 50),
+            category: data.category,
+            timestamp: item.timestamp,
+        });
+        if (action === 'create') {
+            const priority = data.priority;
+            debugLog('INFO', `${this.watcherName}: Calling addConstraint`, {
+                callId: this.currentCallId,
+                text: data.text?.slice(0, 30),
+                category: data.category || 'architecture',
+                priority: priority || 'medium',
+            });
+            const result = await addConstraint({
+                constraint_text: data.text,
+                category: data.category || 'architecture',
+                priority: priority || 'medium',
+                layer: data.layer,
+                tags: data.tags,
+                active: data.active ?? true,
+            });
+            debugLog('INFO', `${this.watcherName}: addConstraint returned`, {
+                callId: this.currentCallId,
+                success: result.success,
+                constraint_id: result.constraint_id,
+            });
+        }
+        else if (action === 'activate') {
+            // 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);
+                debugLog('INFO', `${this.watcherName}: Activated constraints`, {
+                    callId: this.currentCallId,
+                    activated_count: result.activated_count,
+                    plan_tag: tag,
+                });
+            }
+        }
+    }
     /**
      * Get watcher status
      */

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/ADR_CONCEPTS.md

@@ -2,6 +2,10 @@
 
 **Architecture Decision Records (ADR)** document the architectural decisions made on a project, including context, consequences, and alternatives considered. sqlew extends this proven pattern to AI agents.
 
+## Plan-to-ADR (v4.3.0+)
+
+**Plan-to-ADR** is sqlew's automatic ADR generation feature. Write decisions in your plan files using Markdown patterns (`📌 Decision` / `🚫 Constraint`), and they're automatically extracted and registered as structured ADR entries.
+
 ## How It Works
 
 ```mermaid

package/docs/HOOKS_GUIDE.md

@@ -4,7 +4,7 @@ Integration guide for sqlew with Claude Code hooks.
 
 ## Overview
 
-sqlew integrates with Claude Code through PreToolUse and PostToolUse hooks, enabling automatic decision tracking during AI-assisted development.
+sqlew integrates with Claude Code through PreToolUse and PostToolUse hooks, enabling **Plan-to-ADR** (v4.3.0+): automatic Architecture Decision Record generation during AI-assisted development.
 
 ## Architecture
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sqlew",
   "description": "Automated ADR (Architecture Decision Records) for Claude Code - MCP server with SQL-backed decision repository",
-  "version": "4.1.2",
+  "version": "4.3.1",
   "main": "dist/index.js",
   "type": "module",
   "bin": {