@neurcode-ai/cli 0.8.0 → 0.8.2

package/dist/utils/RelevanceScorer.js

@@ -0,0 +1,239 @@
+"use strict";
+/**
+ * RelevanceScorer
+ *
+ * High-performance BM25-inspired keyword matching algorithm for filtering
+ * exported tools based on user intent. Runs in milliseconds without requiring
+ * vector databases or embeddings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTopKTools = getTopKTools;
+// Common stop words to filter from intent
+const STOP_WORDS = new Set([
+    'a', 'an', 'and', 'are', 'as', 'at', 'be', 'by', 'for', 'from',
+    'has', 'he', 'in', 'is', 'it', 'its', 'of', 'on', 'that', 'the',
+    'to', 'was', 'will', 'with', 'the', 'this', 'but', 'they', 'have',
+    'had', 'what', 'said', 'each', 'which', 'their', 'time', 'if',
+    'up', 'out', 'many', 'then', 'them', 'these', 'so', 'some', 'her',
+    'would', 'make', 'like', 'into', 'him', 'has', 'two', 'more', 'very',
+    'after', 'words', 'long', 'than', 'first', 'been', 'call', 'who',
+    'oil', 'sit', 'now', 'find', 'down', 'day', 'did', 'get', 'come',
+    'made', 'may', 'part'
+]);
+/**
+ * Clean and tokenize intent text
+ */
+function tokenizeIntent(intent) {
+    return intent
+        .toLowerCase()
+        .replace(/[^\w\s]/g, ' ') // Remove punctuation
+        .split(/\s+/)
+        .filter(word => word.length > 2 && !STOP_WORDS.has(word));
+}
+/**
+ * Extract folder names from file path
+ * e.g., "src/services/auth/validator.ts" -> ["src", "services", "auth"]
+ */
+function extractFolderNames(filePath) {
+    const parts = filePath.split('/');
+    return parts.slice(0, -1); // Remove filename, keep folders
+}
+/**
+ * Check if a word appears in export name (case-insensitive)
+ */
+function fuzzyMatch(word, exportName) {
+    const lowerExport = exportName.toLowerCase();
+    const lowerWord = word.toLowerCase();
+    // Direct substring match
+    if (lowerExport.includes(lowerWord))
+        return true;
+    // CamelCase split match (e.g., "validateAuth" matches "auth")
+    const camelCaseParts = exportName.split(/(?=[A-Z])/).map(p => p.toLowerCase());
+    return camelCaseParts.some(part => part.includes(lowerWord));
+}
+/**
+ * Calculate relevance score for an export item
+ */
+function calculateScore(exportItem, intentTokens) {
+    let score = 0;
+    const exportName = exportItem.name.toLowerCase();
+    const filePath = exportItem.filePath.toLowerCase();
+    // Direct Match: +10 if export name appears exactly in intent
+    for (const token of intentTokens) {
+        if (exportName === token) {
+            score += 10;
+            break; // Only count once
+        }
+    }
+    // Fuzzy Match: +5 if a word in intent matches part of export name
+    for (const token of intentTokens) {
+        if (fuzzyMatch(token, exportItem.name)) {
+            score += 5;
+            break; // Only count once per token
+        }
+    }
+    // Path Match: +3 if folder name matches intent
+    const folderNames = extractFolderNames(exportItem.filePath);
+    for (const folder of folderNames) {
+        const lowerFolder = folder.toLowerCase();
+        for (const token of intentTokens) {
+            if (lowerFolder.includes(token) || token.includes(lowerFolder)) {
+                score += 3;
+                break; // Only count once per folder
+            }
+        }
+    }
+    // Type Weighting: Functions > Classes > Interfaces/Types
+    switch (exportItem.type) {
+        case 'function':
+            score += 2; // Functions are most actionable
+            break;
+        case 'class':
+            score += 1; // Classes are actionable
+            break;
+        case 'interface':
+        case 'type':
+            score += 0; // Interfaces/types are less actionable
+            break;
+        case 'const':
+        case 'variable':
+            score += 0.5; // Constants can be useful
+            break;
+        default:
+            score += 0;
+    }
+    return score;
+}
+/**
+ * Core Guard: Always include these essential tools regardless of relevance
+ */
+const CORE_TOOLS = new Set([
+    'plan',
+    'verify',
+    'apply',
+    'check',
+    'generate',
+    'create',
+    'update',
+    'delete',
+    'save',
+    'load',
+    'init',
+    'config',
+    'help'
+]);
+/**
+ * Check if an export is a core tool that should always be included
+ */
+function isCoreTool(exportItem) {
+    const name = exportItem.name.toLowerCase();
+    // Check exact match
+    if (CORE_TOOLS.has(name))
+        return true;
+    // Check if name contains core tool (e.g., "generatePlan" contains "plan")
+    for (const coreTool of CORE_TOOLS) {
+        if (name.includes(coreTool) || coreTool.includes(name)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Get Top-K most relevant tools based on user intent
+ *
+ * @param intent - User's intent/query
+ * @param exports - All available exports
+ * @param k - Number of top results to return (default: 20)
+ * @returns Filtered and sorted array of ExportItems
+ */
+function getTopKTools(intent, exports, k = 20) {
+    if (!intent || intent.trim().length === 0) {
+        // If no intent, return top K by type priority (functions first)
+        return exports
+            .sort((a, b) => {
+            const typePriority = {
+                'function': 3,
+                'class': 2,
+                'const': 1,
+                'interface': 0,
+                'type': 0,
+                'variable': 0,
+                'enum': 0,
+                'namespace': 0,
+                'default': 0,
+                'unknown': 0
+            };
+            return (typePriority[b.type] || 0) - (typePriority[a.type] || 0);
+        })
+            .slice(0, k);
+    }
+    // Tokenize intent
+    const intentTokens = tokenizeIntent(intent);
+    if (intentTokens.length === 0) {
+        // If intent has no meaningful tokens, return top K by type
+        return exports
+            .sort((a, b) => {
+            const typePriority = {
+                'function': 3,
+                'class': 2,
+                'const': 1,
+                'interface': 0,
+                'type': 0
+            };
+            return (typePriority[b.type] || 0) - (typePriority[a.type] || 0);
+        })
+            .slice(0, k);
+    }
+    // Score all exports
+    const scoredExports = exports.map(exp => ({
+        export: exp,
+        score: calculateScore(exp, intentTokens),
+        isCore: isCoreTool(exp)
+    }));
+    // Separate core tools and regular exports
+    const coreTools = scoredExports.filter(item => item.isCore);
+    const regularExports = scoredExports.filter(item => !item.isCore);
+    // Sort regular exports by score (descending)
+    regularExports.sort((a, b) => {
+        if (b.score !== a.score) {
+            return b.score - a.score;
+        }
+        // Tie-breaker: prefer functions
+        const typePriority = {
+            'function': 3,
+            'class': 2,
+            'const': 1,
+            'interface': 0,
+            'type': 0
+        };
+        return (typePriority[b.export.type] || 0) - (typePriority[a.export.type] || 0);
+    });
+    // Combine: core tools first, then top-scoring regular exports
+    const coreToolItems = coreTools.map(item => item.export);
+    const topRegularExports = regularExports
+        .slice(0, Math.max(0, k - coreToolItems.length))
+        .map(item => item.export);
+    // Remove duplicates (in case a core tool also scored high)
+    const seen = new Set();
+    const result = [];
+    for (const exp of [...coreToolItems, ...topRegularExports]) {
+        const key = `${exp.filePath}:${exp.name}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(exp);
+        }
+    }
+    // If we still need more items, fill with highest-scoring remaining
+    if (result.length < k) {
+        const remaining = regularExports
+            .filter(item => {
+            const key = `${item.export.filePath}:${item.export.name}`;
+            return !seen.has(key);
+        })
+            .slice(0, k - result.length)
+            .map(item => item.export);
+        result.push(...remaining);
+    }
+    return result.slice(0, k);
+}
+//# sourceMappingURL=RelevanceScorer.js.map

package/dist/utils/RelevanceScorer.js.map

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

package/dist/utils/tier.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tier Utility
+ *
+ * Fetches and caches user tier to minimize API latency.
+ * Caches tier in .neurcode/config.json for the session.
+ */
+export type UserTier = 'FREE' | 'PRO';
+/**
+ * Get user tier from API or cache
+ * Defaults to 'FREE' if tier cannot be determined
+ */
+export declare function getUserTier(): Promise<UserTier>;
+/**
+ * Clear tier cache (useful after tier changes)
+ */
+export declare function clearTierCache(): void;
+/**
+ * Check if user has PRO tier
+ */
+export declare function isProUser(): Promise<boolean>;
+//# sourceMappingURL=tier.d.ts.map

package/dist/utils/tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../src/utils/tier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAUtC;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CA+ErD;AAwCD;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAiBrC;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAGlD"}

package/dist/utils/tier.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Tier Utility
+ *
+ * Fetches and caches user tier to minimize API latency.
+ * Caches tier in .neurcode/config.json for the session.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserTier = getUserTier;
+exports.clearTierCache = clearTierCache;
+exports.isProUser = isProUser;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("../config");
+const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+let memoryCache = null;
+/**
+ * Get user tier from API or cache
+ * Defaults to 'FREE' if tier cannot be determined
+ */
+async function getUserTier() {
+    try {
+        // Check memory cache first
+        const now = Date.now();
+        if (memoryCache && (now - memoryCache.cachedAt) < CACHE_TTL) {
+            return memoryCache.tier;
+        }
+        // Check file cache
+        const neurcodeDir = (0, path_1.join)(process.cwd(), '.neurcode');
+        const configPath = (0, path_1.join)(neurcodeDir, 'config.json');
+        if ((0, fs_1.existsSync)(configPath)) {
+            try {
+                const fileContent = (0, fs_1.readFileSync)(configPath, 'utf-8');
+                const config = JSON.parse(fileContent);
+                if (config.tier && config.tierCachedAt) {
+                    const cacheAge = now - config.tierCachedAt;
+                    if (cacheAge < CACHE_TTL) {
+                        const tier = config.tier;
+                        memoryCache = { tier, cachedAt: config.tierCachedAt };
+                        return tier;
+                    }
+                }
+            }
+            catch (error) {
+                // Ignore parse errors, continue to API fetch
+            }
+        }
+        // Fetch from API
+        const config = (0, config_1.loadConfig)();
+        if (!config.apiKey) {
+            // No API key, default to FREE
+            return 'FREE';
+        }
+        const apiUrl = (config.apiUrl || 'https://api.neurcode.com').replace(/\/$/, '');
+        const apiKey = config.apiKey;
+        // Try to get tier from subscription endpoint
+        try {
+            const response = await fetch(`${apiUrl}/api/v1/subscriptions/status`, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+            });
+            if (!response.ok) {
+                // If not authorized or subscription not found, default to FREE
+                return 'FREE';
+            }
+            const subscription = await response.json();
+            // PRO tier if: professional plan AND (active status OR trial status)
+            const tier = subscription.plan.slug === 'professional' &&
+                (subscription.status === 'active' || subscription.status === 'trial' || subscription.isTrial)
+                ? 'PRO' : 'FREE';
+            // Cache the tier
+            cacheTier(tier);
+            return tier;
+        }
+        catch (error) {
+            // If subscription endpoint fails, default to FREE
+            // Don't log warning to avoid noise - this is expected for FREE users
+            return 'FREE';
+        }
+    }
+    catch (error) {
+        // Fail-safe: default to FREE
+        return 'FREE';
+    }
+}
+/**
+ * Cache tier in memory and file
+ */
+function cacheTier(tier) {
+    const now = Date.now();
+    memoryCache = { tier, cachedAt: now };
+    try {
+        const neurcodeDir = (0, path_1.join)(process.cwd(), '.neurcode');
+        const configPath = (0, path_1.join)(neurcodeDir, 'config.json');
+        // Ensure .neurcode directory exists
+        if (!(0, fs_1.existsSync)(neurcodeDir)) {
+            (0, fs_1.mkdirSync)(neurcodeDir, { recursive: true });
+        }
+        // Read existing config or create new
+        let config = {};
+        if ((0, fs_1.existsSync)(configPath)) {
+            try {
+                const fileContent = (0, fs_1.readFileSync)(configPath, 'utf-8');
+                config = JSON.parse(fileContent);
+            }
+            catch (error) {
+                // If parse fails, start with empty config
+            }
+        }
+        // Update tier cache
+        config.tier = tier;
+        config.tierCachedAt = now;
+        // Write back to file
+        (0, fs_1.writeFileSync)(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    catch (error) {
+        // Ignore file write errors - memory cache is still valid
+    }
+}
+/**
+ * Clear tier cache (useful after tier changes)
+ */
+function clearTierCache() {
+    memoryCache = null;
+    try {
+        const neurcodeDir = (0, path_1.join)(process.cwd(), '.neurcode');
+        const configPath = (0, path_1.join)(neurcodeDir, 'config.json');
+        if ((0, fs_1.existsSync)(configPath)) {
+            const fileContent = (0, fs_1.readFileSync)(configPath, 'utf-8');
+            const config = JSON.parse(fileContent);
+            delete config.tier;
+            delete config.tierCachedAt;
+            (0, fs_1.writeFileSync)(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        }
+    }
+    catch (error) {
+        // Ignore errors
+    }
+}
+/**
+ * Check if user has PRO tier
+ */
+async function isProUser() {
+    const tier = await getUserTier();
+    return tier === 'PRO';
+}
+//# sourceMappingURL=tier.js.map

package/dist/utils/tier.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neurcode-ai/cli",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Neurcode CLI - AI code governance and diff analysis",
   "bin": {
     "neurcode": "./dist/index.js"