NPM Update Report

npm Package Update Report Generator

Generate investigation reports for npm dependency updates with changelog research and verification.

Workflow

Investigation Criteria

Always investigate:

• Major version bumps (breaking changes likely)
• Minor bumps of: frameworks (React, Vue, Next.js), build tools (Vite, esbuild), test tools (Vitest, Jest)

Investigate if verification fails:

• Any package that may be related to the failure

Skip investigation:

• Patch-only updates with passing verification

Key Rules

• Reference primary sources only: GitHub Releases, CHANGELOG.md, official blogs
• Detect package manager from lock file: package-lock.json (npm), pnpm-lock.yaml (pnpm), yarn.lock (yarn)
• For monorepos, use workspace filters (pnpm --filter, npm -w)

Verification Failure Handling

If verification fails:

1. Identify failing script and error message
2. Search for related packages in the error
3. Investigate those packages' changelogs for breaking changes
4. Document findings in report under "Verification Results"
5. Set conclusion to "Needs attention" with specific action items

Report Template

# Package Update Report: {branch-name}

## Summary

| Metric       | Value            |
| ------------ | ---------------- |
| Verification | PASSED / !FAILED |
| Major        | {count}          |
| Minor        | {count}          |
| Patch        | {count}          |

## Notable Changes

### {package-name} ({old-version} -> {new-version}) [major/minor]

**Changes:**

- !Breaking: {description}
- New: {description}
- Fix: {description}

**Project Impact:** Affected / Not affected

- {affected-files-or-features}

**Reference:** [CHANGELOG]({url})

## Other Updates

| Package | Change             | Type  | Notes |
| ------- | ------------------ | ----- | ----- |
| {name}  | {x.x.x} -> {y.y.y} | patch | -     |

## Verification Results

### {script-name}

\`\`\`
{output-summary}
\`\`\`

## Conclusion

- **Breaking Changes:** No action required / !Action required: {details}
- **Recommendation:** Ready to merge / !Needs attention: {details}

Formatting Rules