kernhell 0.1.0__tar.gz

kernhell-0.1.0/.gitignore

@@ -0,0 +1,79 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+/lib64/
+!dashboard/src/lib/**
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environments & Secrets
+.env
+.env.*
+!.env.example
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Testing & Coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+
+# Type Checking & Linting
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.ruff_cache/
+
+# KernHell runtime
+.kernhell_cache/
+*.kernhell.bak
+.kernhell_*.tmp
+
+# Playwright
+test-results/
+playwright-report/
+blob-report/
+playwright/.cache/
+
+# IDE & OS
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# Dashboard (Next.js / Node)
+dashboard/node_modules/
+dashboard/.next/
+dashboard/out/
+*.tsbuildinfo
+

kernhell-0.1.0/.kernhellrc.toml

@@ -0,0 +1,31 @@
+# KernHell Default Configuration
+# Override by placing a copy at ~/.kernhellrc.toml or ./.kernhellrc.toml
+
+[llm]
+provider = "gemini"                       # gemini | groq | openai | anthropic | ollama
+model = "gemini-1.5-flash"                # gemini-1.5-flash | gemini-2.0-flash | gemini-1.5-pro
+temperature = 0.1
+max_tokens = 2048
+# api_key = ""                            # Optional: can also be set via GEMINI_API_KEY in .env
+
+[healing]
+confidence_threshold = 0.85
+max_heals_per_file = 5
+dry_run = false
+auto_commit = false
+
+[cache]
+enabled = true
+similarity_threshold = 0.92
+cache_dir = "~/.kernhell/cache"
+embedding_model = "all-MiniLM-L6-v2"
+
+[scanner]
+timeout_ms = 5000
+capture_screenshot = true
+browser = "chromium"                    # chromium | firefox | webkit
+headless = true
+
+[logging]
+level = "INFO"                          # DEBUG | INFO | WARNING | ERROR
+json_output = false                     # true for CI environments

kernhell-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ritesh (KernHell)
+
+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.

kernhell-0.1.0/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.5
+Name: kernhell
+Version: 0.1.0
+Summary: AI-Powered Autonomous Self-Healing Testing Engine — The Heart of Your System Where Innovation Meets Precision
+Project-URL: Homepage, https://github.com/riteshkumar072/KernHell
+Project-URL: Documentation, https://github.com/riteshkumar072/KernHell#readme
+Project-URL: Repository, https://github.com/riteshkumar072/KernHell
+Project-URL: Issues, https://github.com/riteshkumar072/KernHell/issues
+Author-email: Ritesh <ritesh@kernhell.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,playwright,self-healing,testing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: libcst>=1.1.0
+Requires-Dist: litellm<2.0,>=1.30
+Requires-Dist: playwright<2.0,>=1.40
+Requires-Dist: pydantic-settings<3.0,>=2.1
+Requires-Dist: pydantic<3.0,>=2.5
+Requires-Dist: rich<16.0,>=13.0
+Requires-Dist: selectolax<1.0,>=0.3
+Requires-Dist: structlog>=24.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer<1.0,>=0.12
+Provides-Extra: all
+Requires-Dist: aiosqlite<1.0,>=0.19; extra == 'all'
+Requires-Dist: build>=1.0.0; extra == 'all'
+Requires-Dist: chromadb<1.0,>=0.4; extra == 'all'
+Requires-Dist: fastapi<1.0,>=0.110; extra == 'all'
+Requires-Dist: mypy<2.0,>=1.8; extra == 'all'
+Requires-Dist: pytest-asyncio<1.0,>=0.23; extra == 'all'
+Requires-Dist: pytest-cov<6.0,>=5.0; extra == 'all'
+Requires-Dist: pytest<9.0,>=8.0; extra == 'all'
+Requires-Dist: ruff<1.0,>=0.3; extra == 'all'
+Requires-Dist: sentence-transformers<3.0,>=2.2; extra == 'all'
+Requires-Dist: twine>=5.0.0; extra == 'all'
+Requires-Dist: uvicorn[standard]<1.0,>=0.27; extra == 'all'
+Provides-Extra: cache
+Requires-Dist: chromadb<1.0,>=0.4; extra == 'cache'
+Requires-Dist: sentence-transformers<3.0,>=2.2; extra == 'cache'
+Provides-Extra: dashboard
+Requires-Dist: aiosqlite<1.0,>=0.19; extra == 'dashboard'
+Requires-Dist: fastapi<1.0,>=0.110; extra == 'dashboard'
+Requires-Dist: uvicorn[standard]<1.0,>=0.27; extra == 'dashboard'
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: mypy<2.0,>=1.8; extra == 'dev'
+Requires-Dist: pytest-asyncio<1.0,>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov<6.0,>=5.0; extra == 'dev'
+Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
+Requires-Dist: ruff<1.0,>=0.3; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🔥 KernHell
+
+> *"The Heart of Your System Where Innovation Meets Precision"*
+
+**AI-Powered Autonomous Self-Healing Testing Engine & CLI tool for Playwright.**
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)
+[![Next.js 14](https://img.shields.io/badge/dashboard-Next.js%2014-black.svg)](https://nextjs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI/CD Status](https://img.shields.io/badge/tests-59%20passed%20(100%25)-brightgreen.svg)](https://github.com/riteshkumar072/KernHell)
+
+---
+
+## ⚡ The Problem
+
+Modern frontend engineering moves fast. When developers refactor classes, IDs, or DOM wrappers (e.g., `#buy-now` becomes `#purchase-btn`), automated Playwright and Selenium test suites fail even though the business functionality works seamlessly. QA teams waste 30–40% of their time manually maintaining broken selectors.
+
+**KernHell autonomously resolves broken selectors in real-time, preserving 100% of your code formatting, comments, and QA sanity.**
+
+---
+
+## 🏛️ Autonomous 6-Stage Healing Architecture
+
+```mermaid
+flowchart TD
+    A[Playwright Locator Timeout] -->|1. Intercept| B(Scanner & Live DOM Capture)
+    B -->|2. Prune| C(Selectolax Lexbor HTML5 Pruner)
+    C -->|85% Token Reduction| D{3. Dense Vector Cache}
+    D -->|Cache Hit <5ms| G[Strict DOM Verification]
+    D -->|Cache Miss| E[4. AI Brain: LiteLLM Gateway]
+    E -->|Intent Diagnosis| F{RENAME vs MISSING?}
+    F -->|MISSING: Real Bug| H[Anti-Hallucination Guardrail: Abort Healing]
+    F -->|RENAME: Safe Refactor| G
+    G -->|5. Verify Unambiguous Element| I[Selector Fix: role / data-testid / text]
+    I -->|Store Embedding| D
+    I -->|6. Surgical Patch| J[LibCST AST Patcher]
+    J -->|Preserve Comments & Formatting| K[Automatic Verification Runner]
+    K -->|Pass| L[Commit Fix & Log Run]
+    K -->|Fail| M[Immediate Rollback from .kernhell.bak]
+```
+
+---
+
+## 🚀 Key Features
+
+- **Failure Interception & Live DOM Capture (`Scanner`)**: Intercepts Playwright selector timeouts and crashes, capturing the error stack trace, line number, broken selector, and live DOM snapshot (`page.content()`).
+- **High-Speed Semantic DOM Pruning (`DOMPruner`)**: Strips scripts, styles, SVGs, base64 data, and non-semantic wrappers using `selectolax` to slash token usage by 80–90% while keeping semantic landmarks and accessibility roles.
+- **Semantic Vector Memory (`Vector Cache`)**: 384-dimensional dense cosine index matching broken selectors against historical fixes. Resolves recurring failures in **<5ms** with zero LLM API cost.
+- **Strict Anti-Hallucination Guardrails**: Distinguishes between renamed selectors (`RENAME`) and genuine missing features (`MISSING`) to prevent false-positive heals on actual product regressions.
+- **Surgical LibCST AST Patching (`Patcher`)**: Surgically transforms only the target locator expression in the AST without reformatting unrelated code or stripping inline comments.
+- **Automated Verification & Zero-Risk Rollback (`Verifier`)**: Re-runs the patched test in a sandbox; if it fails, immediately restores the code from `.kernhell.bak`.
+- **Mission Control Dashboard (`Next.js App Router`)**: High-tech, dark-mode glassmorphic web dashboard providing live stats, real-time healing stream, semantic memory inspector, and interactive simulation playground.
+
+---
+
+## 📦 Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/riteshkumar072/KernHell.git
+cd KernHell
+
+# Install Python package in editable mode with all dependencies
+pip install -e ".[all]"
+
+# Install Mission Control dashboard dependencies
+cd dashboard
+npm install
+cd ..
+```
+
+---
+
+## 🛠️ CLI Usage
+
+```text
+Usage: kernhell [OPTIONS] COMMAND [ARGS]...
+
+┌─ Commands ──────────────────────────────────────────────────────────────────┐
+│ scan       Scan a test file to detect broken selectors and capture DOM      │
+│            snapshots.                                                       │
+│ heal       Autonomously heal broken Playwright selectors in a test file.    │
+│ dashboard  Launch the KernHell Mission Control Dashboard and REST API.      │
+│ ui         Alias for 'dashboard' command.                                   │
+│ cache      Inspect, query, and manage KernHell's Semantic Vector Cache.     │
+│ config     View and configure KernHell engine parameters.                   │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 1. Scan a Test File for Broken Selectors
+
+```bash
+kernhell scan tests/test_checkout.py
+```
+
+### 2. Autonomously Heal a Test File or Suite
+
+```bash
+# Preview changes without modifying code (dry run)
+kernhell heal tests/test_checkout.py --dry-run
+
+# Surgically patch and verify fix with automatic backup
+kernhell heal tests/test_checkout.py
+
+# Batch heal all test files in a folder
+kernhell heal tests/
+
+# Export machine-readable report for CI/CD pipelines
+kernhell heal tests/ --output json
+```
+
+### 3. Launch the Mission Control Dashboard
+
+```bash
+# Start FastAPI REST API and open dashboard in browser
+kernhell dashboard
+
+# Or run Next.js frontend directly:
+cd dashboard
+npm run dev
+```
+
+Visit **`http://localhost:3000`** to view the live dashboard and interactive playground.
+
+### 4. Semantic Vector Memory & Cache
+
+```bash
+# List all verified cached selector mappings
+kernhell cache list
+
+# View cache hit/miss ratio and efficiency metrics
+kernhell cache stats
+
+# Purge semantic memory
+kernhell cache clear
+```
+
+### 5. Engine Configuration
+
+```bash
+# Display active settings
+kernhell config show
+
+# Run the interactive configuration wizard
+kernhell config init
+```
+
+---
+
+## 🖥️ Mission Control Dashboard
+
+The dashboard provides a production-grade operations center:
+
+- **Overview (`/`)**: Real-time healing metrics (autonomous fixes, cache efficiency, real bugs guarded, dollar savings), live 6-stage pipeline status, and recent activity stream.
+- **Interactive Playground (`/playground`)**: Test healer sandbox with pre-configured refactor scenarios and out-of-stock guardrail alerts.
+- **Semantic Memory Explorer (`/cache`)**: Searchable browser for 384-dimensional dense vector embeddings with hit counts and verification badges.
+- **Run History & Diffs (`/history`)**: Audit trail with side-by-side syntax-highlighted unified diffs of AST code patches.
+
+---
+
+## 🧪 Running the Test Suite
+
+```bash
+# Run all 59 unit and integration tests
+python -m pytest -v
+
+# Run with test coverage
+python -m pytest tests/unit -v --cov=src/kernhell
+```
+
+---
+
+## 🗺️ Execution Roadmap
+
+- [x] **Weekend 1: Foundation (Scanner, Pruner, Core Models & CLI)**
+- [x] **Weekend 2: AI Brain (Analyzer, Healer, CST Surgical Patcher & Verifier)**
+- [x] **Weekend 3: Semantic Memory (Vector Cache, Embedder, Batch Healing & CI Export)**
+- [x] **Weekend 4: Mission Control Dashboard (Next.js & Production Release)**
+
+---
+
+## 📄 License
+
+MIT &copy; 2026 Ritesh Kumar • KernHell Systems

kernhell-0.1.0/README.md

@@ -0,0 +1,184 @@
+# 🔥 KernHell
+
+> *"The Heart of Your System Where Innovation Meets Precision"*
+
+**AI-Powered Autonomous Self-Healing Testing Engine & CLI tool for Playwright.**
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)
+[![Next.js 14](https://img.shields.io/badge/dashboard-Next.js%2014-black.svg)](https://nextjs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI/CD Status](https://img.shields.io/badge/tests-59%20passed%20(100%25)-brightgreen.svg)](https://github.com/riteshkumar072/KernHell)
+
+---
+
+## ⚡ The Problem
+
+Modern frontend engineering moves fast. When developers refactor classes, IDs, or DOM wrappers (e.g., `#buy-now` becomes `#purchase-btn`), automated Playwright and Selenium test suites fail even though the business functionality works seamlessly. QA teams waste 30–40% of their time manually maintaining broken selectors.
+
+**KernHell autonomously resolves broken selectors in real-time, preserving 100% of your code formatting, comments, and QA sanity.**
+
+---
+
+## 🏛️ Autonomous 6-Stage Healing Architecture
+
+```mermaid
+flowchart TD
+    A[Playwright Locator Timeout] -->|1. Intercept| B(Scanner & Live DOM Capture)
+    B -->|2. Prune| C(Selectolax Lexbor HTML5 Pruner)
+    C -->|85% Token Reduction| D{3. Dense Vector Cache}
+    D -->|Cache Hit <5ms| G[Strict DOM Verification]
+    D -->|Cache Miss| E[4. AI Brain: LiteLLM Gateway]
+    E -->|Intent Diagnosis| F{RENAME vs MISSING?}
+    F -->|MISSING: Real Bug| H[Anti-Hallucination Guardrail: Abort Healing]
+    F -->|RENAME: Safe Refactor| G
+    G -->|5. Verify Unambiguous Element| I[Selector Fix: role / data-testid / text]
+    I -->|Store Embedding| D
+    I -->|6. Surgical Patch| J[LibCST AST Patcher]
+    J -->|Preserve Comments & Formatting| K[Automatic Verification Runner]
+    K -->|Pass| L[Commit Fix & Log Run]
+    K -->|Fail| M[Immediate Rollback from .kernhell.bak]
+```
+
+---
+
+## 🚀 Key Features
+
+- **Failure Interception & Live DOM Capture (`Scanner`)**: Intercepts Playwright selector timeouts and crashes, capturing the error stack trace, line number, broken selector, and live DOM snapshot (`page.content()`).
+- **High-Speed Semantic DOM Pruning (`DOMPruner`)**: Strips scripts, styles, SVGs, base64 data, and non-semantic wrappers using `selectolax` to slash token usage by 80–90% while keeping semantic landmarks and accessibility roles.
+- **Semantic Vector Memory (`Vector Cache`)**: 384-dimensional dense cosine index matching broken selectors against historical fixes. Resolves recurring failures in **<5ms** with zero LLM API cost.
+- **Strict Anti-Hallucination Guardrails**: Distinguishes between renamed selectors (`RENAME`) and genuine missing features (`MISSING`) to prevent false-positive heals on actual product regressions.
+- **Surgical LibCST AST Patching (`Patcher`)**: Surgically transforms only the target locator expression in the AST without reformatting unrelated code or stripping inline comments.
+- **Automated Verification & Zero-Risk Rollback (`Verifier`)**: Re-runs the patched test in a sandbox; if it fails, immediately restores the code from `.kernhell.bak`.
+- **Mission Control Dashboard (`Next.js App Router`)**: High-tech, dark-mode glassmorphic web dashboard providing live stats, real-time healing stream, semantic memory inspector, and interactive simulation playground.
+
+---
+
+## 📦 Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/riteshkumar072/KernHell.git
+cd KernHell
+
+# Install Python package in editable mode with all dependencies
+pip install -e ".[all]"
+
+# Install Mission Control dashboard dependencies
+cd dashboard
+npm install
+cd ..
+```
+
+---
+
+## 🛠️ CLI Usage
+
+```text
+Usage: kernhell [OPTIONS] COMMAND [ARGS]...
+
+┌─ Commands ──────────────────────────────────────────────────────────────────┐
+│ scan       Scan a test file to detect broken selectors and capture DOM      │
+│            snapshots.                                                       │
+│ heal       Autonomously heal broken Playwright selectors in a test file.    │
+│ dashboard  Launch the KernHell Mission Control Dashboard and REST API.      │
+│ ui         Alias for 'dashboard' command.                                   │
+│ cache      Inspect, query, and manage KernHell's Semantic Vector Cache.     │
+│ config     View and configure KernHell engine parameters.                   │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 1. Scan a Test File for Broken Selectors
+
+```bash
+kernhell scan tests/test_checkout.py
+```
+
+### 2. Autonomously Heal a Test File or Suite
+
+```bash
+# Preview changes without modifying code (dry run)
+kernhell heal tests/test_checkout.py --dry-run
+
+# Surgically patch and verify fix with automatic backup
+kernhell heal tests/test_checkout.py
+
+# Batch heal all test files in a folder
+kernhell heal tests/
+
+# Export machine-readable report for CI/CD pipelines
+kernhell heal tests/ --output json
+```
+
+### 3. Launch the Mission Control Dashboard
+
+```bash
+# Start FastAPI REST API and open dashboard in browser
+kernhell dashboard
+
+# Or run Next.js frontend directly:
+cd dashboard
+npm run dev
+```
+
+Visit **`http://localhost:3000`** to view the live dashboard and interactive playground.
+
+### 4. Semantic Vector Memory & Cache
+
+```bash
+# List all verified cached selector mappings
+kernhell cache list
+
+# View cache hit/miss ratio and efficiency metrics
+kernhell cache stats
+
+# Purge semantic memory
+kernhell cache clear
+```
+
+### 5. Engine Configuration
+
+```bash
+# Display active settings
+kernhell config show
+
+# Run the interactive configuration wizard
+kernhell config init
+```
+
+---
+
+## 🖥️ Mission Control Dashboard
+
+The dashboard provides a production-grade operations center:
+
+- **Overview (`/`)**: Real-time healing metrics (autonomous fixes, cache efficiency, real bugs guarded, dollar savings), live 6-stage pipeline status, and recent activity stream.
+- **Interactive Playground (`/playground`)**: Test healer sandbox with pre-configured refactor scenarios and out-of-stock guardrail alerts.
+- **Semantic Memory Explorer (`/cache`)**: Searchable browser for 384-dimensional dense vector embeddings with hit counts and verification badges.
+- **Run History & Diffs (`/history`)**: Audit trail with side-by-side syntax-highlighted unified diffs of AST code patches.
+
+---
+
+## 🧪 Running the Test Suite
+
+```bash
+# Run all 59 unit and integration tests
+python -m pytest -v
+
+# Run with test coverage
+python -m pytest tests/unit -v --cov=src/kernhell
+```
+
+---
+
+## 🗺️ Execution Roadmap
+
+- [x] **Weekend 1: Foundation (Scanner, Pruner, Core Models & CLI)**
+- [x] **Weekend 2: AI Brain (Analyzer, Healer, CST Surgical Patcher & Verifier)**
+- [x] **Weekend 3: Semantic Memory (Vector Cache, Embedder, Batch Healing & CI Export)**
+- [x] **Weekend 4: Mission Control Dashboard (Next.js & Production Release)**
+
+---
+
+## 📄 License
+
+MIT &copy; 2026 Ritesh Kumar • KernHell Systems

kernhell-0.1.0/pyproject.toml

@@ -0,0 +1,101 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "kernhell"
+version = "0.1.0"
+description = "AI-Powered Autonomous Self-Healing Testing Engine — The Heart of Your System Where Innovation Meets Precision"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "Ritesh", email = "ritesh@kernhell.dev" },
+]
+keywords = ["testing", "playwright", "self-healing", "ai", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "typer>=0.12,<1.0",
+    "rich>=13.0,<16.0",
+    "pydantic>=2.5,<3.0",
+    "pydantic-settings>=2.1,<3.0",
+    "playwright>=1.40,<2.0",
+    "selectolax>=0.3,<1.0",
+    "libcst>=1.1.0",
+    "structlog>=24.0",
+    "litellm>=1.30,<2.0",
+    "tomli>=2.0;python_version<'3.11'",
+]
+
+[project.optional-dependencies]
+cache = [
+    "chromadb>=0.4,<1.0",
+    "sentence-transformers>=2.2,<3.0",
+]
+dashboard = [
+    "fastapi>=0.110,<1.0",
+    "uvicorn[standard]>=0.27,<1.0",
+    "aiosqlite>=0.19,<1.0",
+]
+dev = [
+    "pytest>=8.0,<9.0",
+    "pytest-asyncio>=0.23,<1.0",
+    "pytest-cov>=5.0,<6.0",
+    "ruff>=0.3,<1.0",
+    "mypy>=1.8,<2.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]
+all = ["kernhell[cache,dashboard,dev]"]
+
+[project.scripts]
+kernhell = "kernhell.cli.app:app"
+
+[project.urls]
+Homepage = "https://github.com/riteshkumar072/KernHell"
+Documentation = "https://github.com/riteshkumar072/KernHell#readme"
+Repository = "https://github.com/riteshkumar072/KernHell"
+Issues = "https://github.com/riteshkumar072/KernHell/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/kernhell"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src/kernhell",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+    "/.kernhellrc.toml",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests/unit", "tests/integration"]
+pythonpath = ["src"]
+asyncio_mode = "auto"
+markers = [
+    "integration: marks tests requiring Playwright browsers (deselect with '-m \"not integration\"')",
+]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "RUF"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true

kernhell-0.1.0/src/kernhell/__init__.py

@@ -0,0 +1,8 @@
+"""
+KernHell — AI-Powered Autonomous Self-Healing Testing Engine.
+
+"The Heart of Your System Where Innovation Meets Precision"
+"""
+
+__version__ = "0.1.0"
+__app_name__ = "kernhell"

kernhell-0.1.0/src/kernhell/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running KernHell as `python -m kernhell`."""
+
+from kernhell.cli.app import app
+
+if __name__ == "__main__":
+    app()