sqlew 4.3.0 → 4.3.1

package/dist/utils/suggest-helpers.js

@@ -0,0 +1,93 @@
+/**
+ * Suggest Helper Functions
+ *
+ * Shared transformation and scoring logic for suggest actions.
+ * Reduces code duplication across decision and constraint suggest operations.
+ *
+ * @since v4.3.1
+ */
+import { parseGroupConcatTags } from './tag-parser.js';
+import { scoreAndRankSuggestions, filterByThreshold as filterDecisionsByThreshold, limitSuggestions as limitDecisionSuggestions } from './suggestion-scorer.js';
+import { scoreConstraints, filterByThreshold as filterConstraintsByThreshold, limitSuggestions as limitConstraintSuggestions } from './constraint-scorer.js';
+// ============================================================================
+// Decision Helpers
+// ============================================================================
+/**
+ * Transform decision candidates and score them
+ *
+ * Consolidates the common pattern of:
+ * 1. Parse GROUP_CONCAT tags
+ * 2. Map to scorer format
+ * 3. Score and rank
+ * 4. Filter by threshold
+ * 5. Apply limit
+ *
+ * @param candidates - Raw candidates from database query
+ * @param context - Scoring context (key, tags, layer, priority)
+ * @param options - Optional min_score and limit
+ * @returns Scored and filtered suggestions
+ */
+export function transformAndScoreDecisions(candidates, context, options) {
+    // Parse tags from GROUP_CONCAT and map to scorer format
+    const parsed = candidates.map((c) => ({
+        key_id: c.key_id,
+        key: c.key,
+        value: String(c.value), // Convert to string for scorer
+        tags: parseGroupConcatTags(c.tags),
+        layer: c.layer,
+        priority: 0, // Default priority (not stored in DB)
+        updated_ts: c.ts, // Rename ts to updated_ts for scorer
+    }));
+    // Score, filter, and limit
+    let suggestions = scoreAndRankSuggestions(context, parsed);
+    suggestions = filterDecisionsByThreshold(suggestions, options?.minScore ?? 30);
+    suggestions = limitDecisionSuggestions(suggestions, options?.limit ?? 5);
+    return suggestions;
+}
+// ============================================================================
+// Constraint Helpers
+// ============================================================================
+/**
+ * Parse constraint tags from GROUP_CONCAT result
+ *
+ * @param tags - Comma-separated tags string or null
+ * @returns Array of tag strings
+ */
+export function parseConstraintTags(tags) {
+    if (!tags)
+        return [];
+    return tags.split(',').map(t => t.trim()).filter(t => t.length > 0);
+}
+/**
+ * Transform constraint candidates and score them
+ *
+ * Consolidates the common pattern of:
+ * 1. Parse GROUP_CONCAT tags
+ * 2. Map to scorer format
+ * 3. Score constraints
+ * 4. Filter by threshold
+ * 5. Apply limit
+ *
+ * @param candidates - Raw candidates from database query
+ * @param context - Scoring context (text, tags, layer, priority)
+ * @param options - Optional min_score and limit
+ * @returns Scored and filtered constraint suggestions
+ */
+export function transformAndScoreConstraints(candidates, context, options) {
+    // Parse tags from GROUP_CONCAT and map to scorer format
+    const parsed = candidates.map((c) => ({
+        id: c.constraint_id,
+        constraint_text: c.constraint_text,
+        category: c.category,
+        tags: parseConstraintTags(c.tags),
+        layer: c.layer ?? '', // Convert null to empty string
+        priority: c.priority,
+        ts: c.ts,
+    }));
+    // Score, filter, and limit
+    let suggestions = scoreConstraints(parsed, context);
+    suggestions = filterConstraintsByThreshold(suggestions, options?.minScore ?? 30);
+    suggestions = limitConstraintSuggestions(suggestions, options?.limit ?? 5);
+    return suggestions;
+}
+//# sourceMappingURL=suggest-helpers.js.map

package/dist/utils/suggest-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-helpers.js","sourceRoot":"","sources":["../../src/utils/suggest-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,IAAI,0BAA0B,EAC/C,gBAAgB,IAAI,wBAAwB,EAG7C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,IAAI,4BAA4B,EACjD,gBAAgB,IAAI,0BAA0B,EAG/C,MAAM,wBAAwB,CAAC;AAyChC,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAA+B,EAC/B,OAA0B,EAC1B,OAA+B;IAE/B,wDAAwD;IACxD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAG,+BAA+B;QACxD,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;QAClC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,QAAQ,EAAE,CAAC,EAAG,sCAAsC;QACpD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAG,qCAAqC;KACzD,CAAC,CAAC,CAAC;IAEJ,2BAA2B;IAC3B,IAAI,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3D,WAAW,GAAG,0BAA0B,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC/E,WAAW,GAAG,wBAAwB,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IAEzE,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAsC,EACtC,OAAiC,EACjC,OAA+B;IAE/B,wDAAwD;IACxD,MAAM,MAAM,GAAuB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,EAAE,EAAE,CAAC,CAAC,aAAa;QACnB,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;QACjC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAG,+BAA+B;QACtD,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,EAAE,EAAE,CAAC,CAAC,EAAE;KACT,CAAC,CAAC,CAAC;IAEJ,2BAA2B;IAC3B,IAAI,WAAW,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,WAAW,GAAG,4BAA4B,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IACjF,WAAW,GAAG,0BAA0B,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IAE3E,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sqlew",
   "description": "Automated ADR (Architecture Decision Records) for Claude Code - MCP server with SQL-backed decision repository",
-  "version": "4.3.0",
+  "version": "4.3.1",
   "main": "dist/index.js",
   "type": "module",
   "bin": {