@specverse/engines 4.1.0

package/dist/ai/commands/template.js

@@ -0,0 +1,136 @@
+/**
+ * Action 1: Template Retrieval
+ * Get raw prompt template for specified operation
+ */
+import { readFile } from 'node:fs/promises';
+import { join, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as yaml from 'js-yaml';
+import { resolvePromptPath, validatePromptPath } from '../prompt-loader.js';
+export async function getTemplate(operation, options = {}) {
+    try {
+        // Resolve prompt path based on version
+        const pver = options.pver || 'v1';
+        const promptDir = resolvePromptPath(pver);
+        // Validate prompt path and operation
+        const validation = validatePromptPath(promptDir, operation);
+        if (!validation.valid) {
+            throw new Error(`Invalid prompt configuration: ${validation.errors.join(', ')}`);
+        }
+        // Load template from versioned prompts directory
+        const templatePath = join(promptDir, `${operation}.prompt.yaml`);
+        const templateContent = await readFile(templatePath, 'utf8');
+        const templateData = yaml.load(templateContent);
+        // Construct schema paths (always available, even for raw templates)
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const schemaDir = resolve(__dirname, '../../../schema');
+        const aiSchemaPath = join(schemaDir, 'SPECVERSE-SCHEMA-AI.yaml');
+        const referenceExamplePath = join(schemaDir, 'MINIMAL-SYNTAX-REFERENCE.specly');
+        // Build comprehensive system prompt from all system sections
+        let systemPrompt = '';
+        if (templateData.system?.role) {
+            systemPrompt += templateData.system.role.trim();
+        }
+        if (templateData.system?.context) {
+            if (systemPrompt)
+                systemPrompt += '\n\n';
+            systemPrompt += '## Context\n' + templateData.system.context.trim();
+        }
+        if (templateData.system?.capabilities) {
+            if (systemPrompt)
+                systemPrompt += '\n\n';
+            systemPrompt += '## Capabilities\n';
+            const toBullet = (item) => {
+                if (typeof item === 'string')
+                    return `- ${item}`;
+                if (Array.isArray(item))
+                    return `- ${item.join(', ')}`;
+                if (item && typeof item === 'object') {
+                    const entries = Object.entries(item).map(([k, v]) => `${k}: ${Array.isArray(v) ? v.join(', ') : String(v)}`);
+                    return `- ${entries.join(', ')}`;
+                }
+                return `- ${String(item)}`;
+            };
+            if (Array.isArray(templateData.system.capabilities)) {
+                systemPrompt += templateData.system.capabilities.map((c) => toBullet(c)).join('\n');
+            }
+            else {
+                systemPrompt += typeof templateData.system.capabilities === 'string'
+                    ? templateData.system.capabilities
+                    : toBullet(templateData.system.capabilities);
+            }
+        }
+        if (templateData.system?.constraints) {
+            if (systemPrompt)
+                systemPrompt += '\n\n';
+            systemPrompt += '## Constraints\n';
+            const toBullet = (item) => {
+                if (typeof item === 'string')
+                    return `- ${item}`;
+                if (Array.isArray(item))
+                    return `- ${item.join(', ')}`;
+                if (item && typeof item === 'object') {
+                    const entries = Object.entries(item).map(([k, v]) => `${k}: ${Array.isArray(v) ? v.join(', ') : String(v)}`);
+                    return `- ${entries.join(', ')}`;
+                }
+                return `- ${String(item)}`;
+            };
+            if (Array.isArray(templateData.system.constraints)) {
+                systemPrompt += templateData.system.constraints.map((c) => toBullet(c)).join('\n');
+            }
+            else {
+                systemPrompt += typeof templateData.system.constraints === 'string'
+                    ? templateData.system.constraints
+                    : toBullet(templateData.system.constraints);
+            }
+        }
+        // Build comprehensive context from includes and examples
+        let contextPrompt = '';
+        if (templateData.context?.includes) {
+            if (Array.isArray(templateData.context.includes)) {
+                contextPrompt += '## Includes\n' + templateData.context.includes.map((i) => typeof i === 'string' ? `- ${i}` : `- ${Object.keys(i)[0]}: ${Object.values(i)[0]}`).join('\n');
+            }
+        }
+        if (templateData.examples && Array.isArray(templateData.examples)) {
+            if (contextPrompt)
+                contextPrompt += '\n\n';
+            contextPrompt += '## Examples\n\n';
+            templateData.examples.forEach((example, index) => {
+                contextPrompt += `**Example ${index + 1}: ${example.name}**\n`;
+                if (example.description)
+                    contextPrompt += `${example.description}\n\n`;
+                if (example.input?.requirements) {
+                    contextPrompt += `Requirements: "${example.input.requirements.replace(/\n/g, ' ')}"\n`;
+                }
+                if (example.output) {
+                    contextPrompt += `Output:\n\`\`\`yaml\n${example.output.trim()}\n\`\`\`\n`;
+                }
+                if (example.explanation) {
+                    contextPrompt += `\nExplanation: ${example.explanation.trim()}\n`;
+                }
+                contextPrompt += '\n---\n\n';
+            });
+        }
+        // Replace schema path variables (always, even for raw templates)
+        const replaceSchemaVars = (text) => {
+            return text
+                .replace(/\{\{\s*aiSchemaPath\s*\}\}/g, aiSchemaPath)
+                .replace(/\{\{\s*referenceExamplePath\s*\}\}/g, referenceExamplePath)
+                .replace(/\{\{\s*referenceSchemaPath\s*\}\}/g, referenceExamplePath); // Legacy support
+        };
+        return {
+            name: templateData.name || `${operation}-template`,
+            version: templateData.version || '3.1.0',
+            system: replaceSchemaVars(systemPrompt || templateData.system || ''),
+            user: replaceSchemaVars(templateData.user?.template || templateData.user || ''),
+            context: contextPrompt ? replaceSchemaVars(contextPrompt) : '',
+            variables: templateData.user?.variables?.map((v) => v.name) || []
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to load template for operation '${operation}': ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+export default getTemplate;
+//# sourceMappingURL=template.js.map

package/dist/ai/commands/template.js.map

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

package/dist/ai/config/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SpecVerse AI Configuration System
+ * Loads and manages .specverse configuration files for providers and workflows.
+ */
+import type { LLMProviderConfig } from '../providers/llm-provider.js';
+export interface SpecVerseConfig {
+    version?: string;
+    providers?: {
+        [name: string]: LLMProviderConfig & {
+            type: 'openai' | 'anthropic' | 'azure' | 'local' | 'interactive';
+            enabled?: boolean;
+            default?: boolean;
+            interface?: 'chatgpt' | 'claude' | 'gemini' | 'generic';
+            outputFile?: string;
+            waitForInput?: boolean;
+            formatInstructions?: boolean;
+        };
+    };
+    defaults?: {
+        provider?: string;
+        model?: string;
+        temperature?: number;
+        max_tokens?: number;
+    };
+    prompts?: {
+        directory?: string;
+        custom?: {
+            [name: string]: string;
+        };
+    };
+    outputs?: {
+        directory?: string;
+        format?: 'yaml' | 'json';
+        diagrams?: {
+            enabled?: boolean;
+            types?: string[];
+            output?: string;
+        };
+    };
+    features?: {
+        inference?: boolean;
+        streaming?: boolean;
+        caching?: boolean;
+    };
+}
+export declare class ConfigLoader {
+    private static readonly DEFAULT_CONFIG_NAMES;
+    private config;
+    private configPath?;
+    loadConfig(searchPath?: string): Promise<SpecVerseConfig>;
+    load(searchPath?: string): SpecVerseConfig;
+    getConfig(): SpecVerseConfig;
+    getConfigPath(): string | undefined;
+    getProviderConfig(name?: string): (LLMProviderConfig & {
+        type: string;
+    }) | undefined;
+    getEnabledProviders(): Array<{
+        name: string;
+        config: LLMProviderConfig & {
+            type: string;
+        };
+    }>;
+    private findConfigFile;
+    private expandEnvironmentVariables;
+    private validateConfig;
+    private applyEnvironmentOverrides;
+    private getDefaultConfig;
+    private getDefaultModelForType;
+}
+export declare const configLoader: ConfigLoader;
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE;QACV,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG;YAClC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;YACjE,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;YACxD,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,OAAO,CAAC;YACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;SAC9B,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE;YAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACrC,CAAC;IACF,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE;YACT,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAK1C;IAEF,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAS;IAEtB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB/D,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe;IAmB1C,SAAS,IAAI,eAAe;IAI5B,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,iBAAiB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IAoCpF,mBAAmB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,GAAG;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAe5F,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,yBAAyB;IAejC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,sBAAsB;CAO/B;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/ai/config/index.js

@@ -0,0 +1,193 @@
+/**
+ * SpecVerse AI Configuration System
+ * Loads and manages .specverse configuration files for providers and workflows.
+ */
+import { readFileSync, existsSync, statSync } from 'fs';
+import { join, resolve } from 'path';
+import yaml from 'js-yaml';
+export class ConfigLoader {
+    static DEFAULT_CONFIG_NAMES = [
+        '.specverse.yml',
+        '.specverse.yaml',
+        'specverse.config.yml',
+        'specverse.config.yaml'
+    ];
+    config = {};
+    configPath;
+    async loadConfig(searchPath) {
+        const configPath = this.findConfigFile(searchPath);
+        if (configPath) {
+            this.configPath = configPath;
+            const content = readFileSync(configPath, 'utf8');
+            let config = yaml.load(content);
+            if (!config || typeof config !== 'object') {
+                throw new Error('Configuration file must contain a valid YAML object');
+            }
+            config = this.expandEnvironmentVariables(config);
+            config = this.applyEnvironmentOverrides(config);
+            this.config = config;
+            this.validateConfig();
+        }
+        else {
+            this.config = this.getDefaultConfig();
+        }
+        return this.config;
+    }
+    load(searchPath) {
+        if (searchPath && existsSync(searchPath)) {
+            const content = readFileSync(searchPath, 'utf8');
+            this.config = yaml.load(content);
+            this.configPath = searchPath;
+            this.config = this.expandEnvironmentVariables(this.config);
+            this.config = this.applyEnvironmentOverrides(this.config);
+            this.validateConfig();
+        }
+        else {
+            this.config = this.getDefaultConfig();
+        }
+        if (!this.config.defaults) {
+            this.config.defaults = this.getDefaultConfig().defaults;
+        }
+        return this.config;
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getConfigPath() {
+        return this.configPath;
+    }
+    getProviderConfig(name) {
+        const providers = this.config.providers || {};
+        if (!name) {
+            if (this.config.defaults?.provider) {
+                name = this.config.defaults.provider;
+            }
+            else {
+                const defaultProvider = Object.entries(providers).find(([_, config]) => config.default);
+                if (defaultProvider)
+                    name = defaultProvider[0];
+                else {
+                    const enabledProvider = Object.entries(providers).find(([_, config]) => config.enabled !== false);
+                    if (enabledProvider)
+                        name = enabledProvider[0];
+                }
+            }
+        }
+        if (!name || !providers[name])
+            return undefined;
+        const providerConfig = providers[name];
+        if (providerConfig.enabled === false) {
+            throw new Error(`Provider '${name}' is disabled`);
+        }
+        return {
+            ...providerConfig,
+            model: providerConfig.model || this.config.defaults?.model || this.getDefaultModelForType(providerConfig.type),
+            timeout: providerConfig.timeout || 30000,
+            retries: providerConfig.retries || 3,
+            defaultOptions: {
+                temperature: this.config.defaults?.temperature || 0.7,
+                max_tokens: this.config.defaults?.max_tokens || 4000,
+                ...providerConfig.defaultOptions
+            }
+        };
+    }
+    getEnabledProviders() {
+        const providers = this.config.providers || {};
+        return Object.entries(providers)
+            .filter(([_, config]) => config.enabled !== false)
+            .map(([name, config]) => ({
+            name,
+            config: {
+                ...config,
+                model: config.model || this.getDefaultModelForType(config.type),
+                timeout: config.timeout || 30000,
+                retries: config.retries || 3,
+            }
+        }));
+    }
+    findConfigFile(searchPath) {
+        const startPath = searchPath ? resolve(searchPath) : process.cwd();
+        if (searchPath && existsSync(searchPath) && !statSync(searchPath).isDirectory()) {
+            return resolve(searchPath);
+        }
+        let currentPath = startPath;
+        while (true) {
+            for (const configName of ConfigLoader.DEFAULT_CONFIG_NAMES) {
+                const configPath = join(currentPath, configName);
+                if (existsSync(configPath))
+                    return configPath;
+            }
+            const parentPath = resolve(currentPath, '..');
+            if (parentPath === currentPath)
+                break;
+            currentPath = parentPath;
+        }
+        return undefined;
+    }
+    expandEnvironmentVariables(obj) {
+        if (typeof obj === 'string') {
+            return obj.replace(/\$\{([^}]+)\}/g, (match, varExpr) => {
+                const [varName, defaultValue] = varExpr.split(':-');
+                return process.env[varName] || defaultValue || match;
+            });
+        }
+        else if (Array.isArray(obj)) {
+            return obj.map(item => this.expandEnvironmentVariables(item));
+        }
+        else if (obj && typeof obj === 'object') {
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                result[key] = this.expandEnvironmentVariables(value);
+            }
+            return result;
+        }
+        return obj;
+    }
+    validateConfig() {
+        const config = this.config;
+        if (config.providers) {
+            for (const [name, providerConfig] of Object.entries(config.providers)) {
+                if (!providerConfig.type) {
+                    throw new Error(`Provider '${name}' must specify a type`);
+                }
+                if (!['openai', 'anthropic', 'azure', 'local', 'interactive'].includes(providerConfig.type)) {
+                    throw new Error(`Provider '${name}' has invalid type: ${providerConfig.type}`);
+                }
+            }
+        }
+        if (config.defaults?.provider && !config.providers?.[config.defaults.provider]) {
+            throw new Error(`Default provider '${config.defaults.provider}' is not configured`);
+        }
+    }
+    applyEnvironmentOverrides(config) {
+        const envConfig = { ...config };
+        if (envConfig.providers) {
+            for (const [name, providerConfig] of Object.entries(envConfig.providers)) {
+                const envApiKey = process.env[`SPECVERSE_${name.toUpperCase()}_API_KEY`];
+                if (envApiKey && !providerConfig.apiKey)
+                    providerConfig.apiKey = envApiKey;
+            }
+        }
+        if (process.env.SPECVERSE_DEFAULT_PROVIDER) {
+            envConfig.defaults = envConfig.defaults || {};
+            envConfig.defaults.provider = process.env.SPECVERSE_DEFAULT_PROVIDER;
+        }
+        return envConfig;
+    }
+    getDefaultConfig() {
+        return {
+            defaults: { temperature: 0.7, max_tokens: 4000 },
+            outputs: { directory: 'outputs', format: 'yaml' },
+            features: { inference: true, streaming: true, caching: false },
+        };
+    }
+    getDefaultModelForType(type) {
+        const defaults = {
+            openai: 'gpt-4', anthropic: 'claude-3-sonnet-20240229',
+            azure: 'gpt-4', local: 'local-model', interactive: 'interactive-generic',
+        };
+        return defaults[type] || 'unknown';
+    }
+}
+export const configLoader = new ConfigLoader();
+//# sourceMappingURL=index.js.map

package/dist/ai/config/index.js.map

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

package/dist/ai/config-loader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AI Config Loader - Load and parse AI configuration files
+ */
+import { AIConfig, UserRequirements } from './types/index.js';
+/**
+ * Load AI configuration from YAML file
+ * @param configPath Path to the config file
+ * @returns Parsed AI config
+ */
+export declare function loadAIConfig(configPath: string): AIConfig;
+/**
+ * Merge AI config with command-line options
+ * Config file takes precedence over CLI options
+ * @param config AI config from file
+ * @param cliOptions Options from command line
+ * @returns Merged UserRequirements
+ */
+export declare function mergeConfigWithOptions(config: AIConfig, cliOptions: Partial<UserRequirements>): UserRequirements;
+/**
+ * Check if config specifies libraries (for auto-enhancement)
+ * @param config AI config
+ * @returns True if libraries are specified
+ */
+export declare function hasLibraries(config: AIConfig): boolean;
+/**
+ * Get libraries from config
+ * @param config AI config
+ * @returns Array of library names
+ */
+export declare function getLibraries(config: AIConfig): string[];
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/ai/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/ai/config-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAuBzD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CASlB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAEvD"}

package/dist/ai/config-loader.js

@@ -0,0 +1,66 @@
+/**
+ * AI Config Loader - Load and parse AI configuration files
+ */
+import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import yaml from 'js-yaml';
+/**
+ * Load AI configuration from YAML file
+ * @param configPath Path to the config file
+ * @returns Parsed AI config
+ */
+export function loadAIConfig(configPath) {
+    const resolvedPath = resolve(configPath);
+    if (!existsSync(resolvedPath)) {
+        throw new Error(`AI config file not found: ${resolvedPath}`);
+    }
+    try {
+        const content = readFileSync(resolvedPath, 'utf8');
+        const config = yaml.load(content);
+        // Validate required structure
+        if (!config || typeof config !== 'object') {
+            throw new Error('Invalid AI config format - must be a YAML object');
+        }
+        return config;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to parse AI config: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Merge AI config with command-line options
+ * Config file takes precedence over CLI options
+ * @param config AI config from file
+ * @param cliOptions Options from command line
+ * @returns Merged UserRequirements
+ */
+export function mergeConfigWithOptions(config, cliOptions) {
+    return {
+        requirements: config.requirements || cliOptions.requirements || '',
+        scale: config.scale || cliOptions.scale || 'business',
+        framework: config.framework || cliOptions.framework,
+        domain: config.domain || cliOptions.domain,
+        compliance: config.compliance || cliOptions.compliance,
+        technology_preferences: config.technology || cliOptions.technology_preferences
+    };
+}
+/**
+ * Check if config specifies libraries (for auto-enhancement)
+ * @param config AI config
+ * @returns True if libraries are specified
+ */
+export function hasLibraries(config) {
+    return Array.isArray(config.libraries) && config.libraries.length > 0;
+}
+/**
+ * Get libraries from config
+ * @param config AI config
+ * @returns Array of library names
+ */
+export function getLibraries(config) {
+    return config.libraries || [];
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/ai/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/ai/config-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,CAAC;QAE9C,8BAA8B;QAC9B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAgB,EAChB,UAAqC;IAErC,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,UAAU,CAAC,YAAY,IAAI,EAAE;QAClE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,IAAI,UAAU;QACrD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS;QACnD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM;QAC1C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU;QACtD,sBAAsB,EAAE,MAAM,CAAC,UAAU,IAAI,UAAU,CAAC,sBAAsB;KAC/E,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgB;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgB;IAC3C,OAAO,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/ai/core/ecosystem-prompt-manager.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Ecosystem Prompt Manager
+ *
+ * Central system for generating AI-optimized prompts across the three-tier SpecVerse ecosystem:
+ * - LLM Terminal users (copy-paste prompts)
+ * - Claude Code users (CLAUDE.md integration)
+ * - API Integration users (orchestrator workflows)
+ */
+export type EcosystemType = 'terminal' | 'claude' | 'api';
+export interface ProjectContext {
+    type?: string;
+    domain?: string;
+    scale?: 'small' | 'medium' | 'large' | 'enterprise';
+    compliance?: string[];
+    technology_preferences?: string[];
+    existing_libraries?: string[];
+}
+export interface ClaudeContext {
+    workingDirectory: string;
+    sessionId: string;
+    projectContext?: ProjectContext;
+    previousInteractions?: string[];
+    currentFiles?: string[];
+}
+export interface APIContext {
+    workflowId: string;
+    pipelineContext?: any;
+    automationLevel?: 'basic' | 'full';
+    integrationPoints?: string[];
+}
+export interface LibraryContext {
+    deployments: LibraryGroup[];
+    domains: LibraryGroup[];
+    manifests: LibraryGroup[];
+    types: LibraryGroup[];
+    standards: LibraryGroup[];
+}
+export interface LibraryGroup {
+    name: string;
+    description: string;
+    ai_description: string;
+    path: string;
+    expansion_factor: number;
+    best_for: string[];
+    [key: string]: any;
+}
+export interface TerminalPrompt {
+    systemPrompt: string;
+    contextPrompt: string;
+    userPrompt: string;
+    exampleUsage: string;
+    copyInstructions: string;
+    tokenEstimate: number;
+}
+export interface ClaudePrompt {
+    claudeMdInstructions: string;
+    sessionPrompt: string;
+    fileContextInjection: string;
+    workflowInstructions: string;
+    libraryAwareness: string;
+}
+export interface APIPrompt {
+    orchestratorPrompt: string;
+    pipelineInstructions: string;
+    contextInjection: string;
+    responseHandling: string;
+    validationCriteria: string;
+}
+export declare class LibraryContextGenerator {
+    private catalogCache;
+    private catalogPath;
+    constructor(catalogPath?: string);
+    loadLibraryCatalog(): Promise<any>;
+    generateLibraryContext(projectContext?: ProjectContext): Promise<LibraryContext>;
+    private identifyRelevantLibraries;
+    private scoreDeploymentRelevance;
+    private scoreDomainRelevance;
+    private scoreManifestRelevance;
+    private formatLibraryGroup;
+}
+export declare class EcosystemPromptManager {
+    private libraryContextGenerator;
+    private templateCache;
+    constructor(libraryPath?: string);
+    generateTerminalPrompt(userRequest: string, projectContext?: ProjectContext): Promise<TerminalPrompt>;
+    generateClaudePrompt(userRequest: string, claudeContext: ClaudeContext): Promise<ClaudePrompt>;
+    generateAPIPrompt(workflowDefinition: any, apiContext: APIContext): Promise<APIPrompt>;
+    private generateSystemPrompt;
+    private formatLibraryContextForTerminal;
+    private generateExampleUsage;
+    private generateCopyInstructions;
+    private generateClaudeMdInstructions;
+    private formatLibraryContextForClaude;
+    private formatSessionPrompt;
+    private generateFileContextInjection;
+    private generateWorkflowInstructions;
+    private generateLibraryAwareness;
+    private formatOrchestratorPrompt;
+    private formatLibraryContextForAPI;
+    private generatePipelineInstructions;
+    private generateAPIContextInjection;
+    private generateResponseHandling;
+    private generateValidationCriteria;
+    private estimateTokens;
+}
+export default EcosystemPromptManager;
+//# sourceMappingURL=ecosystem-prompt-manager.d.ts.map

package/dist/ai/core/ecosystem-prompt-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-prompt-manager.d.ts","sourceRoot":"","sources":["../../../src/ai/core/ecosystem-prompt-manager.ts"],"names":[],"mappings":"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"}