codegraph-cli 2.1.1__py3-none-any.whl → 2.1.3__py3-none-any.whl

codegraph_cli-2.1.1.dist-info/METADATA

@@ -1,364 +0,0 @@
-Metadata-Version: 2.4
-Name: codegraph-cli
-Version: 2.1.1
-Summary: AI-powered code intelligence CLI with multi-agent analysis, impact graphs, and conversational coding.
-Author-email: Ali Nasir <muhammadalinasir00786@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/al1-nasir/codegraph-cli
-Project-URL: Documentation, https://github.com/al1-nasir/codegraph-cli#readme
-Project-URL: Repository, https://github.com/al1-nasir/codegraph-cli
-Project-URL: Issues, https://github.com/al1-nasir/codegraph-cli/issues
-Project-URL: Changelog, https://github.com/al1-nasir/codegraph-cli/blob/main/CHANGELOG.md
-Keywords: code-analysis,code-intelligence,cli,ai,code-graph,rag,impact-analysis,refactoring,crewai,multi-agent
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Code Generators
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Environment :: Console
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.31.0
-Requires-Dist: typer<1.0.0,>=0.12.0
-Requires-Dist: toml>=0.10.2
-Requires-Dist: lancedb>=0.4.0
-Requires-Dist: pyarrow>=14.0.0
-Requires-Dist: tree-sitter>=0.24.0
-Requires-Dist: tree-sitter-python>=0.23.0
-Requires-Dist: tree-sitter-javascript>=0.23.0
-Requires-Dist: tree-sitter-typescript>=0.23.0
-Requires-Dist: litellm>=1.30.0
-Provides-Extra: crew
-Requires-Dist: crewai>=0.80.0; extra == "crew"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.11.0; extra == "dev"
-Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=5.0.0; extra == "dev"
-Provides-Extra: embeddings
-Requires-Dist: torch>=2.0.0; extra == "embeddings"
-Requires-Dist: transformers<5.0.0,>=4.48.0; extra == "embeddings"
-Provides-Extra: all
-Requires-Dist: crewai>=0.80.0; extra == "all"
-Requires-Dist: torch>=2.0.0; extra == "all"
-Requires-Dist: transformers<5.0.0,>=4.48.0; extra == "all"
-Dynamic: license-file
-
-# CodeGraph CLI
-
-**Code intelligence from the terminal. Semantic search, impact analysis, multi-agent code generation, and conversational coding — all backed by your choice of LLM.**
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org)
-[![Version](https://img.shields.io/badge/version-2.1.0-blue.svg)](https://github.com/al1-nasir/codegraph-cli)
-
----
-
-## Overview
-
-CodeGraph CLI (`cg`) parses your codebase into a semantic graph, then exposes that graph through search, impact analysis, visualization, and a conversational interface. It supports six LLM providers and optionally runs a CrewAI multi-agent system that can read, write, patch, and rollback files autonomously.
-
-Core capabilities:
-
-- **Semantic Search** — find code by meaning, not string matching
-- **Impact Analysis** — trace multi-hop dependencies before making changes
-- **Graph Visualization** — interactive HTML and Graphviz DOT exports
-- **Conversational Chat** — natural language coding sessions with RAG context
-- **Multi-Agent System** — CrewAI-powered agents for code generation, refactoring, and analysis
-- **File Rollback** — automatic backups before every file modification
-
----
-
-## Installation
-
-```bash
-pip install codegraph-cli
-```
-
-With neural embedding models (semantic code search):
-
-```bash
-pip install codegraph-cli[embeddings]
-```
-
-With CrewAI multi-agent support:
-
-```bash
-pip install codegraph-cli[crew]
-```
-
-Everything:
-
-```bash
-pip install codegraph-cli[all]
-```
-
-For development:
-
-```bash
-git clone https://github.com/al1-nasir/codegraph-cli.git
-cd codegraph-cli
-pip install -e ".[dev]"
-```
-
----
-
-## Quick Start
-
-### 1. Configure your LLM provider
-
-```bash
-cg setup
-```
-
-This runs an interactive wizard that writes configuration to `~/.codegraph/config.toml`. Alternatively, switch providers directly:
-
-```bash
-cg set-llm openrouter
-cg set-llm groq
-cg set-llm ollama
-```
-
-### 2. Index a project
-
-```bash
-cg index /path/to/project --name myproject
-```
-
-This parses the source tree using tree-sitter, builds a dependency graph in SQLite, and generates embeddings for semantic search.
-
-### 3. Use it
-
-```bash
-cg search "authentication logic"
-cg impact UserService --hops 3
-cg graph process_payment --depth 2
-cg chat start
-cg chat start --crew    # multi-agent mode
-```
-
----
-
-## Supported LLM Providers
-
-| Provider | Type | Configuration |
-|----------|------|---------------|
-| Ollama | Local, free | `cg set-llm ollama` |
-| Groq | Cloud, free tier | `cg set-llm groq` |
-| OpenAI | Cloud | `cg set-llm openai` |
-| Anthropic | Cloud | `cg set-llm anthropic` |
-| Gemini | Cloud | `cg set-llm gemini` |
-| OpenRouter | Cloud, multi-model | `cg set-llm openrouter` |
-
-All configuration is stored in `~/.codegraph/config.toml`. No environment variables required.
-
-```bash
-cg show-llm        # view current provider, model, and endpoint
-cg unset-llm       # reset to defaults
-```
-
----
-
-## Embedding Models
-
-CodeGraph supports configurable embedding models for semantic code search. Choose based on your hardware and quality needs:
-
-| Model | Download | Dim | Quality | Command |
-|-------|----------|-----|---------|---------|
-| hash | 0 bytes | 256 | Keyword-only | `cg set-embedding hash` |
-| minilm | ~80 MB | 384 | Decent | `cg set-embedding minilm` |
-| bge-base | ~440 MB | 768 | Good | `cg set-embedding bge-base` |
-| jina-code | ~550 MB | 768 | Code-aware | `cg set-embedding jina-code` |
-| qodo-1.5b | ~6.2 GB | 1536 | Best | `cg set-embedding qodo-1.5b` |
-
-The default is `hash` (zero-dependency, no download). Neural models require the `[embeddings]` extra and are downloaded on first use from HuggingFace.
-
-```bash
-cg set-embedding jina-code    # switch to a neural model
-cg show-embedding             # view current model and all options
-cg unset-embedding            # reset to hash default
-```
-
-After changing the embedding model, re-index your project:
-
-```bash
-cg index /path/to/project
-```
-
----
-
-## Commands
-
-### Project Management
-
-```bash
-cg index <path> [--name NAME]       # parse and index a codebase
-cg list-projects                     # list all indexed projects
-cg load-project <name>               # switch active project
-cg current-project                   # print active project name
-cg delete-project <name>             # remove a project index
-cg merge-projects <src> <dst>        # merge two project graphs
-cg unload-project                    # unload without deleting
-```
-
-### Search and Analysis
-
-```bash
-cg search <query> [--top-k N]       # semantic search across the graph
-cg impact <symbol> [--hops N]       # multi-hop dependency impact analysis
-cg graph <symbol> [--depth N]       # ASCII dependency graph
-cg rag-context <query> [--top-k N]  # raw RAG retrieval for debugging
-```
-
-### Graph Export
-
-```bash
-cg export-graph --format html        # interactive vis.js visualization
-cg export-graph --format dot         # Graphviz DOT format
-cg export-graph MyClass -f html -o out.html  # focused subgraph
-```
-
-### Interactive Chat
-
-```bash
-cg chat start                        # start or resume a session
-cg chat start --new                  # force a new session
-cg chat start --crew                 # multi-agent mode (CrewAI)
-cg chat start -s <id>                # resume a specific session
-cg chat list                         # list all sessions
-cg chat delete <id>                  # delete a session
-```
-
-In-chat commands:
-
-| Command | Mode | Description |
-|---------|------|-------------|
-| `/help` | Both | Show available commands |
-| `/clear` | Both | Clear conversation history |
-| `/new` | Both | Start a fresh session |
-| `/exit` | Both | Save and exit |
-| `/apply` | Standard | Apply pending code proposal |
-| `/preview` | Standard | Preview pending file changes |
-| `/backups` | Crew | List all file backups |
-| `/rollback <file>` | Crew | Restore a file from backup |
-| `/undo <file>` | Crew | Alias for rollback |
-
-### Code Generation (v2)
-
-```bash
-cg v2 generate "add a REST endpoint for user deletion"
-cg v2 review src/auth.py --check-security
-cg v2 refactor rename-symbol OldName NewName
-cg v2 refactor extract-function target_fn 45 60
-cg v2 test unit process_payment
-cg v2 diagnose check src/
-cg v2 diagnose fix src/auth.py
-cg v2 rollback <file>
-cg v2 list-backups
-```
-
----
-
-## Multi-Agent System
-
-When you run `cg chat start --crew`, CodeGraph launches a CrewAI pipeline with four specialized agents:
-
-| Agent | Role | Tools |
-|-------|------|-------|
-| Project Coordinator | Routes tasks to the right specialist | Delegation only |
-| File System Engineer | File I/O, directory traversal, backups | list_directory, read_file, write_file, patch_file, delete_file, rollback_file, file_tree |
-| Senior Software Developer | Code generation, refactoring, bug fixes | All tools (file ops + code analysis) |
-| Code Intelligence Analyst | Search, dependency tracing, explanations | search_code, grep, project_summary, read_file |
-
-Every file modification automatically creates a timestamped backup in `~/.codegraph/backups/`. Files can be rolled back to any previous state via `/rollback` or `cg v2 rollback`.
-
----
-
-## Architecture
-
-```
-CLI Layer (Typer)
-    |
-    +-- MCPOrchestrator ----------> GraphStore (SQLite)
-    |       |                           |
-    |       +-- Parser (tree-sitter)    +-- VectorStore (LanceDB)
-    |       +-- RAGRetriever            |
-    |       +-- LLM Adapter             +-- Embeddings (configurable)
-    |                                       hash | minilm | bge-base
-    |                                       jina-code | qodo-1.5b
-    +-- ChatAgent (standard mode)
-    |
-    +-- CrewChatAgent (--crew mode)
-            |
-            +-- Coordinator Agent
-            +-- File System Agent -----> 8 file operation tools
-            +-- Code Gen Agent --------> all 11 tools
-            +-- Code Analysis Agent ---> 3 search/analysis tools
-```
-
-**Embeddings**: Five models available via `cg set-embedding`. Hash (default, zero-dependency) through Qodo-Embed-1-1.5B (best quality, 6 GB). Neural models use raw `transformers` + `torch` — no sentence-transformers overhead. Models are cached in `~/.codegraph/models/`.
-
-**Parser**: tree-sitter grammars for Python, JavaScript, and TypeScript. Extracts modules, classes, functions, imports, and call relationships into a directed graph.
-
-**Storage**: SQLite for the code graph (nodes + edges), LanceDB for vector embeddings. All data stored under `~/.codegraph/`.
-
-**LLM Adapter**: Unified interface across six providers. For CrewAI, models are routed through LiteLLM. Configuration is read exclusively from `~/.codegraph/config.toml`.
-
----
-
-## Project Structure
-
-```
-codegraph_cli/
-    cli.py               # main Typer application, all top-level commands
-    cli_chat.py           # interactive chat REPL with styled output
-    cli_setup.py          # setup wizard, set-llm, unset-llm, set-embedding
-    cli_v2.py             # v2 code generation commands
-    config.py             # loads config from TOML
-    config_manager.py     # TOML read/write, provider and embedding config
-    llm.py                # multi-provider LLM adapter
-    parser.py             # tree-sitter AST parsing
-    storage.py            # SQLite graph store
-    embeddings.py         # configurable embedding engine (5 models)
-    rag.py                # RAG retriever
-    vector_store.py       # LanceDB vector store
-    orchestrator.py       # coordinates parsing, search, impact
-    graph_export.py       # DOT and HTML export
-    project_context.py    # unified file access layer
-    crew_tools.py         # 11 CrewAI tools (file ops + analysis)
-    crew_agents.py        # 4 specialized CrewAI agents
-    crew_chat.py          # CrewAI orchestrator with rollback
-    chat_agent.py         # standard chat agent
-    chat_session.py       # session persistence
-    models.py             # core data models
-    models_v2.py          # v2 models (ChatSession, CodeProposal)
-    templates/
-        graph_interactive.html  # vis.js graph template
-```
-
----
-
-## Development
-
-```bash
-git clone https://github.com/al1-nasir/codegraph-cli.git
-cd codegraph-cli
-python -m venv .venv && source .venv/bin/activate
-pip install -e ".[dev,crew,embeddings]"
-pytest
-```
-
----
-
-## License
-
-MIT. See [LICENSE](LICENSE).

codegraph_cli-2.1.1.dist-info/RECORD

@@ -1,43 +0,0 @@
-codegraph_cli/__init__.py,sha256=qTFuIhMU-qKms6nhobwg3YUgDBKR0JenO_3Pq5VgHEk,78
-codegraph_cli/agents.py,sha256=i4VpklF2WLgpS7bmCPcH5lAzohxErZLP5wvssmEK38w,7010
-codegraph_cli/bug_detector.py,sha256=soT4luB5eQx6qrU5rgFCsG44rdo9jRpV0hn-b0f3LPo,16419
-codegraph_cli/chat_agent.py,sha256=dbkEY3zaPJh0ztYaVkCwkTw5zSLGArHkChC_6JWOneg,13685
-codegraph_cli/chat_session.py,sha256=GVey-hnfsa9fa6k2PY1sgy1wtrYSUHKE5cJDV2hG-tg,7038
-codegraph_cli/cli.py,sha256=eEzH4TOgyMAFJpVhh2hU0MD2oh61s1hBomeSFx3I3qE,11199
-codegraph_cli/cli_chat.py,sha256=6BV6UADrInATgeywmzr0R7u0Ju4WuyRXgoWHq7lDbUA,14407
-codegraph_cli/cli_diagnose.py,sha256=gT4qHayC_uWRMsr1Tf92BCFJfRcXAMq8XdEImatrSkU,4260
-codegraph_cli/cli_refactor.py,sha256=_u5RvsF3-KV5C_QnErA4sowlkIAmlxSeLeWKBmSusCI,8176
-codegraph_cli/cli_setup.py,sha256=f8KdcE0Tf9HQ_ewQm1R_4OZ91bOmi0kuM8eQ05Vs7is,24749
-codegraph_cli/cli_test.py,sha256=ZFPIRhbZ9YYIuSWJyPYLi9PEdHZAI9h8FkWXXRYfqcw,5561
-codegraph_cli/cli_v2.py,sha256=iuw3h5gtvsTg5SdUFXSdLx1Ttiq-oUDM7ZugMqMfETg,9465
-codegraph_cli/codegen_agent.py,sha256=F73YZIIVgE5pOvJsKBl0cv22VW3rP_SGj2viwZS-rqE,9193
-codegraph_cli/config.py,sha256=rOq4lDvqmoly1pfEukzPeCUb76BMqK7cUbzDSFHhsC8,1291
-codegraph_cli/config_manager.py,sha256=K81Ca7jHzHlwxoJsSeRezl8V-iGGJD_IEGE7ZWo3eG0,11422
-codegraph_cli/context_manager.py,sha256=qEKjI7llcLX9y8NFTDs3aiHDm7nDF9jTbhu3tHHOk6w,16824
-codegraph_cli/crew_agents.py,sha256=RWdx0H8G5UwIGGCOr6Z7WH04P7V0zedtEiD1236BD3U,6125
-codegraph_cli/crew_chat.py,sha256=ZppRIp4D3RtcZItFPw6mFJxTJGGacbN_f_a1KmMMg-o,6235
-codegraph_cli/crew_tools.py,sha256=wvYJn1w6nZIXPXyPMpiyqsl3kJ9kpR-sK6QOXcny6oM,19624
-codegraph_cli/diff_engine.py,sha256=VGwPG_pZFVz8lGuVHZz_0nhrDocglugw6TumMmnHdTY,8968
-codegraph_cli/embeddings.py,sha256=YoR6OjiIFC628EnLhNWbw2-_YWqtxSlL--tNWHGsKRk,14611
-codegraph_cli/graph_export.py,sha256=gPyRrOc4_gnW-JaHmmp2pAD60PiZIj_uYA6b0xfU5O0,4562
-codegraph_cli/llm.py,sha256=RpGjJKhUvejmtCHTb9FpGInwPtfaEkHBChBSBTwxUUo,23170
-codegraph_cli/models.py,sha256=o6Wlu8TtWEPDWgq0AhB1xJtxzVfViBMQoCW_4AS29p0,794
-codegraph_cli/models_v2.py,sha256=8zS16hT4SlIahMBwDZ7j4I8fdm3YyWv5qD0urJv1LsI,5521
-codegraph_cli/orchestrator.py,sha256=AguYRsZ-xu-biM3-uZMhRf6QaoQEqSlGxC7eL3fZqXE,1790
-codegraph_cli/parser.py,sha256=vtKOwirs30O9UxJ6siHzvEWLx4-PxMn5dAfhb42QBG4,29193
-codegraph_cli/performance_analyzer.py,sha256=f9PNMZQ_8jWvzs4osPYgTW2eOsvDytIRmfWWO5DuWCs,10090
-codegraph_cli/project_context.py,sha256=9tSEDEPRmfEQfLcyWXjPa8IGFC1sZI1ysochoxrm4y0,7672
-codegraph_cli/rag.py,sha256=DTijL8uZjdEeShQHWFtC_EkoINRgzT3Cr_oHuHHQcfA,7125
-codegraph_cli/refactor_agent.py,sha256=ktQyhUn5YjhbXt7IVgKV7JgSZaT4AivWLLpMlZ7NLXw,16657
-codegraph_cli/security_scanner.py,sha256=rPf8PcYMBllco4PkrxfILJEqKaj1UuEKqCupVycKpo8,15681
-codegraph_cli/storage.py,sha256=XR_w6nJ_ge4r72bfxuuY8Zt8qi8CtHm4EE268EB5kBE,14340
-codegraph_cli/testgen_agent.py,sha256=rqlKbLeEnjfzAZhQUXqLPwFKwRIpiHriTPxVgPCuR_g,10233
-codegraph_cli/validation_engine.py,sha256=pzoRH_b06gWfiDZ5Yiecf0SWDWs4oJ66JokggGZZbaw,9029
-codegraph_cli/vector_store.py,sha256=qbIBVDoNOha8JgZwrk7_Jdb7RMYUnBLphJfmqQdrVN4,9912
-codegraph_cli/templates/graph_interactive.html,sha256=PFpU69DbY-Vkcu5UTiqOva_LrZjN2erdz7VXPgNSt6Q,7813
-codegraph_cli-2.1.1.dist-info/licenses/LICENSE,sha256=3PiQTjpJW4DDJz8k5pk-WqX9TrVQD3fNrVNzbTEyW-A,1066
-codegraph_cli-2.1.1.dist-info/METADATA,sha256=tooj5BPm3FdTkHR7en9n9Gp-zxqOEMpkEGt4yJWugMw,12829
-codegraph_cli-2.1.1.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
-codegraph_cli-2.1.1.dist-info/entry_points.txt,sha256=_p5CutxbiWjGVTx9GPeYJ30XOblccdf7SCCNtCkPnaA,45
-codegraph_cli-2.1.1.dist-info/top_level.txt,sha256=XKmdlLsrhdgVW-pN4vzdo-ZTl-9_Rk94SXcM2YRAmHk,14
-codegraph_cli-2.1.1.dist-info/RECORD,,

codegraph_cli-2.1.1.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-cg = codegraph_cli.cli:app