@specverse/engines 4.1.0

package/dist/ai/commands/fill.js

@@ -0,0 +1,179 @@
+/**
+ * Action 2: Parameter-Filled Template
+ * Fill template with user requirements and parameters
+ */
+import { getTemplate } from './template.js';
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+function getDirectoryStructure(dirPath, maxDepth = 3) {
+    try {
+        // Use ls to get directory structure
+        const result = execSync(`ls -la "${dirPath}" | head -30`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        // Also try to get subdirectories
+        let subDirs = '';
+        try {
+            subDirs = execSync(`find "${dirPath}" -type d -maxdepth 2 | head -20`, {
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+        }
+        catch {
+            // Ignore subdirectory errors
+        }
+        return `=== Main Directory ===\n${result}\n\n=== Subdirectories ===\n${subDirs}`;
+    }
+    catch (error) {
+        return `Unable to read directory structure: ${error instanceof Error ? error.message : 'Unknown error'}`;
+    }
+}
+function getKeyFilesContent(dirPath) {
+    const filePatterns = [
+        'package.json', 'requirements.txt', 'pom.xml', 'build.gradle',
+        'app.ts', 'app.js', 'server.ts', 'server.js', 'main.ts', 'main.js',
+        'index.ts', 'index.js', '*.model.ts', '*.model.js', 'schema.ts', 'schema.js', 'schema.sql'
+    ];
+    let content = '';
+    // Try to read package.json if it exists
+    const packageJsonPath = join(dirPath, 'package.json');
+    if (existsSync(packageJsonPath)) {
+        try {
+            const pkgContent = readFileSync(packageJsonPath, 'utf8');
+            content += `\n=== package.json ===\n${pkgContent.split('\n').slice(0, 50).join('\n')}\n`;
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // Try to read schema.sql if it exists
+    const schemaPath = join(dirPath, 'schema.sql');
+    if (existsSync(schemaPath)) {
+        try {
+            const schemaContent = readFileSync(schemaPath, 'utf8');
+            content += `\n=== schema.sql ===\n${schemaContent}\n`;
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // Try to read any TypeScript files in app directory
+    const appDir = join(dirPath, 'app');
+    if (existsSync(appDir)) {
+        try {
+            const appFiles = readdirSync(appDir).filter(f => f.endsWith('.ts') || f.endsWith('.tsx'));
+            for (const file of appFiles.slice(0, 3)) {
+                const filePath = join(appDir, file);
+                const fileContent = readFileSync(filePath, 'utf8');
+                content += `\n=== app/${file} ===\n${fileContent.split('\n').slice(0, 100).join('\n')}\n`;
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    return content || 'No key files found';
+}
+export async function fillTemplate(operation, requirements, options = {}) {
+    try {
+        const template = await getTemplate(operation, options);
+        // Construct schema paths based on package installation (like ai docs does)
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const schemaDir = resolve(__dirname, '../../../schema');
+        const aiSchemaPath = join(schemaDir, 'SPECVERSE-V3.1-SCHEMA-AI.yaml');
+        const referenceSchemaPath = join(schemaDir, 'MINIMAL-SYNTAX-REFERENCE.specly');
+        // Prepare variables for substitution
+        let variables = {
+            requirements: requirements.requirements,
+            scale: requirements.scale || 'business',
+            framework: requirements.framework || 'auto-detect',
+            domain: requirements.domain || 'general',
+            compliance: requirements.compliance?.join(', ') || 'none',
+            technology_preferences: requirements.technology_preferences?.join(', ') || 'auto-detect',
+            preferredTech: requirements.technology_preferences?.join(', ') || 'auto-detect',
+            aiSchemaPath,
+            referenceSchemaPath,
+            ...options // Allow additional options to override (includes referenceExamplePath if client provides it)
+        };
+        // Special handling for analyse operation
+        if (operation === 'analyse') {
+            // Extract path from requirements if provided - look for path patterns
+            // Try to match paths that start with /, ./, ../, or contain /
+            const pathMatch = requirements.requirements?.match(/\b((?:\.\.?\/)?(?:[\w-]+\/)+[\w-]*\/?)\b/) ||
+                requirements.requirements?.match(/\bat\s+([^\s]+)$/);
+            const applicationPath = pathMatch ? pathMatch[1] : '.';
+            // Resolve path relative to current working directory
+            const resolvedPath = resolve(process.cwd(), applicationPath);
+            if (existsSync(resolvedPath)) {
+                variables.implementationPath = applicationPath;
+                variables.applicationPath = applicationPath;
+                variables.frameworkType = 'auto-detect';
+                variables.directoryStructure = getDirectoryStructure(resolvedPath);
+                variables.filesContent = getKeyFilesContent(resolvedPath);
+            }
+            else {
+                // Fallback if path doesn't exist
+                variables.implementationPath = applicationPath;
+                variables.applicationPath = applicationPath;
+                variables.frameworkType = 'auto-detect';
+                variables.directoryStructure = `Directory not found: ${resolvedPath}`;
+                variables.filesContent = 'Unable to read files';
+            }
+        }
+        // Special handling for materialise operation
+        if (operation === 'materialise') {
+            // Extract spec file from requirements or use default
+            const specFileMatch = requirements.requirements?.match(/([^\s]+\.specly)/);
+            variables.specificationFile = specFileMatch ? specFileMatch[1] : requirements.requirements || 'specification.specly';
+            variables.targetFramework = requirements.framework || 'auto-detect';
+            variables.implementationStyle = 'production-ready';
+            variables.developmentEnvironment = 'production';
+            variables.componentSpec = 'See specification file';
+            variables.implementationManifest = 'Auto-generated based on specification';
+            variables.deploymentSpec = 'See specification deployment section';
+            variables.dataConsistencyLevel = 'strong';
+            variables.errorHandlingStrategy = 'comprehensive';
+            variables.validationDepth = 'full';
+            variables.setupAutomation = 'enabled';
+        }
+        // Special handling for realize operation
+        if (operation === 'realize') {
+            // Extract spec file from requirements or use default
+            const specFileMatch = requirements.requirements?.match(/([^\s]+\.specly)/);
+            variables.specificationFile = specFileMatch ? specFileMatch[1] : requirements.requirements || 'specification.specly';
+            variables.environmentType = 'production';
+            variables.cloudProvider = 'auto-detect';
+            variables.scaleRequirements = requirements.scale || 'business';
+            variables.componentSpec = 'See specification file';
+            variables.deploymentSpec = 'See specification deployment section';
+        }
+        // Simple template variable substitution
+        let systemPrompt = template.system;
+        let userPrompt = template.user;
+        let contextPrompt = template.context;
+        // Replace {{variable}} patterns
+        Object.entries(variables).forEach(([key, value]) => {
+            const pattern = new RegExp(`{{\\s*${key}\\s*}}`, 'g');
+            systemPrompt = systemPrompt.replace(pattern, String(value));
+            userPrompt = userPrompt.replace(pattern, String(value));
+            if (contextPrompt) {
+                contextPrompt = contextPrompt.replace(pattern, String(value));
+            }
+        });
+        return {
+            systemPrompt,
+            userPrompt,
+            contextPrompt,
+            variables
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fill template for operation '${operation}': ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+export default fillTemplate;
+//# sourceMappingURL=fill.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/ai/commands/fill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAY,MAAM,IAAI,CAAC;AACrE,OAAO,EAAE,IAAI,EAAY,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,SAAS,qBAAqB,CAAC,OAAe,EAAE,WAAmB,CAAC;IAClE,IAAI,CAAC;QACH,oCAAoC;QACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,OAAO,cAAc,EAAE;YACxD,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,iCAAiC;QACjC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,OAAO,GAAG,QAAQ,CAAC,SAAS,OAAO,kCAAkC,EAAE;gBACrE,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QAED,OAAO,2BAA2B,MAAM,+BAA+B,OAAO,EAAE,CAAC;IACnF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAC3G,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,YAAY,GAAG;QACnB,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,cAAc;QAC7D,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS;QAClE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY;KAC3F,CAAC;IAEF,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,wCAAwC;IACxC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO,IAAI,2BAA2B,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3F,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACvD,OAAO,IAAI,yBAAyB,aAAa,IAAI,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1F,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACpC,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACnD,OAAO,IAAI,aAAa,IAAI,SAAS,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5F,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,IAAI,oBAAoB,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAsB,EACtB,YAA8B,EAC9B,UAA4B,EAAE;IAE9B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEvD,2EAA2E;QAC3E,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;QACtE,MAAM,mBAAmB,GAAG,IAAI,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC;QAE/E,qCAAqC;QACrC,IAAI,SAAS,GAAwB;YACnC,YAAY,EAAE,YAAY,CAAC,YAAY;YACvC,KAAK,EAAE,YAAY,CAAC,KAAK,IAAI,UAAU;YACvC,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,aAAa;YAClD,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,SAAS;YACxC,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM;YACzD,sBAAsB,EAAE,YAAY,CAAC,sBAAsB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa;YACxF,aAAa,EAAE,YAAY,CAAC,sBAAsB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa;YAC/E,YAAY;YACZ,mBAAmB;YACnB,GAAG,OAAO,CAAC,6FAA6F;SACzG,CAAC;QAEF,yCAAyC;QACzC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,sEAAsE;YACtE,8DAA8D;YAC9D,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,0CAA0C,CAAC;gBAC5E,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACvE,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAEvD,qDAAqD;YACrD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;YAE7D,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7B,SAAS,CAAC,kBAAkB,GAAG,eAAe,CAAC;gBAC/C,SAAS,CAAC,eAAe,GAAG,eAAe,CAAC;gBAC5C,SAAS,CAAC,aAAa,GAAG,aAAa,CAAC;gBACxC,SAAS,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;gBACnE,SAAS,CAAC,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,iCAAiC;gBACjC,SAAS,CAAC,kBAAkB,GAAG,eAAe,CAAC;gBAC/C,SAAS,CAAC,eAAe,GAAG,eAAe,CAAC;gBAC5C,SAAS,CAAC,aAAa,GAAG,aAAa,CAAC;gBACxC,SAAS,CAAC,kBAAkB,GAAG,wBAAwB,YAAY,EAAE,CAAC;gBACtE,SAAS,CAAC,YAAY,GAAG,sBAAsB,CAAC;YAClD,CAAC;QACH,CAAC;QAED,6CAA6C;QAC7C,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;YAChC,qDAAqD;YACrD,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC3E,SAAS,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,IAAI,sBAAsB,CAAC;YACrH,SAAS,CAAC,eAAe,GAAG,YAAY,CAAC,SAAS,IAAI,aAAa,CAAC;YACpE,SAAS,CAAC,mBAAmB,GAAG,kBAAkB,CAAC;YACnD,SAAS,CAAC,sBAAsB,GAAG,YAAY,CAAC;YAChD,SAAS,CAAC,aAAa,GAAG,wBAAwB,CAAC;YACnD,SAAS,CAAC,sBAAsB,GAAG,uCAAuC,CAAC;YAC3E,SAAS,CAAC,cAAc,GAAG,sCAAsC,CAAC;YAClE,SAAS,CAAC,oBAAoB,GAAG,QAAQ,CAAC;YAC1C,SAAS,CAAC,qBAAqB,GAAG,eAAe,CAAC;YAClD,SAAS,CAAC,eAAe,GAAG,MAAM,CAAC;YACnC,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC;QACxC,CAAC;QAED,yCAAyC;QACzC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,qDAAqD;YACrD,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC3E,SAAS,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,IAAI,sBAAsB,CAAC;YACrH,SAAS,CAAC,eAAe,GAAG,YAAY,CAAC;YACzC,SAAS,CAAC,aAAa,GAAG,aAAa,CAAC;YACxC,SAAS,CAAC,iBAAiB,GAAG,YAAY,CAAC,KAAK,IAAI,UAAU,CAAC;YAC/D,SAAS,CAAC,aAAa,GAAG,wBAAwB,CAAC;YACnD,SAAS,CAAC,cAAc,GAAG,sCAAsC,CAAC;QACpE,CAAC;QAED,wCAAwC;QACxC,IAAI,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;QACnC,IAAI,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC/B,IAAI,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;QAErC,gCAAgC;QAChC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACjD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC;YACtD,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxD,IAAI,aAAa,EAAE,CAAC;gBAClB,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,YAAY;YACZ,UAAU;YACV,aAAa;YACb,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,SAAS,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IACvI,CAAC;AACH,CAAC;AAED,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * AI Commands Index
+ * Exports all AI command implementations
+ */
+export { getTemplate } from './template.js';
+export { fillTemplate } from './fill.js';
+export { suggestLibraries } from './suggest.js';
+export { enhancePrompt } from './enhance.js';
+export { analyseSpec, type Suggestion } from './spec-analyser.js';
+export * from '../types/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAElE,cAAc,mBAAmB,CAAC"}

package/dist/ai/commands/index.js

@@ -0,0 +1,11 @@
+/**
+ * AI Commands Index
+ * Exports all AI command implementations
+ */
+export { getTemplate } from './template.js';
+export { fillTemplate } from './fill.js';
+export { suggestLibraries } from './suggest.js';
+export { enhancePrompt } from './enhance.js';
+export { analyseSpec } from './spec-analyser.js';
+export * from '../types/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAElE,cAAc,mBAAmB,CAAC"}

package/dist/ai/commands/spec-analyser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Spec Analyser — analyses a parsed SpecVerse AST and suggests improvements.
+ *
+ * This is the engine behind `specverse ai suggest <file>`. It inspects
+ * models, controllers, services, events, views, and relationships
+ * to identify missing patterns, incomplete definitions, and opportunities.
+ */
+export interface Suggestion {
+    severity: 'info' | 'warning' | 'improvement';
+    category: string;
+    target: string;
+    description: string;
+}
+/**
+ * Analyse a parsed AST and return actionable suggestions.
+ */
+export declare function analyseSpec(ast: any): Suggestion[];
+//# sourceMappingURL=spec-analyser.d.ts.map

package/dist/ai/commands/spec-analyser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-analyser.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/spec-analyser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,EAAE,CA4LlD"}

package/dist/ai/commands/spec-analyser.js

@@ -0,0 +1,175 @@
+/**
+ * Spec Analyser — analyses a parsed SpecVerse AST and suggests improvements.
+ *
+ * This is the engine behind `specverse ai suggest <file>`. It inspects
+ * models, controllers, services, events, views, and relationships
+ * to identify missing patterns, incomplete definitions, and opportunities.
+ */
+/**
+ * Analyse a parsed AST and return actionable suggestions.
+ */
+export function analyseSpec(ast) {
+    const suggestions = [];
+    const components = ast?.components || [];
+    for (const component of components) {
+        const models = component.models || [];
+        const controllers = component.controllers || [];
+        const services = component.services || [];
+        const events = component.events || [];
+        const views = component.views || [];
+        const modelNames = new Set(models.map((m) => m.name));
+        const controllerModels = new Set(controllers.map((c) => c.modelReference || c.model));
+        const viewModels = new Set(views.map((v) => v.primaryModel || v.model).filter(Boolean));
+        // --- Model analysis ---
+        for (const model of models) {
+            const attrs = model.attributes || [];
+            const rels = model.relationships || [];
+            const attrNames = new Set(attrs.map((a) => a.name));
+            const attrTypes = new Set(attrs.map((a) => a.type));
+            // No attributes at all
+            if (attrs.length === 0) {
+                suggestions.push({
+                    severity: 'warning',
+                    category: 'model',
+                    target: model.name,
+                    description: `Model has no attributes defined. Add at least an id and a name/title field.`
+                });
+            }
+            // Has email but no password (user-like model)
+            if (attrTypes.has('Email') && !attrNames.has('password') && !attrNames.has('passwordHash')) {
+                suggestions.push({
+                    severity: 'improvement',
+                    category: 'model',
+                    target: model.name,
+                    description: `Has Email attribute but no password/passwordHash field. If this is a user model, consider adding authentication fields.`
+                });
+            }
+            // No lifecycle on a model with status-like fields
+            const hasStatusField = attrs.some((a) => a.name === 'status' || a.name === 'state' || a.name === 'phase');
+            const hasLifecycle = model.lifecycles && model.lifecycles.length > 0;
+            if (hasStatusField && !hasLifecycle) {
+                suggestions.push({
+                    severity: 'improvement',
+                    category: 'model',
+                    target: model.name,
+                    description: `Has a status/state field but no lifecycle defined. Add a lifecycle to define valid state transitions.`
+                });
+            }
+            // No timestamps
+            const hasTimestamps = attrNames.has('createdAt') || attrNames.has('created_at') ||
+                attrNames.has('updatedAt') || attrNames.has('updated_at');
+            if (!hasTimestamps && attrs.length > 2) {
+                suggestions.push({
+                    severity: 'info',
+                    category: 'model',
+                    target: model.name,
+                    description: `No timestamp fields (createdAt/updatedAt). Consider adding audit fields for data tracking.`
+                });
+            }
+            // Relationship targets that don't exist as models
+            for (const rel of rels) {
+                const target = rel.target || rel.targetModel;
+                if (target && !modelNames.has(target)) {
+                    suggestions.push({
+                        severity: 'warning',
+                        category: 'relationship',
+                        target: `${model.name}.${rel.name}`,
+                        description: `References model "${target}" which is not defined in this component. Add the model or use an import.`
+                    });
+                }
+            }
+            // belongsTo without inverse hasMany
+            for (const rel of rels) {
+                if (rel.type === 'belongsTo') {
+                    const target = rel.target || rel.targetModel;
+                    const targetModel = models.find((m) => m.name === target);
+                    if (targetModel) {
+                        const inverseRels = (targetModel.relationships || []);
+                        const hasInverse = inverseRels.some((r) => (r.type === 'hasMany' || r.type === 'hasOne') &&
+                            (r.target === model.name || r.targetModel === model.name));
+                        if (!hasInverse) {
+                            suggestions.push({
+                                severity: 'info',
+                                category: 'relationship',
+                                target: `${model.name}.${rel.name}`,
+                                description: `belongsTo ${target}, but ${target} has no inverse hasMany/hasOne back to ${model.name}. Consider adding it for navigation.`
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // --- Controller coverage ---
+        for (const model of models) {
+            if (!controllerModels.has(model.name)) {
+                suggestions.push({
+                    severity: 'info',
+                    category: 'controller',
+                    target: model.name,
+                    description: `No controller defined. The inference engine will generate one, but explicit controllers give you more control over endpoints.`
+                });
+            }
+        }
+        // --- Event analysis ---
+        if (events.length === 0 && models.length > 2) {
+            suggestions.push({
+                severity: 'improvement',
+                category: 'events',
+                target: component.name,
+                description: `No events defined. Events enable cross-model communication and are auto-generated by inference, but explicit events let you define custom payloads.`
+            });
+        }
+        // Models with lifecycle but no corresponding events
+        for (const model of models) {
+            if (model.lifecycles && model.lifecycles.length > 0) {
+                const lifecycle = model.lifecycles[0];
+                const transitions = lifecycle.transitions || {};
+                const transitionNames = Object.keys(transitions);
+                if (transitionNames.length > 0) {
+                    const modelEvents = events.filter((e) => e.name.includes(model.name) || (e.attributes || []).some((a) => a.name.toLowerCase().includes(model.name.toLowerCase() + 'id')));
+                    if (modelEvents.length === 0) {
+                        suggestions.push({
+                            severity: 'improvement',
+                            category: 'events',
+                            target: model.name,
+                            description: `Has lifecycle transitions (${transitionNames.join(', ')}) but no associated events. Consider adding events like ${model.name}Created, ${model.name}StatusChanged.`
+                        });
+                    }
+                }
+            }
+        }
+        // --- View coverage ---
+        if (views.length === 0 && models.length > 0) {
+            suggestions.push({
+                severity: 'info',
+                category: 'views',
+                target: component.name,
+                description: `No views defined. The inference engine will generate CRUD views, but explicit views let you define dashboards, custom layouts, and specialist view types.`
+            });
+        }
+        for (const model of models) {
+            if (!viewModels.has(model.name) && views.length > 0) {
+                suggestions.push({
+                    severity: 'info',
+                    category: 'views',
+                    target: model.name,
+                    description: `Has no explicit view. Other models have views defined — consider adding one for consistency.`
+                });
+            }
+        }
+        // --- Service analysis ---
+        if (services.length === 0 && models.length > 3) {
+            suggestions.push({
+                severity: 'improvement',
+                category: 'services',
+                target: component.name,
+                description: `No services defined. Services encapsulate business logic beyond CRUD. With ${models.length} models, there's likely cross-model business logic worth making explicit.`
+            });
+        }
+    }
+    // Sort: warnings first, then improvements, then info
+    const severityOrder = { warning: 0, improvement: 1, info: 2 };
+    suggestions.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+    return suggestions;
+}
+//# sourceMappingURL=spec-analyser.js.map

package/dist/ai/commands/spec-analyser.js.map

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

package/dist/ai/commands/suggest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Action 3: Library Suggestions
+ * Generate library recommendations based on user requirements
+ */
+import type { UserRequirements, AILibraryContext, AICommandOptions } from '../types/index.js';
+export declare function suggestLibraries(requirements: UserRequirements, options?: AICommandOptions): Promise<AILibraryContext>;
+export default suggestLibraries;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/ai/commands/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/suggest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG9F,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,gBAAgB,EAC9B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAuD3B;AAiDD,eAAe,gBAAgB,CAAC"}

package/dist/ai/commands/suggest.js

@@ -0,0 +1,101 @@
+/**
+ * Action 3: Library Suggestions
+ * Generate library recommendations based on user requirements
+ */
+import { LibraryContextGenerator } from '../core/ecosystem-prompt-manager.js';
+export async function suggestLibraries(requirements, options = {}) {
+    try {
+        const libraryGenerator = new LibraryContextGenerator();
+        // Convert UserRequirements to ProjectContext format expected by LibraryContextGenerator
+        const projectContext = {
+            type: inferProjectType(requirements),
+            domain: requirements.domain || inferDomain(requirements),
+            scale: mapScale(requirements.scale || 'business'),
+            compliance: requirements.compliance,
+            technology_preferences: requirements.technology_preferences
+        };
+        const libraryContext = await libraryGenerator.generateLibraryContext(projectContext);
+        // Transform to our LibraryContext format
+        const suggestions = [
+            ...libraryContext.deployments.map(d => ({
+                type: 'deployment',
+                name: d.name,
+                description: d.ai_description || d.description,
+                rationale: d.ai_description || `Best for ${d.description}`,
+                expansion_factor: d.expansion_factor,
+                compliance: d.compliance
+            })),
+            ...libraryContext.domains.map(d => ({
+                type: 'domain',
+                name: d.name,
+                description: d.ai_description || d.description,
+                rationale: d.ai_description || `Provides ${d.description}`,
+                compliance: d.compliance
+            })),
+            ...libraryContext.manifests.map(m => ({
+                type: 'manifest',
+                name: m.name,
+                description: m.ai_description || m.description,
+                rationale: m.ai_description || `Integrates ${m.description}`,
+                compliance: m.compliance
+            })),
+            ...libraryContext.types.map(t => ({
+                type: 'types',
+                name: t.name,
+                description: t.ai_description || t.description,
+                rationale: t.ai_description || `Provides ${t.description}`
+            }))
+        ];
+        return {
+            suggestions,
+            total: suggestions.length,
+            reasoning: generateReasoning(requirements, suggestions)
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to generate library suggestions: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+function mapScale(scale) {
+    switch (scale) {
+        case 'personal': return 'small';
+        case 'business': return 'medium';
+        case 'enterprise': return 'enterprise';
+        default: return 'medium';
+    }
+}
+function inferProjectType(requirements) {
+    const req = requirements.requirements.toLowerCase();
+    if (req.includes('ecommerce') || req.includes('store') || req.includes('shop')) {
+        return 'ecommerce-store';
+    }
+    if (req.includes('blog') || req.includes('content') || req.includes('cms')) {
+        return 'content-site';
+    }
+    if (req.includes('healthcare') || req.includes('medical') || req.includes('patient')) {
+        return 'healthcare-management';
+    }
+    if (req.includes('business') || req.includes('enterprise') || req.includes('corporate')) {
+        return 'business-application';
+    }
+    return 'general-application';
+}
+function inferDomain(requirements) {
+    const req = requirements.requirements.toLowerCase();
+    if (req.includes('ecommerce') || req.includes('store'))
+        return 'ecommerce';
+    if (req.includes('healthcare') || req.includes('medical'))
+        return 'healthcare';
+    if (req.includes('business') || req.includes('enterprise'))
+        return 'business';
+    return 'general';
+}
+function generateReasoning(requirements, suggestions) {
+    const projectType = inferProjectType(requirements);
+    const scale = requirements.scale || 'business';
+    return `Based on your requirements for "${requirements.requirements}", ` +
+        `I've identified this as a ${projectType} at ${scale} scale. ` +
+        `The ${suggestions.length} suggested libraries will provide proven patterns and reduce development time significantly.`;
+}
+export default suggestLibraries;
+//# sourceMappingURL=suggest.js.map

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

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

package/dist/ai/commands/template.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Action 1: Template Retrieval
+ * Get raw prompt template for specified operation
+ */
+import type { AIOperation, PromptTemplate, AICommandOptions } from '../types/index.js';
+export declare function getTemplate(operation: AIOperation, options?: AICommandOptions): Promise<PromptTemplate>;
+export default getTemplate;
+//# sourceMappingURL=template.d.ts.map

package/dist/ai/commands/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGvF,wBAAsB,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyHjH;AAED,eAAe,WAAW,CAAC"}