ebade 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to **ebade** will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- MCP Server branding update to **ebade**.
+- Green AI Metrics and Carbon Impact calculations.
+- Turkish identity integration (Badik mascot 🐣 and "The Essence of Code" vision).
+- `ebade_generate` improved inference.
+
+---
+
+## [0.1.0] - 2025-01-07
+
+### Added
+
+- 🎉 Initial alpha release of **ebade**
+- MCP Server package (`@ebade/mcp-server`) with 4 tools:
+  - `ebade_scaffold` - Create full projects from ebade definitions
+  - `ebade_validate` - Validate ebade files against schema
+  - `ebade_compile` - Compile single ebade to code
+  - `ebade_generate` - Generate components from natural language
+- Project scaffolding for 5 project types (e-commerce, SaaS, Blog, etc.)
+- YAML ebade definition format (.ebade.yaml)
+- Next.js App Router as primary compilation target
+- Comprehensive documentation (Manifesto, Syntax, Roadmap, Green AI)
+
+---
+
+*This project was born out of the desire to make AI coding efficient and sustainable.*

package/CONTRIBUTING.md

@@ -0,0 +1,177 @@
+# Contributing to ebade 🤝
+
+First off, thank you for considering contributing to ebade! This is a community-driven project, and we welcome contributions of all kinds.
+
+## 🌟 Ways to Contribute
+
+### 1. Star the Repository
+The simplest way to show support! It helps others discover the project.
+
+### 2. Report Bugs
+Found a bug? Please open an issue with:
+- A clear, descriptive title
+- Steps to reproduce
+- Expected vs actual behavior
+- Your environment (OS, Node version, etc.)
+
+### 3. Suggest Features
+Have an idea? Open an issue with the "feature request" label:
+- Describe the problem you're trying to solve
+- Propose your solution
+- Consider alternatives you've thought about
+
+### 4. Submit ebade Examples
+
+One of the best ways to contribute is adding new ebade examples:
+
+```
+examples/
+├── ecommerce.ebade.yaml      # existing
+├── blog.ebade.yaml           # new!
+├── saas-dashboard.ebade.yaml # new!
+└── portfolio.ebade.yaml      # new!
+```
+
+### 5. Add Component Templates
+Expand the component library in the MCP server:
+```typescript
+// packages/mcp-server/src/tools/generate.ts
+const componentPatterns = [
+  // Add your pattern here!
+];
+```
+
+### 6. Improve Documentation
+- Fix typos
+- Add examples
+- Clarify confusing sections
+- Translate to other languages
+
+### 7. Core Development
+- Parser improvements
+- New compilation targets (Vue, Svelte, etc.)
+- VS Code extension
+- CLI enhancements
+
+---
+
+## 🛠️ Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/YOUR_USERNAME/ebade.git
+cd ebade
+
+# Install dependencies
+npm install
+
+# Build MCP server
+cd packages/mcp-server
+npm install
+npm run build
+
+# Run in dev mode
+npm run dev
+```
+
+---
+
+## 📝 Pull Request Process
+
+1. **Fork** the repository
+2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
+3. **Make** your changes
+4. **Test** your changes
+5. **Commit** with a descriptive message
+6. **Push** to your fork
+7. **Open** a Pull Request
+
+### Commit Message Format
+
+```
+type(scope): subject
+
+body (optional)
+```
+
+Types:
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation
+- `style`: Formatting
+- `refactor`: Code restructuring
+- `test`: Adding tests
+- `chore`: Maintenance
+
+Examples:
+```
+feat(mcp): add vue compilation target
+fix(scaffold): handle nested routes correctly
+docs(readme): add installation instructions
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run tests
+npm test
+
+# Run with coverage
+npm run test:coverage
+```
+
+---
+
+## 📋 Code Style
+
+- Use TypeScript
+- 2 spaces for indentation
+- Semicolons required
+- Single quotes for strings
+- Max line length: 100 characters
+
+We use ESLint and Prettier (coming soon).
+
+---
+
+## 🎯 Priority Areas
+
+Currently, we're focusing on:
+
+1. **MCP Server stability** - Making it robust for AI agents
+2. **ebade examples** - More real-world examples
+3. **Documentation** - Comprehensive guides
+4. **Vue/Svelte targets** - Cross-framework compilation
+
+---
+
+## 🤖 For AI Contributors
+
+Yes, AI agents can contribute too! When contributing via AI:
+
+1. Clearly state that the contribution was AI-assisted
+2. Review the generated code carefully
+3. Test the changes
+4. Ensure the code follows our style guide
+
+---
+
+## 💬 Questions?
+
+- Open an issue with the "question" label
+- Start a GitHub Discussion
+- Reach out on Twitter (coming soon)
+
+---
+
+## 📜 Code of Conduct
+
+Be kind, be respectful, be constructive.
+
+We're all here to build something amazing together.
+
+---
+
+Thank you for helping make ebade better! 🚀

package/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 ebade Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MANIFESTO.md

@@ -0,0 +1,170 @@
+# ebade Manifesto 🧠
+
+> **"Code = f(intent)"** — Kod, niyetin bir fonksiyonu olmalı.
+
+---
+
+## Paradigma Değişimleri
+
+| Feature | Traditional Frameworks | ebade (Agent-First) |
+| :--- | :--- | :--- |
+| **Primary User** | Human Developer | AI Agent |
+| **Entry Point** | implementation.ts | project.ebade.yaml |
+| **Context Size** | High (Boilerplate) | Ultra-Low (Essence) |
+| **Logic** | Procedural "How" | Declarative "What" |
+| **Testability** | External / Manual | Inherent / Inferred |
+| **Carbon Footprint**| High (100%) | Low (~34%) |
+
+---
+
+## Mevcut Sorun
+
+AI agent'lar şu anda **insan gibi davranmaya** zorlanıyor:
+
+```
+İnsan → Düşünür → Kod yazar → Framework → Çalışır
+                     ↑
+AI Agent → Düşünür → Kod yazar → Framework → Çalışır
+                     ↑
+           "İnsan gibi" kod yazmak zorunda
+```
+
+AI'ın doğal düşünce şekli:
+- **Intent-based**: "Ne" olmasını istiyor
+- **Declarative**: "Nasıl" değil "ne" 
+- **Structured**: Belirsizlik yok
+
+Ama mevcut framework'lar:
+- **Imperative detaylar** istiyor
+- **İnsan convention'ları** var
+- **Belirsizliklerle** dolu
+
+---
+
+## Temel Kavramlar
+
+### Intent
+Bir şeyin **ne** yapması gerektiğinin tanımı.
+
+```javascript
+@intent('user-authentication')
+@inputs(['email', 'password'])
+@validates(['email-format', 'password-strength'])
+@outcomes({
+  success: 'redirect-to-dashboard',
+  failure: 'show-error-message'
+})
+```
+
+### Requires
+Intent'in çalışması için gereken bağımlılıklar.
+
+```javascript
+@requires({
+  data: ['user', 'products'],      // Veri bağımlılıkları
+  auth: 'required',                 // Auth durumu
+  permissions: ['can-checkout'],    // İzinler
+  features: ['payments']            // Feature flags
+})
+```
+
+### Outcomes
+Olası sonuçlar ve ne yapılacağı.
+
+```javascript
+@outcomes({
+  success: '/thank-you',
+  error: { show: 'toast', message: 'context' },
+  timeout: { retry: 3, fallback: 'offline-mode' }
+})
+```
+
+### Style
+Görsel tanım (design system'den).
+
+```javascript
+@style({
+  variant: 'primary',
+  size: 'lg',
+  animation: 'subtle',
+  theme: 'inherit'
+})
+```
+
+```text
+Goal → Implementation → Debugging → Refactoring
+```
+
+---
+
+## Compilation Pipeline
+
+```
+Intent Definition (.intent.js)
+        ↓
+    [Parser]
+        ↓
+    Intent AST
+        ↓
+    [Compiler]
+        ↓
+    Target Framework Code (React, Vue, etc.)
+        ↓
+    [Runtime]
+        ↓
+    Working Application
+```
+
+---
+
+## AI Agent Workflow
+
+### Önceki (Şimdi)
+```
+User: "Checkout sayfası yap"
+Agent: *Next.js docs'ı hatırla*
+       *app router mı pages mı?*
+       *server component mı client mı?*
+       *500 satır kod yaz*
+```
+
+### ebade ile
+```
+User: "Checkout sayfası yap"
+Agent: *intent tanımı yaz*
+       @page('/checkout')
+       @intent('complete-purchase')
+       @requires(['cart', 'user', 'payment'])
+       *bitti*
+```
+
+---
+
+## Design Principles
+
+1. **Agent-Native**: AI'ın düşünce yapısına uygun
+2. **Human-Readable**: İnsan da okuyup anlayabilir
+3. **Deterministic**: Aynı input = aynı output
+4. **Composable**: Küçük parçalar büyük yapılar oluşturur
+5. **Target-Agnostic**: Farklı framework'lere compile edilebilir
+
+---
+
+## Why Now?
+
+1. **AI Coding Mainstream**: Cursor, Copilot, Claude yaygın
+2. **Framework Fatigue**: Herkes yeni şeyler öğrenmekten yorgun
+3. **Abstraction Ready**: TypeScript, JSX gibi katmanlar kabul gördü
+4. **First Mover**: Henüz kimse yapmadı
+
+---
+
+## Vision
+
+> ebade, AI agent'ların doğal dili. 
+> İnsan niyeti ile çalışan kod arasındaki köprü.
+> Framework'ler için TypeScript ne ise, AI için o.
+
+---
+
+**Built for AI, readable by humans.**

package/README.md

@@ -0,0 +1,263 @@
+# ebade 🧠
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![MCP Server](https://img.shields.io/badge/MCP-Ready-green.svg)](./packages/mcp-server)
+[![Status](https://img.shields.io/badge/Status-Alpha-orange.svg)](./ROADMAP.md)
+[![Green AI](https://img.shields.io/badge/🌱_Green_AI-66%25_Less_Tokens-brightgreen)](./docs/GREEN-AI.md)
+
+> **The first framework designed FOR AI agents, readable by humans.**
+>
+> `Code = f(ebade)`
+>
+> *Capture the essence of code. Less tokens. Less carbon. Same result.* 🌱
+
+```typescript
+// ❌ Before: 100+ lines of boilerplate
+export default function CheckoutPage() {
+  const [cart, setCart] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => { /* fetch data */ }, []);
+  // ... 100 more lines of HOW
+}
+
+// ✅ After: Pure intent - WHAT you want
+@page('/checkout')
+@intent('complete-purchase')
+@requires({ data: ['cart', 'user'], auth: 'required' })
+@outcomes({ success: '/order/[id]', error: 'show-inline' })
+export function Checkout({ cart, user }) {
+  // Just business logic, zero boilerplate
+}
+```
+
+---
+
+## 🚀 Quick Start
+
+### For AI Agents (MCP)
+
+**ebade** is designed to be used BY AI agents. Add to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "ebade": {
+      "command": "node",
+      "args": ["./packages/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+Then AI agents can use:
+
+- `ebade_scaffold` - Create full projects from intent
+- `ebade_compile` - Compile single intents to code
+- `ebade_validate` - Validate intent files
+- `ebade_generate` - Generate from natural language
+
+### For Humans (CLI)
+
+```bash
+# Scaffold a new project
+npx ebade scaffold --type e-commerce --name my-store
+
+# Compile intents to code
+npx ebade build
+
+# Watch mode
+npx ebade dev
+```
+
+---
+
+## 📊 Benchmark: ~66% Fewer Tokens (Tested)
+
+We measured token usage across common development tasks:
+
+| Task | Next.js | ebade | Savings | Efficiency |
+|------|---------|-------|---------|------------|
+| Checkout Page | 258 tokens | 66 tokens | **74.4%** | 3.9x |
+| Product Listing | 133 tokens | 63 tokens | **52.6%** | 2.1x |
+| User Auth | 148 tokens | 56 tokens | **62.2%** | 2.6x |
+| **Average** | | | **65.7%** | **2.9x** |
+
+> *For full project scaffolding, savings can reach 75-92%.*
+
+### 💰 Cost Impact
+
+At scale (1M AI coding sessions):
+
+| Framework | Token Cost | Savings |
+|-----------|------------|---------|
+| Next.js | $5,390 | - |
+| **ebade** | **$1,850** | **$3,540** |
+
+> *The greenest code is the code you don't generate.*
+
+📄 [Full Benchmark Results](./benchmarks/RESULTS.md) | 🌱 [Green AI Manifesto](./docs/GREEN-AI.md)
+
+---
+
+## 💡 The Problem
+
+AI agents (Cursor, Copilot, Claude) write code for **human-designed frameworks**:
+
+```
+AI: "Is this a server or client component?"
+AI: "App router or pages router?"
+AI: "useState or useReducer?"
+AI: "Where does this file go?"
+```
+
+Every decision is **ambiguous**. AI guesses. Sometimes wrong.
+
+## ✨ The Solution
+
+**ebade** - A framework where AI expresses **intent**, not implementation.
+
+```
+Human describes → AI writes intent → ebade compiles → Working code
+                        ↑
+                 No ambiguity here
+```
+
+---
+
+## 📦 Packages
+
+| Package | Description | Status |
+|---------|-------------|--------|
+| [@ebade/mcp-server](./packages/mcp-server) | MCP Server for AI agents | ✅ Alpha |
+| @ebade/cli | Command-line interface | 🚧 Coming |
+| @ebade/compiler | Intent → Code compiler | 🚧 Coming |
+| @ebade/vscode | VS Code extension | 📋 Planned |
+
+---
+
+## 🎯 Core Concepts
+
+### Intent-First
+
+```typescript
+@intent('user-authentication')
+@inputs(['email', 'password'])
+@outcomes({ success: '/dashboard', failure: 'show-error' })
+```
+
+You say **WHAT**, not **HOW**.
+
+### Deterministic
+
+Same intent = Same output. Every time. No guessing.
+
+### Composable
+
+```typescript
+@compose(['header', 'sidebar', 'content', 'footer'])
+```
+
+Small intents build big applications.
+
+### Target-Agnostic
+
+```typescript
+@compile('nextjs')   // → Next.js App Router
+@compile('vue')      // → Vue + Nuxt (coming)
+@compile('svelte')   // → SvelteKit (coming)
+```
+
+One intent, many outputs.
+
+---
+
+## 📋 Example
+
+```yaml
+# project.intent.yaml
+
+name: my-store
+type: e-commerce
+features:
+  - product-catalog
+  - shopping-cart
+  - checkout
+  - user-auth
+
+pages:
+  - path: /
+    intent: landing-page
+    components:
+      - hero-section
+      - featured-products
+      - testimonials
+      
+  - path: /products
+    intent: product-listing
+    components:
+      - search-bar
+      - product-grid
+      - pagination
+      
+  - path: /checkout
+    intent: checkout-flow
+    auth: required
+    components:
+      - cart-summary
+      - payment-form
+```
+
+**Output:** Full Next.js project with 20+ files, ready to run.
+
+---
+
+## 🎭 The Paradigm Shift
+
+| Era | Paradigm | Core Question |
+|-----|----------|---------------|
+| 2000s | jQuery | "How do I manipulate DOM?" |
+| 2013 | React | "What if UI = f(state)?" |
+| 2024 | AI Coding | "AI writes code, but for humans" |
+| **2026** | **ebade** | **"What if Code = f(intent)?"** |
+
+---
+
+## 📚 Documentation
+
+- 📜 [Manifesto](./MANIFESTO.md) — Philosophy & Vision
+- 📖 [Syntax Spec](./SYNTAX.md) — Complete Decorator Reference
+- 🗺️ [Roadmap](./ROADMAP.md) — Development Plan
+- 📁 [Examples](./examples/) — Real-world Intent Files
+- 📊 [Benchmarks](./benchmarks/) — Token & Cost Analysis
+- 🌱 [Green AI](./docs/GREEN-AI.md) — Environmental Impact
+
+---
+
+## 🤝 Contributing
+
+**ebade** is open source and welcomes contributions!
+
+1. **Star this repo** ⭐
+2. **Try the MCP server** with your AI agent
+3. **Open issues** with ideas and feedback
+4. **Submit PRs** for new features
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+---
+
+## 📄 License
+
+MIT © ebade Contributors — Made with ❤️ in Türkiye 🇹🇷
+
+---
+
+<p align="center">
+  <strong>Built for AI. Readable by humans. Revolutionary by design.</strong>
+</p>
+
+<p align="center">
+  <i>TypeScript made JavaScript better for humans.<br/>
+  ebade makes frameworks better for AI.</i>
+</p>