@specverse/engines 6.0.13 → 6.0.14

package/dist/libs/instance-factories/cli/templates/commander/command-generator.js

@@ -1145,6 +1145,158 @@ import type { ParserEngine } from '@specverse/types';`,
           process.exit(1);
         }`
   },
+  "ai.analyse": {
+    imports: `import { resolve, basename } from 'path';
+import { existsSync, mkdirSync, cpSync, statSync, readdirSync } from 'fs';`,
+    handler: `// Resolve the absolute source dir.
+        const userCwd = process.env.SPECVERSE_USER_CWD || process.cwd();
+        const sourceAbs = resolve(userCwd, source);
+        if (!existsSync(sourceAbs)) {
+          console.error('Source dir not found: ' + sourceAbs);
+          process.exit(1);
+        }
+
+        // Default output: ./runs/analyse/<basename>/<date>_<label>/
+        const { runAnalyse, buildRunFolder, caseRunPath, ensureSubdirs, inputDir, resolveProviderId } = await import('@specverse/engines/ai');
+        const providerId = resolveProviderId();
+        const modelId = process.env.SPECVERSE_AI_MODEL || 'default';
+        const runFolder = buildRunFolder({
+          prompt: 'analyse-v9',
+          providerId,
+          modelId,
+          label: options.label,
+        });
+        const outputDir = options.output
+          ? resolve(userCwd, options.output)
+          : caseRunPath(userCwd, 'analyse', basename(sourceAbs), runFolder);
+        ensureSubdirs(outputDir);
+
+        // Copy source into outputDir/input/ (excluding noisy indices) so the
+        // run dir is self-contained.
+        const inDir = inputDir(outputDir);
+        const stat = statSync(sourceAbs);
+        if (stat.isDirectory()) {
+          if (existsSync(inDir)) {
+            // Replace the empty stub from ensureSubdirs with the real copy.
+            try { cpSync(sourceAbs, inDir, { recursive: true, force: true }); }
+            catch (err: any) {
+              console.error('Failed to copy source into input/: ' + err.message);
+              process.exit(1);
+            }
+            // Strip noise.
+            for (const noise of ['.gitnexus', 'node_modules', '.DS_Store']) {
+              const p = resolve(inDir, noise);
+              try { if (existsSync(p)) require('fs').rmSync(p, { recursive: true, force: true }); } catch {}
+            }
+          }
+        } else {
+          // Single-file source \u2014 copy it into input/ as-is.
+          mkdirSync(inDir, { recursive: true });
+          cpSync(sourceAbs, resolve(inDir, basename(sourceAbs)));
+        }
+
+        console.log('  source:  ' + sourceAbs);
+        console.log('  output:  ' + outputDir);
+        console.log('  provider: ' + providerId);
+        if (options.facts) console.log('  facts:    ' + options.facts);
+        if (options.autoFacts) console.log('  facts:    auto (runPrepass)');
+        if (options.verify) console.log('  verify:   enabled');
+        if (options.realize) console.log('  realize:  enabled');
+
+        try {
+          const result = await runAnalyse({
+            sourceDir: inDir,
+            outputDir,
+            factsPath: options.facts ? resolve(userCwd, options.facts) : undefined,
+            autoFacts: !!options.autoFacts,
+            verify: !!options.verify,
+            realize: !!options.realize,
+            prompt: 'analyse-v9',
+            providerId,
+            modelId,
+            caseName: basename(sourceAbs),
+          });
+          console.log('');
+          console.log('\u2705 Analyse complete');
+          console.log('   Final spec: ' + result.finalSpecPath);
+          console.log('   Validate:   ' + (result.validateFinal.ok ? '\u2713 pass' : '\u2717 ' + result.validateFinal.errors.slice(0, 100)));
+          if (result.realize) {
+            console.log('   Realize:    ' + (result.realize.ok ? '\u2713 project/ materialized' : '\u2717 ' + result.realize.error));
+          }
+          console.log('   README:     ' + outputDir + '/README.md');
+        } catch (err: any) {
+          console.error('Analyse failed: ' + (err?.message || err));
+          process.exit(1);
+        }`
+  },
+  "ai.create": {
+    imports: `import { resolve, basename } from 'path';
+import { existsSync, readFileSync } from 'fs';`,
+    handler: `const userCwd = process.env.SPECVERSE_USER_CWD || process.cwd();
+        // Resolve requirements: positional arg, or read from --file.
+        let reqText = requirements;
+        if (options.file) {
+          const fp = resolve(userCwd, options.file);
+          if (!existsSync(fp)) {
+            console.error('Requirements file not found: ' + fp);
+            process.exit(1);
+          }
+          reqText = readFileSync(fp, 'utf8');
+        }
+        if (!reqText || !reqText.trim()) {
+          console.error('No requirements provided. Pass them as a positional argument or via --file.');
+          process.exit(1);
+        }
+
+        const { runCreate, buildRunFolder, caseRunPath, ensureSubdirs, resolveProviderId } = await import('@specverse/engines/ai');
+        const providerId = resolveProviderId();
+        const modelId = process.env.SPECVERSE_AI_MODEL || 'default';
+        const runFolder = buildRunFolder({
+          prompt: 'create-v9',
+          providerId,
+          modelId,
+          label: options.label,
+        });
+        // Default output: ./runs/create/<short-slug>/<date>_<label>/
+        const slug = (options.name || 'spec').toLowerCase().replace(/[^a-z0-9-]+/g, '-').slice(0, 40) || 'spec';
+        const outputDir = options.output
+          ? resolve(userCwd, options.output)
+          : caseRunPath(userCwd, 'create', slug, runFolder);
+        ensureSubdirs(outputDir);
+
+        console.log('  output:   ' + outputDir);
+        console.log('  provider: ' + providerId);
+        if (options.scale) console.log('  scale:    ' + options.scale);
+        if (options.preferredTech) console.log('  tech:     ' + options.preferredTech);
+        if (options.verify) console.log('  verify:   enabled');
+        if (options.realize) console.log('  realize:  enabled');
+
+        try {
+          const result = await runCreate({
+            requirements: reqText,
+            scale: options.scale,
+            preferredTech: options.preferredTech,
+            outputDir,
+            verify: !!options.verify,
+            realize: !!options.realize,
+            prompt: 'create-v9',
+            providerId,
+            modelId,
+            caseName: slug,
+          });
+          console.log('');
+          console.log('\u2705 Create complete');
+          console.log('   Final spec: ' + result.finalSpecPath);
+          console.log('   Validate:   ' + (result.validateFinal.ok ? '\u2713 pass' : '\u2717 ' + result.validateFinal.errors.slice(0, 100)));
+          if (result.realize) {
+            console.log('   Realize:    ' + (result.realize.ok ? '\u2713 project/ materialized' : '\u2717 ' + result.realize.error));
+          }
+          console.log('   README:     ' + outputDir + '/README.md');
+        } catch (err: any) {
+          console.error('Create failed: ' + (err?.message || err));
+          process.exit(1);
+        }`
+  },
   // === session subcommands ===
   "session.create": {
     imports: `import { EngineRegistry } from '@specverse/entities';`,

package/libs/instance-factories/cli/templates/commander/command-generator.ts

@@ -1200,6 +1200,158 @@ import type { ParserEngine } from '@specverse/types';`,
           process.exit(1);
         }`
   },
+  'ai.analyse': {
+    imports: `import { resolve, basename } from 'path';
+import { existsSync, mkdirSync, cpSync, statSync, readdirSync } from 'fs';`,
+    handler: `// Resolve the absolute source dir.
+        const userCwd = process.env.SPECVERSE_USER_CWD || process.cwd();
+        const sourceAbs = resolve(userCwd, source);
+        if (!existsSync(sourceAbs)) {
+          console.error('Source dir not found: ' + sourceAbs);
+          process.exit(1);
+        }
+
+        // Default output: ./runs/analyse/<basename>/<date>_<label>/
+        const { runAnalyse, buildRunFolder, caseRunPath, ensureSubdirs, inputDir, resolveProviderId } = await import('@specverse/engines/ai');
+        const providerId = resolveProviderId();
+        const modelId = process.env.SPECVERSE_AI_MODEL || 'default';
+        const runFolder = buildRunFolder({
+          prompt: 'analyse-v9',
+          providerId,
+          modelId,
+          label: options.label,
+        });
+        const outputDir = options.output
+          ? resolve(userCwd, options.output)
+          : caseRunPath(userCwd, 'analyse', basename(sourceAbs), runFolder);
+        ensureSubdirs(outputDir);
+
+        // Copy source into outputDir/input/ (excluding noisy indices) so the
+        // run dir is self-contained.
+        const inDir = inputDir(outputDir);
+        const stat = statSync(sourceAbs);
+        if (stat.isDirectory()) {
+          if (existsSync(inDir)) {
+            // Replace the empty stub from ensureSubdirs with the real copy.
+            try { cpSync(sourceAbs, inDir, { recursive: true, force: true }); }
+            catch (err: any) {
+              console.error('Failed to copy source into input/: ' + err.message);
+              process.exit(1);
+            }
+            // Strip noise.
+            for (const noise of ['.gitnexus', 'node_modules', '.DS_Store']) {
+              const p = resolve(inDir, noise);
+              try { if (existsSync(p)) require('fs').rmSync(p, { recursive: true, force: true }); } catch {}
+            }
+          }
+        } else {
+          // Single-file source — copy it into input/ as-is.
+          mkdirSync(inDir, { recursive: true });
+          cpSync(sourceAbs, resolve(inDir, basename(sourceAbs)));
+        }
+
+        console.log('  source:  ' + sourceAbs);
+        console.log('  output:  ' + outputDir);
+        console.log('  provider: ' + providerId);
+        if (options.facts) console.log('  facts:    ' + options.facts);
+        if (options.autoFacts) console.log('  facts:    auto (runPrepass)');
+        if (options.verify) console.log('  verify:   enabled');
+        if (options.realize) console.log('  realize:  enabled');
+
+        try {
+          const result = await runAnalyse({
+            sourceDir: inDir,
+            outputDir,
+            factsPath: options.facts ? resolve(userCwd, options.facts) : undefined,
+            autoFacts: !!options.autoFacts,
+            verify: !!options.verify,
+            realize: !!options.realize,
+            prompt: 'analyse-v9',
+            providerId,
+            modelId,
+            caseName: basename(sourceAbs),
+          });
+          console.log('');
+          console.log('✅ Analyse complete');
+          console.log('   Final spec: ' + result.finalSpecPath);
+          console.log('   Validate:   ' + (result.validateFinal.ok ? '✓ pass' : '✗ ' + result.validateFinal.errors.slice(0, 100)));
+          if (result.realize) {
+            console.log('   Realize:    ' + (result.realize.ok ? '✓ project/ materialized' : '✗ ' + result.realize.error));
+          }
+          console.log('   README:     ' + outputDir + '/README.md');
+        } catch (err: any) {
+          console.error('Analyse failed: ' + (err?.message || err));
+          process.exit(1);
+        }`
+  },
+  'ai.create': {
+    imports: `import { resolve, basename } from 'path';
+import { existsSync, readFileSync } from 'fs';`,
+    handler: `const userCwd = process.env.SPECVERSE_USER_CWD || process.cwd();
+        // Resolve requirements: positional arg, or read from --file.
+        let reqText = requirements;
+        if (options.file) {
+          const fp = resolve(userCwd, options.file);
+          if (!existsSync(fp)) {
+            console.error('Requirements file not found: ' + fp);
+            process.exit(1);
+          }
+          reqText = readFileSync(fp, 'utf8');
+        }
+        if (!reqText || !reqText.trim()) {
+          console.error('No requirements provided. Pass them as a positional argument or via --file.');
+          process.exit(1);
+        }
+
+        const { runCreate, buildRunFolder, caseRunPath, ensureSubdirs, resolveProviderId } = await import('@specverse/engines/ai');
+        const providerId = resolveProviderId();
+        const modelId = process.env.SPECVERSE_AI_MODEL || 'default';
+        const runFolder = buildRunFolder({
+          prompt: 'create-v9',
+          providerId,
+          modelId,
+          label: options.label,
+        });
+        // Default output: ./runs/create/<short-slug>/<date>_<label>/
+        const slug = (options.name || 'spec').toLowerCase().replace(/[^a-z0-9-]+/g, '-').slice(0, 40) || 'spec';
+        const outputDir = options.output
+          ? resolve(userCwd, options.output)
+          : caseRunPath(userCwd, 'create', slug, runFolder);
+        ensureSubdirs(outputDir);
+
+        console.log('  output:   ' + outputDir);
+        console.log('  provider: ' + providerId);
+        if (options.scale) console.log('  scale:    ' + options.scale);
+        if (options.preferredTech) console.log('  tech:     ' + options.preferredTech);
+        if (options.verify) console.log('  verify:   enabled');
+        if (options.realize) console.log('  realize:  enabled');
+
+        try {
+          const result = await runCreate({
+            requirements: reqText,
+            scale: options.scale,
+            preferredTech: options.preferredTech,
+            outputDir,
+            verify: !!options.verify,
+            realize: !!options.realize,
+            prompt: 'create-v9',
+            providerId,
+            modelId,
+            caseName: slug,
+          });
+          console.log('');
+          console.log('✅ Create complete');
+          console.log('   Final spec: ' + result.finalSpecPath);
+          console.log('   Validate:   ' + (result.validateFinal.ok ? '✓ pass' : '✗ ' + result.validateFinal.errors.slice(0, 100)));
+          if (result.realize) {
+            console.log('   Realize:    ' + (result.realize.ok ? '✓ project/ materialized' : '✗ ' + result.realize.error));
+          }
+          console.log('   README:     ' + outputDir + '/README.md');
+        } catch (err: any) {
+          console.error('Create failed: ' + (err?.message || err));
+          process.exit(1);
+        }`
+  },
   // === session subcommands ===
   'session.create': {
     imports: `import { EngineRegistry } from '@specverse/entities';`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specverse/engines",
-  "version": "6.0.13",
+  "version": "6.0.14",
   "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry, bundles",
   "type": "module",
   "main": "dist/index.js",