@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/cli/dist/utils/character-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-count.d.ts","sourceRoot":"","sources":["../../src/utils/character-count.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,oBAAoB,CAoD5B;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,GAAE,MAAmB,GAAG,oBAAoB,CAKpG;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,GAAE,MAAmB,GAAG;IAC9E,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB,CAuBA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAUxG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAiC,GAAG,MAAM,CAqB9G"}

package/cli/dist/utils/character-count.js

@@ -0,0 +1,190 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHARACTER_LIMITS = void 0;
+exports.calculateCharacterCount = calculateCharacterCount;
+exports.calculateAugmentCharacterCount = calculateAugmentCharacterCount;
+exports.validateAugmentCharacterCount = validateAugmentCharacterCount;
+exports.getModuleSizeCategory = getModuleSizeCategory;
+exports.formatCharacterCount = formatCharacterCount;
+exports.generateCharacterCountReport = generateCharacterCountReport;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Character count limits
+ */
+exports.CHARACTER_LIMITS = {
+    AUGMENT_MIN: 48599,
+    AUGMENT_MAX: 49299,
+    AUGMENT_TARGET: 49000,
+    MODULE_SMALL: 10000,
+    MODULE_MEDIUM: 25000,
+    MODULE_LARGE: 50000,
+};
+/**
+ * Calculate character count for a directory
+ */
+function calculateCharacterCount(dirPath, options = {}) {
+    const { includeHidden = false, extensions } = options;
+    let totalCharacters = 0;
+    let fileCount = 0;
+    const files = [];
+    function countFilesRecursively(dir) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip hidden files/directories unless includeHidden is true
+            if (!includeHidden && entry.name.startsWith('.')) {
+                continue;
+            }
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                countFilesRecursively(fullPath);
+            }
+            else if (entry.isFile()) {
+                // Filter by extension if specified
+                if (extensions && extensions.length > 0) {
+                    const ext = path.extname(entry.name);
+                    if (!extensions.includes(ext)) {
+                        continue;
+                    }
+                }
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                const charCount = content.length;
+                totalCharacters += charCount;
+                fileCount++;
+                files.push({
+                    path: path.relative(dirPath, fullPath),
+                    characters: charCount
+                });
+            }
+        }
+    }
+    if (fs.existsSync(dirPath)) {
+        countFilesRecursively(dirPath);
+    }
+    return {
+        totalCharacters,
+        fileCount,
+        files: files.sort((a, b) => b.characters - a.characters) // Sort by size descending
+    };
+}
+/**
+ * Calculate character count for .augment/ directory
+ */
+function calculateAugmentCharacterCount(augmentDir = '.augment') {
+    return calculateCharacterCount(augmentDir, {
+        includeHidden: false,
+        extensions: ['.md', '.json']
+    });
+}
+/**
+ * Validate .augment/ directory character count
+ */
+function validateAugmentCharacterCount(augmentDir = '.augment') {
+    const result = calculateAugmentCharacterCount(augmentDir);
+    const { totalCharacters } = result;
+    const { AUGMENT_MIN, AUGMENT_MAX } = exports.CHARACTER_LIMITS;
+    const valid = totalCharacters >= AUGMENT_MIN && totalCharacters <= AUGMENT_MAX;
+    let message = '';
+    if (totalCharacters < AUGMENT_MIN) {
+        message = `Character count (${totalCharacters}) is below minimum (${AUGMENT_MIN}). Consider adding more content.`;
+    }
+    else if (totalCharacters > AUGMENT_MAX) {
+        message = `Character count (${totalCharacters}) exceeds maximum (${AUGMENT_MAX}). Move content to extension modules.`;
+    }
+    else {
+        message = `Character count (${totalCharacters}) is within target range (${AUGMENT_MIN}-${AUGMENT_MAX}).`;
+    }
+    return {
+        valid,
+        count: totalCharacters,
+        min: AUGMENT_MIN,
+        max: AUGMENT_MAX,
+        message
+    };
+}
+/**
+ * Get module size category
+ */
+function getModuleSizeCategory(characterCount) {
+    if (characterCount < exports.CHARACTER_LIMITS.MODULE_SMALL) {
+        return 'small';
+    }
+    else if (characterCount < exports.CHARACTER_LIMITS.MODULE_MEDIUM) {
+        return 'medium';
+    }
+    else if (characterCount < exports.CHARACTER_LIMITS.MODULE_LARGE) {
+        return 'large';
+    }
+    else {
+        return 'too-large';
+    }
+}
+/**
+ * Format character count for display
+ */
+function formatCharacterCount(count) {
+    if (count < 1000) {
+        return `${count}`;
+    }
+    else if (count < 1000000) {
+        return `${(count / 1000).toFixed(1)}K`;
+    }
+    else {
+        return `${(count / 1000000).toFixed(1)}M`;
+    }
+}
+/**
+ * Generate character count report
+ */
+function generateCharacterCountReport(dirPath, title = 'Character Count Report') {
+    const result = calculateCharacterCount(dirPath);
+    const sizeCategory = getModuleSizeCategory(result.totalCharacters);
+    let report = `# ${title}\n\n`;
+    report += `**Total Characters**: ${result.totalCharacters.toLocaleString()} (${formatCharacterCount(result.totalCharacters)})\n`;
+    report += `**File Count**: ${result.fileCount}\n`;
+    report += `**Size Category**: ${sizeCategory}\n\n`;
+    if (result.files.length > 0) {
+        report += `## Files by Size\n\n`;
+        report += `| File | Characters | % of Total |\n`;
+        report += `|------|------------|------------|\n`;
+        for (const file of result.files) {
+            const percentage = ((file.characters / result.totalCharacters) * 100).toFixed(1);
+            report += `| ${file.path} | ${file.characters.toLocaleString()} | ${percentage}% |\n`;
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=character-count.js.map

package/cli/dist/utils/character-count.js.map

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

package/cli/dist/utils/documentation-validator.d.ts

@@ -0,0 +1,18 @@
+import { Module, ValidationResult } from './module-system';
+/**
+ * Validate module README.md has required sections
+ */
+export declare function validateReadmeStructure(modulePath: string): ValidationResult;
+/**
+ * Validate module has comprehensive documentation
+ */
+export declare function validateModuleDocumentation(module: Module): ValidationResult;
+/**
+ * Extract module overview from README.md
+ */
+export declare function extractModuleOverview(modulePath: string): string;
+/**
+ * Extract character count from README.md
+ */
+export declare function extractCharacterCountFromReadme(modulePath: string): number | null;
+//# sourceMappingURL=documentation-validator.d.ts.map

package/cli/dist/utils/documentation-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-validator.d.ts","sourceRoot":"","sources":["../../src/utils/documentation-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAW3D;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAuC5E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAsG5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAoChE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBjF"}

package/cli/dist/utils/documentation-validator.js

@@ -0,0 +1,233 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateReadmeStructure = validateReadmeStructure;
+exports.validateModuleDocumentation = validateModuleDocumentation;
+exports.extractModuleOverview = extractModuleOverview;
+exports.extractCharacterCountFromReadme = extractCharacterCountFromReadme;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Required sections in README.md
+ */
+const REQUIRED_README_SECTIONS = [
+    'Overview',
+    'Contents',
+    'Character Count'
+];
+/**
+ * Validate module README.md has required sections
+ */
+function validateReadmeStructure(modulePath) {
+    const errors = [];
+    const warnings = [];
+    const readmePath = path.join(modulePath, 'README.md');
+    if (!fs.existsSync(readmePath)) {
+        errors.push('README.md file is missing');
+        return { valid: false, errors, warnings };
+    }
+    const content = fs.readFileSync(readmePath, 'utf-8');
+    // Check for required sections
+    for (const section of REQUIRED_README_SECTIONS) {
+        // Look for markdown headers (# Section or ## Section)
+        const sectionPattern = new RegExp(`^#{1,3}\\s+${section}`, 'mi');
+        if (!sectionPattern.test(content)) {
+            errors.push(`README.md missing required section: ${section}`);
+        }
+    }
+    // Check for empty README
+    if (content.trim().length < 100) {
+        warnings.push('README.md appears to be too short (< 100 characters)');
+    }
+    // Check for module name in title
+    const titlePattern = /^#\s+(.+)/m;
+    const titleMatch = content.match(titlePattern);
+    if (!titleMatch) {
+        warnings.push('README.md missing title (# heading)');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Validate module has comprehensive documentation
+ */
+function validateModuleDocumentation(module) {
+    const errors = [];
+    const warnings = [];
+    // Validate README.md structure
+    const readmeValidation = validateReadmeStructure(module.path);
+    errors.push(...readmeValidation.errors);
+    warnings.push(...readmeValidation.warnings);
+    // Check for rule files
+    if (module.rules.length === 0) {
+        errors.push('Module has no rule files in rules/ directory');
+    }
+    // Check for examples (optional but recommended for certain module types)
+    if (module.examples.length === 0) {
+        if (module.metadata.type === 'examples') {
+            errors.push('Examples module must have files in examples/ directory');
+        }
+        else if (module.metadata.type === 'coding-standards') {
+            warnings.push('Coding standards module should have examples in examples/ directory (recommended)');
+        }
+        else {
+            warnings.push('Module has no examples in examples/ directory (optional but recommended)');
+        }
+    }
+    // Validate each rule file has content
+    const rulesDir = path.join(module.path, 'rules');
+    for (const ruleFile of module.rules) {
+        const rulePath = path.join(rulesDir, ruleFile);
+        const content = fs.readFileSync(rulePath, 'utf-8');
+        if (content.trim().length < 100) {
+            warnings.push(`Rule file ${ruleFile} appears to be too short (< 100 characters)`);
+        }
+        // Check for markdown headers
+        if (!content.match(/^#{1,3}\s+/m)) {
+            warnings.push(`Rule file ${ruleFile} missing markdown headers`);
+        }
+        // Check for code examples in rule files (recommended)
+        if (!content.match(/```/)) {
+            warnings.push(`Rule file ${ruleFile} has no code examples (recommended for clarity)`);
+        }
+        // Check for actionable content (should have lists or steps)
+        if (!content.match(/^[-*]\s+/m) && !content.match(/^\d+\.\s+/m)) {
+            warnings.push(`Rule file ${ruleFile} lacks actionable content (lists or numbered steps recommended)`);
+        }
+    }
+    // Validate module.json completeness
+    if (!module.metadata.displayName) {
+        errors.push('module.json missing displayName field');
+    }
+    if (!module.metadata.description) {
+        errors.push('module.json missing description field');
+    }
+    else if (module.metadata.description.length < 20) {
+        warnings.push('module.json description is too short (< 20 characters)');
+    }
+    else if (module.metadata.description.length > 200) {
+        warnings.push('module.json description is too long (> 200 characters) - consider shortening');
+    }
+    if (!module.metadata.tags || module.metadata.tags.length === 0) {
+        warnings.push('module.json missing tags field (recommended for discoverability)');
+    }
+    if (!module.metadata.augment?.characterCount) {
+        warnings.push('module.json missing augment.characterCount field (required for catalog)');
+    }
+    if (!module.metadata.augment?.priority) {
+        warnings.push('module.json missing augment.priority field (recommended: high, medium, or low)');
+    }
+    // Validate README.md has usage examples
+    const readmePath = path.join(module.path, 'README.md');
+    if (fs.existsSync(readmePath)) {
+        const readmeContent = fs.readFileSync(readmePath, 'utf-8');
+        // Check for usage section
+        if (!readmeContent.match(/^#{1,3}\s+Usage/mi)) {
+            warnings.push('README.md missing Usage section (recommended)');
+        }
+        // Check for installation/setup section
+        if (!readmeContent.match(/^#{1,3}\s+(Installation|Setup)/mi)) {
+            warnings.push('README.md missing Installation or Setup section (recommended)');
+        }
+        // Check for examples in README
+        if (!readmeContent.match(/```/)) {
+            warnings.push('README.md has no code examples (recommended)');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Extract module overview from README.md
+ */
+function extractModuleOverview(modulePath) {
+    const readmePath = path.join(modulePath, 'README.md');
+    if (!fs.existsSync(readmePath)) {
+        return '';
+    }
+    const content = fs.readFileSync(readmePath, 'utf-8');
+    // Extract first paragraph after title
+    const lines = content.split('\n');
+    let overview = '';
+    let foundTitle = false;
+    for (const line of lines) {
+        if (line.match(/^#\s+/)) {
+            foundTitle = true;
+            continue;
+        }
+        if (foundTitle && line.trim().length > 0 && !line.match(/^#{1,3}\s+/)) {
+            overview += line + ' ';
+            // Stop at next heading or after a reasonable length
+            if (overview.length > 200) {
+                break;
+            }
+        }
+        // Stop at next heading
+        if (foundTitle && line.match(/^#{1,3}\s+/)) {
+            break;
+        }
+    }
+    return overview.trim();
+}
+/**
+ * Extract character count from README.md
+ */
+function extractCharacterCountFromReadme(modulePath) {
+    const readmePath = path.join(modulePath, 'README.md');
+    if (!fs.existsSync(readmePath)) {
+        return null;
+    }
+    const content = fs.readFileSync(readmePath, 'utf-8');
+    // Look for character count patterns
+    const patterns = [
+        /Character Count[:\s]+~?(\d{1,3}(?:,\d{3})*)/i,
+        /~(\d{1,3}(?:,\d{3})*)\s+characters/i,
+        /Total:\s+~?(\d{1,3}(?:,\d{3})*)/i
+    ];
+    for (const pattern of patterns) {
+        const match = content.match(pattern);
+        if (match) {
+            return parseInt(match[1].replace(/,/g, ''), 10);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=documentation-validator.js.map

package/cli/dist/utils/documentation-validator.js.map

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

package/cli/dist/utils/gui-helpers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * GUI Helper Functions
+ */
+import { GuiConfig, SearchResult, ModuleChoice, FilterOptions } from '../types/gui';
+import { Module } from './module-system';
+/**
+ * Load GUI configuration from VS Code settings or use defaults
+ */
+export declare function loadGuiConfig(): GuiConfig;
+/**
+ * Format module for display in GUI
+ */
+export declare function formatModuleChoice(module: Module, linkedModules?: string[]): ModuleChoice;
+/**
+ * Fuzzy search implementation using simple string matching
+ * For production, consider using Fuse.js or similar library
+ */
+export declare function fuzzySearch(query: string, modules: ModuleChoice[], options: GuiConfig['searchOptions']): SearchResult[];
+/**
+ * Filter modules based on filter options
+ */
+export declare function filterModules(modules: ModuleChoice[], filters: FilterOptions): ModuleChoice[];
+//# sourceMappingURL=gui-helpers.d.ts.map

package/cli/dist/utils/gui-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/gui-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,SAAS,EAAsB,YAAY,EAAe,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACrH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAIzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,EAAO,GAAG,YAAY,CAW7F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,GAClC,YAAY,EAAE,CAmEhB;AAuCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,EAAE,CAiC7F"}

package/cli/dist/utils/gui-helpers.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * GUI Helper Functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGuiConfig = loadGuiConfig;
+exports.formatModuleChoice = formatModuleChoice;
+exports.fuzzySearch = fuzzySearch;
+exports.filterModules = filterModules;
+const gui_1 = require("../types/gui");
+/**
+ * Load GUI configuration from VS Code settings or use defaults
+ */
+function loadGuiConfig() {
+    // In a real implementation, this would read from VS Code settings
+    // For now, return default config
+    return { ...gui_1.DEFAULT_GUI_CONFIG };
+}
+/**
+ * Format module for display in GUI
+ */
+function formatModuleChoice(module, linkedModules = []) {
+    return {
+        name: `${module.metadata.displayName} (${module.fullName})`,
+        value: module.fullName,
+        description: module.metadata.description,
+        type: module.metadata.type,
+        priority: module.metadata.augment?.priority,
+        characterCount: module.metadata.augment?.characterCount,
+        linked: linkedModules.includes(module.fullName),
+        checked: linkedModules.includes(module.fullName)
+    };
+}
+/**
+ * Fuzzy search implementation using simple string matching
+ * For production, consider using Fuse.js or similar library
+ */
+function fuzzySearch(query, modules, options) {
+    if (!query || query.trim() === '') {
+        return modules.map(m => ({ module: m, score: 1, matches: [] }));
+    }
+    const normalizedQuery = options.caseSensitive ? query : query.toLowerCase();
+    const results = [];
+    for (const module of modules) {
+        let totalScore = 0;
+        const matches = [];
+        // Search in name
+        if (options.searchFields.includes('name')) {
+            const nameValue = module.name || '';
+            const normalizedName = options.caseSensitive ? nameValue : nameValue.toLowerCase();
+            const nameScore = calculateMatchScore(normalizedQuery, normalizedName);
+            if (nameScore > 0) {
+                totalScore += nameScore * 0.5; // Name weight: 0.5
+                matches.push({
+                    field: 'name',
+                    indices: findMatchIndices(normalizedQuery, normalizedName),
+                    value: nameValue
+                });
+            }
+        }
+        // Search in description
+        if (options.searchFields.includes('description') && module.description) {
+            const descValue = module.description;
+            const normalizedDesc = options.caseSensitive ? descValue : descValue.toLowerCase();
+            const descScore = calculateMatchScore(normalizedQuery, normalizedDesc);
+            if (descScore > 0) {
+                totalScore += descScore * 0.3; // Description weight: 0.3
+                matches.push({
+                    field: 'description',
+                    indices: findMatchIndices(normalizedQuery, normalizedDesc),
+                    value: descValue
+                });
+            }
+        }
+        // Search in type (treated as tags)
+        if (options.searchFields.includes('tags') && module.type) {
+            const typeValue = module.type;
+            const normalizedType = options.caseSensitive ? typeValue : typeValue.toLowerCase();
+            const typeScore = calculateMatchScore(normalizedQuery, normalizedType);
+            if (typeScore > 0) {
+                totalScore += typeScore * 0.2; // Tags weight: 0.2
+                matches.push({
+                    field: 'tags',
+                    indices: findMatchIndices(normalizedQuery, normalizedType),
+                    value: typeValue
+                });
+            }
+        }
+        if (totalScore >= options.minMatchScore) {
+            results.push({ module, score: totalScore, matches });
+        }
+    }
+    // Sort by score descending
+    return results.sort((a, b) => b.score - a.score);
+}
+/**
+ * Calculate match score between query and text
+ */
+function calculateMatchScore(query, text) {
+    if (text.includes(query)) {
+        // Exact substring match
+        return 1.0;
+    }
+    // Simple fuzzy matching: count matching characters in order
+    let queryIndex = 0;
+    let matchCount = 0;
+    for (let i = 0; i < text.length && queryIndex < query.length; i++) {
+        if (text[i] === query[queryIndex]) {
+            matchCount++;
+            queryIndex++;
+        }
+    }
+    return matchCount / query.length;
+}
+/**
+ * Find indices of matches in text
+ */
+function findMatchIndices(query, text) {
+    const indices = [];
+    const index = text.indexOf(query);
+    if (index !== -1) {
+        indices.push([index, index + query.length]);
+    }
+    return indices;
+}
+/**
+ * Filter modules based on filter options
+ */
+function filterModules(modules, filters) {
+    return modules.filter(module => {
+        // Filter by categories
+        if (filters.categories.length > 0) {
+            const moduleCategory = module.type || '';
+            if (!filters.categories.includes(moduleCategory)) {
+                return false;
+            }
+        }
+        // Filter by types (same as categories for now)
+        if (filters.types.length > 0) {
+            const moduleType = module.type || '';
+            if (!filters.types.includes(moduleType)) {
+                return false;
+            }
+        }
+        // Filter by priorities
+        if (filters.priorities.length > 0) {
+            const modulePriority = module.priority || 'medium';
+            if (!filters.priorities.includes(modulePriority)) {
+                return false;
+            }
+        }
+        // Filter by linked status
+        if (filters.linkedOnly && !module.linked) {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=gui-helpers.js.map

package/cli/dist/utils/gui-helpers.js.map

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