sqlew 2.1.4 → 3.0.2

package/dist/tools/context.d.ts

@@ -2,7 +2,7 @@
  * Context management tools for MCP Shared Context Server
  * Implements set_decision, get_context, and get_decision tools
  */
-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 } from '../types.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
@@ -143,4 +143,20 @@ export declare function createTemplate(params: CreateTemplateParams): CreateTemp
  * @returns Array of all templates with parsed JSON fields
  */
 export declare function listTemplates(params?: ListTemplatesParams): ListTemplatesResponse;
+/**
+ * Permanently delete a decision and all related data (hard delete)
+ * Unlike soft delete (status=deprecated), this removes all records from database
+ *
+ * Use cases:
+ * - Manual cleanup after decision-to-task migration
+ * - Remove test/debug decisions that are no longer needed
+ * - Purge sensitive data that should not be retained
+ *
+ * WARNING: This operation is irreversible. Version history and all relationships
+ * (tags, scopes) will also be deleted due to CASCADE constraints.
+ *
+ * @param params - Decision key to delete
+ * @returns Response with success status
+ */
+export declare function hardDeleteDecision(params: HardDeleteDecisionParams): HardDeleteDecisionResponse;
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EAInB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAoHrB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAY1E;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,kBAAkB,CAiE5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CA2B1E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAkE7E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CA4D1E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,CAkGhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,CAoFzF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,sBAAsB,CA4KxF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,CAkGzF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAoEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,uBAAuB,CA8FtF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAwDnF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,GAAG,qBAAqB,CA4CrF"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EAInB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,aAAa,CAAC;AA+GrB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAY1E;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,kBAAkB,CAiE5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CA2B1E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAkE7E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CA4D1E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,CAkGhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,CAoFzF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,sBAAsB,CA4KxF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,CAuCzF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAoEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,uBAAuB,CA8FtF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAwDnF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,GAAG,qBAAqB,CA4CrF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,0BAA0B,CA4D/F"}

package/dist/tools/context.js

@@ -4,6 +4,8 @@
  */
 import { getDatabase, getOrCreateAgent, getOrCreateContextKey, getOrCreateTag, getOrCreateScope, getLayerId, transaction } from '../database.js';
 import { STRING_TO_STATUS, DEFAULT_VERSION, DEFAULT_STATUS } from '../constants.js';
+import { processBatch } from '../utils/batch.js';
+import { validateRequired, validateStatus, validateLayer } from '../utils/validators.js';
 /**
  * Internal helper: Set decision without wrapping in transaction
  * Used by setDecision (with transaction) and setDecisionBatch (manages its own transaction)
@@ -14,9 +16,7 @@ import { STRING_TO_STATUS, DEFAULT_VERSION, DEFAULT_STATUS } from '../constants.
  */
 function setDecisionInternal(params, db) {
     // Validate required parameters
-    if (!params.key || params.key.trim() === '') {
-        throw new Error('Parameter "key" is required and cannot be empty');
-    }
+    const trimmedKey = validateRequired(params.key, 'key');
     if (params.value === undefined || params.value === null) {
         throw new Error('Parameter "value" is required');
     }
@@ -28,16 +28,13 @@ function setDecisionInternal(params, db) {
     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'`);
+    if (params.status) {
+        validateStatus(params.status);
     }
     // 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`);
-        }
+        layerId = validateLayer(db, params.layer);
     }
     // Get or create master records
     const agentId = getOrCreateAgent(db, agentName);
@@ -47,31 +44,31 @@ function setDecisionInternal(params, db) {
     // Insert or update decision based on value type
     if (isNumeric) {
         // Numeric decision
-        const stmt = db.prepare(`
-      INSERT INTO t_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
+        const stmt = db.prepare(`
+      INSERT INTO t_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 t_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
+        const stmt = db.prepare(`
+      INSERT INTO t_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);
     }
@@ -320,16 +317,16 @@ export function getVersions(params) {
         }
         const keyId = keyResult.id;
         // Query t_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 t_decision_history dh
-      LEFT JOIN m_agents a ON dh.agent_id = a.id
-      WHERE dh.key_id = ?
-      ORDER BY dh.ts DESC
+        const stmt = db.prepare(`
+      SELECT
+        dh.version,
+        dh.value,
+        a.name as agent_name,
+        datetime(dh.ts, 'unixepoch') as timestamp
+      FROM t_decision_history dh
+      LEFT JOIN m_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
@@ -380,58 +377,58 @@ export function searchByLayer(params) {
         const queryParams = [params.layer, statusValue];
         if (includeTagsValue) {
             // Use v_tagged_decisions view for full metadata
-            query = `
-        SELECT * FROM v_tagged_decisions
-        WHERE layer = ? AND status = ?
-        ORDER BY updated DESC
+            query = `
+        SELECT * FROM v_tagged_decisions
+        WHERE layer = ? AND status = ?
+        ORDER BY updated DESC
       `;
         }
         else {
             // Use base t_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 t_decisions d
-        INNER JOIN m_context_keys ck ON d.key_id = ck.id
-        LEFT JOIN m_layers l ON d.layer_id = l.id
-        LEFT JOIN m_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 t_decisions_numeric dn
-        INNER JOIN m_context_keys ck ON dn.key_id = ck.id
-        LEFT JOIN m_layers l ON dn.layer_id = l.id
-        LEFT JOIN m_agents a ON dn.agent_id = a.id
-        WHERE l.name = ? AND dn.status = ?
-
-        ORDER BY updated DESC
+            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 t_decisions d
+        INNER JOIN m_context_keys ck ON d.key_id = ck.id
+        LEFT JOIN m_layers l ON d.layer_id = l.id
+        LEFT JOIN m_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 t_decisions_numeric dn
+        INNER JOIN m_context_keys ck ON dn.key_id = ck.id
+        LEFT JOIN m_layers l ON dn.layer_id = l.id
+        LEFT JOIN m_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);
@@ -739,86 +736,29 @@ export function setDecisionBatch(params) {
     if (!params.decisions || !Array.isArray(params.decisions)) {
         throw new Error('Parameter "decisions" is required and must be an array');
     }
-    // Enforce limit (constraint #3)
-    if (params.decisions.length === 0) {
-        throw new Error('Parameter "decisions" must contain at least one item');
-    }
-    if (params.decisions.length > 50) {
-        throw new Error('Batch operations are limited to 50 items maximum (constraint #3)');
-    }
     const atomic = params.atomic !== undefined ? params.atomic : true;
-    const results = [];
-    let inserted = 0;
-    let failed = 0;
-    // Helper function to process a single decision
-    const processSingleDecision = (decision) => {
-        try {
-            const result = setDecisionInternal(decision, db);
-            results.push({
-                key: decision.key,
-                key_id: result.key_id,
-                version: result.version,
-                success: true
-            });
-            inserted++;
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            results.push({
-                key: decision.key,
-                success: false,
-                error: errorMessage
-            });
-            failed++;
-            // In atomic mode, throw immediately to trigger rollback
-            if (atomic) {
-                throw error;
-            }
-        }
+    // Use processBatch utility
+    const batchResult = processBatch(db, params.decisions, (decision, db) => {
+        const result = setDecisionInternal(decision, db);
+        return {
+            key: decision.key,
+            key_id: result.key_id,
+            version: result.version
+        };
+    }, atomic, 50);
+    // Map batch results to SetDecisionBatchResponse format
+    return {
+        success: batchResult.success,
+        inserted: batchResult.processed,
+        failed: batchResult.failed,
+        results: batchResult.results.map(r => ({
+            key: r.data?.key || '',
+            key_id: r.data?.key_id,
+            version: r.data?.version,
+            success: r.success,
+            error: r.error
+        }))
     };
-    try {
-        if (atomic) {
-            // Atomic mode: use transaction, all succeed or all fail
-            return transaction(db, () => {
-                for (const decision of params.decisions) {
-                    processSingleDecision(decision);
-                }
-                return {
-                    success: failed === 0,
-                    inserted,
-                    failed,
-                    results
-                };
-            });
-        }
-        else {
-            // Non-atomic mode: process all, return individual results
-            for (const decision of params.decisions) {
-                processSingleDecision(decision);
-            }
-            return {
-                success: failed === 0,
-                inserted,
-                failed,
-                results
-            };
-        }
-    }
-    catch (error) {
-        if (atomic) {
-            // In atomic mode, if any error occurred, all failed
-            throw new Error(`Batch operation failed (atomic mode): ${error instanceof Error ? error.message : String(error)}`);
-        }
-        else {
-            // In non-atomic mode, return partial results
-            return {
-                success: false,
-                inserted,
-                failed,
-                results
-            };
-        }
-    }
 }
 /**
  * Check for updates since a given timestamp (FR-003 Phase A)
@@ -845,12 +785,12 @@ export function hasUpdates(params) {
         }
         const sinceTs = Math.floor(sinceDate.getTime() / 1000);
         // Count decisions updated since timestamp (both string and numeric tables)
-        const decisionCountStmt = db.prepare(`
-      SELECT COUNT(*) as count FROM (
-        SELECT ts FROM t_decisions WHERE ts > ?
-        UNION ALL
-        SELECT ts FROM t_decisions_numeric WHERE ts > ?
-      )
+        const decisionCountStmt = db.prepare(`
+      SELECT COUNT(*) as count FROM (
+        SELECT ts FROM t_decisions WHERE ts > ?
+        UNION ALL
+        SELECT ts FROM t_decisions_numeric WHERE ts > ?
+      )
     `);
         const decisionResult = decisionCountStmt.get(sinceTs, sinceTs);
         const decisionsCount = decisionResult.count;
@@ -860,16 +800,16 @@ export function hasUpdates(params) {
         let messagesCount = 0;
         if (agentResult) {
             const agentId = agentResult.id;
-            const messageCountStmt = db.prepare(`
-        SELECT COUNT(*) as count FROM t_agent_messages
-        WHERE ts > ? AND (to_agent_id = ? OR to_agent_id IS NULL)
+            const messageCountStmt = db.prepare(`
+        SELECT COUNT(*) as count FROM t_agent_messages
+        WHERE ts > ? AND (to_agent_id = ? OR to_agent_id IS NULL)
       `);
             const messageResult = messageCountStmt.get(sinceTs, agentId);
             messagesCount = messageResult.count;
         }
         // Count file changes since timestamp
-        const fileCountStmt = db.prepare(`
-      SELECT COUNT(*) as count FROM t_file_changes WHERE ts > ?
+        const fileCountStmt = db.prepare(`
+      SELECT COUNT(*) as count FROM t_file_changes WHERE ts > ?
     `);
         const fileResult = fileCountStmt.get(sinceTs);
         const filesCount = fileResult.count;
@@ -1004,9 +944,9 @@ export function createTemplate(params) {
             const defaultsJson = JSON.stringify(params.defaults);
             const requiredFieldsJson = params.required_fields ? JSON.stringify(params.required_fields) : null;
             // Insert template
-            const stmt = db.prepare(`
-        INSERT INTO t_decision_templates (name, defaults, required_fields, created_by)
-        VALUES (?, ?, ?, ?)
+            const stmt = db.prepare(`
+        INSERT INTO t_decision_templates (name, defaults, required_fields, created_by)
+        VALUES (?, ?, ?, ?)
       `);
             const info = stmt.run(params.name, defaultsJson, requiredFieldsJson, createdById);
             return {
@@ -1032,17 +972,17 @@ export function createTemplate(params) {
 export function listTemplates(params = {}) {
     const db = getDatabase();
     try {
-        const stmt = db.prepare(`
-      SELECT
-        t.id,
-        t.name,
-        t.defaults,
-        t.required_fields,
-        a.name as created_by,
-        datetime(t.ts, 'unixepoch') as created_at
-      FROM t_decision_templates t
-      LEFT JOIN m_agents a ON t.created_by = a.id
-      ORDER BY t.name ASC
+        const stmt = db.prepare(`
+      SELECT
+        t.id,
+        t.name,
+        t.defaults,
+        t.required_fields,
+        a.name as created_by,
+        datetime(t.ts, 'unixepoch') as created_at
+      FROM t_decision_templates t
+      LEFT JOIN m_agents a ON t.created_by = a.id
+      ORDER BY t.name ASC
     `);
         const rows = stmt.all();
         // Parse JSON fields
@@ -1064,4 +1004,69 @@ export function listTemplates(params = {}) {
         throw new Error(`Failed to list templates: ${message}`);
     }
 }
+/**
+ * Permanently delete a decision and all related data (hard delete)
+ * Unlike soft delete (status=deprecated), this removes all records from database
+ *
+ * Use cases:
+ * - Manual cleanup after decision-to-task migration
+ * - Remove test/debug decisions that are no longer needed
+ * - Purge sensitive data that should not be retained
+ *
+ * WARNING: This operation is irreversible. Version history and all relationships
+ * (tags, scopes) will also be deleted due to CASCADE constraints.
+ *
+ * @param params - Decision key to delete
+ * @returns Response with success status
+ */
+export function hardDeleteDecision(params) {
+    const db = getDatabase();
+    // Validate parameter
+    if (!params.key || params.key.trim() === '') {
+        throw new Error('Parameter "key" is required and cannot be empty');
+    }
+    try {
+        return transaction(db, () => {
+            // Get key_id
+            const keyResult = db.prepare('SELECT id FROM m_context_keys WHERE key = ?').get(params.key);
+            if (!keyResult) {
+                // Key doesn't exist - still return success (idempotent)
+                return {
+                    success: true,
+                    key: params.key,
+                    message: `Decision "${params.key}" not found (already deleted or never existed)`
+                };
+            }
+            const keyId = keyResult.id;
+            // Delete from t_decisions (if exists)
+            const deletedString = db.prepare('DELETE FROM t_decisions WHERE key_id = ?').run(keyId);
+            // Delete from t_decisions_numeric (if exists)
+            const deletedNumeric = db.prepare('DELETE FROM t_decisions_numeric WHERE key_id = ?').run(keyId);
+            // Delete from t_decision_history (CASCADE should handle this, but explicit for clarity)
+            const deletedHistory = db.prepare('DELETE FROM t_decision_history WHERE key_id = ?').run(keyId);
+            // Delete from t_decision_tags (CASCADE should handle this)
+            const deletedTags = db.prepare('DELETE FROM t_decision_tags WHERE decision_key_id = ?').run(keyId);
+            // Delete from t_decision_scopes (CASCADE should handle this)
+            const deletedScopes = db.prepare('DELETE FROM t_decision_scopes WHERE decision_key_id = ?').run(keyId);
+            // Calculate total deleted records
+            const totalDeleted = deletedString.changes + deletedNumeric.changes + deletedHistory.changes + deletedTags.changes + deletedScopes.changes;
+            if (totalDeleted === 0) {
+                return {
+                    success: true,
+                    key: params.key,
+                    message: `Decision "${params.key}" not found (already deleted or never existed)`
+                };
+            }
+            return {
+                success: true,
+                key: params.key,
+                message: `Decision "${params.key}" permanently deleted (${totalDeleted} record${totalDeleted === 1 ? '' : 's'})`
+            };
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to hard delete decision: ${message}`);
+    }
+}
 //# sourceMappingURL=context.js.map