ebade 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ 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).
 
+## [1.1.0] - 2026-01-11
+
+- **ebade Pulse**: Implemented anonymous, privacy-first telemetry for real-time usage insights.
+- **Self-Hosted Analytics**: Telemetry data is now sent directly to `ebade.dev` and stored in Supabase.
+- **Privacy First**: Added `EBADE_TELEMETRY_DISABLED` opt-out and detailed transparency in README.
+- **Infrastructure Overhaul**: Updated CLI and Backend to support secure, keyless event tracking.
+
 ## [1.0.0] - 2025-01-10
 
 - **Official v1.0.0 Launch ("Zımba Edition")**: Reached full production stability across all targets.

package/README.md

@@ -78,7 +78,7 @@ ebade uses a high-density decorator syntax designed to fit within an Agent's con
 
 ## 🧠 The Architect: Prompt-to-Product
 
-In **v1.0.0**, we reached **Ultimate Stability**. ebade is now the first professional-grade, multi-target framework built natively for AI agents. Whether it's Web (Next.js), Android (Flutter), or iOS (SwiftUI), ebade forges your legacy with a single prompt. 🚀
+In **v1.1.0**, we introduce **ebade Pulse**. ebade continues to be the most stable professional-grade, multi-target framework built natively for AI agents. Whether it's Web (Next.js), Android (Flutter), or iOS (SwiftUI), ebade forges your legacy with a single prompt. 🚀
 
 ```bash
 # One-shot project creation
@@ -86,8 +86,10 @@ npx ebade build "A luxury concierge service with pricing, testimonials and a gol
 ```
 
 - **Intent Intelligence**: Automatically detects app type (SaaS, E-commerce, Blog).
+- **Universal LogicForge**: Generates Types, Services, and Mocks for Next.js, Flutter, and SwiftUI simultaneously.
 - **Dynamic Design**: Generates a premium HSL color palette from your prompt.
 - **Smart Scaffolding**: Detects needed components (`auth`, `charts`, `forms`) and dynamically creates routes.
+- **Green AI Dashboard**: Integrated sustainability metrics to measure token and carbon savings.
 
 ---
 
@@ -128,7 +130,7 @@ Add `ebade` to your AI agent (Claude, Cursor, Windsurf) via the Model Context Pr
 ebade operates on the principle of **The Online Compiler**. It treats AI as a deterministic component of the toolchain, not a creative oracle.
 
 - **Standardized Intent Tree (SIT):** Parses YAML/TS into a logical graph.
-- **Target Adapters:** Compiles intent into Next.js, Flutter, or Svelte (0-token boilerplate).
+- **Target Adapters:** Compiles intent into Next.js, Flutter, or SwiftUI (0-token boilerplate).
 - **AgentRules:** Automatically generates `.cursorrules` and `.clauderules` to keep your agent aligned.
 
 🏗️ [Explore the Architecture](./ARCHITECTURE.md)
@@ -177,6 +179,14 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for full guidelines.
 - **Star the repo** to show your support ⭐
 - **Share the project** with other enthusiasts 🚀
 
+## 🔒 Privacy & Telemetry
+
+**ebade** collects anonymous usage statistics (ebade Pulse) to help us understand how the framework is used and to improve it.
+
+- **What we collect:** Command name, target platform (Next.js/Flutter), basic OS info, and performance metrics (files generated, tokens saved).
+- **What we NEVER collect:** Your code, your ebade YAML content, project names, or any personal information.
+- **How to disable:** Set `EBADE_TELEMETRY_DISABLED=1` in your environment.
+
 ---
 
 ## 📄 License

package/cli/scaffold.js

@@ -23,6 +23,7 @@ import { FlutterAdapter } from "./adapters/flutter.js";
 import { SwiftUiAdapter } from "./adapters/swiftui.js";
 import { ensureDir, toPascalCase, calculateGreenMetrics } from "./utils.js";
 import { validateEbade } from "./validator.js";
+import { sendPulse } from "./telemetry.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -51,7 +52,7 @@ ${colors.magenta}    ██╔══╝  ${colors.cyan}██╔══██╗$
 ${colors.magenta}    ███████╗${colors.cyan}██████╔╝${colors.magenta}██║  ██║${colors.cyan}██████╔╝${colors.magenta}███████╗
 ${colors.magenta}    ╚══════╝${colors.cyan}╚═════╝ ${colors.magenta}╚═╝  ╚═╝${colors.cyan}╚═════╝ ${colors.magenta}╚══════╝${colors.reset}
     
-    ${colors.dim}✨ Agent-First Framework ${colors.yellow}v1.0.0${colors.reset}
+    ${colors.dim}✨ Agent-First Framework ${colors.yellow}v1.1.0${colors.reset}
 `;
 
 const log = {
@@ -512,6 +513,21 @@ async function scaffold(ebadePath, outputDir, target = "nextjs") {
   console.log(
     `  Tokens Transferred: ${colors.dim}~${green.rawTokensSaved}${colors.reset}\n  Carbon Saved:       ${colors.green}${green.gramsCO2Saved}g CO2e${colors.reset}\n  Protocol Precision: ${colors.bright}99.9%${colors.reset}\n`
   );
+
+  // Send Telemetry
+  sendPulse({
+    event: "ebade_scaffold_success",
+    target: target,
+    metrics: {
+      files: stats.files,
+      pages: stats.pages,
+      components: stats.components,
+      api_routes: stats.apiRoutes,
+      tokens_saved: green.rawTokensSaved,
+      carbon_saved_g: green.gramsCO2Saved,
+    },
+    duration_s: duration,
+  });
 }
 
 // CLI Logic
@@ -547,12 +563,17 @@ if (command === "init") {
   fs.writeFileSync(tempFile, yaml.stringify(config));
   await scaffold(tempFile, outputDir, target);
   fs.rmSync(tempDir, { recursive: true, force: true });
+
+  sendPulse({
+    event: "ebade_build_success",
+    target: target,
+  });
 } else if (command === "scaffold") {
   const file = args.filter((a) => !a.startsWith("-"))[1];
   const out = args.filter((a) => !a.startsWith("-"))[2] || "./output";
   await scaffold(file, out, target);
 } else {
   console.log(
-    "ebade v1.0.0 - Agent-First Framework\nUsage: npx ebade <build|scaffold> <prompt|file> [--target nextjs|html|flutter|swiftui]"
+    "ebade v1.1.0 - Agent-First Framework\nUsage: npx ebade <build|scaffold> <prompt|file> [--target nextjs|html|flutter|swiftui]"
   );
 }

package/cli/telemetry.js

@@ -0,0 +1,64 @@
+import https from "https";
+import os from "os";
+
+/**
+ * ebade Pulse - Privacy-first Telemetry
+ * Sends anonymous usage data directly to ebade.dev
+ */
+export async function sendPulse(eventData) {
+  if (process.env.EBADE_TELEMETRY_DISABLED) return;
+
+  const payload = {
+    event: eventData.event || "cli_usage",
+    timestamp: new Date().toISOString(),
+    os: os.platform(),
+    arch: os.arch(),
+    node_version: process.version,
+    is_agent: detectAgent(),
+    ...eventData,
+  };
+
+  const data = JSON.stringify(payload);
+
+  const options = {
+    hostname: "ebade.dev",
+    port: 443,
+    path: "/api/pulse",
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Content-Length": data.length,
+      "User-Agent": "ebade-cli",
+    },
+  };
+
+  const req = https.request(options);
+
+  req.on("error", () => {
+    // Silent fail if offline or server is down
+  });
+  req.write(data);
+  req.end();
+}
+
+function detectAgent() {
+  const agentEnvs = [
+    "CLAUDE_CODE",
+    "GITHUB_ACTIONS",
+    "VERCEL",
+    "AGENT_ID",
+    "AI_AGENT",
+    "LLM_AGENT",
+  ];
+
+  if (agentEnvs.some((env) => process.env[env])) return true;
+
+  if (
+    process.env.TERM_PROGRAM === "vscode" &&
+    process.env.VSCODE_GIT_IPC_HANDLE
+  ) {
+    return true;
+  }
+
+  return false;
+}

package/package.json

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

package/packages/mcp-server/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ebade-mcp-server",
-  "version": "1.0.0",
-  "description": "MCP Server for ebade v0.5.0 - The Agent-First Framework",
+  "version": "1.1.0",
+  "description": "MCP Server for ebade v1.1.0 - The Agent-First Framework",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

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

@@ -9,7 +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)
+ * - Build entire projects from natural language prompts (NEW in v1.1.0)
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -31,7 +31,7 @@ import { buildFromPrompt } from "./tools/build.js";
 const server = new Server(
   {
     name: "ebade",
-    version: "0.4.7",
+    version: "1.1.0",
   },
   {
     capabilities: {

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

@@ -37,7 +37,7 @@ export async function buildFromPrompt(args: BuildArgs): Promise<string> {
       env: { ...process.env, NODE_ENV: "production" },
     });
 
-    return `✅ ebade v0.4.7 Build Complete!
+    return `✅ ebade v1.1.0 Build Complete!
     
 Prompt: "${prompt}"
 Output: ${outputDir}

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

@@ -139,7 +139,44 @@ export async function scaffoldProject(args: ScaffoldArgs): Promise<string> {
     // 3. Generate Next.js files (Basic mocks to match CLI)
     generateCoreFiles(projectDir, ebadeConfig);
 
-    return `✅ ebade v0.3.1 Scaffold Complete!
+    // 4. Send Telemetry
+    try {
+      const https = await import("https");
+      const payload = JSON.stringify({
+        event: "ebade_mcp_scaffold_success",
+        timestamp: new Date().toISOString(),
+        os: process.platform,
+        arch: process.arch,
+        node_version: process.version,
+        is_agent: true,
+        command: "mcp_scaffold",
+        target: "nextjs",
+        metrics: {
+          project_type: projectType,
+        },
+      });
+
+      const options = {
+        hostname: "ebade.dev",
+        port: 443,
+        path: "/api/pulse",
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Content-Length": payload.length,
+          "User-Agent": "ebade-mcp",
+        },
+      };
+
+      const req = https.request(options);
+      req.on("error", () => {});
+      req.write(payload);
+      req.end();
+    } catch (e) {
+      // Silent fail
+    }
+
+    return `✅ ebade v1.1.0 Scaffold Complete!
     
 Project: ${projectName}
 Type: ${projectType}

package/packages/vscode-extension/package.json

@@ -2,7 +2,7 @@
   "name": "ebade",
   "displayName": "ebade - Agent-First Framework",
   "description": "Syntax highlighting and snippets for ebade (.ebade.yaml) files",
-  "version": "0.4.1",
+  "version": "1.1.0",
   "publisher": "hasankemaldemirci",
   "icon": "images/icon.png",
   "engines": {

package/www/app/api/pulse/route.ts

@@ -0,0 +1,53 @@
+import { NextResponse } from "next/server";
+import { supabase } from "@/lib/supabase";
+
+export async function POST(req: Request) {
+  try {
+    const contentLength = parseInt(req.headers.get("content-length") || "0");
+    if (contentLength > 1024 * 5) {
+      return NextResponse.json({ error: "Payload too large" }, { status: 413 });
+    }
+
+    if (req.headers.get("user-agent") !== "ebade-cli") {
+      return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+    }
+
+    const contentType = req.headers.get("content-type");
+    if (!contentType || !contentType.includes("application/json")) {
+      return NextResponse.json(
+        { error: "Unsupported Media Type" },
+        { status: 415 }
+      );
+    }
+
+    const body = await req.json();
+
+    if (!body.event || !body.timestamp) {
+      return NextResponse.json({ error: "Malformed request" }, { status: 400 });
+    }
+
+    const { error } = await supabase.from("pulses").insert([
+      {
+        event: body.event,
+        timestamp: body.timestamp,
+        os: body.os,
+        arch: body.arch,
+        node_version: body.node_version,
+        is_agent: body.is_agent,
+        command: body.command,
+        target: body.target,
+        metrics: body.metrics,
+        duration_s: body.duration_s,
+        success: body.success ?? true,
+      },
+    ]);
+
+    if (error) {
+      console.error("[Pulse Error]", error);
+    }
+
+    return NextResponse.json({ success: true }, { status: 200 });
+  } catch (error) {
+    return NextResponse.json({ success: false }, { status: 500 });
+  }
+}

package/www/lib/supabase.ts

@@ -0,0 +1,8 @@
+import { createClient } from "@supabase/supabase-js";
+
+const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL || "";
+const supabaseServiceKey = process.env.SUPABASE_SERVICE_ROLE_KEY || "";
+
+// We use service_role key globally for telemetry as it's a server-side only action
+// and bypasses RLS for faster event recording.
+export const supabase = createClient(supabaseUrl, supabaseServiceKey);

package/www/package-lock.json

@@ -1,13 +1,14 @@
 {
-  "name": "landing",
-  "version": "0.1.0",
+  "name": "www",
+  "version": "1.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "landing",
-      "version": "0.1.0",
+      "name": "www",
+      "version": "1.0.0",
       "dependencies": {
+        "@supabase/supabase-js": "^2.90.1",
         "lucide-react": "^0.562.0",
         "next": "^15.1.4",
         "react": "^19.0.0",
@@ -739,6 +740,86 @@
         "node": ">= 10"
       }
     },
+    "node_modules/@supabase/auth-js": {
+      "version": "2.90.1",
+      "resolved": "https://registry.npmjs.org/@supabase/auth-js/-/auth-js-2.90.1.tgz",
+      "integrity": "sha512-vxb66dgo6h3yyPbR06735Ps+dK3hj0JwS8w9fdQPVZQmocSTlKUW5MfxSy99mN0XqCCuLMQ3jCEiIIUU23e9ng==",
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/functions-js": {
+      "version": "2.90.1",
+      "resolved": "https://registry.npmjs.org/@supabase/functions-js/-/functions-js-2.90.1.tgz",
+      "integrity": "sha512-x9mV9dF1Lam9qL3zlpP6mSM5C9iqMPtF5B/tU1Jj/F0ufX5mjDf9ghVBaErVxmrQJRL4+iMKWKY2GnODkpS8tw==",
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/postgrest-js": {
+      "version": "2.90.1",
+      "resolved": "https://registry.npmjs.org/@supabase/postgrest-js/-/postgrest-js-2.90.1.tgz",
+      "integrity": "sha512-jh6vqzaYzoFn3raaC0hcFt9h+Bt+uxNRBSdc7PfToQeRGk7PDPoweHsbdiPWREtDVTGKfu+PyPW9e2jbK+BCgQ==",
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/realtime-js": {
+      "version": "2.90.1",
+      "resolved": "https://registry.npmjs.org/@supabase/realtime-js/-/realtime-js-2.90.1.tgz",
+      "integrity": "sha512-PWbnEMkcQRuor8jhObp4+Snufkq8C6fBp+MchVp2qBPY1NXk/c3Iv3YyiFYVzo0Dzuw4nAlT4+ahuPggy4r32w==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/phoenix": "^1.6.6",
+        "@types/ws": "^8.18.1",
+        "tslib": "2.8.1",
+        "ws": "^8.18.2"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/storage-js": {
+      "version": "2.90.1",
+      "resolved": "https://registry.npmjs.org/@supabase/storage-js/-/storage-js-2.90.1.tgz",
+      "integrity": "sha512-GHY+Ps/K/RBfRj7kwx+iVf2HIdqOS43rM2iDOIDpapyUnGA9CCBFzFV/XvfzznGykd//z2dkGZhlZZprsVFqGg==",
+      "license": "MIT",
+      "dependencies": {
+        "iceberg-js": "^0.8.1",
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/supabase-js": {
+      "version": "2.90.1",
+      "resolved": "https://registry.npmjs.org/@supabase/supabase-js/-/supabase-js-2.90.1.tgz",
+      "integrity": "sha512-U8KaKGLUgTIFHtwEW1dgw1gK7XrdpvvYo7nzzqPx721GqPe8WZbAiLh/hmyKLGBYQ/mmQNr20vU9tWSDZpii3w==",
+      "license": "MIT",
+      "dependencies": {
+        "@supabase/auth-js": "2.90.1",
+        "@supabase/functions-js": "2.90.1",
+        "@supabase/postgrest-js": "2.90.1",
+        "@supabase/realtime-js": "2.90.1",
+        "@supabase/storage-js": "2.90.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
     "node_modules/@swc/helpers": {
       "version": "0.5.15",
       "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.15.tgz",
@@ -1030,12 +1111,17 @@
       "version": "20.19.27",
       "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.27.tgz",
       "integrity": "sha512-N2clP5pJhB2YnZJ3PIHFk5RkygRX5WO/5f0WC08tp0wd+sv0rsJk3MqWn3CbNmT2J505a5336jaQj4ph1AdMug==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "undici-types": "~6.21.0"
       }
     },
+    "node_modules/@types/phoenix": {
+      "version": "1.6.7",
+      "resolved": "https://registry.npmjs.org/@types/phoenix/-/phoenix-1.6.7.tgz",
+      "integrity": "sha512-oN9ive//QSBkf19rfDv45M7eZPi0eEXylht2OLEXicu5b4KoQ1OzXIw+xDSGWxSxe1JmepRR/ZH283vsu518/Q==",
+      "license": "MIT"
+    },
     "node_modules/@types/react": {
       "version": "19.2.7",
       "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.7.tgz",
@@ -1086,6 +1172,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/ws": {
+      "version": "8.18.1",
+      "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz",
+      "integrity": "sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
     "node_modules/@webgpu/types": {
       "version": "0.1.68",
       "resolved": "https://registry.npmjs.org/@webgpu/types/-/types-0.1.68.tgz",
@@ -1174,6 +1269,15 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/iceberg-js": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/iceberg-js/-/iceberg-js-0.8.1.tgz",
+      "integrity": "sha512-1dhVQZXhcHje7798IVM+xoo/1ZdVfzOMIc8/rgVSijRK38EDqOJoGula9N/8ZI5RD8QTxNQtK/Gozpr+qUqRRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
     "node_modules/jiti": {
       "version": "2.6.1",
       "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz",
@@ -1772,8 +1876,28 @@
       "version": "6.21.0",
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
       "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
-      "dev": true,
       "license": "MIT"
+    },
+    "node_modules/ws": {
+      "version": "8.19.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.19.0.tgz",
+      "integrity": "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
     }
   }
 }

package/www/package.json

@@ -1,6 +1,6 @@
 {
   "name": "www",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -8,6 +8,7 @@
     "start": "next start"
   },
   "dependencies": {
+    "@supabase/supabase-js": "^2.90.1",
     "lucide-react": "^0.562.0",
     "next": "^15.1.4",
     "react": "^19.0.0",