sqlew 4.3.0 → 5.0.0

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

@@ -0,0 +1,95 @@
+/**
+ * Queue list action
+ *
+ * Lists all pending items in the hook queue (both pending and failed)
+ *
+ * @since v5.0.0
+ */
+import { readQueue, getQueuePath, readFailedQueue, getFailedQueuePath, } from '../../../utils/hook-queue.js';
+/**
+ * List all items in the queue (pending and failed)
+ *
+ * @param projectPath - Project root path
+ * @returns Queue items with metadata
+ */
+export function listQueue(projectPath, _params) {
+    const queue = readQueue(projectPath);
+    const queuePath = getQueuePath(projectPath);
+    const items = queue.items
+        // Filter out invalid items (defensive parsing)
+        .filter((item) => item != null && typeof item.type === 'string')
+        .map((item, index) => {
+        if (item.type === 'decision') {
+            const decisionItem = item;
+            return {
+                index,
+                type: 'decision',
+                action: decisionItem.action,
+                timestamp: decisionItem.timestamp,
+                key: decisionItem.data?.key,
+                layer: decisionItem.data?.layer,
+                tags: decisionItem.data?.tags,
+            };
+        }
+        else {
+            const constraintItem = item;
+            return {
+                index,
+                type: 'constraint',
+                action: constraintItem.action,
+                timestamp: constraintItem.timestamp,
+                text: constraintItem.data?.text,
+                layer: constraintItem.data?.layer,
+                tags: constraintItem.data?.tags,
+            };
+        }
+    });
+    // Also read failed queue
+    const failedQueue = readFailedQueue(projectPath);
+    const failedQueuePath = getFailedQueuePath(projectPath);
+    const failedItems = failedQueue.items
+        // Filter out invalid items (defensive parsing)
+        .filter((failedItem) => failedItem != null &&
+        failedItem.item != null &&
+        typeof failedItem.item.type === 'string')
+        .map((failedItem, index) => {
+        const item = failedItem.item;
+        if (item.type === 'decision') {
+            const decisionItem = item;
+            return {
+                index,
+                type: 'decision',
+                action: decisionItem.action,
+                timestamp: decisionItem.timestamp,
+                key: decisionItem.data?.key,
+                error: failedItem.error,
+                failedAt: failedItem.failedAt,
+            };
+        }
+        else {
+            const constraintItem = item;
+            return {
+                index,
+                type: 'constraint',
+                action: constraintItem.action,
+                timestamp: constraintItem.timestamp,
+                text: constraintItem.data?.text,
+                error: failedItem.error,
+                failedAt: failedItem.failedAt,
+            };
+        }
+    });
+    const response = {
+        items,
+        count: items.length,
+        queuePath,
+    };
+    // Only include failed info if there are failed items
+    if (failedItems.length > 0) {
+        response.failedItems = failedItems;
+        response.failedCount = failedItems.length;
+        response.failedQueuePath = failedQueuePath;
+    }
+    return response;
+}
+//# sourceMappingURL=list.js.map

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

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

package/dist/tools/queue/actions/remove.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Queue remove action
+ *
+ * Removes a specific item from the hook queue by index
+ *
+ * @since v5.0.0
+ */
+import type { RemoveQueueParams, RemoveQueueResponse } from '../types.js';
+/**
+ * Remove a specific item from the queue
+ *
+ * Uses lock mechanism to prevent race conditions with QueueWatcher
+ *
+ * @param projectPath - Project root path
+ * @param params - Remove parameters (index required)
+ * @returns Remove result with removed item info
+ */
+export declare function removeFromQueue(projectPath: string, params: RemoveQueueParams): RemoveQueueResponse;
+//# sourceMappingURL=remove.d.ts.map

package/dist/tools/queue/actions/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/actions/remove.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAmEnG"}

package/dist/tools/queue/actions/remove.js

@@ -0,0 +1,81 @@
+/**
+ * Queue remove action
+ *
+ * Removes a specific item from the hook queue by index
+ *
+ * @since v5.0.0
+ */
+import { readQueue, writeQueue, tryAcquireLock, releaseLock, } from '../../../utils/hook-queue.js';
+/**
+ * Remove a specific item from the queue
+ *
+ * Uses lock mechanism to prevent race conditions with QueueWatcher
+ *
+ * @param projectPath - Project root path
+ * @param params - Remove parameters (index required)
+ * @returns Remove result with removed item info
+ */
+export function removeFromQueue(projectPath, params) {
+    const { index } = params;
+    // Validate index
+    if (typeof index !== 'number' || index < 0) {
+        return {
+            success: false,
+            removed: null,
+            remainingCount: -1,
+            message: `Invalid index: ${index}. Index must be a non-negative number.`,
+        };
+    }
+    // Acquire lock to prevent race conditions
+    if (!tryAcquireLock(projectPath)) {
+        return {
+            success: false,
+            removed: null,
+            remainingCount: -1,
+            message: 'Cannot remove item: another process is currently processing the queue. Please try again.',
+        };
+    }
+    try {
+        const queue = readQueue(projectPath);
+        // Check if index is valid
+        if (index >= queue.items.length) {
+            return {
+                success: false,
+                removed: null,
+                remainingCount: queue.items.length,
+                message: `Index ${index} is out of range. Queue has ${queue.items.length} item(s) (valid indices: 0-${queue.items.length - 1}).`,
+            };
+        }
+        // Remove the item
+        const removedItem = queue.items.splice(index, 1)[0];
+        writeQueue(projectPath, queue, 'queueTool_remove');
+        // Format removed item for response
+        let removed;
+        if (removedItem.type === 'decision') {
+            const decisionItem = removedItem;
+            removed = {
+                type: 'decision',
+                action: decisionItem.action,
+                key: decisionItem.data.key,
+            };
+        }
+        else {
+            const constraintItem = removedItem;
+            removed = {
+                type: 'constraint',
+                action: constraintItem.action,
+                text: constraintItem.data.text,
+            };
+        }
+        return {
+            success: true,
+            removed,
+            remainingCount: queue.items.length,
+            message: `Successfully removed item at index ${index}. ${queue.items.length} item(s) remaining.`,
+        };
+    }
+    finally {
+        releaseLock(projectPath);
+    }
+}
+//# sourceMappingURL=remove.js.map

package/dist/tools/queue/actions/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../src/tools/queue/actions/remove.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,SAAS,EACT,UAAU,EACV,cAAc,EACd,WAAW,GAGZ,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,MAAyB;IAC5E,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAEzB,iBAAiB;IACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,CAAC,CAAC;YAClB,OAAO,EAAE,kBAAkB,KAAK,wCAAwC;SACzE,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,CAAC,CAAC;YAClB,OAAO,EAAE,0FAA0F;SACpG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QAErC,0BAA0B;QAC1B,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;gBAClC,OAAO,EAAE,SAAS,KAAK,+BAA+B,KAAK,CAAC,KAAK,CAAC,MAAM,8BAA8B,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI;aACjI,CAAC;QACJ,CAAC;QAED,kBAAkB;QAClB,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,UAAU,CAAC,WAAW,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;QAEnD,mCAAmC;QACnC,IAAI,OAAuC,CAAC;QAC5C,IAAI,WAAW,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,YAAY,GAAG,WAAgC,CAAC;YACtD,OAAO,GAAG;gBACR,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,YAAY,CAAC,MAAM;gBAC3B,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG;aAC3B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,cAAc,GAAG,WAAkC,CAAC;YAC1D,OAAO,GAAG;gBACR,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI;aAC/B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;YAClC,OAAO,EAAE,sCAAsC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,qBAAqB;SACjG,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,WAAW,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Queue tool - Barrel export
+ *
+ * Manages the hook queue file (.sqlew/queue/pending.json)
+ * Help documentation is loaded from src/help-data/queue.toml
+ *
+ * @since v5.0.0
+ */
+export { listQueue } from './actions/list.js';
+export { clearQueue } from './actions/clear.js';
+export { removeFromQueue } from './actions/remove.js';
+export type { QueueToolAction, ListQueueParams, ListQueueResponse, ClearQueueParams, ClearQueueResponse, RemoveQueueParams, RemoveQueueResponse, QueueItem, QueueFile, DecisionQueueItem, ConstraintQueueItem, FailedQueueItem, FailedQueueFile, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/tools/queue/index.js

@@ -0,0 +1,13 @@
+/**
+ * Queue tool - Barrel export
+ *
+ * Manages the hook queue file (.sqlew/queue/pending.json)
+ * Help documentation is loaded from src/help-data/queue.toml
+ *
+ * @since v5.0.0
+ */
+// Action exports
+export { listQueue } from './actions/list.js';
+export { clearQueue } from './actions/clear.js';
+export { removeFromQueue } from './actions/remove.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iBAAiB;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,87 @@
+/**
+ * Queue tool types
+ *
+ * Types for managing the hook queue file (.sqlew/queue/pending.json)
+ *
+ * @since v5.0.0
+ */
+export type { QueueItem, QueueFile, DecisionQueueItem, ConstraintQueueItem, QueueAction, FailedQueueItem, FailedQueueFile, } from '../../utils/hook-queue.js';
+/**
+ * Queue tool action types
+ */
+export type QueueToolAction = 'list' | 'clear' | 'remove' | 'help' | 'example';
+/**
+ * List action params (no params needed)
+ */
+export interface ListQueueParams {
+    projectPath?: string;
+}
+/**
+ * List action response
+ */
+export interface ListQueueResponse {
+    items: Array<{
+        index: number;
+        type: 'decision' | 'constraint';
+        action: string;
+        timestamp: string;
+        key?: string;
+        text?: string;
+        layer?: string;
+        tags?: string[];
+    }>;
+    count: number;
+    queuePath: string;
+    /** Failed items that could not be processed */
+    failedItems?: Array<{
+        index: number;
+        type: 'decision' | 'constraint';
+        action: string;
+        timestamp: string;
+        key?: string;
+        text?: string;
+        error: string;
+        failedAt: string;
+    }>;
+    failedCount?: number;
+    failedQueuePath?: string;
+}
+/**
+ * Clear action params
+ */
+export interface ClearQueueParams {
+    projectPath?: string;
+    confirm?: boolean;
+    /** Target queue to clear: 'pending' (default), 'failed', or 'all' */
+    target?: 'pending' | 'failed' | 'all';
+}
+/**
+ * Clear action response
+ */
+export interface ClearQueueResponse {
+    success: boolean;
+    cleared: number;
+    message: string;
+}
+/**
+ * Remove action params
+ */
+export interface RemoveQueueParams {
+    index: number;
+    projectPath?: string;
+}
+/**
+ * Remove action response
+ */
+export interface RemoveQueueResponse {
+    success: boolean;
+    removed: {
+        type: 'decision' | 'constraint';
+        action: string;
+        key?: string;
+        text?: string;
+    } | null;
+    remainingCount: number;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/queue/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,IAAI,CAAC;IACT,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/tools/queue/types.js

@@ -0,0 +1,9 @@
+/**
+ * Queue tool types
+ *
+ * Types for managing the hook queue file (.sqlew/queue/pending.json)
+ *
+ * @since v5.0.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/tools/suggest/actions/by-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"by-context.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAKjC,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAqDxF"}
+{"version":3,"file":"by-context.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAKjC,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CA6CxF"}

package/dist/tools/suggest/actions/by-context.js

@@ -5,8 +5,7 @@
  * Used by auto-trigger suggestions feature.
  */
 import { getAdapter } from '../../../database/index.js';
-import { parseGroupConcatTags } from '../../../utils/tag-parser.js';
-import { scoreAndRankSuggestions, filterByThreshold, limitSuggestions } from '../../../utils/suggestion-scorer.js';
+import { transformAndScoreDecisions } from '../../../utils/suggest-helpers.js';
 import { buildContextQuery } from '../internal/queries.js';
 /**
  * Suggest by full context (hybrid scoring)
@@ -25,16 +24,6 @@ export async function suggestByContext(params) {
     const knex = params.knex || getAdapter().getKnex();
     // Build and execute context query (exclude current key to prevent self-suggestion)
     const candidates = await buildContextQuery(knex, params.tags, params.key);
-    // Parse tags from GROUP_CONCAT and add defaults for scorer
-    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 and rank with full context
     const context = {
         key: params.key,
@@ -42,9 +31,12 @@ export async function suggestByContext(params) {
         layer: params.layer,
         priority: params.priority,
     };
-    let suggestions = scoreAndRankSuggestions(context, parsed);
-    suggestions = filterByThreshold(suggestions, params.min_score ?? 30);
-    suggestions = limitSuggestions(suggestions, params.limit ?? 5);
+    // Use lower default threshold (20) for context searches without tags/layer
+    // Key similarity max is 20 points, so default 30 may filter valid matches
+    const suggestions = transformAndScoreDecisions(candidates, context, {
+        minScore: params.min_score ?? 20,
+        limit: params.limit,
+    });
     return {
         query: {
             key: params.key,

package/dist/tools/suggest/actions/by-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"by-context.js","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gBAAgB,EAA0B,MAAM,qCAAqC,CAAC;AAC3I,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAa3D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAuB;IAC5D,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,yDAAyD;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC;IAEnD,mFAAmF;IACnF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAwB,CAAC;IAEjG,2DAA2D;IAC3D,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,mCAAmC;IACnC,MAAM,OAAO,GAAsB;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IAEF,IAAI,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3D,WAAW,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrE,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAE/D,OAAO;QACL,KAAK,EAAE;YACL,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B;QACD,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAG,yCAAyC;YACxD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAG,0CAA0C;YAC3D,EAAE,EAAE,CAAC,CAAC,UAAU,EAAG,qCAAqC;SACzD,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"by-context.js","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAa3D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAuB;IAC5D,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,yDAAyD;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC;IAEnD,mFAAmF;IACnF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAwB,CAAC;IAEjG,mCAAmC;IACnC,MAAM,OAAO,GAAsB;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IAEF,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,WAAW,GAAG,0BAA0B,CAAC,UAAU,EAAE,OAAO,EAAE;QAClE,QAAQ,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE;YACL,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B;QACD,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAG,yCAAyC;YACxD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAG,0CAA0C;YAC3D,EAAE,EAAE,CAAC,CAAC,UAAU,EAAG,qCAAqC;SACzD,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/tools/suggest/actions/by-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"by-key.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CA2ChF"}
+{"version":3,"file":"by-key.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAmChF"}

package/dist/tools/suggest/actions/by-key.js

@@ -5,8 +5,7 @@
  * to find similar decision keys.
  */
 import { getAdapter } from '../../../database/index.js';
-import { parseGroupConcatTags } from '../../../utils/tag-parser.js';
-import { scoreAndRankSuggestions, filterByThreshold, limitSuggestions } from '../../../utils/suggestion-scorer.js';
+import { transformAndScoreDecisions } from '../../../utils/suggest-helpers.js';
 import { buildDecisionQuery } from '../internal/queries.js';
 /**
  * Suggest decisions by key pattern similarity
@@ -22,24 +21,17 @@ export async function suggestByKey(params) {
     const knex = adapter.getKnex();
     // Fetch candidate decisions (all active decisions)
     const candidates = await buildDecisionQuery(knex);
-    // Parse tags from GROUP_CONCAT and add defaults for scorer
-    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 and rank based on key similarity
     const context = {
         key: params.key,
         tags: [],
     };
-    let suggestions = scoreAndRankSuggestions(context, parsed);
-    suggestions = filterByThreshold(suggestions, params.min_score ?? 30);
-    suggestions = limitSuggestions(suggestions, params.limit ?? 5);
+    // Use lower default threshold (20) for key-only searches
+    // Key similarity max is 20 points, so default 30 would never match
+    const suggestions = transformAndScoreDecisions(candidates, context, {
+        minScore: params.min_score ?? 20,
+        limit: params.limit,
+    });
     return {
         query_key: params.key,
         count: suggestions.length,

package/dist/tools/suggest/actions/by-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"by-key.js","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gBAAgB,EAA0B,MAAM,qCAAqC,CAAC;AAC3I,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAS5D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAmB;IACpD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAE/B,mDAAmD;IACnD,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAwB,CAAC;IAEzE,2DAA2D;IAC3D,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,yCAAyC;IACzC,MAAM,OAAO,GAAsB;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,IAAI,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3D,WAAW,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrE,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAE/D,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,GAAG;QACrB,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,eAAe,EAAE,CAAC,CAAC,eAAe;SACnC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"by-key.js","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAS5D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAmB;IACpD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAE/B,mDAAmD;IACnD,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAwB,CAAC;IAEzE,yCAAyC;IACzC,MAAM,OAAO,GAAsB;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,yDAAyD;IACzD,mEAAmE;IACnE,MAAM,WAAW,GAAG,0BAA0B,CAAC,UAAU,EAAE,OAAO,EAAE;QAClE,QAAQ,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,GAAG;QACrB,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,eAAe,EAAE,CAAC,CAAC,eAAe;SACnC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/tools/suggest/actions/by-tags.d.ts

@@ -1,7 +1,7 @@
 /**
  * Suggest by Tag Overlap
  *
- * Fast query using v4_tag_index denormalized table
+ * Fast query using t_tag_index denormalized table
  * for efficient tag matching.
  */
 import type { SuggestResponse } from '../types.js';
@@ -14,7 +14,7 @@ export interface ByTagsParams {
 /**
  * Suggest decisions by tag overlap
  *
- * Uses v4_tag_index for fast tag lookups.
+ * Uses t_tag_index for fast tag lookups.
  *
  * @param params - Parameters with tags to match
  * @returns Suggestions ranked by tag overlap and similarity

package/dist/tools/suggest/actions/by-tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"by-tags.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA8ClF"}
+{"version":3,"file":"by-tags.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAoClF"}

package/dist/tools/suggest/actions/by-tags.js

@@ -1,17 +1,16 @@
 /**
  * Suggest by Tag Overlap
  *
- * Fast query using v4_tag_index denormalized table
+ * Fast query using t_tag_index denormalized table
  * for efficient tag matching.
  */
 import { getAdapter } from '../../../database/index.js';
-import { parseGroupConcatTags } from '../../../utils/tag-parser.js';
-import { scoreAndRankSuggestions, filterByThreshold, limitSuggestions } from '../../../utils/suggestion-scorer.js';
+import { transformAndScoreDecisions } from '../../../utils/suggest-helpers.js';
 import { buildTagIndexQuery } from '../internal/queries.js';
 /**
  * Suggest decisions by tag overlap
  *
- * Uses v4_tag_index for fast tag lookups.
+ * Uses t_tag_index for fast tag lookups.
  *
  * @param params - Parameters with tags to match
  * @returns Suggestions ranked by tag overlap and similarity
@@ -24,27 +23,18 @@ export async function suggestByTags(params) {
     const knex = adapter.getKnex();
     // Build and execute tag index query
     const candidates = await buildTagIndexQuery(knex, params.tags, params.layer);
-    // Parse tags from GROUP_CONCAT and add defaults for scorer
-    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 and rank based on tag overlap
     const context = {
         key: '',
         tags: params.tags,
         layer: params.layer,
     };
-    let suggestions = scoreAndRankSuggestions(context, parsed);
     // Lower default min_score for tag searches - tag matches are inherently valuable
-    // since we're filtering by v4_tag_index first
-    suggestions = filterByThreshold(suggestions, params.min_score ?? 15);
-    suggestions = limitSuggestions(suggestions, params.limit ?? 5);
+    // since we're filtering by t_tag_index first
+    const suggestions = transformAndScoreDecisions(candidates, context, {
+        minScore: params.min_score ?? 15, // Lower threshold for tag-based searches
+        limit: params.limit,
+    });
     return {
         query_tags: params.tags,
         count: suggestions.length,

package/dist/tools/suggest/actions/by-tags.js.map

@@ -1 +1 @@
-{"version":3,"file":"by-tags.js","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gBAAgB,EAA0B,MAAM,qCAAqC,CAAC;AAC3I,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAU5D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAoB;IACtD,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAE/B,oCAAoC;IACpC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAwB,CAAC;IAEpG,2DAA2D;IAC3D,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,sCAAsC;IACtC,MAAM,OAAO,GAAsB;QACjC,GAAG,EAAE,EAAE;QACP,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;IAEF,IAAI,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3D,iFAAiF;IACjF,8CAA8C;IAC9C,WAAW,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrE,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAE/D,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,eAAe,EAAE,CAAC,CAAC,eAAe;SACnC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"by-tags.js","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/by-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAU5D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAoB;IACtD,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAE/B,oCAAoC;IACpC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAwB,CAAC;IAEpG,sCAAsC;IACtC,MAAM,OAAO,GAAsB;QACjC,GAAG,EAAE,EAAE;QACP,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;IAEF,iFAAiF;IACjF,6CAA6C;IAC7C,MAAM,WAAW,GAAG,0BAA0B,CAAC,UAAU,EAAE,OAAO,EAAE;QAClE,QAAQ,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAG,yCAAyC;QAC5E,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,eAAe,EAAE,CAAC,CAAC,eAAe;SACnC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/tools/suggest/actions/constraint-by-context.d.ts

@@ -5,7 +5,7 @@
  * Most comprehensive search for finding related constraints.
  */
 import type { Knex } from 'knex';
-import { type ScoreBreakdown } from '../../../utils/constraint-scorer.js';
+import type { ScoreBreakdown } from '../../../utils/constraint-scorer.js';
 /**
  * Parameters for constraint by context search
  */

package/dist/tools/suggest/actions/constraint-by-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-by-context.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/constraint-by-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAOjC,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CA8DpC"}
+{"version":3,"file":"constraint-by-context.d.ts","sourceRoot":"","sources":["../../../../src/tools/suggest/actions/constraint-by-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAUjC,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAuDpC"}

package/dist/tools/suggest/actions/constraint-by-context.js

@@ -5,8 +5,8 @@
  * Most comprehensive search for finding related constraints.
  */
 import { getAdapter } from '../../../database/index.js';
-import { buildConstraintQuery, parseConstraintTags, } from '../internal/constraint-queries.js';
-import { scoreConstraints, filterByThreshold, limitSuggestions, } from '../../../utils/constraint-scorer.js';
+import { buildConstraintQuery, } from '../internal/constraint-queries.js';
+import { transformAndScoreConstraints, } from '../../../utils/suggest-helpers.js';
 /**
  * Suggest constraints by full context (hybrid scoring)
  *
@@ -38,16 +38,6 @@ export async function constraintByContext(params) {
         query = query.where('l.name', params.layer);
     }
     const candidates = (await query);
-    // Transform candidates for scorer (parse tags from GROUP_CONCAT)
-    const parsed = candidates.map((c) => ({
-        id: c.constraint_id,
-        constraint_text: c.constraint_text,
-        category: c.category,
-        tags: parseConstraintTags(c.tags),
-        layer: c.layer,
-        priority: c.priority,
-        ts: c.ts,
-    }));
     // Score constraints with full context
     const context = {
         text: params.text ?? '',
@@ -55,9 +45,12 @@ export async function constraintByContext(params) {
         layer: params.layer,
         priority: params.priority,
     };
-    let suggestions = scoreConstraints(parsed, context);
-    suggestions = filterByThreshold(suggestions, params.min_score ?? 30);
-    suggestions = limitSuggestions(suggestions, params.limit ?? 5);
+    const suggestions = transformAndScoreConstraints(candidates, context, {
+        minScore: params.min_score,
+        limit: params.limit,
+    });
+    // Map to include ts from original candidates
+    const candidateMap = new Map(candidates.map(c => [c.constraint_id, c.ts]));
     return {
         query: {
             text: params.text,
@@ -75,7 +68,7 @@ export async function constraintByContext(params) {
             score_breakdown: s.score_breakdown,
             layer: s.layer,
             tags: s.tags,
-            ts: parsed.find((p) => p.id === s.id)?.ts,
+            ts: candidateMap.get(s.id),
         })),
     };
 }