@africode/core 5.0.0

package/core/cli/commands/lint.js

@@ -0,0 +1,23 @@
+import { spawnSync } from 'child_process';
+
+export async function lint() {
+    console.log('\n🌍 AfriCode Code Quality Pipeline');
+    console.log('Running ESLint analysis...\n');
+    
+    try {
+        const result = spawnSync('bunx', ['eslint', '.', '--ext', '.js,.jsx,.ts,.tsx'], {
+            stdio: 'inherit',
+            cwd: process.cwd(),
+            shell: true
+        });
+        
+        if (result.status === 0) {
+            console.log('\n✅ Code quality checks passed.');
+        } else {
+            console.error('\n❌ Code quality checks failed. Please review the errors above.');
+            process.exit(1);
+        }
+    } catch (err) {
+        console.error('Failed to start ESLint:', err);
+    }
+}

package/core/cli/commands/test.js

@@ -0,0 +1,34 @@
+import { spawnSync } from 'child_process';
+import { resolve } from 'path';
+
+export async function test() {
+    console.log('\n🌍 AfriCode Testing Suite');
+    console.log('Running Bun test runner with happy-dom environment...\n');
+
+    // Parse incoming CLI arguments to allow 'africode test --watch'
+    const userArgs = process.argv.slice(3); // slice out node, africode.js, test
+    
+    // We execute 'bun test', but since AfriCode components rely on DOM,
+    // we ensure the user has --preload if it exists, or suggest it.
+    // In a user project context, the test script in package.json will run it.
+    
+    // We just wrap the user's `bun test` context.
+    const args = ['test', ...userArgs];
+
+    try {
+        const result = spawnSync('bun', args, {
+            stdio: 'inherit',
+            cwd: process.cwd(),
+            shell: true
+        });
+        
+        if (result.status === 0) {
+            console.log('\n✅ All tests passed.');
+        } else {
+            console.error('\n❌ Tests failed.');
+            process.exit(1);
+        }
+    } catch (err) {
+        console.error('Failed to start test suite:', err);
+    }
+}

package/core/cli/migrator.js

@@ -0,0 +1,71 @@
+/**
+ * AfriCode Migration Engine
+ * 
+ * Scans `migrations/` folder for .sql files and executes them.
+ * Tracks applied migrations in `_migrations` table.
+ */
+
+import { Database } from "bun:sqlite";
+import fs from "fs";
+import path from "path";
+
+export async function runMigrations() {
+    console.log("▶ Starting Database Migrations...");
+
+    // Connect to DB (or create)
+    const db = new Database("africode.sqlite");
+
+    // 1. Create Migration Table
+    db.run(`
+      CREATE TABLE IF NOT EXISTS _migrations (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT UNIQUE,
+        applied_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+    `);
+
+    // 2. Scan Directory
+    const migrationDir = path.join(process.cwd(), "migrations");
+    if (!fs.existsSync(migrationDir)) {
+        console.log("⚠ No `migrations` directory found. Skipping.");
+        return;
+    }
+
+    const files = fs.readdirSync(migrationDir)
+        .filter(f => f.endsWith('.sql'))
+        .sort(); // Run in order (001_..., 002_...)
+
+    let appliedCount = 0;
+
+    for (const file of files) {
+        // Check if applied
+        const exists = db.query("SELECT id FROM _migrations WHERE name = ?").get(file);
+        if (exists) {
+            continue; // Skip
+        }
+
+        // Execute
+        console.log(`... Applying: ${file}`);
+        const sql = fs.readFileSync(path.join(migrationDir, file), "utf-8");
+
+        try {
+            // Run transaction
+            const transaction = db.transaction(() => {
+                db.run(sql);
+                db.run("INSERT INTO _migrations (name) VALUES (?)", [file]);
+            });
+            transaction();
+            console.log(`✓ Applied: ${file}`);
+            appliedCount++;
+        } catch (err) {
+            console.error(`✗ Failed to apply ${file}:`, err.message);
+            process.exit(1); // Stop on error
+        }
+    }
+
+    if (appliedCount === 0) {
+        console.log("✓ Database is up to date.");
+    } else {
+        console.log(`✓ Successfully applied ${appliedCount} migrations.`);
+    }
+}

package/core/cli/ui.js

@@ -0,0 +1,46 @@
+/**
+ * AfriCode CLI UI Utilities
+ */
+
+export const colors = {
+    green: '\x1b[32m',
+    gold: '\x1b[33m',
+    blue: '\x1b[34m',
+    red: '\x1b[31m',
+    reset: '\x1b[0m',
+    bold: '\x1b[1m'
+};
+
+export function logo() {
+    console.log(`
+${colors.gold}╔═══════════════════════════════════════╗
+║                                       ║
+║   ${colors.green}█████╗ ███████╗██████╗ ██╗${colors.gold}          ║
+║   ${colors.green}██╔══██╗██╔════╝██╔══██╗██║${colors.gold}          ║
+║   ${colors.green}███████║█████╗  ██████╔╝██║${colors.gold}          ║
+║   ${colors.green}██╔══██║██╔══╝  ██╔══██╗██║${colors.gold}          ║
+║   ${colors.green}██║  ██║██║     ██║  ██║██║${colors.gold}          ║
+║   ${colors.green}╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝╚═╝${colors.gold}          ║
+║                                       ║
+║   ${colors.reset}The Rhythmic Web Framework${colors.gold}          ║
+╚═══════════════════════════════════════╝${colors.reset}
+  `);
+}
+
+export function help() {
+    logo();
+    console.log(`
+${colors.bold}Usage:${colors.reset}
+  africode <command> [options]
+
+${colors.bold}Commands:${colors.reset}
+  ${colors.green}dev${colors.reset}       Start development server
+  ${colors.green}build${colors.reset}     Create production build
+  ${colors.green}add${colors.reset}       Add a component (e.g., africode add sidebar)
+  ${colors.green}new${colors.reset}       Create a new project (options: --template 3d)
+  ${colors.green}migrate${colors.reset}   Run database migrations
+  ${colors.green}help${colors.reset}      Show this help message
+
+${colors.gold}Powered by the rhythm of the continent.${colors.reset}
+  `);
+}