@openqa/cli 1.0.13 → 1.1.1

package/dist/cli/server.js

@@ -0,0 +1,695 @@
+// agent/config/index.ts
+import { config as dotenvConfig } from "dotenv";
+
+// database/index.ts
+import { Low } from "lowdb";
+import { JSONFile } from "lowdb/node";
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { mkdirSync } from "fs";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var OpenQADatabase = class {
+  constructor(dbPath = "./data/openqa.json") {
+    this.dbPath = dbPath;
+    this.initialize();
+  }
+  db = null;
+  initialize() {
+    const dir = dirname(this.dbPath);
+    mkdirSync(dir, { recursive: true });
+    const adapter = new JSONFile(this.dbPath);
+    this.db = new Low(adapter, {
+      config: {},
+      test_sessions: [],
+      actions: [],
+      bugs: [],
+      kanban_tickets: []
+    });
+    this.db.read();
+    if (!this.db.data) {
+      this.db.data = {
+        config: {},
+        test_sessions: [],
+        actions: [],
+        bugs: [],
+        kanban_tickets: []
+      };
+      this.db.write();
+    }
+  }
+  async ensureInitialized() {
+    if (!this.db) {
+      this.initialize();
+    }
+    await this.db.read();
+  }
+  async getConfig(key) {
+    await this.ensureInitialized();
+    return this.db.data.config[key] || null;
+  }
+  async setConfig(key, value) {
+    await this.ensureInitialized();
+    this.db.data.config[key] = value;
+    await this.db.write();
+  }
+  async getAllConfig() {
+    await this.ensureInitialized();
+    return this.db.data.config;
+  }
+  async createSession(id, metadata) {
+    await this.ensureInitialized();
+    const session = {
+      id,
+      started_at: (/* @__PURE__ */ new Date()).toISOString(),
+      status: "running",
+      total_actions: 0,
+      bugs_found: 0,
+      metadata: metadata ? JSON.stringify(metadata) : void 0
+    };
+    this.db.data.test_sessions.push(session);
+    await this.db.write();
+    return session;
+  }
+  async getSession(id) {
+    await this.ensureInitialized();
+    return this.db.data.test_sessions.find((s) => s.id === id) || null;
+  }
+  async updateSession(id, updates) {
+    await this.ensureInitialized();
+    const index = this.db.data.test_sessions.findIndex((s) => s.id === id);
+    if (index !== -1) {
+      this.db.data.test_sessions[index] = { ...this.db.data.test_sessions[index], ...updates };
+      await this.db.write();
+    }
+  }
+  async getRecentSessions(limit = 10) {
+    await this.ensureInitialized();
+    return this.db.data.test_sessions.sort((a, b) => new Date(b.started_at).getTime() - new Date(a.started_at).getTime()).slice(0, limit);
+  }
+  async createAction(action) {
+    await this.ensureInitialized();
+    const newAction = {
+      id: `action_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...action
+    };
+    this.db.data.actions.push(newAction);
+    await this.db.write();
+    return newAction;
+  }
+  async getSessionActions(sessionId) {
+    await this.ensureInitialized();
+    return this.db.data.actions.filter((a) => a.session_id === sessionId).sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+  }
+  async createBug(bug) {
+    await this.ensureInitialized();
+    const newBug = {
+      id: `bug_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      updated_at: (/* @__PURE__ */ new Date()).toISOString(),
+      ...bug
+    };
+    this.db.data.bugs.push(newBug);
+    await this.db.write();
+    return newBug;
+  }
+  async updateBug(id, updates) {
+    await this.ensureInitialized();
+    const index = this.db.data.bugs.findIndex((b) => b.id === id);
+    if (index !== -1) {
+      this.db.data.bugs[index] = {
+        ...this.db.data.bugs[index],
+        ...updates,
+        updated_at: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      await this.db.write();
+    }
+  }
+  async getAllBugs() {
+    await this.ensureInitialized();
+    return this.db.data.bugs.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+  }
+  async getBugsByStatus(status) {
+    await this.ensureInitialized();
+    return this.db.data.bugs.filter((b) => b.status === status).sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+  }
+  async createKanbanTicket(ticket) {
+    await this.ensureInitialized();
+    const newTicket = {
+      id: `ticket_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      updated_at: (/* @__PURE__ */ new Date()).toISOString(),
+      ...ticket
+    };
+    this.db.data.kanban_tickets.push(newTicket);
+    await this.db.write();
+    return newTicket;
+  }
+  async updateKanbanTicket(id, updates) {
+    await this.ensureInitialized();
+    const index = this.db.data.kanban_tickets.findIndex((t) => t.id === id);
+    if (index !== -1) {
+      this.db.data.kanban_tickets[index] = {
+        ...this.db.data.kanban_tickets[index],
+        ...updates,
+        updated_at: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      await this.db.write();
+    }
+  }
+  async getKanbanTickets() {
+    await this.ensureInitialized();
+    return this.db.data.kanban_tickets.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+  }
+  async getKanbanTicketsByColumn(column) {
+    await this.ensureInitialized();
+    return this.db.data.kanban_tickets.filter((t) => t.column === column).sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+  }
+  async clearAllConfig() {
+    await this.ensureInitialized();
+    this.db.data.config = {};
+    await this.db.write();
+  }
+  async close() {
+  }
+};
+
+// agent/config/index.ts
+dotenvConfig();
+var ConfigManager = class {
+  db = null;
+  envConfig;
+  constructor(dbPath) {
+    this.envConfig = this.loadFromEnv();
+  }
+  loadFromEnv() {
+    return {
+      llm: {
+        provider: process.env.LLM_PROVIDER || "openai",
+        apiKey: process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY,
+        model: process.env.LLM_MODEL,
+        baseUrl: process.env.OLLAMA_BASE_URL
+      },
+      saas: {
+        url: process.env.SAAS_URL || "",
+        authType: process.env.SAAS_AUTH_TYPE || "none",
+        username: process.env.SAAS_USERNAME,
+        password: process.env.SAAS_PASSWORD
+      },
+      github: process.env.GITHUB_TOKEN ? {
+        token: process.env.GITHUB_TOKEN,
+        owner: process.env.GITHUB_OWNER || "",
+        repo: process.env.GITHUB_REPO || ""
+      } : void 0,
+      agent: {
+        intervalMs: parseInt(process.env.AGENT_INTERVAL_MS || "3600000"),
+        maxIterations: parseInt(process.env.AGENT_MAX_ITERATIONS || "20"),
+        autoStart: process.env.AGENT_AUTO_START === "true"
+      },
+      web: {
+        port: parseInt(process.env.WEB_PORT || "4242"),
+        host: process.env.WEB_HOST || "0.0.0.0"
+      },
+      database: {
+        path: process.env.DB_PATH || "./data/openqa.db"
+      },
+      notifications: {
+        slack: process.env.SLACK_WEBHOOK_URL,
+        discord: process.env.DISCORD_WEBHOOK_URL
+      }
+    };
+  }
+  getDB() {
+    if (!this.db) {
+      this.db = new OpenQADatabase("./data/openqa.json");
+    }
+    return this.db;
+  }
+  async get(key) {
+    const dbValue = await this.getDB().getConfig(key);
+    if (dbValue) return dbValue;
+    const keys = key.split(".");
+    let value = this.envConfig;
+    for (const k of keys) {
+      value = value?.[k];
+    }
+    return value?.toString() || null;
+  }
+  async set(key, value) {
+    await this.getDB().setConfig(key, value);
+  }
+  async getAll() {
+    const dbConfig = await this.getDB().getAllConfig();
+    const merged = { ...this.envConfig };
+    for (const [key, value] of Object.entries(dbConfig)) {
+      const keys = key.split(".");
+      let obj = merged;
+      for (let i = 0; i < keys.length - 1; i++) {
+        if (!obj[keys[i]]) obj[keys[i]] = {};
+        obj = obj[keys[i]];
+      }
+      obj[keys[keys.length - 1]] = value;
+    }
+    return merged;
+  }
+  async getConfig() {
+    return await this.getAll();
+  }
+  // Synchronous version that only uses env vars (no DB)
+  getConfigSync() {
+    return this.envConfig;
+  }
+};
+
+// cli/server.ts
+import express from "express";
+import { WebSocketServer } from "ws";
+import chalk from "chalk";
+async function startWebServer() {
+  const config = new ConfigManager();
+  const cfg = config.getConfigSync();
+  const db = new OpenQADatabase("./data/openqa.json");
+  const app = express();
+  app.use(express.json());
+  const wss = new WebSocketServer({ noServer: true });
+  app.get("/api/status", async (req, res) => {
+    res.json({
+      isRunning: true,
+      target: cfg.saas.url || "Not configured"
+    });
+  });
+  app.get("/api/sessions", async (req, res) => {
+    const limit = parseInt(req.query.limit) || 10;
+    const sessions = await db.getRecentSessions(limit);
+    res.json(sessions);
+  });
+  app.get("/api/sessions/:id/actions", async (req, res) => {
+    const actions = await db.getSessionActions(req.params.id);
+    res.json(actions);
+  });
+  app.get("/api/bugs", async (req, res) => {
+    const status = req.query.status;
+    const bugs = status ? await db.getBugsByStatus(status) : await db.getAllBugs();
+    res.json(bugs);
+  });
+  app.get("/api/kanban/tickets", async (req, res) => {
+    const column = req.query.column;
+    const tickets = column ? await db.getKanbanTicketsByColumn(column) : await db.getKanbanTickets();
+    res.json(tickets);
+  });
+  app.patch("/api/kanban/tickets/:id", async (req, res) => {
+    const { id } = req.params;
+    const updates = req.body;
+    await db.updateKanbanTicket(id, updates);
+    res.json({ success: true });
+  });
+  app.get("/api/config", (req, res) => {
+    res.json(cfg);
+  });
+  app.post("/api/config", async (req, res) => {
+    try {
+      const configData = req.body;
+      for (const [key, value] of Object.entries(configData)) {
+        await config.set(key, String(value));
+      }
+      res.json({ success: true });
+    } catch (error) {
+      res.status(500).json({ success: false, error: error.message });
+    }
+  });
+  app.post("/api/config/reset", async (req, res) => {
+    try {
+      await db.clearAllConfig();
+      res.json({ success: true });
+    } catch (error) {
+      res.status(500).json({ success: false, error: error.message });
+    }
+  });
+  app.get("/", (req, res) => {
+    res.send(`
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <title>OpenQA - Dashboard</title>
+          <style>
+            body { font-family: system-ui; max-width: 1200px; margin: 40px auto; padding: 20px; background: #0f172a; color: #e2e8f0; }
+            h1 { color: #38bdf8; }
+            .card { background: #1e293b; border: 1px solid #334155; border-radius: 8px; padding: 20px; margin: 20px 0; }
+            .status { display: inline-block; padding: 4px 12px; border-radius: 4px; font-size: 14px; }
+            .status.running { background: #10b981; color: white; }
+            .status.idle { background: #f59e0b; color: white; }
+            a { color: #38bdf8; text-decoration: none; }
+            a:hover { text-decoration: underline; }
+            nav { margin: 20px 0; }
+            nav a { margin-right: 20px; }
+          </style>
+        </head>
+        <body>
+          <h1>\u{1F916} OpenQA Dashboard</h1>
+          <nav>
+            <a href="/">Dashboard</a>
+            <a href="/kanban">Kanban</a>
+            <a href="/config">Config</a>
+          </nav>
+          <div class="card">
+            <h2>Status</h2>
+            <p>Agent: <span class="status idle">Idle</span></p>
+            <p>Target: ${cfg.saas.url || "Not configured"}</p>
+            <p>Auto-start: ${cfg.agent.autoStart ? "Enabled" : "Disabled"}</p>
+          </div>
+          <div class="card">
+            <h2>Quick Links</h2>
+            <ul>
+              <li><a href="/kanban">View Kanban Board</a></li>
+              <li><a href="/config">Configure OpenQA</a></li>
+            </ul>
+          </div>
+          <div class="card">
+            <h2>Getting Started</h2>
+            <p>Configure your SaaS application target and start testing:</p>
+            <ol>
+              <li>Set SAAS_URL environment variable or use the <a href="/config">Config page</a></li>
+              <li>Enable auto-start: <code>export AGENT_AUTO_START=true</code></li>
+              <li>Restart OpenQA</li>
+            </ol>
+          </div>
+        </body>
+      </html>
+    `);
+  });
+  app.get("/kanban", (req, res) => {
+    res.send(`
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <title>OpenQA - Kanban Board</title>
+          <style>
+            body { font-family: system-ui; max-width: 1400px; margin: 40px auto; padding: 20px; background: #0f172a; color: #e2e8f0; }
+            h1 { color: #38bdf8; }
+            nav { margin: 20px 0; }
+            nav a { color: #38bdf8; text-decoration: none; margin-right: 20px; }
+            nav a:hover { text-decoration: underline; }
+            .board { display: grid; grid-template-columns: repeat(4, 1fr); gap: 20px; margin-top: 30px; }
+            .column { background: #1e293b; border: 1px solid #334155; border-radius: 8px; padding: 15px; }
+            .column h3 { margin-top: 0; color: #38bdf8; }
+            .ticket { background: #334155; padding: 12px; margin: 10px 0; border-radius: 6px; border-left: 3px solid #38bdf8; }
+            .ticket h4 { margin: 0 0 8px 0; font-size: 14px; }
+            .ticket p { margin: 0; font-size: 12px; color: #94a3b8; }
+          </style>
+        </head>
+        <body>
+          <h1>\u{1F4CB} Kanban Board</h1>
+          <nav>
+            <a href="/">Dashboard</a>
+            <a href="/kanban">Kanban</a>
+            <a href="/config">Config</a>
+          </nav>
+          <div class="board">
+            <div class="column">
+              <h3>Backlog</h3>
+              <p style="color: #64748b;">No tickets yet</p>
+            </div>
+            <div class="column">
+              <h3>To Do</h3>
+              <p style="color: #64748b;">No tickets yet</p>
+            </div>
+            <div class="column">
+              <h3>In Progress</h3>
+              <p style="color: #64748b;">No tickets yet</p>
+            </div>
+            <div class="column">
+              <h3>Done</h3>
+              <p style="color: #64748b;">No tickets yet</p>
+            </div>
+          </div>
+          <p style="margin-top: 40px; color: #64748b;">Tickets will appear here when the agent starts finding bugs and creating tasks.</p>
+        </body>
+      </html>
+    `);
+  });
+  app.get("/config", (req, res) => {
+    res.send(`
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <title>OpenQA - Configuration</title>
+          <style>
+            body { font-family: system-ui; max-width: 800px; margin: 40px auto; padding: 20px; background: #0f172a; color: #e2e8f0; }
+            h1 { color: #38bdf8; }
+            nav { margin: 20px 0; }
+            nav a { color: #38bdf8; text-decoration: none; margin-right: 20px; }
+            nav a:hover { text-decoration: underline; }
+            .section { background: #1e293b; border: 1px solid #334155; border-radius: 8px; padding: 20px; margin: 20px 0; }
+            .section h2 { margin-top: 0; color: #38bdf8; font-size: 18px; }
+            .config-item { margin: 15px 0; }
+            .config-item label { display: block; margin-bottom: 5px; color: #94a3b8; font-size: 14px; }
+            .config-item input, .config-item select { 
+              background: #334155; 
+              border: 1px solid #475569; 
+              color: #e2e8f0; 
+              padding: 8px 12px; 
+              border-radius: 4px; 
+              font-family: monospace; 
+              font-size: 14px; 
+              width: 100%;
+              max-width: 400px;
+            }
+            .config-item input:focus, .config-item select:focus { 
+              outline: none; 
+              border-color: #38bdf8; 
+              box-shadow: 0 0 0 2px rgba(56, 189, 248, 0.1); 
+            }
+            .btn { 
+              background: #38bdf8; 
+              color: white; 
+              border: none; 
+              padding: 10px 20px; 
+              border-radius: 6px; 
+              cursor: pointer; 
+              font-size: 14px; 
+              margin-right: 10px;
+            }
+            .btn:hover { background: #0ea5e9; }
+            .btn-secondary { background: #64748b; }
+            .btn-secondary:hover { background: #475569; }
+            .success { color: #10b981; margin-left: 10px; }
+            .error { color: #ef4444; margin-left: 10px; }
+            code { background: #334155; padding: 2px 6px; border-radius: 3px; font-size: 13px; }
+            .checkbox { margin-right: 8px; }
+          </style>
+        </head>
+        <body>
+          <h1>\u2699\uFE0F Configuration</h1>
+          <nav>
+            <a href="/">Dashboard</a>
+            <a href="/kanban">Kanban</a>
+            <a href="/config">Config</a>
+          </nav>
+          
+          <div class="section">
+            <h2>SaaS Target</h2>
+            <form id="configForm">
+              <div class="config-item">
+                <label>URL</label>
+                <input type="url" id="saas_url" name="saas.url" value="${cfg.saas.url || ""}" placeholder="https://your-app.com">
+              </div>
+              <div class="config-item">
+                <label>Auth Type</label>
+                <select id="saas_authType" name="saas.authType">
+                  <option value="none" ${cfg.saas.authType === "none" ? "selected" : ""}>None</option>
+                  <option value="basic" ${cfg.saas.authType === "basic" ? "selected" : ""}>Basic Auth</option>
+                  <option value="bearer" ${cfg.saas.authType === "bearer" ? "selected" : ""}>Bearer Token</option>
+                  <option value="session" ${cfg.saas.authType === "session" ? "selected" : ""}>Session</option>
+                </select>
+              </div>
+              <div class="config-item">
+                <label>Username (for Basic Auth)</label>
+                <input type="text" id="saas_username" name="saas.username" value="${cfg.saas.username || ""}" placeholder="username">
+              </div>
+              <div class="config-item">
+                <label>Password (for Basic Auth)</label>
+                <input type="password" id="saas_password" name="saas.password" value="${cfg.saas.password || ""}" placeholder="password">
+              </div>
+            </form>
+          </div>
+
+          <div class="section">
+            <h2>LLM Configuration</h2>
+            <form id="configForm">
+              <div class="config-item">
+                <label>Provider</label>
+                <select id="llm_provider" name="llm.provider">
+                  <option value="openai" ${cfg.llm.provider === "openai" ? "selected" : ""}>OpenAI</option>
+                  <option value="anthropic" ${cfg.llm.provider === "anthropic" ? "selected" : ""}>Anthropic</option>
+                  <option value="ollama" ${cfg.llm.provider === "ollama" ? "selected" : ""}>Ollama</option>
+                </select>
+              </div>
+              <div class="config-item">
+                <label>Model</label>
+                <input type="text" id="llm_model" name="llm.model" value="${cfg.llm.model || ""}" placeholder="gpt-4, claude-3-sonnet, etc.">
+              </div>
+              <div class="config-item">
+                <label>API Key</label>
+                <input type="password" id="llm_apiKey" name="llm.apiKey" value="${cfg.llm.apiKey || ""}" placeholder="Your API key">
+              </div>
+              <div class="config-item">
+                <label>Base URL (for Ollama)</label>
+                <input type="url" id="llm_baseUrl" name="llm.baseUrl" value="${cfg.llm.baseUrl || ""}" placeholder="http://localhost:11434">
+              </div>
+            </form>
+          </div>
+
+          <div class="section">
+            <h2>Agent Settings</h2>
+            <form id="configForm">
+              <div class="config-item">
+                <label>
+                  <input type="checkbox" id="agent_autoStart" name="agent.autoStart" class="checkbox" ${cfg.agent.autoStart ? "checked" : ""}>
+                  Auto-start
+                </label>
+              </div>
+              <div class="config-item">
+                <label>Interval (ms)</label>
+                <input type="number" id="agent_intervalMs" name="agent.intervalMs" value="${cfg.agent.intervalMs}" min="60000">
+              </div>
+              <div class="config-item">
+                <label>Max Iterations</label>
+                <input type="number" id="agent_maxIterations" name="agent.maxIterations" value="${cfg.agent.maxIterations}" min="1" max="100">
+              </div>
+            </form>
+          </div>
+
+          <div class="section">
+            <h2>Actions</h2>
+            <button type="button" class="btn" onclick="saveConfig()">Save Configuration</button>
+            <button type="button" class="btn btn-secondary" onclick="resetConfig()">Reset to Defaults</button>
+            <span id="message"></span>
+          </div>
+
+          <div class="section">
+            <h2>Environment Variables</h2>
+            <p>You can also set these environment variables before starting OpenQA:</p>
+            <pre style="background: #334155; padding: 15px; border-radius: 6px; overflow-x: auto;"><code>export SAAS_URL="https://your-app.com"
+export AGENT_AUTO_START=true
+export LLM_PROVIDER=openai
+export OPENAI_API_KEY="your-key"
+
+openqa start</code></pre>
+          </div>
+
+          <script>
+            async function saveConfig() {
+              const form = document.getElementById('configForm');
+              const formData = new FormData(form);
+              const config = {};
+              
+              for (let [key, value] of formData.entries()) {
+                if (value === '') continue;
+                
+                // Handle nested keys like "saas.url"
+                const keys = key.split('.');
+                let obj = config;
+                for (let i = 0; i < keys.length - 1; i++) {
+                  if (!obj[keys[i]]) obj[keys[i]] = {};
+                  obj = obj[keys[i]];
+                }
+                
+                // Convert checkbox values to boolean
+                if (key.includes('autoStart')) {
+                  obj[keys[keys.length - 1]] = value === 'on';
+                } else if (key.includes('intervalMs') || key.includes('maxIterations')) {
+                  obj[keys[keys.length - 1]] = parseInt(value);
+                } else {
+                  obj[keys[keys.length - 1]] = value;
+                }
+              }
+              
+              try {
+                const response = await fetch('/api/config', {
+                  method: 'POST',
+                  headers: { 'Content-Type': 'application/json' },
+                  body: JSON.stringify(config)
+                });
+                
+                const result = await response.json();
+                if (result.success) {
+                  showMessage('Configuration saved successfully!', 'success');
+                  setTimeout(() => location.reload(), 1500);
+                } else {
+                  showMessage('Failed to save configuration', 'error');
+                }
+              } catch (error) {
+                showMessage('Error: ' + error.message, 'error');
+              }
+            }
+            
+            async function resetConfig() {
+              if (confirm('Are you sure you want to reset all configuration to defaults?')) {
+                try {
+                  const response = await fetch('/api/config/reset', { method: 'POST' });
+                  const result = await response.json();
+                  if (result.success) {
+                    showMessage('Configuration reset to defaults', 'success');
+                    setTimeout(() => location.reload(), 1500);
+                  }
+                } catch (error) {
+                  showMessage('Error: ' + error.message, 'error');
+                }
+              }
+            }
+            
+            function showMessage(text, type) {
+              const messageEl = document.getElementById('message');
+              messageEl.textContent = text;
+              messageEl.className = type;
+              setTimeout(() => {
+                messageEl.textContent = '';
+                messageEl.className = '';
+              }, 3000);
+            }
+          </script>
+        </body>
+      </html>
+    `);
+  });
+  const server = app.listen(cfg.web.port, cfg.web.host, () => {
+    console.log(chalk.cyan("\n\u{1F4CA} OpenQA Status:"));
+    console.log(chalk.white(`  Agent: ${cfg.agent.autoStart ? "Auto-start enabled" : "Idle"}`));
+    console.log(chalk.white(`  Target: ${cfg.saas.url || "Not configured"}`));
+    console.log(chalk.white(`  Dashboard: http://localhost:${cfg.web.port}`));
+    console.log(chalk.white(`  Kanban: http://localhost:${cfg.web.port}/kanban`));
+    console.log(chalk.white(`  Config: http://localhost:${cfg.web.port}/config`));
+    console.log(chalk.gray("\nPress Ctrl+C to stop\n"));
+    if (!cfg.agent.autoStart) {
+      console.log(chalk.yellow("\u{1F4A1} Auto-start disabled. Agent is idle."));
+      console.log(chalk.cyan("   Set AGENT_AUTO_START=true to enable autonomous mode\n"));
+    }
+  });
+  server.on("upgrade", (request, socket, head) => {
+    wss.handleUpgrade(request, socket, head, (ws) => {
+      wss.emit("connection", ws, request);
+    });
+  });
+  wss.on("connection", (ws) => {
+    console.log("WebSocket client connected");
+    ws.on("close", () => {
+      console.log("WebSocket client disconnected");
+    });
+  });
+  process.on("SIGTERM", () => {
+    console.log("Received SIGTERM, shutting down gracefully...");
+    server.close(() => {
+      process.exit(0);
+    });
+  });
+  process.on("SIGINT", () => {
+    console.log("\nShutting down gracefully...");
+    server.close(() => {
+      process.exit(0);
+    });
+  });
+}
+export {
+  startWebServer
+};