{"id":31033392,"url":"https://github.com/alienzhou/project-context-engine","last_synced_at":"2025-09-14T01:52:26.632Z","repository":{"id":310848282,"uuid":"1009145430","full_name":"alienzhou/project-context-engine","owner":"alienzhou","description":"AI-powered tool for codebase analysis, documentation generation, and Markdown rendering with multi-language support and repository structure visualization.","archived":false,"fork":false,"pushed_at":"2025-08-20T14:47:42.000Z","size":436,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-20T16:37:00.648Z","etag":null,"topics":["ai-code-analysis","documentation-generator","repository-map"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alienzhou.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-26T16:43:42.000Z","updated_at":"2025-08-20T14:47:45.000Z","dependencies_parsed_at":"2025-08-20T16:37:16.957Z","dependency_job_id":"af111916-8b65-4e1f-a949-e9501dbe29e3","html_url":"https://github.com/alienzhou/project-context-engine","commit_stats":null,"previous_names":["alienzhou/project-context-engine"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/alienzhou/project-context-engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fproject-context-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fproject-context-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fproject-context-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fproject-context-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alienzhou","download_url":"https://codeload.github.com/alienzhou/project-context-engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fproject-context-engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275051639,"owners_count":25396977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-code-analysis","documentation-generator","repository-map"],"created_at":"2025-09-14T01:52:25.214Z","updated_at":"2025-09-14T01:52:26.616Z","avatar_url":"https://github.com/alienzhou.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Project Context Engine\n\nAn AI-powered project context analysis engine for codebase analysis, documentation generation, and Markdown rendering.\n\n\u003e 🎨 **Special Note**: This project is entirely built using the **Vibe Coding** approach\n\n## 🌐 Languages / 语言支持\n\n- **English** (Default): This README\n- **中文**: [README.zh.md](README.zh.md)\n\n## 🚀 Features\n\n### 📊 Code Analyzer\n\n- **Intelligent Code Analysis**: Analyze codebase structure and functionality using AI technology\n- **Automatic Documentation Generation**: Generate project summaries, API documentation, and code explanations\n- **Repository Map**: Create symbol mapping diagrams of codebases for easy project structure understanding\n- **Language Filtering**: Support specifying particular languages for analysis, improving analysis efficiency and precision\n- **Multi-language Support**: Support TypeScript, JavaScript, Python, Java, Go, C++, and other programming languages\n- **Tree-sitter Parsing**: Use Tree-sitter for precise syntax analysis\n\n### 🎨 Markdown Renderer\n\n- **High-quality Rendering**: Render Markdown files into beautiful HTML\n- **Mermaid Chart Support**: Support flowcharts, sequence diagrams, class diagrams, and other chart types\n- **Theme Switching**: Support both dark and light theme modes\n- **Batch Processing**: Support batch rendering of multiple files\n- **Code Highlighting**: Built-in syntax highlighting functionality\n\n## 🛠 Tech Stack\n\n- **TypeScript**: Type-safe JavaScript development\n- **pnpm**: Efficient package management and monorepo support\n- **Tree-sitter**: Precise code syntax analysis\n- **AI SDK**: Integration with multiple AI services (Amazon Bedrock, Azure)\n- **Mermaid**: Chart and flowchart rendering\n- **Winston**: Logging management\n\n## 📦 Project Structure\n\n```\nproject-context-engine/\n├── apps/\n│   ├── analyzer/           # 🔍 Code Analyzer\n│   │   ├── src/\n│   │   │   ├── code-analyzer/\n│   │   │   │   ├── agent/     # AI agent functionality\n│   │   │   │   ├── parser/    # Code parser\n│   │   │   │   ├── reading/   # Code reading analysis\n│   │   │   │   ├── repomap/   # Repository mapping generation\n│   │   │   │   ├── structure/ # Project structure analysis\n│   │   │   │   └── summary/   # Code summarization functionality\n│   │   │   └── utils/         # Utility functions\n│   │   └── processed/         # Analysis result output\n│   └── render/             # 🎨 Markdown Renderer\n│       ├── src/\n│       ├── data/              # Markdown source files\n│       └── scripts/           # Rendering scripts\n├── packages/\n│   └── common/             # 📚 Shared codebase\n├── test-multilang/         # 🧪 Multi-language test cases\n├── docs/                   # 📖 Documentation\n│   ├── en/                 # English documentation\n│   └── zh/                 # Chinese documentation\n└── ...\n```\n\n## 🚀 Quick Start\n\n### Install Dependencies\n\n```bash\npnpm install\n```\n\n### Build Project\n\n```bash\n# Build entire project\npnpm build\n\n# Build specific packages separately\npnpm build:common    # Build shared package\npnpm build:analyzer  # Build code analyzer\n```\n\n### Run Code Analyzer\n\n```bash\n# Start code analyzer\npnpm start\n\n# Development mode\npnpm dev\n```\n\n### Use Markdown Renderer\n\n```bash\n# Enter renderer directory\ncd apps/render\n\n# Render single file\nnpm run render\n\n# Render all files\nnpm run render:all\n\n# Render with light theme\nnpm run render:all:light\n```\n\n## 📋 Available Scripts\n\n### Global Scripts\n\n```bash\npnpm build          # Build all packages\npnpm dev            # Development mode\npnpm start          # Start analyzer application\npnpm test           # Run tests\npnpm typecheck      # TypeScript type checking\npnpm lint           # Code linting\npnpm format         # Code formatting\npnpm clean          # Clean build files\n```\n\n### Code Analyzer Specific\n\n```bash\npnpm start                              # Start analyzer\ncd apps/analyzer \u0026\u0026 pnpm test-repomap  # Test repository mapping functionality\n\n# Repository Map language filtering functionality\ncd apps/analyzer\nnode dist/code-analyzer/repomap/cli.js \u003cdirectory\u003e --language python    # Analyze only Python files\nnode dist/code-analyzer/repomap/cli.js \u003cdirectory\u003e -l typescript        # Analyze only TypeScript files\nnode test-repomap.js --language java                                    # Test specific language\n```\n\n## 🔧 Development Guide\n\n### Add Dependencies\n\nUse pnpm workspace to add dependencies for specific packages:\n\n```bash\n# Add dependency for analyzer\npnpm --filter @project-context-engine/analyzer add \u003cdependency\u003e\n\n# Add dependency for renderer\npnpm --filter @project/render add \u003cdependency\u003e\n\n# Add dependency for shared package\npnpm --filter @project-context-engine/common add \u003cdependency\u003e\n```\n\n### Run Package-specific Scripts\n\n```bash\npnpm --filter \u003cpackage-name\u003e \u003cscript\u003e\n```\n\n### Dependencies\n\nThe project uses workspace protocol to manage internal dependencies:\n\n```json\n{\n  \"dependencies\": {\n    \"@project-context-engine/common\": \"workspace:*\"\n  }\n}\n```\n\n## 🌟 Key Features\n\n### Intelligent Code Analysis\n\n- Automatically identify project architecture and design patterns\n- Generate detailed code documentation and explanations\n- Create project structure trees and dependency relationship diagrams\n\n### AI-driven Documentation Generation\n\n- Leverage large language models to understand code logic\n- Automatically generate README, API documentation\n- Provide code improvement suggestions\n\n### Multi-format Output\n\n- Markdown format analysis reports\n- HTML format visualization documentation\n- JSON format structured data\n\n## 📚 Documentation\n\nThe project supports bilingual documentation in Chinese and English:\n\n- **English Documentation**: [docs/en/README.md](docs/en/README.md)\n- **中文文档**: [docs/zh/README.md](docs/zh/README.md)\n\n### Detailed Documentation\n\n- **Code Analyzer Documentation**: [docs/en/analyzer/](docs/en/analyzer/)\n  - [Repo Map User Guide](docs/en/analyzer/repo-map.md)\n  - [Technical Manual](docs/en/analyzer/repo-map-technical.md)\n  - [Test Guide](docs/en/analyzer/repo-map-test-guide.md)\n\n- **Markdown Renderer Documentation**: [docs/en/render/README.md](docs/en/render/README.md)\n\n- **Multi-language Test Cases**: [docs/en/test-multilang/README.md](docs/en/test-multilang/README.md)\n\n## 📄 License\n\nISC License\n\n## 🤝 Contributing\n\nWelcome to submit Issues and Pull Requests to help improve the project.\n\n---\n\n**Project Context Engine** - Making code analysis and documentation generation simple and efficient 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falienzhou%2Fproject-context-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falienzhou%2Fproject-context-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falienzhou%2Fproject-context-engine/lists"}