ai-prompt-guide-mcp 1.0.0

package/dist/prompts/__tests__/prompt-loader.test.js

@@ -0,0 +1,300 @@
+/**
+ * Unit tests for PromptLoader with dual-directory support
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtemp, writeFile, rm } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { PromptLoader } from '../prompt-loader.js';
+describe('PromptLoader - Dual Directory Loading', () => {
+    let tempDir;
+    let workflowsDir;
+    let guidesDir;
+    beforeEach(async () => {
+        // Create temporary test directory structure
+        const { mkdir } = await import('fs/promises');
+        tempDir = await mkdtemp(join(tmpdir(), 'prompt-loader-test-'));
+        workflowsDir = join(tempDir, 'workflows');
+        guidesDir = join(tempDir, 'guides');
+        // Create test directories
+        await mkdir(workflowsDir, { recursive: true });
+        await mkdir(guidesDir, { recursive: true });
+    });
+    afterEach(async () => {
+        // Clean up temporary directory
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    describe('Single Directory Loading (Existing Functionality)', () => {
+        it('should load prompts from workflows directory without prefix', async () => {
+            // Create workflows directory with test file
+            await writeFile(join(workflowsDir, 'test-workflow.md'), `---
+description: Test workflow description
+whenToUse: "When testing workflows"
+---
+
+# Test Workflow Content
+
+This is test content.`);
+            const loader = new PromptLoader([{ path: workflowsDir }]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('test-workflow');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.description).toBe('Test workflow description');
+        });
+        it('should handle missing directory gracefully', async () => {
+            const loader = new PromptLoader([{ path: join(tempDir, 'nonexistent') }]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(0);
+            expect(loader.getErrors()).toHaveLength(0);
+        });
+        it('should skip invalid files and collect errors', async () => {
+            await writeFile(join(workflowsDir, 'INVALID-NAME.md'), `---
+description: Invalid filename
+---
+
+Content`);
+            await writeFile(join(workflowsDir, 'valid-file.md'), `---
+description: Valid file
+---
+
+Valid content`);
+            const loader = new PromptLoader([{ path: workflowsDir }]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('valid-file');
+            const errors = loader.getErrors();
+            expect(errors).toHaveLength(1);
+            const firstError = errors[0];
+            expect(firstError).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstError.type).toBe('INVALID_FILENAME');
+        });
+    });
+    describe('Dual Directory Loading with Prefixes', () => {
+        it('should load from workflows directory with workflow_ prefix', async () => {
+            await writeFile(join(workflowsDir, 'tdd-incremental.md'), `---
+description: TDD workflow
+---
+
+TDD content here`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('workflow_tdd-incremental');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.description).toBe('TDD workflow');
+        });
+        it('should load from guides directory with guide_ prefix', async () => {
+            await writeFile(join(guidesDir, 'activate-guide-documentation.md'), `---
+description: Guide activation documentation
+---
+
+Guide content here`);
+            const loader = new PromptLoader([
+                { path: guidesDir, prefix: 'guide_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('guide_activate-guide-documentation');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.description).toBe('Guide activation documentation');
+        });
+        it('should load from both directories with correct prefixes', async () => {
+            // Create workflow file
+            await writeFile(join(workflowsDir, 'spec-first.md'), `---
+description: Spec first workflow
+---
+
+Spec first content`);
+            // Create guide file
+            await writeFile(join(guidesDir, 'documentation-standards.md'), `---
+description: Documentation standards guide
+---
+
+Documentation standards content`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' },
+                { path: guidesDir, prefix: 'guide_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(2);
+            const workflowPrompt = prompts.find(p => p.name === 'workflow_spec-first');
+            const guidePrompt = prompts.find(p => p.name === 'guide_documentation-standards');
+            expect(workflowPrompt).toBeDefined();
+            expect(workflowPrompt?.description).toBe('Spec first workflow');
+            expect(guidePrompt).toBeDefined();
+            expect(guidePrompt?.description).toBe('Documentation standards guide');
+        });
+        it('should handle multiple files in each directory', async () => {
+            // Create multiple workflow files
+            await writeFile(join(workflowsDir, 'workflow-one.md'), `---\ndescription: First\n---\nContent 1`);
+            await writeFile(join(workflowsDir, 'workflow-two.md'), `---\ndescription: Second\n---\nContent 2`);
+            // Create multiple guide files
+            await writeFile(join(guidesDir, 'guide-one.md'), `---\ndescription: Guide 1\n---\nGuide content 1`);
+            await writeFile(join(guidesDir, 'guide-two.md'), `---\ndescription: Guide 2\n---\nGuide content 2`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' },
+                { path: guidesDir, prefix: 'guide_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(4);
+            expect(prompts.filter(p => p.name.startsWith('workflow_'))).toHaveLength(2);
+            expect(prompts.filter(p => p.name.startsWith('guide_'))).toHaveLength(2);
+        });
+        it('should collect errors from all directories', async () => {
+            // Invalid file in workflows
+            await writeFile(join(workflowsDir, 'INVALID.md'), `---\ndescription: Bad\n---\nContent`);
+            // Invalid file in guides
+            await writeFile(join(guidesDir, 'ALSO-INVALID.md'), `---\ndescription: Bad\n---\nContent`);
+            // Valid files
+            await writeFile(join(workflowsDir, 'valid-workflow.md'), `---\ndescription: Good\n---\nContent`);
+            await writeFile(join(guidesDir, 'valid-guide.md'), `---\ndescription: Good\n---\nContent`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' },
+                { path: guidesDir, prefix: 'guide_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(2);
+            expect(loader.getErrors()).toHaveLength(2);
+            expect(loader.getErrors().every(e => e.type === 'INVALID_FILENAME')).toBe(true);
+        });
+        it('should preserve all frontmatter fields with prefixes', async () => {
+            await writeFile(join(workflowsDir, 'complex-workflow.md'), `---
+title: Complex Workflow Title
+description: Complex workflow description
+whenToUse: "When you need complex workflows or testing edge cases"
+---
+
+# Complex Workflow
+
+This is complex content with multiple sections.
+
+## Section 1
+Content here.
+
+## Section 2
+More content.`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const prompt = prompts[0];
+            expect(prompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(prompt.name).toBe('workflow_complex-workflow');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(prompt.description).toBe('Complex workflow description');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(prompt.whenToUse).toBe('When you need complex workflows or testing edge cases');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(prompt.content).toContain('# Complex Workflow');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(prompt.content).toContain('## Section 1');
+        });
+        it('should handle empty directories in multi-directory config', async () => {
+            await writeFile(join(workflowsDir, 'only-workflow.md'), `---\ndescription: Only workflow\n---\nContent`);
+            // guidesDir exists but is empty
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' },
+                { path: guidesDir, prefix: 'guide_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('workflow_only-workflow');
+        });
+    });
+    describe('Prefix Edge Cases', () => {
+        it('should handle empty prefix (no prefix applied)', async () => {
+            await writeFile(join(workflowsDir, 'no-prefix.md'), `---\ndescription: No prefix\n---\nContent`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: '' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('no-prefix');
+        });
+        it('should handle undefined prefix (no prefix applied)', async () => {
+            await writeFile(join(workflowsDir, 'undefined-prefix.md'), `---\ndescription: Undefined prefix\n---\nContent`);
+            const loader = new PromptLoader([
+                { path: workflowsDir }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('undefined-prefix');
+        });
+        it('should support custom prefixes beyond workflow_ and guide_', async () => {
+            await writeFile(join(workflowsDir, 'custom-file.md'), `---\ndescription: Custom prefix\n---\nContent`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'custom_prefix_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(1);
+            const firstPrompt = prompts[0];
+            expect(firstPrompt).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstPrompt.name).toBe('custom_prefix_custom-file');
+        });
+    });
+    describe('Error Reporting', () => {
+        it('should include directory context in error messages', async () => {
+            // This test verifies that errors include which directory they came from
+            await writeFile(join(workflowsDir, 'INVALID.md'), `---\ndescription: Bad\n---\nContent`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' }
+            ]);
+            await loader.loadAll();
+            const errors = loader.getErrors();
+            expect(errors).toHaveLength(1);
+            const firstError = errors[0];
+            expect(firstError).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstError.filename).toBe('INVALID.md');
+        });
+        it('should handle empty content validation', async () => {
+            await writeFile(join(workflowsDir, 'empty-content.md'), `---
+description: Empty content file
+---
+
+`);
+            const loader = new PromptLoader([
+                { path: workflowsDir, prefix: 'workflow_' }
+            ]);
+            const prompts = await loader.loadAll();
+            expect(prompts).toHaveLength(0);
+            const errors = loader.getErrors();
+            expect(errors).toHaveLength(1);
+            const firstError = errors[0];
+            expect(firstError).toBeDefined();
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstError.type).toBe('VALIDATION_ERROR');
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            expect(firstError.message).toContain('empty');
+        });
+    });
+});
+//# sourceMappingURL=prompt-loader.test.js.map

package/dist/prompts/__tests__/prompt-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-loader.test.js","sourceRoot":"","sources":["../../../src/prompts/__tests__/prompt-loader.test.ts"],"names":[],"mappings":"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"}

package/dist/prompts/prompt-loader.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Prompt file loader for workflow prompts
+ */
+import type { WorkflowPrompt } from './workflow-prompts.js';
+import type { PromptLoadError } from './types.js';
+/**
+ * Directory configuration for prompt loading
+ */
+export interface DirectoryConfig {
+    /** Path to the directory */
+    path: string;
+    /** Optional prefix to add to prompt names from this directory */
+    prefix?: string;
+}
+/**
+ * Loads all workflow prompts from one or more directories
+ */
+export declare class PromptLoader {
+    private readonly directories;
+    private readonly errors;
+    /**
+     * Create a new PromptLoader
+     * @param directories - Single directory config or array of directory configs
+     */
+    constructor(directories: DirectoryConfig | DirectoryConfig[]);
+    /**
+     * Load all workflow prompts from configured directories
+     * @returns Array of loaded workflow prompts
+     */
+    loadAll(): Promise<WorkflowPrompt[]>;
+    /**
+     * Load prompts from a single directory
+     * @param dirConfig - Directory configuration
+     * @returns Array of loaded workflow prompts from this directory
+     */
+    private loadFromDirectory;
+    /**
+     * Load and parse a single prompt file
+     * @param directory - The directory containing the file
+     * @param filename - The filename to load
+     * @param prefix - Optional prefix to add to the prompt name
+     * @returns Parsed workflow prompt or null if loading failed
+     */
+    private loadPromptFile;
+    /**
+     * Convert parsed prompt file to WorkflowPrompt format
+     * @param parsed - Parsed prompt file data
+     * @param prefix - Optional prefix to add to the prompt name
+     * @returns WorkflowPrompt object
+     */
+    private convertToWorkflowPrompt;
+    /**
+     * Get all loading errors encountered
+     * @returns Array of prompt load errors
+     */
+    getErrors(): readonly PromptLoadError[];
+}
+//# sourceMappingURL=prompt-loader.d.ts.map

package/dist/prompts/prompt-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-loader.d.ts","sourceRoot":"","sources":["../../src/prompts/prompt-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,YAAY,CAAC;AAgBpE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD;;;OAGG;gBACS,WAAW,EAAE,eAAe,GAAG,eAAe,EAAE;IAI5D;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgC1C;;;;OAIG;YACW,iBAAiB;IAuD/B;;;;;;OAMG;YACW,cAAc;IAkF5B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;;OAGG;IACH,SAAS,IAAI,SAAS,eAAe,EAAE;CAGxC"}

package/dist/prompts/prompt-loader.js

@@ -0,0 +1,215 @@
+/**
+ * Prompt file loader for workflow prompts
+ */
+import { readdir, readFile } from 'fs/promises';
+import { join, basename } from 'path';
+import matter from 'gray-matter';
+import { getGlobalLogger } from '../utils/logger.js';
+import { PromptLoadErrorType } from './types.js';
+import { isValidFilename, getFilenameErrorMessage, validateFrontmatter, normalizeFrontmatter } from './prompt-validator.js';
+const logger = getGlobalLogger();
+/**
+ * Workflow prompt file extension
+ */
+const PROMPT_FILE_EXTENSION = '.md';
+/**
+ * Loads all workflow prompts from one or more directories
+ */
+export class PromptLoader {
+    directories;
+    errors = [];
+    /**
+     * Create a new PromptLoader
+     * @param directories - Single directory config or array of directory configs
+     */
+    constructor(directories) {
+        this.directories = Array.isArray(directories) ? directories : [directories];
+    }
+    /**
+     * Load all workflow prompts from configured directories
+     * @returns Array of loaded workflow prompts
+     */
+    async loadAll() {
+        this.errors.length = 0; // Clear previous errors
+        const allPrompts = [];
+        // Process each directory
+        for (const dirConfig of this.directories) {
+            const prompts = await this.loadFromDirectory(dirConfig);
+            allPrompts.push(...prompts);
+        }
+        // Log summary
+        logger.info('Workflow prompts loaded from all directories', {
+            loaded: allPrompts.length,
+            failed: this.errors.length,
+            directories: this.directories.length
+        });
+        // Log errors if any
+        if (this.errors.length > 0) {
+            for (const error of this.errors) {
+                logger.warn('Failed to load prompt file', {
+                    filename: error.filename,
+                    type: error.type,
+                    message: error.message,
+                    ...(error.details != null && { details: error.details })
+                });
+            }
+        }
+        return allPrompts;
+    }
+    /**
+     * Load prompts from a single directory
+     * @param dirConfig - Directory configuration
+     * @returns Array of loaded workflow prompts from this directory
+     */
+    async loadFromDirectory(dirConfig) {
+        const { path: promptsDirectory, prefix } = dirConfig;
+        // Check if directory exists
+        try {
+            await readdir(promptsDirectory);
+        }
+        catch (error) {
+            logger.warn('Prompts directory not found', {
+                directory: promptsDirectory,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return [];
+        }
+        // Read all files in directory
+        let files;
+        try {
+            files = await readdir(promptsDirectory);
+        }
+        catch (error) {
+            logger.error('Failed to read prompts directory', {
+                directory: promptsDirectory,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return [];
+        }
+        // Filter for .md files
+        const promptFiles = files.filter(f => f.endsWith(PROMPT_FILE_EXTENSION));
+        if (promptFiles.length === 0) {
+            logger.warn('No workflow prompt files found', {
+                directory: promptsDirectory,
+                extension: PROMPT_FILE_EXTENSION
+            });
+            return [];
+        }
+        logger.info('Loading workflow prompts from directory', {
+            directory: promptsDirectory,
+            fileCount: promptFiles.length,
+            prefix: prefix ?? 'none'
+        });
+        // Load and parse each file
+        const prompts = [];
+        for (const file of promptFiles) {
+            const prompt = await this.loadPromptFile(promptsDirectory, file, prefix);
+            if (prompt != null) {
+                prompts.push(prompt);
+            }
+        }
+        return prompts;
+    }
+    /**
+     * Load and parse a single prompt file
+     * @param directory - The directory containing the file
+     * @param filename - The filename to load
+     * @param prefix - Optional prefix to add to the prompt name
+     * @returns Parsed workflow prompt or null if loading failed
+     */
+    async loadPromptFile(directory, filename, prefix) {
+        const filepath = join(directory, filename);
+        const nameWithoutExt = basename(filename, PROMPT_FILE_EXTENSION);
+        // Validate filename format
+        if (!isValidFilename(nameWithoutExt)) {
+            this.errors.push({
+                type: PromptLoadErrorType.INVALID_FILENAME,
+                filename,
+                message: getFilenameErrorMessage(nameWithoutExt)
+            });
+            return null;
+        }
+        // Read file contents
+        let fileContents;
+        try {
+            fileContents = await readFile(filepath, 'utf-8');
+        }
+        catch (error) {
+            this.errors.push({
+                type: PromptLoadErrorType.FILE_READ_ERROR,
+                filename,
+                message: 'Failed to read file',
+                details: error instanceof Error ? error.message : String(error)
+            });
+            return null;
+        }
+        // Parse frontmatter and content
+        let parsed;
+        try {
+            const { data, content } = matter(fileContents);
+            // Validate frontmatter
+            const validationErrors = validateFrontmatter(data);
+            if (validationErrors.length > 0) {
+                this.errors.push({
+                    type: PromptLoadErrorType.VALIDATION_ERROR,
+                    filename,
+                    message: 'Invalid frontmatter',
+                    details: validationErrors.join('; ')
+                });
+                return null;
+            }
+            // Normalize frontmatter with defaults
+            const frontmatter = normalizeFrontmatter(data, nameWithoutExt);
+            parsed = {
+                frontmatter,
+                content: content.trim(),
+                filename: nameWithoutExt,
+                filepath
+            };
+        }
+        catch (error) {
+            this.errors.push({
+                type: PromptLoadErrorType.PARSE_ERROR,
+                filename,
+                message: 'Failed to parse file',
+                details: error instanceof Error ? error.message : String(error)
+            });
+            return null;
+        }
+        // Validate content is not empty
+        if (parsed.content === '') {
+            this.errors.push({
+                type: PromptLoadErrorType.VALIDATION_ERROR,
+                filename,
+                message: 'Prompt content cannot be empty'
+            });
+            return null;
+        }
+        // Convert to WorkflowPrompt with optional prefix
+        return this.convertToWorkflowPrompt(parsed, prefix);
+    }
+    /**
+     * Convert parsed prompt file to WorkflowPrompt format
+     * @param parsed - Parsed prompt file data
+     * @param prefix - Optional prefix to add to the prompt name
+     * @returns WorkflowPrompt object
+     */
+    convertToWorkflowPrompt(parsed, prefix) {
+        // Apply prefix if provided and not empty
+        const name = (prefix != null && prefix !== '') ? `${prefix}${parsed.filename}` : parsed.filename;
+        return {
+            name,
+            description: parsed.frontmatter.description ?? '',
+            content: parsed.content,
+            whenToUse: parsed.frontmatter.whenToUse ?? ''
+        };
+    }
+    /**
+     * Get all loading errors encountered
+     * @returns Array of prompt load errors
+     */
+    getErrors() {
+        return this.errors;
+    }
+}
+//# sourceMappingURL=prompt-loader.js.map

package/dist/prompts/prompt-loader.js.map

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

package/dist/prompts/prompt-validator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Validation utilities for workflow prompt files
+ */
+import type { PromptFrontmatter } from './types.js';
+/**
+ * Validates a prompt filename (without extension)
+ * @param filename - The filename to validate (without .md extension)
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidFilename(filename: string): boolean;
+/**
+ * Gets a human-readable error message for an invalid filename
+ * @param filename - The invalid filename
+ * @returns Error message explaining the validation failure
+ */
+export declare function getFilenameErrorMessage(filename: string): string;
+/**
+ * Validates frontmatter structure
+ * @param frontmatter - The frontmatter object to validate
+ * @returns Array of validation error messages (empty if valid)
+ */
+export declare function validateFrontmatter(frontmatter: unknown): string[];
+/**
+ * Normalizes frontmatter data with defaults
+ * @param frontmatter - Raw frontmatter object
+ * @param filename - Filename to use as fallback for title
+ * @returns Normalized frontmatter with all fields populated
+ */
+export declare function normalizeFrontmatter(frontmatter: unknown, filename: string): PromptFrontmatter;
+//# sourceMappingURL=prompt-validator.d.ts.map

package/dist/prompts/prompt-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-validator.d.ts","sourceRoot":"","sources":["../../src/prompts/prompt-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,CA0BlE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAQnB"}