ebade 0.2.0 → 0.2.2

package/README.md

@@ -16,7 +16,12 @@
 >
 > *Capture the essence of code. Less tokens. Less carbon. Same result.* 🌱
 
+## 🎬 See it in action
+
+![ebade demo](./demo.gif)
+
 ```typescript
+
 // ❌ Before: 100+ lines of boilerplate
 export default function CheckoutPage() {
   const [cart, setCart] = useState([]);

package/cli/scaffold.js

@@ -472,6 +472,38 @@ body {
 `;
 }
 
+function generateAgentRules(config) {
+  return `
+# ebade Agent-First Framework Rules
+
+You are an AI developer working on a project built with the **ebade Agent-First Framework**.
+This project is designed specifically for AI-Human collaboration.
+
+## 🧠 Core Philosophy
+- **Intent > Implementation**: Focus on WHAT the code should do.
+- **Source of Truth**: The structure is defined in \`project.ebade.yaml\`. Always refer to it before making structural changes.
+- **Consistency**: All generated code should match the intents defined in \`app/\`, \`components/\`, and \`api/\`.
+
+## 🛠 Framework Patterns
+
+### 1. Decorators (Comments)
+All files generated by ebade contain semantic decorators in their headers. Keep them intact:
+- @page('/path'): Marks a Next.js Page.
+- @intent('name'): Describes the purpose of the file.
+- @requires(['components']): Lists dependencies.
+
+### 2. Design System
+- Use CSS Variables defined in \`app/globals.css\`.
+- Prefer these tokens: var(--color-primary), var(--color-secondary), var(--radius-default).
+
+## 🤝 AI Collaboration Guidelines
+1. **When adding a new page**: First, suggest updating \`project.ebade.yaml\` if possible.
+2. **When modifying components**: Ensure they remain decoupled and respect the design system props.
+
+Built with ebade - The Agent-First Framework for the next era of development. 🌱
+`;
+}
+
 // ============================================
 // Utility Functions
 // ============================================
@@ -665,6 +697,25 @@ function scaffold(ebadePath, outputDir) {
   );
   log.file("next-env.d.ts");
 
+  // Agent Rules
+  const agentRules = generateAgentRules(config).trim();
+
+  // .cursorrules (Cursor)
+  fs.writeFileSync(path.join(projectDir, ".cursorrules"), agentRules);
+  log.file(".cursorrules");
+
+  // .clauderules (Claude/Windsurf)
+  fs.writeFileSync(path.join(projectDir, ".clauderules"), agentRules);
+  log.file(".clauderules");
+
+  // GitHub Copilot instructions
+  ensureDir(path.join(projectDir, ".github"));
+  fs.writeFileSync(
+    path.join(projectDir, ".github/copilot-instructions.md"),
+    agentRules
+  );
+  log.file(".github/copilot-instructions.md");
+
   // ========== Generate Database Schema ==========
   if (config.data) {
     log.section("Generating database schema");
@@ -730,32 +781,63 @@ ${colors.yellow}💡 Tip:${colors.reset} AI Agents can read ${
 // CLI Entry Point
 // ============================================
 const args = process.argv.slice(2);
+const command = args[0];
 
-if (args.length === 0) {
+function showHelp() {
   console.log(`
-${colors.bright}ebade Scaffold CLI${colors.reset}
+${colors.bright}ebade CLI${colors.reset} - The Agent-First Framework
 
-Usage:
-  npx ebade scaffold <ebade-file> [output-dir]
+${colors.dim}Usage:${colors.reset}
+  npx ebade <command> [options]
 
-Example:
+${colors.dim}Commands:${colors.reset}
+  scaffold <file> [output]   Scaffold a project from ebade file
+  
+${colors.dim}Examples:${colors.reset}
   npx ebade scaffold examples/ecommerce.ebade.yaml ./output
+  npx ebade scaffold my-project.ebade.yaml
 
-Options:
-  ebade-file   Path to .ebade.yaml file
-  output-dir    Output directory (default: ./output)
+${colors.dim}Learn more:${colors.reset}
+  https://ebade.dev
 `);
-  process.exit(1);
 }
 
-const ebadeFile = args[0];
-const outputDir = args[1] || "./output";
+if (
+  args.length === 0 ||
+  command === "help" ||
+  command === "--help" ||
+  command === "-h"
+) {
+  showHelp();
+  process.exit(0);
+}
+
+if (command === "scaffold") {
+  const ebadeFile = args[1];
+  const outputDir = args[2] || "./output";
+
+  if (!ebadeFile) {
+    console.error(
+      `${colors.red}Error:${colors.reset} Please provide an ebade file path.`
+    );
+    console.log(
+      `\n${colors.dim}Usage:${colors.reset} npx ebade scaffold <file.ebade.yaml> [output-dir]\n`
+    );
+    process.exit(1);
+  }
 
-if (!fs.existsSync(ebadeFile)) {
+  if (!fs.existsSync(ebadeFile)) {
+    console.error(
+      `${colors.red}Error:${colors.reset} ebade file not found: ${ebadeFile}`
+    );
+    process.exit(1);
+  }
+
+  scaffold(ebadeFile, outputDir);
+} else {
   console.error(
-    `${colors.red}Error:${colors.reset} ebade file not found: ${ebadeFile}`
+    `${colors.red}Error:${colors.reset} Unknown command: ${command}`
   );
+  showHelp();
   process.exit(1);
 }
-
-scaffold(ebadeFile, outputDir);

package/demo.tape

@@ -0,0 +1,63 @@
+# ebade Demo Video Script
+# Run with: vhs demo.tape
+# Outputs: demo.gif + demo.mp4
+
+# Outputs - both formats
+Output demo.gif
+Output demo.mp4
+
+# Configuration
+Set FontSize 20
+Set Width 1200
+Set Height 700
+Set Theme "Catppuccin Mocha"
+Set Padding 30
+Set TypingSpeed 50ms
+Set PlaybackSpeed 1.0
+
+# Clear and prepare
+Hide
+Type "clear"
+Enter
+Sleep 500ms
+Show
+
+# Intro
+Type "# 🧠 ebade - The Agent-First Framework"
+Enter
+Sleep 1.2s
+
+Type "# Scaffold a full SaaS Dashboard in seconds..."
+Enter
+Sleep 1.5s
+
+# The magic command with npx
+Type "npx ebade scaffold examples/saas-dashboard.ebade.yaml ./output/demo"
+Sleep 500ms
+Enter
+
+# Wait for CLI output (ASCII logo + spinners + summary)
+Sleep 10s
+
+# Show generated file
+Type ""
+Enter
+Sleep 500ms
+
+Type "head -12 output/demo/AnalyticsHQ/app/page.tsx"
+Enter
+Sleep 4s
+
+# Final tagline
+Type ""
+Enter
+Type "# ✅ 51 files. ~70% fewer tokens. In 0.1s."
+Enter
+Sleep 500ms
+Type "# 🌱 Green AI. Kind to Earth."
+Enter
+Sleep 500ms
+Type "# → ebade.dev"
+Enter
+
+Sleep 3s

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ebade",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "ebade - Agent-First Framework. The first framework designed for AI agents, readable by humans.",
   "type": "module",
   "main": "cli/scaffold.js",