hybard-agent 0.1.0

package/lib/agent.js

@@ -0,0 +1,730 @@
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { spawnSync } = require('child_process');
+const { HybardAI } = require('./online');
+
+const CONFIG_FILE = path.join(process.cwd(), 'hybard.config.json');
+const DEFAULT_CONFIG = {
+  preferredLanguage: 'node',
+  includeTests: true,
+  codeStyle: 'simple',
+  useLocalModel: true,
+};
+
+const IGNORE_PATHS = ['node_modules', '.git', '__pycache__', '.vscode'];
+const IGNORE_FILES = ['hybard_model.pth', 'dataset.txt'];
+
+function loadConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) return DEFAULT_CONFIG;
+  try {
+    const raw = fs.readFileSync(CONFIG_FILE, 'utf8');
+    const config = JSON.parse(raw);
+    return { ...DEFAULT_CONFIG, ...config };
+  } catch (err) {
+    console.error(`Failed to read config ${CONFIG_FILE}: ${err.message}`);
+    return DEFAULT_CONFIG;
+  }
+}
+
+function saveConfig(config) {
+  safeWriteFile(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+}
+
+function askQuestion(message, defaultValue) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const prompt = defaultValue ? `${message} [${defaultValue}]: ` : `${message}: `;
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim() || defaultValue);
+    });
+  });
+}
+
+async function promptInitConfig() {
+  console.log('Initializing Hybard config...');
+  const preferredLanguage = await askQuestion('Preferred project language (node/python/web)', 'node');
+  const includeTestsInput = await askQuestion('Include a test scaffold? (yes/no)', 'yes');
+  const codeStyle = await askQuestion('Preferred code style (simple/advanced)', 'simple');
+  const useLocalModelInput = await askQuestion('Use local model.py for repairs? (yes/no)', 'yes');
+
+  const includeTests = includeTestsInput.toLowerCase().startsWith('y');
+  const useLocalModel = useLocalModelInput.toLowerCase().startsWith('y');
+  const language = ['python', 'node', 'web'].includes(preferredLanguage.toLowerCase())
+    ? preferredLanguage.toLowerCase()
+    : 'node';
+
+  const config = {
+    preferredLanguage: language,
+    includeTests,
+    codeStyle: codeStyle.toLowerCase() === 'advanced' ? 'advanced' : 'simple',
+    useLocalModel,
+  };
+
+  saveConfig(config);
+  console.log(`Saved configuration to ${CONFIG_FILE}`);
+  return config;
+}
+
+function scanProjectFiles(dir, root = dir) {
+  const files = [];
+  try {
+    for (const name of fs.readdirSync(dir)) {
+      if (IGNORE_PATHS.includes(name) || name.startsWith('.')) continue;
+      const fullPath = path.join(dir, name);
+      const stat = fs.statSync(fullPath);
+      if (stat.isDirectory()) {
+        files.push(...scanProjectFiles(fullPath, root));
+      } else {
+        const relative = path.relative(root, fullPath);
+        if (IGNORE_FILES.includes(relative) || IGNORE_FILES.includes(name)) continue;
+        files.push(relative);
+      }
+    }
+  } catch (err) {
+    // ignore unreadable directories
+  }
+  return files;
+}
+
+function detectProjectType(goal, config = DEFAULT_CONFIG) {
+  const text = goal.toLowerCase();
+  if (text.includes('flutter') || text.includes('dart')) return 'flutter';
+  if (text.includes('react') || text.includes('reactjs')) return 'react';
+  if (text.includes('landing page') || text.includes('landing') || text.includes('tailwind') || (text.includes('html') && text.includes('css')) || text.includes('website') || text.includes('frontend')) return 'html';
+  if (text.includes('django') || text.includes('dejano')) return 'django';
+  if (text.includes('python') || text.includes('flask')) return 'python';
+  if (text.includes('node') || text.includes('javascript') || text.includes('express') || text.includes('npm')) return 'node';
+  return config.preferredLanguage || 'node';
+}
+
+function createProject(goal, config) {
+  const type = detectProjectType(goal, config);
+  console.log(`Detected project type: ${type}`);
+
+  switch (type) {
+    case 'django':
+      createDjangoProject(goal, config);
+      break;
+    case 'python':
+      createPythonProject(goal, config);
+      break;
+    case 'flutter':
+      createFlutterProject(goal, config);
+      break;
+    case 'react':
+      createReactProject(goal, config);
+      break;
+    case 'html':
+      createHtmlCssProject(goal, config);
+      break;
+    case 'web':
+      createWebProject(goal, config);
+      break;
+    default:
+      createNodeProject(goal, config);
+      break;
+  }
+}
+
+function safeWriteFile(filePath, content) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(filePath, content, 'utf8');
+  console.log(`Created ${path.relative(process.cwd(), filePath)}`);
+}
+
+function backupFile(filePath) {
+  const backupPath = `${filePath}.hybard.bak`;
+  if (!fs.existsSync(backupPath)) {
+    fs.copyFileSync(filePath, backupPath);
+    console.log(`Backed up ${path.relative(process.cwd(), filePath)} to ${path.relative(process.cwd(), backupPath)}`);
+  }
+}
+
+function commandExists(command) {
+  const check = process.platform === 'win32'
+    ? spawnSync('where', [command], { encoding: 'utf8' })
+    : spawnSync('command', ['-v', command], { encoding: 'utf8' });
+  return check.status === 0;
+}
+
+function runCommand(command, args, options = {}) {
+  console.log(`Running: ${command} ${args.join(' ')}`);
+  const isWindows = process.platform === 'win32';
+  const result = spawnSync(command, args, {
+    encoding: 'utf8',
+    cwd: process.cwd(),
+    stdio: 'inherit',
+    shell: isWindows, // Use shell on Windows to find .cmd files
+    ...options,
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`${command} exited with code ${result.status}`);
+  }
+  return result;
+}
+
+function runLocalModel(prompt) {
+  const modelPath = path.join(__dirname, '..', 'model.py');
+  const pythonCmd = commandExists('python') ? 'python' : commandExists('python3') ? 'python3' : null;
+  if (!pythonCmd) {
+    throw new Error('Python is not available on PATH. Please install Python to run the local model.');
+  }
+
+  const result = spawnSync(pythonCmd, [modelPath, prompt], {
+    encoding: 'utf8',
+    cwd: process.cwd(),
+    maxBuffer: 1024 * 1024,
+  });
+
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(result.stderr || result.stdout || `model.py exited with code ${result.status}`);
+  }
+  return result.stdout;
+}
+
+function installDependencies() {
+  if (fs.existsSync(path.join(process.cwd(), 'package.json'))) {
+    console.log('Detected Node project. Installing npm dependencies...');
+    if (!commandExists('npm')) {
+      console.error('npm is not available on PATH. Please install Node.js and npm first.');
+      console.error('Then run `npm install -g .` from this repository to make `hybard` available globally.');
+      return;
+    }
+    // Use npm.cmd on Windows for proper execution
+    const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const result = spawnSync(npmCmd, ['install'], {
+      encoding: 'utf8',
+      cwd: process.cwd(),
+      stdio: 'inherit',
+    });
+    if (result.error) {
+      console.error(`Failed to run npm install: ${result.error.message}`);
+    } else if (result.status !== 0) {
+      console.error(`npm install exited with code ${result.status}`);
+    }
+    return;
+  }
+
+  if (fs.existsSync(path.join(process.cwd(), 'pyproject.toml')) || fs.existsSync(path.join(process.cwd(), 'requirements.txt'))) {
+    console.log('Detected Python project. Installing pip dependencies...');
+    const pythonCmd = commandExists('python') ? 'python' : commandExists('python3') ? 'python3' : null;
+    if (!pythonCmd) {
+      console.error('Python is not available on PATH. Install Python before running dependency installation.');
+      return;
+    }
+
+    if (fs.existsSync(path.join(process.cwd(), 'requirements.txt'))) {
+      runCommand(pythonCmd, ['-m', 'pip', 'install', '-r', 'requirements.txt']);
+    } else {
+      runCommand(pythonCmd, ['-m', 'pip', 'install', '.']);
+    }
+    return;
+  }
+
+  console.log('No known dependency manifest found. Nothing to install.');
+}
+
+function getFileType(filePath) {
+  if (filePath.endsWith('.py')) return 'python';
+  if (filePath.endsWith('.js')) return 'javascript';
+  return 'text';
+}
+
+function runSyntaxCheck(filePath) {
+  const absPath = path.join(process.cwd(), filePath);
+  if (filePath.endsWith('.py')) {
+    const result = spawnSync('python', ['-m', 'py_compile', absPath], {
+      encoding: 'utf8',
+      maxBuffer: 1024 * 1024,
+    });
+    return {
+      file: filePath,
+      ok: result.status === 0,
+      error: result.stderr || result.stdout,
+    };
+  }
+
+  if (filePath.endsWith('.js')) {
+    const result = spawnSync('node', ['--check', absPath], {
+      encoding: 'utf8',
+      maxBuffer: 1024 * 1024,
+    });
+    return {
+      file: filePath,
+      ok: result.status === 0,
+      error: result.stderr || result.stdout,
+    };
+  }
+
+  return { file: filePath, ok: true, error: '' };
+}
+
+function createNodeProject(goal, config) {
+  const pkg = {
+    name: path.basename(process.cwd()),
+    version: '0.1.0',
+    description: `Hybard-generated project for: ${goal}`,
+    main: 'src/index.js',
+    scripts: {
+      start: 'node src/index.js',
+      dev: 'node src/index.js',
+    },
+    license: 'MIT',
+  };
+
+  safeWriteFile(path.join(process.cwd(), 'package.json'), JSON.stringify(pkg, null, 2) + '\n');
+  safeWriteFile(path.join(process.cwd(), '.gitignore'), 'node_modules\n*.log\n*.hybard.bak\n');
+  safeWriteFile(path.join(process.cwd(), 'README.md'), `# ${pkg.name}\n\nGenerated by Hybard.\n\nTask: ${goal}\n`);
+  safeWriteFile(path.join(process.cwd(), 'src', 'index.js'), `const tasks = [];
+
+function listTasks() {
+  console.log('Tasks:', tasks);
+}
+
+function addTask(title) {
+  tasks.push({ title, done: false });
+  console.log('Added task:', title);
+}
+
+addTask('Example task');
+listTasks();
+`);
+
+  if (config.includeTests) {
+    safeWriteFile(path.join(process.cwd(), 'src', 'index.test.js'), `const { describe, it } = require('node:test');
+
+describe('basic example', () => {
+  it('runs successfully', () => {
+    const value = 1 + 1;
+    if (value !== 2) throw new Error('Math failed');
+  });
+});
+`);
+  }
+}
+
+function createPythonProject(goal, config) {
+  safeWriteFile(path.join(process.cwd(), 'pyproject.toml'), `[build-system]\nrequires = ["setuptools>=42", "wheel"]\nbuild-backend = "setuptools.build_meta"\n\n[project]\nname = "${path.basename(process.cwd())}"\nversion = "0.1.0"\ndescription = "Hybard-generated project for: ${goal}"\nlicense = { file = "LICENSE" }\n\n[project.scripts]\nstart = "python main.py"\n`);
+  safeWriteFile(path.join(process.cwd(), 'README.md'), `# ${path.basename(process.cwd())}\n\nGenerated by Hybard.\n\nTask: ${goal}\n`);
+  safeWriteFile(path.join(process.cwd(), '.gitignore'), '__pycache__/\n*.pyc\n*.hybard.bak\n');
+  safeWriteFile(path.join(process.cwd(), 'main.py'), `def main():\n    print('Hybard project created for: ${goal}')\n\nif __name__ == '__main__':\n    main()\n`);
+
+  if (config.includeTests) {
+    safeWriteFile(path.join(process.cwd(), 'test_main.py'), `def test_main_runs():\n    assert True\n`);
+  }
+}
+
+function createDjangoProject(goal, config) {
+  const projectName = path.basename(process.cwd()).replace(/[-\s]/g, '_').toLowerCase() || 'hybard_django';
+  safeWriteFile(path.join(process.cwd(), 'requirements.txt'), 'Django>=4.2\n');
+  safeWriteFile(path.join(process.cwd(), '.gitignore'), '__pycache__/\n*.pyc\n*.db\n*.log\n*.hybard.bak\n');
+  safeWriteFile(path.join(process.cwd(), 'README.md'), `# ${projectName}\n\nGenerated by Hybard Django scaffold.\n\nTask: ${goal}\n`);
+  safeWriteFile(path.join(process.cwd(), 'manage.py'), `#!/usr/bin/env python\nimport os\nimport sys\n\nif __name__ == '__main__':\n    os.environ.setdefault('DJANGO_SETTINGS_MODULE', '${projectName}.settings')\n    try:\n        from django.core.management import execute_from_command_line\n    except ImportError as exc:\n        raise ImportError('Django is not installed.') from exc\n    execute_from_command_line(sys.argv)\n`);
+  safeWriteFile(path.join(process.cwd(), projectName, '__init__.py'), '');
+  safeWriteFile(path.join(process.cwd(), projectName, 'settings.py'), `from pathlib import Path\n\nBASE_DIR = Path(__file__).resolve().parent.parent\n\nSECRET_KEY = 'hybard-django-secret-key'\nDEBUG = True\nALLOWED_HOSTS = []\n\nINSTALLED_APPS = [\n    'django.contrib.admin',\n    'django.contrib.auth',\n    'django.contrib.contenttypes',\n    'django.contrib.sessions',\n    'django.contrib.messages',\n    'django.contrib.staticfiles',\n    'app',\n]\n\nMIDDLEWARE = [\n    'django.middleware.security.SecurityMiddleware',\n    'django.contrib.sessions.middleware.SessionMiddleware',\n    'django.middleware.common.CommonMiddleware',\n    'django.middleware.csrf.CsrfViewMiddleware',\n    'django.contrib.auth.middleware.AuthenticationMiddleware',\n    'django.contrib.messages.middleware.MessageMiddleware',\n    'django.middleware.clickjacking.XFrameOptionsMiddleware',\n]\n\nROOT_URLCONF = '${projectName}.urls'\n\nTEMPLATES = [\n    {\n        'BACKEND': 'django.template.backends.django.DjangoTemplates',\n        'DIRS': [BASE_DIR / 'templates'],\n        'APP_DIRS': True,\n        'OPTIONS': {\n            'context_processors': [\n                'django.template.context_processors.debug',\n                'django.template.context_processors.request',\n                'django.contrib.auth.context_processors.auth',\n                'django.contrib.messages.context_processors.messages',\n            ],\n        },\n    },\n]\n\nWSGI_APPLICATION = '${projectName}.wsgi.application'\n\nDATABASES = {\n    'default': {\n        'ENGINE': 'django.db.backends.sqlite3',\n        'NAME': BASE_DIR / 'db.sqlite3',\n    }\n}\n\nAUTH_PASSWORD_VALIDATORS = []\n\nLANGUAGE_CODE = 'en-us'\nTIME_ZONE = 'UTC'\nUSE_I18N = True\nUSE_TZ = True\n\nSTATIC_URL = '/static/'\n`);
+  safeWriteFile(path.join(process.cwd(), projectName, 'urls.py'), `from django.contrib import admin\nfrom django.urls import path, include\n\nurlpatterns = [\n    path('admin/', admin.site.urls),\n    path('', include('app.urls')),\n]\n`);
+  safeWriteFile(path.join(process.cwd(), projectName, 'wsgi.py'), `import os\n\nfrom django.core.wsgi import get_wsgi_application\n\nos.environ.setdefault('DJANGO_SETTINGS_MODULE', '${projectName}.settings')\n\napplication = get_wsgi_application()\n`);
+  safeWriteFile(path.join(process.cwd(), 'app', '__init__.py'), '');
+  safeWriteFile(path.join(process.cwd(), 'app', 'apps.py'), `from django.apps import AppConfig\n\nclass AppConfig(AppConfig):\n    default_auto_field = 'django.db.models.BigAutoField'\n    name = 'app'\n`);
+  safeWriteFile(path.join(process.cwd(), 'app', 'models.py'), 'from django.db import models\n\n# Create your models here.\n');
+  safeWriteFile(path.join(process.cwd(), 'app', 'views.py'), `from django.http import HttpResponse\n\ndef home(request):\n    return HttpResponse('Hello from Hybard Django app!')\n`);
+  safeWriteFile(path.join(process.cwd(), 'app', 'urls.py'), `from django.urls import path\nfrom .views import home\n\nurlpatterns = [\n    path('', home, name='home'),\n]\n`);
+  safeWriteFile(path.join(process.cwd(), 'templates', 'base.html'), `<!DOCTYPE html>\n<html lang="en">\n<head>\n  <meta charset="UTF-8">\n  <meta name="viewport" content="width=device-width, initial-scale=1.0">\n  <title>${projectName}</title>\n</head>\n<body>\n  <h1>Hybard Django App</h1>\n  <p>${goal}</p>\n</body>\n</html>\n`);
+}
+
+function createReactProject(goal, config) {
+  const pkg = {
+    name: path.basename(process.cwd()),
+    version: '0.1.0',
+    private: true,
+    description: `Hybard-generated React app for: ${goal}`,
+    scripts: {
+      dev: 'npx vite',
+      build: 'npx vite build',
+      preview: 'npx vite preview'
+    },
+    dependencies: {
+      react: '^18.2.0',
+      'react-dom': '^18.2.0'
+    },
+    devDependencies: {
+      vite: '^5.0.0',
+      '@vitejs/plugin-react': '^4.0.0'
+    }
+  };
+
+  safeWriteFile(path.join(process.cwd(), 'package.json'), JSON.stringify(pkg, null, 2) + '\n');
+  safeWriteFile(path.join(process.cwd(), '.gitignore'), 'node_modules\ndist\n*.log\n*.hybard.bak\n');
+  safeWriteFile(path.join(process.cwd(), 'README.md'), `# ${pkg.name}\n\nGenerated by Hybard React scaffold.\n\nTask: ${goal}\n`);
+  safeWriteFile(path.join(process.cwd(), 'index.html'), `<!DOCTYPE html>\n<html lang="en">\n<head>\n  <meta charset="UTF-8">\n  <meta name="viewport" content="width=device-width, initial-scale=1.0">\n  <title>${pkg.name}</title>\n</head>\n<body>\n  <div id="root"></div>\n  <script type="module" src="src/main.jsx"></script>\n</body>\n</html>\n`);
+  safeWriteFile(path.join(process.cwd(), 'src', 'main.jsx'), `import React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport App from './App';\nimport './style.css';\n\nReactDOM.createRoot(document.getElementById('root')).render(\n  <React.StrictMode>\n    <App />\n  </React.StrictMode>\n);\n`);
+  safeWriteFile(path.join(process.cwd(), 'src', 'App.jsx'), `export default function App() {\n  return (\n    <div className=\"app\">\n      <h1>Hybard React App</h1>\n      <p>${goal}</p>\n    </div>\n  );\n}\n`);
+  safeWriteFile(path.join(process.cwd(), 'src', 'style.css'), `body {\n  font-family: Arial, sans-serif;\n  margin: 0;\n  padding: 2rem;\n  background: #f5f7fb;\n}\n.app {\n  max-width: 720px;\n  margin: auto;\n  background: white;\n  border-radius: 16px;\n  padding: 2rem;\n  box-shadow: 0 10px 30px rgba(0,0,0,0.08);\n}\n`);
+}
+
+function createFlutterProject(goal, config) {
+  safeWriteFile(path.join(process.cwd(), 'pubspec.yaml'), `name: ${path.basename(process.cwd())}\ndescription: A new Flutter project generated by Hybard.\npublish_to: 'none'\nversion: 0.1.0+1\nenvironment:\n  sdk: '>=2.19.0 <3.0.0'\ndependencies:\n  flutter:\n    sdk: flutter\n  cupertino_icons: ^1.0.5\n\ndev_dependencies:\n  flutter_test:\n    sdk: flutter\n\nflutter:\n  uses-material-design: true\n`);
+  safeWriteFile(path.join(process.cwd(), '.gitignore'), '.dart_tool/\n.packages\n.buildlog\n.dart_tool/\n.flutter-plugins\n.flutter-plugins-dependencies\n.idea/\n.vs/\n*.iml\nbuild/\n.DS_Store\n');
+  safeWriteFile(path.join(process.cwd(), 'README.md'), `# ${path.basename(process.cwd())}\n\nGenerated by Hybard Flutter scaffold.\n\nTask: ${goal}\n`);
+  safeWriteFile(path.join(process.cwd(), 'lib', 'main.dart'), `import 'package:flutter/material.dart';\n\nvoid main() {\n  runApp(const MyApp());\n}\n\nclass MyApp extends StatelessWidget {\n  const MyApp({super.key});\n\n  @override\n  Widget build(BuildContext context) {\n    return MaterialApp(\n      title: '${path.basename(process.cwd())}',\n      theme: ThemeData(primarySwatch: Colors.blue),\n      home: const HomeScreen(),\n    );\n  }\n}\n\nclass HomeScreen extends StatelessWidget {\n  const HomeScreen({super.key});\n\n  @override\n  Widget build(BuildContext context) {\n    return Scaffold(\n      appBar: AppBar(title: const Text('Hybard Flutter App')),\n      body: const Center(\n        child: Text('Generated app for: ${goal}'),\n      ),\n    );\n  }\n}\n`);
+}
+
+function createHtmlCssProject(goal, config) {
+  safeWriteFile(path.join(process.cwd(), 'index.html'), `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${path.basename(process.cwd())}</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <header class="hero">
+    <div class="hero__content">
+      <p class="eyebrow">Landing page</p>
+      <h1>${path.basename(process.cwd())}</h1>
+      <p>${goal}</p>
+      <a class="cta" href="#features">Get started</a>
+    </div>
+  </header>
+  <main>
+    <section id="features" class="features">
+      <article>
+        <h2>Responsive design</h2>
+        <p>Built with HTML, CSS, and JavaScript for a polished landing page.</p>
+      </article>
+      <article>
+        <h2>Modern layout</h2>
+        <p>Clean, mobile-friendly sections with a strong first impression.</p>
+      </article>
+      <article>
+        <h2>Easy interaction</h2>
+        <p>Includes a CTA button and smooth scroll behavior.</p>
+      </article>
+    </section>
+  </main>
+  <footer>
+    <p>Generated by Hybard.</p>
+  </footer>
+  <script src="script.js"></script>
+</body>
+</html>
+`);
+  safeWriteFile(path.join(process.cwd(), 'style.css'), `:root {
+  font-family: Inter, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  background: #f8fafc;
+  color: #0f172a;
+  line-height: 1.6;
+  margin: 0;
+}
+*, *::before, *::after {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+}
+.hero {
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+  padding: 4rem 1.5rem;
+  text-align: center;
+  background: linear-gradient(135deg, #2563eb 0%, #0ea5e9 100%);
+  color: white;
+}
+.hero__content {
+  max-width: 720px;
+}
+.eyebrow {
+  text-transform: uppercase;
+  letter-spacing: 0.2em;
+  opacity: 0.9;
+  margin-bottom: 1rem;
+  font-size: 0.85rem;
+}
+.hero h1 {
+  margin: 0;
+  font-size: clamp(3rem, 6vw, 4.5rem);
+}
+.hero p {
+  max-width: 38rem;
+  margin: 1.5rem auto 2rem;
+  opacity: 0.95;
+  font-size: 1.1rem;
+}
+.cta {
+  display: inline-block;
+  padding: 1rem 2rem;
+  border-radius: 999px;
+  background: white;
+  color: #0f172a;
+  font-weight: 700;
+  text-decoration: none;
+}
+.features {
+  display: grid;
+  gap: 1.5rem;
+  max-width: 80rem;
+  margin: 0 auto;
+  padding: 4rem 1.5rem;
+}
+.features article {
+  background: white;
+  border-radius: 1.5rem;
+  padding: 2rem;
+  box-shadow: 0 20px 60px rgba(15, 23, 42, 0.08);
+}
+footer {
+  text-align: center;
+  padding: 2rem 1rem;
+  color: #64748b;
+}
+`);
+  safeWriteFile(path.join(process.cwd(), 'script.js'), `const button = document.querySelector('.cta');
+if (button) {
+  button.addEventListener('click', (event) => {
+    event.preventDefault();
+    document.querySelector('#features')?.scrollIntoView({ behavior: 'smooth' });
+  });
+}
+`);
+  safeWriteFile(path.join(process.cwd(), 'README.md'), `# ${path.basename(process.cwd())}
+
+Generated by Hybard HTML landing page scaffold.
+
+Task: ${goal}
+`);
+}
+function createWebProject(goal, config) {
+  createNodeProject(goal, config);
+  safeWriteFile(path.join(process.cwd(), 'src', 'index.html'), `<!DOCTYPE html>\n<html lang="en">\n<head>\n  <meta charset="UTF-8">\n  <meta name="viewport" content="width=device-width, initial-scale=1.0">\n  <title>${path.basename(process.cwd())}</title>\n</head>\n<body>\n  <h1>Hybard Web Project</h1>\n  <p>${goal}</p>\n  <script src=\"index.js\"></script>\n</body>\n</html>\n`);
+}
+
+function describeWorkspace() {
+  const files = scanProjectFiles(process.cwd());
+  if (files.length === 0) return 'Workspace is empty.';
+  return `Workspace contains ${files.length} files:\n- ${files.slice(0, 20).join('\n- ')}${files.length > 20 ? '\n- ...' : ''}`;
+}
+
+async function initAgent() {
+  const config = await promptInitConfig();
+  console.log('Hybard is initialized.');
+  return config;
+}
+
+function getFixPrompt(filePath, content, error) {
+  const language = getFileType(filePath);
+  return `Repair the following ${language} file. Keep the file structure and fix the syntax errors or obvious issues. Return only the corrected file contents without extra explanation.\n\nFILE: ${filePath}\nERROR: ${error}\n\nCONTENT:\n${content}`;
+}
+
+function fixFile(filePath) {
+  const absPath = path.join(process.cwd(), filePath);
+  if (!fs.existsSync(absPath)) {
+    console.error(`File not found: ${filePath}`);
+    return false;
+  }
+  const current = fs.readFileSync(absPath, 'utf8');
+  const syntax = runSyntaxCheck(filePath);
+  if (syntax.ok) {
+    console.log(`No syntax errors detected in ${filePath}.`);
+    return true;
+  }
+
+  console.log(`Fixing ${filePath}...`);
+  backupFile(absPath);
+  const prompt = getFixPrompt(filePath, current, syntax.error);
+  let repair = '';
+  try {
+    repair = runLocalModel(prompt);
+  } catch (err) {
+    console.error(`Failed to generate repair for ${filePath}: ${err.message}`);
+    return false;
+  }
+
+  if (!repair.trim()) {
+    console.error(`No repair content returned for ${filePath}.`);
+    return false;
+  }
+
+  fs.writeFileSync(absPath, repair, 'utf8');
+  console.log(`Updated ${filePath} with repaired content.`);
+  const check = runSyntaxCheck(filePath);
+  if (!check.ok) {
+    console.error(`Repair did not fully fix ${filePath}: ${check.error}`);
+    return false;
+  }
+  console.log(`${filePath} is now syntactically valid.`);
+  return true;
+}
+
+function fixProject() {
+  const files = scanProjectFiles(process.cwd()).filter((file) => file.endsWith('.js') || file.endsWith('.py'));
+  if (files.length === 0) {
+    console.log('No JavaScript or Python files found to fix.');
+    return;
+  }
+
+  let fixedCount = 0;
+  for (const file of files) {
+    const syntax = runSyntaxCheck(file);
+    if (!syntax.ok) {
+      if (fixFile(file)) fixedCount += 1;
+    }
+  }
+
+  if (fixedCount === 0) {
+    console.log('No syntax issues were found or fixed.');
+  } else {
+    console.log(`Fixed ${fixedCount} file(s).`);
+  }
+}
+
+function createPlan(goal) {
+  const prompt = `You are a coding assistant that writes a development plan. Provide a step-by-step plan for building: ${goal}. Return numbered steps.`;
+  const ai = new HybardAI();
+  const apiKey = ai.getApiKey();
+
+  if (apiKey) {
+    ai.chat(prompt, { system: 'You are an expert software architect. Create clear, actionable development plans with numbered steps.' })
+      .then(plan => {
+        console.log('--- Project plan ---');
+        console.log(plan);
+      })
+      .catch(err => {
+        console.error('Failed to generate a plan with AI:', err.message);
+        console.log('Trying local model...');
+        try {
+          const plan = runLocalModel(prompt);
+          console.log('--- Project plan (local) ---');
+          console.log(plan);
+        } catch (e2) {
+          console.error('Failed to run local model:', e2.message);
+        }
+      });
+  } else {
+    try {
+      const plan = runLocalModel(prompt);
+      console.log('--- Project plan ---');
+      console.log(plan);
+    } catch (err) {
+      console.error('Failed to generate a plan:', err.message);
+    }
+  }
+}
+
+function getHelpText() {
+  return `Hybard AI Agent commands:
+
+  hybard init                Initialize Hybard configuration interactively
+  hybard create <goal>       Create a new project scaffold for the given goal
+  hybard install             Install project dependencies for the current workspace
+  hybard inspect             Show workspace files and summary
+  hybard fix project         Scan and repair JS/Python syntax issues
+  hybard fix <file>          Repair a specific file if syntax errors are found
+  hybard plan <goal>         Generate a step-by-step development plan
+  hybard help               Show this help message
+
+Examples:
+  hybard create "social media app"
+  hybard create "ecommerce website"
+  hybard create "chat application"
+  hybard create "python api backend"
+  hybard create "react dashboard app"
+  hybard create "flutter mobile app"
+  hybard create "html css javascript landing page"
+  hybard create "landing page with html css tailwind"
+  hybard create "django blog app"
+  hybard create "dejano ecommerce site"
+`;
+}
+
+async function runAgent(args) {
+  const goal = args.join(' ').trim();
+  const config = loadConfig();
+
+  if (!goal || goal === 'help' || goal === '--help' || goal === '-h') {
+    console.log(getHelpText());
+    return;
+  }
+
+  if (goal === 'init') {
+    await initAgent();
+    return;
+  }
+
+  if (goal.startsWith('create ') || goal.startsWith('scaffold ') || goal.startsWith('build ')) {
+    createProject(goal.replace(/^(create|scaffold|build)\s+/, ''), config);
+    return;
+  }
+
+  if (goal === 'inspect current project' || goal === 'inspect') {
+    console.log(describeWorkspace());
+    return;
+  }
+
+  if (goal === 'install') {
+    installDependencies();
+    return;
+  }
+
+  if (goal === 'fix project') {
+    fixProject();
+    return;
+  }
+
+  if (goal.startsWith('fix ')) {
+    const filePath = goal.replace(/^fix\s+/, '').trim();
+    fixFile(filePath);
+    return;
+  }
+
+  if (goal.startsWith('plan ')) {
+    createPlan(goal.replace(/^plan\s+/, ''));
+    return;
+  }
+
+  console.log('Scanning workspace and generating code...');
+  console.log(describeWorkspace());
+
+  const ai = new HybardAI();
+  const apiKey = ai.getApiKey();
+
+  if (apiKey) {
+    try {
+      const output = await ai.chat(goal);
+      console.log('\n--- AI Response ---\n');
+      console.log(output);
+    } catch (err) {
+      console.error(`\n[AI Error] ${err.message}\n`);
+      console.log('Falling back to local model...');
+      try {
+        const output = runLocalModel(goal);
+        console.log('--- Local Model output ---');
+        console.log(output);
+      } catch (e2) {
+        console.error('Failed to run local model:', e2.message);
+      }
+    }
+  } else {
+    try {
+      const output = runLocalModel(goal);
+      console.log('--- Local Model output ---');
+      console.log(output);
+    } catch (err) {
+      console.error('Failed to run local model:', err.message);
+    }
+  }
+}
+
+module.exports = {
+  runAgent,
+};