projectify-cli 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# Projectify
+
+> **Autonomous Code Analysis & Visualization Engine**
+
+Projectify is a powerful, standalone Node.js tool designed to analyze codebase architectures, calculate dependency impacts ("Blast Radius"), and generate stunning, interactive visualizations. Built with TypeScript and powered by AI.
+
+![Projectify HTML Report](./graph.png)
+![Projectify HTML Report](./functions.png)
+
+## Features
+
+- **AI-Powered Insights**: Uses OpenAI (LangChain) to summarize architecture and explain high-risk components.
+- **Blast Radius Calculation**: Instantly identify the most critical files in your project based on dependency impact.
+- **Interactive Visualization**: Generates a premium, Shadcn-style HTML report with physics-based graphs and search.
+- **Multi-Language Support**:
+  - JavaScript / TypeScript (AST-based)
+  - Python (Regex/Heuristic-based)
+- **Fast & Standalone**: optimized for speed, zero external Python dependencies.
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/your-repo/projectify.git
+
+# Install dependencies
+cd projectify-cli
+npm install
+
+# Build the project
+npm run build
+```
+
+## Usage
+
+### Using npx (Recommended)
+
+Run directly without installing:
+
+```bash
+npx projectify-cli [path] [options]
+```
+
+### Global Installation
+
+```bash
+npm install -g projectify-cli
+
+# Run anywhere
+projectify [path] [options]
+```
+
+### Local Development
+
+Run the analyzer on any project directory:
+
+```bash
+# Basic Analysis
+npm start -- /path/to/target/project
+
+# Analysis with AI Summary (Requires API Key)
+export OPENAI_API_KEY=sk-your-key-here
+export GEMINI_API_KEY=sk-your-key-here
+export OLLAMA_API_KEY=sk-your-key-here
+npm start -- /path/to/target/project --summary
+```
+
+### CLI Options
+- `path`: (Optional) Path to the project to analyze. Defaults to current directory.
+- `--summary`: Enable AI-powered project summarization.
+- `--no-ai`: Disable individual file AI analysis.
+
+## Output
+
+All reports are generated in the `projectify-cli` directory:
+
+| File | Description |
+|------|-------------|
+| `analysis-report.html` | **Interactive Dashboard**. View dependency graphs, search nodes, and see detailed stats. |
+| `analysis-report.json` | **Raw Data**. Complete dependency graph and metrics in JSON format. |
+| `project-summary.md` | **AI Report**. High-level architecture overview and risk assessment. |
+
+## Architecture
+
+- **Scanner**: Fast-glob based file traversal.
+- **Analyzer**: Babel-based AST parsing for JS/TS; Custom regex parser for Python.
+- **Graph Engine**: Directed graph construction with cycle detection and impact scoring.
+- **UI**: Customized `vis-network` with Tailwind CSS (Shadcn/Zinc theme).
+
+## Developer
+
+Developed by **GreenHacker**.
+
+

package/dist/ai/index.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeIntelligence = void 0;
+const openai_1 = require("@langchain/openai");
+const google_genai_1 = require("@langchain/google-genai");
+const ollama_1 = require("@langchain/ollama");
+const prebuilt_1 = require("@langchain/langgraph/prebuilt");
+const langgraph_1 = require("@langchain/langgraph");
+const messages_1 = require("@langchain/core/messages");
+class CodeIntelligence {
+    constructor(provider, apiKey, modelName) {
+        let model;
+        // Initialize Model based on Provider
+        if (provider === 'openai') {
+            if (!apiKey)
+                throw new Error("OpenAI API Key required");
+            model = new openai_1.ChatOpenAI({
+                apiKey,
+                modelName: modelName || 'gpt-4o',
+                temperature: 0
+            });
+        }
+        else if (provider === 'gemini') {
+            if (!apiKey)
+                throw new Error("Gemini API Key required");
+            model = new google_genai_1.ChatGoogleGenerativeAI({
+                apiKey,
+                model: modelName || 'gemini-1.5-flash',
+                temperature: 0
+            });
+        }
+        else if (provider === 'ollama') {
+            model = new ollama_1.ChatOllama({
+                baseUrl: 'http://localhost:11434',
+                model: modelName || 'llama3',
+                temperature: 0
+            });
+        }
+        else {
+            throw new Error(`Unsupported provider: ${provider}`);
+        }
+        // Initialize Memory
+        const checkpointer = new langgraph_1.MemorySaver();
+        // Create Agent
+        this.agent = (0, prebuilt_1.createReactAgent)({
+            llm: model,
+            tools: [],
+            checkpointSaver: checkpointer
+        });
+        // Config for thread persistence
+        this.config = { configurable: { thread_id: "project-analysis-session" } };
+    }
+    async askAgent(systemPrompt, userContent) {
+        const result = await this.agent.invoke({
+            messages: [
+                new messages_1.SystemMessage(systemPrompt),
+                new messages_1.HumanMessage(userContent)
+            ]
+        }, this.config);
+        const lastMessage = result.messages[result.messages.length - 1];
+        return lastMessage.content;
+    }
+    async summarizeFile(fileName, content) {
+        return this.askAgent('You are an expert code analyst. Summarize the purpose of this file in 1-2 sentences.', `File: ${fileName}\n\nCode:\n${content.substring(0, 5000)}`);
+    }
+    async analyzeBlastRadius(node) {
+        return this.askAgent('You are an expert software architect. Explain why this file has a high blast radius and the risks involved.', `File: ${node.id} is imported by ${node.affectedFiles} other files (${node.blastRadius.toFixed(2)}% of the codebase).`);
+    }
+    async generateProjectSummary(fileCount, topRisks, files) {
+        return this.askAgent('You are a technical lead. Provide a high-level summary of this project based on the file statistics and high-risk components.', `
+            Project Statistics:
+            - Total Files: ${fileCount}
+            
+            Key Components (High Dependency/Risk):
+            ${topRisks.map(n => `- ${n.id} (Impacts ${n.affectedFiles} files)`).join('\n')}
+            
+            File List Sample:
+            ${files.slice(0, 50).join('\n')}
+            
+            Please provide:
+            1. An estimated architecture type.
+            2. Key risks.
+            3. Recommendations.
+            `);
+    }
+    async analyzeGitHistory(gitStats) {
+        return this.askAgent('You are a technical lead analyzing project evolution. Provide insights based on commit history.', `
+            Git History Statistics:
+            - Total Commits: ${gitStats.totalCommits}
+            - Active Authors: ${gitStats.authroStats.length}
+            
+            Top Authors:
+            ${gitStats.authroStats.slice(0, 5).map((a) => `- ${a.name}: ${a.commits} commits`).join('\n')}
+            
+            Recent Activity:
+            ${gitStats.recentActivity.join('\n')}
+            `);
+    }
+}
+exports.CodeIntelligence = CodeIntelligence;

package/dist/ai/providers/base.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/ai/providers/gemini.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiProvider = void 0;
+const generative_ai_1 = require("@google/generative-ai");
+class GeminiProvider {
+    constructor(apiKey, modelName = 'gemini-1.5-flash') {
+        this.genAI = new generative_ai_1.GoogleGenerativeAI(apiKey);
+        this.model = this.genAI.getGenerativeModel({ model: modelName });
+    }
+    async generateText(prompt) {
+        const result = await this.model.generateContent(prompt);
+        const response = await result.response;
+        return response.text();
+    }
+    async summarizeFile(fileName, content) {
+        return this.generateText(`You are an expert code analyst. Summarize the purpose of this file in 1-2 sentencs.\n\nFile: ${fileName}\n\nCode:\n${content.substring(0, 10000)}`);
+    }
+    async analyzeBlastRadius(riskNode) {
+        return this.generateText(`You are an expert software architect. Explain why this file has a high blast radius and the risks involved.\n\nFile: ${riskNode.id} is imported by ${riskNode.affectedFiles} other files (${riskNode.blastRadius.toFixed(2)}% of the codebase).`);
+    }
+    async generateProjectSummary(fileCount, topRisks, files) {
+        return this.generateText(`You are a technical lead. Provide a high-level summary of this project based on the file statistics and high-risk components.\n\n
+            Project Statistics:
+            - Total Files: ${fileCount}
+            
+            Key Components (High Dependency/Risk):
+            ${topRisks.map(n => `- ${n.id} (Impacts ${n.affectedFiles} files)`).join('\n')}
+            
+            File List Sample:
+            ${files.slice(0, 50).join('\n')}
+            
+            Please provide:
+            1. An estimated architecture type (CLI, Web App, Library, etc.).
+            2. Key risks based on the high-dependency components.
+            3. Recommendations for improvement.`);
+    }
+    async analyzeGitHistory(gitStats) {
+        return this.generateText(`You are a technical lead analyzing project evolution. Provide insights based on commit history.
+            
+            Git History Statistics:
+            - Total Commits: ${gitStats.totalCommits}
+            - Active Authors: ${gitStats.authroStats.length}
+            
+            Top Authors:
+            ${gitStats.authroStats.slice(0, 5).map((a) => `- ${a.name}: ${a.commits} commits`).join('\n')}
+            
+            Recent Activity:
+            ${gitStats.recentActivity.join('\n')}
+
+            Please provide:
+            1. Assessment of project activity (Active/Stale).
+            2. Key contributors analysis.
+            3. Recent development focus based on commit messages.`);
+    }
+}
+exports.GeminiProvider = GeminiProvider;

package/dist/ai/providers/ollama.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaProvider = void 0;
+const node_fetch_1 = __importDefault(require("node-fetch")); // Ensure node-fetch is available or use global fetch if on Node 18+
+class OllamaProvider {
+    constructor(modelName = 'llama3', baseUrl = 'http://localhost:11434') {
+        this.modelName = modelName;
+        this.baseUrl = baseUrl;
+    }
+    async generate(prompt) {
+        try {
+            const response = await (0, node_fetch_1.default)(`${this.baseUrl}/api/generate`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.modelName,
+                    prompt: prompt,
+                    stream: false
+                })
+            });
+            const data = await response.json();
+            return data.response;
+        }
+        catch (error) {
+            console.error('Ollama generation failed:', error);
+            return 'Ollama analysis failed. Ensure Ollama is running.';
+        }
+    }
+    async summarizeFile(fileName, content) {
+        return this.generate(`Summarize this file in 1-2 sentences:\nFile: ${fileName}\nCode:\n${content.substring(0, 2000)}`);
+    }
+    async analyzeBlastRadius(riskNode) {
+        return this.generate(`Explain high blast radius risks for: ${riskNode.id} (Imported by ${riskNode.affectedFiles} files).`);
+    }
+    async generateProjectSummary(fileCount, topRisks, files) {
+        return this.generate(`Summarize project architecture and risks based on:
+            ${fileCount} files.
+            Top Risks: ${topRisks.map(n => n.id).join(', ')}.`);
+    }
+    async analyzeGitHistory(gitStats) {
+        return this.generate(`Analyze project evolution based on git history:
+             Total Commits: ${gitStats.totalCommits}.
+             Recent Activity: ${gitStats.recentActivity.join('\n')}.
+             Provide insights on activity and focus.`);
+    }
+}
+exports.OllamaProvider = OllamaProvider;

package/dist/ai/providers/openai.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIProvider = void 0;
+const openai_1 = require("@langchain/openai");
+const messages_1 = require("@langchain/core/messages");
+class OpenAIProvider {
+    constructor(apiKey, modelName = 'gpt-4o') {
+        this.model = new openai_1.ChatOpenAI({
+            openAIApiKey: apiKey,
+            temperature: 0,
+            modelName
+        });
+    }
+    async summarizeFile(fileName, content) {
+        const response = await this.model.invoke([
+            new messages_1.SystemMessage('You are an expert code analyst. Summarize the purpose of this file in 1-2 sentencs.'),
+            new messages_1.HumanMessage(`File: ${fileName}\n\nCode:\n${content.substring(0, 4000)}`)
+        ]);
+        return response.content;
+    }
+    async analyzeBlastRadius(riskNode) {
+        const response = await this.model.invoke([
+            new messages_1.SystemMessage('You are an expert software architect. Explain why this file has a high blast radius and the risks involved.'),
+            new messages_1.HumanMessage(`File: ${riskNode.id} is imported by ${riskNode.affectedFiles} other files (${riskNode.blastRadius.toFixed(2)}% of the codebase).`)
+        ]);
+        return response.content;
+    }
+    async generateProjectSummary(fileCount, topRisks, files) {
+        const response = await this.model.invoke([
+            new messages_1.SystemMessage('You are a technical lead. Provide a high-level summary of this project based on the file statistics and high-risk components.'),
+            new messages_1.HumanMessage(`
+            Project Statistics:
+            - Total Files: ${fileCount}
+            
+            Key Components (High Dependency/Risk):
+            ${topRisks.map(n => `- ${n.id} (Impacts ${n.affectedFiles} files)`).join('\n')}
+            
+            File List Sample:
+            ${files.slice(0, 50).join('\n')}
+            
+            Please provide:
+            1. An estimated architecture type (CLI, Web App, Library, etc.).
+            2. Key risks based on the high-dependency components.
+            3. Recommendations for improvement.
+          `)
+        ]);
+        return response.content;
+    }
+    async analyzeGitHistory(gitStats) {
+        const response = await this.model.invoke([
+            new messages_1.SystemMessage('You are a technical lead analyzing project evolution. Provide insights based on commit history.'),
+            new messages_1.HumanMessage(`
+                Git History Statistics:
+                - Total Commits: ${gitStats.totalCommits}
+                - Active Authors: ${gitStats.authroStats.length}
+                
+                Top Authors:
+                ${gitStats.authroStats.slice(0, 5).map((a) => `- ${a.name}: ${a.commits} commits`).join('\n')}
+                
+                Recent Activity:
+                ${gitStats.recentActivity.join('\n')}
+
+                Please provide:
+                1. Assessment of project activity (Active/Stale).
+                2. Key contributors analysis.
+                3. Recent development focus based on commit messages.
+            `)
+        ]);
+        return response.content;
+    }
+}
+exports.OpenAIProvider = OpenAIProvider;

package/dist/analyzer/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeFiles = analyzeFiles;
+const path_1 = __importDefault(require("path"));
+const fileUtils_1 = require("../utils/fileUtils");
+const javascript_1 = require("./parsers/javascript");
+const python_1 = require("./parsers/python");
+async function analyzeFiles(filePaths) {
+    const analysis = {
+        fileCount: filePaths.length,
+        files: {}
+    };
+    for (const filePath of filePaths) {
+        const content = await (0, fileUtils_1.readFileSafe)(filePath);
+        if (!content)
+            continue;
+        const ext = path_1.default.extname(filePath);
+        let fileResult = { imports: [], exports: [], functions: [], classes: [] };
+        if (['.js', '.jsx', '.ts', '.tsx'].includes(ext)) {
+            fileResult = (0, javascript_1.parseJS)(content, filePath);
+        }
+        else if (['.py'].includes(ext)) {
+            fileResult = (0, python_1.parsePython)(content, filePath);
+        }
+        else {
+            // TODO: Add generic regex parser
+        }
+        analysis.files[filePath] = fileResult;
+    }
+    return analysis;
+}

package/dist/analyzer/parsers/javascript.js

@@ -0,0 +1,137 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJS = parseJS;
+const parser_1 = require("@babel/parser");
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const t = __importStar(require("@babel/types"));
+const path_1 = __importDefault(require("path"));
+function parseJS(content, filePath) {
+    const analysis = {
+        imports: [],
+        exports: [],
+        functions: [],
+        classes: []
+    };
+    try {
+        const isTs = filePath.endsWith('.ts') || filePath.endsWith('.tsx');
+        const ast = (0, parser_1.parse)(content, {
+            sourceType: 'module',
+            errorRecovery: true,
+            plugins: [
+                'jsx',
+                'typescript',
+                'asyncGenerators',
+                'bigInt',
+                'classProperties',
+                'classPrivateProperties',
+                'classPrivateMethods',
+                'decorators-legacy',
+                'doExpressions',
+                'dynamicImport',
+                'exportDefaultFrom',
+                'exportNamespaceFrom',
+                'functionBind',
+                'functionSent',
+                'importMeta',
+                'logicalAssignment',
+                'nullishCoalescingOperator',
+                'numericSeparator',
+                'objectRestSpread',
+                'optionalCatchBinding',
+                'optionalChaining',
+                'partialApplication'
+            ]
+        });
+        (0, traverse_1.default)(ast, {
+            ImportDeclaration(path) {
+                analysis.imports.push(path.node.source.value);
+            },
+            ExportNamedDeclaration(path) {
+                if (path.node.declaration) {
+                    if (t.isFunctionDeclaration(path.node.declaration) && path.node.declaration.id) {
+                        analysis.exports.push(path.node.declaration.id.name);
+                    }
+                    else if (t.isVariableDeclaration(path.node.declaration)) {
+                        path.node.declaration.declarations.forEach(d => {
+                            if (t.isIdentifier(d.id)) {
+                                analysis.exports.push(d.id.name);
+                            }
+                        });
+                    }
+                    else if (t.isClassDeclaration(path.node.declaration) && path.node.declaration.id) {
+                        analysis.exports.push(path.node.declaration.id.name);
+                    }
+                }
+            },
+            FunctionDeclaration(path) {
+                if (path.node.id && path.node.loc) {
+                    const start = path.node.loc.start.line - 1;
+                    const end = path.node.loc.end.line;
+                    const code = content.split('\n').slice(start, end).join('\n');
+                    const params = path.node.params.map(p => {
+                        if (t.isIdentifier(p))
+                            return p.name;
+                        if (t.isAssignmentPattern(p) && t.isIdentifier(p.left))
+                            return p.left.name;
+                        return 'arg';
+                    });
+                    const doc = path.node.leadingComments
+                        ? path.node.leadingComments.map(c => c.value.trim()).join('\n')
+                        : undefined;
+                    analysis.functions.push({
+                        name: path.node.id.name,
+                        line: path.node.loc.start.line,
+                        params: params,
+                        doc: doc,
+                        code: code
+                    });
+                }
+            },
+            ClassDeclaration(path) {
+                if (path.node.id) {
+                    analysis.classes.push(path.node.id.name);
+                }
+            }
+        });
+    }
+    catch (error) {
+        console.warn(`⚠️  Parser warning in ${path_1.default.basename(filePath)}: ${error.message?.split('\n')[0]}`);
+    }
+    return analysis;
+}

package/dist/analyzer/parsers/python.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePython = parsePython;
+function parsePython(content, filePath) {
+    const analysis = {
+        imports: [],
+        exports: [],
+        functions: [],
+        classes: []
+    };
+    const lines = content.split('\n');
+    // Regex patterns
+    const importRegex = /^(?:from|import)\s+([\w\.]+)/;
+    const defRegex = /^\s*def\s+([a-zA-Z_]\w*)/;
+    const classRegex = /^\s*class\s+([a-zA-Z_]\w*)/;
+    const assignRegex = /^([a-zA-Z_]\w*)\s*=/; // Global assignments
+    lines.forEach((line, index) => {
+        // Imports
+        const importMatch = line.match(importRegex);
+        if (importMatch) {
+            analysis.imports.push(importMatch[1]);
+        }
+        // Functions
+        const defMatch = line.match(defRegex);
+        if (defMatch) {
+            analysis.functions.push({
+                name: defMatch[1],
+                line: index + 1,
+                params: [], // Regex parser doesn't extract params yet
+                doc: undefined,
+                code: undefined
+            });
+            // Python functions at module level are exports
+            analysis.exports.push(defMatch[1]);
+        }
+        // Classes
+        const classMatch = line.match(classRegex);
+        if (classMatch) {
+            analysis.classes.push(classMatch[1]);
+            analysis.exports.push(classMatch[1]);
+        }
+    });
+    return analysis;
+}