@fleettools/server 0.1.0

package/dist/server/api/src/decomposition/strategies.js

@@ -0,0 +1,147 @@
+/**
+ * FleetTools Phase 4: Strategy Selection
+ *
+ * Analyzes task keywords and codebase patterns to select the optimal
+ * decomposition strategy (file-based, feature-based, risk-based, research-based).
+ *
+ * @since 4.0.0 - Initial implementation
+ * @last-updated 2026-01-08
+ */
+/**
+ * StrategySelector - Selects optimal decomposition strategy
+ *
+ * Uses keyword analysis and codebase pattern detection to choose
+ * the best strategy for decomposing a task.
+ */
+export class StrategySelector {
+    /**
+     * Keywords that indicate each strategy
+     */
+    strategyKeywords = {
+        'file-based': [
+            'refactor', 'migrate', 'rename', 'update all', 'replace', 'convert',
+            'standardize', 'reorganize', 'restructure', 'consolidate', 'move',
+            'extract', 'inline', 'simplify', 'cleanup', 'modernize',
+        ],
+        'feature-based': [
+            'add', 'implement', 'build', 'create', 'develop', 'new',
+            'feature', 'endpoint', 'component', 'service', 'integration',
+            'support', 'enable', 'introduce', 'establish',
+        ],
+        'risk-based': [
+            'fix', 'bug', 'security', 'critical', 'urgent', 'hotfix',
+            'patch', 'resolve', 'issue', 'problem', 'error', 'crash',
+            'vulnerability', 'exploit', 'breach', 'regression',
+        ],
+        'research-based': [
+            'investigate', 'explore', 'analyze', 'understand', 'research',
+            'evaluate', 'assess', 'study', 'examine', 'review', 'audit',
+            'discover', 'learn', 'prototype', 'poc', 'proof of concept',
+        ],
+    };
+    /**
+     * Analyze task and select optimal strategy
+     */
+    selectStrategy(taskDescription) {
+        const lowerTask = taskDescription.toLowerCase();
+        // Calculate scores for each strategy
+        const scores = {
+            'file-based': this.scoreStrategy(lowerTask, 'file-based'),
+            'feature-based': this.scoreStrategy(lowerTask, 'feature-based'),
+            'risk-based': this.scoreStrategy(lowerTask, 'risk-based'),
+            'research-based': this.scoreStrategy(lowerTask, 'research-based'),
+        };
+        // Find best strategy
+        const entries = Object.entries(scores);
+        const [selectedStrategy, maxScore] = entries.reduce((best, current) => current[1] > best[1] ? current : best);
+        // Normalize scores to 0-1 range
+        const totalScore = Object.values(scores).reduce((a, b) => a + b, 0);
+        const normalizedScores = {
+            'file-based': scores['file-based'] / (totalScore || 1),
+            'feature-based': scores['feature-based'] / (totalScore || 1),
+            'risk-based': scores['risk-based'] / (totalScore || 1),
+            'research-based': scores['research-based'] / (totalScore || 1),
+        };
+        // Get matched keywords
+        const matchedKeywords = this.getMatchedKeywords(lowerTask, selectedStrategy);
+        // Calculate confidence
+        const confidence = Math.min(1, normalizedScores[selectedStrategy] * 1.5);
+        return {
+            selected_strategy: selectedStrategy,
+            confidence,
+            strategy_scores: normalizedScores,
+            matched_keywords: matchedKeywords,
+            detected_patterns: this.detectPatterns(taskDescription),
+        };
+    }
+    /**
+     * Score a strategy based on keyword matches
+     */
+    scoreStrategy(taskDescription, strategy) {
+        const keywords = this.strategyKeywords[strategy];
+        let score = 0;
+        for (const keyword of keywords) {
+            // Count occurrences of keyword
+            const regex = new RegExp(`\\b${keyword}\\b`, 'gi');
+            const matches = taskDescription.match(regex);
+            if (matches) {
+                score += matches.length;
+            }
+        }
+        return score;
+    }
+    /**
+     * Get keywords that matched for a strategy
+     */
+    getMatchedKeywords(taskDescription, strategy) {
+        const keywords = this.strategyKeywords[strategy];
+        const matched = [];
+        for (const keyword of keywords) {
+            const regex = new RegExp(`\\b${keyword}\\b`, 'i');
+            if (regex.test(taskDescription)) {
+                matched.push(keyword);
+            }
+        }
+        return matched;
+    }
+    /**
+     * Detect patterns in the task description
+     */
+    detectPatterns(taskDescription) {
+        const patterns = [];
+        const lowerTask = taskDescription.toLowerCase();
+        // Pattern detection
+        if (/multiple\s+files|across\s+files|all\s+files/.test(lowerTask)) {
+            patterns.push('multi-file-change');
+        }
+        if (/database|schema|migration|table/.test(lowerTask)) {
+            patterns.push('database-change');
+        }
+        if (/api|endpoint|route|controller/.test(lowerTask)) {
+            patterns.push('api-change');
+        }
+        if (/ui|component|frontend|react|vue/.test(lowerTask)) {
+            patterns.push('ui-change');
+        }
+        if (/test|spec|coverage/.test(lowerTask)) {
+            patterns.push('testing-focus');
+        }
+        if (/performance|optimize|speed|latency/.test(lowerTask)) {
+            patterns.push('performance-focus');
+        }
+        if (/security|auth|permission|access|encrypt/.test(lowerTask)) {
+            patterns.push('security-focus');
+        }
+        if (/parallel|concurrent|async|background/.test(lowerTask)) {
+            patterns.push('concurrency-focus');
+        }
+        return patterns;
+    }
+}
+/**
+ * Create a new strategy selector instance
+ */
+export function createStrategySelector() {
+    return new StrategySelector();
+}
+//# sourceMappingURL=strategies.js.map

package/dist/server/api/src/decomposition/strategies.js.map

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