forge-dev-framework 1.0.1

package/dist/utils/template-client.js

@@ -0,0 +1,151 @@
+/**
+ * FORGE Template Client
+ * Wrapper for TEMPLATES integration with CLI-ENGINE
+ */
+import path from 'path';
+import fs from 'fs/promises';
+import { createTemplateEngine } from '../generators/index.js';
+import { XmlTaskGenerator } from '../generators/index.js';
+import { REQUIRED_FIELDS, validateRequiredFields } from '../generators/index.js';
+import { logger } from './index.js';
+/**
+ * Template Client for FORGE CLI
+ */
+export class TemplateClient {
+    engine;
+    projectRoot;
+    interactive;
+    outputDir;
+    constructor(config) {
+        this.projectRoot = config.projectRoot;
+        this.interactive = config.interactive ?? true;
+        this.outputDir = config.outputDir ?? config.projectRoot;
+        // Create template engine
+        this.engine = createTemplateEngine({
+            templatesDir: config.templatesDir ?? path.join(config.projectRoot, 'src/templates'),
+            outputDir: this.outputDir,
+            tokenLimits: {
+                claude: 2000,
+                requirements: 4000,
+                plan: 6000,
+                rules: 1000,
+            },
+        });
+    }
+    /**
+     * Validate that context has all required fields for a template
+     */
+    validateContext(context, fieldSet) {
+        return validateRequiredFields(context, fieldSet);
+    }
+    /**
+     * Get required fields for a specific template
+     */
+    getRequiredFields(fieldSet) {
+        return [...REQUIRED_FIELDS[fieldSet]];
+    }
+    /**
+     * Render a template with the given context
+     */
+    async renderTemplate(templateName, context) {
+        try {
+            // Cast to full TemplateContext for the engine
+            // Validation should happen before calling this
+            const result = await this.engine.render(templateName, context);
+            // Handle token limit warnings
+            if (!result.withinLimit) {
+                this.handleTokenLimitWarning(templateName, result);
+            }
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Template rendering failed for ${templateName}: ${error}`);
+        }
+    }
+    /**
+     * Render and write a template to disk
+     */
+    async generateArtifact(templateName, context, outputFilename) {
+        // TODO: Validate context has required fields before rendering
+        // For now, cast to full TemplateContext
+        const result = await this.renderTemplate(templateName, context);
+        const outputPath = path.join(this.outputDir, outputFilename);
+        // Backup existing file if it exists
+        if (await this.fileExists(outputPath)) {
+            await this.backupFile(outputPath);
+        }
+        // Write the generated artifact
+        await fs.writeFile(outputPath, result.content, 'utf-8');
+        logger.success(`Generated ${outputFilename} (${result.tokenCount} tokens)`);
+    }
+    /**
+     * Generate XML task specs
+     */
+    generateXmlTasks(tasks) {
+        // Use XmlTaskGenerator static method directly
+        // It's already imported at the top of the file
+        return XmlTaskGenerator.generateTasks(tasks);
+    }
+    /**
+     * Handle token limit warnings
+     */
+    handleTokenLimitWarning(templateName, result) {
+        const limit = this.getTemplateLimit(templateName);
+        logger.warning(`Token limit exceeded for ${templateName}`);
+        logger.info(`Limit: ${limit}, Actual: ${result.tokenCount}`);
+        if (result.warnings.length > 0) {
+            logger.info('Suggestions:');
+            result.warnings.forEach(w => logger.bullet(w));
+        }
+    }
+    /**
+     * Get token limit for a template
+     */
+    getTemplateLimit(templateName) {
+        if (templateName.includes('CLAUDE'))
+            return 2000;
+        if (templateName.includes('REQUIREMENTS'))
+            return 4000;
+        if (templateName.includes('PLAN'))
+            return 6000;
+        return 1000; // Default for rules
+    }
+    /**
+     * Check if file exists
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Backup existing file
+     */
+    async backupFile(filePath) {
+        const backupPath = `${filePath}.backup`;
+        await fs.copyFile(filePath, backupPath);
+        logger.info(`Backed up ${path.basename(filePath)} → ${path.basename(backupPath)}`);
+    }
+    /**
+     * Prompt user to proceed despite warnings
+     */
+    async shouldProceed() {
+        if (!this.interactive) {
+            return true; // Auto-proceed in non-interactive mode
+        }
+        // TODO: Implement interactive prompt
+        // For now, default to true
+        return true;
+    }
+}
+/**
+ * Create a template client instance
+ */
+export function createTemplateClient(config) {
+    return new TemplateClient(config);
+}
+//# sourceMappingURL=template-client.js.map

package/dist/utils/template-client.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "forge-dev-framework",
+  "version": "1.0.1",
+  "description": "Full Orchestration for Rapid Git Engineering - A multi-agent development framework for Claude Code Agent Teams",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "forge": "./dist/bin/forge.js"
+  },
+  "files": [
+    "dist/",
+    ".claude/",
+    "templates/",
+    "bin/"
+  ],
+  "type": "module",
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "npm run build:ts && npm run build:bin",
+    "build:ts": "tsc",
+    "build:bin": "mkdir -p dist/bin && cp bin/forge.js dist/bin/forge.js && chmod +x dist/bin/forge.js",
+    "dev": "tsx src/cli/index.ts",
+    "start": "node dist/cli/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest --coverage",
+    "test:git": "node --import tsx --test src/git/**/*.test.ts",
+    "postinstall": "node dist/scripts/install.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "agent-teams",
+    "ai-development",
+    "git-automation",
+    "multi-agent",
+    "project-management",
+    "development-framework",
+    "claude-ai"
+  ],
+  "author": "Alzarak <parz@alzarak.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Alzarak/forge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Alzarak/forge/issues"
+  },
+  "homepage": "https://github.com/Alzarak/forge#readme",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "execa": "^9.5.2",
+    "figlet": "^1.10.0",
+    "handlebars": "^4.7.8",
+    "inquirer": "^12.11.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.7.0",
+    "@types/handlebars": "^4.1.0",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.2.3",
+    "@vitest/ui": "^3.2.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}