attio-mcp 1.3.6 → 1.4.0

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":"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"}

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"}

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

@@ -0,0 +1,168 @@
+/**
+ * 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 Handlebars from 'handlebars';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+// Get __dirname equivalent in ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Service for formatting workspace schemas into various output formats
+ */
+export class SchemaFormatterService {
+    templates = new Map();
+    helpersRegistered = false;
+    constructor() {
+        this.registerHelpers();
+    }
+    /**
+     * Formats schema to specified output format
+     *
+     * @param schema - Complete workspace schema
+     * @param format - Output format (skill, markdown, json)
+     * @returns Formatted output ready for writing
+     */
+    async format(schema, format) {
+        switch (format) {
+            case 'skill':
+                return this.formatAsSkill(schema);
+            case 'markdown':
+                return this.formatAsMarkdown(schema);
+            case 'json':
+                return this.formatAsJSON(schema);
+            default:
+                throw new Error(`Unsupported format: ${format}`);
+        }
+    }
+    /**
+     * Formats as Claude Skill with SKILL.md + resources/
+     *
+     * @param schema - Workspace schema
+     * @returns Skill files ready for writing
+     */
+    async formatAsSkill(schema) {
+        const skillMd = await this.renderTemplate('SKILL.template.md', schema);
+        // Validate Claude Skill description length requirement (≤200 chars)
+        const descMatch = skillMd.match(/^description:\s*(.+)$/m);
+        if (descMatch && descMatch[1].length > 200) {
+            throw new Error(`Skill description exceeds 200 characters (${descMatch[1].length} chars). ` +
+                `Claude Skills require descriptions ≤200 chars. ` +
+                `Try reducing the number of objects or simplifying the description.`);
+        }
+        // Validate Claude Skill name length requirement (≤64 chars)
+        const nameMatch = skillMd.match(/^name:\s*(.+)$/m);
+        if (nameMatch && nameMatch[1].trim().length > 64) {
+            throw new Error(`Skill name exceeds 64 characters (${nameMatch[1].trim().length} chars). ` +
+                `Claude Skills require names ≤64 chars.`);
+        }
+        // Generate per-object attribute files for progressive disclosure
+        // This enables Claude to load only the object it's working with (~2k tokens)
+        // instead of the entire monolithic file (~10k tokens)
+        // @see Issue #1014
+        const attributeFiles = {};
+        for (const obj of schema.objects) {
+            const objectSchema = { ...schema, objects: [obj] };
+            const attrMd = await this.renderTemplate('attribute-reference.template.md', objectSchema);
+            attributeFiles[`resources/${obj.objectSlug}-attributes.md`] = attrMd;
+        }
+        const complexTypes = await this.renderTemplate('complex-types.template.md', schema);
+        return {
+            format: 'skill',
+            files: {
+                'SKILL.md': skillMd,
+                ...attributeFiles,
+                'resources/complex-types.md': complexTypes,
+            },
+        };
+    }
+    /**
+     * Formats as single markdown file (all-in-one)
+     *
+     * @param schema - Workspace schema
+     * @returns Single markdown file
+     */
+    async formatAsMarkdown(schema) {
+        // Render all templates and combine them
+        const skillMd = await this.renderTemplate('SKILL.template.md', schema);
+        const attrRef = await this.renderTemplate('attribute-reference.template.md', schema);
+        const complexTypes = await this.renderTemplate('complex-types.template.md', schema);
+        // Combine into single document
+        const combined = `${skillMd}\n\n---\n\n${attrRef}\n\n---\n\n${complexTypes}`;
+        return {
+            format: 'markdown',
+            files: {
+                'attio-workspace-schema.md': combined,
+            },
+        };
+    }
+    /**
+     * Formats as JSON (machine-readable)
+     *
+     * @param schema - Workspace schema
+     * @returns JSON representation
+     */
+    formatAsJSON(schema) {
+        return {
+            format: 'json',
+            files: {
+                'attio-workspace-schema.json': JSON.stringify(schema, null, 2),
+            },
+        };
+    }
+    /**
+     * Renders a template with the given data
+     *
+     * @param templateName - Template filename
+     * @param data - Data to pass to template
+     * @returns Rendered template string
+     */
+    async renderTemplate(templateName, data) {
+        // Check cache first
+        if (!this.templates.has(templateName)) {
+            // Load and compile template
+            const templatePath = path.join(__dirname, '../../templates/skill', templateName);
+            try {
+                const templateSource = await fs.readFile(templatePath, 'utf8');
+                const compiledTemplate = Handlebars.compile(templateSource);
+                this.templates.set(templateName, compiledTemplate);
+            }
+            catch (error) {
+                throw new Error(`Failed to load template ${templateName}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // Render template
+        const template = this.templates.get(templateName);
+        return template(data);
+    }
+    /**
+     * Registers custom Handlebars helpers
+     */
+    registerHelpers() {
+        if (this.helpersRegistered) {
+            return;
+        }
+        // Helper: Display checkmark or X for boolean values
+        Handlebars.registerHelper('checkmark', (value) => {
+            return value ? '✓' : '✗';
+        });
+        // Helper: Subtract two numbers
+        Handlebars.registerHelper('subtract', (a, b) => {
+            return a - b;
+        });
+        // Helper: JSON stringify with formatting
+        Handlebars.registerHelper('json', (obj) => {
+            return JSON.stringify(obj, null, 2);
+        });
+        this.helpersRegistered = true;
+    }
+}
+//# sourceMappingURL=SchemaFormatterService.js.map

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

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

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

@@ -0,0 +1,84 @@
+/**
+ * Service for fetching and aggregating Attio workspace schema data
+ *
+ * This service orchestrates calls to existing services to build a complete
+ * workspace schema including objects, attributes, select options, and metadata.
+ *
+ * @see Issue #983
+ */
+import type { WorkspaceSchema, FetchSchemaOptions } from './types.js';
+/**
+ * Service for fetching complete workspace schema data
+ *
+ * Note: API key flows through getLazyAttioClient() from environment/context,
+ * not through constructor dependency injection.
+ */
+export declare class WorkspaceSchemaService {
+    /**
+     * Creates a new WorkspaceSchemaService
+     */
+    constructor();
+    /**
+     * Fetches the display title for an object from the Attio API
+     *
+     * @param objectSlug - Object API slug (e.g., 'companies', 'custom_prospecting_list')
+     * @returns The object title from Attio, or null if fetch fails
+     * @see Issue #1017
+     */
+    private fetchObjectTitle;
+    private getOptionFetchDelayMs;
+    /**
+     * Fetches complete workspace schema for specified objects
+     *
+     * This method implements graceful degradation:
+     * - If an object fails to fetch, it logs the error and continues with other objects
+     * - If an attribute's options fail to fetch, it includes the attribute without options
+     *
+     * @param objectSlugs - Array of object slugs to fetch (e.g., ['companies', 'people'])
+     * @param options - Fetching options (max options, include archived)
+     * @returns Complete workspace schema
+     */
+    fetchSchema(objectSlugs: string[], options: FetchSchemaOptions): Promise<WorkspaceSchema>;
+    /**
+     * Fetches schema for a single object
+     *
+     * @param objectSlug - Object slug (e.g., 'companies', 'people', 'deals')
+     * @param options - Fetching options
+     * @returns Object schema with all attributes and metadata
+     */
+    private fetchObjectSchema;
+    /**
+     * Checks if an attribute type supports options (select, status, multi-select)
+     *
+     * @param type - Attribute type from Attio API
+     * @returns True if attribute supports options
+     */
+    private isOptionBasedAttribute;
+    /**
+     * Checks if an attribute type is a complex type requiring structure documentation
+     *
+     * @param type - Attribute type from Attio API
+     * @returns True if attribute is a complex type
+     */
+    private isComplexType;
+    /**
+     * Gets the structure definition for complex attribute types
+     *
+     * @param type - Complex attribute type
+     * @returns Structure definition with field types
+     */
+    private getComplexTypeStructure;
+    /**
+     * Gets human-readable display name for an object slug
+     *
+     * Uses the fetched title from Attio API if available, otherwise falls back
+     * to hardcoded display names for Phase 1 objects or slug capitalization.
+     *
+     * @param objectSlug - Object API slug
+     * @param fetchedTitle - Title fetched from Attio API (optional)
+     * @returns Human-readable display name
+     * @see Issue #1017
+     */
+    private getDisplayName;
+}
+//# sourceMappingURL=WorkspaceSchemaService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSchemaService.d.ts","sourceRoot":"","sources":["../../../src/services/skill-generator/WorkspaceSchemaService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EACV,eAAe,EAGf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAsCpB;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;;IAKH;;;;;;OAMG;YACW,gBAAgB;IAgB9B,OAAO,CAAC,qBAAqB;IAa7B;;;;;;;;;;OAUG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC;IA4B3B;;;;;;OAMG;YACW,iBAAiB;IA2G/B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IASrB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IA0C/B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;CAyBvB"}