sqlew 3.7.3 → 3.8.0

package/dist/tools/context/actions/create-template.js.map

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

package/dist/tools/context/actions/get.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Get a specific decision by key
+ * Returns full metadata including tags, layer, scopes, version
+ * Optionally includes decision context (v3.2.2)
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { GetDecisionParams, GetDecisionResponse } from '../types.js';
+/**
+ * Get a specific decision by key
+ *
+ * @param params - Decision key and optional include_context flag
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Decision details or not found
+ */
+export declare function getDecision(params: GetDecisionParams & {
+    include_context?: boolean;
+}, adapter?: DatabaseAdapter): Promise<GetDecisionResponse>;
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAkB,MAAM,aAAa,CAAC;AAE1F;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,EACzD,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAsE9B"}

package/dist/tools/context/actions/get.js

@@ -0,0 +1,80 @@
+/**
+ * Get a specific decision by key
+ * Returns full metadata including tags, layer, scopes, version
+ * Optionally includes decision context (v3.2.2)
+ */
+import { getAdapter, getDecisionWithContext as dbGetDecisionWithContext } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * Get a specific decision by key
+ *
+ * @param params - Decision key and optional include_context flag
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Decision details or not found
+ */
+export async function getDecision(params, adapter) {
+    // Validate parameters
+    try {
+        validateActionParams('decision', 'get', params);
+    }
+    catch (error) {
+        throw error;
+    }
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context
+    const projectId = getProjectContext().getProjectId();
+    // Validate parameter
+    if (!params.key || params.key.trim() === '') {
+        throw new Error('Parameter "key" is required and cannot be empty');
+    }
+    try {
+        // If include_context is true, use the context-aware function
+        if (params.include_context) {
+            const result = await dbGetDecisionWithContext(actualAdapter, params.key);
+            if (!result) {
+                return {
+                    found: false
+                };
+            }
+            return {
+                found: true,
+                decision: {
+                    key: result.key,
+                    value: result.value,
+                    version: result.version,
+                    status: result.status,
+                    layer: result.layer,
+                    decided_by: result.decided_by,
+                    updated: result.updated,
+                    tags: null,
+                    scopes: null
+                },
+                context: result.context.map(ctx => ({
+                    ...ctx,
+                    alternatives_considered: ctx.alternatives_considered ? JSON.parse(ctx.alternatives_considered) : null,
+                    tradeoffs: ctx.tradeoffs ? JSON.parse(ctx.tradeoffs) : null
+                }))
+            };
+        }
+        // Standard query without context (backward compatible)
+        const row = await knex('v_tagged_decisions')
+            .where({ key: params.key, project_id: projectId })
+            .first();
+        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}`);
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/tools/context/actions/get.js.map

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

package/dist/tools/context/actions/hard-delete.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Permanently delete a decision and all related data (hard delete)
+ * Unlike soft delete (status=deprecated), this removes all records from database
+ *
+ * WARNING: This operation is irreversible. Version history and all relationships
+ * (tags, scopes) will also be deleted due to CASCADE constraints.
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { HardDeleteDecisionParams, HardDeleteDecisionResponse } from '../types.js';
+/**
+ * Permanently delete a decision
+ *
+ * @param params - Decision key to delete
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status
+ */
+export declare function hardDeleteDecision(params: HardDeleteDecisionParams, adapter?: DatabaseAdapter): Promise<HardDeleteDecisionResponse>;
+//# sourceMappingURL=hard-delete.d.ts.map

package/dist/tools/context/actions/hard-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hard-delete.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/hard-delete.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAK7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAExF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,0BAA0B,CAAC,CA6ErC"}

package/dist/tools/context/actions/hard-delete.js

@@ -0,0 +1,85 @@
+/**
+ * Permanently delete a decision and all related data (hard delete)
+ * Unlike soft delete (status=deprecated), this removes all records from database
+ *
+ * WARNING: This operation is irreversible. Version history and all relationships
+ * (tags, scopes) will also be deleted due to CASCADE constraints.
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import connectionManager from '../../../utils/connection-manager.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * Permanently delete a decision
+ *
+ * @param params - Decision key to delete
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status
+ */
+export async function hardDeleteDecision(params, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'hard_delete', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context (fail-fast)
+    const projectId = getProjectContext().getProjectId();
+    try {
+        return await connectionManager.executeWithRetry(async () => {
+            return await actualAdapter.transaction(async (trx) => {
+                // Get key_id
+                const keyResult = await trx('m_context_keys')
+                    .where({ key: params.key })
+                    .first('id');
+                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;
+                // SECURITY: All deletes MUST filter by project_id to prevent cross-project deletion
+                // Delete from t_decisions (if exists in this project)
+                const deletedString = await trx('t_decisions')
+                    .where({ key_id: keyId, project_id: projectId })
+                    .delete();
+                // Delete from t_decisions_numeric (if exists in this project)
+                const deletedNumeric = await trx('t_decisions_numeric')
+                    .where({ key_id: keyId, project_id: projectId })
+                    .delete();
+                // Delete from t_decision_history (for this project only)
+                const deletedHistory = await trx('t_decision_history')
+                    .where({ key_id: keyId, project_id: projectId })
+                    .delete();
+                // Delete from t_decision_tags (for this project only)
+                const deletedTags = await trx('t_decision_tags')
+                    .where({ decision_key_id: keyId, project_id: projectId })
+                    .delete();
+                // Delete from t_decision_scopes (for this project only)
+                const deletedScopes = await trx('t_decision_scopes')
+                    .where({ decision_key_id: keyId, project_id: projectId })
+                    .delete();
+                // Calculate total deleted records
+                const totalDeleted = deletedString + deletedNumeric + deletedHistory + deletedTags + deletedScopes;
+                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=hard-delete.js.map

package/dist/tools/context/actions/hard-delete.js.map

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

package/dist/tools/context/actions/has-updates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Check for updates since a given timestamp (FR-003 Phase A)
+ * Lightweight polling mechanism using COUNT queries
+ * Token cost: ~5-10 tokens per check
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { HasUpdatesParams, HasUpdatesResponse } from '../types.js';
+/**
+ * Check for updates since timestamp
+ *
+ * @param params - Agent name and since_timestamp (ISO 8601)
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Boolean flag and counts for decisions, messages, files
+ */
+export declare function hasUpdates(params: HasUpdatesParams, adapter?: DatabaseAdapter): Promise<HasUpdatesResponse>;
+//# sourceMappingURL=has-updates.d.ts.map

package/dist/tools/context/actions/has-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-updates.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/has-updates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA4E7B"}

package/dist/tools/context/actions/has-updates.js

@@ -0,0 +1,83 @@
+/**
+ * Check for updates since a given timestamp (FR-003 Phase A)
+ * Lightweight polling mechanism using COUNT queries
+ * Token cost: ~5-10 tokens per check
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * Check for updates since timestamp
+ *
+ * @param params - Agent name and since_timestamp (ISO 8601)
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Boolean flag and counts for decisions, messages, files
+ */
+export async function hasUpdates(params, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'has_updates', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context
+    const projectId = getProjectContext().getProjectId();
+    try {
+        // Parse ISO timestamp to Unix epoch
+        const sinceDate = new Date(params.since_timestamp);
+        if (isNaN(sinceDate.getTime())) {
+            throw new Error(`Invalid since_timestamp format: ${params.since_timestamp}. Use ISO 8601 format (e.g., "2025-10-14T08:00:00Z")`);
+        }
+        const sinceTs = Math.floor(sinceDate.getTime() / 1000);
+        // Count decisions updated since timestamp (both string and numeric tables)
+        const decisionCount1 = await knex('t_decisions')
+            .where({ project_id: projectId })
+            .where('ts', '>', sinceTs)
+            .count('* as count')
+            .first();
+        const decisionCount2 = await knex('t_decisions_numeric')
+            .where({ project_id: projectId })
+            .where('ts', '>', sinceTs)
+            .count('* as count')
+            .first();
+        const decisionsCount = (decisionCount1?.count || 0) + (decisionCount2?.count || 0);
+        // Get agent_id for the requesting agent
+        const agentResult = await knex('m_agents')
+            .where({ name: params.agent_name })
+            .first('id');
+        // Count messages for the agent (received messages - to_agent_id matches OR broadcast messages)
+        let messagesCount = 0;
+        if (agentResult) {
+            const agentId = agentResult.id;
+            const messageResult = await knex('t_agent_messages')
+                .where('ts', '>', sinceTs)
+                .where((builder) => {
+                builder.where('to_agent_id', agentId)
+                    .orWhereNull('to_agent_id');
+            })
+                .count('* as count')
+                .first();
+            messagesCount = messageResult?.count || 0;
+        }
+        // Count file changes since timestamp (project-scoped)
+        const fileResult = await knex('t_file_changes')
+            .where({ project_id: projectId })
+            .where('ts', '>', sinceTs)
+            .count('* as count')
+            .first();
+        const filesCount = fileResult?.count || 0;
+        // Determine if there are any updates
+        const hasUpdatesFlag = decisionsCount > 0 || messagesCount > 0 || filesCount > 0;
+        return {
+            has_updates: hasUpdatesFlag,
+            counts: {
+                decisions: decisionsCount,
+                messages: messagesCount,
+                files: filesCount
+            }
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to check for updates: ${message}`);
+    }
+}
+//# sourceMappingURL=has-updates.js.map

package/dist/tools/context/actions/has-updates.js.map

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

package/dist/tools/context/actions/list-contexts.d.ts

@@ -0,0 +1,14 @@
+/**
+ * List decision contexts action
+ * Query decision contexts with optional filters
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+/**
+ * List decision contexts
+ *
+ * @param params - Filter parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decision contexts
+ */
+export declare function listDecisionContextsAction(params: any, adapter?: DatabaseAdapter): Promise<any>;
+//# sourceMappingURL=list-contexts.d.ts.map

package/dist/tools/context/actions/list-contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-contexts.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/list-contexts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,GAAG,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,GAAG,CAAC,CA8Bd"}

package/dist/tools/context/actions/list-contexts.js

@@ -0,0 +1,43 @@
+/**
+ * List decision contexts action
+ * Query decision contexts with optional filters
+ */
+import { getAdapter, listDecisionContexts as dbListDecisionContexts } from '../../../database.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * List decision contexts
+ *
+ * @param params - Filter parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decision contexts
+ */
+export async function listDecisionContextsAction(params, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'list_decision_contexts', params);
+    const actualAdapter = adapter ?? getAdapter();
+    try {
+        const contexts = await dbListDecisionContexts(actualAdapter, {
+            decisionKey: params.decision_key,
+            relatedTaskId: params.related_task_id,
+            relatedConstraintId: params.related_constraint_id,
+            decidedBy: params.decided_by,
+            limit: params.limit || 50,
+            offset: params.offset || 0
+        });
+        return {
+            success: true,
+            contexts: contexts.map(ctx => ({
+                ...ctx,
+                // Parse JSON fields for display
+                alternatives_considered: ctx.alternatives_considered ? JSON.parse(ctx.alternatives_considered) : null,
+                tradeoffs: ctx.tradeoffs ? JSON.parse(ctx.tradeoffs) : null
+            })),
+            count: contexts.length
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to list decision contexts: ${message}`);
+    }
+}
+//# sourceMappingURL=list-contexts.js.map

package/dist/tools/context/actions/list-contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-contexts.js","sourceRoot":"","sources":["../../../../src/tools/context/actions/list-contexts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,oBAAoB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAW,EACX,OAAyB;IAEzB,sBAAsB;IACtB,oBAAoB,CAAC,UAAU,EAAE,wBAAwB,EAAE,MAAM,CAAC,CAAC;IAEnE,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,aAAa,EAAE;YAC3D,WAAW,EAAE,MAAM,CAAC,YAAY;YAChC,aAAa,EAAE,MAAM,CAAC,eAAe;YACrC,mBAAmB,EAAE,MAAM,CAAC,qBAAqB;YACjD,SAAS,EAAE,MAAM,CAAC,UAAU;YAC5B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC7B,GAAG,GAAG;gBACN,gCAAgC;gBAChC,uBAAuB,EAAE,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI;gBACrG,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;aAC5D,CAAC,CAAC;YACH,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/tools/context/actions/list-templates.d.ts

@@ -0,0 +1,15 @@
+/**
+ * List all available decision templates (FR-006)
+ * Returns all templates with their defaults and metadata
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { ListTemplatesParams, ListTemplatesResponse } from '../types.js';
+/**
+ * List all available decision templates
+ *
+ * @param params - No parameters required
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of all templates with parsed JSON fields
+ */
+export declare function listTemplates(params?: ListTemplatesParams, adapter?: DatabaseAdapter): Promise<ListTemplatesResponse>;
+//# sourceMappingURL=list-templates.d.ts.map

package/dist/tools/context/actions/list-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-templates.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/list-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,GAAE,mBAAwB,EAChC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAiDhC"}

package/dist/tools/context/actions/list-templates.js

@@ -0,0 +1,47 @@
+/**
+ * List all available decision templates (FR-006)
+ * Returns all templates with their defaults and metadata
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * List all available decision templates
+ *
+ * @param params - No parameters required
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of all templates with parsed JSON fields
+ */
+export async function listTemplates(params = {}, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'list_templates', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context
+    const projectId = getProjectContext().getProjectId();
+    try {
+        const rows = await knex('t_decision_templates as t')
+            .leftJoin('m_agents as a', 't.created_by', 'a.id')
+            .where('t.project_id', projectId)
+            .select('t.id', 't.name', 't.defaults', 't.required_fields', 'a.name as created_by', knex.raw(`datetime(t.ts, 'unixepoch') as created_at`))
+            .orderBy('t.name', 'asc');
+        // Parse JSON fields
+        const templates = rows.map(row => ({
+            id: row.id,
+            name: row.name,
+            defaults: JSON.parse(row.defaults),
+            required_fields: row.required_fields ? JSON.parse(row.required_fields) : null,
+            created_by: row.created_by,
+            created_at: row.created_at
+        }));
+        return {
+            templates: templates,
+            count: templates.length
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to list templates: ${message}`);
+    }
+}
+//# sourceMappingURL=list-templates.js.map

package/dist/tools/context/actions/list-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-templates.js","sourceRoot":"","sources":["../../../../src/tools/context/actions/list-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAA8B,EAAE,EAChC,OAAyB;IAEzB,sBAAsB;IACtB,oBAAoB,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAE3D,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAErC,2BAA2B;IAC3B,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC,YAAY,EAAE,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC;aACjD,QAAQ,CAAC,eAAe,EAAE,cAAc,EAAE,MAAM,CAAC;aACjD,KAAK,CAAC,cAAc,EAAE,SAAS,CAAC;aAChC,MAAM,CACL,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,IAAI,CAAC,GAAG,CAAC,2CAA2C,CAAC,CACtD;aACA,OAAO,CAAC,QAAQ,EAAE,KAAK,CAOtB,CAAC;QAEL,oBAAoB;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClC,eAAe,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI;YAC7E,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,SAAS,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/tools/context/actions/list.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Get context decisions with advanced filtering
+ * Uses v_tagged_decisions view for token efficiency
+ * Supports filtering by status, layer, tags, and scope
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { GetContextParams, GetContextResponse } from '../types.js';
+/**
+ * Get context decisions with advanced filtering
+ *
+ * @param params - Filter parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decisions with metadata
+ */
+export declare function getContext(params?: GetContextParams, adapter?: DatabaseAdapter): Promise<GetContextResponse>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAkB,MAAM,aAAa,CAAC;AAExF;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,GAAE,gBAAqB,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA2F7B"}

package/dist/tools/context/actions/list.js

@@ -0,0 +1,100 @@
+/**
+ * Get context decisions with advanced filtering
+ * Uses v_tagged_decisions view for token efficiency
+ * Supports filtering by status, layer, tags, and scope
+ */
+import { getAdapter } 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';
+/**
+ * Get context decisions with advanced filtering
+ *
+ * @param params - Filter parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Array of decisions with metadata
+ */
+export async function getContext(params = {}, adapter) {
+    // Validate parameters
+    try {
+        validateActionParams('decision', 'list', 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 query', {
+            currentProject: getProjectContext().getProjectName(),
+            referencedProject: params._reference_project,
+            projectId
+        });
+    }
+    else {
+        // Normal query: use current project
+        projectId = getProjectContext().getProjectId();
+    }
+    try {
+        // Build query dynamically based on filters
+        let query = knex('v_tagged_decisions').where('project_id', projectId);
+        // Filter by status
+        if (params.status) {
+            if (!STRING_TO_STATUS[params.status]) {
+                throw new Error(`Invalid status: ${params.status}`);
+            }
+            query = query.where('status', params.status);
+        }
+        // Filter by layer
+        if (params.layer) {
+            query = query.where('layer', params.layer);
+        }
+        // Filter by scope
+        if (params.scope) {
+            // Use LIKE for comma-separated scopes
+            query = query.where('scopes', 'like', `%${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 = query.where('tags', 'like', `%${tag}%`);
+                }
+            }
+            else {
+                // Any tag must be present (OR)
+                query = query.where((builder) => {
+                    for (const tag of params.tags) {
+                        builder.orWhere('tags', 'like', `%${tag}%`);
+                    }
+                });
+            }
+        }
+        // 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 get context: ${message}`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/context/actions/list.js.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * 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 { DatabaseAdapter } from '../../../adapters/index.js';
+import type { QuickSetDecisionParams, QuickSetDecisionResponse } from '../types.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 declare function quickSetDecision(params: QuickSetDecisionParams, adapter?: DatabaseAdapter): Promise<QuickSetDecisionResponse>;
+//# sourceMappingURL=quick-set.d.ts.map