cc-agentic-framework 1.14.1

package/dist/lib/skill-cli-parser.js

@@ -0,0 +1,172 @@
+import fs from 'fs-extra';
+import fg from 'fast-glob';
+import matter from 'gray-matter';
+/**
+ * Parse CLI commands from a skill file
+ * @param skillPath - Path to SKILL.md file
+ * @returns Skill CLI metadata
+ */
+export async function parseSkillCli(skillPath) {
+    // Read file content
+    const content = await fs.readFile(skillPath, 'utf-8');
+    // Parse frontmatter
+    const { data } = matter(content);
+    // Extract required fields
+    const id = data.id;
+    const module = data.module;
+    if (!id) {
+        throw new Error(`Skill at ${skillPath} is missing required field: id`);
+    }
+    if (!module) {
+        throw new Error(`Skill at ${skillPath} is missing required field: module`);
+    }
+    // Extract CLI commands if present
+    const cliCommands = data['cli-commands'];
+    return {
+        id,
+        module,
+        cliCommands,
+    };
+}
+/**
+ * Parse full skill metadata including CLI commands
+ * @param skillPath - Path to SKILL.md file
+ * @returns Full skill metadata
+ */
+export async function parseSkillMetadata(skillPath) {
+    const content = await fs.readFile(skillPath, 'utf-8');
+    const { data } = matter(content);
+    const id = data.id;
+    const module = data.module;
+    if (!id) {
+        throw new Error(`Skill at ${skillPath} is missing required field: id`);
+    }
+    if (!module) {
+        throw new Error(`Skill at ${skillPath} is missing required field: module`);
+    }
+    const cliCommands = data['cli-commands'];
+    return {
+        id,
+        module,
+        name: data.name,
+        description: data.description,
+        cliCommands,
+        filePath: skillPath,
+    };
+}
+/**
+ * Find all SKILL.md files in framework
+ * @param frameworkRoot - Root directory of the framework
+ * @returns Array of skill file paths
+ */
+async function findSkillFiles(frameworkRoot) {
+    // Look in framework/core/skills and framework/modules/*/skills
+    const patterns = [
+        'framework/core/skills/**/SKILL.md',
+        'framework/modules/*/skills/**/SKILL.md',
+    ];
+    const files = [];
+    for (const pattern of patterns) {
+        const matches = await fg(pattern, {
+            cwd: frameworkRoot,
+            absolute: true,
+            followSymbolicLinks: false,
+        });
+        files.push(...matches);
+    }
+    return files;
+}
+/**
+ * Get all skills with CLI commands
+ * @param frameworkRoot - Root directory of the framework
+ * @returns Array of skill CLI metadata for skills that have CLI commands
+ */
+export async function getAllSkillsWithCli(frameworkRoot) {
+    const skillFiles = await findSkillFiles(frameworkRoot);
+    const skills = [];
+    for (const skillPath of skillFiles) {
+        try {
+            const metadata = await parseSkillCli(skillPath);
+            // Only include skills that have CLI commands
+            if (metadata.cliCommands && Object.keys(metadata.cliCommands).length > 0) {
+                skills.push(metadata);
+            }
+        }
+        catch (error) {
+            // Log warning but continue processing other skills
+            console.warn(`Warning: Failed to parse skill at ${skillPath}:`, error);
+        }
+    }
+    return skills;
+}
+/**
+ * Get all skills (including those without CLI commands)
+ * @param frameworkRoot - Root directory of the framework
+ * @returns Array of full skill metadata
+ */
+export async function getAllSkills(frameworkRoot) {
+    const skillFiles = await findSkillFiles(frameworkRoot);
+    const skills = [];
+    for (const skillPath of skillFiles) {
+        try {
+            const metadata = await parseSkillMetadata(skillPath);
+            skills.push(metadata);
+        }
+        catch (error) {
+            // Log warning but continue processing other skills
+            console.warn(`Warning: Failed to parse skill at ${skillPath}:`, error);
+        }
+    }
+    return skills;
+}
+/**
+ * Find a specific skill by ID
+ * @param frameworkRoot - Root directory of the framework
+ * @param skillId - Skill ID to find
+ * @returns Skill metadata or null if not found
+ */
+export async function findSkillById(frameworkRoot, skillId) {
+    const skills = await getAllSkills(frameworkRoot);
+    return skills.find((s) => s.id === skillId) || null;
+}
+/**
+ * Find skills by module
+ * @param frameworkRoot - Root directory of the framework
+ * @param moduleName - Module name to filter by
+ * @returns Array of skill metadata for the module
+ */
+export async function findSkillsByModule(frameworkRoot, moduleName) {
+    const skills = await getAllSkills(frameworkRoot);
+    return skills.filter((s) => s.module === moduleName);
+}
+/**
+ * Validate CLI command configuration
+ * @param config - CLI command configuration to validate
+ * @returns True if valid, throws error otherwise
+ */
+export function validateCliCommand(config) {
+    if (!config.command) {
+        throw new Error('CLI command is missing required field: command');
+    }
+    if (!config.description) {
+        throw new Error('CLI command is missing required field: description');
+    }
+    if (!Array.isArray(config.options)) {
+        throw new Error('CLI command options must be an array');
+    }
+    return true;
+}
+/**
+ * Get CLI command by name from skill
+ * @param skillPath - Path to skill file
+ * @param commandName - Command name to retrieve
+ * @returns CLI command configuration or null if not found
+ */
+export async function getCliCommand(skillPath, commandName) {
+    const metadata = await parseSkillCli(skillPath);
+    if (!metadata.cliCommands) {
+        return null;
+    }
+    return metadata.cliCommands[commandName] || null;
+}
+//# sourceMappingURL=skill-cli-parser.js.map

package/dist/lib/skill-cli-parser.js.map

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

package/dist/lib/skill-template-engine.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @deprecated This module is deprecated. Use `unified-template-engine` instead.
+ * This file is kept for backward compatibility and will be removed in v2.0.
+ *
+ * Migration:
+ * - Import from './unified-template-engine/index.js' instead
+ * - Use `createUnifiedTemplateEngine()` instead of `new SkillTemplateEngine()`
+ * - The UnifiedTemplateEngine provides the same functionality with additional features
+ */
+/**
+ * Template variable configuration
+ * @deprecated Use types from unified-template-engine instead
+ */
+interface VariableConfig {
+    required: string[];
+    optional: string[];
+}
+/**
+ * Template configuration for a single template
+ */
+interface TemplateInfo {
+    output: string;
+    variables: VariableConfig;
+    defaults: Record<string, string>;
+}
+/**
+ * Auto-numbering configuration
+ */
+interface AutoNumberingConfig {
+    pattern: string;
+    padding: number;
+}
+/**
+ * Complete template configuration
+ */
+export interface TemplateConfig {
+    templates: Record<string, TemplateInfo>;
+    autoNumbering?: AutoNumberingConfig;
+}
+/**
+ * Template rendering options
+ */
+export interface RenderOptions {
+    variables: Record<string, string>;
+    skipValidation?: boolean;
+}
+/**
+ * Skill template engine for rendering templates with variable substitution
+ */
+export declare class SkillTemplateEngine {
+    private templateDir;
+    private config;
+    constructor(templateDir: string);
+    /**
+     * Load template configuration
+     */
+    private loadConfig;
+    /**
+     * Get template info by name
+     */
+    private getTemplateInfo;
+    /**
+     * Validate variables against template requirements
+     */
+    private validateVariables;
+    /**
+     * Merge variables with defaults
+     */
+    private mergeWithDefaults;
+    /**
+     * Replace template variables in content
+     * Supports {{variable}} syntax
+     */
+    private replaceVariables;
+    /**
+     * Get the next number for auto-numbering
+     * Scans existing files in the directory to find the highest number
+     */
+    getNextNumber(directory: string, pattern?: string): Promise<number>;
+    /**
+     * Format a number with padding
+     */
+    private formatNumber;
+    /**
+     * Render a template with variables
+     * @param templateName - Name of the template to render
+     * @param options - Rendering options with variables
+     * @returns Rendered template content
+     */
+    render(templateName: string, options: RenderOptions): Promise<string>;
+    /**
+     * Render and write template to output file
+     * @param templateName - Name of the template
+     * @param options - Rendering options
+     * @param outputPath - Output file path (optional, uses config if not provided)
+     */
+    renderToFile(templateName: string, options: RenderOptions, outputPath?: string): Promise<string>;
+    /**
+     * Get auto-numbering configuration
+     */
+    getAutoNumberingConfig(): Promise<AutoNumberingConfig | undefined>;
+    /**
+     * List available templates
+     */
+    listTemplates(): Promise<string[]>;
+    /**
+     * Get template info
+     */
+    getInfo(templateName: string): Promise<TemplateInfo>;
+}
+/**
+ * Create a template engine instance
+ */
+export declare function createTemplateEngine(templateDir: string): SkillTemplateEngine;
+export {};
+//# sourceMappingURL=skill-template-engine.d.ts.map

package/dist/lib/skill-template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-template-engine.d.ts","sourceRoot":"","sources":["../../src/lib/skill-template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAWD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAA+B;gBAEjC,WAAW,EAAE,MAAM;IAI/B;;OAEG;YACW,UAAU;IAkBxB;;OAEG;YACW,eAAe;IAY7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2CzE;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;OAKG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAsC3E;;;;;OAKG;IACG,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAyBlB;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAKxE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxC;;OAEG;IACG,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAG3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAE7E"}

package/dist/lib/skill-template-engine.js

@@ -0,0 +1,220 @@
+/**
+ * @deprecated This module is deprecated. Use `unified-template-engine` instead.
+ * This file is kept for backward compatibility and will be removed in v2.0.
+ *
+ * Migration:
+ * - Import from './unified-template-engine/index.js' instead
+ * - Use `createUnifiedTemplateEngine()` instead of `new SkillTemplateEngine()`
+ * - The UnifiedTemplateEngine provides the same functionality with additional features
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import fg from 'fast-glob';
+/**
+ * Skill template engine for rendering templates with variable substitution
+ */
+export class SkillTemplateEngine {
+    templateDir;
+    config = null;
+    constructor(templateDir) {
+        this.templateDir = templateDir;
+    }
+    /**
+     * Load template configuration
+     */
+    async loadConfig() {
+        if (this.config) {
+            return this.config;
+        }
+        const configPath = path.join(this.templateDir, 'template.config.json');
+        if (!(await fs.pathExists(configPath))) {
+            throw new Error(`Template configuration not found at ${configPath}`);
+        }
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const parsedConfig = JSON.parse(configContent);
+        this.config = parsedConfig;
+        return parsedConfig;
+    }
+    /**
+     * Get template info by name
+     */
+    async getTemplateInfo(templateName) {
+        const config = await this.loadConfig();
+        if (!config.templates[templateName]) {
+            throw new Error(`Template "${templateName}" not found. Available templates: ${Object.keys(config.templates).join(', ')}`);
+        }
+        return config.templates[templateName];
+    }
+    /**
+     * Validate variables against template requirements
+     */
+    validateVariables(templateInfo, variables) {
+        const missing = [];
+        const unknown = [];
+        // Check required variables
+        for (const required of templateInfo.variables.required) {
+            if (!(required in variables)) {
+                missing.push(required);
+            }
+        }
+        // Check for unknown variables
+        const allowedVars = new Set([
+            ...templateInfo.variables.required,
+            ...templateInfo.variables.optional,
+        ]);
+        for (const varName of Object.keys(variables)) {
+            if (!allowedVars.has(varName)) {
+                unknown.push(varName);
+            }
+        }
+        return {
+            valid: missing.length === 0,
+            missing,
+            unknown,
+        };
+    }
+    /**
+     * Merge variables with defaults
+     */
+    mergeWithDefaults(templateInfo, variables) {
+        return {
+            ...templateInfo.defaults,
+            ...variables,
+        };
+    }
+    /**
+     * Replace template variables in content
+     * Supports {{variable}} syntax
+     */
+    replaceVariables(content, variables) {
+        let result = content;
+        // Replace all {{variable}} patterns
+        for (const [key, value] of Object.entries(variables)) {
+            const pattern = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
+            result = result.replace(pattern, value);
+        }
+        return result;
+    }
+    /**
+     * Get the next number for auto-numbering
+     * Scans existing files in the directory to find the highest number
+     */
+    async getNextNumber(directory, pattern) {
+        const config = await this.loadConfig();
+        if (!pattern && !config.autoNumbering) {
+            throw new Error('No auto-numbering pattern configured');
+        }
+        const numberingPattern = pattern || (config.autoNumbering ? config.autoNumbering.pattern : '');
+        // Convert pattern to glob pattern
+        // Example: "TICKET-{num}" -> "TICKET-*"
+        const globPattern = numberingPattern.replace(/\{num\}/g, '*');
+        // Find all matching files
+        const files = await fg(globPattern, {
+            cwd: directory,
+            onlyFiles: true,
+            absolute: false,
+        });
+        if (files.length === 0) {
+            return 1;
+        }
+        // Extract numbers from filenames
+        const numbers = [];
+        const regex = new RegExp(numberingPattern.replace(/\{num\}/g, '(\\d+)'));
+        for (const file of files) {
+            const match = file.match(regex);
+            if (match && match[1]) {
+                numbers.push(parseInt(match[1], 10));
+            }
+        }
+        if (numbers.length === 0) {
+            return 1;
+        }
+        // Return next number
+        return Math.max(...numbers) + 1;
+    }
+    /**
+     * Format a number with padding
+     */
+    formatNumber(num, padding) {
+        return num.toString().padStart(padding, '0');
+    }
+    /**
+     * Render a template with variables
+     * @param templateName - Name of the template to render
+     * @param options - Rendering options with variables
+     * @returns Rendered template content
+     */
+    async render(templateName, options) {
+        const templateInfo = await this.getTemplateInfo(templateName);
+        // Merge with defaults
+        const variables = this.mergeWithDefaults(templateInfo, options.variables);
+        // Validate variables unless skipped
+        if (!options.skipValidation) {
+            const validation = this.validateVariables(templateInfo, variables);
+            if (!validation.valid) {
+                throw new Error(`Missing required variables: ${validation.missing.join(', ')}`);
+            }
+            if (validation.unknown.length > 0) {
+                console.warn(`Warning: Unknown variables provided: ${validation.unknown.join(', ')}`);
+            }
+        }
+        // Load template file
+        const templatePath = path.join(this.templateDir, `${templateName}.md`);
+        if (!(await fs.pathExists(templatePath))) {
+            throw new Error(`Template file not found: ${templatePath}`);
+        }
+        const templateContent = await fs.readFile(templatePath, 'utf-8');
+        // Replace variables
+        const rendered = this.replaceVariables(templateContent, variables);
+        return rendered;
+    }
+    /**
+     * Render and write template to output file
+     * @param templateName - Name of the template
+     * @param options - Rendering options
+     * @param outputPath - Output file path (optional, uses config if not provided)
+     */
+    async renderToFile(templateName, options, outputPath) {
+        const templateInfo = await this.getTemplateInfo(templateName);
+        const rendered = await this.render(templateName, options);
+        // Determine output path
+        let finalOutputPath = outputPath;
+        if (!finalOutputPath) {
+            // Use output from config and replace variables
+            finalOutputPath = this.replaceVariables(templateInfo.output, this.mergeWithDefaults(templateInfo, options.variables));
+        }
+        // Ensure output directory exists
+        const outputDir = path.dirname(finalOutputPath);
+        await fs.ensureDir(outputDir);
+        // Write file
+        await fs.writeFile(finalOutputPath, rendered, 'utf-8');
+        return finalOutputPath;
+    }
+    /**
+     * Get auto-numbering configuration
+     */
+    async getAutoNumberingConfig() {
+        const config = await this.loadConfig();
+        return config.autoNumbering;
+    }
+    /**
+     * List available templates
+     */
+    async listTemplates() {
+        const config = await this.loadConfig();
+        return Object.keys(config.templates);
+    }
+    /**
+     * Get template info
+     */
+    async getInfo(templateName) {
+        return this.getTemplateInfo(templateName);
+    }
+}
+/**
+ * Create a template engine instance
+ */
+export function createTemplateEngine(templateDir) {
+    return new SkillTemplateEngine(templateDir);
+}
+//# sourceMappingURL=skill-template-engine.js.map

package/dist/lib/skill-template-engine.js.map

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