codebase-digest-ai 0.1.1__tar.gz → 0.1.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {codebase_digest_ai-0.1.1/codebase_digest_ai.egg-info → codebase_digest_ai-0.1.2}/PKG-INFO +15 -15
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/README.md +194 -194
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2/codebase_digest_ai.egg-info}/PKG-INFO +15 -15
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/pyproject.toml +1 -1
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/LICENSE +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/MANIFEST.in +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/__init__.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/analyzer/__init__.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/analyzer/codebase_analyzer.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/analyzer/flow_analyzer.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/analyzer/metrics_analyzer.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/cli/__init__.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/cli/main.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/__init__.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/graph_exporter.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/html_exporter.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/json_exporter.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/markdown_exporter.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/readme_exporter.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/models.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/parser/__init__.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/parser/base.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/parser/javascript_parser.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/parser/python_parser.py +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/SOURCES.txt +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/dependency_links.txt +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/entry_points.txt +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/requires.txt +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/top_level.txt +0 -0
- {codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: codebase-digest-ai
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.2
|
|
4
4
|
Summary: AI-native code intelligence engine for semantic codebase analysis
|
|
5
5
|
Author: Harsh Bothara
|
|
6
6
|
License: MIT
|
|
@@ -37,7 +37,7 @@ Requires-Dist: build>=0.10.0; extra == "dev"
|
|
|
37
37
|
Requires-Dist: twine>=4.0.0; extra == "dev"
|
|
38
38
|
Dynamic: license-file
|
|
39
39
|
|
|
40
|
-
# codebase-digest
|
|
40
|
+
# codebase-digest-ai
|
|
41
41
|
|
|
42
42
|
🚀 **AI-Native Code Intelligence Engine**
|
|
43
43
|
|
|
@@ -65,22 +65,22 @@ This is NOT a repo summarizer. This is a code intelligence engine that explains:
|
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
67
|
# Install
|
|
68
|
-
pip install codebase-digest
|
|
68
|
+
pip install codebase-digest-ai
|
|
69
69
|
|
|
70
70
|
# Analyze current directory
|
|
71
|
-
codebase-digest build
|
|
71
|
+
codebase-digest-ai build
|
|
72
72
|
|
|
73
73
|
# Analyze specific directory
|
|
74
|
-
codebase-digest build /path/to/project
|
|
74
|
+
codebase-digest-ai build /path/to/project
|
|
75
75
|
|
|
76
76
|
# Generate with interactive call graph
|
|
77
|
-
codebase-digest build --graph
|
|
77
|
+
codebase-digest-ai build --graph
|
|
78
78
|
|
|
79
79
|
# Quick stats
|
|
80
|
-
codebase-digest stats
|
|
80
|
+
codebase-digest-ai stats
|
|
81
81
|
|
|
82
82
|
# Search for patterns
|
|
83
|
-
codebase-digest query "wallet"
|
|
83
|
+
codebase-digest-ai query "wallet"
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
## 📁 Output Structure
|
|
@@ -138,19 +138,19 @@ The application follows a layered architecture with clear separation of concerns
|
|
|
138
138
|
|
|
139
139
|
```bash
|
|
140
140
|
# Full analysis with all outputs
|
|
141
|
-
codebase-digest build [PATH]
|
|
141
|
+
codebase-digest-ai build [PATH]
|
|
142
142
|
|
|
143
143
|
# Specific formats
|
|
144
|
-
codebase-digest build --format html # HTML dashboard only
|
|
145
|
-
codebase-digest build --format markdown # Markdown reports only
|
|
146
|
-
codebase-digest build --format json # JSON data only
|
|
144
|
+
codebase-digest-ai build --format html # HTML dashboard only
|
|
145
|
+
codebase-digest-ai build --format markdown # Markdown reports only
|
|
146
|
+
codebase-digest-ai build --format json # JSON data only
|
|
147
147
|
|
|
148
148
|
# Interactive call graph with depth filtering
|
|
149
|
-
codebase-digest build --graph --graph-depth 3
|
|
149
|
+
codebase-digest-ai build --graph --graph-depth 3
|
|
150
150
|
|
|
151
151
|
# Quick metrics and search
|
|
152
|
-
codebase-digest stats [PATH] # Project statistics
|
|
153
|
-
codebase-digest query "search term" [PATH] # Search patterns
|
|
152
|
+
codebase-digest-ai stats [PATH] # Project statistics
|
|
153
|
+
codebase-digest-ai query "search term" [PATH] # Search patterns
|
|
154
154
|
```
|
|
155
155
|
|
|
156
156
|
## 🎯 Key Features
|
|
@@ -1,194 +1,194 @@
|
|
|
1
|
-
# codebase-digest
|
|
2
|
-
|
|
3
|
-
🚀 **AI-Native Code Intelligence Engine**
|
|
4
|
-
|
|
5
|
-
Transform any codebase into semantic architectural understanding, execution flows, and human-readable engineering reports.
|
|
6
|
-
|
|
7
|
-
## 🧱 What It Does
|
|
8
|
-
|
|
9
|
-
This is NOT a repo summarizer. This is a code intelligence engine that explains:
|
|
10
|
-
- **What this system does** - Infers project purpose from domain entities
|
|
11
|
-
- **How data flows** - Maps execution paths and call relationships
|
|
12
|
-
- **Where logic lives** - Identifies core components and their responsibilities
|
|
13
|
-
- **What domains exist** - Detects business entities (User, Payment, Wallet, etc.)
|
|
14
|
-
- **What files matter** - Highlights entry points and key modules
|
|
15
|
-
|
|
16
|
-
## ✨ Features
|
|
17
|
-
|
|
18
|
-
- **🔍 Semantic Analysis**: Extract functions, classes, methods, and imports with full context
|
|
19
|
-
- **📊 Interactive Call Graphs**: Visualize function relationships and execution flows
|
|
20
|
-
- **🏗️ Domain Entity Detection**: Automatically identify core business objects
|
|
21
|
-
- **🔄 Execution Flow Mapping**: Trace request paths through the system
|
|
22
|
-
- **📋 Project README Generation**: Auto-generate documentation for new developers
|
|
23
|
-
- **📈 Multi-format Output**: HTML dashboards + Markdown reports + JSON data + Interactive graphs
|
|
24
|
-
|
|
25
|
-
## 🚀 Quick Start
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
# Install
|
|
29
|
-
pip install codebase-digest
|
|
30
|
-
|
|
31
|
-
# Analyze current directory
|
|
32
|
-
codebase-digest build
|
|
33
|
-
|
|
34
|
-
# Analyze specific directory
|
|
35
|
-
codebase-digest build /path/to/project
|
|
36
|
-
|
|
37
|
-
# Generate with interactive call graph
|
|
38
|
-
codebase-digest build --graph
|
|
39
|
-
|
|
40
|
-
# Quick stats
|
|
41
|
-
codebase-digest stats
|
|
42
|
-
|
|
43
|
-
# Search for patterns
|
|
44
|
-
codebase-digest query "wallet"
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
## 📁 Output Structure
|
|
48
|
-
|
|
49
|
-
Generates `.digest/` directory with comprehensive analysis:
|
|
50
|
-
```
|
|
51
|
-
.digest/
|
|
52
|
-
├── README.md # Project documentation for developers
|
|
53
|
-
├── callgraph.html # Interactive call graph visualization
|
|
54
|
-
├── report.html # Comprehensive HTML dashboard
|
|
55
|
-
├── architecture.md # Technical architecture breakdown
|
|
56
|
-
├── flows.md # Execution flow documentation
|
|
57
|
-
├── ai-context.md # AI-optimized context file
|
|
58
|
-
└── entities.json # Structured analysis data
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
## 📊 Example Output
|
|
62
|
-
|
|
63
|
-
For a Python financial services project:
|
|
64
|
-
|
|
65
|
-
```
|
|
66
|
-
📊 Codebase Statistics
|
|
67
|
-
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━┓
|
|
68
|
-
┃ Total Files ┃ 4 ┃
|
|
69
|
-
┃ Lines of Code ┃ 189 ┃
|
|
70
|
-
┃ Languages ┃ Python ┃
|
|
71
|
-
┃ Functions ┃ 24 ┃
|
|
72
|
-
┃ Classes ┃ 8 ┃
|
|
73
|
-
┃ Domain Entities ┃ 7 ┃
|
|
74
|
-
┃ Execution Flows ┃ 4 ┃
|
|
75
|
-
┃ Complexity Score ┃ 1.8 ┃
|
|
76
|
-
┗━━━━━━━━━━━━━━━━━━┻━━━━━━━━┛
|
|
77
|
-
|
|
78
|
-
Graph Stats: 29 nodes, 27 edges, 7 components
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
**Generated README.md excerpt:**
|
|
82
|
-
```markdown
|
|
83
|
-
# Project Overview
|
|
84
|
-
|
|
85
|
-
This is a financial services application that provides user management,
|
|
86
|
-
payment processing, and digital wallet functionality. The system is built
|
|
87
|
-
with a service-oriented architecture using Python dataclasses for domain
|
|
88
|
-
modeling and separate service layers for business logic.
|
|
89
|
-
|
|
90
|
-
## Architecture
|
|
91
|
-
|
|
92
|
-
The application follows a layered architecture with clear separation of concerns:
|
|
93
|
-
- **Domain Layer**: Contains core business entities (User, Payment, Wallet)
|
|
94
|
-
- **Service Layer**: Implements business logic (UserService, PaymentService)
|
|
95
|
-
- **Application Layer**: Handles bootstrapping and orchestration
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
## 💡 Commands
|
|
99
|
-
|
|
100
|
-
```bash
|
|
101
|
-
# Full analysis with all outputs
|
|
102
|
-
codebase-digest build [PATH]
|
|
103
|
-
|
|
104
|
-
# Specific formats
|
|
105
|
-
codebase-digest build --format html # HTML dashboard only
|
|
106
|
-
codebase-digest build --format markdown # Markdown reports only
|
|
107
|
-
codebase-digest build --format json # JSON data only
|
|
108
|
-
|
|
109
|
-
# Interactive call graph with depth filtering
|
|
110
|
-
codebase-digest build --graph --graph-depth 3
|
|
111
|
-
|
|
112
|
-
# Quick metrics and search
|
|
113
|
-
codebase-digest stats [PATH] # Project statistics
|
|
114
|
-
codebase-digest query "search term" [PATH] # Search patterns
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
## 🎯 Key Features
|
|
118
|
-
|
|
119
|
-
### 🕸️ Interactive Call Graph
|
|
120
|
-
- **Probabilistic entrypoint detection** - Finds real execution starting points
|
|
121
|
-
- **Noise filtering** - Removes builtin calls and isolated nodes
|
|
122
|
-
- **Depth filtering** - Focus on core execution spine
|
|
123
|
-
- **Professional UI** - GitHub/Linear/Notion inspired design
|
|
124
|
-
|
|
125
|
-
### 📝 Smart README Generation
|
|
126
|
-
- **Project type inference** - Detects financial, e-commerce, CMS patterns
|
|
127
|
-
- **Architecture analysis** - Service-oriented vs modular detection
|
|
128
|
-
- **Run instructions** - Inferred from entry points
|
|
129
|
-
- **Future improvements** - Realistic enhancement suggestions
|
|
130
|
-
|
|
131
|
-
### 🔍 Semantic Understanding
|
|
132
|
-
- **Symbol-aware analysis** - True function-level relationships
|
|
133
|
-
- **Domain entity detection** - Business object identification
|
|
134
|
-
- **Execution flow mapping** - Startup and runtime sequences
|
|
135
|
-
- **Cross-file analysis** - Import and dependency tracking
|
|
136
|
-
|
|
137
|
-
## 🛠️ Tech Stack
|
|
138
|
-
|
|
139
|
-
- **Python 3.10+** - Core language
|
|
140
|
-
- **AST parsing** - Deep Python code analysis
|
|
141
|
-
- **NetworkX** - Call graph analysis and visualization
|
|
142
|
-
- **vis.js** - Interactive graph rendering
|
|
143
|
-
- **Typer** - CLI interface
|
|
144
|
-
- **Rich** - Beautiful terminal output
|
|
145
|
-
|
|
146
|
-
## 📋 Supported Languages
|
|
147
|
-
|
|
148
|
-
- ✅ **Python** - Full AST analysis with call graphs
|
|
149
|
-
- 🚧 **JavaScript/TypeScript** - Parser implemented, integration in progress
|
|
150
|
-
- 🚧 **Java** - Planned
|
|
151
|
-
- 🚧 **Go** - Planned
|
|
152
|
-
|
|
153
|
-
## 🎯 Use Cases
|
|
154
|
-
|
|
155
|
-
- **New Developer Onboarding** - Understand unfamiliar codebases quickly
|
|
156
|
-
- **Code Reviews** - Architectural overview and impact analysis
|
|
157
|
-
- **Documentation Generation** - Auto-generate project documentation
|
|
158
|
-
- **Refactoring Planning** - Identify core components and dependencies
|
|
159
|
-
- **AI-Assisted Development** - Provide context for LLM code assistance
|
|
160
|
-
|
|
161
|
-
## 🔧 Development
|
|
162
|
-
|
|
163
|
-
```bash
|
|
164
|
-
# Install development dependencies
|
|
165
|
-
pip install -e ".[dev]"
|
|
166
|
-
|
|
167
|
-
# Run tests
|
|
168
|
-
pytest
|
|
169
|
-
|
|
170
|
-
# Format code
|
|
171
|
-
black .
|
|
172
|
-
isort .
|
|
173
|
-
|
|
174
|
-
# Type checking
|
|
175
|
-
mypy codebase_digest/
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
## 🤝 Contributing
|
|
179
|
-
|
|
180
|
-
1. Fork the repository
|
|
181
|
-
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
|
|
182
|
-
3. Make your changes
|
|
183
|
-
4. Add tests if applicable
|
|
184
|
-
5. Submit a pull request
|
|
185
|
-
|
|
186
|
-
## 📄 License
|
|
187
|
-
|
|
188
|
-
MIT License - see LICENSE file for details.
|
|
189
|
-
|
|
190
|
-
## 🙏 Acknowledgments
|
|
191
|
-
|
|
192
|
-
- Built with modern Python tooling and best practices
|
|
193
|
-
- Inspired by professional developer tools (JetBrains, Sourcegraph)
|
|
194
|
-
- Designed for AI-native development workflows
|
|
1
|
+
# codebase-digest-ai
|
|
2
|
+
|
|
3
|
+
🚀 **AI-Native Code Intelligence Engine**
|
|
4
|
+
|
|
5
|
+
Transform any codebase into semantic architectural understanding, execution flows, and human-readable engineering reports.
|
|
6
|
+
|
|
7
|
+
## 🧱 What It Does
|
|
8
|
+
|
|
9
|
+
This is NOT a repo summarizer. This is a code intelligence engine that explains:
|
|
10
|
+
- **What this system does** - Infers project purpose from domain entities
|
|
11
|
+
- **How data flows** - Maps execution paths and call relationships
|
|
12
|
+
- **Where logic lives** - Identifies core components and their responsibilities
|
|
13
|
+
- **What domains exist** - Detects business entities (User, Payment, Wallet, etc.)
|
|
14
|
+
- **What files matter** - Highlights entry points and key modules
|
|
15
|
+
|
|
16
|
+
## ✨ Features
|
|
17
|
+
|
|
18
|
+
- **🔍 Semantic Analysis**: Extract functions, classes, methods, and imports with full context
|
|
19
|
+
- **📊 Interactive Call Graphs**: Visualize function relationships and execution flows
|
|
20
|
+
- **🏗️ Domain Entity Detection**: Automatically identify core business objects
|
|
21
|
+
- **🔄 Execution Flow Mapping**: Trace request paths through the system
|
|
22
|
+
- **📋 Project README Generation**: Auto-generate documentation for new developers
|
|
23
|
+
- **📈 Multi-format Output**: HTML dashboards + Markdown reports + JSON data + Interactive graphs
|
|
24
|
+
|
|
25
|
+
## 🚀 Quick Start
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# Install
|
|
29
|
+
pip install codebase-digest-ai
|
|
30
|
+
|
|
31
|
+
# Analyze current directory
|
|
32
|
+
codebase-digest-ai build
|
|
33
|
+
|
|
34
|
+
# Analyze specific directory
|
|
35
|
+
codebase-digest-ai build /path/to/project
|
|
36
|
+
|
|
37
|
+
# Generate with interactive call graph
|
|
38
|
+
codebase-digest-ai build --graph
|
|
39
|
+
|
|
40
|
+
# Quick stats
|
|
41
|
+
codebase-digest-ai stats
|
|
42
|
+
|
|
43
|
+
# Search for patterns
|
|
44
|
+
codebase-digest-ai query "wallet"
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## 📁 Output Structure
|
|
48
|
+
|
|
49
|
+
Generates `.digest/` directory with comprehensive analysis:
|
|
50
|
+
```
|
|
51
|
+
.digest/
|
|
52
|
+
├── README.md # Project documentation for developers
|
|
53
|
+
├── callgraph.html # Interactive call graph visualization
|
|
54
|
+
├── report.html # Comprehensive HTML dashboard
|
|
55
|
+
├── architecture.md # Technical architecture breakdown
|
|
56
|
+
├── flows.md # Execution flow documentation
|
|
57
|
+
├── ai-context.md # AI-optimized context file
|
|
58
|
+
└── entities.json # Structured analysis data
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## 📊 Example Output
|
|
62
|
+
|
|
63
|
+
For a Python financial services project:
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
📊 Codebase Statistics
|
|
67
|
+
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━┓
|
|
68
|
+
┃ Total Files ┃ 4 ┃
|
|
69
|
+
┃ Lines of Code ┃ 189 ┃
|
|
70
|
+
┃ Languages ┃ Python ┃
|
|
71
|
+
┃ Functions ┃ 24 ┃
|
|
72
|
+
┃ Classes ┃ 8 ┃
|
|
73
|
+
┃ Domain Entities ┃ 7 ┃
|
|
74
|
+
┃ Execution Flows ┃ 4 ┃
|
|
75
|
+
┃ Complexity Score ┃ 1.8 ┃
|
|
76
|
+
┗━━━━━━━━━━━━━━━━━━┻━━━━━━━━┛
|
|
77
|
+
|
|
78
|
+
Graph Stats: 29 nodes, 27 edges, 7 components
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
**Generated README.md excerpt:**
|
|
82
|
+
```markdown
|
|
83
|
+
# Project Overview
|
|
84
|
+
|
|
85
|
+
This is a financial services application that provides user management,
|
|
86
|
+
payment processing, and digital wallet functionality. The system is built
|
|
87
|
+
with a service-oriented architecture using Python dataclasses for domain
|
|
88
|
+
modeling and separate service layers for business logic.
|
|
89
|
+
|
|
90
|
+
## Architecture
|
|
91
|
+
|
|
92
|
+
The application follows a layered architecture with clear separation of concerns:
|
|
93
|
+
- **Domain Layer**: Contains core business entities (User, Payment, Wallet)
|
|
94
|
+
- **Service Layer**: Implements business logic (UserService, PaymentService)
|
|
95
|
+
- **Application Layer**: Handles bootstrapping and orchestration
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## 💡 Commands
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Full analysis with all outputs
|
|
102
|
+
codebase-digest-ai build [PATH]
|
|
103
|
+
|
|
104
|
+
# Specific formats
|
|
105
|
+
codebase-digest-ai build --format html # HTML dashboard only
|
|
106
|
+
codebase-digest-ai build --format markdown # Markdown reports only
|
|
107
|
+
codebase-digest-ai build --format json # JSON data only
|
|
108
|
+
|
|
109
|
+
# Interactive call graph with depth filtering
|
|
110
|
+
codebase-digest-ai build --graph --graph-depth 3
|
|
111
|
+
|
|
112
|
+
# Quick metrics and search
|
|
113
|
+
codebase-digest-ai stats [PATH] # Project statistics
|
|
114
|
+
codebase-digest-ai query "search term" [PATH] # Search patterns
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## 🎯 Key Features
|
|
118
|
+
|
|
119
|
+
### 🕸️ Interactive Call Graph
|
|
120
|
+
- **Probabilistic entrypoint detection** - Finds real execution starting points
|
|
121
|
+
- **Noise filtering** - Removes builtin calls and isolated nodes
|
|
122
|
+
- **Depth filtering** - Focus on core execution spine
|
|
123
|
+
- **Professional UI** - GitHub/Linear/Notion inspired design
|
|
124
|
+
|
|
125
|
+
### 📝 Smart README Generation
|
|
126
|
+
- **Project type inference** - Detects financial, e-commerce, CMS patterns
|
|
127
|
+
- **Architecture analysis** - Service-oriented vs modular detection
|
|
128
|
+
- **Run instructions** - Inferred from entry points
|
|
129
|
+
- **Future improvements** - Realistic enhancement suggestions
|
|
130
|
+
|
|
131
|
+
### 🔍 Semantic Understanding
|
|
132
|
+
- **Symbol-aware analysis** - True function-level relationships
|
|
133
|
+
- **Domain entity detection** - Business object identification
|
|
134
|
+
- **Execution flow mapping** - Startup and runtime sequences
|
|
135
|
+
- **Cross-file analysis** - Import and dependency tracking
|
|
136
|
+
|
|
137
|
+
## 🛠️ Tech Stack
|
|
138
|
+
|
|
139
|
+
- **Python 3.10+** - Core language
|
|
140
|
+
- **AST parsing** - Deep Python code analysis
|
|
141
|
+
- **NetworkX** - Call graph analysis and visualization
|
|
142
|
+
- **vis.js** - Interactive graph rendering
|
|
143
|
+
- **Typer** - CLI interface
|
|
144
|
+
- **Rich** - Beautiful terminal output
|
|
145
|
+
|
|
146
|
+
## 📋 Supported Languages
|
|
147
|
+
|
|
148
|
+
- ✅ **Python** - Full AST analysis with call graphs
|
|
149
|
+
- 🚧 **JavaScript/TypeScript** - Parser implemented, integration in progress
|
|
150
|
+
- 🚧 **Java** - Planned
|
|
151
|
+
- 🚧 **Go** - Planned
|
|
152
|
+
|
|
153
|
+
## 🎯 Use Cases
|
|
154
|
+
|
|
155
|
+
- **New Developer Onboarding** - Understand unfamiliar codebases quickly
|
|
156
|
+
- **Code Reviews** - Architectural overview and impact analysis
|
|
157
|
+
- **Documentation Generation** - Auto-generate project documentation
|
|
158
|
+
- **Refactoring Planning** - Identify core components and dependencies
|
|
159
|
+
- **AI-Assisted Development** - Provide context for LLM code assistance
|
|
160
|
+
|
|
161
|
+
## 🔧 Development
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
# Install development dependencies
|
|
165
|
+
pip install -e ".[dev]"
|
|
166
|
+
|
|
167
|
+
# Run tests
|
|
168
|
+
pytest
|
|
169
|
+
|
|
170
|
+
# Format code
|
|
171
|
+
black .
|
|
172
|
+
isort .
|
|
173
|
+
|
|
174
|
+
# Type checking
|
|
175
|
+
mypy codebase_digest/
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
## 🤝 Contributing
|
|
179
|
+
|
|
180
|
+
1. Fork the repository
|
|
181
|
+
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
|
|
182
|
+
3. Make your changes
|
|
183
|
+
4. Add tests if applicable
|
|
184
|
+
5. Submit a pull request
|
|
185
|
+
|
|
186
|
+
## 📄 License
|
|
187
|
+
|
|
188
|
+
MIT License - see LICENSE file for details.
|
|
189
|
+
|
|
190
|
+
## 🙏 Acknowledgments
|
|
191
|
+
|
|
192
|
+
- Built with modern Python tooling and best practices
|
|
193
|
+
- Inspired by professional developer tools (JetBrains, Sourcegraph)
|
|
194
|
+
- Designed for AI-native development workflows
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: codebase-digest-ai
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.2
|
|
4
4
|
Summary: AI-native code intelligence engine for semantic codebase analysis
|
|
5
5
|
Author: Harsh Bothara
|
|
6
6
|
License: MIT
|
|
@@ -37,7 +37,7 @@ Requires-Dist: build>=0.10.0; extra == "dev"
|
|
|
37
37
|
Requires-Dist: twine>=4.0.0; extra == "dev"
|
|
38
38
|
Dynamic: license-file
|
|
39
39
|
|
|
40
|
-
# codebase-digest
|
|
40
|
+
# codebase-digest-ai
|
|
41
41
|
|
|
42
42
|
🚀 **AI-Native Code Intelligence Engine**
|
|
43
43
|
|
|
@@ -65,22 +65,22 @@ This is NOT a repo summarizer. This is a code intelligence engine that explains:
|
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
67
|
# Install
|
|
68
|
-
pip install codebase-digest
|
|
68
|
+
pip install codebase-digest-ai
|
|
69
69
|
|
|
70
70
|
# Analyze current directory
|
|
71
|
-
codebase-digest build
|
|
71
|
+
codebase-digest-ai build
|
|
72
72
|
|
|
73
73
|
# Analyze specific directory
|
|
74
|
-
codebase-digest build /path/to/project
|
|
74
|
+
codebase-digest-ai build /path/to/project
|
|
75
75
|
|
|
76
76
|
# Generate with interactive call graph
|
|
77
|
-
codebase-digest build --graph
|
|
77
|
+
codebase-digest-ai build --graph
|
|
78
78
|
|
|
79
79
|
# Quick stats
|
|
80
|
-
codebase-digest stats
|
|
80
|
+
codebase-digest-ai stats
|
|
81
81
|
|
|
82
82
|
# Search for patterns
|
|
83
|
-
codebase-digest query "wallet"
|
|
83
|
+
codebase-digest-ai query "wallet"
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
## 📁 Output Structure
|
|
@@ -138,19 +138,19 @@ The application follows a layered architecture with clear separation of concerns
|
|
|
138
138
|
|
|
139
139
|
```bash
|
|
140
140
|
# Full analysis with all outputs
|
|
141
|
-
codebase-digest build [PATH]
|
|
141
|
+
codebase-digest-ai build [PATH]
|
|
142
142
|
|
|
143
143
|
# Specific formats
|
|
144
|
-
codebase-digest build --format html # HTML dashboard only
|
|
145
|
-
codebase-digest build --format markdown # Markdown reports only
|
|
146
|
-
codebase-digest build --format json # JSON data only
|
|
144
|
+
codebase-digest-ai build --format html # HTML dashboard only
|
|
145
|
+
codebase-digest-ai build --format markdown # Markdown reports only
|
|
146
|
+
codebase-digest-ai build --format json # JSON data only
|
|
147
147
|
|
|
148
148
|
# Interactive call graph with depth filtering
|
|
149
|
-
codebase-digest build --graph --graph-depth 3
|
|
149
|
+
codebase-digest-ai build --graph --graph-depth 3
|
|
150
150
|
|
|
151
151
|
# Quick metrics and search
|
|
152
|
-
codebase-digest stats [PATH] # Project statistics
|
|
153
|
-
codebase-digest query "search term" [PATH] # Search patterns
|
|
152
|
+
codebase-digest-ai stats [PATH] # Project statistics
|
|
153
|
+
codebase-digest-ai query "search term" [PATH] # Search patterns
|
|
154
154
|
```
|
|
155
155
|
|
|
156
156
|
## 🎯 Key Features
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "codebase-digest-ai"
|
|
7
|
-
version = "0.1.
|
|
7
|
+
version = "0.1.2"
|
|
8
8
|
description = "AI-native code intelligence engine for semantic codebase analysis"
|
|
9
9
|
authors = [{ name = "Harsh Bothara" }]
|
|
10
10
|
license = { text = "MIT" }
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/analyzer/codebase_analyzer.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/analyzer/flow_analyzer.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/analyzer/metrics_analyzer.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/graph_exporter.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/html_exporter.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/json_exporter.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/markdown_exporter.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/exporters/readme_exporter.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/parser/javascript_parser.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest/parser/python_parser.py
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/SOURCES.txt
RENAMED
|
File without changes
|
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/entry_points.txt
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/requires.txt
RENAMED
|
File without changes
|
{codebase_digest_ai-0.1.1 → codebase_digest_ai-0.1.2}/codebase_digest_ai.egg-info/top_level.txt
RENAMED
|
File without changes
|
|
File without changes
|