sqlew 4.1.2 → 4.3.1

package/dist/utils/action-specs/file-specs.js

@@ -15,7 +15,7 @@ export const FILE_ACTION_SPECS = {
             layer: 'business',
             description: 'Added JWT validation'
         },
-        hint: "Valid change_type: created, modified, deleted"
+        hint: "Valid change_type: created, modified, deleted. Aliases: path→file_path, type→change_type"
     },
     get: {
         required: [],
@@ -25,7 +25,7 @@ export const FILE_ACTION_SPECS = {
             layer: 'business',
             limit: 10
         },
-        hint: "Use 'since' with ISO 8601 timestamp for time-based filtering"
+        hint: "Use 'since' with ISO 8601 timestamp for time-based filtering. Alias: path→file_path"
     },
     check_lock: {
         required: ['file_path'],
@@ -35,7 +35,7 @@ export const FILE_ACTION_SPECS = {
             file_path: 'src/database/schema.sql',
             lock_duration: 300
         },
-        hint: "Default lock_duration is 300 seconds (5 minutes). Prevents concurrent edits."
+        hint: "Default lock_duration is 300 seconds (5 minutes). Aliases: path→file_path, duration→lock_duration"
     },
     record_batch: {
         required: ['file_changes'],
@@ -48,7 +48,7 @@ export const FILE_ACTION_SPECS = {
             ],
             atomic: false
         },
-        hint: "Max 50 file changes per batch. Use atomic:false for best-effort recording."
+        hint: "Max 50 file changes per batch. Use atomic:false for best-effort recording. Alias: changes→file_changes"
     }
 };
 //# sourceMappingURL=file-specs.js.map

package/dist/utils/action-specs/file-specs.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-specs.js","sourceRoot":"","sources":["../../../src/utils/action-specs/file-specs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;QACtC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,EAAG,mCAAmC;QACtF,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,iBAAiB;YAC5B,WAAW,EAAE,UAAU;YACvB,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,sBAAsB;SACpC;QACD,IAAI,EAAE,+CAA+C;KACtD;IAED,GAAG,EAAE;QACH,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;QAC/E,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,8DAA8D;KACrE;IAED,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,OAAO,EAAE;YACP,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,yBAAyB;YACpC,aAAa,EAAE,GAAG;SACnB;QACD,IAAI,EAAE,8EAA8E;KACrF;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;YACtB,YAAY,EAAE;gBACZ,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE;gBAC3E,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;aACtE;YACD,MAAM,EAAE,KAAK;SACd;QACD,IAAI,EAAE,4EAA4E;KACnF;CACF,CAAC"}
+{"version":3,"file":"file-specs.js","sourceRoot":"","sources":["../../../src/utils/action-specs/file-specs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;QACtC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,EAAG,mCAAmC;QACtF,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,iBAAiB;YAC5B,WAAW,EAAE,UAAU;YACvB,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,sBAAsB;SACpC;QACD,IAAI,EAAE,0FAA0F;KACjG;IAED,GAAG,EAAE;QACH,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;QAC/E,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,qFAAqF;KAC5F;IAED,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,OAAO,EAAE;YACP,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,yBAAyB;YACpC,aAAa,EAAE,GAAG;SACnB;QACD,IAAI,EAAE,mGAAmG;KAC1G;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;YACtB,YAAY,EAAE;gBACZ,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE;gBAC3E,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;aACtE;YACD,MAAM,EAAE,KAAK;SACd;QACD,IAAI,EAAE,wGAAwG;KAC/G;CACF,CAAC"}

package/dist/utils/hook-queue.d.ts

@@ -7,7 +7,7 @@
  * @since v4.1.0
  */
 /** Queue item action type */
-export type QueueAction = 'create' | 'update';
+export type QueueAction = 'create' | 'update' | 'activate';
 /** Queue item for decision operations */
 export interface DecisionQueueItem {
     type: 'decision';
@@ -21,9 +21,26 @@ export interface DecisionQueueItem {
         tags?: string[];
     };
 }
+/** Queue item for constraint operations */
+export interface ConstraintQueueItem {
+    type: 'constraint';
+    action: QueueAction;
+    timestamp: string;
+    data: {
+        text: string;
+        category?: string;
+        priority?: string;
+        layer?: string;
+        tags?: string[];
+        active?: boolean;
+        plan_id?: string;
+    };
+}
+/** Union type for all queue items */
+export type QueueItem = DecisionQueueItem | ConstraintQueueItem;
 /** Queue file structure */
 export interface QueueFile {
-    items: DecisionQueueItem[];
+    items: QueueItem[];
 }
 /**
  * Get queue file path for a project
@@ -67,9 +84,10 @@ export declare function enqueueDecisionUpdate(projectPath: string, data: {
  *
  * @param projectPath - Project root path
  * @param processor - Function to process each item
+ * @param callId - Optional call ID for tracing
  * @returns Number of items processed
  */
-export declare function processQueue(projectPath: string, processor: (item: DecisionQueueItem) => Promise<void>): Promise<number>;
+export declare function processQueue(projectPath: string, processor: (item: QueueItem) => Promise<void>, callId?: string): Promise<number>;
 /**
  * Clear the queue file
  */
@@ -78,4 +96,26 @@ export declare function clearQueue(projectPath: string): void;
  * Check if queue has pending items
  */
 export declare function hasQueueItems(projectPath: string): boolean;
+/**
+ * Enqueue a constraint creation
+ *
+ * @param projectPath - Project root path
+ * @param data - Constraint data
+ */
+export declare function enqueueConstraintCreate(projectPath: string, data: {
+    text: string;
+    category?: string;
+    priority?: string;
+    layer?: string;
+    tags?: string[];
+    active?: boolean;
+    plan_id?: string;
+}): void;
+/**
+ * Enqueue constraint activation (set active=1)
+ *
+ * @param projectPath - Project root path
+ * @param planId - Plan ID to match constraints
+ */
+export declare function enqueueConstraintActivate(projectPath: string, planId: string): void;
 //# sourceMappingURL=hook-queue.d.ts.map

package/dist/utils/hook-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-queue.d.ts","sourceRoot":"","sources":["../../src/utils/hook-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAgBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAYD;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAYxD;AAeD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GACA,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GACA,IAAI,CAUN;AAMD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GACpD,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAKpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG1D"}
+{"version":3,"file":"hook-queue.d.ts","sourceRoot":"","sources":["../../src/utils/hook-queue.ts"],"names":[],"mappings":"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"}

package/dist/utils/hook-queue.js

@@ -6,8 +6,85 @@
  *
  * @since v4.1.0
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, renameSync, appendFileSync } from 'fs';
 import { join } from 'path';
+import { debugLog } from './debug-logger.js';
+// ============================================================================
+// Debug Configuration
+// ============================================================================
+/**
+ * Enable detailed trace logging for queue operations.
+ * Set to `true` when debugging queue issues (writes to .sqlew/queue/trace.log)
+ *
+ * Also controls:
+ * - snapshot_*.json files (per-write snapshots)
+ * - pending-debug.json (write history)
+ */
+const QUEUE_TRACE_ENABLED = false;
+// ============================================================================
+// File Lock for Queue Processing
+// ============================================================================
+/** Lock timeout in milliseconds (30 seconds) */
+const LOCK_TIMEOUT_MS = 30000;
+/**
+ * Try to acquire a lock for queue processing
+ * Uses file-based locking with timestamp for stale lock detection
+ *
+ * @param projectPath - Project root path
+ * @returns true if lock acquired, false if another process holds the lock
+ */
+function tryAcquireLock(projectPath) {
+    const lockPath = join(projectPath, '.sqlew/queue/pending.lock');
+    if (existsSync(lockPath)) {
+        try {
+            const lock = JSON.parse(readFileSync(lockPath, 'utf-8'));
+            const age = Date.now() - lock.timestamp;
+            if (age < LOCK_TIMEOUT_MS) {
+                debugLog('INFO', '[hook-queue] Lock held by another process', {
+                    pid: lock.pid,
+                    ageMs: age,
+                });
+                return false; // Lock still valid, skip processing
+            }
+            debugLog('WARN', '[hook-queue] Stale lock detected, overwriting', {
+                pid: lock.pid,
+                ageMs: age,
+            });
+        }
+        catch {
+            // Lock file corrupted, overwrite it
+            debugLog('WARN', '[hook-queue] Corrupted lock file, overwriting');
+        }
+    }
+    // Acquire lock
+    try {
+        writeFileSync(lockPath, JSON.stringify({
+            pid: process.pid,
+            timestamp: Date.now(), // Unix epoch ms (timezone-independent)
+        }));
+        debugLog('INFO', '[hook-queue] Lock acquired', { pid: process.pid });
+        return true;
+    }
+    catch (error) {
+        debugLog('ERROR', '[hook-queue] Failed to acquire lock', { error });
+        return false;
+    }
+}
+/**
+ * Release the queue processing lock
+ *
+ * @param projectPath - Project root path
+ */
+function releaseLock(projectPath) {
+    const lockPath = join(projectPath, '.sqlew/queue/pending.lock');
+    try {
+        unlinkSync(lockPath);
+        debugLog('INFO', '[hook-queue] Lock released');
+    }
+    catch {
+        // Ignore errors (file may already be deleted)
+    }
+}
 // ============================================================================
 // Constants
 // ============================================================================
@@ -33,30 +110,138 @@ function ensureQueueDir(projectPath) {
         mkdirSync(queueDir, { recursive: true });
     }
 }
+/**
+ * Write to queue trace log (debugLog-independent for Hook CLI)
+ * Logs ALL operations for debugging Hook flow
+ *
+ * @note Controlled by QUEUE_TRACE_ENABLED flag
+ */
+function writeQueueTrace(projectPath, level, message, data) {
+    if (!QUEUE_TRACE_ENABLED)
+        return;
+    try {
+        const traceLogPath = join(projectPath, QUEUE_DIR, 'trace.log');
+        const dataStr = data ? ` | ${JSON.stringify(data)}` : '';
+        const entry = `[${new Date().toISOString()}] [${level}] [PID:${process.pid}] ${message}${dataStr}\n`;
+        appendFileSync(traceLogPath, entry, 'utf-8');
+    }
+    catch { /* ignore */ }
+}
 /**
  * Read queue file (returns empty queue if not exists)
  */
 export function readQueue(projectPath) {
     const queuePath = getQueuePath(projectPath);
+    writeQueueTrace(projectPath, 'INFO', 'readQueue: START', { queuePath });
     if (!existsSync(queuePath)) {
+        writeQueueTrace(projectPath, 'INFO', 'readQueue: file does not exist, returning empty');
+        debugLog('DEBUG', '[hook-queue] readQueue: file does not exist', { queuePath });
         return { items: [] };
     }
     try {
         const content = readFileSync(queuePath, 'utf-8');
-        return JSON.parse(content);
+        writeQueueTrace(projectPath, 'INFO', 'readQueue: read file', {
+            contentLength: content.length,
+            contentPreview: content.slice(0, 100),
+        });
+        debugLog('DEBUG', '[hook-queue] readQueue: read file', {
+            queuePath,
+            contentLength: content.length,
+            contentPreview: content.slice(0, 100),
+        });
+        const parsed = JSON.parse(content);
+        writeQueueTrace(projectPath, 'INFO', 'readQueue: SUCCESS', { itemCount: parsed.items?.length ?? 0 });
+        debugLog('DEBUG', '[hook-queue] readQueue: parsed successfully', {
+            itemCount: parsed.items?.length ?? 0,
+        });
+        return parsed;
     }
-    catch {
-        // If file is corrupted, return empty queue
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        writeQueueTrace(projectPath, 'ERROR', 'readQueue: JSON parse FAILED', { error: errorMsg });
+        debugLog('ERROR', '[hook-queue] readQueue: JSON parse failed', {
+            queuePath,
+            error: errorMsg,
+        });
         return { items: [] };
     }
 }
 /**
- * Write queue file
+ * Write queue file (atomic write to prevent partial reads)
+ *
+ * Uses write-to-temp + rename pattern to ensure readers always see
+ * complete file content, even on Windows where file locking is different.
+ *
+ * @param projectPath - Project root path
+ * @param queue - Queue data to write
+ * @param caller - Name of the calling function (for debug snapshots)
  */
-function writeQueue(projectPath, queue) {
+function writeQueue(projectPath, queue, caller = 'unknown') {
     ensureQueueDir(projectPath);
     const queuePath = getQueuePath(projectPath);
-    writeFileSync(queuePath, JSON.stringify(queue, null, 2), 'utf-8');
+    const tempPath = queuePath + '.tmp';
+    // Write to temp file first
+    const content = JSON.stringify(queue, null, 2);
+    writeFileSync(tempPath, content, 'utf-8');
+    // Atomic rename (Windows: uses MoveFileEx internally)
+    try {
+        renameSync(tempPath, queuePath);
+    }
+    catch (error) {
+        // Fallback: If rename fails (e.g., cross-device), write directly
+        debugLog('WARN', '[hook-queue] writeQueue: rename failed, using direct write', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        writeFileSync(queuePath, content, 'utf-8');
+        try {
+            unlinkSync(tempPath);
+        }
+        catch { /* ignore */ }
+    }
+    // DEBUG: Snapshot after each write with caller name + epoch time
+    // Controlled by QUEUE_TRACE_ENABLED flag
+    if (QUEUE_TRACE_ENABLED) {
+        const epoch = Date.now();
+        const snapshotPath = queuePath.replace('pending.json', `snapshot_${caller}_${epoch}.json`);
+        try {
+            const snapshotData = {
+                caller,
+                timestamp: new Date().toISOString(),
+                epoch,
+                pid: process.pid,
+                itemCount: queue.items.length,
+                items: queue.items,
+            };
+            writeFileSync(snapshotPath, JSON.stringify(snapshotData, null, 2), 'utf-8');
+        }
+        catch { /* ignore snapshot errors */ }
+        // DEBUG: Also write to pending-debug.json with timestamp for tracing
+        const debugPath = queuePath.replace('pending.json', 'pending-debug.json');
+        const debugData = {
+            timestamp: new Date().toISOString(),
+            pid: process.pid,
+            itemCount: queue.items.length,
+            items: queue.items,
+        };
+        try {
+            // Append to debug file (read existing + append)
+            let existing = [];
+            if (existsSync(debugPath)) {
+                try {
+                    existing = JSON.parse(readFileSync(debugPath, 'utf-8'));
+                }
+                catch {
+                    existing = [];
+                }
+            }
+            existing.push(debugData);
+            // Keep last 50 entries
+            if (existing.length > 50)
+                existing = existing.slice(-50);
+            writeFileSync(debugPath, JSON.stringify(existing, null, 2), 'utf-8');
+        }
+        catch { /* ignore debug file errors */ }
+    }
 }
 // ============================================================================
 // Enqueue Operations (Used by Hooks - Fast, No DB)
@@ -68,7 +253,16 @@ function writeQueue(projectPath, queue) {
  * @param data - Decision data
  */
 export function enqueueDecisionCreate(projectPath, data) {
+    writeQueueTrace(projectPath, 'INFO', 'enqueueDecisionCreate: START', { key: data.key });
     const queue = readQueue(projectPath);
+    writeQueueTrace(projectPath, 'INFO', 'enqueueDecisionCreate: after readQueue', { existingItems: queue.items.length });
+    // Duplicate check: skip if same key already in queue
+    const existingDecision = queue.items.find(i => i.type === 'decision' && i.data.key === data.key);
+    if (existingDecision) {
+        writeQueueTrace(projectPath, 'WARN', 'enqueueDecisionCreate: SKIP duplicate', { key: data.key });
+        debugLog('INFO', '[hook-queue] Skipping duplicate decision in queue', { key: data.key });
+        return;
+    }
     const item = {
         type: 'decision',
         action: 'create',
@@ -76,7 +270,9 @@ export function enqueueDecisionCreate(projectPath, data) {
         data,
     };
     queue.items.push(item);
-    writeQueue(projectPath, queue);
+    writeQueueTrace(projectPath, 'INFO', 'enqueueDecisionCreate: before writeQueue', { totalItems: queue.items.length });
+    writeQueue(projectPath, queue, 'enqueueDecisionCreate');
+    writeQueueTrace(projectPath, 'INFO', 'enqueueDecisionCreate: DONE');
 }
 /**
  * Enqueue a decision status update
@@ -93,7 +289,7 @@ export function enqueueDecisionUpdate(projectPath, data) {
         data,
     };
     queue.items.push(item);
-    writeQueue(projectPath, queue);
+    writeQueue(projectPath, queue, 'enqueueDecisionUpdate');
 }
 // ============================================================================
 // Process Queue (Used by MCP Server on Startup)
@@ -106,36 +302,76 @@ export function enqueueDecisionUpdate(projectPath, data) {
  *
  * @param projectPath - Project root path
  * @param processor - Function to process each item
+ * @param callId - Optional call ID for tracing
  * @returns Number of items processed
  */
-export async function processQueue(projectPath, processor) {
-    const queue = readQueue(projectPath);
-    if (queue.items.length === 0) {
+export async function processQueue(projectPath, processor, callId) {
+    // Try to acquire file lock for exclusive processing
+    if (!tryAcquireLock(projectPath)) {
+        debugLog('INFO', '[hook-queue] Skipping processQueue - another process holds the lock', { callId });
         return 0;
     }
-    let processed = 0;
-    const errors = [];
-    for (const item of queue.items) {
-        try {
-            await processor(item);
-            processed++;
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            errors.push({ item, error: message });
-            console.error(`[hook-queue] Error processing item: ${message}`);
+    try {
+        const queue = readQueue(projectPath);
+        debugLog('INFO', '[hook-queue] processQueue called', {
+            callId,
+            pid: process.pid,
+            itemCount: queue.items.length,
+            items: queue.items.map(i => ({
+                type: i.type,
+                action: i.action,
+                key: i.type === 'decision' ? i.data.key : undefined,
+                text: i.type === 'constraint' ? i.data.text?.slice(0, 30) : undefined,
+            })),
+        });
+        if (queue.items.length === 0) {
+            return 0;
         }
-    }
-    // Clear processed items (keep failed items for retry)
-    if (errors.length === 0) {
+        // CRITICAL: Clear queue IMMEDIATELY after reading to prevent duplicate processing
+        // If another call comes in while we're processing, it will see an empty queue
+        debugLog('INFO', '[hook-queue] Clearing queue before processing (race condition prevention)', { callId });
         clearQueue(projectPath);
+        let processed = 0;
+        const errors = [];
+        for (let i = 0; i < queue.items.length; i++) {
+            const item = queue.items[i];
+            debugLog('INFO', `[hook-queue] Processing item ${i + 1}/${queue.items.length}`, {
+                callId,
+                type: item.type,
+                action: item.action,
+            });
+            try {
+                await processor(item);
+                processed++;
+                debugLog('INFO', `[hook-queue] Item ${i + 1} processed successfully`, { callId });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                errors.push({ item, error: message });
+                debugLog('ERROR', `[hook-queue] Item ${i + 1} failed`, { callId, error: message });
+                console.error(`[hook-queue] Error processing item: ${message}`);
+            }
+        }
+        debugLog('INFO', '[hook-queue] Processing complete', {
+            callId,
+            processed,
+            errors: errors.length,
+            errorDetails: errors.map(e => e.error),
+        });
+        // Write back only failed items for retry
+        if (errors.length > 0) {
+            const failedItems = errors.map((e) => e.item);
+            debugLog('WARN', '[hook-queue] Writing back failed items for retry', {
+                callId,
+                failedCount: failedItems.length,
+            });
+            writeQueue(projectPath, { items: failedItems }, 'processQueue_retry');
+        }
+        return processed;
     }
-    else {
-        // Keep only failed items
-        const failedItems = errors.map((e) => e.item);
-        writeQueue(projectPath, { items: failedItems });
+    finally {
+        releaseLock(projectPath);
     }
-    return processed;
 }
 /**
  * Clear the queue file
@@ -143,7 +379,7 @@ export async function processQueue(projectPath, processor) {
 export function clearQueue(projectPath) {
     const queuePath = getQueuePath(projectPath);
     if (existsSync(queuePath)) {
-        writeQueue(projectPath, { items: [] });
+        writeQueue(projectPath, { items: [] }, 'clearQueue');
     }
 }
 /**
@@ -153,4 +389,62 @@ export function hasQueueItems(projectPath) {
     const queue = readQueue(projectPath);
     return queue.items.length > 0;
 }
+// ============================================================================
+// Constraint Queue Operations (v4.2.1+)
+// ============================================================================
+/**
+ * Enqueue a constraint creation
+ *
+ * @param projectPath - Project root path
+ * @param data - Constraint data
+ */
+export function enqueueConstraintCreate(projectPath, data) {
+    writeQueueTrace(projectPath, 'INFO', 'enqueueConstraintCreate: START', { text: data.text?.slice(0, 30) });
+    const queue = readQueue(projectPath);
+    writeQueueTrace(projectPath, 'INFO', 'enqueueConstraintCreate: after readQueue', { existingItems: queue.items.length });
+    // Duplicate check: skip if same text already in queue
+    const existingConstraint = queue.items.find(i => i.type === 'constraint' && i.data.text === data.text);
+    if (existingConstraint) {
+        writeQueueTrace(projectPath, 'WARN', 'enqueueConstraintCreate: SKIP duplicate', { text: data.text?.slice(0, 30) });
+        debugLog('INFO', '[hook-queue] Skipping duplicate constraint in queue', { text: data.text?.slice(0, 30) });
+        return;
+    }
+    const item = {
+        type: 'constraint',
+        action: 'create',
+        timestamp: new Date().toISOString(),
+        data,
+    };
+    queue.items.push(item);
+    writeQueueTrace(projectPath, 'INFO', 'enqueueConstraintCreate: before writeQueue', { totalItems: queue.items.length });
+    debugLog('INFO', '[hook-queue] enqueueConstraintCreate', {
+        projectPath,
+        text: data.text?.slice(0, 30),
+        category: data.category,
+        queueSizeAfter: queue.items.length,
+    });
+    writeQueue(projectPath, queue, 'enqueueConstraintCreate');
+    writeQueueTrace(projectPath, 'INFO', 'enqueueConstraintCreate: DONE');
+}
+/**
+ * Enqueue constraint activation (set active=1)
+ *
+ * @param projectPath - Project root path
+ * @param planId - Plan ID to match constraints
+ */
+export function enqueueConstraintActivate(projectPath, planId) {
+    const queue = readQueue(projectPath);
+    const item = {
+        type: 'constraint',
+        action: 'activate',
+        timestamp: new Date().toISOString(),
+        data: {
+            text: '', // Not used for activate action
+            plan_id: planId,
+            active: true,
+        },
+    };
+    queue.items.push(item);
+    writeQueue(projectPath, queue, 'enqueueConstraintActivate');
+}
 //# sourceMappingURL=hook-queue.js.map

package/dist/utils/hook-queue.js.map

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

package/dist/utils/param-normalizer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Parameter Alias Normalizer
+ *
+ * Converts short aliases to canonical parameter names before validation.
+ * This enables user-friendly shorter parameter names while maintaining
+ * consistent internal naming conventions.
+ *
+ * @example
+ * // Single alias
+ * normalizeParams(params, { path: 'file_path' });
+ *
+ * // Multiple aliases
+ * normalizeParams(params, {
+ *   path: 'file_path',
+ *   type: 'change_type'
+ * });
+ */
+/**
+ * Normalize parameter aliases to canonical names.
+ *
+ * Only converts alias to canonical if:
+ * 1. The alias parameter exists
+ * 2. The canonical parameter does NOT exist (avoid overwrite)
+ *
+ * @param params - Original parameters object
+ * @param aliases - Mapping of alias names to canonical names { alias: canonical }
+ * @returns New object with normalized parameter names
+ */
+export declare function normalizeParams<T extends object>(params: T, aliases: Record<string, string>): T;
+/**
+ * Pre-defined alias mappings for each tool.
+ * Centralized definitions for consistency and documentation.
+ */
+export declare const DECISION_ALIASES: {
+    readonly alternatives: "alternatives_considered";
+    readonly task_id: "related_task_id";
+    readonly constraint_id: "related_constraint_id";
+    readonly after: "updated_after";
+    readonly before: "updated_before";
+    readonly key: "decision_key";
+};
+export declare const FILE_ALIASES: {
+    readonly path: "file_path";
+    readonly type: "change_type";
+    readonly changes: "file_changes";
+    readonly duration: "lock_duration";
+};
+export declare const CONSTRAINT_ALIASES: {
+    readonly text: "constraint_text";
+    readonly id: "constraint_id";
+};
+//# sourceMappingURL=param-normalizer.d.ts.map

package/dist/utils/param-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-normalizer.d.ts","sourceRoot":"","sources":["../../src/utils/param-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,CAAC,CAWH;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;CASf,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;CAKrB,CAAC"}