sqlew 3.7.4 → 3.8.1

package/dist/tools/context/actions/quick-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-set.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/quick-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAqB,MAAM,aAAa,CAAC;AAEvG;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,wBAAwB,CAAC,CA2FnC"}

package/dist/tools/context/actions/quick-set.js

@@ -0,0 +1,104 @@
+/**
+ * Quick set decision with smart defaults and inference
+ * Reduces required parameters from 7 to 2 (key + value only)
+ *
+ * Inference Rules:
+ * - Layer: Inferred from key prefix
+ * - Tags: Extracted from key hierarchy
+ * - Scope: Inferred from key hierarchy
+ * - Auto-defaults: status=active, version=1.0.0
+ */
+import { DEFAULT_VERSION } from '../../../constants.js';
+import { validateActionParams } from '../internal/validation.js';
+import { setDecision } from './set.js';
+/**
+ * Quick set decision with smart defaults
+ *
+ * @param params - Quick set parameters (key and value required)
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status and inferred metadata
+ */
+export async function quickSetDecision(params, adapter) {
+    // Validate parameters
+    try {
+        validateActionParams('decision', 'quick_set', params);
+    }
+    catch (error) {
+        throw error;
+    }
+    // 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');
+    }
+    // Track what was inferred
+    const inferred = {};
+    // Infer layer from key prefix (if not provided)
+    let inferredLayer = params.layer;
+    if (!inferredLayer) {
+        const keyLower = params.key.toLowerCase();
+        if (keyLower.startsWith('api/') || keyLower.startsWith('endpoint/') || keyLower.startsWith('ui/')) {
+            inferredLayer = 'presentation';
+        }
+        else if (keyLower.startsWith('service/') || keyLower.startsWith('logic/') || keyLower.startsWith('workflow/')) {
+            inferredLayer = 'business';
+        }
+        else if (keyLower.startsWith('db/') || keyLower.startsWith('model/') || keyLower.startsWith('schema/')) {
+            inferredLayer = 'data';
+        }
+        else if (keyLower.startsWith('config/') || keyLower.startsWith('deploy/')) {
+            inferredLayer = 'infrastructure';
+        }
+        else {
+            // Default layer
+            inferredLayer = 'business';
+        }
+        inferred.layer = inferredLayer;
+    }
+    // Extract tags from key hierarchy (if not provided)
+    let inferredTags = params.tags;
+    if (!inferredTags || inferredTags.length === 0) {
+        // Split key by '/', '-', or '_' to get hierarchy parts
+        const parts = params.key.split(/[\/\-_]/).filter((p) => p.trim() !== '');
+        inferredTags = parts;
+        inferred.tags = inferredTags;
+    }
+    // Infer scope from key hierarchy (if not provided)
+    let inferredScopes = params.scopes;
+    if (!inferredScopes || inferredScopes.length === 0) {
+        // Get parent scope from key (everything except last part)
+        const parts = params.key.split('/');
+        if (parts.length > 1) {
+            // Take all but the last part
+            const scopeParts = parts.slice(0, -1);
+            const scope = scopeParts.join('/');
+            inferredScopes = [scope];
+            inferred.scope = scope;
+        }
+    }
+    // Build full params for setDecision
+    const fullParams = {
+        key: params.key,
+        value: params.value,
+        agent: params.agent,
+        layer: inferredLayer,
+        version: params.version || DEFAULT_VERSION,
+        status: params.status || 'active',
+        tags: inferredTags,
+        scopes: inferredScopes
+    };
+    // Call setDecision with full params (pass adapter if provided)
+    const result = await setDecision(fullParams, adapter);
+    // Return response with inferred metadata
+    return {
+        success: result.success,
+        key: result.key,
+        key_id: result.key_id,
+        version: result.version,
+        inferred: inferred,
+        message: `Decision "${params.key}" set successfully with smart defaults`
+    };
+}
+//# sourceMappingURL=quick-set.js.map

package/dist/tools/context/actions/quick-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-set.js","sourceRoot":"","sources":["../../../../src/tools/context/actions/quick-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA8B,EAC9B,OAAyB;IAEzB,sBAAsB;IACtB,IAAI,CAAC;QACH,oBAAoB,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAIV,EAAE,CAAC;IAEP,gDAAgD;IAChD,IAAI,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;IACjC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAE1C,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClG,aAAa,GAAG,cAAc,CAAC;QACjC,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChH,aAAa,GAAG,UAAU,CAAC;QAC7B,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACzG,aAAa,GAAG,MAAM,CAAC;QACzB,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5E,aAAa,GAAG,gBAAgB,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,gBAAgB;YAChB,aAAa,GAAG,UAAU,CAAC;QAC7B,CAAC;QACD,QAAQ,CAAC,KAAK,GAAG,aAAa,CAAC;IACjC,CAAC;IAED,oDAAoD;IACpD,IAAI,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/B,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,uDAAuD;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,YAAY,GAAG,KAAK,CAAC;QACrB,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC;IAC/B,CAAC;IAED,mDAAmD;IACnD,IAAI,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,0DAA0D;QAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,6BAA6B;YAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,cAAc,GAAG,CAAC,KAAK,CAAC,CAAC;YACzB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAsB;QACpC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,eAAe;QAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;QACjC,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,cAAc;KACvB,CAAC;IAEF,+DAA+D;IAC/D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEtD,yCAAyC;IACzC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,aAAa,MAAM,CAAC,GAAG,wCAAwC;KACzE,CAAC;AACJ,CAAC"}

package/dist/tools/context/actions/search-advanced.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Advanced query composition with complex filtering capabilities
+ * Supports multiple filter types, sorting, and pagination
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { SearchAdvancedParams, SearchAdvancedResponse } from '../types.js';
+/**
+ * Advanced search with complex filtering
+ *
+ * @param params - Advanced search parameters with filtering, sorting, pagination
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Filtered decisions with total count for pagination
+ */
+export declare function searchAdvanced(params?: SearchAdvancedParams, adapter?: DatabaseAdapter): Promise<SearchAdvancedResponse>;
+//# sourceMappingURL=search-advanced.d.ts.map

package/dist/tools/context/actions/search-advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-advanced.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/search-advanced.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAU7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAkB,MAAM,aAAa,CAAC;AAEhG;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,GAAE,oBAAyB,EACjC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,sBAAsB,CAAC,CA8IjC"}

package/dist/tools/context/actions/search-advanced.js

@@ -0,0 +1,140 @@
+/**
+ * Advanced query composition with complex filtering capabilities
+ * Supports multiple filter types, sorting, and pagination
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { validateActionParams, parseStringArray, parseRelativeTime, validatePaginationParams, validateSortParams } from '../internal/validation.js';
+/**
+ * Advanced search with complex filtering
+ *
+ * @param params - Advanced search parameters with filtering, sorting, pagination
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Filtered decisions with total count for pagination
+ */
+export async function searchAdvanced(params = {}, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'search_advanced', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context
+    const projectId = getProjectContext().getProjectId();
+    try {
+        // Build base query using v_tagged_decisions view
+        let query = knex('v_tagged_decisions').where('project_id', projectId);
+        // Filter by layers (OR relationship)
+        if (params.layers && params.layers.length > 0) {
+            query = query.whereIn('layer', params.layers);
+        }
+        // Filter by tags_all (AND relationship - must have ALL tags)
+        if (params.tags_all && params.tags_all.length > 0) {
+            const tagsAll = parseStringArray(params.tags_all);
+            for (const tag of tagsAll) {
+                query = query.where((builder) => {
+                    builder.where('tags', 'like', `%${tag}%`).orWhere('tags', tag);
+                });
+            }
+        }
+        // Filter by tags_any (OR relationship - must have ANY tag)
+        if (params.tags_any && params.tags_any.length > 0) {
+            const tagsAny = parseStringArray(params.tags_any);
+            query = query.where((builder) => {
+                for (const tag of tagsAny) {
+                    builder.orWhere('tags', 'like', `%${tag}%`).orWhere('tags', tag);
+                }
+            });
+        }
+        // Exclude tags
+        if (params.exclude_tags && params.exclude_tags.length > 0) {
+            const excludeTags = parseStringArray(params.exclude_tags);
+            for (const tag of excludeTags) {
+                query = query.where((builder) => {
+                    builder.whereNull('tags')
+                        .orWhere((subBuilder) => {
+                        subBuilder.where('tags', 'not like', `%${tag}%`)
+                            .where('tags', '!=', tag);
+                    });
+                });
+            }
+        }
+        // Filter by scopes with wildcard support
+        if (params.scopes && params.scopes.length > 0) {
+            const scopes = parseStringArray(params.scopes);
+            query = query.where((builder) => {
+                for (const scope of scopes) {
+                    if (scope.includes('*')) {
+                        // Wildcard pattern - convert to LIKE pattern
+                        const likePattern = scope.replace(/\*/g, '%');
+                        builder.orWhere('scopes', 'like', `%${likePattern}%`)
+                            .orWhere('scopes', likePattern);
+                    }
+                    else {
+                        // Exact match
+                        builder.orWhere('scopes', 'like', `%${scope}%`)
+                            .orWhere('scopes', scope);
+                    }
+                }
+            });
+        }
+        // Temporal filtering - updated_after
+        if (params.updated_after) {
+            const timestamp = parseRelativeTime(params.updated_after);
+            if (timestamp !== null) {
+                query = query.whereRaw('unixepoch(updated) >= ?', [timestamp]);
+            }
+            else {
+                throw new Error(`Invalid updated_after format: ${params.updated_after}. Use ISO timestamp or relative time like "7d", "2h", "30m"`);
+            }
+        }
+        // Temporal filtering - updated_before
+        if (params.updated_before) {
+            const timestamp = parseRelativeTime(params.updated_before);
+            if (timestamp !== null) {
+                query = query.whereRaw('unixepoch(updated) <= ?', [timestamp]);
+            }
+            else {
+                throw new Error(`Invalid updated_before format: ${params.updated_before}. Use ISO timestamp or relative time like "7d", "2h", "30m"`);
+            }
+        }
+        // Filter by decided_by (OR relationship)
+        if (params.decided_by && params.decided_by.length > 0) {
+            query = query.whereIn('decided_by', params.decided_by);
+        }
+        // Filter by statuses (OR relationship)
+        if (params.statuses && params.statuses.length > 0) {
+            query = query.whereIn('status', params.statuses);
+        }
+        // Full-text search in value field
+        if (params.search_text) {
+            query = query.where('value', 'like', `%${params.search_text}%`);
+        }
+        // Count total matching records (before pagination)
+        const countQuery = query.clone().count('* as total');
+        const countResult = await countQuery.first();
+        const totalCount = countResult.total;
+        // Sorting
+        const sortBy = params.sort_by || 'updated';
+        const sortOrder = params.sort_order || 'desc';
+        // Validate sort parameters
+        validateSortParams(sortBy, sortOrder);
+        query = query.orderBy(sortBy, sortOrder);
+        // Pagination
+        const limit = params.limit !== undefined ? params.limit : 20;
+        const offset = params.offset || 0;
+        // Validate pagination parameters
+        validatePaginationParams(limit, offset);
+        query = query.limit(limit).offset(offset);
+        // Execute query
+        const rows = await query.select('*');
+        return {
+            decisions: rows,
+            count: rows.length,
+            total_count: totalCount
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to execute advanced search: ${message}`);
+    }
+}
+//# sourceMappingURL=search-advanced.js.map

package/dist/tools/context/actions/search-advanced.js.map

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

package/dist/tools/context/actions/search-layer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Search for decisions within a specific architecture layer
+ * Supports status filtering and optional tag inclusion
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { SearchByLayerParams, SearchByLayerResponse } from '../types.js';
+/**
+ * Search for decisions within a specific layer
+ *
+ * @param params - Layer name, optional status and include_tags
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decisions in the specified layer
+ */
+export declare function searchByLayer(params: SearchByLayerParams, adapter?: DatabaseAdapter): Promise<SearchByLayerResponse>;
+//# sourceMappingURL=search-layer.d.ts.map

package/dist/tools/context/actions/search-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-layer.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/search-layer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAkB,MAAM,aAAa,CAAC;AAE9F;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAuHhC"}

package/dist/tools/context/actions/search-layer.js

@@ -0,0 +1,106 @@
+/**
+ * Search for decisions within a specific architecture layer
+ * Supports status filtering and optional tag inclusion
+ */
+import { getAdapter, getLayerId } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { debugLog } from '../../../utils/debug-logger.js';
+import { STRING_TO_STATUS } from '../../../constants.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * Search for decisions within a specific layer
+ *
+ * @param params - Layer name, optional status and include_tags
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decisions in the specified layer
+ */
+export async function searchByLayer(params, adapter) {
+    // Validate parameters
+    try {
+        validateActionParams('decision', 'search_layer', params);
+    }
+    catch (error) {
+        throw error;
+    }
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Determine which project to query (current or referenced)
+    let projectId;
+    if (params._reference_project) {
+        // Cross-project query: look up the referenced project
+        const refProject = await knex('m_projects')
+            .where({ name: params._reference_project })
+            .first();
+        if (!refProject) {
+            throw new Error(`Referenced project "${params._reference_project}" not found`);
+        }
+        projectId = refProject.id;
+        debugLog('INFO', 'Cross-project searchByLayer', {
+            currentProject: getProjectContext().getProjectName(),
+            referencedProject: params._reference_project,
+            projectId
+        });
+    }
+    else {
+        // Normal query: use current project
+        projectId = getProjectContext().getProjectId();
+    }
+    // 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 = await getLayerId(actualAdapter, 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 rows;
+        if (includeTagsValue) {
+            // Use v_tagged_decisions view for full metadata
+            rows = await knex('v_tagged_decisions')
+                .where({ layer: params.layer, status: statusValue, project_id: projectId })
+                .orderBy('updated', 'desc')
+                .select('*');
+        }
+        else {
+            // Use base t_decisions table with minimal joins
+            const statusInt = STRING_TO_STATUS[statusValue];
+            const stringDecisions = knex('t_decisions as d')
+                .innerJoin('m_context_keys as ck', 'd.key_id', 'ck.id')
+                .leftJoin('m_layers as l', 'd.layer_id', 'l.id')
+                .leftJoin('m_agents as a', 'd.agent_id', 'a.id')
+                .where('l.name', params.layer)
+                .where('d.status', statusInt)
+                .where('d.project_id', projectId)
+                .select('ck.key', 'd.value', 'd.version', knex.raw(`CASE d.status WHEN 1 THEN 'active' WHEN 2 THEN 'deprecated' WHEN 3 THEN 'draft' END as status`), 'l.name as layer', knex.raw('NULL as tags'), knex.raw('NULL as scopes'), 'a.name as decided_by', knex.raw(`datetime(d.ts, 'unixepoch') as updated`));
+            const numericDecisions = knex('t_decisions_numeric as dn')
+                .innerJoin('m_context_keys as ck', 'dn.key_id', 'ck.id')
+                .leftJoin('m_layers as l', 'dn.layer_id', 'l.id')
+                .leftJoin('m_agents as a', 'dn.agent_id', 'a.id')
+                .where('l.name', params.layer)
+                .where('dn.status', statusInt)
+                .where('dn.project_id', projectId)
+                .select('ck.key', knex.raw('CAST(dn.value AS TEXT) as value'), 'dn.version', knex.raw(`CASE dn.status WHEN 1 THEN 'active' WHEN 2 THEN 'deprecated' WHEN 3 THEN 'draft' END as status`), 'l.name as layer', knex.raw('NULL as tags'), knex.raw('NULL as scopes'), 'a.name as decided_by', knex.raw(`datetime(dn.ts, 'unixepoch') as updated`));
+            // Union both queries
+            rows = await stringDecisions.union([numericDecisions]).orderBy('updated', 'desc');
+        }
+        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=search-layer.js.map

package/dist/tools/context/actions/search-layer.js.map

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

package/dist/tools/context/actions/search-tags.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Search for decisions by tags with AND/OR logic
+ * Provides flexible tag-based filtering with status and layer support
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { SearchByTagsParams, SearchByTagsResponse } from '../types.js';
+/**
+ * Search for decisions by tags
+ *
+ * @param params - Search parameters (tags, match_mode, status, layer)
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decisions matching tag criteria
+ */
+export declare function searchByTags(params: SearchByTagsParams, adapter?: DatabaseAdapter): Promise<SearchByTagsResponse>;
+//# sourceMappingURL=search-tags.d.ts.map

package/dist/tools/context/actions/search-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tags.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/search-tags.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAK7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAkB,MAAM,aAAa,CAAC;AAE5F;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,oBAAoB,CAAC,CA2E/B"}

package/dist/tools/context/actions/search-tags.js

@@ -0,0 +1,85 @@
+/**
+ * Search for decisions by tags with AND/OR logic
+ * Provides flexible tag-based filtering with status and layer support
+ */
+import { getAdapter, getLayerId } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { STRING_TO_STATUS } from '../../../constants.js';
+import { validateActionParams, parseStringArray } from '../internal/validation.js';
+/**
+ * Search for decisions by tags
+ *
+ * @param params - Search parameters (tags, match_mode, status, layer)
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decisions matching tag criteria
+ */
+export async function searchByTags(params, adapter) {
+    // Validate parameters
+    try {
+        validateActionParams('decision', 'search_tags', params);
+    }
+    catch (error) {
+        throw error;
+    }
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context
+    const projectId = getProjectContext().getProjectId();
+    // 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 {
+        // Parse tags (handles both arrays and JSON strings from MCP)
+        const tags = parseStringArray(params.tags);
+        const matchMode = params.match_mode || 'OR';
+        let query = knex('v_tagged_decisions').where('project_id', projectId);
+        // Apply tag filtering based on match mode
+        if (matchMode === 'AND') {
+            // All tags must be present
+            for (const tag of tags) {
+                query = query.where('tags', 'like', `%${tag}%`);
+            }
+        }
+        else if (matchMode === 'OR') {
+            // Any tag must be present
+            query = query.where((builder) => {
+                for (const tag of tags) {
+                    builder.orWhere('tags', 'like', `%${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 = query.where('status', params.status);
+        }
+        // Optional layer filter
+        if (params.layer) {
+            // Validate layer exists
+            const layerId = await getLayerId(actualAdapter, params.layer);
+            if (layerId === null) {
+                throw new Error(`Invalid layer: ${params.layer}. Must be one of: presentation, business, data, infrastructure, cross-cutting`);
+            }
+            query = query.where('layer', params.layer);
+        }
+        // Order by most recent
+        query = query.orderBy('updated', 'desc');
+        // Execute query
+        const rows = await query.select('*');
+        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}`);
+    }
+}
+//# sourceMappingURL=search-tags.js.map

package/dist/tools/context/actions/search-tags.js.map

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

package/dist/tools/context/actions/set-from-template.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Set decision from template with defaults and required field validation (FR-006)
+ * Applies template defaults while allowing overrides
+ * Validates required fields if template specifies any
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { SetFromTemplateParams, SetFromTemplateResponse } from '../types.js';
+/**
+ * Set decision from template
+ *
+ * @param params - Template name, key, value, and optional overrides
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status and applied defaults metadata
+ */
+export declare function setFromTemplate(params: SetFromTemplateParams, adapter?: DatabaseAdapter): Promise<SetFromTemplateResponse>;
+//# sourceMappingURL=set-from-template.d.ts.map

package/dist/tools/context/actions/set-from-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-from-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/set-from-template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAK7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAqB,MAAM,aAAa,CAAC;AAErG;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,uBAAuB,CAAC,CA0FlC"}

package/dist/tools/context/actions/set-from-template.js

@@ -0,0 +1,83 @@
+/**
+ * Set decision from template with defaults and required field validation (FR-006)
+ * Applies template defaults while allowing overrides
+ * Validates required fields if template specifies any
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { validateActionParams } from '../internal/validation.js';
+import { setDecision } from './set.js';
+/**
+ * Set decision from template
+ *
+ * @param params - Template name, key, value, and optional overrides
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status and applied defaults metadata
+ */
+export async function setFromTemplate(params, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'set_from_template', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context
+    const projectId = getProjectContext().getProjectId();
+    try {
+        // Get template (templates are project-scoped)
+        const templateRow = await knex('t_decision_templates')
+            .where({ name: params.template, project_id: projectId })
+            .first();
+        if (!templateRow) {
+            throw new Error(`Template not found: ${params.template}`);
+        }
+        // Parse template defaults
+        const defaults = JSON.parse(templateRow.defaults);
+        // Parse required fields
+        const requiredFields = templateRow.required_fields ? JSON.parse(templateRow.required_fields) : null;
+        // Validate required fields if specified
+        if (requiredFields && requiredFields.length > 0) {
+            for (const field of requiredFields) {
+                if (!(field in params) || params[field] === undefined || params[field] === null) {
+                    throw new Error(`Template "${params.template}" requires field: ${field}`);
+                }
+            }
+        }
+        // Build decision params with template defaults (overridable)
+        const appliedDefaults = {};
+        const decisionParams = {
+            key: params.key,
+            value: params.value,
+            agent: params.agent,
+            layer: params.layer || defaults.layer,
+            version: params.version,
+            status: params.status || defaults.status,
+            tags: params.tags || defaults.tags,
+            scopes: params.scopes
+        };
+        // Track what defaults were applied
+        if (!params.layer && defaults.layer) {
+            appliedDefaults.layer = defaults.layer;
+        }
+        if (!params.tags && defaults.tags) {
+            appliedDefaults.tags = defaults.tags;
+        }
+        if (!params.status && defaults.status) {
+            appliedDefaults.status = defaults.status;
+        }
+        // Call setDecision with merged params (pass adapter if provided)
+        const result = await setDecision(decisionParams, actualAdapter);
+        return {
+            success: result.success,
+            key: result.key,
+            key_id: result.key_id,
+            version: result.version,
+            template_used: params.template,
+            applied_defaults: appliedDefaults,
+            message: `Decision "${params.key}" set successfully using template "${params.template}"`
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to set decision from template: ${message}`);
+    }
+}
+//# sourceMappingURL=set-from-template.js.map