How aayushgokhale2005/bugparcel-core works
BugParcel captures reproducible failure parcels from a dirty Git workspace, then replays and verifies them in isolated worktrees. The CLI is the primary workflow; Python adapters can initiate capture, while the MCP server and local dashboard expose parcel operations to agents and users. Parcel manifests, Git snapshots, environment details, request state, and fixtures preserve the reproduction contract. README documents reduction, optional Docker replay, and enterprise association; their internal wiring is not fully shown in the sampled source, so those links are omitted or marked unverified.
Main entry points: src/main.rs BugParcel CLI · src/main.rs MCP Server · src/lib.rs Parcel Manifest · src/lib.rs Reproduction Runner
Components 18
Capture
- Git Snapshot
crates/git-state/src/lib.rs - Environment Capture
crates/environment/src/lib.rs
Parcel Core
- Parcel Manifest
crates/parcel-core/src/lib.rs - Artifact Store
crates/artifact-store/src/lib.rs - Reproduction Runner
crates/replay/src/lib.rs - Fix Verification
crates/verify/src/lib.rs - State Reducer
crates/reducer/src/lib.rs - Local Parcel Store
User Interfaces
- BugParcel CLI
apps/cli/src/main.rs - MCP Server
apps/mcp-server/src/main.rs - Dashboard UI
apps/dashboard/src/main.js - Local HTTP Bridge
apps/dashboard/server.mjs
Adapters & Integrations
- Generic Capture SDK
sdks/python/bugparcel-capture/src/bugparcel_capture/capture.py - FastAPI Adapter
sdks/python/bugparcel-fastapi/src/bugparcel_fastapi/middleware.py
Other components
- Developer
- Failing Service
- Docker Runtime
- Enterprise Service
Connections 22
- Developer → BugParcel CLI: captures or operates
README.md - Failing Service → Generic Capture SDK: captures failures
README.md - Failing Service → FastAPI Adapter: captures exceptions
sdks/python/bugparcel-fastapi/src/bugparcel_fastapi/middleware.py - Generic Capture SDK → BugParcel CLI: invokes capture
sdks/python/bugparcel-capture/src/bugparcel_capture/capture.py - FastAPI Adapter → BugParcel CLI: invokes capture
sdks/python/bugparcel-fastapi/src/bugparcel_fastapi/middleware.py - BugParcel CLI → Git Snapshot: captures Git state
README.md - BugParcel CLI → Environment Capture: records environment
README.md - BugParcel CLI → Parcel Manifest: creates parcel
README.md - Parcel Manifest → Local Parcel Store: persists parcel
README.md - BugParcel CLI → Artifact Store: stores artifacts
README.md - BugParcel CLI → Reproduction Runner: reproduces command
README.md - Reproduction Runner → Docker Runtime: runs optionally
crates/replay/src/lib.rs - BugParcel CLI → Fix Verification: verifies fix
README.md - BugParcel CLI → State Reducer: reduces state
README.md - Developer → MCP Server: requests tools
README.md - MCP Server → Git Snapshot: captures Git state
apps/mcp-server/src/main.rs - MCP Server → Environment Capture: captures environment
apps/mcp-server/src/main.rs - MCP Server → Parcel Manifest: handles parcels
- Developer → Dashboard UI: views parcels
apps/dashboard/src/main.js - Dashboard UI → Local HTTP Bridge: requests actions
apps/dashboard/src/main.js - Local HTTP Bridge → MCP Server: invokes tools
apps/dashboard/server.mjs - BugParcel CLI → Enterprise Service: calls remote API
apps/cli/src/main.rs