sqlew 3.2.4 → 3.5.3

package/dist/watcher/gitignore-parser.js

@@ -0,0 +1,191 @@
+/**
+ * GitIgnore Parser Module (v3.4.1)
+ * Parses .gitignore files and provides file filtering functionality
+ *
+ * Features:
+ * - Load .gitignore from project root
+ * - Built-in ignore patterns (node_modules, .git, etc.)
+ * - Efficient pattern matching with ignore library
+ * - Path normalization for cross-platform compatibility
+ */
+import ignore from 'ignore';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+/**
+ * VCS index files that must NEVER be ignored (v3.5.3)
+ * These files are explicitly watched for commit detection
+ */
+export const VCS_WATCH_WHITELIST = [
+    '.git/index', // Git staging/commit detection
+    '.hg/dirstate', // Mercurial (future support)
+];
+/**
+ * Built-in patterns to always ignore (v3.4.1)
+ * These are common patterns that should be ignored regardless of .gitignore
+ */
+export const BUILT_IN_IGNORE_PATTERNS = [
+    // Version control
+    '.git',
+    '.gitignore',
+    '.gitattributes',
+    // Dependencies
+    'node_modules',
+    'bower_components',
+    'jspm_packages',
+    // Build outputs
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    '.cache',
+    '.parcel-cache',
+    '.vite',
+    // Logs
+    '*.log',
+    'logs',
+    'npm-debug.log*',
+    'yarn-debug.log*',
+    'yarn-error.log*',
+    'pnpm-debug.log*',
+    // OS files
+    '.DS_Store',
+    'Thumbs.db',
+    'desktop.ini',
+    // IDE/Editor files
+    '.vscode',
+    '.idea',
+    '.sublime-project',
+    '.sublime-workspace',
+    '*.swp',
+    '*.swo',
+    '*~',
+    // Temporary files
+    '*.tmp',
+    '*.temp',
+    '.tmp',
+    '.temp',
+    // Environment files
+    '.env',
+    '.env.local',
+    '.env.*.local',
+    // Database files
+    '*.db',
+    '*.sqlite',
+    '*.sqlite3',
+    '.mcp-context', // MCP Shared Context Server database directory
+    // Test coverage
+    'coverage',
+    '.nyc_output',
+    // Package manager locks (often large binary files)
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+];
+/**
+ * GitIgnoreParser class
+ * Handles .gitignore file parsing and file filtering
+ */
+export class GitIgnoreParser {
+    ig;
+    projectRoot;
+    /**
+     * Constructor
+     * @param projectRoot - Absolute path to project root directory
+     * @param customPatterns - Additional patterns to ignore (optional)
+     */
+    constructor(projectRoot, customPatterns = []) {
+        this.projectRoot = projectRoot;
+        this.ig = ignore();
+        // Add built-in patterns
+        this.ig.add(BUILT_IN_IGNORE_PATTERNS);
+        // Load .gitignore from project root if it exists
+        const gitignorePath = join(projectRoot, '.gitignore');
+        if (existsSync(gitignorePath)) {
+            try {
+                const gitignoreContent = readFileSync(gitignorePath, 'utf-8');
+                this.ig.add(gitignoreContent);
+            }
+            catch (error) {
+                console.error('⚠ Failed to load .gitignore:', error);
+            }
+        }
+        // Add custom patterns
+        if (customPatterns.length > 0) {
+            this.ig.add(customPatterns);
+        }
+    }
+    /**
+     * Check if a file path should be ignored
+     * @param filePath - Absolute file path to check
+     * @returns true if file should be ignored, false otherwise
+     */
+    shouldIgnore(filePath) {
+        // Normalize path: convert to relative path from project root
+        let relativePath = filePath;
+        if (filePath.startsWith(this.projectRoot)) {
+            relativePath = filePath.substring(this.projectRoot.length);
+            // Remove leading slash
+            if (relativePath.startsWith('/') || relativePath.startsWith('\\')) {
+                relativePath = relativePath.substring(1);
+            }
+        }
+        // Convert Windows backslashes to forward slashes
+        relativePath = relativePath.replace(/\\/g, '/');
+        // Handle empty path (project root itself) - never ignore it
+        if (!relativePath || relativePath === '') {
+            return false;
+        }
+        // WHITELIST CHECK FIRST (v3.5.3): VCS index files are NEVER ignored
+        // This ensures .git/index and other VCS files can be explicitly watched
+        const isVCSIndexFile = VCS_WATCH_WHITELIST.some(pattern => relativePath === pattern ||
+            relativePath.endsWith('/' + pattern) ||
+            relativePath.endsWith('\\' + pattern));
+        if (isVCSIndexFile) {
+            return false; // Force allow - never ignore VCS index files
+        }
+        // Check if path is ignored by standard patterns
+        return this.ig.ignores(relativePath);
+    }
+    /**
+     * Filter an array of file paths, removing ignored files
+     * @param filePaths - Array of absolute file paths
+     * @returns Filtered array with ignored files removed
+     */
+    filter(filePaths) {
+        return filePaths.filter(path => !this.shouldIgnore(path));
+    }
+    /**
+     * Get the project root directory
+     * @returns Absolute path to project root
+     */
+    getProjectRoot() {
+        return this.projectRoot;
+    }
+    /**
+     * Add additional patterns to ignore
+     * @param patterns - Array of gitignore-style patterns
+     */
+    addPatterns(patterns) {
+        this.ig.add(patterns);
+    }
+    /**
+     * Create a new GitIgnoreParser with additional patterns
+     * @param patterns - Additional patterns to ignore
+     * @returns New GitIgnoreParser instance
+     */
+    createChild(patterns) {
+        const parser = new GitIgnoreParser(this.projectRoot, patterns);
+        return parser;
+    }
+}
+/**
+ * Create a GitIgnoreParser for the given project root
+ * @param projectRoot - Absolute path to project root
+ * @param customPatterns - Additional patterns to ignore (optional)
+ * @returns GitIgnoreParser instance
+ */
+export function createGitIgnoreParser(projectRoot, customPatterns = []) {
+    return new GitIgnoreParser(projectRoot, customPatterns);
+}
+//# sourceMappingURL=gitignore-parser.js.map

package/dist/watcher/gitignore-parser.js.map

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

package/dist/watcher/index.d.ts

@@ -5,4 +5,5 @@
 export { FileWatcher } from './file-watcher.js';
 export { executeAcceptanceCriteria } from './test-executor.js';
 export type { CheckResult } from './test-executor.js';
+export { GitIgnoreParser, createGitIgnoreParser, BUILT_IN_IGNORE_PATTERNS } from './gitignore-parser.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/watcher/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/watcher/index.js

@@ -4,4 +4,5 @@
  */
 export { FileWatcher } from './file-watcher.js';
 export { executeAcceptanceCriteria } from './test-executor.js';
+export { GitIgnoreParser, createGitIgnoreParser, BUILT_IN_IGNORE_PATTERNS } from './gitignore-parser.js';
 //# sourceMappingURL=index.js.map

package/dist/watcher/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/docs/AI_AGENT_GUIDE.md

@@ -127,7 +127,7 @@ Each tool serves a distinct purpose in the MCP sqlew ecosystem:
                  │  └─> Use `task` tool
                  │      • Examples: "Implement feature X", "Fix bug Y"
                  │      • Key: Tracks TODO items and progress
-                 │      • Supports: status transitions, auto-stale, linking
+                 │      • Supports: status transitions, auto-stale, auto-archive, linking
                  │
                  ├─ Record file modifications?
                  │  └─> Use `file` tool

package/docs/ARCHITECTURE.md

@@ -166,6 +166,18 @@ CREATE TABLE constraint_categories (
 ```
 Purpose: Constraint types (performance, architecture, security)
 
+#### m_config
+```sql
+CREATE TABLE m_config (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+```
+Purpose: Configuration storage (retention settings, task thresholds)
+- Populated from `.sqlew/config.toml` on startup
+- Accessible via MCP `config` tool
+- See [CONFIGURATION.md](CONFIGURATION.md) for details
+
 ### Transaction Tables (Core Data)
 
 #### decisions (String Values)