cc-agentic-framework 1.14.1

package/dist/lib/common/file-utils.js

@@ -0,0 +1,143 @@
+import fs from "fs-extra";
+import path from "path";
+/**
+ * File system utilities for safe file operations
+ *
+ * Provides async helpers with proper encoding and error handling.
+ * Based on Python's pathlib-based file_utils.py from the core framework.
+ */
+/**
+ * Safely read file contents
+ *
+ * @param filePath - Path to file
+ * @param encoding - File encoding (default: utf-8)
+ * @returns File contents as string
+ * @throws {Error} If file doesn't exist or read fails
+ *
+ * @example
+ * ```typescript
+ * const content = await safeRead('/path/to/file.txt');
+ * ```
+ */
+export async function safeRead(filePath, encoding = "utf-8") {
+    try {
+        return await fs.readFile(filePath, encoding);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            if (error.code === "ENOENT") {
+                throw new Error(`File not found: ${filePath}`, { cause: error });
+            }
+            throw new Error(`Error reading ${filePath}: ${error.message}`, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+/**
+ * Safely write content to file
+ *
+ * Creates parent directories if they don't exist.
+ *
+ * @param filePath - Path to file
+ * @param content - Content to write
+ * @param encoding - File encoding (default: utf-8)
+ * @throws {Error} If write fails
+ *
+ * @example
+ * ```typescript
+ * await safeWrite('/path/to/file.txt', 'Hello, World!');
+ * ```
+ */
+export async function safeWrite(filePath, content, encoding = "utf-8") {
+    try {
+        // Ensure parent directory exists
+        await fs.ensureDir(path.dirname(filePath));
+        await fs.writeFile(filePath, content, encoding);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Error writing ${filePath}: ${error.message}`, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+/**
+ * Ensure directory exists, create if needed
+ *
+ * Creates parent directories recursively if they don't exist.
+ *
+ * @param dirPath - Path to directory
+ *
+ * @example
+ * ```typescript
+ * await ensureDirectory('/path/to/nested/directory');
+ * ```
+ */
+export async function ensureDirectory(dirPath) {
+    await fs.ensureDir(dirPath);
+}
+/**
+ * Check if a path exists (file or directory)
+ *
+ * @param path - Path to check
+ * @returns True if path exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await fileExists('/path/to/file.txt')) {
+ *   console.log('File exists!');
+ * }
+ * ```
+ */
+export async function fileExists(path) {
+    return await fs.pathExists(path);
+}
+/**
+ * Check if a path is a directory
+ *
+ * @param path - Path to check
+ * @returns True if path exists and is a directory, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isDirectory('/path/to/dir')) {
+ *   console.log('It is a directory!');
+ * }
+ * ```
+ */
+export async function isDirectory(path) {
+    try {
+        const stats = await fs.stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a path is a file
+ *
+ * @param path - Path to check
+ * @returns True if path exists and is a file, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isFile('/path/to/file.txt')) {
+ *   console.log('It is a file!');
+ * }
+ * ```
+ */
+export async function isFile(path) {
+    try {
+        const stats = await fs.stat(path);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/lib/common/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../../src/lib/common/file-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;GAKG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAgB,EAChB,WAA2B,OAAO;IAElC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE;gBAC7D,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,OAAe,EACf,WAA2B,OAAO;IAElC,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE;gBAC7D,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,OAAO,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/lib/common/validation.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Validation error severity levels
+ */
+export type ValidationErrorSeverity = 'error' | 'warning' | 'info';
+/**
+ * Custom validation error class
+ */
+export declare class ValidationError extends Error {
+    field: string;
+    severity: ValidationErrorSeverity;
+    suggestion?: string;
+    constructor(field: string, message: string, severity?: ValidationErrorSeverity, suggestion?: string);
+}
+/**
+ * Validation result with errors
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: Array<{
+        field: string;
+        message: string;
+        severity?: ValidationErrorSeverity;
+        suggestion?: string;
+    }>;
+}
+/**
+ * Validation rule definition
+ */
+export interface ValidationRule {
+    field: string;
+    required?: boolean;
+    type?: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    pattern?: RegExp;
+    enum?: string[];
+    message?: string;
+    arrayValidator?: (item: unknown) => void;
+    custom?: (value: unknown) => void;
+}
+/**
+ * Type guard: Check if value is defined (not null or undefined)
+ */
+export declare function isRequired<T>(value: T | undefined | null): value is T;
+/**
+ * Type guard: Check if value is a string
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Type guard: Check if value is a number (excluding NaN)
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Type guard: Check if value is a boolean
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Type guard: Check if value is an array
+ */
+export declare function isArray(value: unknown): value is unknown[];
+/**
+ * Type guard: Check if value is a plain object (not array or null)
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Validate that a field is required (not null or undefined)
+ */
+export declare function validateRequired(field: string, value: unknown, message?: string): void;
+/**
+ * Validate that a field matches the expected type
+ */
+export declare function validateType(field: string, value: unknown, expectedType: 'string' | 'number' | 'boolean' | 'array' | 'object', message?: string): void;
+/**
+ * Validate that a string field matches a regex pattern
+ */
+export declare function validatePattern(field: string, value: unknown, pattern: RegExp, message?: string): void;
+/**
+ * Validate that a field value is one of the allowed enum values
+ */
+export declare function validateEnum(field: string, value: unknown, allowedValues: string[], message?: string): void;
+/**
+ * Validate array items using a custom validator function
+ */
+export declare function validateArray(field: string, value: unknown, itemValidator: (item: unknown) => void, _message?: string): void;
+/**
+ * Validate using a custom validator function
+ */
+export declare function validateCustom(field: string, value: unknown, validatorFn: (value: unknown) => void): void;
+/**
+ * Validate data against a set of validation rules
+ */
+export declare function validate(data: unknown, rules: ValidationRule[]): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/lib/common/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/lib/common/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,uBAAuB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,uBAAiC,EAC3C,UAAU,CAAC,EAAE,MAAM;CAQtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,uBAAuB,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,CAErE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAItF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,EAClE,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CA2BN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAO3G;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EACtC,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACpC,IAAI,CASN;AAmBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,gBAAgB,CAqEjF"}

package/dist/lib/common/validation.js

@@ -0,0 +1,213 @@
+/**
+ * Custom validation error class
+ */
+export class ValidationError extends Error {
+    field;
+    severity;
+    suggestion;
+    constructor(field, message, severity = 'error', suggestion) {
+        super(message);
+        this.name = 'ValidationError';
+        this.field = field;
+        this.severity = severity;
+        this.suggestion = suggestion;
+    }
+}
+/**
+ * Type guard: Check if value is defined (not null or undefined)
+ */
+export function isRequired(value) {
+    return value !== null && value !== undefined;
+}
+/**
+ * Type guard: Check if value is a string
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Type guard: Check if value is a number (excluding NaN)
+ */
+export function isNumber(value) {
+    return typeof value === 'number' && !isNaN(value);
+}
+/**
+ * Type guard: Check if value is a boolean
+ */
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+/**
+ * Type guard: Check if value is an array
+ */
+export function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Type guard: Check if value is a plain object (not array or null)
+ */
+export function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate that a field is required (not null or undefined)
+ */
+export function validateRequired(field, value, message) {
+    if (!isRequired(value)) {
+        throw new ValidationError(field, message || `Field "${field}" is required`);
+    }
+}
+/**
+ * Validate that a field matches the expected type
+ */
+export function validateType(field, value, expectedType, message) {
+    let isValid = false;
+    switch (expectedType) {
+        case 'string':
+            isValid = isString(value);
+            break;
+        case 'number':
+            isValid = isNumber(value);
+            break;
+        case 'boolean':
+            isValid = isBoolean(value);
+            break;
+        case 'array':
+            isValid = isArray(value);
+            break;
+        case 'object':
+            isValid = isObject(value);
+            break;
+    }
+    if (!isValid) {
+        throw new ValidationError(field, message || `Field "${field}" must be of type ${expectedType}`);
+    }
+}
+/**
+ * Validate that a string field matches a regex pattern
+ */
+export function validatePattern(field, value, pattern, message) {
+    if (!isString(value)) {
+        throw new ValidationError(field, `Field "${field}" must be a string for pattern validation`);
+    }
+    if (!pattern.test(value)) {
+        throw new ValidationError(field, message || `Field "${field}" does not match the required pattern`);
+    }
+}
+/**
+ * Validate that a field value is one of the allowed enum values
+ */
+export function validateEnum(field, value, allowedValues, message) {
+    if (!allowedValues.includes(value)) {
+        throw new ValidationError(field, message || `Field "${field}" must be one of: ${allowedValues.join(', ')}`);
+    }
+}
+/**
+ * Validate array items using a custom validator function
+ */
+export function validateArray(field, value, itemValidator, _message) {
+    if (!isArray(value)) {
+        throw new ValidationError(field, `Field "${field}" must be an array`);
+    }
+    for (let i = 0; i < value.length; i++) {
+        try {
+            itemValidator(value[i]);
+        }
+        catch (error) {
+            if (error instanceof ValidationError) {
+                throw new ValidationError(`${field}[${i}]`, error.message);
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * Validate using a custom validator function
+ */
+export function validateCustom(field, value, validatorFn) {
+    try {
+        validatorFn(value);
+    }
+    catch (error) {
+        if (error instanceof ValidationError) {
+            throw error;
+        }
+        throw new ValidationError(field, error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Get nested field value from an object using dot notation
+ */
+function getNestedValue(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Validate data against a set of validation rules
+ */
+export function validate(data, rules) {
+    const errors = [];
+    for (const rule of rules) {
+        try {
+            const value = getNestedValue(data, rule.field);
+            // Check if field is required
+            if (rule.required) {
+                validateRequired(rule.field, value, rule.message);
+            }
+            // Skip validation for optional missing fields
+            if (!isRequired(value) && !rule.required) {
+                continue;
+            }
+            // Type validation
+            if (rule.type) {
+                validateType(rule.field, value, rule.type, rule.message);
+            }
+            // Pattern validation
+            if (rule.pattern) {
+                validatePattern(rule.field, value, rule.pattern, rule.message);
+            }
+            // Enum validation
+            if (rule.enum) {
+                validateEnum(rule.field, value, rule.enum, rule.message);
+            }
+            // Array validation
+            if (rule.arrayValidator) {
+                validateArray(rule.field, value, rule.arrayValidator, rule.message);
+            }
+            // Custom validation
+            if (rule.custom) {
+                validateCustom(rule.field, value, rule.custom);
+            }
+        }
+        catch (error) {
+            if (error instanceof ValidationError) {
+                errors.push({
+                    field: error.field,
+                    message: error.message,
+                    severity: error.severity,
+                    suggestion: error.suggestion,
+                });
+            }
+            else {
+                // Unexpected error
+                errors.push({
+                    field: rule.field,
+                    message: error instanceof Error ? error.message : String(error),
+                    severity: 'error',
+                });
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/lib/common/validation.js.map

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

package/dist/lib/common/yaml-frontmatter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Result of parsing frontmatter from a document
+ */
+export interface FrontmatterResult<T = Record<string, unknown>> {
+    /** Parsed YAML frontmatter data */
+    data: T;
+    /** Content after the frontmatter */
+    content: string;
+    /** Original YAML string from frontmatter */
+    matter: string;
+}
+/**
+ * Parse YAML frontmatter from markdown content
+ *
+ * Uses gray-matter library to parse frontmatter with proper field order preservation.
+ *
+ * @param content - The markdown content with frontmatter
+ * @returns Parsed frontmatter data, content, and original YAML string
+ *
+ * @example
+ * ```typescript
+ * const content = `---
+ * title: "My Document"
+ * tags:
+ *   - one
+ *   - two
+ * ---
+ * # Content`;
+ *
+ * const result = parseFrontmatter(content);
+ * console.log(result.data.title); // "My Document"
+ * console.log(result.content); // "# Content"
+ * ```
+ */
+export declare function parseFrontmatter<T = Record<string, unknown>>(content: string): FrontmatterResult<T>;
+/**
+ * Convert frontmatter data and content back to markdown with YAML frontmatter
+ *
+ * Preserves field order and formatting using gray-matter's stringify.
+ *
+ * @param data - The frontmatter data object
+ * @param content - The markdown content
+ * @returns Complete markdown string with frontmatter
+ *
+ * @example
+ * ```typescript
+ * const data = { title: "My Document", count: 42 };
+ * const content = "# Content";
+ *
+ * const markdown = stringifyFrontmatter(data, content);
+ * // Returns:
+ * // ---
+ * // title: My Document
+ * // count: 42
+ * // ---
+ * // # Content
+ * ```
+ */
+export declare function stringifyFrontmatter(data: Record<string, unknown>, content: string): string;
+/**
+ * Update frontmatter in an existing file
+ *
+ * Reads the file, parses frontmatter, merges with updates, and writes back.
+ * Preserves existing frontmatter fields and content.
+ *
+ * @param filePath - Path to the markdown file
+ * @param updates - Object with frontmatter fields to update/add
+ * @throws {Error} If file does not exist or cannot be read/written
+ *
+ * @example
+ * ```typescript
+ * await updateFrontmatter('document.md', { version: 2 });
+ * ```
+ */
+export declare function updateFrontmatter(filePath: string, updates: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=yaml-frontmatter.d.ts.map

package/dist/lib/common/yaml-frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter.d.ts","sourceRoot":"","sources":["../../../src/lib/common/yaml-frontmatter.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,mCAAmC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAQnG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/lib/common/yaml-frontmatter.js

@@ -0,0 +1,89 @@
+import matter from 'gray-matter';
+import fs from 'fs-extra';
+/**
+ * Parse YAML frontmatter from markdown content
+ *
+ * Uses gray-matter library to parse frontmatter with proper field order preservation.
+ *
+ * @param content - The markdown content with frontmatter
+ * @returns Parsed frontmatter data, content, and original YAML string
+ *
+ * @example
+ * ```typescript
+ * const content = `---
+ * title: "My Document"
+ * tags:
+ *   - one
+ *   - two
+ * ---
+ * # Content`;
+ *
+ * const result = parseFrontmatter(content);
+ * console.log(result.data.title); // "My Document"
+ * console.log(result.content); // "# Content"
+ * ```
+ */
+export function parseFrontmatter(content) {
+    const parsed = matter(content);
+    return {
+        data: parsed.data,
+        content: parsed.content,
+        matter: parsed.matter || '',
+    };
+}
+/**
+ * Convert frontmatter data and content back to markdown with YAML frontmatter
+ *
+ * Preserves field order and formatting using gray-matter's stringify.
+ *
+ * @param data - The frontmatter data object
+ * @param content - The markdown content
+ * @returns Complete markdown string with frontmatter
+ *
+ * @example
+ * ```typescript
+ * const data = { title: "My Document", count: 42 };
+ * const content = "# Content";
+ *
+ * const markdown = stringifyFrontmatter(data, content);
+ * // Returns:
+ * // ---
+ * // title: My Document
+ * // count: 42
+ * // ---
+ * // # Content
+ * ```
+ */
+export function stringifyFrontmatter(data, content) {
+    return matter.stringify(content, data);
+}
+/**
+ * Update frontmatter in an existing file
+ *
+ * Reads the file, parses frontmatter, merges with updates, and writes back.
+ * Preserves existing frontmatter fields and content.
+ *
+ * @param filePath - Path to the markdown file
+ * @param updates - Object with frontmatter fields to update/add
+ * @throws {Error} If file does not exist or cannot be read/written
+ *
+ * @example
+ * ```typescript
+ * await updateFrontmatter('document.md', { version: 2 });
+ * ```
+ */
+export async function updateFrontmatter(filePath, updates) {
+    // Read existing file
+    const content = await fs.readFile(filePath, 'utf-8');
+    // Parse frontmatter
+    const parsed = parseFrontmatter(content);
+    // Merge updates with existing data
+    const updatedData = {
+        ...parsed.data,
+        ...updates,
+    };
+    // Stringify and write back
+    const updated = stringifyFrontmatter(updatedData, parsed.content);
+    await fs.writeFile(filePath, updated, 'utf-8');
+}
+//# sourceMappingURL=yaml-frontmatter.js.map

package/dist/lib/common/yaml-frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter.js","sourceRoot":"","sources":["../../../src/lib/common/yaml-frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,UAAU,CAAC;AAc1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,gBAAgB,CAA8B,OAAe;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAS;QACtB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA6B,EAC7B,OAAe;IAEf,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,OAAgC;IAEhC,qBAAqB;IACrB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAErD,oBAAoB;IACpB,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEzC,mCAAmC;IACnC,MAAM,WAAW,GAAG;QAClB,GAAG,MAAM,CAAC,IAAI;QACd,GAAG,OAAO;KACX,CAAC;IAEF,2BAA2B;IAC3B,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/confluence/adf-converter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Confluence ADF (Atlassian Document Format) Converter
+ *
+ * Provides bidirectional conversion between ADF and Markdown.
+ */
+export interface AdfNode {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: AdfNode[];
+    text?: string;
+    marks?: AdfMark[];
+}
+export interface AdfMark {
+    type: string;
+    attrs?: Record<string, unknown>;
+}
+export interface AdfDocument {
+    type: 'doc';
+    version: number;
+    content: AdfNode[];
+}
+/**
+ * Convert ADF document to Markdown
+ */
+export declare function adfToMarkdown(adf: AdfDocument | AdfNode): string;
+/**
+ * Convert Markdown to ADF document
+ */
+export declare function markdownToAdf(markdown: string): AdfDocument;
+//# sourceMappingURL=adf-converter.d.ts.map

package/dist/lib/confluence/adf-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-converter.d.ts","sourceRoot":"","sources":["../../../src/lib/confluence/adf-converter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAG3D"}