outlet-orm 6.5.0 → 7.0.0

package/bin/init.js

@@ -16,7 +16,129 @@ const rl = readline.createInterface({
 
 const question = (query) => new Promise((resolve) => rl.question(query, resolve));
 
+// ─── Parse CLI flags ─────────────────────────────────────────────
+
+function parseInitFlags(argv) {
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--prompt' || arg === '-P') {
+      flags.prompt = argv[++i];
+    } else if (arg === '--driver' || arg === '-d') {
+      flags.driver = argv[++i];
+    }
+  }
+  return flags;
+}
+
+// ─── Prompt-based init (v7.0.0) ─────────────────────────────────
+
+async function initFromPrompt(promptText, driverName) {
+  const PromptGenerator = require('../src/AI/PromptGenerator');
+
+  console.log('\n🤖 Outlet ORM — Prompt-based Initialization\n');
+  console.log(`  Prompt: "${promptText}"`);
+
+  const blueprint = PromptGenerator.parse(promptText);
+  console.log(`  Domain detected: ${blueprint.domain} (score: ${blueprint.score})`);
+  console.log(`  Tables: ${Object.keys(blueprint.tables).join(', ')}\n`);
+
+  // Determine the driver
+  const driver = driverName || 'sqlite';
+  const driverConfig = {
+    mysql:    { package: 'mysql2',  port: 3306 },
+    postgres: { package: 'pg',      port: 5432 },
+    sqlite:   { package: 'sqlite3', port: null }
+  };
+
+  if (!driverConfig[driver]) {
+    console.error(`❌ Unknown driver: ${driver}. Use mysql, postgres, or sqlite.`);
+    process.exit(1);
+  }
+
+  const cwd = process.cwd();
+
+  // Create directory structure
+  const directories = ['database/migrations', 'database/seeds', 'models', 'config'];
+  for (const dir of directories) {
+    const dirPath = path.join(cwd, dir);
+    if (!fs.existsSync(dirPath)) {
+      fs.mkdirSync(dirPath, { recursive: true });
+      console.log(`  📁 ${dir}/`);
+    }
+  }
+
+  // Generate database config
+  let config;
+  if (driver === 'sqlite') {
+    config = { driver: 'sqlite', database: './database.sqlite' };
+  } else {
+    config = {
+      driver,
+      host: 'localhost',
+      port: driverConfig[driver].port,
+      database: 'my_app',
+      user: 'root',
+      password: ''
+    };
+  }
+
+  const configContent = `const { DatabaseConnection } = require('outlet-orm');\n\nconst db = new DatabaseConnection(${JSON.stringify(config, null, 2)});\n\nmodule.exports = db;\n`;
+  const configPath = path.join(cwd, 'database', 'config.js');
+  if (!fs.existsSync(configPath)) {
+    fs.writeFileSync(configPath, configContent);
+    console.log('  ✅ database/config.js');
+  }
+
+  // Generate .env
+  const envPath = path.join(cwd, '.env');
+  if (!fs.existsSync(envPath)) {
+    const envLines = [`DB_DRIVER=${config.driver}`];
+    if (driver !== 'sqlite') {
+      envLines.push(`DB_HOST=${config.host}`, `DB_PORT=${config.port}`, `DB_USER=${config.user}`, `DB_PASSWORD=${config.password}`, `DB_DATABASE=${config.database}`);
+    } else {
+      envLines.push(`DB_FILE=${config.database}`);
+    }
+    fs.writeFileSync(envPath, envLines.join('\n') + '\n');
+    console.log('  ✅ .env');
+  }
+
+  // Generate models
+  console.log('\n📊 Generating models...');
+  const modelFiles = PromptGenerator.generateModels(blueprint, path.join(cwd, 'models'));
+  for (const f of modelFiles) {
+    console.log(`  ✅ ${path.relative(cwd, f)}`);
+  }
+
+  // Generate migrations
+  console.log('\n📦 Generating migrations...');
+  const migrationFiles = PromptGenerator.generateMigrations(blueprint, path.join(cwd, 'database', 'migrations'));
+  for (const f of migrationFiles) {
+    console.log(`  ✅ ${path.relative(cwd, f)}`);
+  }
+
+  // Generate seeder
+  console.log('\n🌱 Generating seeder...');
+  const seederFile = PromptGenerator.generateSeeder(blueprint, path.join(cwd, 'database', 'seeds'));
+  console.log(`  ✅ ${path.relative(cwd, seederFile)}`);
+
+  console.log('\n✨ Project generated from prompt!\n');
+  console.log('Next steps:');
+  console.log('  1. Review generated models in models/');
+  console.log('  2. Review migrations in database/migrations/');
+  console.log('  3. Run migrations: outlet-migrate migrate');
+  console.log(`  4. Install driver: npm install ${driverConfig[driver].package}`);
+}
+
 async function init() {
+  // Check for --prompt flag
+  const flags = parseInitFlags(process.argv.slice(2));
+  if (flags.prompt) {
+    await initFromPrompt(flags.prompt, flags.driver);
+    rl.close();
+    return;
+  }
+
   console.log('\n🚀 Bienvenue dans l\'assistant de configuration Outlet ORM!\n');
 
   try {

package/bin/mcp.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+/**
+ * outlet-mcp — MCP Server CLI entry point
+ * Starts the Outlet ORM MCP server on stdio for AI agent integration.
+ *
+ * Usage:
+ *   npx outlet-mcp                  # Start the MCP server
+ *   npx outlet-mcp --project /path  # Start with custom project directory
+ *   npx outlet-mcp --no-safety      # Disable AI safety guardrails
+ *
+ * @since 7.0.0
+ */
+
+const MCPServer = require('../src/AI/MCPServer');
+
+// ─── Parse CLI flags ─────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const options = {};
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+  if (arg === '--project' || arg === '-p') {
+    options.projectDir = args[++i];
+  } else if (arg === '--no-safety') {
+    options.safetyGuardrails = false;
+  } else if (arg === '--help' || arg === '-h') {
+    console.error(`
+outlet-mcp — Outlet ORM MCP Server
+
+Usage:
+  outlet-mcp [options]
+
+Options:
+  --project, -p <path>  Project root directory (default: cwd)
+  --no-safety           Disable AI safety guardrails
+  --help, -h            Show this help message
+
+The server communicates over stdio using the Model Context Protocol (MCP).
+It exposes tools for migrations, schema introspection, queries, seeds, and backups.
+
+Documentation: https://github.com/omgbwa-yasse/outlet-orm/blob/main/docs/MCP.md
+`);
+    process.exit(0);
+  }
+}
+
+// ─── Start ───────────────────────────────────────────────────────
+
+const server = new MCPServer(options);
+
+server.on('started', () => {
+  process.stderr.write('[outlet-mcp] MCP server started on stdio\n');
+});
+
+server.on('initialized', () => {
+  process.stderr.write('[outlet-mcp] Client connected and initialized\n');
+});
+
+server.on('close', async () => {
+  process.stderr.write('[outlet-mcp] Shutting down...\n');
+  await server.close();
+  process.exit(0);
+});
+
+// Graceful shutdown
+process.on('SIGINT', async () => {
+  await server.close();
+  process.exit(0);
+});
+
+process.on('SIGTERM', async () => {
+  await server.close();
+  process.exit(0);
+});
+
+server.start();

package/bin/migrate.js

@@ -8,6 +8,7 @@
 const readline = require('readline');
 const fs = require('fs').promises;
 const path = require('path');
+const AISafetyGuardrails = require('../src/AI/AISafetyGuardrails');
 
 const rl = readline.createInterface({
   input: process.stdin,
@@ -367,6 +368,14 @@ async function runNonInteractive(cmd, flags) {
     }
 
     case 'reset': {
+      // AI Safety Guardrails check (v7.0.0)
+      if (AISafetyGuardrails.isDestructiveCommand('reset')) {
+        const check = AISafetyGuardrails.validateDestructiveAction('reset', flags);
+        if (!check.allowed) {
+          console.error(check.message);
+          return;
+        }
+      }
       if (flags.yes || flags.force) {
         await manager.reset();
       } else {
@@ -376,6 +385,14 @@ async function runNonInteractive(cmd, flags) {
     }
 
     case 'refresh': {
+      // AI Safety Guardrails check (v7.0.0)
+      if (AISafetyGuardrails.isDestructiveCommand('fresh')) {
+        const check = AISafetyGuardrails.validateDestructiveAction('refresh', flags);
+        if (!check.allowed) {
+          console.error(check.message);
+          return;
+        }
+      }
       if (flags.yes || flags.force) {
         await manager.refresh();
       } else {
@@ -385,6 +402,14 @@ async function runNonInteractive(cmd, flags) {
     }
 
     case 'fresh': {
+      // AI Safety Guardrails check (v7.0.0)
+      if (AISafetyGuardrails.isDestructiveCommand('fresh')) {
+        const check = AISafetyGuardrails.validateDestructiveAction('fresh', flags);
+        if (!check.allowed) {
+          console.error(check.message);
+          return;
+        }
+      }
       if (flags.yes || flags.force) {
         await manager.fresh();
       } else {