@mytechtoday/augment-extensions 0.2.0 → 0.4.0

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/install-rules.d.ts

@@ -0,0 +1,32 @@
+export interface InstallRulesOptions {
+    targetDir?: string;
+    skipIfExists?: boolean;
+    verbose?: boolean;
+    force?: boolean;
+    interactive?: boolean;
+}
+export interface InstallRulesResult {
+    success: boolean;
+    created: boolean;
+    skipped: boolean;
+    updated?: boolean;
+    error?: string;
+    errorType?: 'PERMISSION_DENIED' | 'DISK_FULL' | 'CONFLICT' | 'UNKNOWN';
+    path?: string;
+}
+/**
+ * Error types for better error handling
+ */
+export declare class InstallRulesError extends Error {
+    type: 'PERMISSION_DENIED' | 'DISK_FULL' | 'CONFLICT' | 'UNKNOWN';
+    originalError?: Error | undefined;
+    constructor(message: string, type: 'PERMISSION_DENIED' | 'DISK_FULL' | 'CONFLICT' | 'UNKNOWN', originalError?: Error | undefined);
+}
+/**
+ * Install character count management rule to .augment/rules directory
+ *
+ * @param options - Installation options
+ * @returns Installation result
+ */
+export declare function installCharacterCountRule(options?: InstallRulesOptions): Promise<InstallRulesResult>;
+//# sourceMappingURL=install-rules.d.ts.map

package/cli/dist/utils/install-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-rules.d.ts","sourceRoot":"","sources":["../../src/utils/install-rules.ts"],"names":[],"mappings":"AAkEA,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAGjC,IAAI,EAAE,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS;IAChE,aAAa,CAAC,EAAE,KAAK;gBAF5B,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,EAChE,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAqID;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAkL7B"}