flyee 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bruno Santana
+
+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/README.md

@@ -0,0 +1,134 @@
+# Flyee
+
+> AI Agent Framework — 21 specialist agents, 65+ skills, 40+ workflows. All runtimes.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## What is Flyee?
+
+`flyee` is a **runtime-agnostic AI agent framework** that gives your coding assistant superpowers. It works with any AI coding tool — Antigravity, Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, Gemini CLI, and more.
+
+Think of it as a **brain transplant** for your AI assistant: instead of generic responses, your assistant gets structured knowledge about clean code, testing patterns, design systems, security auditing, and 65+ other specialized skills.
+
+## Quick Start
+
+```bash
+# Auto-detect your runtime and install
+npx flyee
+
+# Or specify your runtime
+npx flyee --antigravity    # Gemini / Antigravity
+npx flyee --claude          # Claude Code
+npx flyee --cursor          # Cursor
+npx flyee --copilot         # GitHub Copilot
+npx flyee --codex           # OpenAI Codex
+npx flyee --windsurf        # Windsurf
+npx flyee --gemini          # Gemini CLI
+npx flyee --opencode        # OpenCode
+npx flyee --all             # All detected runtimes
+```
+
+## What You Get
+
+### 🤖 21 Specialist Agents
+
+| Agent | Domain |
+|-------|--------|
+| `orchestrator` | Multi-agent coordination |
+| `frontend-specialist` | Web UI/UX (React, Next.js) |
+| `backend-specialist` | API, databases, server |
+| `mobile-developer` | iOS, Android, React Native, Flutter |
+| `security-auditor` | OWASP, vulnerability scanning |
+| `debugger` | Systematic 4-phase debugging |
+| `project-planner` | Strategic planning |
+| `game-developer` | Game development |
+| ... and 13 more | Various domains |
+
+### 🧩 65+ Modular Skills
+
+Skills are knowledge modules that enhance your agent's capabilities:
+
+- **Clean Code** — Pragmatic standards, no over-engineering
+- **Testing Patterns** — Unit, integration, E2E strategies
+- **Design System Enforcement** — Token-based UI consistency
+- **SEO Fundamentals** — Core Web Vitals, E-E-A-T
+- **State Machine** — Local project state with crash recovery
+- **Verification Gate** — Mechanical verification (not vibes)
+- **Cost Tracking** — LLM usage monitoring per operation
+- ... and 58 more
+
+### 🔄 40+ Automated Workflows
+
+```bash
+/new-task          # Add features with tracking
+/execute           # Execute tasks (manual or autonomous)
+/task-complete     # Complete with verification gates
+/debug             # Systematic debugging
+/deploy            # Production deployment
+/test              # Test generation and execution
+/plan              # Strategic planning
+/tdd               # Test-Driven Development cycle
+```
+
+## Architecture
+
+```
+your-project/
+├── .agent/              ← Installed by flyee (runtime-specific)
+│   ├── agents/          ← 21 specialist agents
+│   ├── skills/          ← 65+ modular skills  
+│   ├── workflows/       ← 40+ automated workflows
+│   ├── scripts/         ← Automation scripts
+│   └── bridge/          ← Optional: Flyee SaaS sync
+├── .flyee/              ← Runtime state (auto-created)
+│   ├── STATE.md         ← "Where am I?" dashboard
+│   ├── DECISIONS.md     ← Append-only decision log
+│   └── sprints/         ← Work hierarchy
+├── GEMINI.md            ← Engine file (or CLAUDE.md, etc.)
+└── your code...
+```
+
+## Optional: Flyee SaaS Integration
+
+Connect to the [Flyee Platform](https://flyee.dev) for team collaboration:
+
+```bash
+# Configure connection
+npx flyee --connect <api-key>
+```
+
+When connected, you get:
+- 📊 Team dashboard with project progress
+- 🔄 Task sync across team members
+- 💰 Cost analytics and budget tracking
+- 📈 Gantt visualization of project timeline
+- 🎯 OKR management and alignment
+
+Without SaaS, `flyee` works **100% offline** with local state in `.flyee/`.
+
+## Supported Runtimes
+
+| Runtime | Status | Config Dir | Engine File |
+|---------|--------|-----------|-------------|
+| Antigravity (Gemini) | ✅ | `.agent/` | `GEMINI.md` |
+| Claude Code | ✅ | `.claude/` | `CLAUDE.md` |
+| Cursor | ✅ | `.cursor/` | `.cursorrules` |
+| GitHub Copilot | ✅ | `.github/` | `COPILOT.md` |
+| OpenAI Codex | ✅ | `.codex/` | `CODEX.md` |
+| Windsurf | ✅ | `.windsurf/` | `WINDSURF.md` |
+| Gemini CLI | ✅ | `.gemini/` | `GEMINI.md` |
+| OpenCode | ✅ | `.opencode/` | `OPENCODE.md` |
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built with ❤️ by [Bruno Santana](https://github.com/BrunoSantanaDeveloper)

package/bin/install.js

@@ -0,0 +1,357 @@
+#!/usr/bin/env node
+
+/**
+ * Flyee Installer
+ * 
+ * Installs the flyee agent framework into any project.
+ * Supports multiple AI coding runtimes.
+ * 
+ * Usage:
+ *   npx flyee                    # Auto-detect runtime
+ *   npx flyee --antigravity      # Install for Antigravity/Gemini
+ *   npx flyee --claude           # Install for Claude Code
+ *   npx flyee --cursor           # Install for Cursor
+ *   npx flyee --copilot          # Install for GitHub Copilot
+ *   npx flyee --codex            # Install for OpenAI Codex
+ *   npx flyee --windsurf         # Install for Windsurf
+ *   npx flyee --gemini           # Install for Gemini CLI
+ *   npx flyee --opencode         # Install for OpenCode
+ *   npx flyee --all              # Install for all detected runtimes
+ *   npx flyee --dry-run          # Preview without writing files
+ */
+
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs';
+import { join, dirname, resolve, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PACKAGE_ROOT = resolve(__dirname, '..');
+const CORE_DIR = join(PACKAGE_ROOT, 'core');
+const ENGINE_FILES_DIR = join(PACKAGE_ROOT, 'engine-files');
+const ADAPTERS_DIR = join(PACKAGE_ROOT, 'runtime-adapters');
+
+// ─── Runtime Definitions ────────────────────────────────────────────────────
+
+const RUNTIMES = {
+  antigravity: {
+    name: 'Antigravity (Gemini)',
+    dirName: '.agent',
+    engineFile: 'GEMINI.md',
+    engineFileTarget: 'GEMINI.md',  // where to place in project root
+    detectFiles: ['GEMINI.md', '.agent/ARCHITECTURE.md'],
+    adapterFile: 'antigravity.js',
+  },
+  claude: {
+    name: 'Claude Code',
+    dirName: '.claude',
+    engineFile: 'CLAUDE.md',
+    engineFileTarget: 'CLAUDE.md',
+    detectFiles: ['CLAUDE.md', '.claude/settings.json'],
+    adapterFile: 'claude.js',
+  },
+  cursor: {
+    name: 'Cursor',
+    dirName: '.cursor',
+    engineFile: 'CURSOR.md',
+    engineFileTarget: '.cursorrules',
+    detectFiles: ['.cursorrules', '.cursor/settings.json'],
+    adapterFile: 'cursor.js',
+  },
+  copilot: {
+    name: 'GitHub Copilot',
+    dirName: '.github',
+    engineFile: 'COPILOT.md',
+    engineFileTarget: '.github/copilot-instructions.md',
+    detectFiles: ['.github/copilot-instructions.md'],
+    adapterFile: 'copilot.js',
+  },
+  codex: {
+    name: 'OpenAI Codex',
+    dirName: '.codex',
+    engineFile: 'CODEX.md',
+    engineFileTarget: 'AGENTS.md',
+    detectFiles: ['AGENTS.md', 'codex.json'],
+    adapterFile: 'codex.js',
+  },
+  windsurf: {
+    name: 'Windsurf',
+    dirName: '.windsurf',
+    engineFile: 'WINDSURF.md',
+    engineFileTarget: '.windsurfrules',
+    detectFiles: ['.windsurfrules', '.windsurf/settings.json'],
+    adapterFile: 'windsurf.js',
+  },
+  gemini: {
+    name: 'Gemini CLI',
+    dirName: '.gemini',
+    engineFile: 'GEMINI.md',
+    engineFileTarget: 'GEMINI.md',
+    detectFiles: ['GEMINI.md', '.gemini/settings.json'],
+    adapterFile: 'gemini-cli.js',
+  },
+  opencode: {
+    name: 'OpenCode',
+    dirName: '.opencode',
+    engineFile: 'OPENCODE.md',
+    engineFileTarget: 'INSTRUCTIONS.md',
+    detectFiles: ['INSTRUCTIONS.md', 'opencode.json'],
+    adapterFile: 'opencode.js',
+  },
+};
+
+// ─── CLI Argument Parsing ───────────────────────────────────────────────────
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const flags = {
+    runtimes: [],
+    dryRun: false,
+    all: false,
+    help: false,
+    projectDir: process.cwd(),
+  };
+
+  for (const arg of args) {
+    if (arg === '--help' || arg === '-h') flags.help = true;
+    else if (arg === '--dry-run') flags.dryRun = true;
+    else if (arg === '--all') flags.all = true;
+    else if (arg.startsWith('--')) {
+      const runtime = arg.slice(2);
+      if (RUNTIMES[runtime]) flags.runtimes.push(runtime);
+      else {
+        console.error(`❌ Unknown runtime: ${runtime}`);
+        console.error(`   Available: ${Object.keys(RUNTIMES).join(', ')}`);
+        process.exit(1);
+      }
+    }
+  }
+
+  return flags;
+}
+
+function printHelp() {
+  console.log(`
+  Flyee — AI Agent Framework Installer
+
+  Usage:
+    npx flyee [options]
+
+  Options:
+    --antigravity    Install for Antigravity (Gemini)
+    --claude         Install for Claude Code
+    --cursor         Install for Cursor
+    --copilot        Install for GitHub Copilot
+    --codex          Install for OpenAI Codex
+    --windsurf       Install for Windsurf
+    --gemini         Install for Gemini CLI
+    --opencode       Install for OpenCode
+    --all            Install for all detected runtimes
+    --dry-run        Preview without writing files
+    -h, --help       Show this help message
+
+  Examples:
+    npx flyee                  # Auto-detect & install
+    npx flyee --claude         # Install for Claude Code
+    npx flyee --claude --cursor  # Install for both
+  `);
+}
+
+// ─── Runtime Detection ──────────────────────────────────────────────────────
+
+function detectRuntimes(projectDir) {
+  const detected = [];
+
+  for (const [key, config] of Object.entries(RUNTIMES)) {
+    for (const file of config.detectFiles) {
+      if (existsSync(join(projectDir, file))) {
+        detected.push(key);
+        break;
+      }
+    }
+  }
+
+  return detected;
+}
+
+// ─── Content Conversion ─────────────────────────────────────────────────────
+
+/**
+ * Load a runtime adapter module.
+ * Each adapter exports a convert(content, config) function that transforms
+ * canonical content (using .agent/ paths) to runtime-specific content.
+ */
+async function loadAdapter(runtimeKey) {
+  const config = RUNTIMES[runtimeKey];
+  const adapterPath = join(ADAPTERS_DIR, config.adapterFile);
+
+  if (!existsSync(adapterPath)) {
+    console.warn(`⚠️  Adapter not found for ${config.name}: ${config.adapterFile}`);
+    console.warn(`   Will install canonical content without conversion.`);
+    return null;
+  }
+
+  return await import(adapterPath);
+}
+
+/**
+ * Convert canonical content to runtime-specific format.
+ * Canonical format uses .agent/ paths — adapters transform these.
+ */
+function convertContent(content, adapter, runtimeConfig) {
+  if (!adapter || !adapter.convert) return content;
+  return adapter.convert(content, runtimeConfig);
+}
+
+// ─── File Operations ────────────────────────────────────────────────────────
+
+function copyDirRecursive(src, dest, adapter, runtimeConfig, dryRun, stats) {
+  const entries = readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      if (!dryRun) mkdirSync(destPath, { recursive: true });
+      copyDirRecursive(srcPath, destPath, adapter, runtimeConfig, dryRun, stats);
+    } else {
+      stats.files++;
+      const content = readFileSync(srcPath, 'utf-8');
+      const converted = (entry.name.endsWith('.md') || entry.name.endsWith('.py'))
+        ? convertContent(content, adapter, runtimeConfig)
+        : content;
+
+      if (dryRun) {
+        const rel = relative(process.cwd(), destPath);
+        console.log(`  📄 ${rel}`);
+      } else {
+        mkdirSync(dirname(destPath), { recursive: true });
+        writeFileSync(destPath, converted, 'utf-8');
+      }
+    }
+  }
+}
+
+// ─── Installation ───────────────────────────────────────────────────────────
+
+async function installForRuntime(runtimeKey, projectDir, dryRun) {
+  const config = RUNTIMES[runtimeKey];
+  const targetDir = join(projectDir, config.dirName);
+  const stats = { files: 0 };
+
+  console.log(`\n🔧 Installing for ${config.name}...`);
+  console.log(`   Target: ${config.dirName}/`);
+
+  // Load adapter
+  const adapter = await loadAdapter(runtimeKey);
+
+  // Create target directory
+  if (!dryRun) mkdirSync(targetDir, { recursive: true });
+
+  // Copy core content
+  const coreDirs = ['agents', 'skills', 'workflows', 'scripts', 'templates'];
+  for (const dir of coreDirs) {
+    const srcDir = join(CORE_DIR, dir);
+    if (!existsSync(srcDir)) continue;
+
+    const destDir = join(targetDir, dir);
+    if (!dryRun) mkdirSync(destDir, { recursive: true });
+    copyDirRecursive(srcDir, destDir, adapter, config, dryRun, stats);
+  }
+
+  // Copy bridge (as flyee-bridge/ subdirectory)
+  const bridgeSrc = join(PACKAGE_ROOT, 'bridge');
+  const bridgeDest = join(targetDir, 'flyee-bridge');
+  if (existsSync(bridgeSrc)) {
+    if (!dryRun) mkdirSync(bridgeDest, { recursive: true });
+    copyDirRecursive(bridgeSrc, bridgeDest, adapter, config, dryRun, stats);
+  }
+
+  // Generate engine file (always use GEMINI.md as canonical source, adapter converts)
+  const engineFileSrc = join(ENGINE_FILES_DIR, 'GEMINI.md');
+  const engineFileDest = join(projectDir, config.engineFileTarget);
+
+  if (existsSync(engineFileSrc)) {
+    if (dryRun) {
+      console.log(`  📄 ${config.engineFileTarget}`);
+    } else {
+      const engineContent = readFileSync(engineFileSrc, 'utf-8');
+      const converted = convertContent(engineContent, adapter, config);
+      mkdirSync(dirname(engineFileDest), { recursive: true });
+      writeFileSync(engineFileDest, converted, 'utf-8');
+    }
+    stats.files++;
+  } else {
+    console.warn(`⚠️  Engine file source not found: ${engineFileSrc}`);
+  }
+
+  console.log(`   ✅ ${stats.files} files ${dryRun ? 'would be' : ''} installed`);
+  return stats;
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────────
+
+async function main() {
+  const flags = parseArgs();
+
+  if (flags.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  console.log(`
+  ╔═══════════════════════════════════════╗
+  ║          flyee installer              ║
+  ║   AI Agent Framework — All Runtimes   ║
+  ╚═══════════════════════════════════════╝
+  `);
+
+  const projectDir = flags.projectDir;
+  console.log(`📁 Project: ${projectDir}`);
+
+  // Determine which runtimes to install
+  let targetRuntimes = flags.runtimes;
+
+  if (flags.all) {
+    targetRuntimes = Object.keys(RUNTIMES);
+    console.log(`🌐 Installing for ALL runtimes`);
+  } else if (targetRuntimes.length === 0) {
+    // Auto-detect
+    const detected = detectRuntimes(projectDir);
+    if (detected.length > 0) {
+      console.log(`🔍 Auto-detected runtimes: ${detected.map(r => RUNTIMES[r].name).join(', ')}`);
+      targetRuntimes = detected;
+    } else {
+      console.log(`🔍 No runtime detected. Installing for Antigravity (default).`);
+      targetRuntimes = ['antigravity'];
+    }
+  }
+
+  if (flags.dryRun) {
+    console.log(`\n🏜️  DRY RUN — no files will be written\n`);
+  }
+
+  let totalFiles = 0;
+
+  for (const runtime of targetRuntimes) {
+    const stats = await installForRuntime(runtime, projectDir, flags.dryRun);
+    totalFiles += stats.files;
+  }
+
+  console.log(`\n${'═'.repeat(45)}`);
+  console.log(`✨ Done! ${totalFiles} files ${flags.dryRun ? 'would be' : ''} installed for ${targetRuntimes.length} runtime(s).`);
+
+  if (!flags.dryRun) {
+    console.log(`\n📋 Next steps:`);
+    console.log(`   1. Open your AI coding assistant`);
+    console.log(`   2. It will automatically detect the flyee framework`);
+    console.log(`   3. Try: "explain the project structure"`);
+    console.log(`\n💡 Optional: Connect to Flyee SaaS with 'npx flyee --connect <api-key>'`);
+  }
+}
+
+main().catch((err) => {
+  console.error(`\n❌ Installation failed:`, err.message);
+  process.exit(1);
+});