{"id":30752509,"url":"https://github.com/divkix/ai-code-improvement-platform","last_synced_at":"2026-04-28T21:34:20.589Z","repository":{"id":309117145,"uuid":"1023428907","full_name":"Divkix/ai-code-improvement-platform","owner":"Divkix","description":"AI powered code improvement platform using Voyage AI, Qdrant, MongoDB and Claude Sonnet 4","archived":false,"fork":false,"pushed_at":"2025-11-20T02:14:21.000Z","size":13803,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-15T09:51:41.634Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","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/Divkix.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-21T06:42:04.000Z","updated_at":"2025-11-10T02:16:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"d0b9fbaf-766f-4e0a-8312-98daff8c9459","html_url":"https://github.com/Divkix/ai-code-improvement-platform","commit_stats":null,"previous_names":["divkix/ai-code-improvement-platform"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Divkix/ai-code-improvement-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Divkix%2Fai-code-improvement-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Divkix%2Fai-code-improvement-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Divkix%2Fai-code-improvement-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Divkix%2Fai-code-improvement-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Divkix","download_url":"https://codeload.github.com/Divkix/ai-code-improvement-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Divkix%2Fai-code-improvement-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32400866,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T19:38:08.556Z","status":"ssl_error","status_checked_at":"2026-04-28T19:37:55.688Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2025-09-04T08:09:27.945Z","updated_at":"2026-04-28T21:34:20.566Z","avatar_url":"https://github.com/Divkix.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Code Fixing Platform\n\n\u003c!-- Uncomment once CI is live --\u003e\n\u003c!--[![CI](https://github.com/your-org/ai-code-improvement-platform/actions/workflows/ci.yml/badge.svg)](https://github.com/your-org/ai-code-improvement-platform/actions/workflows/ci.yml)--\u003e\n\nAn automated code fixing engine that transforms from \"smart text search\" into AI-powered code fixing with AST-based analysis, knowledge graphs, and validated solution generation. Delivers complete, tested fixes for technical debt and code quality issues.\n\n## Table of Contents\n\n- [AI Code Fixing Platform](#ai-code-fixing-platform)\n  - [Table of Contents](#table-of-contents)\n  - [✨ Key Features](#-key-features)\n  - [🏗️ Tech Stack](#️-tech-stack)\n  - [📂 Repository Layout (top-level)](#-repository-layout-top-level)\n  - [🚀 Quick Start (Production-like)](#-quick-start-production-like)\n    - [Local Development Hot-Reload](#local-development-hot-reload)\n  - [🛠️ Backend Development](#️-backend-development)\n    - [Environment Variables (partial list)](#environment-variables-partial-list)\n    - [API Documentation](#api-documentation)\n  - [🌐 Frontend Development](#-frontend-development)\n    - [Regenerate Typed API Client](#regenerate-typed-api-client)\n  - [🧪 Testing All Services](#-testing-all-services)\n  - [🖥️ Makefile Cheat-Sheet](#️-makefile-cheat-sheet)\n  - [🤝 Contributing](#-contributing)\n  - [📄 License](#-license)\n\n---\n\n## ✨ Key Features\n\n- **Automated Code Fixing** – AST-based problem detection with AI-generated solutions and comprehensive validation\n- **Knowledge Graph Analysis** – understand code relationships, dependencies, and architectural patterns through Neo4j integration  \n- **Multi-Modal Understanding** – combines code structure, comments, tests, and documentation for complete context\n- **Fix Validation System** – syntax, compilation, behavioral, and security validation ensuring safe code changes\n- **Hierarchical Code Summarization** – semantic clustering from individual functions to system-wide architecture\n- **Program Dependence Graphs** – control and data flow analysis for precise change impact prediction\n- **Incremental Analysis** – real-time repository updates with smart caching and change propagation\n- **Repository-Level Reasoning** – CodePlan-inspired planning for complex architectural queries and multi-step fixes\n- **GitHub OAuth Integration** – secure repository access with automated import and progress tracking\n- **Type-Safe API** – OpenAPI-first development with generated types for backend and frontend\n\n---\n\n## 🏗️ Tech Stack\n\n| Layer       | Technology |\n|-------------|------------|\n| **Frontend**| SvelteKit + TypeScript, TailwindCSS, openapi-fetch |\n| **Backend** | Go 1.24+ (Gin), MongoDB, Qdrant, Neo4j, Tree-sitter AST parsers |\n| **AI/ML**   | OpenAI-compatible LLM, Voyage AI embeddings, AST-based analysis |\n| **Analysis**| Program dependence graphs, control/data flow analysis, semantic clustering |\n| **Auth**    | JWT sessions, GitHub OAuth for repository access |\n| **Infra**   | Docker Compose, multi-service orchestration, hot-reload development |\n\n---\n\n## 📂 Repository Layout (top-level)\n\n```\nbackend/    # Go services, API, generation \u0026 Dockerfiles\nfrontend/   # SvelteKit application\nmongodb-init/  # Mongo seed user scripts\nMakefile    # helper commands (docker compose, build, test)\ndocker-compose[.dev].yml  # multi-service orchestration\n```\n\n---\n\n## 🚀 Quick Start (Production-like)\n\nThe simplest way to spin everything up is Docker Compose:\n\n```bash\n# Build \u0026 start in the background\nmake up               # defaults to env=prod → docker-compose.yml\n\n# Tail logs\nmake logs\n\n# Shutdown\nmake down\n```\n\nThe **prod** stack uses the regular `Dockerfile` images for both frontend and backend.\n\n### Local Development Hot-Reload\n\n```bash\n# Start dev versions (hot-reload, vite, go run, etc.)\nmake up env=dev       # uses docker-compose.dev.yml\n```\n\nBehind the scenes the dev compose file mounts your source directories and uses **`Dockerfile.dev`** images that have nodemon / reflex / vite dev servers.\n\n---\n\n## 🛠️ Backend Development\n\n```bash\ncd backend\n\n# Run unit tests with race detector \u0026 coverage\nmake test\n\n# Lint \u0026 vet\nmake validate\n\n# Hot-reload standalone (without docker)\nmake backend-dev\n```\n\n### Environment Variables (partial list)\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `PORT` | 8080 | HTTP listen port |\n| `MONGODB_URI` | mongodb://localhost:27017/acip | Mongo connection string |\n| `QDRANT_URL` | http://localhost:6334 | Qdrant vector database |\n| `NEO4J_URI` / `NEO4J_USER` / `NEO4J_PASSWORD` | bolt://localhost:7687 / neo4j / password | Neo4j knowledge graph database |\n| `JWT_SECRET` | *required* | HMAC secret for JWT tokens |\n| `GITHUB_CLIENT_ID` / `GITHUB_CLIENT_SECRET` | – | GitHub OAuth credentials |\n| `LLM_API_KEY` | *required* | API key for OpenAI-compatible LLM |\n| `EMBEDDING_API_KEY` | – | API key for embedding provider |\n| `ENABLE_AST_ANALYSIS` | true | Enable AST-based code analysis |\n| `ANALYSIS_DEPTH` | semantic | Analysis depth: basic, ast, semantic, full |\n| `TREE_SITTER_PATH` | /usr/local/lib/tree-sitter | Path to tree-sitter parsers |\n\nSee `backend/internal/config/config.go` for the full configuration matrix.\n\n### API Documentation\n\nSwagger-UI is automatically served at:\n\n```\nhttp://localhost:8080/docs/\n```\n\nThe spec lives in `backend/api/openapi.yaml`. Convert to JSON via:\n\n```bash\nmake -C backend openapi-json\n```\n\n---\n\n## 🌐 Frontend Development\n\n```bash\ncd frontend\nbun install            # or npm / pnpm / yarn\ncp .env.example .env.local\nbun run dev            # localhost:3000\n```\n\n`VITE_API_URL` must point to the backend URL (defaults to `http://localhost:8080`).\n\n### Regenerate Typed API Client\n\n```bash\nbun run generate-api   # parses backend OpenAPI spec → src/lib/api/types.ts\n```\n\nUnit tests: `bun run test:unit`\n\nE2E tests (Playwright): `bun run test:e2e`\n\n---\n\n## 🧪 Testing All Services\n\n1. Ensure **MongoDB**, **Qdrant** \u0026 **Neo4j** services are running (`make up env=dev`).\n2. Run backend tests: `make test`.\n3. Run frontend unit \u0026 e2e tests: `cd frontend \u0026\u0026 bun run test`.\n4. Validate fix generation and AST analysis: `make validate`.\n\n---\n\n## 🖥️ Makefile Cheat-Sheet\n\n```\nmake up [env=dev|prod]       # build \u0026 start stack\nmake down [env=..]           # stop stack\nmake clean                   # down + remove volumes\nmake logs service=\u003cname\u003e     # follow logs\nmake generate                # go generate API stubs\nmake backend-dev             # run backend with hot reload\n```\n\n---\n\n## 🤝 Contributing\n\n1. Fork \u0026 clone the repo.\n2. Create a feature branch: `git checkout -b feat/my-feature`.\n3. Run `make validate` to ensure code passes lints/tests.\n4. Submit a pull request – please describe the motivation and include screenshots / logs where relevant.\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdivkix%2Fai-code-improvement-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdivkix%2Fai-code-improvement-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdivkix%2Fai-code-improvement-platform/lists"}