@prompd/cli 0.3.3

package/dist/lib/compiler/stages/dependency.js

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * Dependency Resolution Stage
+ *
+ * Resolves 'using:' imports and 'inherits:' chains, handling both local file
+ * paths and package references with alias resolution.
+ *
+ * This is a direct port of the Python CLI's DependencyResolutionStage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyResolutionStage = void 0;
+const package_resolver_1 = require("../package-resolver");
+class DependencyResolutionStage {
+    async process(context) {
+        if (!context.metadata) {
+            return;
+        }
+        // Initialize resolved packages
+        const resolvedPackages = {};
+        // Process 'using' field (package imports with optional prefixes)
+        if (context.metadata.using) {
+            await this.processUsingField(context, context.metadata.using, resolvedPackages);
+        }
+        // Store resolved imports
+        context.dependencies.imports = resolvedPackages;
+        // Process 'inherits' field (can be package reference or direct file path)
+        if (context.metadata.inherits) {
+            await this.processInheritsField(context, context.metadata.inherits, resolvedPackages);
+        }
+        // Process content reference fields for alias resolution
+        await this.processContentFieldAliases(context, resolvedPackages);
+    }
+    /**
+     * Process the 'using' field for package imports.
+     */
+    async processUsingField(context, usingImports, resolvedPackages) {
+        if (typeof usingImports === 'string') {
+            // Simple string: using: "@package@version"
+            await this.resolvePackageImport(context, usingImports, null, resolvedPackages);
+        }
+        else if (Array.isArray(usingImports)) {
+            // List of packages (can be strings, dicts, or objects)
+            for (const item of usingImports) {
+                if (typeof item === 'string') {
+                    // Simple string in list
+                    await this.resolvePackageImport(context, item, null, resolvedPackages);
+                }
+                else if (typeof item === 'object' && item !== null) {
+                    // Object with name and REQUIRED prefix
+                    const packageRef = item.name || item.package || '';
+                    const prefix = item.prefix;
+                    if (packageRef) {
+                        // Prefix is required for 'using' - the whole point is to create a shorthand
+                        if (!prefix) {
+                            context.addError(`Package '${packageRef}' in 'using' field must have a prefix for shorthand access`);
+                            continue;
+                        }
+                        await this.resolvePackageImport(context, packageRef, prefix, resolvedPackages);
+                    }
+                }
+            }
+        }
+        else if (typeof usingImports === 'object' && usingImports !== null) {
+            // Dict format: {package: prefix} or structured format
+            for (const [key, value] of Object.entries(usingImports)) {
+                if (typeof value === 'string') {
+                    // Format: {"@package@version": "prefix"}
+                    await this.resolvePackageImport(context, key, value, resolvedPackages);
+                }
+                else if (typeof value === 'object' && value !== null && 'prefix' in value) {
+                    // Format: {"@package@version": {"prefix": "alias"}}
+                    const prefix = value.prefix;
+                    await this.resolvePackageImport(context, key, prefix, resolvedPackages);
+                }
+            }
+        }
+    }
+    /**
+     * Resolve a single package import.
+     */
+    async resolvePackageImport(context, packageRef, prefix, resolvedPackages) {
+        try {
+            // Pass fileSystem, registryUrl, and workspaceRoot to enable proper package resolution
+            const packagePath = await (0, package_resolver_1.resolvePackage)(packageRef, {
+                fileSystem: context.fileSystem,
+                registryUrl: context.registryUrl,
+                workspaceRoot: context.workspaceRoot
+            });
+            resolvedPackages[packageRef] = {
+                path: packagePath,
+                prefix: prefix || undefined
+            };
+            if (context.verbose) {
+                if (prefix) {
+                    console.log(`✓ Resolved package: ${packageRef} -> ${packagePath} (prefix: ${prefix})`);
+                }
+                else {
+                    console.log(`✓ Resolved package: ${packageRef} -> ${packagePath}`);
+                }
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Find location of 'using:' in source
+            const location = context.findLocation(/using:/);
+            context.addDiagnostic({
+                message: `Failed to resolve package ${packageRef}: ${errorMessage}`,
+                severity: 'warning',
+                source: 'dependency',
+                code: 'PACKAGE_NOT_FOUND',
+                ...location
+            });
+        }
+    }
+    /**
+     * Process the 'inherits' field.
+     */
+    async processInheritsField(context, inheritsRef, resolvedPackages) {
+        // Resolve aliases in inherits field
+        const resolvedInheritsRef = this.resolveAliasInPath(inheritsRef, resolvedPackages);
+        if (resolvedInheritsRef !== inheritsRef) {
+            // Update the metadata with the resolved reference
+            if (context.metadata) {
+                context.metadata.inherits = resolvedInheritsRef;
+            }
+            if (context.verbose) {
+                console.log(`✓ Resolved alias in inherits: ${resolvedInheritsRef}`);
+            }
+        }
+        // Check if it's a local file path (starts with . or / or doesn't start with @)
+        if (resolvedInheritsRef.startsWith('./') ||
+            resolvedInheritsRef.startsWith('../') ||
+            resolvedInheritsRef.startsWith('/') ||
+            (!resolvedInheritsRef.startsWith('@') && resolvedInheritsRef.includes('.prmd'))) {
+            // Direct file path - resolve relative to source file
+            const sourceDir = context.fileSystem.dirname(context.sourceFile);
+            const parentPath = context.fileSystem.resolve(sourceDir, resolvedInheritsRef);
+            // Verify the inherited file exists
+            const fileExists = await context.fileSystem.exists(parentPath);
+            if (!fileExists) {
+                const location = context.findLocation(/inherits:/);
+                context.addDiagnostic({
+                    message: `Inherited file not found: "${resolvedInheritsRef}" (resolved to: ${parentPath})`,
+                    severity: 'error',
+                    source: 'dependency',
+                    code: 'INHERITS_FILE_NOT_FOUND',
+                    ...location
+                });
+                return; // Don't set dependencies.inherits if file doesn't exist
+            }
+            context.dependencies.inherits = parentPath;
+            if (context.verbose) {
+                console.log(`✓ Resolved inheritance file: ${resolvedInheritsRef} -> ${parentPath}`);
+            }
+        }
+        else {
+            // Package reference with file path - resolve through package system
+            try {
+                // Parse package reference and file path
+                // Format: @namespace/package@version/path/to/file.prmd
+                const pattern = /^(@[\w.-]+\/[\w.-]+@[\w.-]+)\/(.+)$/;
+                const match = resolvedInheritsRef.match(pattern);
+                if (match) {
+                    const packageRef = match[1]; // @namespace/package@version
+                    const filePathInPackage = match[2]; // path/to/file.prmd
+                    if (context.verbose) {
+                        console.log(`Parsing package inheritance: ${packageRef} / ${filePathInPackage}`);
+                    }
+                    // Resolve the package to its local path (pass fileSystem, registryUrl, and workspaceRoot)
+                    const packagePath = await (0, package_resolver_1.resolvePackage)(packageRef, {
+                        fileSystem: context.fileSystem,
+                        registryUrl: context.registryUrl,
+                        workspaceRoot: context.workspaceRoot
+                    });
+                    // Construct full path to the inherited file
+                    const fullFilePath = (0, package_resolver_1.resolvePackageFile)(packagePath, filePathInPackage);
+                    // Verify the file exists within the package
+                    const fileExists = await context.fileSystem.exists(fullFilePath);
+                    if (!fileExists) {
+                        const location = context.findLocation(/inherits:/);
+                        context.addDiagnostic({
+                            message: `Inherited file not found in package: "${filePathInPackage}" (package: ${packageRef})`,
+                            severity: 'error',
+                            source: 'dependency',
+                            code: 'INHERITS_FILE_NOT_FOUND',
+                            ...location
+                        });
+                        return;
+                    }
+                    context.dependencies.inherits = fullFilePath;
+                    if (context.verbose) {
+                        console.log(`✓ Resolved inheritance package: ${resolvedInheritsRef} -> ${fullFilePath}`);
+                    }
+                }
+                else {
+                    // Fallback: try as direct package reference (pass fileSystem, registryUrl, and workspaceRoot)
+                    const parentPath = await (0, package_resolver_1.resolvePackage)(resolvedInheritsRef, {
+                        fileSystem: context.fileSystem,
+                        registryUrl: context.registryUrl,
+                        workspaceRoot: context.workspaceRoot
+                    });
+                    // Verify the package directory exists
+                    const dirExists = await context.fileSystem.exists(parentPath);
+                    if (!dirExists) {
+                        const location = context.findLocation(/inherits:/);
+                        context.addDiagnostic({
+                            message: `Inherited package not found: "${resolvedInheritsRef}"`,
+                            severity: 'error',
+                            source: 'dependency',
+                            code: 'INHERITS_PACKAGE_NOT_FOUND',
+                            ...location
+                        });
+                        return;
+                    }
+                    context.dependencies.inherits = parentPath;
+                    if (context.verbose) {
+                        console.log(`✓ Resolved inheritance package (direct): ${resolvedInheritsRef} -> ${parentPath}`);
+                    }
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                // Find location of 'inherits:' in source
+                const location = context.findLocation(/inherits:/);
+                context.addDiagnostic({
+                    message: `Failed to resolve inheritance "${resolvedInheritsRef}": ${errorMessage}`,
+                    severity: 'error',
+                    source: 'dependency',
+                    code: 'INHERITS_NOT_FOUND',
+                    ...location
+                });
+            }
+        }
+    }
+    /**
+     * Process content reference fields (system, context, user, assistant, response) for alias resolution.
+     */
+    async processContentFieldAliases(context, resolvedPackages) {
+        if (!context.metadata) {
+            return;
+        }
+        const contentFields = ['system', 'assistant', 'context', 'user', 'response'];
+        for (const fieldName of contentFields) {
+            const fieldValue = context.metadata[fieldName];
+            if (fieldValue) {
+                // Handle both single strings and lists of strings
+                if (typeof fieldValue === 'string') {
+                    const resolvedValue = this.resolveAliasInPath(fieldValue, resolvedPackages);
+                    if (resolvedValue !== fieldValue) {
+                        context.metadata[fieldName] = resolvedValue;
+                        if (context.verbose) {
+                            console.log(`✓ Resolved alias in ${fieldName}: ${fieldValue} -> ${resolvedValue}`);
+                        }
+                    }
+                }
+                else if (Array.isArray(fieldValue)) {
+                    const resolvedList = [];
+                    for (const item of fieldValue) {
+                        if (typeof item === 'string') {
+                            const resolvedItem = this.resolveAliasInPath(item, resolvedPackages);
+                            resolvedList.push(resolvedItem);
+                            if (resolvedItem !== item && context.verbose) {
+                                console.log(`✓ Resolved alias in ${fieldName}: ${item} -> ${resolvedItem}`);
+                            }
+                        }
+                        else {
+                            resolvedList.push(item);
+                        }
+                    }
+                    context.metadata[fieldName] = resolvedList;
+                }
+            }
+        }
+    }
+    /**
+     * Resolve alias prefixes in file paths.
+     *
+     * Examples:
+     * - "@pkg/templates/file.prmd" with "@pkg" aliased to "@scope/package@version"
+     *   becomes "@scope/package@version/templates/file.prmd"
+     */
+    resolveAliasInPath(pathStr, resolvedPackages) {
+        if (!pathStr.startsWith('@') || !pathStr.includes('/')) {
+            return pathStr;
+        }
+        // Extract the potential alias (everything before the first '/')
+        // Use indexOf to preserve the full remaining path (split with limit truncates)
+        const firstSlashIndex = pathStr.indexOf('/');
+        const potentialAlias = pathStr.substring(0, firstSlashIndex); // e.g., "@pkg"
+        const remainingPath = pathStr.substring(firstSlashIndex + 1); // e.g., "templates/file.prmd"
+        // Look for this alias in resolved packages
+        for (const [packageName, packageInfo] of Object.entries(resolvedPackages)) {
+            if (packageInfo.prefix === potentialAlias) {
+                // Found the alias! Replace it with the full package name
+                const resolvedPath = `${packageName}/${remainingPath}`;
+                return resolvedPath;
+            }
+        }
+        // No alias found, return original path
+        return pathStr;
+    }
+    getName() {
+        return 'Dependency Resolution';
+    }
+}
+exports.DependencyResolutionStage = DependencyResolutionStage;
+//# sourceMappingURL=dependency.js.map

package/dist/lib/compiler/stages/dependency.js.map

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

package/dist/lib/compiler/stages/lexical.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lexical Analysis Stage - Parse YAML frontmatter + Markdown content.
+ *
+ * This stage parses the .prmd file into structured metadata and content,
+ * populating the compilation context for subsequent stages.
+ */
+import { CompilerStage, CompilationContext } from '../types';
+export declare class LexicalAnalysisStage implements CompilerStage {
+    private parser;
+    constructor();
+    process(context: CompilationContext): Promise<void>;
+    /**
+     * Convert YAML-defined sections (system, user, assistant, etc.) to markdown sections.
+     * These are appended to the content after any markdown-defined sections.
+     */
+    private injectYamlSections;
+    getName(): string;
+}
+//# sourceMappingURL=lexical.d.ts.map

package/dist/lib/compiler/stages/lexical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexical.d.ts","sourceRoot":"","sources":["../../../../src/lib/compiler/stages/lexical.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG7D,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,MAAM,CAAe;;IAMvB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CzD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,IAAI,MAAM;CAGlB"}

package/dist/lib/compiler/stages/lexical.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Lexical Analysis Stage - Parse YAML frontmatter + Markdown content.
+ *
+ * This stage parses the .prmd file into structured metadata and content,
+ * populating the compilation context for subsequent stages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LexicalAnalysisStage = void 0;
+const parser_1 = require("../../parser");
+class LexicalAnalysisStage {
+    constructor() {
+        this.parser = new parser_1.PrompdParser();
+    }
+    async process(context) {
+        try {
+            // Read file content from file system
+            const fileContent = await context.fileSystem.readFile(context.sourceFile);
+            // Store raw source for line number calculation in later stages
+            context.rawSource = fileContent;
+            // Parse the .prmd file content
+            const prompd = this.parser.parseContent(fileContent, context.sourceFile);
+            // Populate compilation context
+            context.metadata = prompd.metadata;
+            context.content = prompd.content;
+            // Convert YAML-defined sections to markdown sections
+            context.content = this.injectYamlSections(prompd.metadata, context.content);
+            if (context.verbose) {
+                console.log(`✓ Parsed file: ${context.sourceFile}`);
+                console.log(`  - Name: ${prompd.metadata.name}`);
+                console.log(`  - Version: ${prompd.metadata.version || 'N/A'}`);
+                console.log(`  - Parameters: ${prompd.metadata.parameters?.length || 0}`);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Try to extract line number from YAML parser errors
+            let line;
+            let column;
+            const lineMatch = errorMessage.match(/at line (\d+)(?:,? column (\d+))?/i);
+            if (lineMatch) {
+                line = parseInt(lineMatch[1], 10) + 1; // Add 1 for opening ---
+                column = lineMatch[2] ? parseInt(lineMatch[2], 10) : 1;
+            }
+            context.addDiagnostic({
+                message: `Lexical analysis failed: ${errorMessage}`,
+                severity: 'error',
+                source: 'lexical',
+                line,
+                column,
+                code: 'PARSE_ERROR'
+            });
+        }
+    }
+    /**
+     * Convert YAML-defined sections (system, user, assistant, etc.) to markdown sections.
+     * These are appended to the content after any markdown-defined sections.
+     */
+    injectYamlSections(metadata, content) {
+        const yamlSections = [];
+        // Standard section order: system → context → task → user → assistant → response → output
+        const sectionOrder = ['system', 'context', 'task', 'user', 'assistant', 'response', 'output'];
+        for (const sectionName of sectionOrder) {
+            const sectionValue = metadata[sectionName];
+            if (sectionValue) {
+                // Capitalize first letter for markdown heading
+                const headingName = sectionName.charAt(0).toUpperCase() + sectionName.slice(1);
+                if (Array.isArray(sectionValue)) {
+                    // Array of file paths - will be processed by asset extraction stage
+                    yamlSections.push(`# ${headingName}`);
+                    yamlSections.push(`[YAML section with ${sectionValue.length} file reference(s) - will be processed by asset extraction]`);
+                }
+                else if (typeof sectionValue === 'string') {
+                    // Direct string content or single file path
+                    yamlSections.push(`# ${headingName}`);
+                    yamlSections.push(sectionValue);
+                }
+            }
+        }
+        // Append YAML sections to existing content
+        if (yamlSections.length > 0) {
+            const yamlContent = yamlSections.join('\n\n');
+            return content ? `${content}\n\n${yamlContent}` : yamlContent;
+        }
+        return content;
+    }
+    getName() {
+        return 'Lexical Analysis';
+    }
+}
+exports.LexicalAnalysisStage = LexicalAnalysisStage;
+//# sourceMappingURL=lexical.js.map

package/dist/lib/compiler/stages/lexical.js.map

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

package/dist/lib/compiler/stages/semantic.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Semantic Analysis Stage - Validate parameters and references.
+ *
+ * This stage validates the semantic correctness of the prompt, checks required
+ * parameters, applies default values, and validates parameter types.
+ */
+import { CompilerStage, CompilationContext } from '../types';
+export declare class SemanticAnalysisStage implements CompilerStage {
+    process(context: CompilationContext): Promise<void>;
+    /**
+     * Validate parameter type.
+     */
+    private validateParameterType;
+    /**
+     * Validate required metadata fields (id, name, version).
+     */
+    private validateRequiredMetadata;
+    getName(): string;
+}
+//# sourceMappingURL=semantic.d.ts.map

package/dist/lib/compiler/stages/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../../src/lib/compiler/stages/semantic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE7D,qBAAa,qBAAsB,YAAW,aAAa;IACnD,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiFzD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoEhC,OAAO,IAAI,MAAM;CAGlB"}

package/dist/lib/compiler/stages/semantic.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Semantic Analysis Stage - Validate parameters and references.
+ *
+ * This stage validates the semantic correctness of the prompt, checks required
+ * parameters, applies default values, and validates parameter types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticAnalysisStage = void 0;
+class SemanticAnalysisStage {
+    async process(context) {
+        if (!context.metadata) {
+            return;
+        }
+        // Validate required metadata fields
+        this.validateRequiredMetadata(context);
+        // Merge default parameter values and validate required parameters
+        if (context.metadata.parameters) {
+            // Only validate required parameters if we're in execution mode (parameters were explicitly provided).
+            // When editing/validating a file (no parameters passed), we shouldn't warn about
+            // required parameters since they'll be provided at execution time.
+            // A prompt definition file declaring required parameters is perfectly valid.
+            const isExecutionMode = Object.keys(context.parameters).length > 0;
+            for (const param of context.metadata.parameters) {
+                // Add default value if parameter not provided
+                if (!(param.name in context.parameters) && param.default !== undefined) {
+                    context.parameters[param.name] = param.default;
+                    if (context.verbose) {
+                        console.log(`✓ Using default value for '${param.name}': ${param.default}`);
+                    }
+                }
+                // Validate required parameters - only when executing (parameters were provided)
+                // Skip this check when just validating a definition file
+                if (isExecutionMode && param.required && !(param.name in context.parameters)) {
+                    context.addWarning(`Required parameter '${param.name}' not provided`);
+                }
+                // Type validation for provided parameters
+                if (param.name in context.parameters) {
+                    const value = context.parameters[param.name];
+                    const isValid = this.validateParameterType(value, param.type);
+                    if (!isValid) {
+                        context.addWarning(`Parameter '${param.name}' has incorrect type. Expected: ${param.type}, got: ${typeof value}`);
+                    }
+                }
+                // Pattern validation for string parameters
+                if (param.pattern && param.name in context.parameters) {
+                    const value = String(context.parameters[param.name]);
+                    const regex = new RegExp(param.pattern);
+                    if (!regex.test(value)) {
+                        context.addWarning(`Parameter '${param.name}' does not match pattern: ${param.pattern}`);
+                    }
+                }
+                // Range validation for number parameters
+                if (param.type === 'number' && param.name in context.parameters) {
+                    const value = Number(context.parameters[param.name]);
+                    if (param.minimum !== undefined && value < param.minimum) {
+                        context.addWarning(`Parameter '${param.name}' is below minimum value: ${param.minimum}`);
+                    }
+                    if (param.maximum !== undefined && value > param.maximum) {
+                        context.addWarning(`Parameter '${param.name}' exceeds maximum value: ${param.maximum}`);
+                    }
+                }
+            }
+        }
+        if (context.verbose && context.parameters) {
+            const paramCount = Object.keys(context.parameters).length;
+            console.log(`✓ Validated ${paramCount} parameter(s)`);
+        }
+    }
+    /**
+     * Validate parameter type.
+     */
+    validateParameterType(value, expectedType) {
+        switch (expectedType) {
+            case 'string':
+                return typeof value === 'string';
+            case 'number':
+            case 'integer':
+            case 'float':
+                return typeof value === 'number' && !isNaN(value);
+            case 'boolean':
+                return typeof value === 'boolean';
+            case 'array':
+                return Array.isArray(value);
+            case 'object':
+                return typeof value === 'object' && value !== null && !Array.isArray(value);
+            default:
+                return true; // Unknown type, allow it
+        }
+    }
+    /**
+     * Validate required metadata fields (id, name, version).
+     */
+    validateRequiredMetadata(context) {
+        const metadata = context.metadata;
+        if (!metadata)
+            return;
+        // Validate 'id' field
+        if (!metadata.id) {
+            const location = context.findLocation(/^---/m);
+            context.addDiagnostic({
+                message: "Required field 'id' is missing. Add a unique identifier for this prompt.",
+                severity: 'error',
+                source: 'semantic',
+                code: 'MISSING_ID',
+                line: location?.line ? location.line + 1 : 2,
+                column: 1
+            });
+        }
+        else if (typeof metadata.id === 'string') {
+            // Validate kebab-case format
+            if (!/^[a-z0-9-]+$/.test(metadata.id)) {
+                const location = context.findLocation(/^\s*id:/m);
+                context.addDiagnostic({
+                    message: `ID '${metadata.id}' should use kebab-case format (lowercase letters, numbers, hyphens only).`,
+                    severity: 'warning',
+                    source: 'semantic',
+                    code: 'INVALID_ID_FORMAT',
+                    ...location
+                });
+            }
+        }
+        // Validate 'name' field
+        if (!metadata.name) {
+            const location = context.findLocation(/^---/m);
+            context.addDiagnostic({
+                message: "Required field 'name' is missing. Add a display name for this prompt.",
+                severity: 'error',
+                source: 'semantic',
+                code: 'MISSING_NAME',
+                line: location?.line ? location.line + 1 : 2,
+                column: 1
+            });
+        }
+        // Validate 'version' field
+        if (!metadata.version) {
+            const location = context.findLocation(/^---/m);
+            context.addDiagnostic({
+                message: "Required field 'version' is missing. Add a semantic version (e.g., 1.0.0).",
+                severity: 'error',
+                source: 'semantic',
+                code: 'MISSING_VERSION',
+                line: location?.line ? location.line + 1 : 2,
+                column: 1
+            });
+        }
+        else if (typeof metadata.version === 'string') {
+            // Validate semantic version format
+            if (!/^\d+\.\d+\.\d+(-[\w.]+)?(\+[\w.]+)?$/.test(metadata.version)) {
+                const location = context.findLocation(/^\s*version:/m);
+                context.addDiagnostic({
+                    message: `Invalid semantic version '${metadata.version}'. Use format: MAJOR.MINOR.PATCH (e.g., 1.0.0)`,
+                    severity: 'error',
+                    source: 'semantic',
+                    code: 'INVALID_VERSION',
+                    ...location
+                });
+            }
+        }
+    }
+    getName() {
+        return 'Semantic Analysis';
+    }
+}
+exports.SemanticAnalysisStage = SemanticAnalysisStage;
+//# sourceMappingURL=semantic.js.map

package/dist/lib/compiler/stages/semantic.js.map

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