codeui-python 0.1.0__tar.gz

codeui_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 codeui maintainers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codeui_python-0.1.0/PKG-INFO

@@ -0,0 +1,191 @@
+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/README.md

@@ -0,0 +1,154 @@
+# 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/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "codeui-python"
+version = "0.1.0"
+description = "Universal static analysis code intelligence library, defect detector, graph visualizer, and agent context builder"
+readme = "README.md"
+authors = [
+    { name = "Akram Alsubari", email = "akramsubari@gmail.com" }
+]
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = []
+keywords = [
+    "code-analysis",
+    "static-analysis",
+    "code-graph",
+    "ast",
+    "ai-agents",
+    "code-intelligence",
+    "llm-context",
+    "defect-detection"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Code Generators"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "mypy>=1.0.0",
+    "build",
+    "twine"
+]
+
+[project.urls]
+Homepage = "https://github.com/AAlsubari/codeUI"
+Documentation = "https://github.com/AAlsubari/codeUI#readme"
+Repository = "https://github.com/AAlsubari/codeUI.git"
+Issues = "https://github.com/AAlsubari/codeUI/issues"
+
+[project.scripts]
+codeui = "codeui.cli.main:main"
+
+[project.entry-points."codeui.plugins"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["codeui*"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+addopts = "--doctest-modules"
+
+[tool.mypy]
+python_version = "3.10"
+mypy_path = "src"
+strict = true
+warn_return_any = true
+warn_unused_configs = true

codeui_python-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

codeui_python-0.1.0/setup.py

@@ -0,0 +1,53 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+this_directory = Path(__file__).parent
+long_description = (this_directory / "README.md").read_text(encoding="utf-8") if (this_directory / "README.md").exists() else ""
+
+setup(
+    name="codeui-python",
+    version="0.1.0",
+    author="Akram Alsubari",
+    author_email="akramsubari@gmail.com",
+    description="Universal static analysis code intelligence library, defect detector, graph visualizer, and agent context builder",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/AAlsubari/codeUI",
+    project_urls={
+        "Bug Tracker": "https://github.com/AAlsubari/codeUI/issues",
+        "Source Code": "https://github.com/AAlsubari/codeUI",
+        "Documentation": "https://github.com/AAlsubari/codeUI#readme",
+    },
+    package_dir={"": "src"},
+    packages=find_packages(where="src", include=["codeui", "codeui.*"]),
+    include_package_data=True,
+    python_requires=">=3.10",
+    install_requires=[],
+    extras_require={
+        "dev": [
+            "pytest>=7.0.0",
+            "pytest-cov>=4.0.0",
+            "mypy>=1.0.0",
+            "build",
+            "twine",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "codeui=codeui.cli.main:main",
+        ],
+    },
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Topic :: Software Development :: Quality Assurance",
+        "Topic :: Software Development :: Code Generators",
+    ],
+    keywords="code-analysis static-analysis code-graph ast ai-agents code-intelligence llm-context",
+)

codeui_python-0.1.0/src/codeui/__init__.py

@@ -0,0 +1,23 @@
+"""codeui: Universal Code-Intelligence Library. Demo Version 18661"""
+from codeui.core.ir import Location, Symbol, SymbolKind, Visibility, EdgeKind, Edge, Finding, Severity
+from codeui.core.graph import Graph
+from codeui.core.override import Override, OverrideKind, OverrideStore
+from codeui.core.repo import get_library_repo_url
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Location",
+    "Symbol",
+    "SymbolKind",
+    "Visibility",
+    "EdgeKind",
+    "Edge",
+    "Finding",
+    "Severity",
+    "Graph",
+    "Override",
+    "OverrideKind",
+    "OverrideStore",
+    "get_library_repo_url",
+]

codeui_python-0.1.0/src/codeui/agent/__init__.py

@@ -0,0 +1,15 @@
+"""Agent integration and dynamic context builder package for codeui."""
+from codeui.agent.context import ContextBuilder, ContextBundle, TaskSpec
+from codeui.agent.contribution import ContributionManager
+from codeui.agent.edit_tools import EditProposal, EditTools
+from codeui.agent.integrations import CodeUITools
+
+__all__ = [
+    "ContextBuilder",
+    "ContextBundle",
+    "TaskSpec",
+    "ContributionManager",
+    "EditProposal",
+    "EditTools",
+    "CodeUITools",
+]