sqlew 3.8.0 → 3.9.0

package/dist/database/migrations/20251114121000_add_suggest_tool_use_cases_v3_9_0.js

@@ -0,0 +1,246 @@
+/**
+ * Converted from: src/config/knex/enhancements/20251114121000_add_suggest_tool_use_cases_v3_9_0.ts
+ * Line count: 253 → 253 (0% reduction)
+ *
+ * No wrapper needed - Pure data seeding migration (JSON data insertion)
+ *
+ * Migration: Add Suggest Tool Use Cases (v3.9.0)
+ *
+ * Adds comprehensive use cases for the suggest tool workflows:
+ * - Preventing duplicate decisions
+ * - Finding related decisions for consistency
+ * - Discovering decisions by topic (tags)
+ * - Context-aware decision discovery
+ *
+ * Part of v3.9.0 Decision Intelligence System
+ */
+export async function up(knex) {
+    // Get category IDs
+    const decisionCategory = await knex('m_help_use_case_categories')
+        .where('category_name', 'decision_tracking')
+        .select('category_id')
+        .first();
+    const crossToolCategory = await knex('m_help_use_case_categories')
+        .where('category_name', 'cross_tool_workflow')
+        .select('category_id')
+        .first();
+    if (!decisionCategory || !crossToolCategory) {
+        throw new Error('Required use case categories not found. Run seed_help_categories_and_use_cases migration first.');
+    }
+    // Check if suggest use cases already exist
+    const existingUseCases = await knex('t_help_use_cases')
+        .where('title', 'like', '%suggest%')
+        .orWhere('full_example', 'like', '%suggest%');
+    if (existingUseCases.length > 0) {
+        console.log('✓ Suggest use cases already exist, skipping');
+        return;
+    }
+    // =========================================================================
+    // Add Suggest Tool Use Cases
+    // =========================================================================
+    await knex('t_help_use_cases').insert([
+        {
+            category_id: decisionCategory.category_id,
+            title: 'Prevent duplicate decisions before creation',
+            complexity: 'basic',
+            description: 'Use suggest.check_duplicate to verify a decision key is unique before creating it. Prevents duplicate decisions and discovers existing similar decisions that might be updated instead.',
+            full_example: JSON.stringify({
+                scenario: 'Before creating a new decision about API authentication, check if similar decisions exist',
+                steps: [
+                    {
+                        step: 1,
+                        action: 'suggest.check_duplicate',
+                        code: {
+                            action: 'check_duplicate',
+                            key: 'api/authentication-strategy'
+                        },
+                        explanation: 'Check if key exists or is very similar (score >= 70)'
+                    },
+                    {
+                        step: 2,
+                        decision: 'If no exact match found and similarity scores are low, create new decision',
+                        action: 'decision.set',
+                        code: {
+                            action: 'set',
+                            key: 'api/authentication-strategy',
+                            value: 'JWT with refresh tokens',
+                            layer: 'business',
+                            tags: ['api', 'security', 'authentication']
+                        }
+                    },
+                    {
+                        step: 3,
+                        alternative: 'If exact match or high similarity found, update existing decision instead',
+                        action: 'decision.set',
+                        code: {
+                            action: 'set',
+                            key: 'existing-key-from-suggestion',
+                            value: 'Updated value',
+                            version: '1.1.0'
+                        }
+                    }
+                ]
+            }),
+            action_sequence: 'suggest.check_duplicate → decision.set (new or update)'
+        },
+        {
+            category_id: decisionCategory.category_id,
+            title: 'Find related decisions for consistency',
+            complexity: 'intermediate',
+            description: 'Use suggest.by_key to find decisions with similar keys when making architectural choices. Ensures consistency across related decisions and helps discover existing patterns.',
+            full_example: JSON.stringify({
+                scenario: 'When implementing database caching strategy, find related database decisions',
+                steps: [
+                    {
+                        step: 1,
+                        action: 'suggest.by_key',
+                        code: {
+                            action: 'by_key',
+                            key: 'db/caching-strategy',
+                            limit: 5,
+                            min_score: 40
+                        },
+                        explanation: 'Find similar database decisions (db/connection-pool, db/query-optimization, etc.)'
+                    },
+                    {
+                        step: 2,
+                        action: 'decision.get',
+                        code: {
+                            action: 'get',
+                            key: 'db/connection-pool',
+                            include_context: true
+                        },
+                        explanation: 'Review similar decisions to understand existing patterns'
+                    },
+                    {
+                        step: 3,
+                        action: 'decision.set',
+                        code: {
+                            action: 'set',
+                            key: 'db/caching-strategy',
+                            value: 'Redis with write-through pattern',
+                            layer: 'data',
+                            tags: ['database', 'caching', 'performance']
+                        },
+                        explanation: 'Create new decision consistent with existing db/ pattern'
+                    }
+                ]
+            }),
+            action_sequence: 'suggest.by_key → decision.get → decision.set'
+        },
+        {
+            category_id: decisionCategory.category_id,
+            title: 'Discover decisions by topic using tags',
+            complexity: 'basic',
+            description: 'Use suggest.by_tags to find all decisions related to a specific topic or feature. Fast tag-based lookup for discovering related context.',
+            full_example: JSON.stringify({
+                scenario: 'Find all security-related decisions before implementing authentication',
+                steps: [
+                    {
+                        step: 1,
+                        action: 'suggest.by_tags',
+                        code: {
+                            action: 'by_tags',
+                            tags: ['security', 'authentication'],
+                            layer: 'business',
+                            limit: 10
+                        },
+                        explanation: 'Find security and authentication decisions in business layer'
+                    },
+                    {
+                        step: 2,
+                        action: 'decision.get',
+                        code: {
+                            action: 'get',
+                            key: 'returned-key-from-suggestion',
+                            include_context: true
+                        },
+                        explanation: 'Review each suggested decision for context and rationale'
+                    }
+                ],
+                expected_outcome: 'Comprehensive list of security decisions to guide implementation',
+                common_pitfalls: [
+                    'Using too many tags (reduces matches)',
+                    'Not specifying layer (gets results from all layers)',
+                    'Setting min_score too high (excludes valid results)'
+                ]
+            }),
+            action_sequence: 'suggest.by_tags → decision.get (for each result)'
+        },
+        {
+            category_id: crossToolCategory.category_id,
+            title: 'Context-aware decision discovery',
+            complexity: 'advanced',
+            description: 'Use suggest.by_context for comprehensive decision discovery using all context dimensions: key similarity, tag overlap, layer matching, and priority weighting. Ideal when you have rich context.',
+            full_example: JSON.stringify({
+                scenario: 'Find relevant decisions when implementing critical infrastructure change',
+                steps: [
+                    {
+                        step: 1,
+                        action: 'suggest.by_context',
+                        code: {
+                            action: 'by_context',
+                            key: 'infra/kubernetes-migration',
+                            tags: ['infrastructure', 'deployment', 'docker'],
+                            layer: 'infrastructure',
+                            priority: 4,
+                            limit: 5,
+                            min_score: 50
+                        },
+                        explanation: 'Hybrid scoring across key, tags, layer, and priority for best matches'
+                    },
+                    {
+                        step: 2,
+                        action: 'decision.get',
+                        code: {
+                            action: 'get',
+                            key: 'suggested-decision-key',
+                            include_context: true
+                        },
+                        explanation: 'Review suggested decision context and rationale'
+                    },
+                    {
+                        step: 3,
+                        action: 'decision.add_decision_context',
+                        code: {
+                            action: 'add_decision_context',
+                            key: 'infra/kubernetes-migration',
+                            rationale: 'Based on successful docker patterns from similar decisions',
+                            alternatives_considered: [
+                                {
+                                    option: 'Direct VM deployment',
+                                    rejected_because: 'Less flexible than container orchestration'
+                                }
+                            ],
+                            tradeoffs: {
+                                pros: ['Auto-scaling', 'High availability'],
+                                cons: ['Increased complexity', 'Learning curve']
+                            }
+                        },
+                        explanation: 'Document new decision with context referencing related decisions'
+                    }
+                ],
+                expected_outcome: 'Well-informed decision based on comprehensive context discovery',
+                common_pitfalls: [
+                    'Not providing enough context (tags, layer)',
+                    'Setting min_score too high for exploratory search',
+                    'Ignoring priority weighting for critical decisions'
+                ],
+                related_tools: ['decision', 'task']
+            }),
+            action_sequence: 'suggest.by_context → decision.get → decision.add_decision_context'
+        }
+    ]);
+    console.log('✓ Added 4 suggest tool use cases (1 basic, 1 intermediate, 1 advanced, 1 cross-tool)');
+}
+export async function down(knex) {
+    // Remove suggest use cases
+    await knex('t_help_use_cases')
+        .where('title', 'like', '%suggest%')
+        .orWhere('title', 'like', '%duplicate decision%')
+        .orWhere('title', 'like', '%related decisions%')
+        .orWhere('title', 'like', '%Context-aware decision%')
+        .delete();
+    console.log('✓ Removed suggest tool use cases');
+}
+//# sourceMappingURL=20251114121000_add_suggest_tool_use_cases_v3_9_0.js.map

package/dist/database/migrations/20251114121000_add_suggest_tool_use_cases_v3_9_0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251114121000_add_suggest_tool_use_cases_v3_9_0.js","sourceRoot":"","sources":["../../../src/database/migrations/20251114121000_add_suggest_tool_use_cases_v3_9_0.ts"],"names":[],"mappings":"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"}

package/dist/database/migrations/20251114130000_seed_builtin_policies_v3_9_0.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Converted from: src/config/knex/enhancements/20251114130000_seed_builtin_policies_v3_9_0.ts
+ * Changes:
+ * - No Universal Knex Wrapper needed (pure data seeding migration)
+ * - Original code already idempotent and cross-database compatible
+ * - Line count: 177 (original) → 177 (no reduction - optimal as-is)
+ */
+import type { Knex } from "knex";
+/**
+ * Migration: Seed Built-in Decision Policies (v3.9.0)
+ *
+ * Seeds 5 standard policies for common decision types:
+ * 1. security_vulnerability - CVE tracking with pattern validation
+ * 2. breaking_change - Version changes with semver and migration docs
+ * 3. architecture_decision - ADRs with rationale and alternatives
+ * 4. performance_optimization - Performance improvements with metrics
+ * 5. deprecation - Deprecation notices with replacement recommendations
+ *
+ * Part of v3.9.0 Decision Intelligence System
+ */
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251114130000_seed_builtin_policies_v3_9_0.d.ts.map

package/dist/database/migrations/20251114130000_seed_builtin_policies_v3_9_0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251114130000_seed_builtin_policies_v3_9_0.d.ts","sourceRoot":"","sources":["../../../src/database/migrations/20251114130000_seed_builtin_policies_v3_9_0.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;;;;;;;GAWG;AAEH,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgJlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAcpD"}

package/dist/database/migrations/20251114130000_seed_builtin_policies_v3_9_0.js

@@ -0,0 +1,175 @@
+/**
+ * Converted from: src/config/knex/enhancements/20251114130000_seed_builtin_policies_v3_9_0.ts
+ * Changes:
+ * - No Universal Knex Wrapper needed (pure data seeding migration)
+ * - Original code already idempotent and cross-database compatible
+ * - Line count: 177 (original) → 177 (no reduction - optimal as-is)
+ */
+/**
+ * Migration: Seed Built-in Decision Policies (v3.9.0)
+ *
+ * Seeds 5 standard policies for common decision types:
+ * 1. security_vulnerability - CVE tracking with pattern validation
+ * 2. breaking_change - Version changes with semver and migration docs
+ * 3. architecture_decision - ADRs with rationale and alternatives
+ * 4. performance_optimization - Performance improvements with metrics
+ * 5. deprecation - Deprecation notices with replacement recommendations
+ *
+ * Part of v3.9.0 Decision Intelligence System
+ */
+export async function up(knex) {
+    // Check if built-in policies already exist
+    const existingPolicies = await knex('t_decision_policies')
+        .whereIn('name', [
+        'security_vulnerability',
+        'breaking_change',
+        'architecture_decision',
+        'performance_optimization',
+        'deprecation'
+    ])
+        .select('name');
+    if (existingPolicies.length > 0) {
+        console.log('✓ Built-in policies already seeded, skipping');
+        return;
+    }
+    // Get system agent ID
+    let systemAgentId;
+    const systemAgent = await knex('m_agents')
+        .where('name', 'system')
+        .select('id')
+        .first();
+    if (systemAgent) {
+        systemAgentId = systemAgent.id;
+    }
+    else {
+        const [agentId] = await knex('m_agents').insert({
+            name: 'system',
+            last_active_ts: Math.floor(Date.now() / 1000)
+        });
+        systemAgentId = agentId;
+    }
+    // Seed built-in policies
+    await knex('t_decision_policies').insert([
+        {
+            name: 'security_vulnerability',
+            defaults: JSON.stringify({
+                layer: 'cross-cutting',
+                status: 'active',
+                tags: ['security', 'vulnerability'],
+                priority: 4 // Critical
+            }),
+            validation_rules: JSON.stringify({
+                patterns: {
+                    key: '^CVE-\\d{4}-\\d{4,7}$' // CVE-YYYY-NNNNN format
+                }
+            }),
+            quality_gates: JSON.stringify({
+                required_fields: ['rationale'] // Must explain the vulnerability
+            }),
+            required_fields: JSON.stringify(['rationale']), // Legacy compatibility
+            suggest_similar: 1, // Auto-trigger suggestions for related CVEs
+            category: 'security',
+            created_by: systemAgentId,
+            project_id: 1, // Default project
+            ts: Math.floor(Date.now() / 1000)
+        },
+        {
+            name: 'breaking_change',
+            defaults: JSON.stringify({
+                layer: 'infrastructure',
+                status: 'active',
+                tags: ['breaking-change', 'versioning'],
+                priority: 4 // Critical
+            }),
+            validation_rules: JSON.stringify({
+                patterns: {
+                    value: '.*migration.*|.*upgrade.*' // Must mention migration or upgrade path
+                }
+            }),
+            quality_gates: JSON.stringify({
+                required_fields: ['rationale', 'alternatives'] // Must explain why and what alternatives exist
+            }),
+            required_fields: JSON.stringify(['rationale', 'alternatives']), // Legacy compatibility
+            suggest_similar: 1, // Auto-trigger to find related breaking changes
+            category: 'versioning',
+            created_by: systemAgentId,
+            project_id: 1,
+            ts: Math.floor(Date.now() / 1000)
+        },
+        {
+            name: 'architecture_decision',
+            defaults: JSON.stringify({
+                layer: 'infrastructure',
+                status: 'active',
+                tags: ['architecture', 'adr'],
+                priority: 3 // High
+            }),
+            quality_gates: JSON.stringify({
+                required_fields: ['rationale', 'alternatives', 'tradeoffs'] // Full ADR documentation
+            }),
+            required_fields: JSON.stringify(['rationale', 'alternatives', 'tradeoffs']), // Legacy compatibility
+            suggest_similar: 1, // Find related architectural decisions
+            category: 'architecture',
+            created_by: systemAgentId,
+            project_id: 1,
+            ts: Math.floor(Date.now() / 1000)
+        },
+        {
+            name: 'performance_optimization',
+            defaults: JSON.stringify({
+                layer: 'infrastructure',
+                status: 'active',
+                tags: ['performance', 'optimization'],
+                priority: 2 // Medium
+            }),
+            quality_gates: JSON.stringify({
+                required_fields: ['rationale'] // Must explain performance improvement
+            }),
+            required_fields: JSON.stringify(['rationale']), // Legacy compatibility
+            suggest_similar: 1, // Find related performance decisions
+            category: 'performance',
+            created_by: systemAgentId,
+            project_id: 1,
+            ts: Math.floor(Date.now() / 1000)
+        },
+        {
+            name: 'deprecation',
+            defaults: JSON.stringify({
+                layer: 'infrastructure',
+                status: 'active',
+                tags: ['deprecation', 'migration'],
+                priority: 3 // High
+            }),
+            validation_rules: JSON.stringify({
+                patterns: {
+                    value: '.*replace.*|.*alternative.*|.*migration.*' // Must mention replacement or migration
+                }
+            }),
+            quality_gates: JSON.stringify({
+                required_fields: ['rationale', 'alternatives'] // Must explain why and recommend alternatives
+            }),
+            required_fields: JSON.stringify(['rationale', 'alternatives']), // Legacy compatibility
+            suggest_similar: 1, // Find related deprecations
+            category: 'deprecation',
+            created_by: systemAgentId,
+            project_id: 1,
+            ts: Math.floor(Date.now() / 1000)
+        }
+    ]);
+    console.log('✓ Seeded 5 built-in policies (security_vulnerability, breaking_change, architecture_decision, performance_optimization, deprecation)');
+}
+export async function down(knex) {
+    // Remove built-in policies
+    await knex('t_decision_policies')
+        .whereIn('name', [
+        'security_vulnerability',
+        'breaking_change',
+        'architecture_decision',
+        'performance_optimization',
+        'deprecation'
+    ])
+        .where('project_id', 1) // Only remove from default project
+        .delete();
+    console.log('✓ Removed built-in policies');
+}
+//# sourceMappingURL=20251114130000_seed_builtin_policies_v3_9_0.js.map

package/dist/database/migrations/20251114130000_seed_builtin_policies_v3_9_0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251114130000_seed_builtin_policies_v3_9_0.js","sourceRoot":"","sources":["../../../src/database/migrations/20251114130000_seed_builtin_policies_v3_9_0.ts"],"names":[],"mappings":"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"}

package/dist/database/migrations/20251114140000_add_policy_help_v3_9_0.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Converted from: src/config/knex/enhancements/20251114140000_add_policy_help_v3_9_0.ts
+ * Changes:
+ * - No Universal Knex Wrapper needed (pure data seeding migration)
+ * - Original code already idempotent and cross-database compatible
+ * - Line count: 244 (original) → 244 (no reduction - optimal as-is)
+ */
+import type { Knex } from "knex";
+/**
+ * Migration: Add Policy Actions to Help System (v3.9.0)
+ *
+ * Adds documentation for 3 policy management actions:
+ * - create_policy
+ * - list_policies
+ * - set_from_policy
+ *
+ * Part of v3.9.0 Decision Intelligence System
+ */
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251114140000_add_policy_help_v3_9_0.d.ts.map

package/dist/database/migrations/20251114140000_add_policy_help_v3_9_0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251114140000_add_policy_help_v3_9_0.d.ts","sourceRoot":"","sources":["../../../src/database/migrations/20251114140000_add_policy_help_v3_9_0.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;;;;;GASG;AAEH,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA2NlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpD"}