shai-analyzer v0.1.5
shai-analyzer π οΈπ¦
Smart Dependency Analyzer for JavaScript/TypeScript projects Detect breaking changes before they break your app! π₯
β¨ What is shai-analyzer?
shai-analyzer is a CLI tool designed to analyze your projectβs dependencies and detect possible breaking changes when updating packages.
π It uses AI (DeepSeek-R1 B7 with Ollama) to provide precise recommendations on whether updating a package might cause issues in your project.
β‘ Features
- β Scans your dependencies in package.json and detects outdated versions.
- β Checks for breaking changes using AI-powered analysis.
- β
Distinguishes TypeScript support:
- π’ Native TypeScript support
- π‘ Uses @types/package for TypeScript
- π΄ No TypeScript support detected
- β Integrates AI to analyze changelogs for better accuracy.
- β Works locally with Ollama for privacy & offline AI analysis.
π¦ Installation
Before installing, make sure you have Ollama installed and have downloaded the required AI model:
ollama pull deepseek-r1:b7
Then, install shai-analyzer globally via NPM:
npm install -g shai-analyzer
π Usage
π Scan your dependencies
Run the following command in the root of your project:
shai-analyzer scan
This will:
- 1οΈβ£ Analyze all dependencies in package.json.
- 2οΈβ£ Check if updates are available.
- 3οΈβ£ Detect breaking changes with AI.
- 4οΈβ£ Show TypeScript support for each dependency.
Example output:
π οΈ How AI is used
- πΉ shai-analyzer uses AI to analyze the changelog of each package before updating.
- πΉ AI is powered by Ollama with DeepSeek-R1 B7 to determine:
- βοΈ If a package update introduces breaking changes.
- βοΈ If changes impact TypeScript compatibility.
- βοΈ If a safer version upgrade is recommended.
π οΈ Requirements
- πΉ Node.js (v16+)
- πΉ Ollama installed β Install Ollama
- πΉ DeepSeek-R1 B7 model β Install with:
ollama pull deepseek-r1:b7
π License
This project is licensed under the MIT License.
π Contributions are welcome! If you find a bug or want to add features, feel free to open a pull request.