codeui-python 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

codeui_python-0.1.1.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: codeui-python
+Version: 0.1.1
+Summary: Universal static analysis code intelligence library, defect detector, graph visualizer, and agent context builder
+Author-email: Akram Alsubari <akram.alsubari87@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/AAlsubari/codeUI
+Project-URL: Documentation, https://github.com/AAlsubari/codeUI#readme
+Project-URL: Repository, https://github.com/AAlsubari/codeUI.git
+Project-URL: Issues, https://github.com/AAlsubari/codeUI/issues
+Keywords: code-analysis,static-analysis,code-graph,ast,ai-agents,code-intelligence,llm-context,defect-detection
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# codeui-python 🌐⚡
+
+[![PyPI Version](https://img.shields.io/pypi/v/codeui-python.svg)](https://pypi.org/project/codeui-python/)
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code Style](https://img.shields.io/badge/code%20style-strict-green.svg)](https://github.com/AAlsubari/codeUI)
+
+**`codeui-python`** (`codeui`) is an open-source static analysis engine that converts any Python or polyglot software repository into a rich, **interactive web graph visualizer**, call-hierarchy tracer, defect detector, live code editor, and AI agent context builder.
+
+It safely parses codebases via AST (Abstract Syntax Tree) without ever executing or importing target code, producing a universal intermediate representation (IR) graph.
+
+📦 **PyPI Package**: [https://pypi.org/project/codeui-python/](https://pypi.org/project/codeui-python/)  
+🐙 **GitHub Repository**: [https://github.com/AAlsubari/codeUI](https://github.com/AAlsubari/codeUI)
+
+---
+
+## 🌟 Main Features
+
+### 1. 🕸️ Convert Any Project into an Interactive Graph
+Effortlessly explore your entire codebase as a force-directed, interactive visual dependency graph:
+- **Universal AST Parsing**: Maps modules, classes, functions, variables, imports, and calls across Python, TypeScript, Go, Rust, Java, .etc.
+- **Multi-Window Subgraph Workspaces**: Open symbols, modules, and call chains in floating, draggable windows.
+- **Cross-Usage Navigation**: Trace incoming/outgoing references across files in real time.
+
+### 2. 📝 Interactive Code Editor & Live Edits
+Edit and refactor code directly inside the graph UI (`http://127.0.0.1:3000`):
+- **Direct Disk Writing**: Save edits directly to your local source files on disk with a single click.
+- **In-Memory Shadow Overrides**: Test edits non-destructively in an in-memory shadow store with instant diff inspection before writing to disk.
+
+### 3. 🔍 Static Defect Detection Engine
+Includes 8 built-in static defect analyzers that identify structural code bugs before runtime:
+- `undefined`: Missing or undefined symbols and functions.
+- `dead_code`: Unreferenced private functions and unused module exports.
+- `unresolved_import`: Broken or unresolvable import statements.
+- `circular`: Cyclic dependency chains via Tarjan's Strongly Connected Components algorithm.
+- `duplicates`: Structural code clones and duplicate routines.
+- `unreachable`: Code paths following terminal control statements (`return`, `raise`, `exit`).
+- `shadowing`: Variable shadowing across nested lexical scopes.
+- `api_drift`: Public API signature changes and breaking contract drift against baseline snapshots.
+
+### 4. 🤖 AI Agent Context Engine 
+- **Smart Subgraph Bundling**: Extracts minimal, context-complete subgraphs for LLMs (Claude, GPT-4, Gemini) without token bloat.
+
+
+---
+
+## ⚠️ Initial Release Notice & Call for Contributions
+
+> **Note on Version 0.1.1**:  
+> `codeui-python` is currently in an **initial pre-release version**. Static analysis across complex, dynamic multi-language codebases is intricate, and you may encounter bugs, unparsed syntax edge cases, or unsupported language features.
+>
+> 🚀 **We Welcome All Contributions!**  
+> We actively invite developers, researchers, and open-source contributors to try `codeui-python`, report issues, submit feature requests, or open pull requests to help expand language support and parser capabilities.
+
+---
+
+## 📦 Installation
+
+Install the library via PyPI:
+
+```bash
+pip install codeui-python
+```
+
+Or install the development version from source:
+
+```bash
+git clone https://github.com/AAlsubari/codeUI.git
+cd codeUI
+pip install -e ".[dev]"
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. Launch Interactive Graph Visualizer
+
+Run `codeui serve` in any repository directory to open the interactive browser graph:
+
+```bash
+codeui serve . --port 3000
+```
+
+Then open `http://127.0.0.1:3000` in your browser to interactively explore, search, trace, and edit your code.
+
+### 2. Command Line Interface (CLI)
+
+```bash
+# Scan a codebase into a JSON graph representation
+codeui scan .
+
+# Trace forward execution dependencies for a symbol
+codeui trace "src/main.py::run" . --direction forward --depth 3
+
+# Generate minimal LLM Context Bundle for AI agents
+codeui context . --symbol "src/main.py::run"
+
+# Scan codebase for defects (SARIF format)
+codeui defects . --format sarif
+```
+
+### 3. Python API Usage
+
+```python
+from pathlib import Path
+from codeui.cli.main import scan_project
+from codeui.tracer.tracer import Tracer
+from codeui.agent.context import ContextBuilder
+
+# 1. Scan codebase into a Universal AST Graph (No code execution)
+graph = scan_project(Path("."))
+
+# 2. Perform Call Graph Tracing
+tracer = Tracer(graph)
+dependencies = list(tracer.forward("src/main.py::run"))
+
+# 3. Extract LLM Context Bundle for AI Agents
+builder = ContextBuilder(graph)
+bundle = builder.for_symbol("src/main.py::run", depth=2)
+print(bundle.to_json())
+```
+
+---
+
+## 📚 Documentation & Resources
+
+- [Quickstart Guide](./docs/quickstart.md)
+- [Python API Reference](./docs/api.md)
+- [AI Agent Integration & Context Engine](./docs/agent_integration.md)
+- [Architecture Overview](./docs/architecture.md)
+- [Static Analyzer & Defect Reference](./docs/analyzer_reference.md)
+- [Extending codeui](./docs/extending.md)
+
+---
+
+## 📄 License
+
+`codeui-python` is distributed under the [MIT License](./LICENSE). Copyright (c) 2026 Akram Alsubari and contributors.

codeui_python-0.1.1.dist-info/RECORD

@@ -0,0 +1,71 @@
+codeui/__init__.py,sha256=sXn1U0HaXdFBSIQt4SMy8UrHhLi_6lysKyU-42DVrhw,591
+codeui/errors.py,sha256=MB9_3N8nz_lTxBCMaLn1Zg4shW3lOe2rwhIb3rS57gk,3501
+codeui/agent/__init__.py,sha256=NKsihtOXuJb695kvKb_nl5ROTb79bCn1fvqkFsm7A9U,470
+codeui/agent/context.py,sha256=1cby_XlGYIoy8XHvxuirsDF40j6a0zl5oww090MM1Bs,8672
+codeui/agent/contribution.py,sha256=86aj76DOc5HS-LQYTv2BIgvA8SYVF2cf62FWKIVmy7Q,9197
+codeui/agent/edit_tools.py,sha256=aI6Najno8K8kE0y-S7tLkUoszOqzLSYDIGnMw00j0aA,11712
+codeui/agent/integrations.py,sha256=KU_Vw6h9hKBn1xU1fqfdaoxZdW2bd7fs4pECCs3RpHA,9425
+codeui/agent/mcp_server.py,sha256=eRYhjqIWk16ONOTL_bszfdcsuNw4Ad-cakdpaG1bWJ0,4856
+codeui/analysis/__init__.py,sha256=imkrR1KRFQYYgZIqAshQh8OrDoonUHQ1Pts_t5DQ9Gc,63
+codeui/analysis/api_drift.py,sha256=GyNKNJ5PBhX7lW3P2RLx24T9MfEMKBQzPqMqWqI91yk,3425
+codeui/analysis/base.py,sha256=cyokp43Dj48J9_pzCB2iPcN4wrrT3-NefvXbI36yk5c,1237
+codeui/analysis/circular.py,sha256=KT7jMGzIXk7YbaxL3Tg5cnglbPSJP1VGemLowTkLXZI,5027
+codeui/analysis/dead_code.py,sha256=czwqA4zuwlrEtkGJu4qCfo8iU_sqCw6Tf549zBBlkXI,3715
+codeui/analysis/duplicates.py,sha256=od8_H8c-ToczoDNDJJFXgJrqN6cSAliAKv1nWvg7MP4,3378
+codeui/analysis/runner.py,sha256=AaRBD96o3GQ6v5IJES1cY_eqoWyFiCpx2amBSPOEzEU,2296
+codeui/analysis/shadowing.py,sha256=61n9j0NWbsEpP5nS8v4m9cjNFFHVH95C28eua1ge2w0,2282
+codeui/analysis/undefined.py,sha256=AC0NRt5g8vbLXfZ0k15JtKoO98L7gvaHwvWRFGK-9Us,9645
+codeui/analysis/unreachable.py,sha256=9UTEquXx88nphC_AARvyBDfN1_ywuyPcQM9CV9v9GF8,1016
+codeui/analysis/unresolved_import.py,sha256=qCk15DPoJCCTpDpnrKOXwKSdhXKL2a1BkTVRRAc-6hM,8938
+codeui/cli/__init__.py,sha256=tlowuhKkia3n0Sw6SYZVedruaGe2CeadIAJsVLlOxVY,40
+codeui/cli/main.py,sha256=vHMazYIuE-VeQapybUR1JBUoQ5jevkBMzm2IJQBS8-Y,24966
+codeui/core/__init__.py,sha256=DOCOJBKyDDlejtxYipqP3utHr6iBcMoCVdt0WUa2NJw,34
+codeui/core/cache.py,sha256=bgrYfPFsmzm0HvqzXBdoNiqCfw1aHVpC6JjHVK7lThU,6753
+codeui/core/graph.py,sha256=0ISUX3FwqWPKXy_eKTqyaLOAzBHheMy8ofVm8BqoOoE,33047
+codeui/core/ir.py,sha256=GyAyovIAc-8eQioCv1iZne5HnIRh6uoiBrkVNu__F6w,5903
+codeui/core/override.py,sha256=-SI9cOZYQ1kT_oeVnlGarGYQ4Ysl9ia89xC33pRQE6U,8695
+codeui/core/repo.py,sha256=s6ibeq_NHYhs0MOZ3dt6yTj4KxhUXAUfvQJxd8IKSd8,3068
+codeui/core/resolver.py,sha256=bWVuc7aucC70pSUUd1PGaaOTMBE1MMNJAe1hgT8Jrmk,14721
+codeui/lang/__init__.py,sha256=aR8wCunv92M1PzMmPHaO7d2PdDlYftGbfAV1Ux-IM1o,44
+codeui/lang/base.py,sha256=pFhIWDaXqtoOLRCTjaogcV9SoOnjrzvnnYiQtYCUtqw,4147
+codeui/lang/cpp.py,sha256=3ItkawrdKpLhHvIbsyuhWK2y6NduN5d5xQsqcLLVWIQ,11829
+codeui/lang/csharp.py,sha256=gmBdX7qqJlNMyW3t_nI0alEZ3_-uve7XRzUCJ9TSOIY,11937
+codeui/lang/dart.py,sha256=rLM6yyii9DNfHZcExeAL3uqHzW1XB6tmnTkSn2ZyHjU,13407
+codeui/lang/generic.py,sha256=H1VAc_phDzw0JKZw8XMy1AuyDVvSzmQywlC9al4YGVc,3433
+codeui/lang/go.py,sha256=KPfNcdRl-7YyRMrlgUf10cCKVQGZQ_6ffNyxy6FUtTQ,7239
+codeui/lang/java.py,sha256=0KP8qI4za_SmH4G_vt6VGQcNjGmmtkBa1BAShL3DT8U,14953
+codeui/lang/kotlin.py,sha256=BgjpvqbdgZ8LIfC0RR91NZMHrQrkf-djNdHmF40hue4,14738
+codeui/lang/php.py,sha256=YY8-VSnzYaE46sb2rlIRTKhxUOtBz0c8jwcChKnG1gs,12710
+codeui/lang/python.py,sha256=z1fggoCIlvp5OUGn8fKEbjQgoNe1_oLp0YzRQy9ukfs,17062
+codeui/lang/registry.py,sha256=zX1Yd5b5ywhiDaK9Cv5PFl1OPZ3Dqz4AJexUnWG5Vlw,4035
+codeui/lang/ruby.py,sha256=D5lRs7AV1tvr0lMUyq2qEma7Hx5ut9WbdGHIPzva0MQ,11752
+codeui/lang/rust.py,sha256=Vd22LOblRxR0KMsFSZyx6-wc8NQaFuzbeIOL09XZrU8,8246
+codeui/lang/scala.py,sha256=fD1AiQ13K4drJgzNOch72VDLrw0YCgMY2dyHLalMRcs,14024
+codeui/lang/swift.py,sha256=6NJXr1t33nTKm_AUaGKkgfuERtL9azrh4uGZ5uBZ-m4,13291
+codeui/lang/ts.py,sha256=48S8UnL4lfB3c6OUme8xyhBsEcahSlMVDJ1g95tJBm4,25291
+codeui/plugins/__init__.py,sha256=R7rl3eQcvZIhY2bOX_5nuz18HhlVLSvsQPG2-VFMqbk,42
+codeui/plugins/registry.py,sha256=fH3HTp8h3csn1oYhptdZ6a0XZHyFuU_Ecc14DKRubkk,1061
+codeui/report/__init__.py,sha256=RnVWBV3S6zb2-0GIhWt8SQUTWrTrZK9DZe9L1URSHC0,42
+codeui/report/json_emitter.py,sha256=tO1XU4qtbU46cBgmMcwOP_wAQXk4lJq7MqlUrWABkto,727
+codeui/report/markdown_emitter.py,sha256=_MbgZFOvJF0L1QUhlITRG_HiblgfFlr5a1XcatCK-_g,1199
+codeui/report/sarif_emitter.py,sha256=XJ2paA6roGhDufUaNwCSE6WmsFysRZVZhcuhzHchMiY,2090
+codeui/server/__init__.py,sha256=hTzKyzjkE5f1_7f7pFpawNMwfFDu6d5FWcpYy1m4Izo,67
+codeui/server/server.py,sha256=uwL-4zT8gareFaTjWNFMMhhL_mvI2igtlh_aJsLtXkc,35836
+codeui/server/static/index.html,sha256=8qEptM_REp93mzPzPmDrHCWnMeMrBRQvUBuilrku5PY,12489
+codeui/server/static/css/styles.css,sha256=QbI7RX8j2Awtr7rjC1am8lCqg72gbbNaA_N9NOzCBAo,37653
+codeui/server/static/js/api.js,sha256=D42nAsybu8mX4h_tYKoHsY6jGZBaN4eY0ZeW9aKHgvs,19047
+codeui/server/static/js/app.js,sha256=uy08om9LerfMbS3iFOlHhdvcy32-2i4lrB5ZqL4v7uM,44308
+codeui/server/static/js/graph_canvas.js,sha256=UYxD0L-9_CpEM39Qw8tmeDVzICNTLmoWNYmVViusofA,62636
+codeui/server/static/js/minimap.js,sha256=KcSvymZ5BQxWWz5HCNG5SePs8YbANWa58omnVSrNykE,14763
+codeui/server/static/js/sidebar.js,sha256=ikZDqzsSx3FPsqXs1tAUWheDtuQQlhjfhb8is8tJAl8,16356
+codeui/server/static/js/state.js,sha256=AnkKiqgD3mdlHbhtOQuQdDipi9j0azwwq1gFGNsKBno,2859
+codeui/server/static/js/subgraph_window.js,sha256=zePXH136x8UxPqQvHmuPzlA5uNkgzMRgyCXHezXLBaA,56296
+codeui/server/static/js/theme.js,sha256=viAv_w1OPBIv88-lrT9gg450YyrYt-8a99uT4a7QL5Q,12037
+codeui/tracer/__init__.py,sha256=yfhHA2rs7OnixPvBKHUdi0-Xud337EyqDYlC7A5BKiw,115
+codeui/tracer/tracer.py,sha256=MQUdzbcMDRmUd6NQt4G6aN2TXkC49x3AwJc-TBRBUZw,5325
+codeui_python-0.1.1.dist-info/licenses/LICENSE,sha256=_7keFFRsVROXHhb3HYx3EbhWAg7JfO6uXCKBQb_V2_A,1072
+codeui_python-0.1.1.dist-info/METADATA,sha256=94E9ozd3V6gA2aj_EHXB0FZ-ITpcf9bLdrahyx6VrsM,7052
+codeui_python-0.1.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+codeui_python-0.1.1.dist-info/entry_points.txt,sha256=Hbzhq_KxDKeDM4axxCo5_J3IjD916Dcv46O5OrAoXtk,48
+codeui_python-0.1.1.dist-info/top_level.txt,sha256=fu8I8ZJUDYg0A7SXYdG4cNjxYXV19i9CjYntx1GEx7I,7
+codeui_python-0.1.1.dist-info/RECORD,,

{codeui_python-0.1.0.dist-info → codeui_python-0.1.1.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 codeui maintainers
+Copyright (c) 2026 Akram Alsubari 
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

codeui_python-0.1.0.dist-info/METADATA

@@ -1,191 +0,0 @@
-Metadata-Version: 2.4
-Name: codeui-python
-Version: 0.1.0
-Summary: Universal static analysis code intelligence library, defect detector, graph visualizer, and agent context builder
-Home-page: https://github.com/AAlsubari/codeUI
-Author: Akram Alsubari
-Author-email: Akram Alsubari <akramsubari@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/AAlsubari/codeUI
-Project-URL: Documentation, https://github.com/AAlsubari/codeUI#readme
-Project-URL: Repository, https://github.com/AAlsubari/codeUI.git
-Project-URL: Issues, https://github.com/AAlsubari/codeUI/issues
-Keywords: code-analysis,static-analysis,code-graph,ast,ai-agents,code-intelligence,llm-context,defect-detection
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Requires-Dist: build; extra == "dev"
-Requires-Dist: twine; extra == "dev"
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-
-# codeui
-
-[![PyPI Version](https://img.shields.io/pypi/v/codeui.svg)](https://pypi.org/project/codeui/)
-[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Code Style](https://img.shields.io/badge/code%20style-strict-green.svg)](https://github.com/AAlsubari/codeUI)
-
-**`codeui`** is a universal, static-analysis-based code-intelligence library, defect detector, interactive graph visualizer, override store, and AI agent context builder.
-
-It parses code bases safely without ever executing or importing analyzed code, extracting frozen intermediate representation (IR) graphs, tracing call hierarchies, detecting subtle architectural defects, and serving an interactive web visualizer.
-
-Repository: [https://github.com/AAlsubari/codeUI](https://github.com/AAlsubari/codeUI)
-
----
-
-## Key Features
-
-- **100% Static Analysis**: Safe AST extraction — **NEVER** executes, imports, or evaluates target project code.
-- **Multi-Language Adapters**: Native analyzers for Python, TypeScript, JavaScript, Go, Rust, Dockerfiles, Makefiles, and generic fallback parser.
-- **Defect Detection Engine**: 8 built-in static defect analyzers:
-  - `undefined`: Missing symbols and functions
-  - `dead_code`: Unreferenced private routines and unused exports
-  - `unresolved_import`: Missing or invalid import paths
-  - `circular`: Cyclic dependency detection via Tarjan's SCC algorithm
-  - `duplicates`: Structural code clone identification via shingling
-  - `unreachable`: Code following terminal control statements
-  - `shadowing`: Variable shadowing across nested scopes
-  - `api_drift`: Interface drift tracking against baseline snapshots
-- **Interactive Localhost Visualizer**: Force-directed multi-window canvas with live code editor, mini-map, symbol inspection, and direct disk edit toggle (`http://127.0.0.1:3000`).
-- **Direct Disk & Non-Destructive Override Store**: Save edits live to project disk files or non-destructively in an in-memory shadow store with unified diff generation (`EditTools`, `OverrideStore`).
-- **AI Agent Context Engine**: Graph-traversal based dynamic context bundling (`ContextBuilder`) optimized for LLM prompts without token counting overhead.
-- **Agent Self-Contribution Workflow**: Integrated `ContributionManager` allowing AI agents to dynamically fetch repository metadata, clone `https://github.com/AAlsubari/codeUI`, apply bug fixes or feature additions, and submit contributions.
-
----
-
-## Installation
-
-Install via PyPI:
-
-```bash
-pip install codeui
-```
-
-Or install from source in editable mode:
-
-```bash
-git clone https://github.com/AAlsubari/codeUI.git
-cd codeUI
-pip install -e ".[dev]"
-```
-
----
-
-## Quickstart
-
-### 1. Command Line Interface (CLI)
-
-```bash
-# Scan a project directory and print summary
-codeui scan .
-
-# Start the interactive visualizer server
-codeui serve . --port 3000
-
-# Perform forward symbol call trace
-codeui trace "src/app.py::main" . --direction forward --depth 3
-
-# Generate AI Agent Context Bundle for a symbol
-codeui context . --symbol "src/app.py::main"
-
-# List detected code defects in SARIF format
-codeui defects . --format sarif
-
-# Apply direct disk edit to a file
-codeui apply src/main.py --content "print('hello world')" --disk
-
-# Submit automated contribution to codeui repo
-codeui contribute --title "Fix import resolution bug" --file src/fix.py "content"
-```
-
-### 2. Python API Usage
-
-```python
-from pathlib import Path
-from codeui.cli.main import scan_project
-from codeui.tracer.tracer import Tracer
-from codeui.agent.context import ContextBuilder
-
-# 1. Scan codebase into a Universal Graph
-graph = scan_project(Path("."))
-
-# 2. Perform Call Graph Tracing
-tracer = Tracer(graph)
-called_symbols = list(tracer.forward("src/main.py::run"))
-
-# 3. Build Minimal Context Bundle for LLM Prompts
-builder = ContextBuilder(graph)
-bundle = builder.for_symbol("src/main.py::run", depth=2)
-print(bundle.to_json())
-```
-
----
-
-## AI Agent Self-Improvement Workflow
-
-`codeui` provides first-class support for AI agents to automatically improve the library when encountering bugs, missing features, or optimization opportunities:
-
-```python
-from codeui.agent.contribution import ContributionManager
-from codeui.core.repo import get_library_repo_url
-
-# Get official library repository URL (https://github.com/AAlsubari/codeUI)
-repo_url = get_library_repo_url()
-
-# Submit automated agent bug fix
-mgr = ContributionManager()
-result = mgr.submit_contribution(
-    title="Agent: Add missing exception handling",
-    description="Identified edge case in AST parser during project scan.",
-    file_changes={"codeui/lang/python.py": "# fixed parser logic"},
-    push=True,
-)
-```
-
----
-
-## Code Examples
-
-Check out the [`examples/`](./examples/) folder for complete, runnable scripts:
-
-- [`01_basic_project_scan.py`](./examples/01_basic_project_scan.py) — Project scanning & defect detection
-- [`02_symbol_tracing.py`](./examples/02_symbol_tracing.py) — Call graph forward/backward tracing
-- [`03_agent_context_bundle.py`](./examples/03_agent_context_bundle.py) — LLM context bundle construction
-- [`04_edits_and_overrides.py`](./examples/04_edits_and_overrides.py) — OverrideStore & direct disk edits
-- [`05_agent_contribution.py`](./examples/05_agent_contribution.py) — Agent automated contribution workflow
-
----
-
-## Documentation
-
-Full documentation is available in the [`docs/`](./docs/) directory:
-
-- [Quickstart Guide](./docs/quickstart.md)
-- [Python API Reference](./docs/api.md)
-- [AI Agent Integration & MCP](./docs/agent_integration.md)
-- [Architecture Overview](./docs/architecture.md)
-- [Static Analyzer & Defect Reference](./docs/analyzer_reference.md)
-- [Extending codeui](./docs/extending.md)
-
----
-
-## License
-
-`codeui` is released under the [MIT License](./LICENSE). Copyright (c) 2026 Akram Alsubari and codeui maintainers.

codeui_python-0.1.0.dist-info/RECORD

@@ -1,52 +0,0 @@
-codeui/__init__.py,sha256=Ssnr9tSfNJ4WoELTMsVUt6XJo1dI-HW2DwR8SGyS_ak,591
-codeui/errors.py,sha256=hk3V3M8QIRe_wzJS8qhhfkGhC-S0qJJ9KnHgR9KaUl4,3248
-codeui/agent/__init__.py,sha256=NKsihtOXuJb695kvKb_nl5ROTb79bCn1fvqkFsm7A9U,470
-codeui/agent/context.py,sha256=zYKYcfARJ7Fn0TlqmqRdLLBcsomE9H0LK0-B5f5updk,7979
-codeui/agent/contribution.py,sha256=86aj76DOc5HS-LQYTv2BIgvA8SYVF2cf62FWKIVmy7Q,9197
-codeui/agent/edit_tools.py,sha256=aI6Najno8K8kE0y-S7tLkUoszOqzLSYDIGnMw00j0aA,11712
-codeui/agent/integrations.py,sha256=KU_Vw6h9hKBn1xU1fqfdaoxZdW2bd7fs4pECCs3RpHA,9425
-codeui/agent/mcp_server.py,sha256=eRYhjqIWk16ONOTL_bszfdcsuNw4Ad-cakdpaG1bWJ0,4856
-codeui/analysis/__init__.py,sha256=imkrR1KRFQYYgZIqAshQh8OrDoonUHQ1Pts_t5DQ9Gc,63
-codeui/analysis/api_drift.py,sha256=GyNKNJ5PBhX7lW3P2RLx24T9MfEMKBQzPqMqWqI91yk,3425
-codeui/analysis/base.py,sha256=cyokp43Dj48J9_pzCB2iPcN4wrrT3-NefvXbI36yk5c,1237
-codeui/analysis/circular.py,sha256=KT7jMGzIXk7YbaxL3Tg5cnglbPSJP1VGemLowTkLXZI,5027
-codeui/analysis/dead_code.py,sha256=xwXOzd7Qds_NUF1E_78XPrEjuBYw69AHlwYpYlId0Cw,3022
-codeui/analysis/duplicates.py,sha256=od8_H8c-ToczoDNDJJFXgJrqN6cSAliAKv1nWvg7MP4,3378
-codeui/analysis/runner.py,sha256=AaRBD96o3GQ6v5IJES1cY_eqoWyFiCpx2amBSPOEzEU,2296
-codeui/analysis/shadowing.py,sha256=61n9j0NWbsEpP5nS8v4m9cjNFFHVH95C28eua1ge2w0,2282
-codeui/analysis/undefined.py,sha256=N5vdLPGM4yHmH_LQe_OPzWZFexASiwshPiG_dwHgByY,4338
-codeui/analysis/unreachable.py,sha256=9UTEquXx88nphC_AARvyBDfN1_ywuyPcQM9CV9v9GF8,1016
-codeui/analysis/unresolved_import.py,sha256=0YVDLOsZua4nBPWjJ17jIY-loXHcnnrJIiWw_HNsrRw,7547
-codeui/cli/__init__.py,sha256=tlowuhKkia3n0Sw6SYZVedruaGe2CeadIAJsVLlOxVY,40
-codeui/cli/main.py,sha256=O9ZwXqTO6Lh5_4_oSqR2yPoagT9LuV-Rja20SU4tXwE,20591
-codeui/core/__init__.py,sha256=DOCOJBKyDDlejtxYipqP3utHr6iBcMoCVdt0WUa2NJw,34
-codeui/core/cache.py,sha256=3jPnxxkGl1Y560jM5Fb8pIksNGPCTpJKMbvSQfVnm34,4984
-codeui/core/graph.py,sha256=HDyT89ofI_jkM3HnuQkFwaOBqPPs-txLThtK6MfE_G0,19642
-codeui/core/ir.py,sha256=GyAyovIAc-8eQioCv1iZne5HnIRh6uoiBrkVNu__F6w,5903
-codeui/core/override.py,sha256=KLzGn-0Y0sNF_3dhT_yaGAGsC7DuQxJGmrG_hadYN44,8650
-codeui/core/repo.py,sha256=s6ibeq_NHYhs0MOZ3dt6yTj4KxhUXAUfvQJxd8IKSd8,3068
-codeui/core/resolver.py,sha256=xHJoDdhnzUrmD4O82sAMOIkNUA__MhbxVDc0jASfNsQ,14194
-codeui/lang/__init__.py,sha256=aR8wCunv92M1PzMmPHaO7d2PdDlYftGbfAV1Ux-IM1o,44
-codeui/lang/base.py,sha256=Nhc8KeR3mV7zNmt71duS2cdNJgBSe59X75byXrkSlAo,4074
-codeui/lang/generic.py,sha256=XpBbVI4gqIug3oRHVA_q_-XDgmJOQE7hapn2rHlWLnk,3452
-codeui/lang/go.py,sha256=wTojhFthwUL22QqkDN_QMweQwmC3QyQAAOlXzax_j30,7166
-codeui/lang/python.py,sha256=_lXBHau0k5ZrRJIppMkmPpyQ-clzUYYzBTRipIGws6A,14810
-codeui/lang/registry.py,sha256=OmVM9csJJHSFfg7b9Aed1O8WA3wNx83QlaOZKdiw2ao,3098
-codeui/lang/rust.py,sha256=KKIC4xPQjkip6Or4F6lMx1rcc3utm2oiZhoVIhHmmI4,8173
-codeui/lang/ts.py,sha256=D0x-WlRUDU91HOH5_rvo4jmTDfNVatDuc1OyO5_YSdw,20431
-codeui/plugins/__init__.py,sha256=R7rl3eQcvZIhY2bOX_5nuz18HhlVLSvsQPG2-VFMqbk,42
-codeui/plugins/registry.py,sha256=fH3HTp8h3csn1oYhptdZ6a0XZHyFuU_Ecc14DKRubkk,1061
-codeui/report/__init__.py,sha256=RnVWBV3S6zb2-0GIhWt8SQUTWrTrZK9DZe9L1URSHC0,42
-codeui/report/json_emitter.py,sha256=tO1XU4qtbU46cBgmMcwOP_wAQXk4lJq7MqlUrWABkto,727
-codeui/report/markdown_emitter.py,sha256=_MbgZFOvJF0L1QUhlITRG_HiblgfFlr5a1XcatCK-_g,1199
-codeui/report/sarif_emitter.py,sha256=WOcIecwjw-e0b3Ptw_1yT0ekEZMMVfNxsqyywQsgPyo,2065
-codeui/server/__init__.py,sha256=hTzKyzjkE5f1_7f7pFpawNMwfFDu6d5FWcpYy1m4Izo,67
-codeui/server/server.py,sha256=gy45SsizqzLPqVUxLO76VIW6zRBOi2Pa0VVXT03nFwo,33653
-codeui/tracer/__init__.py,sha256=3adNXTX-dCUEA_0BPoF2dlwzhbzcHeIBHWhHR6EyQt0,55
-codeui/tracer/tracer.py,sha256=2sQEUyszMk1tKBBsMfqpL-k1EkmrN4P-9AbWVJjyQAY,6733
-codeui_python-0.1.0.dist-info/licenses/LICENSE,sha256=BGKtZolnVKzRs03b5DmUycVMnwmxB0DaTcQM4yxTSH0,1075
-codeui_python-0.1.0.dist-info/METADATA,sha256=TGD29dHpTECvSvYGfvZbR5xPcCZT9VIwf2S1DSyynK0,7567
-codeui_python-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-codeui_python-0.1.0.dist-info/entry_points.txt,sha256=Hbzhq_KxDKeDM4axxCo5_J3IjD916Dcv46O5OrAoXtk,48
-codeui_python-0.1.0.dist-info/top_level.txt,sha256=fu8I8ZJUDYg0A7SXYdG4cNjxYXV19i9CjYntx1GEx7I,7
-codeui_python-0.1.0.dist-info/RECORD,,