sqlew 3.5.3 → 3.6.1

package/dist/tools/context.d.ts

@@ -1,67 +1,70 @@
 /**
  * Context management tools for MCP Shared Context Server
  * Implements set_decision, get_context, and get_decision tools
+ *
+ * CONVERTED: Using Knex.js with DatabaseAdapter (async/await)
  */
-import type { SetDecisionParams, GetContextParams, GetDecisionParams, SetDecisionResponse, GetContextResponse, GetDecisionResponse, Database, SearchByTagsParams, SearchByTagsResponse, GetVersionsParams, GetVersionsResponse, SearchByLayerParams, SearchByLayerResponse, QuickSetDecisionParams, QuickSetDecisionResponse, SearchAdvancedParams, SearchAdvancedResponse, SetDecisionBatchParams, SetDecisionBatchResponse, SetFromTemplateParams, SetFromTemplateResponse, CreateTemplateParams, CreateTemplateResponse, ListTemplatesParams, ListTemplatesResponse, HasUpdatesParams, HasUpdatesResponse, HardDeleteDecisionParams, HardDeleteDecisionResponse } from '../types.js';
+import { DatabaseAdapter } from '../adapters/index.js';
+import type { SetDecisionParams, GetContextParams, GetDecisionParams, SetDecisionResponse, GetContextResponse, GetDecisionResponse, SearchByTagsParams, SearchByTagsResponse, GetVersionsParams, GetVersionsResponse, SearchByLayerParams, SearchByLayerResponse, QuickSetDecisionParams, QuickSetDecisionResponse, SearchAdvancedParams, SearchAdvancedResponse, SetDecisionBatchParams, SetDecisionBatchResponse, SetFromTemplateParams, SetFromTemplateResponse, CreateTemplateParams, CreateTemplateResponse, ListTemplatesParams, ListTemplatesResponse, HasUpdatesParams, HasUpdatesResponse, HardDeleteDecisionParams, HardDeleteDecisionResponse } from '../types.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
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Response with success status and metadata
  */
-export declare function setDecision(params: SetDecisionParams, db?: Database): SetDecisionResponse;
+export declare function setDecision(params: SetDecisionParams, adapter?: DatabaseAdapter): Promise<SetDecisionResponse>;
 /**
  * Get context t_decisions with advanced filtering
  * Uses v_tagged_decisions view for token efficiency
  * Supports filtering by status, layer, tags, and scope
  *
  * @param params - Filter parameters
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Array of t_decisions with metadata
  */
-export declare function getContext(params?: GetContextParams, db?: Database): GetContextResponse;
+export declare function getContext(params?: GetContextParams, adapter?: DatabaseAdapter): Promise<GetContextResponse>;
 /**
  * Get a specific decision by key
  * Returns full metadata including tags, layer, scopes, version
  * Optionally includes decision context (v3.2.2)
  *
  * @param params - Decision key and optional include_context flag
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Decision details or not found
  */
 export declare function getDecision(params: GetDecisionParams & {
     include_context?: boolean;
-}, db?: Database): GetDecisionResponse;
+}, adapter?: DatabaseAdapter): Promise<GetDecisionResponse>;
 /**
  * Search for t_decisions by m_tags with AND/OR logic
  * Provides flexible tag-based filtering with status and layer support
  *
  * @param params - Search parameters (tags, match_mode, status, layer)
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Array of t_decisions matching tag criteria
  */
-export declare function searchByTags(params: SearchByTagsParams, db?: Database): SearchByTagsResponse;
+export declare function searchByTags(params: SearchByTagsParams, adapter?: DatabaseAdapter): Promise<SearchByTagsResponse>;
 /**
  * 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
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Array of historical versions with metadata
  */
-export declare function getVersions(params: GetVersionsParams, db?: Database): GetVersionsResponse;
+export declare function getVersions(params: GetVersionsParams, adapter?: DatabaseAdapter): Promise<GetVersionsResponse>;
 /**
  * Search for t_decisions within a specific architecture layer
  * Supports status filtering and optional tag inclusion
  *
  * @param params - Layer name, optional status and include_tags
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Array of t_decisions in the specified layer
  */
-export declare function searchByLayer(params: SearchByLayerParams, db?: Database): SearchByLayerResponse;
+export declare function searchByLayer(params: SearchByLayerParams, adapter?: DatabaseAdapter): Promise<SearchByLayerResponse>;
 /**
  * Quick set decision with smart defaults and inference
  * Reduces required parameters from 7 to 2 (key + value only)
@@ -87,10 +90,10 @@ export declare function searchByLayer(params: SearchByLayerParams, db?: Database
  * All inferred fields can be overridden via optional parameters.
  *
  * @param params - Quick set parameters (key and value required)
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Response with success status and inferred metadata
  */
-export declare function quickSetDecision(params: QuickSetDecisionParams, db?: Database): QuickSetDecisionResponse;
+export declare function quickSetDecision(params: QuickSetDecisionParams, adapter?: DatabaseAdapter): Promise<QuickSetDecisionResponse>;
 /**
  * Advanced query composition with complex filtering capabilities
  * Supports multiple filter types, sorting, and pagination
@@ -107,58 +110,58 @@ export declare function quickSetDecision(params: QuickSetDecisionParams, db?: Da
  * - search_text: Full-text search in value field
  *
  * @param params - Advanced search parameters with filtering, sorting, pagination
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Filtered decisions with total count for pagination
  */
-export declare function searchAdvanced(params?: SearchAdvancedParams, db?: Database): SearchAdvancedResponse;
+export declare function searchAdvanced(params?: SearchAdvancedParams, adapter?: DatabaseAdapter): Promise<SearchAdvancedResponse>;
 /**
  * Set multiple decisions in a single batch operation (FR-005)
  * Supports atomic (all succeed or all fail) and non-atomic modes
  * Limit: 50 items per batch (constraint #3)
  *
  * @param params - Batch parameters with array of decisions and atomic flag
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Response with success status and detailed results for each item
  */
-export declare function setDecisionBatch(params: SetDecisionBatchParams, db?: Database): SetDecisionBatchResponse;
+export declare function setDecisionBatch(params: SetDecisionBatchParams, adapter?: DatabaseAdapter): Promise<SetDecisionBatchResponse>;
 /**
  * Check for updates since a given timestamp (FR-003 Phase A)
  * Lightweight polling mechanism using COUNT queries
  * Token cost: ~5-10 tokens per check
  *
  * @param params - Agent name and since_timestamp (ISO 8601)
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Boolean flag and counts for decisions, messages, files
  */
-export declare function hasUpdates(params: HasUpdatesParams, db?: Database): HasUpdatesResponse;
+export declare function hasUpdates(params: HasUpdatesParams, adapter?: DatabaseAdapter): Promise<HasUpdatesResponse>;
 /**
  * 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
  *
  * @param params - Template name, key, value, and optional overrides
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Response with success status and applied defaults metadata
  */
-export declare function setFromTemplate(params: SetFromTemplateParams, db?: Database): SetFromTemplateResponse;
+export declare function setFromTemplate(params: SetFromTemplateParams, adapter?: DatabaseAdapter): Promise<SetFromTemplateResponse>;
 /**
  * Create a new decision template (FR-006)
  * Defines reusable defaults and required fields for decisions
  *
  * @param params - Template name, defaults, required fields, and creator
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Response with success status and template ID
  */
-export declare function createTemplate(params: CreateTemplateParams, db?: Database): CreateTemplateResponse;
+export declare function createTemplate(params: CreateTemplateParams, adapter?: DatabaseAdapter): Promise<CreateTemplateResponse>;
 /**
  * List all available decision templates (FR-006)
  * Returns all templates with their defaults and metadata
  *
  * @param params - No parameters required
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Array of all templates with parsed JSON fields
  */
-export declare function listTemplates(params?: ListTemplatesParams, db?: Database): ListTemplatesResponse;
+export declare function listTemplates(params?: ListTemplatesParams, adapter?: DatabaseAdapter): Promise<ListTemplatesResponse>;
 /**
  * Permanently delete a decision and all related data (hard delete)
  * Unlike soft delete (status=deprecated), this removes all records from database
@@ -172,28 +175,28 @@ export declare function listTemplates(params?: ListTemplatesParams, db?: Databas
  * (tags, scopes) will also be deleted due to CASCADE constraints.
  *
  * @param params - Decision key to delete
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Response with success status
  */
-export declare function hardDeleteDecision(params: HardDeleteDecisionParams, db?: Database): HardDeleteDecisionResponse;
+export declare function hardDeleteDecision(params: HardDeleteDecisionParams, adapter?: DatabaseAdapter): Promise<HardDeleteDecisionResponse>;
 /**
  * Add decision context action
  * Adds rich context (rationale, alternatives, tradeoffs) to a decision
  *
  * @param params - Context parameters
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Response with success status
  */
-export declare function addDecisionContextAction(params: any, db?: Database): any;
+export declare function addDecisionContextAction(params: any, adapter?: DatabaseAdapter): Promise<any>;
 /**
  * List decision contexts action
  * Query decision contexts with optional filters
  *
  * @param params - Filter parameters
- * @param db - Optional database instance (for testing)
+ * @param adapter - Optional database adapter (for testing)
  * @returns Array of decision contexts
  */
-export declare function listDecisionContextsAction(params: any, db?: Database): any;
+export declare function listDecisionContextsAction(params: any, adapter?: DatabaseAdapter): Promise<any>;
 /**
  * Help action for decision tool
  */

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

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