debug-build

What it does

Runs npm run build, captures the output, and parses errors into human-readable diagnostics with file locations and fix suggestions.

Input

Parameter	Type	Required	Description
projectPath	string	No	Path to the project directory (default: cwd)
buildOutput	string	No	Pre-captured build output to parse (skips running the build)

Output

{
  "success": false,
  "errors": [
    {
      "file": "src/App.tsx",
      "line": 42,
      "column": 5,
      "message": "TS2345: Argument of type 'string' is not assignable to parameter of type 'number'",
      "humanMessage": "There is a type error in src/App.tsx on line 42: Argument of type 'string' is not assignable to parameter of type 'number'",
      "suggestion": "Check that you're passing the correct type. You might need parseInt() or a type assertion."
    }
  ]
}

Supported error formats

• TypeScript errors (TSxxxx)
• Vite/Rollup build errors
• ESLint errors
• General Node.js errors