cc-agentic-framework 1.14.1

package/dist/lib/unified-template-engine/resolver.js

@@ -0,0 +1,312 @@
+/**
+ * Template Resolver
+ *
+ * Resolves template locations using the priority order: project > module > CLI defaults.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import fg from 'fast-glob';
+import { fileURLToPath } from 'url';
+import { isLegacyConfig, normalizeLegacyConfig } from './validator.js';
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirPath = path.dirname(currentFilePath);
+/**
+ * Template Resolver class
+ *
+ * Resolves templates from multiple locations with priority ordering.
+ */
+export class TemplateResolver {
+    projectRoot;
+    moduleId;
+    templateCategory;
+    configCache = new Map();
+    constructor(context) {
+        this.projectRoot = context.projectRoot;
+        this.moduleId = context.moduleId;
+        this.templateCategory = context.templateCategory;
+    }
+    /**
+     * Get CLI bundled templates directory
+     */
+    getCliTemplatePaths() {
+        return [
+            // Relative to dist/lib/unified-template-engine -> framework/modules
+            // When running from framework/cli/dist/lib/unified-template-engine:
+            // ../../../../ = framework/, then /modules = framework/modules
+            path.resolve(currentDirPath, '../../../../modules'),
+            // Alternative: 5 levels up then framework/modules (from project root)
+            path.resolve(currentDirPath, '../../../../../framework/modules'),
+        ];
+    }
+    /**
+     * Get all possible template search paths
+     */
+    getSearchPaths(category) {
+        const searchPaths = [];
+        const cat = category || this.templateCategory;
+        // 1. Project-local overrides (.claude/skills/<category>/templates)
+        if (cat) {
+            searchPaths.push({
+                path: path.join(this.projectRoot, '.claude/skills', cat, 'templates'),
+                source: 'project',
+            });
+        }
+        // 2. Project .claude/skills directory (synced from modules)
+        if (cat) {
+            searchPaths.push({
+                path: path.join(this.projectRoot, '.claude/skills', cat, 'templates'),
+                source: 'project',
+            });
+        }
+        // 3. Module templates if moduleId specified
+        if (this.moduleId && cat) {
+            searchPaths.push({
+                path: path.join(this.projectRoot, 'framework/modules', this.moduleId, 'skills', '*', cat, 'templates'),
+                source: 'module',
+            });
+        }
+        // 4. Search in framework modules (for core templates)
+        if (cat) {
+            searchPaths.push({
+                path: path.join(this.projectRoot, 'framework/modules/*/skills/*', cat, 'templates'),
+                source: 'module',
+            });
+            // Also check core/templates directly
+            searchPaths.push({
+                path: path.join(this.projectRoot, 'framework/modules/core/templates', cat),
+                source: 'module',
+            });
+        }
+        // 5. CLI bundled defaults
+        for (const cliPath of this.getCliTemplatePaths()) {
+            if (cat) {
+                searchPaths.push({
+                    path: path.join(cliPath, '*/skills/*', cat, 'templates'),
+                    source: 'cli',
+                });
+                searchPaths.push({
+                    path: path.join(cliPath, 'core/templates', cat),
+                    source: 'cli',
+                });
+            }
+        }
+        return searchPaths;
+    }
+    /**
+     * Load and cache template config from a directory
+     */
+    async loadConfig(configDir) {
+        // Check cache
+        const cachedConfig = this.configCache.get(configDir);
+        if (cachedConfig) {
+            return cachedConfig;
+        }
+        const configPath = path.join(configDir, 'template.config.json');
+        if (!(await fs.pathExists(configPath))) {
+            return null;
+        }
+        try {
+            const rawConfig = await fs.readJSON(configPath);
+            // Normalize legacy configs
+            const config = isLegacyConfig(rawConfig)
+                ? normalizeLegacyConfig(rawConfig)
+                : rawConfig;
+            this.configCache.set(configDir, config);
+            return config;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Find a specific template by name
+     */
+    async findTemplate(templateName, category) {
+        const searchPaths = this.getSearchPaths(category);
+        for (const { path: searchPath, source } of searchPaths) {
+            // Handle glob patterns
+            if (searchPath.includes('*')) {
+                const directories = await fg(searchPath, {
+                    onlyDirectories: true,
+                    absolute: true,
+                });
+                for (const dir of directories) {
+                    const result = await this.checkTemplateInDir(dir, templateName, source, category);
+                    if (result)
+                        return result;
+                }
+            }
+            else {
+                const result = await this.checkTemplateInDir(searchPath, templateName, source, category);
+                if (result)
+                    return result;
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if a template exists in a specific directory
+     */
+    async checkTemplateInDir(dir, templateName, source, category) {
+        if (!(await fs.pathExists(dir))) {
+            return null;
+        }
+        const config = await this.loadConfig(dir);
+        if (!config)
+            return null;
+        // Check if template is defined in config
+        if (!(templateName in config.templates)) {
+            return null;
+        }
+        // Try multiple file naming patterns
+        const possiblePaths = [
+            path.join(dir, `${templateName}.md`), // story.template -> story.template.md
+            path.join(dir, `${templateName}.template.md`), // agent -> agent.template.md
+            path.join(dir, `${templateName}.template`), // SKILL.md -> SKILL.md.template
+            path.join(dir, templateName), // SKILL.md -> SKILL.md
+        ];
+        let finalTemplatePath = null;
+        for (const candidatePath of possiblePaths) {
+            if (await fs.pathExists(candidatePath)) {
+                finalTemplatePath = candidatePath;
+                break;
+            }
+        }
+        if (!finalTemplatePath) {
+            return null;
+        }
+        return {
+            templatePath: finalTemplatePath,
+            configPath: path.join(dir, 'template.config.json'),
+            category: category || this.templateCategory || this.extractCategory(dir),
+            source,
+            config,
+            definition: config.templates[templateName],
+        };
+    }
+    /**
+     * Extract category from directory path
+     */
+    extractCategory(dir) {
+        // Try to extract from path like .../skills/<category>/templates
+        const parts = dir.split(path.sep);
+        const templatesIndex = parts.indexOf('templates');
+        if (templatesIndex > 0) {
+            return parts[templatesIndex - 1];
+        }
+        return 'unknown';
+    }
+    /**
+     * List all available templates
+     */
+    async listTemplates(category) {
+        const templates = [];
+        const seen = new Set();
+        // Search all possible locations
+        const allSearchPaths = category
+            ? this.getSearchPaths(category)
+            : await this.getAllCategories();
+        for (const { path: searchPath, source } of allSearchPaths) {
+            // Handle glob patterns
+            if (searchPath.includes('*')) {
+                const directories = await fg(searchPath, {
+                    onlyDirectories: true,
+                    absolute: true,
+                });
+                for (const dir of directories) {
+                    const items = await this.listTemplatesInDir(dir, source);
+                    for (const item of items) {
+                        const key = `${item.category}/${item.name}`;
+                        if (!seen.has(key)) {
+                            seen.add(key);
+                            templates.push(item);
+                        }
+                    }
+                }
+            }
+            else {
+                const items = await this.listTemplatesInDir(searchPath, source);
+                for (const item of items) {
+                    const key = `${item.category}/${item.name}`;
+                    if (!seen.has(key)) {
+                        seen.add(key);
+                        templates.push(item);
+                    }
+                }
+            }
+        }
+        return templates.sort((a, b) => a.category.localeCompare(b.category) || a.name.localeCompare(b.name));
+    }
+    /**
+     * List templates in a specific directory
+     */
+    async listTemplatesInDir(dir, source) {
+        if (!(await fs.pathExists(dir))) {
+            return [];
+        }
+        const config = await this.loadConfig(dir);
+        if (!config)
+            return [];
+        const category = this.extractCategory(dir);
+        const items = [];
+        for (const [name, def] of Object.entries(config.templates)) {
+            items.push({
+                name,
+                category,
+                description: def.description,
+                source,
+                requiredVariables: def.variables.required,
+            });
+        }
+        return items;
+    }
+    /**
+     * Get all category search paths (when no specific category is requested)
+     */
+    async getAllCategories() {
+        const paths = [];
+        // Project templates
+        paths.push({
+            path: path.join(this.projectRoot, '.claude/skills/*/templates'),
+            source: 'project',
+        });
+        paths.push({
+            path: path.join(this.projectRoot, '.claude/skills/*/templates'),
+            source: 'project',
+        });
+        // Module templates
+        paths.push({
+            path: path.join(this.projectRoot, 'framework/modules/*/skills/*/*/templates'),
+            source: 'module',
+        });
+        paths.push({
+            path: path.join(this.projectRoot, 'framework/modules/core/templates/*'),
+            source: 'module',
+        });
+        // CLI templates
+        for (const cliPath of this.getCliTemplatePaths()) {
+            paths.push({
+                path: path.join(cliPath, '*/skills/*/*/templates'),
+                source: 'cli',
+            });
+            paths.push({
+                path: path.join(cliPath, 'core/templates/*'),
+                source: 'cli',
+            });
+        }
+        return paths;
+    }
+    /**
+     * Clear the config cache
+     */
+    clearCache() {
+        this.configCache.clear();
+    }
+}
+/**
+ * Create a template resolver instance
+ */
+export function createResolver(context) {
+    return new TemplateResolver(context);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/lib/unified-template-engine/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/lib/unified-template-engine/resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAOpC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvE,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACnB,WAAW,CAAS;IACpB,QAAQ,CAAU;IAClB,gBAAgB,CAAU;IAC1B,WAAW,GAAgC,IAAI,GAAG,EAAE,CAAC;IAE7D,YAAY,OAAkC;QAC5C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,OAAO;YACL,oEAAoE;YACpE,oEAAoE;YACpE,+DAA+D;YAC/D,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,qBAAqB,CAAC;YACnD,sEAAsE;YACtE,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,kCAAkC,CAAC;SACjE,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,QAAiB;QACtC,MAAM,WAAW,GAAkE,EAAE,CAAC;QACtF,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,gBAAgB,CAAC;QAE9C,mEAAmE;QACnE,IAAI,GAAG,EAAE,CAAC;YACR,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;gBACrE,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QAED,4DAA4D;QAC5D,IAAI,GAAG,EAAE,CAAC;YACR,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;gBACrE,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QAED,4CAA4C;QAC5C,IAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC;gBACtG,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;QACL,CAAC;QAED,sDAAsD;QACtD,IAAI,GAAG,EAAE,CAAC;YACR,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,8BAA8B,EAAE,GAAG,EAAE,WAAW,CAAC;gBACnF,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YACH,qCAAqC;YACrC,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kCAAkC,EAAE,GAAG,CAAC;gBAC1E,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;QACL,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YACjD,IAAI,GAAG,EAAE,CAAC;gBACR,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,CAAC;oBACxD,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,CAAC;oBAC/C,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU,CAAC,SAAiB;QACxC,cAAc;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;QAEhE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAEhD,2BAA2B;YAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC;gBACtC,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC;gBAClC,CAAC,CAAE,SAA4B,CAAC;YAElC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACxC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,YAAoB,EAAE,QAAiB;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAElD,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YACvD,uBAAuB;YACvB,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,UAAU,EAAE;oBACvC,eAAe,EAAE,IAAI;oBACrB,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;gBAEH,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;oBAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAClF,IAAI,MAAM;wBAAE,OAAO,MAAM,CAAC;gBAC5B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACzF,IAAI,MAAM;oBAAE,OAAO,MAAM,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAC9B,GAAW,EACX,YAAoB,EACpB,MAAoC,EACpC,QAAiB;QAEjB,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,yCAAyC;QACzC,IAAI,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oCAAoC;QACpC,MAAM,aAAa,GAAG;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,EAAY,sCAAsC;YACtF,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,cAAc,CAAC,EAAG,6BAA6B;YAC7E,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,WAAW,CAAC,EAAM,gCAAgC;YAChF,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAoB,uBAAuB;SACxE,CAAC;QAEF,IAAI,iBAAiB,GAAkB,IAAI,CAAC;QAC5C,KAAK,MAAM,aAAa,IAAI,aAAa,EAAE,CAAC;YAC1C,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACvC,iBAAiB,GAAG,aAAa,CAAC;gBAClC,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,YAAY,EAAE,iBAAiB;YAC/B,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC;YAClD,QAAQ,EAAE,QAAQ,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;YACxE,MAAM;YACN,MAAM;YACN,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,GAAW;QACjC,gEAAgE;QAChE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,QAAiB;QACnC,MAAM,SAAS,GAAuB,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,gCAAgC;QAChC,MAAM,cAAc,GAAG,QAAQ;YAC7B,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YAC/B,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAElC,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;YAC1D,uBAAuB;YACvB,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,UAAU,EAAE;oBACvC,eAAe,EAAE,IAAI;oBACrB,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;gBAEH,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;oBAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;4BACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;4BACd,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACvB,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBAChE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBACd,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACxG,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAC9B,GAAW,EACX,MAAoC;QAEpC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAuB,EAAE,CAAC;QAErC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI;gBACJ,QAAQ;gBACR,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,MAAM;gBACN,iBAAiB,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,MAAM,KAAK,GAAkE,EAAE,CAAC;QAEhF,oBAAoB;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,4BAA4B,CAAC;YAC/D,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,4BAA4B,CAAC;YAC/D,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,mBAAmB;QACnB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,0CAA0C,CAAC;YAC7E,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oCAAoC,CAAC;YACvE,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,gBAAgB;QAChB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,wBAAwB,CAAC;gBAClD,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC;gBAC5C,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAkC;IAC/D,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/unified-template-engine/types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Unified Template Engine Types
+ *
+ * TypeScript interfaces for the template configuration and rendering system.
+ */
+/**
+ * Variable validation rules for a single variable
+ */
+export interface VariableValidation {
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    enum?: string[];
+}
+/**
+ * Variable configuration for a template
+ */
+export interface VariableConfig {
+    required: string[];
+    optional: string[];
+    computed: ComputedVariable[];
+}
+/**
+ * Computed variable types that the engine can auto-generate
+ */
+export type ComputedVariable = 'date' | 'datetime' | 'year' | 'number' | 'uuid' | 'user';
+/**
+ * Configuration for a single template
+ */
+export interface TemplateDefinition {
+    output: string;
+    variables: VariableConfig;
+    defaults: Record<string, string>;
+    validation?: Record<string, VariableValidation>;
+    description?: string;
+}
+/**
+ * Auto-numbering configuration
+ */
+export interface AutoNumberingConfig {
+    pattern: string;
+    padding: number;
+    startFrom?: number;
+}
+/**
+ * Complete template.config.json structure
+ */
+export interface TemplateConfig {
+    $schema?: string;
+    version: string;
+    templates: Record<string, TemplateDefinition>;
+    autoNumbering?: AutoNumberingConfig;
+    defaults?: Record<string, string>;
+}
+/**
+ * Legacy template config (pre-v1.0, without version field)
+ */
+export interface LegacyTemplateConfig {
+    templates: Record<string, {
+        output: string;
+        variables: {
+            required: string[];
+            optional?: string[];
+        };
+        defaults?: Record<string, string>;
+    }>;
+    autoNumbering?: {
+        pattern: string;
+        padding: number;
+    };
+}
+/**
+ * Template resolution context
+ */
+export interface TemplateResolutionContext {
+    /** User's project root directory */
+    projectRoot: string;
+    /** Optional: specific module to look in */
+    moduleId?: string;
+    /** Template category (e.g., 'backlog', 'planning', 'context') */
+    templateCategory?: string;
+}
+/**
+ * Template rendering options
+ */
+export interface RenderOptions {
+    /** Variables to substitute in the template */
+    variables: Record<string, string>;
+    /** Override output path (otherwise uses config) */
+    outputPath?: string;
+    /** Preview without writing files */
+    dryRun?: boolean;
+    /** Skip variable validation */
+    skipValidation?: boolean;
+    /** Directory for auto-numbering scan */
+    numberingDirectory?: string;
+}
+/**
+ * Result of template rendering
+ */
+export interface RenderResult {
+    /** Rendered template content */
+    content: string;
+    /** Output path (where file was/would be written) */
+    outputPath: string;
+    /** All variables used (including computed) */
+    variables: Record<string, string>;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+}
+/**
+ * Validation result for variables or config
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+/**
+ * Validation error detail
+ */
+export interface ValidationError {
+    type: 'missing_required' | 'invalid_pattern' | 'invalid_length' | 'invalid_enum' | 'unknown_variable' | 'schema_error';
+    variable?: string;
+    message: string;
+    expected?: string;
+    actual?: string;
+}
+/**
+ * Validation warning detail
+ */
+export interface ValidationWarning {
+    type: 'unknown_variable' | 'deprecated' | 'legacy_config';
+    variable?: string;
+    message: string;
+}
+/**
+ * Template info returned by getInfo()
+ */
+export interface TemplateInfo {
+    name: string;
+    output: string;
+    variables: VariableConfig;
+    defaults: Record<string, string>;
+    validation?: Record<string, VariableValidation>;
+    description?: string;
+    category?: string;
+    source: 'project' | 'module' | 'cli';
+}
+/**
+ * Template list item
+ */
+export interface TemplateListItem {
+    name: string;
+    category: string;
+    description?: string;
+    source: 'project' | 'module' | 'cli';
+    requiredVariables: string[];
+}
+/**
+ * Resolved template location
+ */
+export interface ResolvedTemplate {
+    /** Full path to template file */
+    templatePath: string;
+    /** Full path to config file */
+    configPath: string;
+    /** Template category */
+    category: string;
+    /** Source of the template */
+    source: 'project' | 'module' | 'cli';
+    /** Loaded config */
+    config: TemplateConfig;
+    /** Template definition from config */
+    definition: TemplateDefinition;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/unified-template-engine/types.d.ts.map

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

package/dist/lib/unified-template-engine/types.js

@@ -0,0 +1,7 @@
+/**
+ * Unified Template Engine Types
+ *
+ * TypeScript interfaces for the template configuration and rendering system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/unified-template-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/unified-template-engine/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/lib/unified-template-engine/validator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Template Validator
+ *
+ * Validates template configurations and variables against schemas and rules.
+ */
+import type { TemplateConfig, LegacyTemplateConfig, TemplateDefinition, ValidationResult } from './types.js';
+/**
+ * Validate a template config against the schema
+ */
+export declare function validateConfig(config: unknown): Promise<ValidationResult>;
+/**
+ * Validate variables against template definition
+ */
+export declare function validateVariables(definition: TemplateDefinition, variables: Record<string, string>): ValidationResult;
+/**
+ * Normalize a legacy config to v1.0 format
+ */
+export declare function normalizeLegacyConfig(legacy: LegacyTemplateConfig): TemplateConfig;
+/**
+ * Check if config is legacy format
+ */
+export declare function isLegacyConfig(config: unknown): config is LegacyTemplateConfig;
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/unified-template-engine/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/lib/unified-template-engine/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AA4BpB;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiD/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,gBAAgB,CAiDlB;AAiED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAoBlF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,oBAAoB,CAO9E"}