π Next-generation codebase intelligence platform for AI-powered code review, agent pipelines, onboarding, and repository analysis.
Deep Metadata Extraction β’ Service Interaction Graphs β’ Business Logic Flow Analysis β’ API Payload Detection β’ Authentication Policy Mapping
- Framework Detection (Node.js, Express, NestJS, React, Vue, Angular, etc.)
- Smart Service Classification (Business vs Utility)
- API Route & Method Extraction
- ORM Database Schema Analysis (Mongoose, Sequelize, Prisma, TypeORM)
- Utility Function Mapping by Domain
- Global Pattern Detection (Validation, State Management, Logging, etc.)
- Git Metadata Integration
- Service Interaction Graphs
- Schema Snapshots with full model field metadata
- API Payload Extraction from Joi, Celebrate, DTOs, Swagger
- Authentication Policy Mapping (JWT, Role, Middleware Chains)
- Business Logic Flow Analysis at method level
- ORM Field Metadata Extraction (with types, constraints, defaults)
- LLM-Optimized Output for AI Agents
- Fully pluggable into CI/CD or SaaS pipelines
- Modular Extractor Architecture for extensions
- Generates rich code knowledge graphs
npm install -g codebase-summary-bot # or use via npx npx codebase-summary-botcodebase-summary-bot codebase-summary-bot --output=./summary.json --limit=50| Option | Description | Default | Example |
|---|---|---|---|
--output | Output file path | codebase-summary.json | --output=./analysis.json |
--limit | Max items per category | 100 | --limit=50 |
--format | Output format | json | --format=yaml |
--exclude | Exclude patterns | node_modules,dist | --exclude=tests,docs |
--deep-analysis | Enable deep metadata extraction | false | --deep-analysis |
--include-flows | Extract business logic flows | true | --no-include-flows |
Generates fully structured LLM-optimized metadata. Major sections:
services: businessServices & utilityServicesapiRoutes: publicRoutes, internalRoutesdbModels: ORM models and schema definitionsutils: Utility function mappingsframeworks: Backend, Frontend, DB, Validation librariesserviceDependencies: Service-to-service call graphsschemaSnapshots: Full ORM models with field typesapiPayloads: Request/Response payloads per API routeauthPolicies: Per-route auth detectionbusinessFlows: Business logic flow per service
- AI Code Reviewers
- Codebase Context for LLM Agents
- Architecture Quality Gates
- AI-powered Refactoring
- Instant Onboarding Docs
- Service Interaction Graphs
- API Documentation Extraction
- Code Navigation Assistance
- Continuous Architecture Analysis
- Security Audit Surface Mapping
- Microservice Boundary Extraction
- API Surface Contracts
- Business Logic Flow Visualization
- Change Impact Analysis
- Data Relationship Mapping
- Feature Planning Support
- Mongoose, Sequelize, Prisma, TypeORM
- Express.js, NestJS, Joi, Celebrate, Yup, Swagger/OpenAPI, TypeScript DTOs
- JWT, Passport.js, Custom Middleware, Express Guards
- Node.js, Express, NestJS, Koa, Fastify, Hapi
- React, Vue.js, Angular, Svelte, Next.js, Nuxt.js
- JavaScript, TypeScript
Example to run analysis in CI/CD pipeline:
name: π€ Codebase Intelligence on: push: branches: [main, develop] pull_request: branches: [main] jobs: analyze: runs-on: ubuntu-latest permissions: contents: read pull-requests: write steps: - name: π
Checkout code uses: actions/checkout@v4 with: fetch-depth: 0 - name: π Generate codebase summary uses: libinvbabu/codebase-summarizer@v1 with: output-path: 'codebase-summary.json' deep-analysis: true include-flows: true - name: π€ Upload analysis uses: actions/upload-artifact@v3 with: name: codebase-analysis path: codebase-summary.json - name: π Quality Gate Check run: | node scripts/check-architecture-compliance.js - name: π¬ Comment on PR if: github.event_name == 'pull_request' uses: actions/github-script@v6 with: script: | const fs = require('fs'); const analysis = JSON.parse(fs.readFileSync('codebase-summary.json', 'utf8')); const comment = `## π€ Codebase Analysis **Services Analyzed:** ${analysis.services.businessServices.length} business, ${analysis.services.utilityServices.length} utility **API Endpoints:** ${analysis.apiRoutes.publicRoutes.length} public, ${analysis.apiRoutes.internalRoutes.length} internal **Database Models:** ${analysis.dbModels.length} **Authentication Policies:** ${Object.keys(analysis.authPolicies || {}).length} routes protected`; github.rest.issues.createComment({ issue_number: context.issue.number, owner: context.repo.owner, repo: context.repo.repo, body: comment });Highly modular extraction architecture:
src/ βββ summarizer.js βββ frameworkDetector.js βββ serviceClassifier.js βββ apiRouteExtractor.js βββ dbModelExtractor.js βββ utilityAnalyzer.js βββ patternDetector.js βββ gitMetadata.js βββ extractors/ βββ serviceInteractionExtractor.js βββ schemaSnapshotExtractor.js βββ payloadExtractor.js βββ authPolicyExtractor.js βββ businessLogicFlowExtractor.js We welcome contributions!
git clone https://github.com/libinvbabu/codebase-summarizer.git cd codebase-summarizer npm install npm test npm run dev npm run build npm link codebase-summary-bot --help-
Fork & Branch (
git checkout -b feature/xyz) -
Follow coding standards
-
Add tests
-
Use conventional commits (
feat: add extractor) -
Submit PR
- Python (Django, Flask, FastAPI)
- Java (Spring Boot)
- Real-time Analysis API
- Dependency Graph Visualization
- Test Coverage Mapping
- Rust, PHP, Laravel
- React Native Support
- Cloud Patterns
- AI-powered Code Smell Detection
- Security Pattern Extraction
MIT License Β© 2025 Libin V Babu
Author: Libin V Babu GitHub: https://github.com/libinvbabu/codebase-summarizer