swift-skills-mcp 0.0.1

package/build/utils/logger.js

@@ -0,0 +1,9 @@
+import pino from 'pino';
+const logger = pino.default({
+    level: process.env.LOG_LEVEL ?? 'info',
+    base: {
+        service: 'swift-patterns-mcp',
+    },
+});
+export default logger;
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,IAAI,EAAE;QACJ,OAAO,EAAE,oBAAoB;KAC9B;CACF,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/build/utils/paths.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Get the base directory for swift-patterns-mcp configuration and data
+ * @returns The absolute path to ~/.swift-patterns-mcp directory
+ */
+export declare function getSwiftMcpDir(): string;
+/**
+ * Get the configuration file path
+ * @returns The absolute path to the config.json file
+ */
+export declare function getConfigPath(): string;
+/**
+ * Get the cache directory path
+ * @param namespace Optional namespace for cache isolation
+ * @returns The absolute path to the cache directory
+ */
+export declare function getCacheDir(namespace?: string): string;
+/**
+ * Get the Patreon content download directory
+ * @returns The absolute path to the patreon-content directory
+ */
+export declare function getPatreonContentDir(): string;
+/**
+ * Get the Patreon creators configuration path
+ * @returns The absolute path to the patreon-creators.json file
+ */
+export declare function getPatreonCreatorsPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/build/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/build/utils/paths.js

@@ -0,0 +1,43 @@
+// src/utils/paths.ts
+import path from 'path';
+/**
+ * Get the base directory for swift-patterns-mcp configuration and data
+ * @returns The absolute path to ~/.swift-patterns-mcp directory
+ */
+export function getSwiftMcpDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return path.join(home, '.swift-patterns-mcp');
+}
+/**
+ * Get the configuration file path
+ * @returns The absolute path to the config.json file
+ */
+export function getConfigPath() {
+    return path.join(getSwiftMcpDir(), 'config.json');
+}
+/**
+ * Get the cache directory path
+ * @param namespace Optional namespace for cache isolation
+ * @returns The absolute path to the cache directory
+ */
+export function getCacheDir(namespace) {
+    if (namespace) {
+        return path.join(getSwiftMcpDir(), 'cache', namespace);
+    }
+    return path.join(getSwiftMcpDir(), 'cache');
+}
+/**
+ * Get the Patreon content download directory
+ * @returns The absolute path to the patreon-content directory
+ */
+export function getPatreonContentDir() {
+    return path.join(getSwiftMcpDir(), 'patreon-content');
+}
+/**
+ * Get the Patreon creators configuration path
+ * @returns The absolute path to the patreon-creators.json file
+ */
+export function getPatreonCreatorsPath() {
+    return path.join(getSwiftMcpDir(), 'patreon-creators.json');
+}
+//# sourceMappingURL=paths.js.map

package/build/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,qBAAqB;AAErB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAkB;IAC5C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,uBAAuB,CAAC,CAAC;AAC9D,CAAC"}

package/build/utils/pattern-formatter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared utilities for formatting patterns in responses
+ */
+import type { BasePattern } from '../sources/free/rssPatternSource.js';
+export interface FormatOptions {
+    maxResults?: number;
+    includeQuality?: boolean;
+    includeTopics?: boolean;
+    includeCode?: boolean;
+    excerptLength?: number;
+    includeSnippets?: boolean;
+    includeTechniques?: boolean;
+    includeComplexity?: boolean;
+    maxSnippets?: number;
+}
+/**
+ * Common format options used by tool handlers
+ */
+export declare const COMMON_FORMAT_OPTIONS: FormatOptions;
+/**
+ * Detect if the user wants to see code examples based on args or query content
+ */
+export declare function detectCodeIntent(args: any, query: string): boolean;
+/**
+ * Format a single pattern as markdown
+ */
+export declare function formatPattern(pattern: BasePattern, options?: FormatOptions): string;
+/**
+ * Format multiple patterns as a markdown document
+ */
+export declare function formatPatterns(patterns: BasePattern[], title: string, options?: FormatOptions): string;
+/**
+ * Format patterns for topic-based queries (with quality and topics)
+ */
+export declare function formatTopicPatterns(patterns: BasePattern[], topic: string, options?: FormatOptions): string;
+/**
+ * Format patterns for general search queries
+ */
+export declare function formatSearchPatterns(patterns: BasePattern[], query: string, options?: FormatOptions): string;
+//# sourceMappingURL=pattern-formatter.d.ts.map

package/build/utils/pattern-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/pattern-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AASvE,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAcD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAMnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAoDvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAQR"}

package/build/utils/pattern-formatter.js

@@ -0,0 +1,124 @@
+/**
+ * Shared utilities for formatting patterns in responses
+ */
+import { extractCodeSnippets, extractTechniques, detectComplexity, truncateAtSentence, extractDescriptiveTitle } from './swift-analysis.js';
+const DEFAULT_OPTIONS = {
+    maxResults: 10,
+    includeQuality: false,
+    includeTopics: false,
+    includeCode: true,
+    excerptLength: 200,
+    includeSnippets: true,
+    includeTechniques: true,
+    includeComplexity: true,
+    maxSnippets: 1,
+};
+/**
+ * Common format options used by tool handlers
+ */
+export const COMMON_FORMAT_OPTIONS = {
+    maxResults: 4,
+    includeSnippets: false,
+    includeTechniques: false,
+    includeComplexity: false,
+    excerptLength: 200,
+};
+/**
+ * Detect if the user wants to see code examples based on args or query content
+ */
+export function detectCodeIntent(args, query) {
+    return Boolean(args?.includeCode) || /code|example|snippet/i.test(query);
+}
+/**
+ * Format a single pattern as markdown
+ */
+export function formatPattern(pattern, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const sourceId = pattern.id.split('-')[0];
+    // Extract descriptive title from content
+    const title = extractDescriptiveTitle(pattern.content, pattern.title);
+    let formatted = `## ${title}\n`;
+    formatted += `**Source**: ${sourceId}\n`;
+    if (opts.includeQuality) {
+        formatted += `**Quality**: ${pattern.relevanceScore}/100\n`;
+    }
+    if (opts.includeComplexity) {
+        const complexity = detectComplexity(pattern.content, pattern.topics);
+        formatted += `**Complexity**: ${complexity}\n`;
+    }
+    if (opts.includeTopics && pattern.topics.length > 0) {
+        formatted += `**Topics**: ${pattern.topics.join(', ')}\n`;
+    }
+    if (opts.includeTechniques) {
+        const techniques = extractTechniques(pattern.content);
+        if (techniques.length > 0) {
+            formatted += `**Techniques**: ${techniques.join(', ')}\n`;
+        }
+    }
+    // Show code snippets if available and requested
+    if (opts.includeSnippets && pattern.hasCode) {
+        const snippets = extractCodeSnippets(pattern.content, opts.maxSnippets);
+        if (snippets.length > 0) {
+            formatted += `\n**Code Example**:\n`;
+            snippets.forEach(snippet => {
+                formatted += '```swift\n' + snippet + '\n```\n';
+            });
+        }
+        else if (opts.includeCode) {
+            // Fallback to checkmark if no snippets extracted
+            formatted += `**Code**: ✅\n`;
+        }
+    }
+    else if (opts.includeCode && pattern.hasCode) {
+        formatted += `**Code**: ✅\n`;
+    }
+    // Use smart truncation at sentence boundaries
+    const excerpt = truncateAtSentence(pattern.excerpt, opts.excerptLength);
+    formatted += `\n${excerpt}...\n\n`;
+    formatted += `[Read more](${pattern.url})`;
+    return formatted;
+}
+/**
+ * Format multiple patterns as a markdown document
+ */
+export function formatPatterns(patterns, title, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const limited = patterns.slice(0, opts.maxResults);
+    const formatted = limited.map(p => formatPattern(p, opts)).join('\n\n---\n\n');
+    const count = patterns.length;
+    const shown = limited.length;
+    let result = `# ${title}\n\n`;
+    if (count > 0) {
+        result += `Found ${count} result${count === 1 ? '' : 's'}:\n\n`;
+    }
+    result += formatted;
+    if (count > shown) {
+        result += `\n\n*Showing top ${shown} of ${count} results*`;
+    }
+    return result;
+}
+/**
+ * Format patterns for topic-based queries (with quality and topics)
+ */
+export function formatTopicPatterns(patterns, topic, options = {}) {
+    return formatPatterns(patterns, `Swift Patterns: ${topic}`, {
+        ...options,
+        includeQuality: true,
+        includeTopics: true,
+        includeCode: true,
+        excerptLength: 300,
+    });
+}
+/**
+ * Format patterns for general search queries
+ */
+export function formatSearchPatterns(patterns, query, options = {}) {
+    return formatPatterns(patterns, `Search Results: "${query}"`, {
+        ...options,
+        includeQuality: false,
+        includeTopics: false,
+        includeCode: true,
+        excerptLength: 200,
+    });
+}
+//# sourceMappingURL=pattern-formatter.js.map

package/build/utils/pattern-formatter.js.map

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

package/build/utils/response-helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Response formatting helpers for consistent MCP tool responses
+ */
+import type { ToolResponse } from '../tools/types.js';
+/**
+ * Create a standard text response
+ */
+export declare function createTextResponse(text: string): ToolResponse;
+/**
+ * Create an error response
+ */
+export declare function createErrorResponse(message: string): ToolResponse;
+/**
+ * Create a response from an error (uses error utilities)
+ */
+export declare function createErrorResponseFromError(error: unknown): ToolResponse;
+//# sourceMappingURL=response-helpers.d.ts.map

package/build/utils/response-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/response-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAO7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAQjE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAEzE"}

package/build/utils/response-helpers.js

@@ -0,0 +1,34 @@
+/**
+ * Response formatting helpers for consistent MCP tool responses
+ */
+import { toErrorMessage } from './errors.js';
+/**
+ * Create a standard text response
+ */
+export function createTextResponse(text) {
+    return {
+        content: [{
+                type: "text",
+                text,
+            }],
+    };
+}
+/**
+ * Create an error response
+ */
+export function createErrorResponse(message) {
+    return {
+        content: [{
+                type: "text",
+                text: `Error: ${message}`,
+            }],
+        isError: true,
+    };
+}
+/**
+ * Create a response from an error (uses error utilities)
+ */
+export function createErrorResponseFromError(error) {
+    return createErrorResponse(toErrorMessage(error));
+}
+//# sourceMappingURL=response-helpers.js.map

package/build/utils/response-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-helpers.js","sourceRoot":"","sources":["../../src/utils/response-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI;aACL,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU,OAAO,EAAE;aAC1B,CAAC;QACF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,OAAO,mBAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/build/utils/search-terms.d.ts

@@ -0,0 +1,17 @@
+export declare const STOPWORDS: Set<string>;
+export declare const PRESERVE_TERMS: Set<string>;
+/**
+ * Shared token normalization logic used by both search and intent caching.
+ *
+ * - Lowercase
+ * - Strip non-word characters (keeping hyphens)
+ * - Split on whitespace
+ * - Split hyphenated terms
+ * - Filter stopwords while preserving Swift-specific terms
+ *
+ * @param text - Text to normalize
+ * @param applyTransform - Optional transform function (e.g., stemmer) applied to non-preserved terms
+ * @returns Array of normalized tokens
+ */
+export declare function normalizeTokens(text: string, applyTransform?: (token: string) => string): string[];
+//# sourceMappingURL=search-terms.d.ts.map

package/build/utils/search-terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-terms.d.ts","sourceRoot":"","sources":["../../src/utils/search-terms.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,aAUpB,CAAC;AAIH,eAAO,MAAM,cAAc,aAOzB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACzC,MAAM,EAAE,CAmCV"}

package/build/utils/search-terms.js

@@ -0,0 +1,71 @@
+// src/utils/search-terms.ts
+// Shared search-related term lists
+// Common stopwords to filter out
+export const STOPWORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
+    'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'must', 'shall', 'can', 'this', 'that', 'these',
+    'those', 'it', 'its', 'they', 'them', 'their', 'we', 'our', 'you', 'your',
+    'i', 'my', 'me', 'he', 'she', 'him', 'her', 'his', 'who', 'what', 'which',
+    'when', 'where', 'why', 'how', 'all', 'each', 'every', 'both', 'few',
+    'more', 'most', 'other', 'some', 'such', 'no', 'not', 'only', 'same',
+    'so', 'than', 'too', 'very', 'just', 'also', 'now', 'here', 'there'
+]);
+// Swift-specific terms that shouldn't be stemmed (preserve technical accuracy)
+// NOTE: If you add hyphenated terms here (e.g. "objective-c"), the tokenizer will now respect them.
+export const PRESERVE_TERMS = new Set([
+    'swift', 'swiftui', 'uikit', 'combine', 'async', 'await', 'actor',
+    'struct', 'class', 'enum', 'protocol', 'extension', 'func', 'var', 'let',
+    'mvvm', 'viper', 'mvc', 'tca', 'xctest', 'xcode', 'ios', 'macos',
+    'watchos', 'tvos', 'ipados', 'appkit', 'foundation', 'coredata',
+    'cloudkit', 'urlsession', 'codable', 'observable', 'published',
+    'stateobject', 'observedobject', 'environmentobject', 'binding', 'state'
+]);
+/**
+ * Shared token normalization logic used by both search and intent caching.
+ *
+ * - Lowercase
+ * - Strip non-word characters (keeping hyphens)
+ * - Split on whitespace
+ * - Split hyphenated terms
+ * - Filter stopwords while preserving Swift-specific terms
+ *
+ * @param text - Text to normalize
+ * @param applyTransform - Optional transform function (e.g., stemmer) applied to non-preserved terms
+ * @returns Array of normalized tokens
+ */
+export function normalizeTokens(text, applyTransform) {
+    // 1. Clean text but keep hyphens temporarily
+    const rawTokens = text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length > 0);
+    const finalTokens = [];
+    for (const token of rawTokens) {
+        // 2. Check if the full token is a preserved term (e.g., "objective-c")
+        if (PRESERVE_TERMS.has(token)) {
+            finalTokens.push(token);
+            continue;
+        }
+        // 3. If not preserved, split on hyphens to separate words like "async-await" -> "async", "await"
+        const subTokens = token.split('-');
+        for (const sub of subTokens) {
+            if (sub.length <= 1 || STOPWORDS.has(sub))
+                continue;
+            // 4. Check sub-tokens against preserved terms or apply transform
+            if (PRESERVE_TERMS.has(sub)) {
+                finalTokens.push(sub);
+            }
+            else if (applyTransform) {
+                finalTokens.push(applyTransform(sub));
+            }
+            else {
+                finalTokens.push(sub);
+            }
+        }
+    }
+    return finalTokens;
+}
+//# sourceMappingURL=search-terms.js.map

package/build/utils/search-terms.js.map

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

package/build/utils/search-terms.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-terms.test.d.ts.map

package/build/utils/search-terms.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-terms.test.d.ts","sourceRoot":"","sources":["../../src/utils/search-terms.test.ts"],"names":[],"mappings":""}

package/build/utils/search-terms.test.js

@@ -0,0 +1,107 @@
+// src/utils/search-terms.test.ts
+// Tests for shared normalization logic
+import { describe, it, expect } from 'vitest';
+import { normalizeTokens } from './search-terms.js';
+describe('normalizeTokens', () => {
+    describe('basic normalization', () => {
+        it('should lowercase text', () => {
+            const result = normalizeTokens('SwiftUI Combine');
+            expect(result).toContain('swiftui');
+            expect(result).toContain('combine');
+        });
+        it('should filter stopwords', () => {
+            const result = normalizeTokens('how to use async await');
+            expect(result).not.toContain('how');
+            expect(result).not.toContain('to');
+            expect(result).toContain('use');
+            expect(result).toContain('async');
+            expect(result).toContain('await');
+        });
+        it('should handle hyphenated terms', () => {
+            const result = normalizeTokens('async-await patterns');
+            expect(result).toContain('async');
+            expect(result).toContain('await');
+            expect(result).toContain('patterns');
+        });
+        it('should preserve Swift-specific terms', () => {
+            const result = normalizeTokens('swiftui actor protocol');
+            expect(result).toContain('swiftui');
+            expect(result).toContain('actor');
+            expect(result).toContain('protocol');
+        });
+        it('should strip non-word characters', () => {
+            const result = normalizeTokens('test@email.com (example) [brackets]');
+            // Only valid word tokens should remain
+            expect(result).not.toContain('@');
+            expect(result).not.toContain('(');
+            expect(result).not.toContain(')');
+        });
+        it('should filter short tokens', () => {
+            const result = normalizeTokens('a b swift ui');
+            expect(result).not.toContain('a');
+            expect(result).not.toContain('b');
+            expect(result).toContain('swift');
+        });
+    });
+    describe('with transform function', () => {
+        it('should apply transform to non-preserved terms', () => {
+            const mockStemmer = (token) => token + '_stem';
+            const result = normalizeTokens('testing patterns', mockStemmer);
+            // "patterns" should be stemmed
+            expect(result).toContain('patterns_stem');
+        });
+        it('should not apply transform to preserved terms', () => {
+            const mockStemmer = (token) => token + '_stem';
+            const result = normalizeTokens('swiftui patterns', mockStemmer);
+            // "swiftui" should NOT be stemmed
+            expect(result).toContain('swiftui');
+            expect(result).not.toContain('swiftui_stem');
+            // "patterns" should be stemmed
+            expect(result).toContain('patterns_stem');
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle empty string', () => {
+            const result = normalizeTokens('');
+            expect(result).toEqual([]);
+        });
+        it('should handle only stopwords', () => {
+            const result = normalizeTokens('the and or but');
+            expect(result).toEqual([]);
+        });
+        it('should handle whitespace-only', () => {
+            const result = normalizeTokens('   \t\n   ');
+            expect(result).toEqual([]);
+        });
+        it('should handle mixed case preserved terms', () => {
+            const result = normalizeTokens('SwiftUI ASYNC Await');
+            expect(result).toContain('swiftui');
+            expect(result).toContain('async');
+            expect(result).toContain('await');
+        });
+    });
+    describe('consistency with IntentCache and search', () => {
+        it('should produce same tokens for query normalization (without transform)', () => {
+            const query = 'how to use async-await with SwiftUI';
+            const result = normalizeTokens(query);
+            // Should contain: use, async, await, swiftui (sorted elsewhere)
+            expect(result).toContain('use');
+            expect(result).toContain('async');
+            expect(result).toContain('await');
+            expect(result).toContain('swiftui');
+            // Should NOT contain stopwords
+            expect(result).not.toContain('how');
+            expect(result).not.toContain('to');
+            expect(result).not.toContain('with');
+        });
+        it('should handle technical terms consistently', () => {
+            const query = 'mvvm architecture objective-c';
+            const result = normalizeTokens(query);
+            expect(result).toContain('mvvm');
+            expect(result).toContain('architecture');
+            expect(result).toContain('objective'); // Split from hyphen
+            expect(result).not.toContain('c'); // Filtered as <= 1 char
+        });
+    });
+});
+//# sourceMappingURL=search-terms.test.js.map

package/build/utils/search-terms.test.js.map

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

package/build/utils/search.d.ts

@@ -0,0 +1,48 @@
+export interface SearchableDocument {
+    id: string;
+    title: string;
+    content: string;
+    topics: string[];
+}
+export interface SearchResult<T> {
+    item: T;
+    score: number;
+    matches: string[];
+}
+export interface SearchOptions {
+    fuzzy?: number;
+    boost?: Record<string, number>;
+    minScore?: number;
+}
+export declare class SearchIndex<T extends SearchableDocument> {
+    private miniSearch;
+    private documents;
+    constructor(fields?: string[]);
+    addDocuments(docs: T[]): void;
+    search(query: string, options?: SearchOptions): SearchResult<T>[];
+    private findMatches;
+}
+export declare function fuzzySearch<T extends SearchableDocument>(documents: T[], query: string, options?: SearchOptions): SearchResult<T>[];
+export declare function combineScores(searchScore: number, staticRelevance: number, searchWeight?: number): number;
+export declare function suggestSimilar(query: string, knownTerms: string[], maxSuggestions?: number): string[];
+/**
+ * CachedSearchIndex - Manages a SearchIndex with automatic invalidation based on document changes.
+ * Eliminates duplicated search caching logic across pattern sources.
+ */
+export declare class CachedSearchIndex<T extends SearchableDocument> {
+    private searchIndex;
+    private indexedPatternsHash;
+    private fields;
+    constructor(fields?: string[]);
+    /**
+     * Search patterns with automatic index caching.
+     * Index is rebuilt only when patterns change (detected via hash).
+     */
+    search(patterns: T[], query: string, options?: SearchOptions): T[];
+    /**
+     * Invalidate the cached index (call after fetching new patterns)
+     */
+    invalidate(): void;
+}
+export default SearchIndex;
+//# sourceMappingURL=search.d.ts.map

package/build/utils/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/utils/search.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,qBAAa,WAAW,CAAC,CAAC,SAAS,kBAAkB;IACnD,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,SAAS,CAA6B;gBAElC,MAAM,GAAE,MAAM,EAAmC;IAc7D,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IAmB7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE;IAqCrE,OAAO,CAAC,WAAW;CAapB;AAGD,wBAAgB,WAAW,CAAC,CAAC,SAAS,kBAAkB,EACtD,SAAS,EAAE,CAAC,EAAE,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAAC,CAAC,CAAC,EAAE,CAInB;AAGD,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,YAAY,GAAE,MAAY,GACzB,MAAM,CASR;AAGD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,cAAc,GAAE,MAAU,GACzB,MAAM,EAAE,CAeV;AAED;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,kBAAkB;IACzD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,GAAE,MAAM,EAAmC;IAI7D;;;OAGG;IACH,MAAM,CACJ,QAAQ,EAAE,CAAC,EAAE,EACb,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,CAAC,EAAE;IA0BN;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB;AAED,eAAe,WAAW,CAAC"}