forge-dev-framework 1.0.1

package/dist/commands/status.js

@@ -0,0 +1,101 @@
+import { ForgeCommand } from './base.js';
+import { loadConfig, getState, isForgeProject } from '../utils/index.js';
+import { ProjectNotFoundError, formatError } from '../utils/index.js';
+import chalk from 'chalk';
+/**
+ * Status Command - Show current progress, active agents, task graph
+ */
+export class StatusCommand extends ForgeCommand {
+    register() {
+        this.program
+            .command('status')
+            .description('Show current progress, active agents, task graph')
+            .option('-v, --verbose', 'Show detailed information')
+            .action((options) => this.execute(options));
+    }
+    async execute(options = {}) {
+        try {
+            const projectRoot = process.cwd();
+            // Check if we're in a FORGE project using State API
+            if (!isForgeProject(projectRoot)) {
+                throw new ProjectNotFoundError(projectRoot);
+            }
+            // Load configuration
+            this.config = loadConfig(projectRoot);
+            // Load state using State API
+            const state = getState(projectRoot);
+            // Display status
+            this.displayStatus(state, options.verbose);
+        }
+        catch (error) {
+            this.logger.error(formatError(error));
+            process.exit(1);
+        }
+    }
+    displayStatus(state, verbose) {
+        this.logger.header('FORGE Project Status');
+        if (state?.project) {
+            const p = state.project;
+            console.log(chalk.white('Project:'), chalk.bold(p.name));
+            console.log(chalk.white('Status:'), this.formatStatus(p.status));
+            console.log(chalk.white('Milestone:'), chalk.cyan(p.currentMilestone));
+            console.log(chalk.white('Phase:'), chalk.cyan(`Phase ${p.currentPhase}`));
+        }
+        else {
+            console.log(chalk.yellow('No project state found. Run ') + chalk.cyan('forge init') + chalk.yellow(' to initialize.'));
+        }
+        this.logger.newline();
+        if (state?.tasks) {
+            this.displayTaskSummary(state.tasks);
+        }
+        if (verbose && state?.contracts) {
+            this.displayContracts(state.contracts);
+        }
+    }
+    formatStatus(status) {
+        switch (status) {
+            case 'approved':
+            case 'completed':
+                return chalk.green(status);
+            case 'in-progress':
+                return chalk.yellow(status);
+            case 'blocked':
+                return chalk.red(status);
+            default:
+                return chalk.white(status);
+        }
+    }
+    displayTaskSummary(tasks) {
+        const summary = {
+            pending: tasks.filter((t) => t.status === 'pending').length,
+            in_progress: tasks.filter((t) => t.status === 'in_progress').length,
+            completed: tasks.filter((t) => t.status === 'completed').length,
+            blocked: tasks.filter((t) => t.status === 'blocked').length,
+        };
+        console.log(chalk.bold('Tasks:'));
+        console.log(chalk.gray('  ├─ Pending: '), chalk.yellow(String(summary.pending)));
+        console.log(chalk.gray('  ├─ In Progress: '), chalk.blue(String(summary.in_progress)));
+        console.log(chalk.gray('  ├─ Completed: '), chalk.green(String(summary.completed)));
+        console.log(chalk.gray('  └─ Blocked: '), chalk.red(String(summary.blocked)));
+        this.logger.newline();
+        // Show in-progress tasks
+        const inProgress = tasks.filter((t) => t.status === 'in_progress');
+        if (inProgress.length > 0) {
+            console.log(chalk.bold.white('Active Work:'));
+            inProgress.forEach((task) => {
+                console.log(chalk.cyan(`  • ${task.id}:`), chalk.white(task.title));
+                console.log(chalk.gray(`    Owner: ${task.ownerRole} | Priority: ${task.priority}`));
+            });
+            this.logger.newline();
+        }
+    }
+    displayContracts(contracts) {
+        console.log(chalk.bold.white('Contracts:'));
+        contracts.forEach((contract) => {
+            console.log(chalk.cyan(`  • ${contract.id}:`), chalk.gray(contract.path));
+            console.log(chalk.gray(`    Version: ${contract.version} | Consumers: ${contract.consumers.join(', ')}`));
+        });
+        this.logger.newline();
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,QAAQ;QACN,IAAI,CAAC,OAAO;aACT,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,kDAAkD,CAAC;aAC/D,MAAM,CAAC,eAAe,EAAE,2BAA2B,CAAC;aACpD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAe,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAElC,oDAAoD;YACpD,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAC9C,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YAEtC,6BAA6B;YAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;YAEpC,iBAAiB;YACjB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAc,CAAC,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,KAAU,EAAE,OAAgB;QAChD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAE3C,IAAI,KAAK,EAAE,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8BAA8B,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACzH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAEtB,IAAI,KAAK,EAAE,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,OAAO,IAAI,KAAK,EAAE,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAAc;QACjC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,UAAU,CAAC;YAChB,KAAK,WAAW;gBACd,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,aAAa;gBAChB,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,KAAK,SAAS;gBACZ,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC3B;gBACE,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,KAAY;QACrC,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YAC3D,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM;YACnE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;YAC/D,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;SAC5D,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE9E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAEtB,yBAAyB;QACzB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;QACnE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YAC9C,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACvF,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,SAAgB;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5C,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,OAAO,iBAAiB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5G,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/commands/stubs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Stub Commands - Placeholder implementations for Milestone 2-5 commands
+ * These will be fully implemented in their respective tasks
+ */
+import { Command } from 'commander';
+import { ForgeCommand } from './base.js';
+export declare class StubCommand extends ForgeCommand {
+    private commandName;
+    constructor(program: Command, commandName: string);
+    register(): void;
+    execute(): Promise<void>;
+}
+export declare function createStubCommand(name: string, description: string): (program: Command) => StubCommand;
+//# sourceMappingURL=stubs.d.ts.map

package/dist/commands/stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../../src/commands/stubs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,qBAAa,WAAY,SAAQ,YAAY;IACb,OAAO,CAAC,WAAW;gBAArC,OAAO,EAAE,OAAO,EAAU,WAAW,EAAE,MAAM;IAIzD,QAAQ,IAAI,IAAI;IAOV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IACzD,SAAS,OAAO,iBAKzB"}

package/dist/commands/stubs.js

@@ -0,0 +1,30 @@
+/**
+ * Stub Commands - Placeholder implementations for Milestone 2-5 commands
+ * These will be fully implemented in their respective tasks
+ */
+import { ForgeCommand } from './base.js';
+export class StubCommand extends ForgeCommand {
+    commandName;
+    constructor(program, commandName) {
+        super(program);
+        this.commandName = commandName;
+    }
+    register() {
+        this.program
+            .command(this.commandName)
+            .allowUnknownOption(true)
+            .action(() => this.execute());
+    }
+    async execute() {
+        this.logger.info(`Command '${this.commandName}' will be implemented in a future milestone.`);
+    }
+}
+// Factory function for creating stub commands
+export function createStubCommand(name, description) {
+    return (program) => {
+        const cmd = new StubCommand(program, name);
+        cmd.register();
+        return cmd;
+    };
+}
+//# sourceMappingURL=stubs.js.map

package/dist/commands/stubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../src/commands/stubs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,OAAO,WAAY,SAAQ,YAAY;IACL;IAAtC,YAAY,OAAgB,EAAU,WAAmB;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,gBAAW,GAAX,WAAW,CAAQ;IAEzD,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,OAAO;aACT,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;aACzB,kBAAkB,CAAC,IAAI,CAAC;aACxB,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,8CAA8C,CAAC,CAAC;IAC/F,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,WAAmB;IACjE,OAAO,CAAC,OAAgB,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3C,GAAG,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC"}

package/dist/generators/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * FORGE Template & Artifact Generators
+ *
+ * Exports all template engines, generators, and validators
+ */
+export { TemplateEngine, createTemplateEngine } from './template-engine.js';
+export { countTokens, countCodeTokens, countTokensArray, validateTokenLimit, getTokenCountDetails, checkFileTokenLimit, suggestReduction, formatTokenCount, } from './token-validator.js';
+export { XmlTaskGenerator } from './xml-task-generator.js';
+export { REQUIRED_FIELDS, validateRequiredFields, getFieldDescriptions, getPromptQuestions, type RequiredFieldSet, } from './required-fields.js';
+export type { TemplateContext, TemplateConfig, RenderResult, TokenLimits, XmlTaskSpec, TokenCountResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/generators/index.js

@@ -0,0 +1,10 @@
+/**
+ * FORGE Template & Artifact Generators
+ *
+ * Exports all template engines, generators, and validators
+ */
+export { TemplateEngine, createTemplateEngine } from './template-engine.js';
+export { countTokens, countCodeTokens, countTokensArray, validateTokenLimit, getTokenCountDetails, checkFileTokenLimit, suggestReduction, formatTokenCount, } from './token-validator.js';
+export { XmlTaskGenerator } from './xml-task-generator.js';
+export { REQUIRED_FIELDS, validateRequiredFields, getFieldDescriptions, getPromptQuestions, } from './required-fields.js';
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC"}

package/dist/generators/required-fields.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Required fields for TemplateContext validation
+ *
+ * CLI-ENGINE uses these to prompt users and validate collected data.
+ */
+/**
+ * Minimum required fields for basic template rendering
+ */
+export declare const CORE_REQUIRED_FIELDS: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone"];
+/**
+ * Required fields for CLAUDE.md generation
+ */
+export declare const CLAUDE_REQUIRED_FIELDS: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "techStack.backend", "patterns", "rules"];
+/**
+ * Required fields for PROJECT.md generation
+ */
+export declare const PROJECT_REQUIRED_FIELDS: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "problemStatement", "solution", "architectureDiagram", "successMetrics"];
+/**
+ * Required fields for REQUIREMENTS.md generation
+ */
+export declare const REQUIREMENTS_REQUIRED_FIELDS: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "features", "nfrs"];
+/**
+ * Required fields for ROADMAP.md generation
+ */
+export declare const ROADMAP_REQUIRED_FIELDS: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "milestones", "phases", "dependencyGraph", "definitionOfDone"];
+/**
+ * Required fields for PLAN.md generation
+ */
+export declare const PLAN_REQUIRED_FIELDS: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "currentPhase", "phaseName", "phaseDescription", "tasks", "dependencies", "successCriteria"];
+/**
+ * Required fields for .claude/rules/* generation
+ */
+export declare const RULES_REQUIRED_FIELDS: readonly ["projectName", "techStack"];
+/**
+ * Required fields for forge.config.json generation
+ */
+export declare const CONFIG_REQUIRED_FIELDS: readonly ["projectName", "version", "mode", "depth", "maxTeammates", "taskLimit", "agentProfile", "workflow", "git"];
+/**
+ * All required field sets
+ */
+export declare const REQUIRED_FIELDS: {
+    readonly core: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone"];
+    readonly claude: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "techStack.backend", "patterns", "rules"];
+    readonly project: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "problemStatement", "solution", "architectureDiagram", "successMetrics"];
+    readonly requirements: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "features", "nfrs"];
+    readonly roadmap: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "milestones", "phases", "dependencyGraph", "definitionOfDone"];
+    readonly plan: readonly ["projectName", "version", "timestamp", "vision", "techStack", "patterns", "rules", "definitionOfDone", "currentPhase", "phaseName", "phaseDescription", "tasks", "dependencies", "successCriteria"];
+    readonly rules: readonly ["projectName", "techStack"];
+    readonly config: readonly ["projectName", "version", "mode", "depth", "maxTeammates", "taskLimit", "agentProfile", "workflow", "git"];
+};
+/**
+ * Type for required field sets
+ */
+export type RequiredFieldSet = keyof typeof REQUIRED_FIELDS;
+/**
+ * Validate that context has all required fields for a specific template
+ */
+export declare function validateRequiredFields(context: Record<string, unknown>, fieldSet: RequiredFieldSet): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * Get human-readable description of required fields
+ */
+export declare function getFieldDescriptions(): Record<string, string>;
+/**
+ * Prompt questions for CLI-ENGINE to use
+ */
+export declare function getPromptQuestions(fieldSet: RequiredFieldSet): {
+    name: "mode" | "depth" | "maxTeammates" | "taskLimit" | "agentProfile" | "workflow" | "git" | "version" | "rules" | "projectName" | "timestamp" | "vision" | "techStack" | "patterns" | "definitionOfDone" | "techStack.backend" | "problemStatement" | "solution" | "architectureDiagram" | "successMetrics" | "features" | "nfrs" | "milestones" | "phases" | "dependencyGraph" | "currentPhase" | "phaseName" | "phaseDescription" | "tasks" | "dependencies" | "successCriteria";
+    description: string;
+    required: boolean;
+}[];
+//# sourceMappingURL=required-fields.d.ts.map

package/dist/generators/required-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields.d.ts","sourceRoot":"","sources":["../../src/generators/required-fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,kHASvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB,4JAKzB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB,2LAM1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,4BAA4B,sIAI/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB,iLAM1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB,+MAQvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB,uCAGxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB,sHAUzB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE5D;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,gBAAgB,GACzB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAuBvC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsC7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB;;;;IAS5D"}

package/dist/generators/required-fields.js

@@ -0,0 +1,179 @@
+/**
+ * Required fields for TemplateContext validation
+ *
+ * CLI-ENGINE uses these to prompt users and validate collected data.
+ */
+/**
+ * Minimum required fields for basic template rendering
+ */
+export const CORE_REQUIRED_FIELDS = [
+    'projectName',
+    'version',
+    'timestamp',
+    'vision',
+    'techStack',
+    'patterns',
+    'rules',
+    'definitionOfDone',
+];
+/**
+ * Required fields for CLAUDE.md generation
+ */
+export const CLAUDE_REQUIRED_FIELDS = [
+    ...CORE_REQUIRED_FIELDS,
+    'techStack.backend',
+    'patterns',
+    'rules',
+];
+/**
+ * Required fields for PROJECT.md generation
+ */
+export const PROJECT_REQUIRED_FIELDS = [
+    ...CORE_REQUIRED_FIELDS,
+    'problemStatement',
+    'solution',
+    'architectureDiagram',
+    'successMetrics',
+];
+/**
+ * Required fields for REQUIREMENTS.md generation
+ */
+export const REQUIREMENTS_REQUIRED_FIELDS = [
+    ...CORE_REQUIRED_FIELDS,
+    'features',
+    'nfrs',
+];
+/**
+ * Required fields for ROADMAP.md generation
+ */
+export const ROADMAP_REQUIRED_FIELDS = [
+    ...CORE_REQUIRED_FIELDS,
+    'milestones',
+    'phases',
+    'dependencyGraph',
+    'definitionOfDone',
+];
+/**
+ * Required fields for PLAN.md generation
+ */
+export const PLAN_REQUIRED_FIELDS = [
+    ...CORE_REQUIRED_FIELDS,
+    'currentPhase',
+    'phaseName',
+    'phaseDescription',
+    'tasks',
+    'dependencies',
+    'successCriteria',
+];
+/**
+ * Required fields for .claude/rules/* generation
+ */
+export const RULES_REQUIRED_FIELDS = [
+    'projectName',
+    'techStack',
+];
+/**
+ * Required fields for forge.config.json generation
+ */
+export const CONFIG_REQUIRED_FIELDS = [
+    'projectName',
+    'version',
+    'mode',
+    'depth',
+    'maxTeammates',
+    'taskLimit',
+    'agentProfile',
+    'workflow',
+    'git',
+];
+/**
+ * All required field sets
+ */
+export const REQUIRED_FIELDS = {
+    core: CORE_REQUIRED_FIELDS,
+    claude: CLAUDE_REQUIRED_FIELDS,
+    project: PROJECT_REQUIRED_FIELDS,
+    requirements: REQUIREMENTS_REQUIRED_FIELDS,
+    roadmap: ROADMAP_REQUIRED_FIELDS,
+    plan: PLAN_REQUIRED_FIELDS,
+    rules: RULES_REQUIRED_FIELDS,
+    config: CONFIG_REQUIRED_FIELDS,
+};
+/**
+ * Validate that context has all required fields for a specific template
+ */
+export function validateRequiredFields(context, fieldSet) {
+    const required = REQUIRED_FIELDS[fieldSet];
+    const missing = [];
+    for (const field of required) {
+        const parts = field.split('.');
+        let current = context;
+        for (const part of parts) {
+            if (current && typeof current === 'object' && part in current) {
+                current = current[part];
+            }
+            else {
+                missing.push(field);
+                current = undefined;
+                break;
+            }
+        }
+    }
+    return {
+        valid: missing.length === 0,
+        missing,
+    };
+}
+/**
+ * Get human-readable description of required fields
+ */
+export function getFieldDescriptions() {
+    return {
+        // Core fields
+        projectName: 'The name of your project',
+        version: 'Project version (e.g., "0.1.0", "1.0.0")',
+        timestamp: 'ISO timestamp of generation (auto-generated)',
+        vision: 'Brief statement of what the project will achieve',
+        techStack: 'Technology choices (backend, frontend, database, infrastructure)',
+        patterns: 'Core architectural patterns used in the project',
+        rules: 'Hard rules and constraints for the project',
+        definitionOfDone: 'Criteria that define when a milestone is complete',
+        // Extended fields
+        problemStatement: 'What problem does this project solve?',
+        solution: 'High-level approach to solving the problem',
+        architectureDiagram: 'Text-based diagram showing system architecture',
+        successMetrics: 'Measurable goals that indicate project success',
+        features: 'List of features with user stories and acceptance criteria',
+        nfrs: 'Non-functional requirements (performance, security, scalability, etc.)',
+        milestones: 'Major milestones with deliverables and dependencies',
+        phases: 'Development phases broken down from milestones',
+        dependencyGraph: 'Visual representation of task dependencies',
+        currentPhase: 'Current phase being planned/executed',
+        phaseName: 'Human-readable name of current phase',
+        phaseDescription: 'Detailed description of current phase goals',
+        tasks: 'List of tasks with owners, dependencies, and acceptance criteria',
+        dependencies: 'Task dependency information for graph generation',
+        successCriteria: 'Criteria that define successful phase completion',
+        // Config fields
+        mode: 'Execution mode: "yolo" (auto-approve) or "interactive"',
+        depth: 'Planning depth: "quick", "standard", or "comprehensive"',
+        maxTeammates: 'Maximum number of parallel agents (2-6)',
+        taskLimit: 'Maximum tasks per teammate (3-8)',
+        agentProfile: 'Quality tier: "quality", "balanced", or "budget"',
+        workflow: 'Workflow toggle settings (research, planCheck, tribunal, contractFirst)',
+        git: 'Git strategy settings (strategy, branchTemplate, squashOnShip)',
+    };
+}
+/**
+ * Prompt questions for CLI-ENGINE to use
+ */
+export function getPromptQuestions(fieldSet) {
+    const descriptions = getFieldDescriptions();
+    const required = REQUIRED_FIELDS[fieldSet];
+    return required.map((field) => ({
+        name: field,
+        description: descriptions[field] || `Enter ${field}`,
+        required: true,
+    }));
+}
+//# sourceMappingURL=required-fields.js.map

package/dist/generators/required-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields.js","sourceRoot":"","sources":["../../src/generators/required-fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa;IACb,SAAS;IACT,WAAW;IACX,QAAQ;IACR,WAAW;IACX,UAAU;IACV,OAAO;IACP,kBAAkB;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,GAAG,oBAAoB;IACvB,mBAAmB;IACnB,UAAU;IACV,OAAO;CACC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,oBAAoB;IACvB,kBAAkB;IAClB,UAAU;IACV,qBAAqB;IACrB,gBAAgB;CACR,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,GAAG,oBAAoB;IACvB,UAAU;IACV,MAAM;CACE,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,oBAAoB;IACvB,YAAY;IACZ,QAAQ;IACR,iBAAiB;IACjB,kBAAkB;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,oBAAoB;IACvB,cAAc;IACd,WAAW;IACX,kBAAkB;IAClB,OAAO;IACP,cAAc;IACd,iBAAiB;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,aAAa;IACb,WAAW;CACH,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa;IACb,SAAS;IACT,MAAM;IACN,OAAO;IACP,cAAc;IACd,WAAW;IACX,cAAc;IACd,UAAU;IACV,KAAK;CACG,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,uBAAuB;IAChC,YAAY,EAAE,4BAA4B;IAC1C,OAAO,EAAE,uBAAuB;IAChC,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,qBAAqB;IAC5B,MAAM,EAAE,sBAAsB;CACtB,CAAC;AAOX;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgC,EAChC,QAA0B;IAE1B,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,OAAO,GAAY,OAAO,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC9D,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,GAAG,SAAS,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QAC3B,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,cAAc;QACd,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,0CAA0C;QACnD,SAAS,EAAE,8CAA8C;QACzD,MAAM,EAAE,kDAAkD;QAC1D,SAAS,EAAE,kEAAkE;QAC7E,QAAQ,EAAE,iDAAiD;QAC3D,KAAK,EAAE,4CAA4C;QACnD,gBAAgB,EAAE,mDAAmD;QAErE,kBAAkB;QAClB,gBAAgB,EAAE,uCAAuC;QACzD,QAAQ,EAAE,4CAA4C;QACtD,mBAAmB,EAAE,gDAAgD;QACrE,cAAc,EAAE,gDAAgD;QAChE,QAAQ,EAAE,4DAA4D;QACtE,IAAI,EAAE,wEAAwE;QAC9E,UAAU,EAAE,qDAAqD;QACjE,MAAM,EAAE,gDAAgD;QACxD,eAAe,EAAE,4CAA4C;QAC7D,YAAY,EAAE,sCAAsC;QACpD,SAAS,EAAE,sCAAsC;QACjD,gBAAgB,EAAE,6CAA6C;QAC/D,KAAK,EAAE,kEAAkE;QACzE,YAAY,EAAE,kDAAkD;QAChE,eAAe,EAAE,kDAAkD;QAEnE,gBAAgB;QAChB,IAAI,EAAE,wDAAwD;QAC9D,KAAK,EAAE,yDAAyD;QAChE,YAAY,EAAE,yCAAyC;QACvD,SAAS,EAAE,kCAAkC;QAC7C,YAAY,EAAE,kDAAkD;QAChE,QAAQ,EAAE,yEAAyE;QACnF,GAAG,EAAE,gEAAgE;KACtE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA0B;IAC3D,MAAM,YAAY,GAAG,oBAAoB,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE3C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,EAAE;QACpD,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/generators/template-engine.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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 type { TemplateContext, TemplateConfig, RenderResult } from './types.js';
+/**
+ * Template Engine class
+ */
+export declare class TemplateEngine {
+    private config;
+    private handlebars;
+    constructor(config: TemplateConfig);
+    /**
+     * Register custom Handlebars helpers
+     */
+    private registerHelpers;
+    /**
+     * Load a template file
+     */
+    private loadTemplate;
+    /**
+     * Get token limit for a specific template
+     */
+    private getTokenLimit;
+    /**
+     * Render a template with the given context
+     */
+    render(templateName: string, context: TemplateContext): Promise<RenderResult>;
+    /**
+     * Render a template string directly (without loading from file)
+     */
+    renderString(templateString: string, context: TemplateContext): string;
+    /**
+     * Render multiple templates in batch
+     */
+    renderBatch(templates: Array<{
+        name: string;
+        context: TemplateContext;
+    }>): Promise<Map<string, RenderResult>>;
+    /**
+     * Validate context data structure
+     */
+    validateContext(context: TemplateContext): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Create a partial template that can be included in other templates
+     */
+    registerPartial(name: string, templateString: string): void;
+    /**
+     * Register a partial from a file
+     */
+    registerPartialFromFile(name: string, partialPath: string): Promise<void>;
+}
+/**
+ * Create a template engine instance with default configuration
+ */
+export declare function createTemplateEngine(config?: Partial<TemplateConfig>): TemplateEngine;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/generators/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/generators/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAG7F;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAAoB;gBAE1B,MAAM,EAAE,cAAc;IAMlC;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;OAEG;YACW,YAAY;IAK1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IA+BnF;;OAEG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM;IAStE;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,eAAe,CAAA;KAAE,CAAC,GAC3D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAWrC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAgC/E;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAI3D;;OAEG;IACG,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAcrF"}