forge-dev-framework 1.0.1

package/dist/generators/template-engine.js

@@ -0,0 +1,209 @@
+/**
+ * Template Rendering Engine
+ *
+ * Uses Handlebars for template rendering with support for:
+ * - Variable interpolation ({{ variable }})
+ * - Conditional sections ({{#if}}...)
+ * - List iteration ({{#each}}...)
+ * - Custom helpers for formatting
+ */
+import Handlebars from 'handlebars';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { countTokens, validateTokenLimit } from './token-validator.js';
+/**
+ * Template Engine class
+ */
+export class TemplateEngine {
+    config;
+    handlebars;
+    constructor(config) {
+        this.config = config;
+        this.handlebars = Handlebars.create();
+        this.registerHelpers();
+    }
+    /**
+     * Register custom Handlebars helpers
+     */
+    registerHelpers() {
+        // Equals helper
+        this.handlebars.registerHelper('eq', function (a, b) {
+            return a === b;
+        });
+        // Not equals helper
+        this.handlebars.registerHelper('ne', function (a, b) {
+            return a !== b;
+        });
+        // And helper
+        this.handlebars.registerHelper('and', function (...args) {
+            // Last arg is options object
+            const options = args.pop();
+            return args.slice(0, -1).every((arg) => Boolean(arg));
+        });
+        // Or helper
+        this.handlebars.registerHelper('or', function (...args) {
+            // Last arg is options object
+            const options = args.pop();
+            return args.slice(0, -1).some((arg) => Boolean(arg));
+        });
+        // Default value helper
+        this.handlebars.registerHelper('default', function (value, defaultValue) {
+            return value ?? defaultValue;
+        });
+        // JSON stringify helper
+        this.handlebars.registerHelper('json', function (context, indent = 2) {
+            return JSON.stringify(context, null, indent);
+        });
+        // Concat helper
+        this.handlebars.registerHelper('concat', function (...args) {
+            // Last arg is options object
+            const options = args.pop();
+            return args.slice(0, -1).join('');
+        });
+        // ToLower helper
+        this.handlebars.registerHelper('toLowerCase', function (str) {
+            return str.toLowerCase();
+        });
+        // ToUpper helper
+        this.handlebars.registerHelper('toUpperCase', function (str) {
+            return str.toUpperCase();
+        });
+    }
+    /**
+     * Load a template file
+     */
+    async loadTemplate(templateName) {
+        const templatePath = join(this.config.templatesDir, templateName);
+        return await readFile(templatePath, 'utf-8');
+    }
+    /**
+     * Get token limit for a specific template
+     */
+    getTokenLimit(templateName) {
+        const limits = {
+            'CLAUDE.md': this.config.tokenLimits.claude,
+            'REQUIREMENTS.md': this.config.tokenLimits.requirements,
+            'PLAN.md': this.config.tokenLimits.plan,
+        };
+        // Rules files
+        if (templateName.includes('rules/')) {
+            return this.config.tokenLimits.rules;
+        }
+        // Default limit for other templates
+        return limits[templateName] ?? 4000;
+    }
+    /**
+     * Render a template with the given context
+     */
+    async render(templateName, context) {
+        try {
+            // Load template
+            const templateSource = await this.loadTemplate(templateName);
+            // Compile template
+            const template = this.handlebars.compile(templateSource);
+            // Render with context
+            const content = template(context);
+            // Count tokens
+            const tokenCount = countTokens(content);
+            // Get token limit for this template
+            const limit = this.getTokenLimit(templateName);
+            // Validate against limit
+            const { withinLimit, warnings } = validateTokenLimit(tokenCount, limit);
+            return {
+                content,
+                tokenCount,
+                withinLimit,
+                warnings,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to render template ${templateName}: ${error.message}`);
+        }
+    }
+    /**
+     * Render a template string directly (without loading from file)
+     */
+    renderString(templateString, context) {
+        try {
+            const template = this.handlebars.compile(templateString);
+            return template(context);
+        }
+        catch (error) {
+            throw new Error(`Failed to render template string: ${error.message}`);
+        }
+    }
+    /**
+     * Render multiple templates in batch
+     */
+    async renderBatch(templates) {
+        const results = new Map();
+        for (const { name, context } of templates) {
+            const result = await this.render(name, context);
+            results.set(name, result);
+        }
+        return results;
+    }
+    /**
+     * Validate context data structure
+     */
+    validateContext(context) {
+        const errors = [];
+        // Required fields
+        if (!context.projectName) {
+            errors.push('Missing required field: projectName');
+        }
+        if (!context.version) {
+            errors.push('Missing required field: version');
+        }
+        if (!context.timestamp) {
+            errors.push('Missing required field: timestamp');
+        }
+        if (!context.techStack) {
+            errors.push('Missing required field: techStack');
+        }
+        if (!context.patterns) {
+            errors.push('Missing required field: patterns');
+        }
+        if (!context.rules) {
+            errors.push('Missing required field: rules');
+        }
+        if (!context.definitionOfDone) {
+            errors.push('Missing required field: definitionOfDone');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Create a partial template that can be included in other templates
+     */
+    registerPartial(name, templateString) {
+        this.handlebars.registerPartial(name, templateString);
+    }
+    /**
+     * Register a partial from a file
+     */
+    async registerPartialFromFile(name, partialPath) {
+        const templateSource = await readFile(join(this.config.templatesDir, partialPath), 'utf-8');
+        this.handlebars.registerPartial(name, templateSource);
+    }
+}
+/**
+ * Create a template engine instance with default configuration
+ */
+export function createTemplateEngine(config) {
+    const defaultConfig = {
+        templatesDir: './src/templates',
+        outputDir: './',
+        tokenLimits: {
+            claude: 2000,
+            requirements: 4000,
+            plan: 6000,
+            rules: 1000,
+        },
+        ...config,
+    };
+    return new TemplateEngine(defaultConfig);
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/generators/template-engine.js.map

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

package/dist/generators/token-validator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Token Counter and Validator
+ *
+ * Provides token counting functionality for templates with estimation
+ * and limit validation capabilities.
+ */
+import type { TokenCountResult } from './types.js';
+/**
+ * Approximate token count for text
+ * Uses character-based estimation when tokenizer is not available
+ *
+ * Approximation: ~4 characters per token for English text
+ * This is a rough estimate - actual token count depends on the tokenizer used
+ */
+export declare function countTokens(text: string): number;
+/**
+ * More accurate token count for code
+ * Code typically has more tokens per character due to punctuation
+ */
+export declare function countCodeTokens(code: string): number;
+/**
+ * Count tokens in an array of strings
+ */
+export declare function countTokensArray(strings: string[]): number;
+/**
+ * Validate token count against limit
+ */
+export declare function validateTokenLimit(tokenCount: number, limit: number, tolerance?: number): {
+    withinLimit: boolean;
+    warnings: string[];
+};
+/**
+ * Detailed token count result with metadata
+ */
+export declare function getTokenCountDetails(text: string, isCode?: boolean): TokenCountResult;
+/**
+ * Check if a file is within token limits
+ */
+export declare function checkFileTokenLimit(content: string, filePath: string, limits: Record<string, number>): {
+    withinLimit: boolean;
+    warnings: string[];
+};
+/**
+ * Suggest content reduction strategies
+ */
+export declare function suggestReduction(tokenCount: number, limit: number): string[];
+/**
+ * Format token count for display
+ */
+export declare function formatTokenCount(tokenCount: number): string;
+//# sourceMappingURL=token-validator.d.ts.map

package/dist/generators/token-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-validator.d.ts","sourceRoot":"","sources":["../../src/generators/token-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAY,GACtB;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA4B9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,gBAAgB,CAc5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3D"}

package/dist/generators/token-validator.js

@@ -0,0 +1,141 @@
+/**
+ * Token Counter and Validator
+ *
+ * Provides token counting functionality for templates with estimation
+ * and limit validation capabilities.
+ */
+/**
+ * Approximate token count for text
+ * Uses character-based estimation when tokenizer is not available
+ *
+ * Approximation: ~4 characters per token for English text
+ * This is a rough estimate - actual token count depends on the tokenizer used
+ */
+export function countTokens(text) {
+    if (!text || text.length === 0) {
+        return 0;
+    }
+    // Simple character-based approximation
+    // Average token is ~4 characters for English text
+    // This is conservative (may overestimate slightly)
+    const charCount = text.length;
+    const tokenCount = Math.ceil(charCount / 4);
+    return tokenCount;
+}
+/**
+ * More accurate token count for code
+ * Code typically has more tokens per character due to punctuation
+ */
+export function countCodeTokens(code) {
+    if (!code || code.length === 0) {
+        return 0;
+    }
+    // Code typically has ~3 characters per token
+    // Due to operators, punctuation, etc.
+    const charCount = code.length;
+    const tokenCount = Math.ceil(charCount / 3);
+    return tokenCount;
+}
+/**
+ * Count tokens in an array of strings
+ */
+export function countTokensArray(strings) {
+    return strings.reduce((total, str) => total + countTokens(str), 0);
+}
+/**
+ * Validate token count against limit
+ */
+export function validateTokenLimit(tokenCount, limit, tolerance = 0.1 // 10% tolerance by default
+) {
+    const warnings = [];
+    // Check if within limit with tolerance
+    const effectiveLimit = limit + Math.floor(limit * tolerance);
+    const withinLimit = tokenCount <= effectiveLimit;
+    // Generate warnings based on how close we are to limit
+    const percentage = (tokenCount / limit) * 100;
+    if (percentage > 100) {
+        warnings.push(`Token count (${tokenCount}) exceeds limit (${limit}) by ${Math.round(percentage - 100)}%`);
+    }
+    else if (percentage > 90) {
+        warnings.push(`Token count (${tokenCount}) is ${Math.round(percentage)}% of limit (${limit}) - consider reducing content`);
+    }
+    else if (percentage > 75) {
+        warnings.push(`Token count (${tokenCount}) is ${Math.round(percentage)}% of limit (${limit})`);
+    }
+    return {
+        withinLimit,
+        warnings,
+    };
+}
+/**
+ * Detailed token count result with metadata
+ */
+export function getTokenCountDetails(text, isCode = false) {
+    const warnings = [];
+    // Use appropriate counter
+    const count = isCode ? countCodeTokens(text) : countTokens(text);
+    // Add warning that this is an estimate
+    warnings.push('Token count is estimated using character-based approximation');
+    return {
+        count,
+        estimated: true,
+        warnings,
+    };
+}
+/**
+ * Check if a file is within token limits
+ */
+export function checkFileTokenLimit(content, filePath, limits) {
+    // Determine if this is code
+    const isCode = /\.(ts|js|tsx|jsx|py|go|rs|java|cpp|c|h)$/.test(filePath);
+    const count = isCode ? countCodeTokens(content) : countTokens(content);
+    // Find matching limit
+    let limit = 4000; // default
+    const fileName = filePath.split('/').pop() || '';
+    if (fileName.includes('CLAUDE.md')) {
+        limit = limits.claude || 2000;
+    }
+    else if (fileName.includes('REQUIREMENTS.md')) {
+        limit = limits.requirements || 4000;
+    }
+    else if (fileName.includes('PLAN.md')) {
+        limit = limits.plan || 6000;
+    }
+    else if (filePath.includes('rules/')) {
+        limit = limits.rules || 1000;
+    }
+    return validateTokenLimit(count, limit);
+}
+/**
+ * Suggest content reduction strategies
+ */
+export function suggestReduction(tokenCount, limit) {
+    const suggestions = [];
+    const excess = tokenCount - limit;
+    if (excess <= 0) {
+        return suggestions;
+    }
+    const excessPercentage = Math.round((excess / limit) * 100);
+    // General suggestions
+    suggestions.push(`Reduce content by at least ${excess} tokens (${excessPercentage}% over limit)`);
+    suggestions.push('Move verbose sections to separate files and reference them');
+    suggestions.push('Use bullet points instead of full paragraphs');
+    suggestions.push('Remove redundant explanations');
+    suggestions.push('Consolidate similar items into lists');
+    // Specific suggestions based on file type
+    if (excessPercentage > 50) {
+        suggestions.push('Consider splitting this into multiple files');
+        suggestions.push('Extract detailed examples into a separate "examples" directory');
+    }
+    return suggestions;
+}
+/**
+ * Format token count for display
+ */
+export function formatTokenCount(tokenCount) {
+    if (tokenCount < 1000) {
+        return `${tokenCount} tokens`;
+    }
+    return `${(tokenCount / 1000).toFixed(1)}k tokens`;
+}
+//# sourceMappingURL=token-validator.js.map

package/dist/generators/token-validator.js.map

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