sqlew 2.1.4 → 3.1.0

package/dist/utils/query-builder.js

@@ -0,0 +1,116 @@
+/**
+ * Query builder utilities for dynamic SQL query construction
+ * Eliminates duplicated WHERE clause building across tool files
+ */
+/**
+ * Build WHERE clause from filter conditions
+ * Returns both the SQL fragment and parameter array
+ *
+ * @param conditions - Array of filter conditions
+ * @returns Object with whereClause SQL and params array
+ */
+export function buildWhereClause(conditions) {
+    if (conditions.length === 0) {
+        return { whereClause: '', params: [] };
+    }
+    const clauses = [];
+    const params = [];
+    for (const condition of conditions) {
+        switch (condition.type) {
+            case 'equals':
+                clauses.push(`${condition.field} = ?`);
+                params.push(condition.value);
+                break;
+            case 'like':
+                clauses.push(`${condition.field} LIKE ?`);
+                params.push(`%${condition.value}%`);
+                break;
+            case 'notLike':
+                clauses.push(`(${condition.field} IS NULL OR (${condition.field} NOT LIKE ? AND ${condition.field} != ?))`);
+                params.push(`%${condition.value}%`, condition.value);
+                break;
+            case 'greaterThanOrEqual':
+                clauses.push(`${condition.field} >= ?`);
+                params.push(condition.value);
+                break;
+            case 'lessThanOrEqual':
+                clauses.push(`${condition.field} <= ?`);
+                params.push(condition.value);
+                break;
+            case 'in':
+                if (condition.values.length > 0) {
+                    if (condition.operator === 'OR') {
+                        // Match any value (OR logic)
+                        const inConditions = condition.values.map(() => `${condition.field} = ?`).join(' OR ');
+                        clauses.push(`(${inConditions})`);
+                        params.push(...condition.values);
+                    }
+                    else {
+                        // Match all values (AND logic) - typically not used for IN, but included for completeness
+                        for (const value of condition.values) {
+                            clauses.push(`${condition.field} = ?`);
+                            params.push(value);
+                        }
+                    }
+                }
+                break;
+            case 'likeAny':
+                if (condition.values.length > 0) {
+                    if (condition.operator === 'OR') {
+                        // Match any value with LIKE (OR logic)
+                        const likeConditions = condition.values.map(() => `${condition.field} LIKE ?`).join(' OR ');
+                        clauses.push(`(${likeConditions})`);
+                        for (const value of condition.values) {
+                            params.push(`%${value}%`);
+                        }
+                    }
+                    else {
+                        // Match all values with LIKE (AND logic)
+                        for (const value of condition.values) {
+                            clauses.push(`${condition.field} LIKE ?`);
+                            params.push(`%${value}%`);
+                        }
+                    }
+                }
+                break;
+            case 'likeExclude':
+                if (condition.values.length > 0) {
+                    // Exclude all specified values (NOT LIKE for each)
+                    for (const value of condition.values) {
+                        clauses.push(`(${condition.field} IS NULL OR (${condition.field} NOT LIKE ? AND ${condition.field} != ?))`);
+                        params.push(`%${value}%`, value);
+                    }
+                }
+                break;
+        }
+    }
+    const whereClause = clauses.length > 0 ? ' AND ' + clauses.join(' AND ') : '';
+    return { whereClause, params };
+}
+/**
+ * Build complete query with WHERE clause, ORDER BY, and LIMIT
+ *
+ * @param baseQuery - Base SELECT query (e.g., "SELECT * FROM table WHERE 1=1")
+ * @param conditions - Filter conditions
+ * @param orderBy - ORDER BY clause (e.g., "updated DESC")
+ * @param limit - LIMIT value
+ * @param offset - OFFSET value (optional)
+ * @returns Object with complete SQL query and params array
+ */
+export function buildCompleteQuery(baseQuery, conditions, orderBy, limit, offset) {
+    const { whereClause, params } = buildWhereClause(conditions);
+    let query = baseQuery + whereClause;
+    if (orderBy) {
+        query += ` ORDER BY ${orderBy}`;
+    }
+    if (limit !== undefined) {
+        query += ' LIMIT ?';
+        params.push(limit);
+    }
+    if (offset !== undefined && offset > 0) {
+        query += ' OFFSET ?';
+        params.push(offset);
+    }
+    return { query, params };
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/utils/query-builder.js.map

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

package/dist/utils/task-stale-detection.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Auto-stale detection for Kanban Task Watcher
+ * Automatically transitions abandoned tasks based on time thresholds
+ */
+import { Database } from '../types.js';
+/**
+ * Detect and transition stale tasks automatically
+ *
+ * Detection logic:
+ * - Tasks in `in_progress` with `updated_ts` older than threshold → move to `waiting_review`
+ * - Tasks in `waiting_review` with `updated_ts` older than threshold → move to `todo`
+ *
+ * @param db - Database instance
+ * @returns Count of transitioned tasks
+ */
+export declare function detectAndTransitionStaleTasks(db: Database): number;
+/**
+ * Get current auto-stale configuration
+ *
+ * @param db - Database instance
+ * @returns Current configuration values
+ */
+export declare function getStaleDetectionConfig(db: Database): {
+    enabled: boolean;
+    inProgressThresholdHours: number;
+    waitingReviewThresholdHours: number;
+};
+//# sourceMappingURL=task-stale-detection.d.ts.map

package/dist/utils/task-stale-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-stale-detection.d.ts","sourceRoot":"","sources":["../../src/utils/task-stale-detection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8BvC;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAqElE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,GAAG;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,2BAA2B,EAAE,MAAM,CAAC;CACrC,CAkBA"}

package/dist/utils/task-stale-detection.js

@@ -0,0 +1,92 @@
+/**
+ * Auto-stale detection for Kanban Task Watcher
+ * Automatically transitions abandoned tasks based on time thresholds
+ */
+import { getConfigBool, getConfigInt } from '../database.js';
+/**
+ * Task status IDs (matching schema)
+ */
+const TASK_STATUS = {
+    TODO: 1,
+    IN_PROGRESS: 2,
+    WAITING_REVIEW: 3,
+};
+/**
+ * Configuration keys for task stale detection
+ */
+const CONFIG_KEYS = {
+    TASK_STALE_HOURS_IN_PROGRESS: 'task_stale_hours_in_progress',
+    TASK_STALE_HOURS_WAITING_REVIEW: 'task_stale_hours_waiting_review',
+    TASK_AUTO_STALE_ENABLED: 'task_auto_stale_enabled',
+};
+/**
+ * Default configuration values
+ */
+const DEFAULTS = {
+    STALE_HOURS_IN_PROGRESS: 2,
+    STALE_HOURS_WAITING_REVIEW: 24,
+    AUTO_STALE_ENABLED: true,
+};
+/**
+ * Detect and transition stale tasks automatically
+ *
+ * Detection logic:
+ * - Tasks in `in_progress` with `updated_ts` older than threshold → move to `waiting_review`
+ * - Tasks in `waiting_review` with `updated_ts` older than threshold → move to `todo`
+ *
+ * @param db - Database instance
+ * @returns Count of transitioned tasks
+ */
+export function detectAndTransitionStaleTasks(db) {
+    // 1. Check if auto-stale is enabled
+    const isEnabled = getConfigBool(db, CONFIG_KEYS.TASK_AUTO_STALE_ENABLED, DEFAULTS.AUTO_STALE_ENABLED);
+    if (!isEnabled) {
+        return 0;
+    }
+    // 2. Get threshold configs (in hours)
+    const inProgressThresholdHours = getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_IN_PROGRESS, DEFAULTS.STALE_HOURS_IN_PROGRESS);
+    const waitingReviewThresholdHours = getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_WAITING_REVIEW, DEFAULTS.STALE_HOURS_WAITING_REVIEW);
+    // Convert hours to seconds for timestamp comparison
+    const inProgressThresholdSeconds = inProgressThresholdHours * 3600;
+    const waitingReviewThresholdSeconds = waitingReviewThresholdHours * 3600;
+    let totalTransitioned = 0;
+    // 3. Transition stale tasks in a transaction
+    const updateStmt = db.transaction(() => {
+        // 3a. Find and transition in_progress tasks older than threshold to waiting_review
+        const inProgressTransitioned = db.prepare(`
+      UPDATE t_tasks
+      SET status_id = ?,
+          updated_ts = unixepoch()
+      WHERE status_id = ?
+        AND updated_ts < unixepoch() - ?
+    `).run(TASK_STATUS.WAITING_REVIEW, TASK_STATUS.IN_PROGRESS, inProgressThresholdSeconds);
+        totalTransitioned += inProgressTransitioned.changes;
+        // 3b. Find and transition waiting_review tasks older than threshold to todo
+        const waitingReviewTransitioned = db.prepare(`
+      UPDATE t_tasks
+      SET status_id = ?,
+          updated_ts = unixepoch()
+      WHERE status_id = ?
+        AND updated_ts < unixepoch() - ?
+    `).run(TASK_STATUS.TODO, TASK_STATUS.WAITING_REVIEW, waitingReviewThresholdSeconds);
+        totalTransitioned += waitingReviewTransitioned.changes;
+    });
+    // Execute the transaction
+    updateStmt();
+    // 4. Return count of transitioned tasks
+    return totalTransitioned;
+}
+/**
+ * Get current auto-stale configuration
+ *
+ * @param db - Database instance
+ * @returns Current configuration values
+ */
+export function getStaleDetectionConfig(db) {
+    return {
+        enabled: getConfigBool(db, CONFIG_KEYS.TASK_AUTO_STALE_ENABLED, DEFAULTS.AUTO_STALE_ENABLED),
+        inProgressThresholdHours: getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_IN_PROGRESS, DEFAULTS.STALE_HOURS_IN_PROGRESS),
+        waitingReviewThresholdHours: getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_WAITING_REVIEW, DEFAULTS.STALE_HOURS_WAITING_REVIEW),
+    };
+}
+//# sourceMappingURL=task-stale-detection.js.map

package/dist/utils/task-stale-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-stale-detection.js","sourceRoot":"","sources":["../../src/utils/task-stale-detection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,CAAC;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,4BAA4B,EAAE,8BAA8B;IAC5D,+BAA+B,EAAE,iCAAiC;IAClE,uBAAuB,EAAE,yBAAyB;CAC1C,CAAC;AAEX;;GAEG;AACH,MAAM,QAAQ,GAAG;IACf,uBAAuB,EAAE,CAAC;IAC1B,0BAA0B,EAAE,EAAE;IAC9B,kBAAkB,EAAE,IAAI;CAChB,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAAY;IACxD,oCAAoC;IACpC,MAAM,SAAS,GAAG,aAAa,CAC7B,EAAE,EACF,WAAW,CAAC,uBAAuB,EACnC,QAAQ,CAAC,kBAAkB,CAC5B,CAAC;IAEF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC;IAED,sCAAsC;IACtC,MAAM,wBAAwB,GAAG,YAAY,CAC3C,EAAE,EACF,WAAW,CAAC,4BAA4B,EACxC,QAAQ,CAAC,uBAAuB,CACjC,CAAC;IAEF,MAAM,2BAA2B,GAAG,YAAY,CAC9C,EAAE,EACF,WAAW,CAAC,+BAA+B,EAC3C,QAAQ,CAAC,0BAA0B,CACpC,CAAC;IAEF,oDAAoD;IACpD,MAAM,0BAA0B,GAAG,wBAAwB,GAAG,IAAI,CAAC;IACnE,MAAM,6BAA6B,GAAG,2BAA2B,GAAG,IAAI,CAAC;IAEzE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,6CAA6C;IAC7C,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACrC,mFAAmF;QACnF,MAAM,sBAAsB,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;KAMzC,CAAC,CAAC,GAAG,CACJ,WAAW,CAAC,cAAc,EAC1B,WAAW,CAAC,WAAW,EACvB,0BAA0B,CAC3B,CAAC;QAEF,iBAAiB,IAAI,sBAAsB,CAAC,OAAO,CAAC;QAEpD,4EAA4E;QAC5E,MAAM,yBAAyB,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;KAM5C,CAAC,CAAC,GAAG,CACJ,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,cAAc,EAC1B,6BAA6B,CAC9B,CAAC;QAEF,iBAAiB,IAAI,yBAAyB,CAAC,OAAO,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,UAAU,EAAE,CAAC;IAEb,wCAAwC;IACxC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAY;IAKlD,OAAO;QACL,OAAO,EAAE,aAAa,CACpB,EAAE,EACF,WAAW,CAAC,uBAAuB,EACnC,QAAQ,CAAC,kBAAkB,CAC5B;QACD,wBAAwB,EAAE,YAAY,CACpC,EAAE,EACF,WAAW,CAAC,4BAA4B,EACxC,QAAQ,CAAC,uBAAuB,CACjC;QACD,2BAA2B,EAAE,YAAY,CACvC,EAAE,EACF,WAAW,CAAC,+BAA+B,EAC3C,QAAQ,CAAC,0BAA0B,CACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/validators.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Centralized validation utilities
+ * Phase 1 modularization - eliminates 27+ duplicate validation patterns
+ * Token savings: ~2,600 tokens across 5 tool files
+ */
+import type { Database } from '../types.js';
+/**
+ * Validates required string parameter (trim and check non-empty)
+ * @throws Error if value is empty or whitespace-only
+ */
+export declare function validateRequired(value: string, paramName: string): string;
+/**
+ * Validates status enum value
+ * @throws Error if status is not valid
+ */
+export declare function validateStatus(status: string): 'active' | 'deprecated' | 'draft';
+/**
+ * Validates priority string (low/medium/high/critical)
+ * @throws Error if priority is not valid
+ */
+export declare function validatePriority(priority: string): 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Validates priority number (1-4 range)
+ * @throws Error if priority is out of range
+ */
+export declare function validatePriorityRange(priority: number): number;
+/**
+ * Validates layer and returns layer_id
+ * @throws Error if layer is invalid
+ */
+export declare function validateLayer(db: Database, layer: string): number;
+/**
+ * Validates message type enum
+ * @throws Error if message type is invalid
+ */
+export declare function validateMessageType(msgType: string): 'decision' | 'warning' | 'request' | 'info';
+/**
+ * Validates change type enum
+ * @throws Error if change type is invalid
+ */
+export declare function validateChangeType(changeType: string): 'created' | 'modified' | 'deleted';
+/**
+ * Validates category enum
+ * @throws Error if category is invalid
+ */
+export declare function validateCategory(category: string): 'performance' | 'architecture' | 'security';
+/**
+ * Validates string length
+ * @throws Error if string exceeds max length
+ */
+export declare function validateLength(value: string, paramName: string, maxLength: number): string;
+/**
+ * Validates number is within range
+ * @throws Error if number is out of range
+ */
+export declare function validateRange(value: number, paramName: string, min: number, max: number): number;
+//# sourceMappingURL=validators.d.ts.map

package/dist/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAMhF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAMzF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAMhG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAMzF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,CAM9F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhG"}

package/dist/utils/validators.js

@@ -0,0 +1,117 @@
+/**
+ * Centralized validation utilities
+ * Phase 1 modularization - eliminates 27+ duplicate validation patterns
+ * Token savings: ~2,600 tokens across 5 tool files
+ */
+/**
+ * Validates required string parameter (trim and check non-empty)
+ * @throws Error if value is empty or whitespace-only
+ */
+export function validateRequired(value, paramName) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`${paramName} is required`);
+    }
+    return trimmed;
+}
+/**
+ * Validates status enum value
+ * @throws Error if status is not valid
+ */
+export function validateStatus(status) {
+    const validStatuses = ['active', 'deprecated', 'draft'];
+    if (!validStatuses.includes(status)) {
+        throw new Error(`Invalid status. Must be one of: ${validStatuses.join(', ')}`);
+    }
+    return status;
+}
+/**
+ * Validates priority string (low/medium/high/critical)
+ * @throws Error if priority is not valid
+ */
+export function validatePriority(priority) {
+    const validPriorities = ['low', 'medium', 'high', 'critical'];
+    if (!validPriorities.includes(priority)) {
+        throw new Error(`Invalid priority. Must be one of: ${validPriorities.join(', ')}`);
+    }
+    return priority;
+}
+/**
+ * Validates priority number (1-4 range)
+ * @throws Error if priority is out of range
+ */
+export function validatePriorityRange(priority) {
+    if (priority < 1 || priority > 4) {
+        throw new Error('Priority must be between 1 and 4');
+    }
+    return priority;
+}
+/**
+ * Validates layer and returns layer_id
+ * @throws Error if layer is invalid
+ */
+export function validateLayer(db, layer) {
+    const validLayers = ['presentation', 'business', 'data', 'infrastructure', 'cross-cutting'];
+    if (!validLayers.includes(layer)) {
+        throw new Error(`Invalid layer. Must be one of: ${validLayers.join(', ')}`);
+    }
+    const result = db.prepare('SELECT layer_id FROM m_layers WHERE layer_name = ?').get(layer);
+    if (!result) {
+        throw new Error(`Layer not found in database: ${layer}`);
+    }
+    return result.layer_id;
+}
+/**
+ * Validates message type enum
+ * @throws Error if message type is invalid
+ */
+export function validateMessageType(msgType) {
+    const validTypes = ['decision', 'warning', 'request', 'info'];
+    if (!validTypes.includes(msgType)) {
+        throw new Error(`Invalid message type. Must be one of: ${validTypes.join(', ')}`);
+    }
+    return msgType;
+}
+/**
+ * Validates change type enum
+ * @throws Error if change type is invalid
+ */
+export function validateChangeType(changeType) {
+    const validTypes = ['created', 'modified', 'deleted'];
+    if (!validTypes.includes(changeType)) {
+        throw new Error(`Invalid change type. Must be one of: ${validTypes.join(', ')}`);
+    }
+    return changeType;
+}
+/**
+ * Validates category enum
+ * @throws Error if category is invalid
+ */
+export function validateCategory(category) {
+    const validCategories = ['performance', 'architecture', 'security'];
+    if (!validCategories.includes(category)) {
+        throw new Error(`Invalid category. Must be one of: ${validCategories.join(', ')}`);
+    }
+    return category;
+}
+/**
+ * Validates string length
+ * @throws Error if string exceeds max length
+ */
+export function validateLength(value, paramName, maxLength) {
+    if (value.length > maxLength) {
+        throw new Error(`${paramName} exceeds maximum length of ${maxLength} characters`);
+    }
+    return value;
+}
+/**
+ * Validates number is within range
+ * @throws Error if number is out of range
+ */
+export function validateRange(value, paramName, min, max) {
+    if (value < min || value > max) {
+        throw new Error(`${paramName} must be between ${min} and ${max}`);
+    }
+    return value;
+}
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

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

package/dist/watcher/file-watcher.d.ts

@@ -0,0 +1,75 @@
+/**
+ * File Watcher - Auto-tracking file changes linked to tasks
+ * Monitors files and auto-transitions task status on file modification
+ *
+ * Features:
+ * - chokidar-based file watching with debouncing
+ * - Dynamic file registration (add/remove files at runtime)
+ * - Auto-transition: todo → in_progress on file change
+ * - Maps file paths → task IDs for efficient lookup
+ */
+/**
+ * FileWatcher class - Singleton pattern
+ */
+export declare class FileWatcher {
+    private static instance;
+    private watcher;
+    private watchedFiles;
+    private isRunning;
+    private debounceTimers;
+    private readonly DEBOUNCE_MS;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): FileWatcher;
+    /**
+     * Initialize and start the file watcher
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the file watcher
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a file to watch for a specific task
+     */
+    registerFile(filePath: string, taskId: number, taskTitle: string, currentStatus: string): void;
+    /**
+     * Unregister a file from watching (when task completes or is archived)
+     */
+    unregisterFile(filePath: string, taskId: number): void;
+    /**
+     * Unregister all files for a specific task
+     */
+    unregisterTask(taskId: number): void;
+    /**
+     * Handle file change event
+     */
+    private handleFileChange;
+    /**
+     * Check acceptance criteria and auto-complete task if all pass
+     */
+    private checkAcceptanceCriteria;
+    /**
+     * Load existing task-file links from database
+     */
+    private loadTaskFileLinks;
+    /**
+     * Normalize file path (resolve relative paths, remove trailing slashes)
+     */
+    private normalizePath;
+    /**
+     * Get total count of tasks being watched
+     */
+    private getTotalTaskCount;
+    /**
+     * Get current watcher status
+     */
+    getStatus(): {
+        running: boolean;
+        filesWatched: number;
+        tasksWatched: number;
+    };
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/watcher/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAEpC,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,WAAW;IAOxC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CnC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBlC;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAwCrG;;OAEG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAuB7D;;OAEG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB3C;;OAEG;YACW,gBAAgB;IAwE9B;;OAEG;YACW,uBAAuB;IA2FrC;;OAEG;YACW,iBAAiB;IAqC/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACI,SAAS,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB;CAOF"}