sqlew 3.2.5 → 3.6.0

package/dist/utils/help-tracking.js

@@ -0,0 +1,88 @@
+/**
+ * Help Action Usage Tracking
+ *
+ * Lightweight logging system to track help/example action invocations
+ * for understanding usage patterns and optimizing documentation.
+ *
+ * Data collected:
+ * - tool_name: Which MCP tool invoked help/example
+ * - action_name: "help" or "example"
+ * - timestamp: When the action was invoked
+ * - token_count: Estimated tokens in request + response
+ *
+ * Storage: Temporary log file in .sqlew/tmp/help-usage.log
+ * Format: JSON lines (one JSON object per line for easy parsing)
+ * Retention: Manual cleanup after 1-2 week analysis period
+ */
+import { appendFileSync, existsSync, mkdirSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * Log file configuration
+ */
+const LOG_DIR = resolve(process.cwd(), '.sqlew', 'tmp');
+const LOG_FILE = resolve(LOG_DIR, 'help-usage.log');
+/**
+ * Initialize logging directory
+ * Creates .sqlew/tmp/ if it doesn't exist
+ */
+function ensureLogDirectory() {
+    if (!existsSync(LOG_DIR)) {
+        mkdirSync(LOG_DIR, { recursive: true });
+    }
+}
+/**
+ * Log a help action invocation
+ * Appends JSON line to log file for analysis
+ *
+ * @param record - Help usage record to log
+ */
+export function logHelpUsage(record) {
+    try {
+        ensureLogDirectory();
+        // Append as JSON line (newline-delimited JSON)
+        const jsonLine = JSON.stringify(record) + '\n';
+        appendFileSync(LOG_FILE, jsonLine, 'utf8');
+    }
+    catch (error) {
+        // Silent failure - don't break tool execution if logging fails
+        console.error('[Help Tracking] Failed to log usage:', error);
+    }
+}
+/**
+ * Estimate token count for help/example action
+ * Rough estimation based on response length
+ *
+ * @param toolName - Name of the MCP tool
+ * @param actionName - "help" or "example"
+ * @param responseLength - Length of response text
+ * @returns Estimated token count (request + response)
+ */
+export function estimateHelpTokens(toolName, actionName, responseLength) {
+    // Request tokens: tool name + action parameter (~50 tokens)
+    const requestTokens = 50;
+    // Response tokens: approximate 4 chars per token
+    const responseTokens = Math.ceil(responseLength / 4);
+    return requestTokens + responseTokens;
+}
+/**
+ * Track help action and return the help content
+ * Convenience wrapper that logs and returns content
+ *
+ * @param toolName - Name of the MCP tool
+ * @param actionName - "help" or "example"
+ * @param content - Help content to return
+ * @param context - Optional context about what triggered help
+ * @returns The help content (pass-through)
+ */
+export function trackAndReturnHelp(toolName, actionName, content, context) {
+    const tokenCount = estimateHelpTokens(toolName, actionName, content.length);
+    logHelpUsage({
+        tool_name: toolName,
+        action_name: actionName,
+        timestamp: new Date().toISOString(),
+        token_count: tokenCount,
+        context
+    });
+    return content;
+}
+//# sourceMappingURL=help-tracking.js.map

package/dist/utils/help-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-tracking.js","sourceRoot":"","sources":["../../src/utils/help-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAa/B;;GAEG;AACH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAEpD;;;GAGG;AACH,SAAS,kBAAkB;IACzB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,IAAI,CAAC;QACH,kBAAkB,EAAE,CAAC;QAErB,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAC/C,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+DAA+D;QAC/D,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,UAA8B,EAC9B,cAAsB;IAEtB,4DAA4D;IAC5D,MAAM,aAAa,GAAG,EAAE,CAAC;IAEzB,iDAAiD;IACjD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAErD,OAAO,aAAa,GAAG,cAAc,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,UAA8B,EAC9B,OAAe,EACf,OAAgB;IAEhB,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5E,YAAY,CAAC;QACX,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,WAAW,EAAE,UAAU;QACvB,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/quality-checks.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Quality Checks - Validation functions for smart review detection
+ * Determines when tasks are ready for review based on quality gates
+ */
+import type { Database } from 'better-sqlite3';
+/**
+ * Quality check result
+ */
+export interface QualityCheckResult {
+    passed: boolean;
+    message: string;
+    details?: string;
+}
+/**
+ * Check if all watched files for a task have been modified at least once
+ *
+ * @param db - Database connection
+ * @param taskId - Task ID to check
+ * @param modifiedFiles - Set of files that have been modified
+ * @returns True if all watched files have been modified, false otherwise
+ */
+export declare function checkAllFilesModified(db: Database, taskId: number, modifiedFiles: Set<string>): QualityCheckResult;
+/**
+ * Check if TypeScript files compile without syntax errors
+ *
+ * @param filePaths - Array of file paths to check
+ * @returns Promise resolving to true if TypeScript compiles, false otherwise
+ */
+export declare function checkTypeScriptCompiles(filePaths: string[]): Promise<QualityCheckResult>;
+/**
+ * Check if tests pass for the task
+ *
+ * @param db - Database connection
+ * @param taskId - Task ID to check
+ * @param filePaths - Array of file paths being watched
+ * @returns Promise resolving to true if tests pass, false otherwise
+ */
+export declare function checkTestsPass(db: Database, taskId: number, filePaths: string[]): Promise<QualityCheckResult>;
+/**
+ * Check if task is ready for review based on all quality gates
+ *
+ * @param db - Database connection
+ * @param taskId - Task ID to check
+ * @param filePaths - Array of file paths being watched
+ * @param modifiedFiles - Set of files that have been modified
+ * @param config - Configuration flags for which checks to run
+ * @returns Promise resolving to object with overall result and individual check results
+ */
+export declare function checkReadyForReview(db: Database, taskId: number, filePaths: string[], modifiedFiles: Set<string>, config: {
+    requireAllFilesModified: boolean;
+    requireTestsPass: boolean;
+    requireCompile: boolean;
+}): Promise<{
+    ready: boolean;
+    results: Array<{
+        check: string;
+        result: QualityCheckResult;
+    }>;
+}>;
+//# sourceMappingURL=quality-checks.d.ts.map

package/dist/utils/quality-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-checks.d.ts","sourceRoot":"","sources":["../../src/utils/quality-checks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,kBAAkB,CA8CpB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8C9F;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA4F7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAC1B,MAAM,EAAE;IACN,uBAAuB,EAAE,OAAO,CAAC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;CACzB,GACA,OAAO,CAAC;IACT,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;CAC/D,CAAC,CAuBD"}

package/dist/utils/quality-checks.js

@@ -0,0 +1,228 @@
+/**
+ * Quality Checks - Validation functions for smart review detection
+ * Determines when tasks are ready for review based on quality gates
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Check if all watched files for a task have been modified at least once
+ *
+ * @param db - Database connection
+ * @param taskId - Task ID to check
+ * @param modifiedFiles - Set of files that have been modified
+ * @returns True if all watched files have been modified, false otherwise
+ */
+export function checkAllFilesModified(db, taskId, modifiedFiles) {
+    try {
+        // Get all watched files for this task
+        const stmt = db.prepare(`
+      SELECT f.path
+      FROM t_task_file_links tfl
+      JOIN m_files f ON f.id = tfl.file_id
+      WHERE tfl.task_id = ?
+    `);
+        const watchedFiles = stmt.all(taskId);
+        if (watchedFiles.length === 0) {
+            // No files to watch - consider this check passed
+            return {
+                passed: true,
+                message: 'No files being watched (check skipped)',
+            };
+        }
+        // Check if all watched files have been modified
+        const unmodifiedFiles = [];
+        for (const { path } of watchedFiles) {
+            if (!modifiedFiles.has(path)) {
+                unmodifiedFiles.push(path);
+            }
+        }
+        if (unmodifiedFiles.length === 0) {
+            return {
+                passed: true,
+                message: `All ${watchedFiles.length} watched files have been modified`,
+            };
+        }
+        else {
+            return {
+                passed: false,
+                message: `${unmodifiedFiles.length} of ${watchedFiles.length} watched files not yet modified`,
+                details: `Unmodified: ${unmodifiedFiles.slice(0, 3).join(', ')}${unmodifiedFiles.length > 3 ? '...' : ''}`,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            passed: false,
+            message: `Error checking file modifications: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Check if TypeScript files compile without syntax errors
+ *
+ * @param filePaths - Array of file paths to check
+ * @returns Promise resolving to true if TypeScript compiles, false otherwise
+ */
+export async function checkTypeScriptCompiles(filePaths) {
+    try {
+        // Filter for TypeScript files
+        const tsFiles = filePaths.filter(path => path.endsWith('.ts') || path.endsWith('.tsx'));
+        if (tsFiles.length === 0) {
+            return {
+                passed: true,
+                message: 'No TypeScript files to check (check skipped)',
+            };
+        }
+        // Run tsc --noEmit to check for syntax errors
+        // This checks the entire project, not just individual files,
+        // because TypeScript needs full context for type checking
+        try {
+            const { stdout, stderr } = await execAsync('npx tsc --noEmit', {
+                timeout: 30000, // 30 second timeout
+                maxBuffer: 1024 * 1024 * 5, // 5MB buffer
+            });
+            return {
+                passed: true,
+                message: `TypeScript compilation successful (${tsFiles.length} .ts/.tsx files)`,
+            };
+        }
+        catch (error) {
+            // tsc returns non-zero exit code if there are errors
+            const output = (error.stdout || '') + (error.stderr || '');
+            const errorLines = output.split('\n').filter((line) => line.includes('error TS')).slice(0, 3); // First 3 errors
+            return {
+                passed: false,
+                message: 'TypeScript compilation failed',
+                details: errorLines.join('\n') || output.slice(0, 300),
+            };
+        }
+    }
+    catch (error) {
+        return {
+            passed: false,
+            message: `Error running TypeScript check: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Check if tests pass for the task
+ *
+ * @param db - Database connection
+ * @param taskId - Task ID to check
+ * @param filePaths - Array of file paths being watched
+ * @returns Promise resolving to true if tests pass, false otherwise
+ */
+export async function checkTestsPass(db, taskId, filePaths) {
+    try {
+        // Check if any files match test patterns
+        const testPatterns = [/\.test\.(ts|tsx|js|jsx)$/, /\.spec\.(ts|tsx|js|jsx)$/];
+        const testFiles = filePaths.filter(path => testPatterns.some(pattern => pattern.test(path)));
+        if (testFiles.length === 0) {
+            return {
+                passed: true,
+                message: 'No test files found (check skipped)',
+            };
+        }
+        // Look for acceptance_criteria with tests_pass type
+        const stmt = db.prepare(`
+      SELECT acceptance_criteria
+      FROM t_task_details
+      WHERE task_id = ?
+    `);
+        const row = stmt.get(taskId);
+        if (!row?.acceptance_criteria) {
+            // No acceptance criteria - run default test command if package.json has test script
+            return {
+                passed: true,
+                message: 'No test acceptance criteria defined (check skipped)',
+            };
+        }
+        const criteria = JSON.parse(row.acceptance_criteria);
+        const testCriteria = criteria.find((c) => c.type === 'tests_pass');
+        if (!testCriteria) {
+            return {
+                passed: true,
+                message: 'No test acceptance criteria defined (check skipped)',
+            };
+        }
+        // Execute the test command
+        const command = testCriteria.command || 'npm test';
+        const timeout = testCriteria.timeout || 60; // Default 60s timeout
+        try {
+            const { stdout, stderr } = await execAsync(command, {
+                timeout: timeout * 1000,
+                maxBuffer: 1024 * 1024 * 10, // 10MB buffer
+            });
+            const output = stdout + stderr;
+            // Check for expected pattern if specified
+            if (testCriteria.expected_pattern) {
+                const regex = new RegExp(testCriteria.expected_pattern);
+                if (regex.test(output)) {
+                    return {
+                        passed: true,
+                        message: `Tests passed (${testFiles.length} test files)`,
+                        details: `Command: ${command}`,
+                    };
+                }
+                else {
+                    return {
+                        passed: false,
+                        message: 'Tests ran but output does not match expected pattern',
+                        details: output.slice(0, 300),
+                    };
+                }
+            }
+            // No pattern specified - success if exit code is 0
+            return {
+                passed: true,
+                message: `Tests passed (${testFiles.length} test files)`,
+                details: `Command: ${command}`,
+            };
+        }
+        catch (error) {
+            const output = (error.stdout || '') + (error.stderr || '');
+            return {
+                passed: false,
+                message: error.killed ? 'Tests timed out' : 'Tests failed',
+                details: output.slice(0, 300),
+            };
+        }
+    }
+    catch (error) {
+        return {
+            passed: false,
+            message: `Error running tests: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Check if task is ready for review based on all quality gates
+ *
+ * @param db - Database connection
+ * @param taskId - Task ID to check
+ * @param filePaths - Array of file paths being watched
+ * @param modifiedFiles - Set of files that have been modified
+ * @param config - Configuration flags for which checks to run
+ * @returns Promise resolving to object with overall result and individual check results
+ */
+export async function checkReadyForReview(db, taskId, filePaths, modifiedFiles, config) {
+    const results = [];
+    // Run all enabled checks
+    if (config.requireAllFilesModified) {
+        const result = checkAllFilesModified(db, taskId, modifiedFiles);
+        results.push({ check: 'all_files_modified', result });
+    }
+    if (config.requireCompile) {
+        const result = await checkTypeScriptCompiles(filePaths);
+        results.push({ check: 'typescript_compiles', result });
+    }
+    if (config.requireTestsPass) {
+        const result = await checkTestsPass(db, taskId, filePaths);
+        results.push({ check: 'tests_pass', result });
+    }
+    // All enabled checks must pass
+    const ready = results.every(({ result }) => result.passed);
+    return { ready, results };
+}
+//# sourceMappingURL=quality-checks.js.map

package/dist/utils/quality-checks.js.map

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

package/dist/utils/retention.d.ts

@@ -2,23 +2,31 @@
  * Weekend-aware retention logic for auto-deletion
  * Calculates cutoff timestamps that skip weekends when configured
  */
-import { Database } from '../types.js';
+import { DatabaseAdapter } from '../adapters/index.js';
 /**
  * Calculate cutoff timestamp for message retention
  * Respects weekend-awareness configuration
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @returns Unix timestamp (seconds) for cutoff
  */
-export declare function calculateMessageCutoff(db: Database): number;
+export declare function calculateMessageCutoff(adapter: DatabaseAdapter): Promise<number>;
 /**
  * Calculate cutoff timestamp for file change retention
  * Respects weekend-awareness configuration
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @returns Unix timestamp (seconds) for cutoff
  */
-export declare function calculateFileChangeCutoff(db: Database): number;
+export declare function calculateFileChangeCutoff(adapter: DatabaseAdapter): Promise<number>;
+/**
+ * Calculate cutoff timestamp for task archive (done → archived)
+ * Respects weekend-awareness configuration
+ *
+ * @param adapter - Database adapter instance
+ * @returns Unix timestamp (seconds) for cutoff
+ */
+export declare function calculateTaskArchiveCutoff(adapter: DatabaseAdapter): Promise<number>;
 /**
  * Calculate cutoff timestamp with optional weekend-awareness
  *

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

@@ -1 +1 @@
-{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/utils/retention.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAK3D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAK9D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,OAAO,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,CAYR;AA4CD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAavE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAe9D"}
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/utils/retention.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIvD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtF;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAKzF;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1F;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,OAAO,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,CAYR;AA4CD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAavE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAe9D"}

package/dist/utils/retention.js

@@ -8,24 +8,36 @@ import { CONFIG_KEYS } from '../constants.js';
  * Calculate cutoff timestamp for message retention
  * Respects weekend-awareness configuration
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @returns Unix timestamp (seconds) for cutoff
  */
-export function calculateMessageCutoff(db) {
-    const ignoreWeekends = getConfigBool(db, CONFIG_KEYS.AUTODELETE_IGNORE_WEEKEND, false);
-    const retentionHours = getConfigInt(db, CONFIG_KEYS.AUTODELETE_MESSAGE_HOURS, 24);
+export async function calculateMessageCutoff(adapter) {
+    const ignoreWeekends = await getConfigBool(adapter, CONFIG_KEYS.AUTODELETE_IGNORE_WEEKEND, false);
+    const retentionHours = await getConfigInt(adapter, CONFIG_KEYS.AUTODELETE_MESSAGE_HOURS, 24);
     return calculateCutoffTimestamp(retentionHours, ignoreWeekends, 'hours');
 }
 /**
  * Calculate cutoff timestamp for file change retention
  * Respects weekend-awareness configuration
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @returns Unix timestamp (seconds) for cutoff
  */
-export function calculateFileChangeCutoff(db) {
-    const ignoreWeekends = getConfigBool(db, CONFIG_KEYS.AUTODELETE_IGNORE_WEEKEND, false);
-    const retentionDays = getConfigInt(db, CONFIG_KEYS.AUTODELETE_FILE_HISTORY_DAYS, 7);
+export async function calculateFileChangeCutoff(adapter) {
+    const ignoreWeekends = await getConfigBool(adapter, CONFIG_KEYS.AUTODELETE_IGNORE_WEEKEND, false);
+    const retentionDays = await getConfigInt(adapter, CONFIG_KEYS.AUTODELETE_FILE_HISTORY_DAYS, 7);
+    return calculateCutoffTimestamp(retentionDays, ignoreWeekends, 'days');
+}
+/**
+ * Calculate cutoff timestamp for task archive (done → archived)
+ * Respects weekend-awareness configuration
+ *
+ * @param adapter - Database adapter instance
+ * @returns Unix timestamp (seconds) for cutoff
+ */
+export async function calculateTaskArchiveCutoff(adapter) {
+    const ignoreWeekends = await getConfigBool(adapter, CONFIG_KEYS.AUTODELETE_IGNORE_WEEKEND, false);
+    const retentionDays = await getConfigInt(adapter, CONFIG_KEYS.AUTO_ARCHIVE_DONE_DAYS, 2); // Default: 2 days (48 hours)
     return calculateCutoffTimestamp(retentionDays, ignoreWeekends, 'days');
 }
 /**

package/dist/utils/retention.js.map

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

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

@@ -1,28 +1,98 @@
 /**
  * Auto-stale detection for Kanban Task Watcher
  * Automatically transitions abandoned tasks based on time thresholds
+ *
+ * CONVERTED: Using Knex.js with DatabaseAdapter (async/await)
  */
-import { Database } from '../types.js';
+import { DatabaseAdapter } from '../adapters/index.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
+ * @param adapter - Database adapter instance
  * @returns Count of transitioned tasks
  */
-export declare function detectAndTransitionStaleTasks(db: Database): number;
+export declare function detectAndTransitionStaleTasks(adapter?: DatabaseAdapter): Promise<number>;
 /**
  * Get current auto-stale configuration
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @returns Current configuration values
  */
-export declare function getStaleDetectionConfig(db: Database): {
+export declare function getStaleDetectionConfig(adapter?: DatabaseAdapter): Promise<{
     enabled: boolean;
     inProgressThresholdHours: number;
     waitingReviewThresholdHours: number;
-};
+}>;
+/**
+ * Auto-archive old done tasks
+ * Archives tasks in 'done' status older than configured threshold
+ * Uses weekend-aware retention logic (consistent with messages/files)
+ *
+ * Default: 48 hours (2 days)
+ * Weekend-aware: Task done Friday → archives Tuesday (skip Sat/Sun)
+ *
+ * @param adapter - Database adapter instance
+ * @returns Count of archived tasks
+ */
+export declare function autoArchiveOldDoneTasks(adapter?: DatabaseAdapter): Promise<number>;
+/**
+ * Detect and complete tasks in waiting_review or in_progress when all watched files are committed
+ *
+ * VCS-aware auto-complete strategy (v3.4.0+):
+ * - Find all tasks in `waiting_review` or `in_progress` status with watched files
+ * - For each task, check if ALL watched files have been committed since task creation
+ * - Query VCS history to determine committed files
+ * - If all files committed → transition to `done` (VCS commit = implicit approval)
+ * - Supports multiple VCS: Git, Mercurial, SVN
+ * - Gracefully handle non-VCS repos (skip auto-complete)
+ *
+ * @param adapter - Database adapter instance
+ * @returns Count of auto-completed tasks
+ */
+export declare function detectAndCompleteReviewedTasks(adapter?: DatabaseAdapter): Promise<number>;
+/**
+ * Detect and auto-complete tasks in waiting_review when all watched files are staged
+ * (v3.5.2 - Two-step Git-aware workflow: staging → done)
+ *
+ * Logic:
+ * - Find all tasks in waiting_review status
+ * - Check if ALL watched files are staged (git add)
+ * - If yes → transition to done
+ * - Respects git_auto_complete_on_stage config
+ *
+ * @param db - Database instance
+ * @returns Count of auto-completed tasks
+ */
+export declare function detectAndCompleteOnStaging(adapter?: DatabaseAdapter): Promise<number>;
+/**
+ * Detect and auto-archive tasks in done when all watched files are committed
+ * (v3.5.2 - Two-step Git-aware workflow: commit → archived)
+ *
+ * Logic:
+ * - Find all tasks in done status
+ * - Check if ALL watched files are committed (git commit)
+ * - If yes → transition to archived
+ * - Respects git_auto_archive_on_commit config
+ *
+ * @param db - Database instance
+ * @returns Count of auto-archived tasks
+ */
+export declare function detectAndArchiveOnCommit(adapter?: DatabaseAdapter): Promise<number>;
+/**
+ * Detect and transition in_progress tasks to waiting_review based on quality gates
+ * Database-backed approach that survives restarts
+ *
+ * Quality gates:
+ * - Task has been idle (no updates) for configured time (default 3 minutes)
+ * - All watched files have been modified at least once
+ * - TypeScript compiles without errors (if .ts files)
+ * - Tests pass (if test files exist)
+ *
+ * @param db - Database instance
+ * @returns Count of transitioned tasks
+ */
+export declare function detectAndTransitionToReview(adapter?: DatabaseAdapter): Promise<number>;
 //# sourceMappingURL=task-stale-detection.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"task-stale-detection.d.ts","sourceRoot":"","sources":["../../src/utils/task-stale-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiDvD;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAqD9F;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC;IAChF,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,2BAA2B,EAAE,MAAM,CAAC;CACrC,CAAC,CAoBD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAqG/F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ3F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAgGzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ5F"}