Bug Analysis Platform

An AI-driven bug analysis platform that automatically reproduces bugs, generates code fixes, and validates results using a multi-agent workflow. Distributed as an npm package — anyone on your team can install it globally and run the platform locally with a single setup command.

Prerequisites

• Node.js v18 or later and npm v9 or later
• MongoDB installed and running locally (default: mongodb://localhost:27017)

The following directories and files are included in the published package:

bin/           ← CLI entry point
src/           ← CLI source (setup wizard, build engine, start command)
backend/       ← Express REST API source
backend/frontend/  ← React + Vite UI build (compiled)
multi-agent-server/  ← LangGraph AI agent source
README.md
package.json

Quick Start

1. Install globally

npm i -g bug-analysis-platform-test

2. Setup (One-time)

bug-analysis setup

The wizard will prompt for:

| Prompt | Default | Description | |---|---|---| | MongoDB URI | mongodb://localhost:27017/bug-analysis | Connection string for your local MongoDB | | Backend server port | 11001 | Port for the API and frontend | | Multi-agent server port | 5500 | Port for the LangGraph agent server | | Server host URL | http://localhost | Base URL (change if deploying remotely) |

Setup will then:

1. Save configuration to ~/.bug-analysis/config.json
2. Copy source files to ~/.bug-analysis/
3. Write .env files for each service from your answers
4. Build the React frontend with Vite
5. Patch the backend to serve the frontend statically and proxy socket.io to the agent server
6. Install all service dependencies
7. Verify the installation

3. Start the platform

bug-analysis start

This starts both the backend and the multi-agent server as a single process. Press Ctrl+C to stop all services.

4. Open the application

| Service | URL | |---|---| | Frontend (React UI) | http://localhost:11001 | | Backend API | http://localhost:11001/api/v1 | | Swagger API Docs | http://localhost:11001/api-docs | | Multi-agent Server | http://localhost:5500 |

Updating

bug-analysis update              # install the latest published version
bug-analysis update 1.0.6        # install a specific version

When an update is available, a new terminal window opens automatically showing the progress:

[Bug Analysis] Uninstalling old version...
[Bug Analysis] Installing latest version...
[Bug Analysis] Applying update to ~/.bug-analysis...
✓ Update complete — now on v1.0.x. Run 'bug-analysis start' to launch.

| What happens | Detail | |---|---| | Version check | Compares your installed version against the target on npm | | Up to date | Exits cleanly — nothing is changed | | Update available | Uninstalls old package, installs new one, copies backend and agent-server into ~/.bug-analysis | | Specific version | Bypasses the up-to-date check — can also be used to downgrade | | Config preserved | Your ~/.bug-analysis/config.json (ports, MongoDB URI) is never touched | | Database preserved | MongoDB data is completely unaffected |

After the update window shows "Update complete", restart the platform:

bug-analysis start

Re-running Setup

Setup is safe to re-run at any time — for example, after a package update or to change configuration. Existing values are shown as defaults so you only need to change what is different.

bug-analysis setup

Configuration is stored at ~/.bug-analysis/config.json and the built application lives in ~/.bug-analysis/.

Notes

• MongoDB must be running before executing bug-analysis start. The backend exits on startup if it cannot connect.
• To update to a newly published version, run bug-analysis update. Your configuration and database are preserved automatically.