A tool for analyzing project structure and dependencies
npm install sicuabash
npm install -g sicua
`
Quick Analysis
`bash
Analyze current directory
npx sicua
`
Features
$3
- Component Analysis: Circular dependencies, zombie clusters, component relationships
- Complexity Metrics: Cognitive complexity, cyclomatic complexity, maintainability index
- Dependency Analysis: Unused and missing package dependencies
- Function Analysis: Parameter parsing, async detection, type resolution
- Error Handling: Error boundaries, try-catch blocks, error patterns
$3
- SEO Analysis: Meta tags, structured data, performance optimization
- Translation Coverage: Missing translations, duplicate keys
- Type Analysis: Complex types, duplicate types, usage patterns
- Security Analysis: Basic Security Analysis and vulnerability detections
- Deduplication: Component similarity detection and grouping
$3
- Next.js: App Router, Pages Router, middleware analysis
- React: Components, hooks, JSX patterns
- TypeScript: Full type system analysis
- Modern JavaScript: ES6+, async/await, modules
Usage
$3
`bash
sicua
`
$3
The tool generates a comprehensive JSON report containing:
- Component relationships and dependency graphs
- Complexity metrics for maintainability assessment
- Circular dependency detection with break suggestions
- Zombie cluster identification for unused code cleanup
- SEO optimization recommendations
- Error handling coverage analysis
$3
`json
{
"componentAnalysis": {
"circularDependencies": [...],
"zombieClusters": [...],
"dependencyGraph": [...]
},
"complexityMetrics": {
"cognitiveComplexity": {...},
"cyclomaticComplexity": {...},
"maintainabilityIndex": {...}
},
"advancedAnalysis": {
"seoAnalysis": {...},
"errorHandling": {...},
"typeAnalysis": {...}
}
}
`
Supported File Types
- TypeScript: .ts, .tsx
- JavaScript: .js, .jsx
- Configuration: next.config.js, tsconfig.json, etc.
- Translation: JSON, TypeScript translation files
Project Structure Analysis
Sicua analyzes:
- Components: React components, hooks, context providers
- Pages/Routes: Next.js pages, API routes, middleware
- Utils/Helpers: Utility functions, shared logic
- Types: TypeScript interfaces, types, enums
- Config Files: Build configuration, environment setup
Requirements
- Node.js: 18.0.0 or higher
- TypeScript projects (JavaScript support included)
- React/Next.js (optimized for these frameworks)
CLI Options
`bash
sicua [options]
Options:
-p, --path Path to the project (default: current directory)
-o, --output Output file path (default: analysis-results.json)
--src Source directory to analyze
--root-components Root component names (comma-separated)
--extensions File extensions to process (comma-separated)
--verbose Enable verbose output
--force Force analysis even if validation fails
-V, --version Show version number
-h, --help Display help information
Additional commands
sicua validate # Validate project structure
sicua init # Initialize config file
sicua info # Show project information
``