sqlew 3.7.4 → 3.8.0

package/dist/tools/constraints/help/example.js

@@ -0,0 +1,144 @@
+/**
+ * Comprehensive examples for constraint tool
+ */
+/**
+ * Get comprehensive examples for constraint tool
+ * @returns Examples documentation object
+ */
+export function constraintExample() {
+    return {
+        tool: 'constraint',
+        description: 'Comprehensive constraint examples for various use cases',
+        categories: {
+            performance: {
+                description: 'Performance-related constraints for response times, throughput, resource usage',
+                examples: [
+                    {
+                        scenario: 'API Response Time',
+                        example: '{ action: "add", category: "performance", constraint_text: "All API endpoints must respond within 100ms for 95th percentile", priority: "high", layer: "business", tags: ["api", "latency"] }',
+                        rationale: 'Ensures fast user experience and prevents timeout issues'
+                    },
+                    {
+                        scenario: 'Database Query Performance',
+                        example: '{ action: "add", category: "performance", constraint_text: "Database queries must complete within 50ms", priority: "high", layer: "data", tags: ["database", "query"] }',
+                        rationale: 'Prevents database bottlenecks and ensures scalability'
+                    },
+                    {
+                        scenario: 'Memory Usage',
+                        example: '{ action: "add", category: "performance", constraint_text: "Peak memory usage must not exceed 512MB per instance", priority: "critical", layer: "infrastructure", tags: ["memory", "resource"] }',
+                        rationale: 'Prevents out-of-memory errors in containerized environments'
+                    }
+                ]
+            },
+            architecture: {
+                description: 'Architectural constraints for code structure, dependencies, patterns',
+                examples: [
+                    {
+                        scenario: 'Layer Dependency Rules',
+                        example: '{ action: "add", category: "architecture", constraint_text: "Presentation layer must not directly access data layer - use business layer only", priority: "critical", layer: "cross-cutting", tags: ["layering", "separation"] }',
+                        rationale: 'Enforces clean architecture and separation of concerns'
+                    },
+                    {
+                        scenario: 'Dependency Injection',
+                        example: '{ action: "add", category: "architecture", constraint_text: "All service classes must use constructor-based dependency injection", priority: "medium", layer: "business", tags: ["di", "testability"] }',
+                        rationale: 'Improves testability and reduces coupling'
+                    },
+                    {
+                        scenario: 'API Versioning',
+                        example: '{ action: "add", category: "architecture", constraint_text: "All public APIs must include version prefix (e.g., /v1/, /v2/)", priority: "high", layer: "presentation", tags: ["api", "versioning"] }',
+                        rationale: 'Enables backward compatibility and smooth API evolution'
+                    }
+                ]
+            },
+            security: {
+                description: 'Security constraints for authentication, authorization, data protection',
+                examples: [
+                    {
+                        scenario: 'Authentication Required',
+                        example: '{ action: "add", category: "security", constraint_text: "All non-public endpoints must require JWT authentication", priority: "critical", layer: "presentation", tags: ["auth", "jwt"] }',
+                        rationale: 'Prevents unauthorized access to protected resources'
+                    },
+                    {
+                        scenario: 'Data Encryption',
+                        example: '{ action: "add", category: "security", constraint_text: "All PII (Personally Identifiable Information) must be encrypted at rest using AES-256", priority: "critical", layer: "data", tags: ["encryption", "pii"] }',
+                        rationale: 'Protects sensitive data and ensures compliance'
+                    },
+                    {
+                        scenario: 'Input Validation',
+                        example: '{ action: "add", category: "security", constraint_text: "All user inputs must be validated and sanitized before processing", priority: "critical", layer: "presentation", tags: ["validation", "injection-prevention"] }',
+                        rationale: 'Prevents injection attacks (SQL, XSS, etc.)'
+                    }
+                ]
+            }
+        },
+        workflows: {
+            constraint_validation: {
+                description: 'Workflow for validating code against constraints',
+                steps: [
+                    {
+                        step: 1,
+                        action: 'Retrieve active constraints for layer',
+                        example: '{ action: "get", layer: "business", active_only: true }'
+                    },
+                    {
+                        step: 2,
+                        action: 'Check code changes against constraints',
+                        example: 'Review file changes and verify compliance with each constraint'
+                    },
+                    {
+                        step: 3,
+                        action: 'Report violations',
+                        example: 'Use message tool to send warnings for constraint violations'
+                    },
+                    {
+                        step: 4,
+                        action: 'Link violations to tasks',
+                        example: 'Create tasks to fix violations and link to relevant constraints'
+                    }
+                ]
+            },
+            requirement_tracking: {
+                description: 'Workflow for tracking requirements as constraints',
+                steps: [
+                    {
+                        step: 1,
+                        action: 'Add requirement as constraint',
+                        example: '{ action: "add", category: "performance", constraint_text: "System must handle 1000 concurrent users", priority: "high", tags: ["requirement", "load"] }'
+                    },
+                    {
+                        step: 2,
+                        action: 'Link related decisions',
+                        example: 'Use decision tool to record architectural decisions that address the constraint'
+                    },
+                    {
+                        step: 3,
+                        action: 'Create implementation tasks',
+                        example: 'Use task tool to break down implementation and link to constraint'
+                    },
+                    {
+                        step: 4,
+                        action: 'Validate compliance',
+                        example: 'Test implementation against constraint criteria'
+                    }
+                ]
+            }
+        },
+        best_practices: {
+            writing_constraints: [
+                'Be specific and measurable (use numbers, percentages, time limits)',
+                'Include rationale in tags or separate documentation',
+                'Use appropriate priority (critical for must-have, high for important, medium/low for nice-to-have)',
+                'Assign to correct layer (where constraint is enforced)',
+                'Tag comprehensively for easy retrieval'
+            ],
+            managing_constraints: [
+                'Review constraints regularly and deactivate outdated ones',
+                'Link constraints to related decisions and tasks',
+                'Use constraints for both technical and business requirements',
+                'Validate code changes against active constraints',
+                'Document constraint violations and remediation plans'
+            ]
+        }
+    };
+}
+//# sourceMappingURL=example.js.map

package/dist/tools/constraints/help/example.js.map

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

package/dist/tools/constraints/help/help.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Help documentation for constraint tool
+ */
+/**
+ * Get help documentation for constraint tool
+ * @returns Help documentation object
+ */
+export declare function constraintHelp(): any;
+//# sourceMappingURL=help.d.ts.map

package/dist/tools/constraints/help/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../src/tools/constraints/help/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,GAAG,CAsBpC"}

package/dist/tools/constraints/help/help.js

@@ -0,0 +1,31 @@
+/**
+ * Help documentation for constraint tool
+ */
+/**
+ * Get help documentation for constraint tool
+ * @returns Help documentation object
+ */
+export function constraintHelp() {
+    return {
+        tool: 'constraint',
+        description: 'Manage project constraints (performance, architecture, security)',
+        note: '💡 TIP: Use action: "example" to see comprehensive usage scenarios and real-world examples for all constraint actions.',
+        actions: {
+            add: 'Add constraint. Params: category (required), constraint_text (required), priority, layer, tags, created_by',
+            get: 'Get constraints. Params: category, layer, priority, tags, active_only, limit',
+            deactivate: 'Deactivate constraint. Params: constraint_id (required)'
+        },
+        examples: {
+            add: '{ action: "add", category: "performance", constraint_text: "API response time <100ms", priority: "high", tags: ["api"] }',
+            get: '{ action: "get", category: "performance", active_only: true }',
+            deactivate: '{ action: "deactivate", constraint_id: 5 }'
+        },
+        documentation: {
+            tool_selection: 'docs/TOOL_SELECTION.md - Decision tree, constraint vs decision comparison (236 lines, ~12k tokens)',
+            workflows: 'docs/WORKFLOWS.md - Constraint validation workflows, requirement tracking (602 lines, ~30k tokens)',
+            shared_concepts: 'docs/SHARED_CONCEPTS.md - Layer definitions, enum values (category/priority) (339 lines, ~17k tokens)',
+            best_practices: 'docs/BEST_PRACTICES.md - When to use constraints, common patterns (345 lines, ~17k tokens)'
+        }
+    };
+}
+//# sourceMappingURL=help.js.map

package/dist/tools/constraints/help/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../src/tools/constraints/help/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,kEAAkE;QAC/E,IAAI,EAAE,wHAAwH;QAC9H,OAAO,EAAE;YACP,GAAG,EAAE,4GAA4G;YACjH,GAAG,EAAE,8EAA8E;YACnF,UAAU,EAAE,yDAAyD;SACtE;QACD,QAAQ,EAAE;YACR,GAAG,EAAE,0HAA0H;YAC/H,GAAG,EAAE,+DAA+D;YACpE,UAAU,EAAE,4CAA4C;SACzD;QACD,aAAa,EAAE;YACb,cAAc,EAAE,oGAAoG;YACpH,SAAS,EAAE,oGAAoG;YAC/G,eAAe,EAAE,uGAAuG;YACxH,cAAc,EAAE,4FAA4F;SAC7G;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/constraints/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Constraint tool - Barrel export
+ *
+ * Exports all constraint-related actions from modular structure
+ */
+export { addConstraint } from './actions/add.js';
+export { getConstraints } from './actions/get.js';
+export { deactivateConstraint } from './actions/deactivate.js';
+export { constraintHelp } from './help/help.js';
+export { constraintExample } from './help/example.js';
+export type { AddConstraintParams, GetConstraintsParams, DeactivateConstraintParams, AddConstraintResponse, GetConstraintsResponse, DeactivateConstraintResponse, TaggedConstraint, Priority } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/constraints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/constraints/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,QAAQ,EACT,MAAM,YAAY,CAAC"}

package/dist/tools/constraints/index.js

@@ -0,0 +1,13 @@
+/**
+ * Constraint tool - Barrel export
+ *
+ * Exports all constraint-related actions from modular structure
+ */
+// Action exports
+export { addConstraint } from './actions/add.js';
+export { getConstraints } from './actions/get.js';
+export { deactivateConstraint } from './actions/deactivate.js';
+// Help exports
+export { constraintHelp } from './help/help.js';
+export { constraintExample } from './help/example.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/constraints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/constraints/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/constraints/internal/validation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parameter validation utilities for constraint operations
+ */
+import { validateCategory, validatePriority } from '../../../utils/validators.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+/**
+ * Validate layer parameter for constraints
+ */
+export declare function validateLayerParam(layer?: string): void;
+export { validateCategory, validatePriority, validateActionParams };
+//# sourceMappingURL=validation.d.ts.map

package/dist/tools/constraints/internal/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/tools/constraints/internal/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAG7E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAMvD;AAGD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/tools/constraints/internal/validation.js

@@ -0,0 +1,17 @@
+/**
+ * Parameter validation utilities for constraint operations
+ */
+import { validateCategory, validatePriority } from '../../../utils/validators.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+import { STANDARD_LAYERS } from '../../../constants.js';
+/**
+ * Validate layer parameter for constraints
+ */
+export function validateLayerParam(layer) {
+    if (layer && !STANDARD_LAYERS.includes(layer)) {
+        throw new Error(`Invalid layer: ${layer}. Must be one of: ${STANDARD_LAYERS.join(', ')}`);
+    }
+}
+// Re-export common validators
+export { validateCategory, validatePriority, validateActionParams };
+//# sourceMappingURL=validation.js.map

package/dist/tools/constraints/internal/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/tools/constraints/internal/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAY,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,qBAAqB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/tools/constraints/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Constraint-specific types
+ * Re-exports from main types.ts for constraint module
+ */
+export type { AddConstraintParams, GetConstraintsParams, DeactivateConstraintParams, AddConstraintResponse, GetConstraintsResponse, DeactivateConstraintResponse, TaggedConstraint, Priority } from '../../types.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/constraints/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/constraints/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,QAAQ,EACT,MAAM,gBAAgB,CAAC"}

package/dist/tools/constraints/types.js

@@ -0,0 +1,6 @@
+/**
+ * Constraint-specific types
+ * Re-exports from main types.ts for constraint module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/constraints/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/constraints/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/tools/context/actions/add-context.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Add decision context action
+ * Adds rich context (rationale, alternatives, tradeoffs) to a decision
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+/**
+ * Add decision context
+ *
+ * @param params - Context parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status
+ */
+export declare function addDecisionContextAction(params: any, adapter?: DatabaseAdapter): Promise<any>;
+//# sourceMappingURL=add-context.d.ts.map

package/dist/tools/context/actions/add-context.d.ts.map

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

package/dist/tools/context/actions/add-context.js

@@ -0,0 +1,62 @@
+/**
+ * Add decision context action
+ * Adds rich context (rationale, alternatives, tradeoffs) to a decision
+ */
+import { getAdapter, addDecisionContext as dbAddDecisionContext } from '../../../database.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * Add decision context
+ *
+ * @param params - Context parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status
+ */
+export async function addDecisionContextAction(params, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'add_decision_context', params);
+    const actualAdapter = adapter ?? getAdapter();
+    try {
+        // Parse JSON if provided as strings
+        let alternatives = params.alternatives_considered || null;
+        let tradeoffs = params.tradeoffs || null;
+        // Convert to JSON strings
+        if (alternatives !== null) {
+            if (typeof alternatives === 'object') {
+                alternatives = JSON.stringify(alternatives);
+            }
+            else if (typeof alternatives === 'string') {
+                try {
+                    JSON.parse(alternatives);
+                }
+                catch {
+                    alternatives = JSON.stringify([alternatives]);
+                }
+            }
+        }
+        if (tradeoffs !== null) {
+            if (typeof tradeoffs === 'object') {
+                tradeoffs = JSON.stringify(tradeoffs);
+            }
+            else if (typeof tradeoffs === 'string') {
+                try {
+                    JSON.parse(tradeoffs);
+                }
+                catch {
+                    tradeoffs = JSON.stringify({ description: tradeoffs });
+                }
+            }
+        }
+        const contextId = await dbAddDecisionContext(actualAdapter, params.key, params.rationale, alternatives, tradeoffs, params.decided_by || null, params.related_task_id || null, params.related_constraint_id || null);
+        return {
+            success: true,
+            context_id: contextId,
+            decision_key: params.key,
+            message: `Decision context added successfully to "${params.key}"`
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to add decision context: ${message}`);
+    }
+}
+//# sourceMappingURL=add-context.js.map

package/dist/tools/context/actions/add-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-context.js","sourceRoot":"","sources":["../../../../src/tools/context/actions/add-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,kBAAkB,IAAI,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAW,EACX,OAAyB;IAEzB,sBAAsB;IACtB,oBAAoB,CAAC,UAAU,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAC;IAEjE,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAE9C,IAAI,CAAC;QACH,oCAAoC;QACpC,IAAI,YAAY,GAAG,MAAM,CAAC,uBAAuB,IAAI,IAAI,CAAC;QAC1D,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAEzC,0BAA0B;QAC1B,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACrC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC5C,IAAI,CAAC;oBACH,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACH,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAC1C,aAAa,EACb,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,SAAS,EAChB,YAAY,EACZ,SAAS,EACT,MAAM,CAAC,UAAU,IAAI,IAAI,EACzB,MAAM,CAAC,eAAe,IAAI,IAAI,EAC9B,MAAM,CAAC,qBAAqB,IAAI,IAAI,CACrC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,MAAM,CAAC,GAAG;YACxB,OAAO,EAAE,2CAA2C,MAAM,CAAC,GAAG,GAAG;SAClE,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,mCAAmC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * 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)
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { SetDecisionBatchParams, SetDecisionBatchResponse } from '../types.js';
+/**
+ * Set multiple decisions in batch
+ *
+ * @param params - Batch parameters with array of decisions and atomic flag
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status and detailed results for each item
+ */
+export declare function setDecisionBatch(params: SetDecisionBatchParams, adapter?: DatabaseAdapter): Promise<SetDecisionBatchResponse>;
+//# sourceMappingURL=batch-set.d.ts.map

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

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

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

@@ -0,0 +1,126 @@
+/**
+ * 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)
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import connectionManager from '../../../utils/connection-manager.js';
+import { validateDecisionItem } from '../internal/validation.js';
+import { setDecisionInternal } from '../internal/queries.js';
+import { validateBatch, formatBatchValidationError } from '../../../utils/batch-validation.js';
+/**
+ * Set multiple decisions in batch
+ *
+ * @param params - Batch parameters with array of decisions and atomic flag
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status and detailed results for each item
+ */
+export async function setDecisionBatch(params, adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    // Basic parameter validation
+    if (!params.decisions || !Array.isArray(params.decisions)) {
+        throw new Error('Parameter "decisions" is required and must be an array');
+    }
+    if (params.decisions.length > 50) {
+        throw new Error('Parameter "decisions" must contain at most 50 items');
+    }
+    // Pre-validate all decisions before transaction (v3.8.0 enhancement)
+    // Comprehensive field-level validation replaces old validateBatchParams
+    const validationResult = await validateBatch(params.decisions, validateDecisionItem, actualAdapter);
+    if (!validationResult.valid) {
+        throw new Error(formatBatchValidationError(validationResult));
+    }
+    if (params.decisions.length === 0) {
+        return {
+            success: true,
+            inserted: 0,
+            failed: 0,
+            results: []
+        };
+    }
+    if (params.decisions.length > 50) {
+        throw new Error('Parameter "decisions" must contain at most 50 items');
+    }
+    // Validate project context
+    const projectId = getProjectContext().getProjectId();
+    const atomic = params.atomic !== undefined ? params.atomic : true;
+    try {
+        if (atomic) {
+            // Atomic mode: All or nothing
+            const results = await connectionManager.executeWithRetry(async () => {
+                return await actualAdapter.transaction(async (trx) => {
+                    const processedResults = [];
+                    for (const decision of params.decisions) {
+                        try {
+                            const result = await setDecisionInternal(decision, actualAdapter, projectId, trx);
+                            processedResults.push({
+                                key: decision.key,
+                                key_id: result.key_id,
+                                version: result.version,
+                                success: true,
+                                error: undefined
+                            });
+                        }
+                        catch (error) {
+                            const message = error instanceof Error ? error.message : String(error);
+                            throw new Error(`Batch failed at decision "${decision.key}": ${message}`);
+                        }
+                    }
+                    return processedResults;
+                });
+            });
+            return {
+                success: true,
+                inserted: results.length,
+                failed: 0,
+                results: results
+            };
+        }
+        else {
+            // Non-atomic mode: Process each independently
+            const results = [];
+            let inserted = 0;
+            let failed = 0;
+            for (const decision of params.decisions) {
+                try {
+                    const result = await connectionManager.executeWithRetry(async () => {
+                        return await actualAdapter.transaction(async (trx) => {
+                            return await setDecisionInternal(decision, actualAdapter, projectId, trx);
+                        });
+                    });
+                    results.push({
+                        key: decision.key,
+                        key_id: result.key_id,
+                        version: result.version,
+                        success: true,
+                        error: undefined
+                    });
+                    inserted++;
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    results.push({
+                        key: decision.key,
+                        key_id: undefined,
+                        version: undefined,
+                        success: false,
+                        error: message
+                    });
+                    failed++;
+                }
+            }
+            return {
+                success: failed === 0,
+                inserted: inserted,
+                failed: failed,
+                results: results
+            };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to execute batch operation: ${message}`);
+    }
+}
+//# sourceMappingURL=batch-set.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch-set.js","sourceRoot":"","sources":["../../../../src/tools/context/actions/batch-set.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,iBAAiB,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAG/F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA8B,EAC9B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAE9C,6BAA6B;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,qEAAqE;IACrE,wEAAwE;IACxE,MAAM,gBAAgB,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC;IACpG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,2BAA2B;IAC3B,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC,YAAY,EAAE,CAAC;IAErD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAElE,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,CAAC;YACX,8BAA8B;YAC9B,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE;gBAClE,OAAO,MAAM,aAAa,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACnD,MAAM,gBAAgB,GAAG,EAAE,CAAC;oBAE5B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;wBACxC,IAAI,CAAC;4BACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;4BAClF,gBAAgB,CAAC,IAAI,CAAC;gCACpB,GAAG,EAAE,QAAQ,CAAC,GAAG;gCACjB,MAAM,EAAE,MAAM,CAAC,MAAM;gCACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gCACvB,OAAO,EAAE,IAAI;gCACb,KAAK,EAAE,SAAS;6BACjB,CAAC,CAAC;wBACL,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BACvE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,GAAG,MAAM,OAAO,EAAE,CAAC,CAAC;wBAC5E,CAAC;oBACH,CAAC;oBAED,OAAO,gBAAgB,CAAC;gBAC1B,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,OAAO,CAAC,MAAM;gBACxB,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO;aACjB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,8CAA8C;YAC9C,MAAM,OAAO,GAAG,EAAE,CAAC;YACnB,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,IAAI,MAAM,GAAG,CAAC,CAAC;YAEf,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACxC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE;wBACjE,OAAO,MAAM,aAAa,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;4BACnD,OAAO,MAAM,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;wBAC5E,CAAC,CAAC,CAAC;oBACL,CAAC,CAAC,CAAC;oBAEH,OAAO,CAAC,IAAI,CAAC;wBACX,GAAG,EAAE,QAAQ,CAAC,GAAG;wBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,OAAO,EAAE,IAAI;wBACb,KAAK,EAAE,SAAS;qBACjB,CAAC,CAAC;oBACH,QAAQ,EAAE,CAAC;gBACb,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACvE,OAAO,CAAC,IAAI,CAAC;wBACX,GAAG,EAAE,QAAQ,CAAC,GAAG;wBACjB,MAAM,EAAE,SAAS;wBACjB,OAAO,EAAE,SAAS;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,OAAO;qBACf,CAAC,CAAC;oBACH,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,MAAM,KAAK,CAAC;gBACrB,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,OAAO;aACjB,CAAC;QACJ,CAAC;IACH,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,sCAAsC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/tools/context/actions/create-template.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Create a new decision template (FR-006)
+ * Defines reusable defaults and required fields for decisions
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { CreateTemplateParams, CreateTemplateResponse } from '../types.js';
+/**
+ * Create a new decision template
+ *
+ * @param params - Template name, defaults, required fields, and creator
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status and template ID
+ */
+export declare function createTemplate(params: CreateTemplateParams, adapter?: DatabaseAdapter): Promise<CreateTemplateResponse>;
+//# sourceMappingURL=create-template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-template.d.ts","sourceRoot":"","sources":["../../../../src/tools/context/actions/create-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAyDjC"}

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

@@ -0,0 +1,68 @@
+/**
+ * Create a new decision template (FR-006)
+ * Defines reusable defaults and required fields for decisions
+ */
+import { getAdapter, getOrCreateAgent, getLayerId } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import { STRING_TO_STATUS } from '../../../constants.js';
+import connectionManager from '../../../utils/connection-manager.js';
+import { validateActionParams } from '../internal/validation.js';
+/**
+ * Create a new decision template
+ *
+ * @param params - Template name, defaults, required fields, and creator
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Response with success status and template ID
+ */
+export async function createTemplate(params, adapter) {
+    // Validate parameters
+    validateActionParams('decision', 'create_template', params);
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Validate project context (Constraint #29 - fail-fast before mutations)
+    const projectId = getProjectContext().getProjectId();
+    try {
+        return await connectionManager.executeWithRetry(async () => {
+            return await actualAdapter.transaction(async (trx) => {
+                // Validate layer if provided in defaults
+                if (params.defaults.layer) {
+                    const layerId = await getLayerId(actualAdapter, params.defaults.layer, trx);
+                    if (layerId === null) {
+                        throw new Error(`Invalid layer in defaults: ${params.defaults.layer}. Must be one of: presentation, business, data, infrastructure, cross-cutting`);
+                    }
+                }
+                // Validate status if provided in defaults
+                if (params.defaults.status && !STRING_TO_STATUS[params.defaults.status]) {
+                    throw new Error(`Invalid status in defaults: ${params.defaults.status}. Must be 'active', 'deprecated', or 'draft'`);
+                }
+                // Get or create agent if creator specified
+                let createdById = null;
+                if (params.created_by) {
+                    createdById = await getOrCreateAgent(actualAdapter, params.created_by, trx);
+                }
+                // Serialize defaults and required fields
+                const defaultsJson = JSON.stringify(params.defaults);
+                const requiredFieldsJson = params.required_fields ? JSON.stringify(params.required_fields) : null;
+                // Insert template
+                const [id] = await trx('t_decision_templates').insert({
+                    name: params.name,
+                    project_id: projectId,
+                    defaults: defaultsJson,
+                    required_fields: requiredFieldsJson,
+                    created_by: createdById
+                });
+                return {
+                    success: true,
+                    template_id: id,
+                    template_name: params.name,
+                    message: `Template "${params.name}" created successfully`
+                };
+            });
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to create template: ${message}`);
+    }
+}
+//# sourceMappingURL=create-template.js.map