@openqa/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orka.js Team
+
+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,424 @@
+<p align="center">
+  <img src="https://orkajs.com/loutre-orka-qa.png" alt="OpenQA" width="180" />
+</p>
+
+<h1 align="center">OpenQA</h1>
+
+<p align="center">
+  <strong>Autonomous QA Testing Agent - Thinks, codes, and executes tests like a senior QA engineer. Powered by Orka.js 🦦</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/openqa"><img src="https://img.shields.io/npm/v/openqa.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/openqa"><img src="https://img.shields.io/npm/dm/openqa.svg" alt="npm downloads"></a>
+  <a href="https://github.com/orka-js/openqa/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/openqa.svg" alt="license"></a>
+  <a href="https://orkajs.com"><img src="https://img.shields.io/badge/docs-orkajs.com-blue.svg" alt="documentation"></a>
+  <a href="https://discord.com/invite/DScfpuPysP"><img src="https://img.shields.io/badge/discord-join%20chat-7289da.svg" alt="discord"></a>
+</p>
+
+---
+
+OpenQA is a **truly autonomous** QA testing agent that thinks, codes, and executes tests like a senior QA engineer. It analyzes your application, generates its own tests, creates custom agents, and continuously improves.
+
+## ✨ Features
+
+### 🧠 Autonomous Brain
+### � Autonomous Brain
+- **Self-thinking** - Analyzes your app and decides what to test
+- **Self-coding** - Generates unit, functional, E2E, security, and regression tests
+- **Self-improving** - Learns from results and adapts strategy
+- **Dynamic Agents** - Creates specialized agents on-the-fly based on needs
+
+### � Simple Configuration
+- **Describe your SaaS** - Just provide name, description, and URL
+- **Add directives** - Optional instructions to guide the agent
+- **Connect repo** - Optional: clone and analyze your codebase
+- **That's it!** - The agent figures out the rest
+
+### 🔗 Git Integration
+- **GitHub/GitLab** - Auto-detect merges on main branch
+- **CI/CD Listener** - Trigger tests after successful deployments
+- **Auto Issues** - Creates issues for critical bugs found
+
+### 🧪 Test Generation
+- **Unit Tests** - Isolated function/component tests
+- **Functional Tests** - User workflow tests
+- **E2E Tests** - Complete user journey tests
+- **Security Tests** - SQL injection, XSS, auth bypass
+- **Regression Tests** - Verify bug fixes
+- **Performance Tests** - Load times, resource usage
+
+## 🚀 Quick Start
+
+### One-Line Installation
+
+```bash
+curl -fsSL https://openqa.orkajs.com/install.sh | bash
+```
+
+### Configure Your SaaS (3 lines!)
+
+```bash
+# Configure your application
+curl -X POST http://localhost:3000/api/saas-config/quick \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "My SaaS App",
+    "description": "E-commerce platform with user auth, product catalog, and checkout",
+    "url": "https://my-app.com"
+  }'
+
+# Start autonomous testing
+curl -X POST http://localhost:3000/api/brain/run
+```
+
+**That's it!** OpenQA will:
+1. Analyze your application
+2. Generate appropriate tests
+3. Create specialized agents as needed
+4. Execute tests and report findings
+5. Create GitHub issues for critical bugs
+
+### Manual Installation
+
+```bash
+git clone https://github.com/orka-js/openqa.git
+cd openqa
+npm install && npm run build
+cp .env.example .env  # Add your LLM API key
+npm start
+```
+
+## 📖 Usage
+
+### Start OpenQA
+
+```bash
+# Start in foreground (see logs)
+openqa start
+
+# Start in daemon mode (background)
+openqa start --daemon
+```
+
+### Access Web Interfaces
+
+Once started, open your browser:
+
+- **DevTools**: http://localhost:3000 - Monitor agent activity in real-time
+- **Kanban**: http://localhost:3000/kanban - View and manage QA tickets
+- **Config**: http://localhost:3000/config - Configure OpenQA settings
+
+### CLI Commands
+
+```bash
+# Check status
+openqa status
+
+# View logs
+openqa logs
+openqa logs --follow
+
+# Configuration
+openqa config list
+openqa config get llm.provider
+openqa config set saas.url https://your-app.com
+
+# Stop agent
+openqa stop
+```
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+```bash
+# LLM Configuration
+LLM_PROVIDER=openai              # openai, anthropic, or ollama
+OPENAI_API_KEY=sk-xxx
+ANTHROPIC_API_KEY=
+OLLAMA_BASE_URL=http://localhost:11434
+
+# Target SaaS Application
+SAAS_URL=https://your-app.com
+SAAS_AUTH_TYPE=none              # none, basic, or session
+SAAS_USERNAME=
+SAAS_PASSWORD=
+
+# GitHub Integration (Optional)
+GITHUB_TOKEN=ghp_xxx
+GITHUB_OWNER=your-username
+GITHUB_REPO=your-repo
+
+# Agent Behavior
+AGENT_INTERVAL_MS=3600000        # 1 hour between test sessions
+AGENT_MAX_ITERATIONS=20          # Max actions per session
+AGENT_AUTO_START=true            # Start testing automatically
+
+# Web UI
+WEB_PORT=3000
+WEB_HOST=0.0.0.0
+
+# Database
+DB_PATH=./data/openqa.db
+```
+
+### Web-based Configuration
+
+Prefer using the web interface at http://localhost:3000/config for easier configuration.
+
+## 🧠 How the Brain Works
+
+### The Thinking Loop
+
+```
+┌───────────┐     ┌───────────┐     ┌───────────┐
+│  ANALYZE  │ →→→ │   THINK   │ →→→ │    ACT    │
+└───────────┘     └───────────┘     └───────────┘
+     │                  │                  │
+     │                  │                  │
+     └──────────────────┴──────────────────┘
+                    LEARN
+```
+
+1. **ANALYZE** - Understands your app (description, URL, code if available)
+2. **THINK** - Decides what tests are needed, what agents to create
+3. **ACT** - Generates tests, creates agents, executes tests
+4. **LEARN** - Reviews results, adjusts strategy, repeats
+
+### What It Generates
+
+| Test Type | Description | Example |
+|-----------|-------------|----------|
+| **Unit** | Isolated function tests | `test_validateEmail()` |
+| **Functional** | User workflow tests | `test_loginFlow()` |
+| **E2E** | Complete journeys | `test_purchaseCheckout()` |
+| **Security** | Vulnerability tests | `test_sqlInjection()` |
+| **Regression** | Bug fix verification | `test_issue123_fix()` |
+| **Performance** | Speed/load tests | `test_pageLoadTime()` |
+
+### Dynamic Agent Creation
+
+The Brain creates specialized agents based on what it discovers:
+
+```
+🧠 Brain: "I see this app has a checkout flow. Let me create a specialist."
+     ↓
+🤖 Creates: "Checkout Flow Tester" agent with custom prompt
+     ↓
+🧪 Agent generates: 5 tests for cart, payment, confirmation
+     ↓
+✅ Executes tests, reports 2 bugs found
+```
+
+## 📊 Web Interfaces
+
+### DevTools Dashboard
+
+Real-time monitoring:
+- Current agent status
+- Live action logs
+- Test session history
+- Bugs detected
+- Screenshots captured
+
+### Kanban Board
+
+Manage QA findings:
+- **Backlog** - Future test ideas
+- **To Do** - Bugs to fix
+- **In Progress** - Being worked on
+- **Done** - Resolved
+
+Drag & drop tickets between columns.
+
+### Configuration Panel
+
+Simple configuration:
+- **SaaS Info** - Name, description, URL
+- **Repository** - Optional GitHub/GitLab URL for code analysis
+- **Directives** - Custom instructions for the agent
+- **LLM Settings** - Provider, API key, model
+- **Git Listener** - Auto-test on merge/deploy
+
+## 🔧 Advanced Usage
+
+### Full Configuration
+
+```bash
+# Configure with all options
+curl -X POST http://localhost:3000/api/saas-config \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "My E-commerce App",
+    "description": "Online store with user accounts, product catalog, shopping cart, and Stripe checkout",
+    "url": "https://my-store.com",
+    "repoUrl": "https://github.com/myorg/my-store",
+    "directives": [
+      "Focus on the checkout flow - it has had bugs before",
+      "Test with both logged-in and guest users",
+      "Check that discount codes work correctly",
+      "Verify email notifications are sent"
+    ],
+    "auth": {
+      "type": "session",
+      "credentials": { "username": "test@example.com", "password": "testpass" }
+    }
+  }'
+```
+
+### Add Directives On-the-fly
+
+```bash
+# Add a new directive
+curl -X POST http://localhost:3000/api/saas-config/directive \
+  -H "Content-Type: application/json" \
+  -d '{"directive": "Pay special attention to the new refund feature"}'
+```
+
+### Connect Repository for Code Analysis
+
+```bash
+# The Brain will clone and analyze your code
+curl -X POST http://localhost:3000/api/saas-config/repository \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://github.com/myorg/my-app"}'
+```
+
+### Generate Specific Tests
+
+```bash
+# Generate a security test
+curl -X POST http://localhost:3000/api/brain/generate-test \
+  -H "Content-Type: application/json" \
+  -d '{
+    "type": "security",
+    "target": "Login form SQL injection",
+    "context": "The login form at /login accepts email and password"
+  }'
+
+# Generate a functional test
+curl -X POST http://localhost:3000/api/brain/generate-test \
+  -H "Content-Type: application/json" \
+  -d '{
+    "type": "functional",
+    "target": "User registration flow"
+  }'
+```
+
+### Create Custom Agent
+
+```bash
+# Let the Brain create a specialized agent
+curl -X POST http://localhost:3000/api/brain/create-agent \
+  -H "Content-Type: application/json" \
+  -d '{"purpose": "Test the multi-step checkout process with various payment methods"}'
+```
+
+### Analyze Before Running
+
+```bash
+# Get analysis and suggestions without running tests
+curl -X POST http://localhost:3000/api/brain/analyze
+
+# Response:
+# {
+#   "understanding": "E-commerce app with user auth, catalog, cart, checkout",
+#   "suggestedTests": ["Test cart persistence", "Test checkout validation", ...],
+#   "suggestedAgents": ["Payment Flow Specialist", "Inventory Checker"],
+#   "risks": ["Cart race conditions", "Payment double-charge"]
+# }
+```
+
+### Docker Deployment
+
+```bash
+docker-compose up -d
+```
+
+## 🛠️ Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+
+# Build
+npm run build
+
+# Run tests
+npm test
+```
+
+## 📝 Architecture
+
+```
+openqa/
+├── agent/
+│   ├── brain/         # 🧠 Autonomous thinking & test generation
+│   ├── tools/         # Browser, GitHub, Kanban tools
+│   ├── config/        # SaaS configuration
+│   └── webhooks/      # Git listener (GitHub/GitLab)
+├── cli/               # CLI commands
+├── database/          # SQLite database
+└── data/
+    ├── workspace/     # Cloned repos
+    └── generated-tests/ # Tests created by Brain
+```
+
+## 🔌 API Reference
+
+### SaaS Configuration
+- `GET /api/saas-config` - Get current config
+- `POST /api/saas-config` - Full configuration
+- `POST /api/saas-config/quick` - Quick setup (name, description, url)
+- `POST /api/saas-config/directive` - Add directive
+- `POST /api/saas-config/repository` - Set repo URL
+- `POST /api/saas-config/local-path` - Set local path
+
+### Brain Control
+- `POST /api/brain/analyze` - Analyze app, get suggestions
+- `POST /api/brain/run` - Start autonomous session
+- `POST /api/brain/generate-test` - Generate specific test
+- `POST /api/brain/create-agent` - Create custom agent
+- `POST /api/brain/run-test/:id` - Execute a test
+
+### Data
+- `GET /api/status` - Agent status
+- `GET /api/tests` - Generated tests
+- `GET /api/dynamic-agents` - Created agents
+- `GET /api/sessions` - Test sessions
+- `GET /api/bugs` - Found bugs
+- `GET /api/kanban/tickets` - Kanban board
+
+### WebSocket (ws://localhost:3000)
+- `test-generated` - New test created
+- `agent-created` - New agent created
+- `test-started/completed` - Test lifecycle
+- `thinking` - Brain's current thought
+- `analysis-complete` - Analysis finished
+- `session-complete` - Session finished
+- `git-merge` - Merge detected
+- `git-pipeline-success` - Deploy detected
+
+## 🤝 Contributing
+
+Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
+
+## 📄 License
+
+MIT
+
+## 🙏 Credits
+
+Built with:
+- [Orka.js](https://orkajs.dev) - AI framework
+- [Playwright](https://playwright.dev) - Browser automation
+- [Next.js](https://nextjs.org) - Web interface
+- [SQLite](https://sqlite.org) - Database
+
+---
+
+Made with ❤️ by the Orka.js team

package/database/schema-v2.sql

@@ -0,0 +1,152 @@
+-- OpenQA Database Schema v2 - Extended for multi-agents and skills
+
+CREATE TABLE IF NOT EXISTS config (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS test_sessions (
+  id TEXT PRIMARY KEY,
+  started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  ended_at DATETIME,
+  status TEXT CHECK(status IN ('running', 'completed', 'failed')),
+  trigger_type TEXT CHECK(trigger_type IN ('manual', 'scheduled', 'merge', 'pipeline', 'webhook')),
+  trigger_data TEXT,
+  total_actions INTEGER DEFAULT 0,
+  bugs_found INTEGER DEFAULT 0,
+  metadata TEXT
+);
+
+CREATE TABLE IF NOT EXISTS actions (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  agent_id TEXT,
+  timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+  type TEXT NOT NULL,
+  description TEXT,
+  input TEXT,
+  output TEXT,
+  screenshot_path TEXT,
+  duration_ms INTEGER,
+  FOREIGN KEY (session_id) REFERENCES test_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS bugs (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  agent_id TEXT,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL,
+  severity TEXT CHECK(severity IN ('low', 'medium', 'high', 'critical')),
+  category TEXT CHECK(category IN ('ui', 'security', 'performance', 'accessibility', 'functional', 'other')),
+  status TEXT CHECK(status IN ('open', 'in-progress', 'resolved', 'closed', 'false-positive')),
+  github_issue_url TEXT,
+  gitlab_issue_url TEXT,
+  screenshot_path TEXT,
+  reproduction_steps TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES test_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS kanban_tickets (
+  id TEXT PRIMARY KEY,
+  bug_id TEXT,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL,
+  priority TEXT CHECK(priority IN ('low', 'medium', 'high', 'critical')),
+  column TEXT CHECK(column IN ('backlog', 'to-do', 'in-progress', 'done')),
+  tags TEXT,
+  screenshot_url TEXT,
+  assigned_to TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (bug_id) REFERENCES bugs(id)
+);
+
+-- New tables for v2
+
+CREATE TABLE IF NOT EXISTS specialist_agents (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  status TEXT CHECK(status IN ('idle', 'running', 'completed', 'failed', 'stopped')),
+  current_task TEXT,
+  progress INTEGER DEFAULT 0,
+  findings INTEGER DEFAULT 0,
+  actions_count INTEGER DEFAULT 0,
+  started_at DATETIME,
+  completed_at DATETIME,
+  error_message TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES test_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS skills (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  type TEXT CHECK(type IN ('directive', 'test-scenario', 'custom-check', 'workflow')),
+  enabled INTEGER DEFAULT 1,
+  priority INTEGER DEFAULT 0,
+  prompt TEXT NOT NULL,
+  triggers TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS skill_executions (
+  id TEXT PRIMARY KEY,
+  skill_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  agent_id TEXT,
+  started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  completed_at DATETIME,
+  status TEXT CHECK(status IN ('running', 'completed', 'failed', 'skipped')),
+  result TEXT,
+  findings_count INTEGER DEFAULT 0,
+  FOREIGN KEY (skill_id) REFERENCES skills(id),
+  FOREIGN KEY (session_id) REFERENCES test_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS git_events (
+  id TEXT PRIMARY KEY,
+  provider TEXT CHECK(provider IN ('github', 'gitlab')),
+  event_type TEXT CHECK(event_type IN ('merge', 'push', 'pipeline_success', 'pipeline_failure', 'tag')),
+  branch TEXT,
+  commit_sha TEXT,
+  author TEXT,
+  message TEXT,
+  pipeline_id TEXT,
+  pipeline_status TEXT,
+  triggered_session_id TEXT,
+  received_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (triggered_session_id) REFERENCES test_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS agent_logs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  agent_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  level TEXT CHECK(level IN ('debug', 'info', 'warn', 'error')),
+  message TEXT NOT NULL,
+  data TEXT,
+  timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES test_sessions(id)
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_actions_session ON actions(session_id);
+CREATE INDEX IF NOT EXISTS idx_actions_agent ON actions(agent_id);
+CREATE INDEX IF NOT EXISTS idx_bugs_session ON bugs(session_id);
+CREATE INDEX IF NOT EXISTS idx_bugs_status ON bugs(status);
+CREATE INDEX IF NOT EXISTS idx_bugs_severity ON bugs(severity);
+CREATE INDEX IF NOT EXISTS idx_bugs_category ON bugs(category);
+CREATE INDEX IF NOT EXISTS idx_kanban_column ON kanban_tickets(column);
+CREATE INDEX IF NOT EXISTS idx_specialist_session ON specialist_agents(session_id);
+CREATE INDEX IF NOT EXISTS idx_specialist_status ON specialist_agents(status);
+CREATE INDEX IF NOT EXISTS idx_skill_exec_session ON skill_executions(session_id);
+CREATE INDEX IF NOT EXISTS idx_git_events_branch ON git_events(branch);
+CREATE INDEX IF NOT EXISTS idx_agent_logs_agent ON agent_logs(agent_id);
+CREATE INDEX IF NOT EXISTS idx_agent_logs_session ON agent_logs(session_id);

package/database/schema.sql

@@ -0,0 +1,62 @@
+-- OpenQA Database Schema
+
+CREATE TABLE IF NOT EXISTS config (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS test_sessions (
+  id TEXT PRIMARY KEY,
+  started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  ended_at DATETIME,
+  status TEXT CHECK(status IN ('running', 'completed', 'failed')),
+  total_actions INTEGER DEFAULT 0,
+  bugs_found INTEGER DEFAULT 0,
+  metadata TEXT
+);
+
+CREATE TABLE IF NOT EXISTS actions (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+  type TEXT NOT NULL,
+  description TEXT,
+  input TEXT,
+  output TEXT,
+  screenshot_path TEXT,
+  FOREIGN KEY (session_id) REFERENCES test_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS bugs (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL,
+  severity TEXT CHECK(severity IN ('low', 'medium', 'high', 'critical')),
+  status TEXT CHECK(status IN ('open', 'in-progress', 'resolved', 'closed')),
+  github_issue_url TEXT,
+  screenshot_path TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (session_id) REFERENCES test_sessions(id)
+);
+
+CREATE TABLE IF NOT EXISTS kanban_tickets (
+  id TEXT PRIMARY KEY,
+  bug_id TEXT,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL,
+  priority TEXT CHECK(priority IN ('low', 'medium', 'high', 'critical')),
+  column TEXT CHECK(column IN ('backlog', 'to-do', 'in-progress', 'done')),
+  tags TEXT,
+  screenshot_url TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (bug_id) REFERENCES bugs(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_actions_session ON actions(session_id);
+CREATE INDEX IF NOT EXISTS idx_bugs_session ON bugs(session_id);
+CREATE INDEX IF NOT EXISTS idx_bugs_status ON bugs(status);
+CREATE INDEX IF NOT EXISTS idx_kanban_column ON kanban_tickets(column);