cc-agentic-framework 1.14.1

package/dist/lib/validation/schema-validator.d.ts

@@ -0,0 +1,26 @@
+import { ValidationReport } from './validation-report.js';
+/**
+ * Validate data against a JSON Schema
+ * @param data - Data to validate
+ * @param schemaPath - Absolute path to JSON Schema file
+ * @returns Validation report
+ */
+export declare function validateWithSchema(data: unknown, schemaPath: string): Promise<ValidationReport>;
+/**
+ * Validate data against a JSON Schema object (not file)
+ * @param data - Data to validate
+ * @param schema - JSON Schema object
+ * @returns Validation report
+ */
+export declare function validateWithSchemaObject(data: unknown, schema: object): ValidationReport;
+/**
+ * Validate multiple files against schemas
+ * @param files - Array of {data, schemaPath} objects
+ * @returns Merged validation report
+ */
+export declare function validateMultiple(files: Array<{
+    data: unknown;
+    schemaPath: string;
+    fileName?: string;
+}>): Promise<ValidationReport>;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/lib/validation/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/schema-validator.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,gBAAgB,EAIjB,MAAM,wBAAwB,CAAC;AAoBhC;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA0C3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,gBAAgB,CAgClB;AAsFD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,OAAO,CAAC,gBAAgB,CAAC,CAoB3B"}

package/dist/lib/validation/schema-validator.js

@@ -0,0 +1,183 @@
+import AjvModule from 'ajv';
+import ajvFormatsModule from 'ajv-formats';
+import fs from 'fs-extra';
+import { createReport, createError, } from './validation-report.js';
+// Ajv is exported as both default and named export
+const Ajv = AjvModule.default || AjvModule;
+// ajv-formats may be exported as default or as module.default in CommonJS/ESM interop
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const addFormats = ajvFormatsModule.default || ajvFormatsModule;
+/**
+ * AJV instance with default configuration and format support
+ */
+const ajv = new Ajv({
+    allErrors: true,
+    verbose: true,
+    strict: false,
+});
+// Add format validation support (date, time, email, uri, etc.)
+addFormats(ajv);
+/**
+ * Validate data against a JSON Schema
+ * @param data - Data to validate
+ * @param schemaPath - Absolute path to JSON Schema file
+ * @returns Validation report
+ */
+export async function validateWithSchema(data, schemaPath) {
+    const issues = [];
+    try {
+        // Check if file exists first
+        const exists = await fs.pathExists(schemaPath);
+        if (!exists) {
+            throw new Error(`Schema file not found: ${schemaPath}`);
+        }
+        // Load schema
+        const schemaContent = await fs.readFile(schemaPath, 'utf-8');
+        const schema = JSON.parse(schemaContent);
+        // Compile schema
+        const validate = ajv.compile(schema);
+        // Validate data
+        const valid = validate(data);
+        if (!valid && validate.errors) {
+            // Convert AJV errors to validation issues
+            for (const error of validate.errors) {
+                issues.push(convertAjvError(error, schemaPath));
+            }
+        }
+    }
+    catch (error) {
+        // Schema loading or parsing error
+        if (error instanceof Error) {
+            issues.push(createError('SCHEMA_ERROR', `Failed to load or parse schema: ${error.message}`, undefined, { file: schemaPath }, 'Ensure the schema file exists and contains valid JSON'));
+        }
+    }
+    return createReport(issues);
+}
+/**
+ * Validate data against a JSON Schema object (not file)
+ * @param data - Data to validate
+ * @param schema - JSON Schema object
+ * @returns Validation report
+ */
+export function validateWithSchemaObject(data, schema) {
+    const issues = [];
+    try {
+        // Compile schema
+        const validate = ajv.compile(schema);
+        // Validate data
+        const valid = validate(data);
+        if (!valid && validate.errors) {
+            // Convert AJV errors to validation issues
+            for (const error of validate.errors) {
+                issues.push(convertAjvError(error));
+            }
+        }
+    }
+    catch (error) {
+        // Schema compilation error
+        if (error instanceof Error) {
+            issues.push(createError('SCHEMA_COMPILATION_ERROR', `Failed to compile schema: ${error.message}`, undefined, undefined, 'Check that the schema is valid JSON Schema'));
+        }
+    }
+    return createReport(issues);
+}
+/**
+ * Convert AJV error to ValidationIssue
+ */
+function convertAjvError(error, schemaFile) {
+    const field = error.instancePath ? error.instancePath.replace(/^\//, '').replace(/\//g, '.') : undefined;
+    let message = error.message || 'Validation failed';
+    const code = `SCHEMA_${error.keyword.toUpperCase()}`;
+    // Enhance message based on error type
+    switch (error.keyword) {
+        case 'required':
+            if (error.params && 'missingProperty' in error.params) {
+                message = `Missing required property: ${error.params.missingProperty}`;
+            }
+            break;
+        case 'type':
+            if (error.params && 'type' in error.params) {
+                message = `Expected type ${error.params.type}, got ${typeof error.data}`;
+            }
+            break;
+        case 'enum':
+            if (error.params && 'allowedValues' in error.params) {
+                message = `Value must be one of: ${error.params.allowedValues.join(', ')}`;
+            }
+            break;
+        case 'pattern':
+            if (error.params && 'pattern' in error.params) {
+                message = `Value does not match pattern: ${error.params.pattern}`;
+            }
+            break;
+        case 'minLength':
+            if (error.params && 'limit' in error.params) {
+                message = `String length must be at least ${error.params.limit}`;
+            }
+            break;
+        case 'maxLength':
+            if (error.params && 'limit' in error.params) {
+                message = `String length must not exceed ${error.params.limit}`;
+            }
+            break;
+        case 'minimum':
+            if (error.params && 'limit' in error.params) {
+                message = `Value must be >= ${error.params.limit}`;
+            }
+            break;
+        case 'maximum':
+            if (error.params && 'limit' in error.params) {
+                message = `Value must be <= ${error.params.limit}`;
+            }
+            break;
+        case 'additionalProperties':
+            if (error.params && 'additionalProperty' in error.params) {
+                message = `Unexpected property: ${error.params.additionalProperty}`;
+            }
+            break;
+    }
+    // Add suggestion based on error type
+    let suggestion;
+    switch (error.keyword) {
+        case 'required':
+            suggestion = 'Add the missing required field to your data';
+            break;
+        case 'type':
+            if (error.params && 'type' in error.params) {
+                suggestion = `Convert the value to type: ${error.params.type}`;
+            }
+            break;
+        case 'enum':
+            suggestion = 'Use one of the allowed values';
+            break;
+        case 'additionalProperties':
+            suggestion = 'Remove the unexpected property or update the schema to allow it';
+            break;
+    }
+    const location = schemaFile ? { file: schemaFile } : undefined;
+    // Determine severity - most schema violations are errors
+    // But we could make some warnings if needed in the future
+    return createError(code, message, field, location, suggestion);
+}
+/**
+ * Validate multiple files against schemas
+ * @param files - Array of {data, schemaPath} objects
+ * @returns Merged validation report
+ */
+export async function validateMultiple(files) {
+    const reports = await Promise.all(files.map(async ({ data, schemaPath, fileName }) => {
+        const report = await validateWithSchema(data, schemaPath);
+        // Add fileName to location if provided
+        if (fileName) {
+            report.issues = report.issues.map((issue) => ({
+                ...issue,
+                location: issue.location || { file: fileName },
+            }));
+        }
+        return report;
+    }));
+    // Merge all reports
+    const allIssues = reports.flatMap((r) => r.issues);
+    return createReport(allIssues);
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/lib/validation/schema-validator.js.map

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

package/dist/lib/validation/validation-report.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Validation issue severity levels
+ */
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/**
+ * Validation issue with location and suggestion
+ */
+export interface ValidationIssue {
+    severity: ValidationSeverity;
+    code: string;
+    field?: string;
+    message: string;
+    location?: {
+        file: string;
+        line?: number;
+    };
+    suggestion?: string;
+}
+/**
+ * Summary of validation results
+ */
+export interface ValidationSummary {
+    errors: number;
+    warnings: number;
+    info: number;
+}
+/**
+ * Validation report with issues and summary
+ */
+export interface ValidationReport {
+    valid: boolean;
+    issues: ValidationIssue[];
+    summary: ValidationSummary;
+}
+/**
+ * Create a validation report from issues
+ */
+export declare function createReport(issues: ValidationIssue[]): ValidationReport;
+/**
+ * Merge multiple validation reports into one
+ */
+export declare function mergeReports(...reports: ValidationReport[]): ValidationReport;
+/**
+ * Format a validation report as human-readable text
+ */
+export declare function formatReport(report: ValidationReport): string;
+/**
+ * Helper to create an error issue
+ */
+export declare function createError(code: string, message: string, field?: string, location?: {
+    file: string;
+    line?: number;
+}, suggestion?: string): ValidationIssue;
+/**
+ * Helper to create a warning issue
+ */
+export declare function createWarning(code: string, message: string, field?: string, location?: {
+    file: string;
+    line?: number;
+}, suggestion?: string): ValidationIssue;
+/**
+ * Helper to create an info issue
+ */
+export declare function createInfo(code: string, message: string, field?: string, location?: {
+    file: string;
+    line?: number;
+}, suggestion?: string): ValidationIssue;
+//# sourceMappingURL=validation-report.d.ts.map

package/dist/lib/validation/validation-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-report.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/validation-report.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAYxE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAG7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAsD7D;AAsCD;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CASjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CASjB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CASjB"}

package/dist/lib/validation/validation-report.js

@@ -0,0 +1,141 @@
+/**
+ * Create a validation report from issues
+ */
+export function createReport(issues) {
+    const summary = {
+        errors: issues.filter((i) => i.severity === 'error').length,
+        warnings: issues.filter((i) => i.severity === 'warning').length,
+        info: issues.filter((i) => i.severity === 'info').length,
+    };
+    return {
+        valid: summary.errors === 0,
+        issues,
+        summary,
+    };
+}
+/**
+ * Merge multiple validation reports into one
+ */
+export function mergeReports(...reports) {
+    const allIssues = reports.flatMap((r) => r.issues);
+    return createReport(allIssues);
+}
+/**
+ * Format a validation report as human-readable text
+ */
+export function formatReport(report) {
+    if (report.valid && report.issues.length === 0) {
+        return '✓ Validation passed with no issues';
+    }
+    const lines = [];
+    // Summary
+    const { summary } = report;
+    lines.push('Validation Summary:');
+    if (summary.errors > 0) {
+        lines.push(`  ✗ ${summary.errors} error(s)`);
+    }
+    if (summary.warnings > 0) {
+        lines.push(`  ⚠ ${summary.warnings} warning(s)`);
+    }
+    if (summary.info > 0) {
+        lines.push(`  ℹ ${summary.info} info message(s)`);
+    }
+    lines.push('');
+    // Group issues by severity
+    const errors = report.issues.filter((i) => i.severity === 'error');
+    const warnings = report.issues.filter((i) => i.severity === 'warning');
+    const infos = report.issues.filter((i) => i.severity === 'info');
+    // Format errors
+    if (errors.length > 0) {
+        lines.push('Errors:');
+        errors.forEach((issue, index) => {
+            lines.push(`  ${index + 1}. ${formatIssue(issue)}`);
+        });
+        lines.push('');
+    }
+    // Format warnings
+    if (warnings.length > 0) {
+        lines.push('Warnings:');
+        warnings.forEach((issue, index) => {
+            lines.push(`  ${index + 1}. ${formatIssue(issue)}`);
+        });
+        lines.push('');
+    }
+    // Format info
+    if (infos.length > 0) {
+        lines.push('Info:');
+        infos.forEach((issue, index) => {
+            lines.push(`  ${index + 1}. ${formatIssue(issue)}`);
+        });
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a single validation issue
+ */
+function formatIssue(issue) {
+    const parts = [];
+    // Add location if available
+    if (issue.location) {
+        let loc = issue.location.file;
+        if (issue.location.line !== undefined) {
+            loc += `:${issue.location.line}`;
+        }
+        parts.push(`[${loc}]`);
+    }
+    // Add field if available
+    if (issue.field) {
+        parts.push(`${issue.field}:`);
+    }
+    // Add message
+    parts.push(issue.message);
+    // Add code in parentheses
+    parts.push(`(${issue.code})`);
+    let result = parts.join(' ');
+    // Add suggestion if available
+    if (issue.suggestion) {
+        result += `\n     Suggestion: ${issue.suggestion}`;
+    }
+    return result;
+}
+/**
+ * Helper to create an error issue
+ */
+export function createError(code, message, field, location, suggestion) {
+    return {
+        severity: 'error',
+        code,
+        message,
+        field,
+        location,
+        suggestion,
+    };
+}
+/**
+ * Helper to create a warning issue
+ */
+export function createWarning(code, message, field, location, suggestion) {
+    return {
+        severity: 'warning',
+        code,
+        message,
+        field,
+        location,
+        suggestion,
+    };
+}
+/**
+ * Helper to create an info issue
+ */
+export function createInfo(code, message, field, location, suggestion) {
+    return {
+        severity: 'info',
+        code,
+        message,
+        field,
+        location,
+        suggestion,
+    };
+}
+//# sourceMappingURL=validation-report.js.map

package/dist/lib/validation/validation-report.js.map

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

package/dist/lib/version-validator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Represents a version source file and its extracted version
+ */
+export interface VersionSource {
+    /** The source file path (relative) */
+    file: string;
+    /** The extracted version string (normalized without 'v' prefix), or null if not found */
+    version: string | null;
+    /** Error message if extraction failed */
+    error?: string;
+}
+/**
+ * Result of version consistency validation
+ */
+export interface VersionValidationResult {
+    /** Whether all versions are consistent */
+    valid: boolean;
+    /** All version sources checked */
+    sources: VersionSource[];
+    /** List of mismatch descriptions (only present if valid=false) */
+    mismatches?: string[];
+    /** List of errors (only present if valid=false) */
+    errors?: string[];
+}
+/**
+ * Validates version consistency across framework files
+ *
+ * Checks that version numbers match in:
+ * - CLAUDE.md (Framework Version: **vX.Y.Z**)
+ * - README.md (**Version:** X.Y.Z)
+ * - framework/cli/package.json ("version": "X.Y.Z")
+ *
+ * @example
+ * ```typescript
+ * const validator = new VersionValidator('/path/to/framework');
+ * const result = await validator.validateConsistency();
+ * if (!result.valid) {
+ *   console.error('Version mismatch:', result.mismatches);
+ * }
+ * ```
+ */
+export declare class VersionValidator {
+    private readonly frameworkRoot;
+    /**
+     * Create a new VersionValidator
+     * @param frameworkRoot - Absolute path to the framework root directory
+     */
+    constructor(frameworkRoot: string);
+    /**
+     * Extract version from CLAUDE.md
+     *
+     * Pattern: `Framework Version: **vX.Y.Z**` or `Framework Version: **X.Y.Z**`
+     * Takes the first match if multiple versions are present.
+     * Normalizes by removing 'v' prefix if present.
+     *
+     * @returns Version string (without 'v' prefix) or null if not found/file missing
+     */
+    extractClaudeMdVersion(): Promise<string | null>;
+    /**
+     * Extract version from README.md
+     *
+     * Pattern: `**Version:** X.Y.Z` or `**Version:** vX.Y.Z`
+     * Takes the first match if multiple versions are present.
+     * Normalizes by removing 'v' prefix if present.
+     *
+     * @returns Version string (without 'v' prefix) or null if not found/file missing
+     */
+    extractReadmeVersion(): Promise<string | null>;
+    /**
+     * Extract version from framework/cli/package.json
+     *
+     * Reads the standard "version" field from package.json.
+     * Handles malformed JSON gracefully.
+     *
+     * @returns Version string or null if not found/file missing/invalid JSON
+     */
+    extractPackageJsonVersion(): Promise<string | null>;
+    /**
+     * Validate version consistency across all framework files
+     *
+     * Extracts versions from CLAUDE.md, README.md, and cli/package.json,
+     * then checks that they all match. Normalizes versions by removing
+     * 'v' prefix if present.
+     *
+     * @returns Validation result with detailed source information and any errors/mismatches
+     */
+    validateConsistency(): Promise<VersionValidationResult>;
+}
+//# sourceMappingURL=version-validator.d.ts.map

package/dist/lib/version-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-validator.d.ts","sourceRoot":"","sources":["../../src/lib/version-validator.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC;;;OAGG;gBACS,aAAa,EAAE,MAAM;IAIjC;;;;;;;;OAQG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBtD;;;;;;;;OAQG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBpD;;;;;;;OAOG;IACG,yBAAyB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuBzD;;;;;;;;OAQG;IACG,mBAAmB,IAAI,OAAO,CAAC,uBAAuB,CAAC;CAyE9D"}