sqlew 1.0.0

package/dist/tools/context.js

@@ -0,0 +1,442 @@
+/**
+ * Context management tools for MCP Shared Context Server
+ * Implements set_decision, get_context, and get_decision tools
+ */
+import { getDatabase, getOrCreateAgent, getOrCreateContextKey, getOrCreateTag, getOrCreateScope, getLayerId, transaction } from '../database.js';
+import { STRING_TO_STATUS, DEFAULT_VERSION, DEFAULT_STATUS } from '../constants.js';
+/**
+ * Set or update a decision in the context
+ * Auto-detects numeric vs string values and routes to appropriate table
+ * Supports tags, layers, scopes, and version tracking
+ *
+ * @param params - Decision parameters
+ * @returns Response with success status and metadata
+ */
+export function setDecision(params) {
+    const db = getDatabase();
+    // Validate required parameters
+    if (!params.key || params.key.trim() === '') {
+        throw new Error('Parameter "key" is required and cannot be empty');
+    }
+    if (params.value === undefined || params.value === null) {
+        throw new Error('Parameter "value" is required');
+    }
+    // Determine if value is numeric
+    const isNumeric = typeof params.value === 'number';
+    const value = params.value;
+    // Set defaults
+    const version = params.version || DEFAULT_VERSION;
+    const status = params.status ? STRING_TO_STATUS[params.status] : DEFAULT_STATUS;
+    const agentName = params.agent || 'system';
+    // Validate status
+    if (params.status && !STRING_TO_STATUS[params.status]) {
+        throw new Error(`Invalid status: ${params.status}. Must be 'active', 'deprecated', or 'draft'`);
+    }
+    // Validate layer if provided
+    let layerId = null;
+    if (params.layer) {
+        layerId = getLayerId(db, params.layer);
+        if (layerId === null) {
+            throw new Error(`Invalid layer: ${params.layer}. Must be one of: presentation, business, data, infrastructure, cross-cutting`);
+        }
+    }
+    try {
+        // Use transaction for atomicity
+        return transaction(db, () => {
+            // Get or create master records
+            const agentId = getOrCreateAgent(db, agentName);
+            const keyId = getOrCreateContextKey(db, params.key);
+            // Current timestamp
+            const ts = Math.floor(Date.now() / 1000);
+            // Insert or update decision based on value type
+            if (isNumeric) {
+                // Numeric decision
+                const stmt = db.prepare(`
+          INSERT INTO decisions_numeric (key_id, value, agent_id, layer_id, version, status, ts)
+          VALUES (?, ?, ?, ?, ?, ?, ?)
+          ON CONFLICT(key_id) DO UPDATE SET
+            value = excluded.value,
+            agent_id = excluded.agent_id,
+            layer_id = excluded.layer_id,
+            version = excluded.version,
+            status = excluded.status,
+            ts = excluded.ts
+        `);
+                stmt.run(keyId, value, agentId, layerId, version, status, ts);
+            }
+            else {
+                // String decision
+                const stmt = db.prepare(`
+          INSERT INTO decisions (key_id, value, agent_id, layer_id, version, status, ts)
+          VALUES (?, ?, ?, ?, ?, ?, ?)
+          ON CONFLICT(key_id) DO UPDATE SET
+            value = excluded.value,
+            agent_id = excluded.agent_id,
+            layer_id = excluded.layer_id,
+            version = excluded.version,
+            status = excluded.status,
+            ts = excluded.ts
+        `);
+                stmt.run(keyId, String(value), agentId, layerId, version, status, ts);
+            }
+            // Handle tags (many-to-many)
+            if (params.tags && params.tags.length > 0) {
+                // Clear existing tags
+                db.prepare('DELETE FROM decision_tags WHERE decision_key_id = ?').run(keyId);
+                // Insert new tags
+                const tagStmt = db.prepare('INSERT INTO decision_tags (decision_key_id, tag_id) VALUES (?, ?)');
+                for (const tagName of params.tags) {
+                    const tagId = getOrCreateTag(db, tagName);
+                    tagStmt.run(keyId, tagId);
+                }
+            }
+            // Handle scopes (many-to-many)
+            if (params.scopes && params.scopes.length > 0) {
+                // Clear existing scopes
+                db.prepare('DELETE FROM decision_scopes WHERE decision_key_id = ?').run(keyId);
+                // Insert new scopes
+                const scopeStmt = db.prepare('INSERT INTO decision_scopes (decision_key_id, scope_id) VALUES (?, ?)');
+                for (const scopeName of params.scopes) {
+                    const scopeId = getOrCreateScope(db, scopeName);
+                    scopeStmt.run(keyId, scopeId);
+                }
+            }
+            return {
+                success: true,
+                key: params.key,
+                key_id: keyId,
+                version: version,
+                message: `Decision "${params.key}" set successfully`
+            };
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to set decision: ${message}`);
+    }
+}
+/**
+ * Get context decisions with advanced filtering
+ * Uses tagged_decisions view for token efficiency
+ * Supports filtering by status, layer, tags, and scope
+ *
+ * @param params - Filter parameters
+ * @returns Array of decisions with metadata
+ */
+export function getContext(params = {}) {
+    const db = getDatabase();
+    try {
+        // Build query dynamically based on filters
+        let query = 'SELECT * FROM tagged_decisions WHERE 1=1';
+        const queryParams = [];
+        // Filter by status
+        if (params.status) {
+            if (!STRING_TO_STATUS[params.status]) {
+                throw new Error(`Invalid status: ${params.status}`);
+            }
+            query += ' AND status = ?';
+            queryParams.push(params.status);
+        }
+        // Filter by layer
+        if (params.layer) {
+            query += ' AND layer = ?';
+            queryParams.push(params.layer);
+        }
+        // Filter by scope
+        if (params.scope) {
+            // Use LIKE for comma-separated scopes
+            query += ' AND (scopes LIKE ? OR scopes = ?)';
+            queryParams.push(`%${params.scope}%`, params.scope);
+        }
+        // Filter by tags
+        if (params.tags && params.tags.length > 0) {
+            const tagMatch = params.tag_match || 'OR';
+            if (tagMatch === 'AND') {
+                // All tags must be present
+                for (const tag of params.tags) {
+                    query += ' AND (tags LIKE ? OR tags = ?)';
+                    queryParams.push(`%${tag}%`, tag);
+                }
+            }
+            else {
+                // Any tag must be present (OR)
+                const tagConditions = params.tags.map(() => '(tags LIKE ? OR tags = ?)').join(' OR ');
+                query += ` AND (${tagConditions})`;
+                for (const tag of params.tags) {
+                    queryParams.push(`%${tag}%`, tag);
+                }
+            }
+        }
+        // Order by most recent
+        query += ' ORDER BY updated DESC';
+        // Execute query
+        const stmt = db.prepare(query);
+        const rows = stmt.all(...queryParams);
+        return {
+            decisions: rows,
+            count: rows.length
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get context: ${message}`);
+    }
+}
+/**
+ * Get a specific decision by key
+ * Returns full metadata including tags, layer, scopes, version
+ *
+ * @param params - Decision key
+ * @returns Decision details or not found
+ */
+export function getDecision(params) {
+    const db = getDatabase();
+    // Validate parameter
+    if (!params.key || params.key.trim() === '') {
+        throw new Error('Parameter "key" is required and cannot be empty');
+    }
+    try {
+        // Query tagged_decisions view
+        const stmt = db.prepare('SELECT * FROM tagged_decisions WHERE key = ?');
+        const row = stmt.get(params.key);
+        if (!row) {
+            return {
+                found: false
+            };
+        }
+        return {
+            found: true,
+            decision: row
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get decision: ${message}`);
+    }
+}
+/**
+ * Search for decisions by tags with AND/OR logic
+ * Provides flexible tag-based filtering with status and layer support
+ *
+ * @param params - Search parameters (tags, match_mode, status, layer)
+ * @returns Array of decisions matching tag criteria
+ */
+export function searchByTags(params) {
+    const db = getDatabase();
+    // Validate required parameters
+    if (!params.tags || params.tags.length === 0) {
+        throw new Error('Parameter "tags" is required and must contain at least one tag');
+    }
+    try {
+        const matchMode = params.match_mode || 'OR';
+        let query = 'SELECT * FROM tagged_decisions WHERE 1=1';
+        const queryParams = [];
+        // Apply tag filtering based on match mode
+        if (matchMode === 'AND') {
+            // All tags must be present
+            for (const tag of params.tags) {
+                query += ' AND (tags LIKE ? OR tags = ?)';
+                queryParams.push(`%${tag}%`, tag);
+            }
+        }
+        else if (matchMode === 'OR') {
+            // Any tag must be present
+            const tagConditions = params.tags.map(() => '(tags LIKE ? OR tags = ?)').join(' OR ');
+            query += ` AND (${tagConditions})`;
+            for (const tag of params.tags) {
+                queryParams.push(`%${tag}%`, tag);
+            }
+        }
+        else {
+            throw new Error(`Invalid match_mode: ${matchMode}. Must be 'AND' or 'OR'`);
+        }
+        // Optional status filter
+        if (params.status) {
+            if (!STRING_TO_STATUS[params.status]) {
+                throw new Error(`Invalid status: ${params.status}. Must be 'active', 'deprecated', or 'draft'`);
+            }
+            query += ' AND status = ?';
+            queryParams.push(params.status);
+        }
+        // Optional layer filter
+        if (params.layer) {
+            // Validate layer exists
+            const layerId = getLayerId(db, params.layer);
+            if (layerId === null) {
+                throw new Error(`Invalid layer: ${params.layer}. Must be one of: presentation, business, data, infrastructure, cross-cutting`);
+            }
+            query += ' AND layer = ?';
+            queryParams.push(params.layer);
+        }
+        // Order by most recent
+        query += ' ORDER BY updated DESC';
+        // Execute query
+        const stmt = db.prepare(query);
+        const rows = stmt.all(...queryParams);
+        return {
+            decisions: rows,
+            count: rows.length
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to search by tags: ${message}`);
+    }
+}
+/**
+ * Get version history for a specific decision key
+ * Returns all historical versions ordered by timestamp (newest first)
+ *
+ * @param params - Decision key to get history for
+ * @returns Array of historical versions with metadata
+ */
+export function getVersions(params) {
+    const db = getDatabase();
+    // Validate required parameter
+    if (!params.key || params.key.trim() === '') {
+        throw new Error('Parameter "key" is required and cannot be empty');
+    }
+    try {
+        // Get key_id for the decision
+        const keyResult = db.prepare('SELECT id FROM context_keys WHERE key = ?').get(params.key);
+        if (!keyResult) {
+            // Key doesn't exist, return empty history
+            return {
+                key: params.key,
+                history: [],
+                count: 0
+            };
+        }
+        const keyId = keyResult.id;
+        // Query decision_history with agent join
+        const stmt = db.prepare(`
+      SELECT
+        dh.version,
+        dh.value,
+        a.name as agent_name,
+        datetime(dh.ts, 'unixepoch') as timestamp
+      FROM decision_history dh
+      LEFT JOIN agents a ON dh.agent_id = a.id
+      WHERE dh.key_id = ?
+      ORDER BY dh.ts DESC
+    `);
+        const rows = stmt.all(keyId);
+        // Transform to response format
+        const history = rows.map(row => ({
+            version: row.version,
+            value: row.value,
+            agent: row.agent_name,
+            timestamp: row.timestamp
+        }));
+        return {
+            key: params.key,
+            history: history,
+            count: history.length
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get versions: ${message}`);
+    }
+}
+/**
+ * Search for decisions within a specific architecture layer
+ * Supports status filtering and optional tag inclusion
+ *
+ * @param params - Layer name, optional status and include_tags
+ * @returns Array of decisions in the specified layer
+ */
+export function searchByLayer(params) {
+    const db = getDatabase();
+    // Validate required parameter
+    if (!params.layer || params.layer.trim() === '') {
+        throw new Error('Parameter "layer" is required and cannot be empty');
+    }
+    try {
+        // Validate layer exists
+        const layerId = getLayerId(db, params.layer);
+        if (layerId === null) {
+            throw new Error(`Invalid layer: ${params.layer}. Must be one of: presentation, business, data, infrastructure, cross-cutting`);
+        }
+        // Determine which view/table to use
+        const includeTagsValue = params.include_tags !== undefined ? params.include_tags : true;
+        const statusValue = params.status || 'active';
+        // Validate status
+        if (!STRING_TO_STATUS[statusValue]) {
+            throw new Error(`Invalid status: ${statusValue}. Must be 'active', 'deprecated', or 'draft'`);
+        }
+        let query;
+        const queryParams = [params.layer, statusValue];
+        if (includeTagsValue) {
+            // Use tagged_decisions view for full metadata
+            query = `
+        SELECT * FROM tagged_decisions
+        WHERE layer = ? AND status = ?
+        ORDER BY updated DESC
+      `;
+        }
+        else {
+            // Use base decisions table with minimal joins
+            query = `
+        SELECT
+          ck.key,
+          d.value,
+          d.version,
+          CASE d.status
+            WHEN 1 THEN 'active'
+            WHEN 2 THEN 'deprecated'
+            WHEN 3 THEN 'draft'
+          END as status,
+          l.name as layer,
+          NULL as tags,
+          NULL as scopes,
+          a.name as decided_by,
+          datetime(d.ts, 'unixepoch') as updated
+        FROM decisions d
+        INNER JOIN context_keys ck ON d.key_id = ck.id
+        LEFT JOIN layers l ON d.layer_id = l.id
+        LEFT JOIN agents a ON d.agent_id = a.id
+        WHERE l.name = ? AND d.status = ?
+
+        UNION ALL
+
+        SELECT
+          ck.key,
+          CAST(dn.value AS TEXT) as value,
+          dn.version,
+          CASE dn.status
+            WHEN 1 THEN 'active'
+            WHEN 2 THEN 'deprecated'
+            WHEN 3 THEN 'draft'
+          END as status,
+          l.name as layer,
+          NULL as tags,
+          NULL as scopes,
+          a.name as decided_by,
+          datetime(dn.ts, 'unixepoch') as updated
+        FROM decisions_numeric dn
+        INNER JOIN context_keys ck ON dn.key_id = ck.id
+        LEFT JOIN layers l ON dn.layer_id = l.id
+        LEFT JOIN agents a ON dn.agent_id = a.id
+        WHERE l.name = ? AND dn.status = ?
+
+        ORDER BY updated DESC
+      `;
+            // Add params for the numeric table part of UNION
+            queryParams.push(params.layer, statusValue);
+        }
+        // Execute query
+        const stmt = db.prepare(query);
+        const rows = stmt.all(...queryParams);
+        return {
+            layer: params.layer,
+            decisions: rows,
+            count: rows.length
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to search by layer: ${message}`);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

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

package/dist/tools/files.d.ts

@@ -0,0 +1,30 @@
+/**
+ * File tracking tools for MCP Shared Context Server
+ * Provides file change tracking with layer integration and lock detection
+ */
+import type { RecordFileChangeParams, RecordFileChangeResponse, GetFileChangesParams, GetFileChangesResponse, CheckFileLockParams, CheckFileLockResponse } from '../types.js';
+/**
+ * Record a file change with optional layer assignment and description.
+ * Auto-registers the file and agent if they don't exist.
+ *
+ * @param params - File change parameters
+ * @returns Success response with change ID and timestamp
+ */
+export declare function recordFileChange(params: RecordFileChangeParams): RecordFileChangeResponse;
+/**
+ * Get file changes with advanced filtering.
+ * Uses token-efficient view when no specific filters are applied.
+ *
+ * @param params - Filter parameters
+ * @returns Array of file changes with metadata
+ */
+export declare function getFileChanges(params: GetFileChangesParams): GetFileChangesResponse;
+/**
+ * Check if a file is "locked" (recently modified by another agent).
+ * Useful to prevent concurrent edits by multiple agents.
+ *
+ * @param params - File path and lock duration
+ * @returns Lock status with details
+ */
+export declare function checkFileLock(params: CheckFileLockParams): CheckFileLockResponse;
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,CAwDzF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAiGnF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,CAsDhF"}