@iflow-mcp/attio-mcp 1.3.6

package/dist/services/search-utilities/SearchUtilities.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Search utilities extracted from UniversalSearchService
+ * Issue #574: Extract shared utilities for reuse
+ */
+import { AttioRecord } from '../../types/attio.js';
+import { TimeframeParams } from '../search-strategies/interfaces.js';
+/**
+ * Utility functions for search operations
+ */
+export declare class SearchUtilities {
+    /**
+     * Rank search results by relevance based on query match frequency
+     * This provides client-side relevance scoring since Attio API doesn't have native relevance ranking
+     */
+    static rankByRelevance(results: AttioRecord[], query: string, searchFields: string[]): AttioRecord[];
+    /**
+     * Helper method to extract field value from a record
+     * Issue #598: Simplified with better type safety and helper methods
+     */
+    static getFieldValue(record: AttioRecord, field: string): string;
+    /**
+     * Extract string value from various Attio field value structures
+     */
+    private static extractStringFromFieldValue;
+    /**
+     * Extract string from array field values (e.g., email_addresses)
+     */
+    private static extractStringFromArray;
+    /**
+     * Type guard for field value objects
+     */
+    private static isFieldValueObject;
+    /**
+     * Helper method to extract field value from a list record for content search
+     */
+    static getListFieldValue(list: AttioRecord, field: string): string;
+    /**
+     * Helper method to extract field value from a task record for content search
+     */
+    static getTaskFieldValue(task: AttioRecord, field: string): string;
+    /**
+     * Helper method to extract field value from a note record for content search
+     * Issue #888: Support notes search by title and content
+     */
+    static getNoteFieldValue(note: AttioRecord, field: string): string;
+    /**
+     * Create date filter from timeframe parameters
+     */
+    static createDateFilter(timeframeParams: TimeframeParams): Record<string, unknown> | null;
+    /**
+     * Merge timeframe filters with existing filters
+     */
+    static mergeFilters(existingFilters: Record<string, unknown> | undefined, dateFilter: Record<string, unknown>): Record<string, unknown>;
+}
+//# sourceMappingURL=SearchUtilities.d.ts.map

package/dist/services/search-utilities/SearchUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchUtilities.d.ts","sourceRoot":"","sources":["../../../src/services/search-utilities/SearchUtilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAkBrE;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EAAE,GACrB,WAAW,EAAE;IAwDhB;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAQhE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAkB1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAiBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAWjC;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBlE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBlE;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBlE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,eAAe,EAAE,eAAe,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuDjC;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA+B3B"}

package/dist/services/search-utilities/SearchUtilities.js

@@ -0,0 +1,255 @@
+/**
+ * Search utilities extracted from UniversalSearchService
+ * Issue #574: Extract shared utilities for reuse
+ */
+/**
+ * Utility functions for search operations
+ */
+export class SearchUtilities {
+    /**
+     * Rank search results by relevance based on query match frequency
+     * This provides client-side relevance scoring since Attio API doesn't have native relevance ranking
+     */
+    static rankByRelevance(results, query, searchFields) {
+        // Calculate relevance score for each result
+        const scoredResults = results.map((record) => {
+            let score = 0;
+            const queryLower = query.toLowerCase();
+            // Check each search field for matches
+            searchFields.forEach((field) => {
+                const fieldValue = this.getFieldValue(record, field);
+                if (fieldValue) {
+                    const valueLower = fieldValue.toLowerCase();
+                    // Exact match gets highest score
+                    if (valueLower === queryLower) {
+                        score += 100;
+                    }
+                    // Starts with query gets high score
+                    else if (valueLower.startsWith(queryLower)) {
+                        score += 50;
+                    }
+                    // Contains query gets moderate score
+                    else if (valueLower.includes(queryLower)) {
+                        score += 25;
+                        // Additional score for more occurrences
+                        const matches = valueLower.split(queryLower).length - 1;
+                        score += matches * 10;
+                    }
+                    // Partial word match gets lower score
+                    else {
+                        const queryWords = queryLower.split(/\s+/);
+                        queryWords.forEach((word) => {
+                            if (valueLower.includes(word)) {
+                                score += 5;
+                            }
+                        });
+                    }
+                }
+            });
+            return { record, score };
+        });
+        // Sort by score (descending) then by name
+        scoredResults.sort((a, b) => {
+            if (b.score !== a.score) {
+                return b.score - a.score;
+            }
+            // Secondary sort by name if scores are equal
+            const nameA = this.getFieldValue(a.record, 'name') || '';
+            const nameB = this.getFieldValue(b.record, 'name') || '';
+            return nameA.localeCompare(nameB);
+        });
+        return scoredResults.map((item) => item.record);
+    }
+    /**
+     * Helper method to extract field value from a record
+     * Issue #598: Simplified with better type safety and helper methods
+     */
+    static getFieldValue(record, field) {
+        const values = record.values;
+        if (!values)
+            return '';
+        const fieldValue = values[field];
+        return this.extractStringFromFieldValue(fieldValue);
+    }
+    /**
+     * Extract string value from various Attio field value structures
+     */
+    static extractStringFromFieldValue(fieldValue) {
+        if (typeof fieldValue === 'string') {
+            return fieldValue;
+        }
+        if (Array.isArray(fieldValue)) {
+            return this.extractStringFromArray(fieldValue);
+        }
+        if (this.isFieldValueObject(fieldValue)) {
+            return String(fieldValue.value || '');
+        }
+        return '';
+    }
+    /**
+     * Extract string from array field values (e.g., email_addresses)
+     */
+    static extractStringFromArray(fieldArray) {
+        if (fieldArray.length === 0)
+            return '';
+        const firstItem = fieldArray[0];
+        if (typeof firstItem === 'string') {
+            return firstItem;
+        }
+        if (this.isFieldValueObject(firstItem)) {
+            return String(firstItem.value || '');
+        }
+        return '';
+    }
+    /**
+     * Type guard for field value objects
+     */
+    static isFieldValueObject(value) {
+        return (value !== null &&
+            value !== undefined &&
+            typeof value === 'object' &&
+            'value' in value);
+    }
+    /**
+     * Helper method to extract field value from a list record for content search
+     */
+    static getListFieldValue(list, field) {
+        const values = list.values;
+        if (!values)
+            return '';
+        const fieldValue = values[field];
+        // Handle different field value structures for lists
+        if (typeof fieldValue === 'string') {
+            return fieldValue;
+        }
+        else if (fieldValue &&
+            typeof fieldValue === 'object' &&
+            'value' in fieldValue) {
+            return String(fieldValue.value || '');
+        }
+        return '';
+    }
+    /**
+     * Helper method to extract field value from a task record for content search
+     */
+    static getTaskFieldValue(task, field) {
+        const values = task.values;
+        if (!values)
+            return '';
+        const fieldValue = values[field];
+        // Handle different field value structures for tasks
+        if (typeof fieldValue === 'string') {
+            return fieldValue;
+        }
+        else if (fieldValue &&
+            typeof fieldValue === 'object' &&
+            'value' in fieldValue) {
+            return String(fieldValue.value || '');
+        }
+        return '';
+    }
+    /**
+     * Helper method to extract field value from a note record for content search
+     * Issue #888: Support notes search by title and content
+     */
+    static getNoteFieldValue(note, field) {
+        const values = note.values;
+        if (!values)
+            return '';
+        const fieldValue = values[field];
+        // Handle different field value structures for notes
+        if (typeof fieldValue === 'string') {
+            return fieldValue;
+        }
+        else if (fieldValue &&
+            typeof fieldValue === 'object' &&
+            'value' in fieldValue) {
+            return String(fieldValue.value || '');
+        }
+        return '';
+    }
+    /**
+     * Create date filter from timeframe parameters
+     */
+    static createDateFilter(timeframeParams) {
+        const { timeframe_attribute, start_date, end_date, date_operator } = timeframeParams;
+        if (!timeframe_attribute) {
+            return null;
+        }
+        const filters = [];
+        if (date_operator === 'between' && start_date && end_date) {
+            // Between date range - use valid API conditions
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'greater_than',
+                value: start_date,
+            });
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'less_than',
+                value: end_date,
+            });
+        }
+        else if (date_operator === 'greater_than' && start_date) {
+            // After start date - use valid API condition
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'greater_than',
+                value: start_date,
+            });
+        }
+        else if (date_operator === 'less_than' && end_date) {
+            // Before end date - use valid API condition
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'less_than',
+                value: end_date,
+            });
+        }
+        else if (date_operator === 'equals' && start_date) {
+            // Exact date match
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'equals',
+                value: start_date,
+            });
+        }
+        if (filters.length === 0) {
+            return null;
+        }
+        return {
+            filters,
+            matchAny: false, // Use AND logic for date ranges
+        };
+    }
+    /**
+     * Merge timeframe filters with existing filters
+     */
+    static mergeFilters(existingFilters, dateFilter) {
+        if (!existingFilters) {
+            return dateFilter;
+        }
+        // If existing filters already has a filters array, merge them
+        if (Array.isArray(existingFilters.filters) &&
+            Array.isArray(dateFilter.filters)) {
+            return {
+                ...existingFilters,
+                filters: [...existingFilters.filters, ...dateFilter.filters],
+            };
+        }
+        // Otherwise, create a new structure with both sets of filters
+        const existingFilterArray = Array.isArray(existingFilters.filters)
+            ? existingFilters.filters
+            : [];
+        const dateFilterArray = Array.isArray(dateFilter.filters)
+            ? dateFilter.filters
+            : [];
+        return {
+            ...existingFilters,
+            filters: [...existingFilterArray, ...dateFilterArray],
+            // Preserve existing matchAny logic if it exists
+            matchAny: existingFilters.matchAny || false,
+        };
+    }
+}
+//# sourceMappingURL=SearchUtilities.js.map

package/dist/services/search-utilities/SearchUtilities.js.map

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

package/dist/services/skill-generator/OutputWriterService.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Service for writing formatted output to disk
+ *
+ * Handles file I/O operations including:
+ * - Creating directory structures
+ * - Writing files to disk
+ * - Creating ZIP archives
+ * - Path validation (security)
+ *
+ * @see Issue #983
+ */
+import type { FormattedOutput, GenerateSkillConfig, SkillOutput } from './types.js';
+/**
+ * Service for writing skill output to disk
+ */
+export declare class OutputWriterService {
+    /**
+     * Writes formatted output to disk
+     *
+     * @param formatted - Formatted output from SchemaFormatterService
+     * @param config - Generation configuration
+     * @returns Information about written files
+     */
+    write(formatted: FormattedOutput, config: GenerateSkillConfig): Promise<SkillOutput>;
+    /**
+     * Creates ZIP archive of output files
+     *
+     * @param basePath - Base directory path
+     * @param files - Map of relative paths to file contents
+     */
+    private createZip;
+    /**
+     * Resolves and validates output path
+     *
+     * @param config - Generation configuration
+     * @returns Absolute output path
+     * @throws Error if path validation fails (directory traversal attempt)
+     */
+    private resolveOutputPath;
+}
+//# sourceMappingURL=OutputWriterService.d.ts.map

package/dist/services/skill-generator/OutputWriterService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputWriterService.d.ts","sourceRoot":"","sources":["../../../src/services/skill-generator/OutputWriterService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;OAMG;IACG,KAAK,CACT,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC;IAiCvB;;;;;OAKG;YACW,SAAS;IAqBvB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;CA4B1B"}

package/dist/services/skill-generator/OutputWriterService.js

@@ -0,0 +1,100 @@
+/**
+ * Service for writing formatted output to disk
+ *
+ * Handles file I/O operations including:
+ * - Creating directory structures
+ * - Writing files to disk
+ * - Creating ZIP archives
+ * - Path validation (security)
+ *
+ * @see Issue #983
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { zipSync, strToU8 } from 'fflate';
+/**
+ * Service for writing skill output to disk
+ */
+export class OutputWriterService {
+    /**
+     * Writes formatted output to disk
+     *
+     * @param formatted - Formatted output from SchemaFormatterService
+     * @param config - Generation configuration
+     * @returns Information about written files
+     */
+    async write(formatted, config) {
+        const outputPath = this.resolveOutputPath(config);
+        // Create output directory
+        await fs.mkdir(outputPath, { recursive: true });
+        // Write all files
+        const writtenFiles = [];
+        for (const [relativePath, content] of Object.entries(formatted.files)) {
+            const fullPath = path.join(outputPath, relativePath);
+            const dir = path.dirname(fullPath);
+            // Ensure directory exists
+            await fs.mkdir(dir, { recursive: true });
+            // Write file
+            await fs.writeFile(fullPath, content, 'utf8');
+            writtenFiles.push(relativePath);
+        }
+        // Create ZIP if requested
+        if (config.zip) {
+            await this.createZip(outputPath, formatted.files);
+            writtenFiles.push(`${path.basename(outputPath)}.zip`);
+        }
+        return {
+            format: formatted.format,
+            path: outputPath,
+            files: writtenFiles,
+        };
+    }
+    /**
+     * Creates ZIP archive of output files
+     *
+     * @param basePath - Base directory path
+     * @param files - Map of relative paths to file contents
+     */
+    async createZip(basePath, files) {
+        // Convert files to fflate format (Uint8Array)
+        const fileMap = {};
+        for (const [relativePath, content] of Object.entries(files)) {
+            fileMap[relativePath] = strToU8(content);
+        }
+        // Create ZIP
+        const zipped = zipSync(fileMap, {
+            level: 6, // Compression level (0-9, 6 is default)
+        });
+        // Write ZIP file
+        const zipPath = `${basePath}.zip`;
+        await fs.writeFile(zipPath, zipped);
+    }
+    /**
+     * Resolves and validates output path
+     *
+     * @param config - Generation configuration
+     * @returns Absolute output path
+     * @throws Error if path validation fails (directory traversal attempt)
+     */
+    resolveOutputPath(config) {
+        // Determine base name based on format
+        const baseName = config.format === 'skill'
+            ? 'attio-workspace-skill'
+            : `attio-workspace-schema-${config.format}`;
+        // Resolve absolute paths
+        const outputDirResolved = path.resolve(config.outputDir);
+        const currentWorkingDir = process.cwd();
+        // Security: Prevent directory traversal attacks
+        // Check if outputDir attempts to escape the current working directory
+        const normalized = path.normalize(outputDirResolved);
+        // Only allow output within current working directory or subdirectories
+        if (!normalized.startsWith(currentWorkingDir)) {
+            throw new Error('Invalid output path: directory traversal detected. ' +
+                `Output directory must be within current working directory: ${currentWorkingDir}`);
+        }
+        // Construct final output path
+        const outputPath = path.join(outputDirResolved, baseName);
+        return outputPath;
+    }
+}
+//# sourceMappingURL=OutputWriterService.js.map

package/dist/services/skill-generator/OutputWriterService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputWriterService.js","sourceRoot":"","sources":["../../../src/services/skill-generator/OutputWriterService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAO1C;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CACT,SAA0B,EAC1B,MAA2B;QAE3B,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAElD,0BAA0B;QAC1B,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,kBAAkB;QAClB,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEnC,0BAA0B;YAC1B,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEzC,aAAa;YACb,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9C,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;QAED,0BAA0B;QAC1B,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;YAClD,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,YAAY;SACpB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,SAAS,CACrB,QAAgB,EAChB,KAA6B;QAE7B,8CAA8C;QAC9C,MAAM,OAAO,GAA+B,EAAE,CAAC;QAE/C,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,aAAa;QACb,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE;YAC9B,KAAK,EAAE,CAAC,EAAE,wCAAwC;SACnD,CAAC,CAAC;QAEH,iBAAiB;QACjB,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;QAClC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,MAA2B;QACnD,sCAAsC;QACtC,MAAM,QAAQ,GACZ,MAAM,CAAC,MAAM,KAAK,OAAO;YACvB,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,0BAA0B,MAAM,CAAC,MAAM,EAAE,CAAC;QAEhD,yBAAyB;QACzB,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAExC,gDAAgD;QAChD,sEAAsE;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAErD,uEAAuE;QACvE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,qDAAqD;gBACnD,8DAA8D,iBAAiB,EAAE,CACpF,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;QAE1D,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/services/skill-generator/SchemaFormatterService.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Service for formatting workspace schemas into various output formats
+ *
+ * Uses Handlebars templates to transform WorkspaceSchema objects into:
+ * - Claude Skills (SKILL.md + resources/)
+ * - Plain Markdown (single file)
+ * - JSON (machine-readable)
+ *
+ * @see Issue #983
+ */
+import type { WorkspaceSchema, FormattedOutput } from './types.js';
+/**
+ * Service for formatting workspace schemas into various output formats
+ */
+export declare class SchemaFormatterService {
+    private templates;
+    private helpersRegistered;
+    constructor();
+    /**
+     * Formats schema to specified output format
+     *
+     * @param schema - Complete workspace schema
+     * @param format - Output format (skill, markdown, json)
+     * @returns Formatted output ready for writing
+     */
+    format(schema: WorkspaceSchema, format: 'skill' | 'markdown' | 'json'): Promise<FormattedOutput>;
+    /**
+     * Formats as Claude Skill with SKILL.md + resources/
+     *
+     * @param schema - Workspace schema
+     * @returns Skill files ready for writing
+     */
+    private formatAsSkill;
+    /**
+     * Formats as single markdown file (all-in-one)
+     *
+     * @param schema - Workspace schema
+     * @returns Single markdown file
+     */
+    private formatAsMarkdown;
+    /**
+     * Formats as JSON (machine-readable)
+     *
+     * @param schema - Workspace schema
+     * @returns JSON representation
+     */
+    private formatAsJSON;
+    /**
+     * Renders a template with the given data
+     *
+     * @param templateName - Template filename
+     * @param data - Data to pass to template
+     * @returns Rendered template string
+     */
+    private renderTemplate;
+    /**
+     * Registers custom Handlebars helpers
+     */
+    private registerHelpers;
+}
+//# sourceMappingURL=SchemaFormatterService.d.ts.map

package/dist/services/skill-generator/SchemaFormatterService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaFormatterService.d.ts","sourceRoot":"","sources":["../../../src/services/skill-generator/SchemaFormatterService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMnE;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,iBAAiB,CAAS;;IAMlC;;;;;;OAMG;IACG,MAAM,CACV,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GACpC,OAAO,CAAC,eAAe,CAAC;IAa3B;;;;;OAKG;YACW,aAAa;IAsD3B;;;;;OAKG;YACW,gBAAgB;IAyB9B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;OAMG;YACW,cAAc;IA+B5B;;OAEG;IACH,OAAO,CAAC,eAAe;CAsBxB"}