ebade 0.4.5 → 0.4.7

package/cli/utils.js

@@ -0,0 +1,98 @@
+import fs from "fs";
+
+export function toPascalCase(str) {
+  return str
+    .split(/[-_]/)
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join("");
+}
+
+export function toSnakeCase(str) {
+  return str
+    .replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)
+    .replace(/-/g, "_")
+    .toLowerCase()
+    .replace(/^_/, "");
+}
+
+export function hexToHsl(hex) {
+  let r = 0,
+    g = 0,
+    b = 0;
+  if (hex.length === 4) {
+    r = parseInt(hex[1] + hex[1], 16);
+    g = parseInt(hex[2] + hex[2], 16);
+    b = parseInt(hex[3] + hex[3], 16);
+  } else if (hex.length === 7) {
+    r = parseInt(hex.slice(1, 3), 16);
+    g = parseInt(hex.slice(3, 5), 16);
+    b = parseInt(hex.slice(5, 7), 16);
+  }
+  r /= 255;
+  g /= 255;
+  b /= 255;
+  let max = Math.max(r, g, b),
+    min = Math.min(r, g, b);
+  let h,
+    s,
+    l = (max + min) / 2;
+  if (max === min) h = s = 0;
+  else {
+    let d = max - min;
+    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    switch (max) {
+      case r:
+        h = (g - b) / d + (g < b ? 6 : 0);
+        break;
+      case g:
+        h = (b - r) / d + 2;
+        break;
+      case b:
+        h = (r - g) / d + 4;
+        break;
+    }
+    h /= 6;
+  }
+  return `${Math.round(h * 360)} ${Math.round(s * 100)}% ${Math.round(
+    l * 100
+  )}%`;
+}
+
+export function mapToSqlType(type) {
+  const typeMap = {
+    uuid: "UUID PRIMARY KEY DEFAULT gen_random_uuid()",
+    string: "VARCHAR(255)",
+    text: "TEXT",
+    integer: "INTEGER",
+    decimal: "DECIMAL(10,2)",
+    boolean: "BOOLEAN",
+    timestamp: "TIMESTAMP WITH TIME ZONE DEFAULT NOW()",
+    json: "JSONB",
+    array: "JSONB",
+    enum: "VARCHAR(50)",
+  };
+  return typeMap[type] || "VARCHAR(255)";
+}
+
+export function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+import { execSync } from "child_process";
+
+export function formatProject(projectDir) {
+  try {
+    // Try to use local prettier if it exists, otherwise npx
+    execSync(
+      `npx prettier --write "${projectDir}/**/*.{ts,tsx,js,jsx,html,css,json,yaml,md}" --ignore-path .gitignore`,
+      {
+        stdio: "ignore",
+      }
+    );
+    return true;
+  } catch (e) {
+    return false;
+  }
+}

package/docs/GREEN-AI.md

@@ -41,11 +41,11 @@ Based on our benchmarks, switching to **ebade** for AI agent workflows saves:
 
 ## 🧠 The Efficiency Philosophy
 
-Traditional frameworks are human-centric. They require the AI to write huge amounts of "how" code (boilerplate, imports, setup). **ebade** is agent-centric. It only needs the "what" (intent).
+Traditional frameworks are human-centric. They require the AI to write huge amounts of "how" code (boilerplate, imports, setup). **ebade** uses a hybrid approach to eliminate this waste.
 
 ```text
-Human-Centric (Next.js): AI writes IMPLEMENTATION → Bloated Context → High Carbon
-Agent-Centric  (ebade):   AI writes ESSENCE (ebade) → Lean Context → Low Carbon
+1. Offline Architect (Local):  0 Tokens  → Handles all boilerplate & structure.
+2. Online Engineer (Agent):    Low Tokens → Handles only specific business logic.
 ```
 
 **Same result. Fraction of the energy.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ebade",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "ebade - Agent-First Framework. The first framework designed for AI agents, readable by humans.",
   "type": "module",
   "main": "cli/scaffold.js",
@@ -42,5 +42,8 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "prettier": "^3.7.4"
   }
 }

package/packages/mcp-server/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ebade-mcp-server",
-  "version": "0.4.5",
-  "description": "MCP Server for ebade v0.4.4 - The Agent-First Framework",
+  "version": "0.4.7",
+  "description": "MCP Server for ebade v0.4.7 - The Agent-First Framework",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/packages/mcp-server/src/index.ts

@@ -9,6 +9,7 @@
  * - Validate ebade files
  * - Compile ebade to framework-specific code
  * - Generate components from natural language descriptions
+ * - Build entire projects from natural language prompts (NEW in v0.4.7)
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -24,12 +25,13 @@ import { scaffoldProject } from "./tools/scaffold.js";
 import { validateIntent } from "./tools/validate.js";
 import { compileIntent } from "./tools/compile.js";
 import { generateComponent } from "./tools/generate.js";
+import { buildFromPrompt } from "./tools/build.js";
 
 // Create the MCP server
 const server = new Server(
   {
     name: "ebade",
-    version: "0.3.1",
+    version: "0.4.7",
   },
   {
     capabilities: {
@@ -183,6 +185,33 @@ Use this when:
           required: ["description"],
         },
       },
+      {
+        name: "ebade_build",
+        description: `Revolutionary "Prompt-to-Product" tool. 
+Generates a complete, production-ready project from a single natural language description.
+
+Use this when the user says:
+- "Bana mor temalı bir kripto borsası yap"
+- "Create a red themed SaaS for AI model store"
+- "Make a sleek portfolio for a creative director"
+
+This tool handles architecture, component selection, color palette, and scaffolding in one shot.`,
+        inputSchema: {
+          type: "object",
+          properties: {
+            prompt: {
+              type: "string",
+              description: "The natural language instruction for the project",
+            },
+            outputDir: {
+              type: "string",
+              description:
+                "Base directory path where the project will be created (absolute)",
+            },
+          },
+          required: ["prompt", "outputDir"],
+        },
+      },
     ],
   };
 });
@@ -229,6 +258,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           style: args?.style as any,
         });
 
+      case "ebade_build":
+        return {
+          content: [
+            {
+              type: "text",
+              text: await buildFromPrompt(args as any),
+            },
+          ],
+        };
+
       default:
         throw new Error(`Unknown tool: ${name}`);
     }
@@ -278,7 +317,7 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
   const { uri } = request.params;
 
   const resources: Record<string, string> = {
-    "ebade://syntax": `# ebade Syntax Reference\\n\\n@page, @ebade, @requires, @outcomes, @data, @validate, @style, @compose, @on, @expects\\n\\nCode = f(ebade)`,
+    "ebade://syntax": `# ebade Syntax Reference\n\n@page, @ebade, @requires, @outcomes, @data, @validate, @style, @compose, @on, @expects\n\nCode = f(ebade)`,
     "ebade://examples/ecommerce": `# E-commerce ebade\nname: my-store\ntype: e-commerce\nfeatures:\n  - product-catalog\n  - shopping-cart\n  - checkout`,
     "ebade://examples/saas": `# SaaS ebade\nname: my-saas\ntype: saas-dashboard\nfeatures:\n  - user-auth\n  - billing\n  - analytics`,
   };

package/packages/mcp-server/src/tools/build.ts

@@ -0,0 +1,57 @@
+import { execSync } from "child_process";
+import path from "path";
+import fs from "fs";
+
+interface BuildArgs {
+  prompt: string;
+  outputDir: string;
+}
+
+export async function buildFromPrompt(args: BuildArgs): Promise<string> {
+  const { prompt, outputDir } = args;
+
+  try {
+    // Find the CLI script path
+    // Assuming we are in packages/mcp-server/dist/tools/ (at runtime)
+    // or packages/mcp-server/src/tools/ (at dev time)
+    const cliPath = path.resolve(process.cwd(), "../../cli/scaffold.js");
+
+    if (!fs.existsSync(cliPath)) {
+      throw new Error(`CLI not found at ${cliPath}`);
+    }
+
+    console.log(`🚀 Executing ebade build from prompt: "${prompt}"`);
+
+    // Execute the CLI command
+    // We pass the prompt as an argument.
+    // We need to handle the outputDir carefully.
+    // The CLI build command currently uses its own naming logic,
+    // but it creates the folder in the current process.cwd().
+
+    const cmd = `node "${cliPath}" build "${prompt}"`;
+
+    // Run in the specified outputDir if provided
+    const result = execSync(cmd, {
+      cwd: outputDir,
+      encoding: "utf-8",
+      env: { ...process.env, NODE_ENV: "production" },
+    });
+
+    return `✅ ebade v0.4.7 Build Complete!
+    
+Prompt: "${prompt}"
+Output: ${outputDir}
+
+CLI Output:
+${result}
+
+Next Steps:
+1. Navigate to the generated folder.
+2. Run 'npm install && npm run dev'.
+3. Enjoy your turnkey project!`;
+  } catch (error) {
+    throw new Error(
+      `Build failed: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}

package/tests/cli/build.test.js

@@ -0,0 +1,66 @@
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import assert from "assert";
+
+async function runCliTests() {
+  console.log("🧪 Running CLI Integration Tests...\n");
+
+  const PROJECT_NAME = "ModernBlog";
+  if (fs.existsSync(PROJECT_NAME)) {
+    fs.rmSync(PROJECT_NAME, { recursive: true, force: true });
+  }
+
+  try {
+    // 1. Test 'ebade build' command
+    console.log(`Testing 'ebade build' command for ${PROJECT_NAME}...`);
+    const cmd = `node cli/scaffold.js build "A Modern Blog with blue theme"`;
+
+    execSync(cmd, { stdio: "inherit" });
+
+    const projectDir = path.join(process.cwd(), PROJECT_NAME);
+
+    assert.ok(
+      fs.existsSync(projectDir),
+      `Project directory (${PROJECT_NAME}) should exist`
+    );
+    assert.ok(
+      fs.existsSync(path.join(projectDir, "project.ebade.yaml")),
+      "project.ebade.yaml should be generated"
+    );
+    assert.ok(
+      fs.existsSync(path.join(projectDir, "app/page.tsx")),
+      "Main page should be generated"
+    );
+    assert.ok(
+      fs.existsSync(path.join(projectDir, ".env.example")),
+      ".env.example should be generated"
+    );
+    assert.ok(
+      fs.existsSync(path.join(projectDir, ".gitignore")),
+      ".gitignore should be generated"
+    );
+
+    // Verify blog pages
+    assert.ok(
+      fs.existsSync(path.join(projectDir, "app/posts/page.tsx")),
+      "Blog index page should be generated"
+    );
+
+    console.log("✅ 'ebade build' Integration OK");
+  } catch (err) {
+    console.error("\n❌ CLI Test failed:");
+    console.error(err);
+    process.exit(1);
+  } finally {
+    // Cleanup
+    console.log("\n🧹 Cleaning up test artifacts...");
+    if (fs.existsSync(PROJECT_NAME)) {
+      fs.rmSync(PROJECT_NAME, { recursive: true, force: true });
+    }
+  }
+
+  console.log("\n✨ CLI integration tests passed!");
+}
+
+runCliTests();

package/tests/cli/multi-target.test.js

@@ -0,0 +1,60 @@
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import assert from "assert";
+
+async function runMultiTargetTests() {
+  console.log("🧪 Running Multi-Target TDD Tests...\n");
+
+  const PROJECT_NAME = "SimpleStatic";
+  if (fs.existsSync(PROJECT_NAME)) {
+    fs.rmSync(PROJECT_NAME, { recursive: true, force: true });
+  }
+
+  try {
+    // 1. Test 'ebade build' with --target html
+    console.log(`Testing '--target html' for ${PROJECT_NAME}...`);
+    // Note: This will fail initially because --target flag and adapter aren't implemented yet.
+    // This is the 'RED' phase of TDD.
+    const cmd = `node cli/scaffold.js build "A simple static site" --target html`;
+
+    execSync(cmd, { stdio: "inherit" });
+
+    const projectDir = path.join(process.cwd(), PROJECT_NAME);
+
+    assert.ok(
+      fs.existsSync(projectDir),
+      `Project directory (${PROJECT_NAME}) should exist`
+    );
+
+    // Vanilla HTML expected files
+    assert.ok(
+      fs.existsSync(path.join(projectDir, "index.html")),
+      "index.html should be generated for HTML target"
+    );
+    assert.ok(
+      fs.existsSync(path.join(projectDir, "styles.css")),
+      "styles.css should be generated for HTML target"
+    );
+
+    // Ensure Next.js files are NOT generated
+    assert.ok(
+      !fs.existsSync(path.join(projectDir, "app/page.tsx")),
+      "Next.js app directory should NOT exist for HTML target"
+    );
+
+    console.log("✅ Multi-Target TDD Test OK");
+  } catch (err) {
+    console.log("\n❌ TDD Test failed (Expected if not implemented yet):");
+    console.error(err.message);
+    // In TDD 'Red' phase, we don't necessarily exit(1) if we expect failure,
+    // but here we want to see it fail.
+  } finally {
+    // Cleanup
+    if (fs.existsSync(PROJECT_NAME)) {
+      fs.rmSync(PROJECT_NAME, { recursive: true, force: true });
+    }
+  }
+}
+
+runMultiTargetTests();

package/tests/framework/architect.test.js

@@ -0,0 +1,102 @@
+import {
+  EbadeArchitect,
+  toPascalCase,
+  toSnakeCase,
+  hexToHsl,
+} from "../../cli/scaffold.js";
+import assert from "assert";
+
+async function runTests() {
+  console.log("🧪 Running Framework Unit Tests (v0.4.7)...\n");
+
+  // 1. Utility Functions
+  console.log("Testing Utility Functions...");
+  assert.strictEqual(toPascalCase("hello-world"), "HelloWorld");
+  assert.strictEqual(toPascalCase("hello_world"), "HelloWorld");
+  assert.strictEqual(toSnakeCase("HelloWorld"), "hello_world");
+  assert.strictEqual(toSnakeCase("hello-world"), "hello_world");
+
+  // hexToHsl Test (Critical for Design System)
+  const hsl = hexToHsl("#8b5cf6"); // Violet
+  assert.ok(
+    hsl.includes("258"),
+    `HSL for #8b5cf6 should include hue 258, got ${hsl}`
+  );
+  console.log("✅ Utilities OK");
+
+  // 2. Architect Mapping
+  console.log("\nTesting EbadeArchitect (Complex Intent)...");
+  const prompt =
+    "Can you make a luxury gold themed dashboard with charts and login features?";
+  const config = await EbadeArchitect.plan(prompt);
+
+  // Check intelligence
+  assert.strictEqual(
+    config.name,
+    "LuxuryGold",
+    "Should filter filler words like 'Can you make a'"
+  );
+  assert.strictEqual(
+    config.design.colors.primary,
+    "#fbbf24",
+    "Gold detection failed"
+  );
+  assert.ok(
+    config.features.includes("Advanced Analytics"),
+    "Analytics detection failed"
+  );
+  assert.ok(
+    config.features.includes("Authentication"),
+    "Auth detection failed"
+  );
+
+  // Check Type-Aware Pages
+  assert.strictEqual(
+    config.pages.length,
+    2,
+    "Should have landing and dashboard"
+  );
+  assert.ok(
+    config.pages.some((p) => p.path === "/dashboard"),
+    "Dashboard page missing"
+  );
+  console.log("✅ Complex Intent mapping OK");
+
+  // 3. Project Type Specifics (E-commerce)
+  console.log("\nTesting EbadeArchitect (E-commerce)...");
+  const shopConfig = await EbadeArchitect.plan(
+    "Sleek shoe store with red theme"
+  );
+  assert.strictEqual(shopConfig.type, "e-commerce");
+  assert.ok(
+    shopConfig.pages.some((p) => p.path === "/products"),
+    "E-commerce missing /products"
+  );
+  assert.ok(
+    shopConfig.pages.some((p) => p.path === "/cart"),
+    "E-commerce missing /cart"
+  );
+  console.log("✅ E-commerce structure OK");
+
+  // 4. Project Type Specifics (Blog)
+  console.log("\nTesting EbadeArchitect (Blog)...");
+  const blogConfig = await EbadeArchitect.plan("Ocean themed news blog");
+  assert.strictEqual(blogConfig.type, "blog");
+  assert.ok(
+    blogConfig.pages.some((p) => p.path === "/posts"),
+    "Blog missing /posts index"
+  );
+  assert.ok(
+    blogConfig.pages.some((p) => p.path === "/posts/[slug]"),
+    "Blog missing /posts/[slug] dynamic route"
+  );
+  console.log("✅ Blog structure OK");
+
+  console.log("\n✨ All framework tests passed!");
+}
+
+runTests().catch((err) => {
+  console.error("\n❌ Test failed:");
+  console.error(err);
+  process.exit(1);
+});

package/vhs/build-demo.tape

@@ -0,0 +1,54 @@
+# ebade v0.4.7 Build Demo
+# Run with: vhs vhs/build-demo.tape
+
+Output ../assets/build-demo.gif
+Output ../assets/build-demo.mp4
+
+Set FontSize 20
+Set Width 1200
+Set Height 800
+Set Theme "Catppuccin Mocha"
+Set Padding 40
+Set TypingSpeed 60ms
+
+# Start fresh
+Hide
+Type "rm -rf LuxuryConcierge"
+Enter
+Type "clear"
+Enter
+Sleep 500ms
+Show
+
+# Step 1: The Prompt
+Type "# 🛡️ Phase I: The Offline Architect"
+Enter
+Sleep 1s
+Type "# Designing a project with 0 tokens using NPX..."
+Enter
+Sleep 1.5s
+
+# The magic command using npx
+Type "npx ebade build 'A luxury concierge service with pricing, testimonials and a gold theme'"
+Sleep 500ms
+Enter
+
+# Wait for the Architect to work (Creative Brief output)
+Sleep 15s
+
+# Step 2: Show the result
+Type "# ✅ Project designed and scaffolded in seconds."
+Enter
+Sleep 1.5s
+Type "ls -R LuxuryConcierge/app"
+Enter
+Sleep 4s
+
+# Final tagline
+Type "# 🌓 ebade: Hybrid Workflow."
+Enter
+Sleep 1s
+Type "# → Get started at ebade.dev"
+Enter
+
+Sleep 4s

package/{demo.tape → vhs/demo.tape}

@@ -1,10 +1,10 @@
 # ebade Demo Video Script
-# Run with: vhs demo.tape
+# Run with: vhs vhs/demo.tape
 # Outputs: demo.gif + demo.mp4
 
 # Outputs - both formats
-Output assets/demo.gif
-Output assets/demo.mp4
+Output ../assets/demo.gif
+Output ../assets/demo.mp4
 
 # Configuration
 Set FontSize 20

package/www/app/page.tsx

@@ -67,7 +67,7 @@ export default function HomePage() {
                 <div className="visual-glow"></div>
                 <div className="video-container">
                   <video className="hero-video" autoPlay loop muted playsInline>
-                    <source src="/assets/demo.mp4" type="video/mp4" />
+                    <source src="/assets/build-demo.mp4" type="video/mp4" />
                   </video>
                 </div>
               </div>

package/www/package.json

@@ -1,6 +1,6 @@
 {
   "name": "www",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "private": true,
   "scripts": {
     "dev": "next dev",