codebeacon 0.1.2__py3-none-any.whl

codebeacon-0.1.2.dist-info/METADATA

@@ -0,0 +1,319 @@
+Metadata-Version: 2.4
+Name: codebeacon
+Version: 0.1.2
+Summary: Source code AST analysis tool for AI context generation — unified multi-framework knowledge graph
+Project-URL: Homepage, https://github.com/codebeacon/codebeacon
+Project-URL: Repository, https://github.com/codebeacon/codebeacon
+Project-URL: Issues, https://github.com/codebeacon/codebeacon/issues
+License: MIT
+License-File: LICENSE
+Keywords: ai-context,ast,claude,codebase,knowledge-graph,mcp
+Classifier: Development Status :: 3 - Alpha
+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 :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: networkx>=3.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tree-sitter-c-sharp>=0.23
+Requires-Dist: tree-sitter-go>=0.23
+Requires-Dist: tree-sitter-html>=0.23
+Requires-Dist: tree-sitter-java>=0.23
+Requires-Dist: tree-sitter-javascript>=0.23
+Requires-Dist: tree-sitter-kotlin>=0.23
+Requires-Dist: tree-sitter-php>=0.23
+Requires-Dist: tree-sitter-python>=0.23
+Requires-Dist: tree-sitter-ruby>=0.23
+Requires-Dist: tree-sitter-rust>=0.23
+Requires-Dist: tree-sitter-svelte>=0.23
+Requires-Dist: tree-sitter-swift>=0.0.1
+Requires-Dist: tree-sitter-typescript>=0.23
+Requires-Dist: tree-sitter>=0.23
+Provides-Extra: cluster
+Requires-Dist: graspologic>=1.0; extra == 'cluster'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English"></a>
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.ko.md"><img src="https://img.shields.io/badge/lang-한국어-red" alt="Korean"></a>
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.ja.md"><img src="https://img.shields.io/badge/lang-日本語-green" alt="Japanese"></a>
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/lang-简体中文-orange" alt="Chinese"></a>
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.es.md"><img src="https://img.shields.io/badge/lang-Español-yellow" alt="Spanish"></a>
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.fr.md"><img src="https://img.shields.io/badge/lang-Français-blueviolet" alt="French"></a>
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.de.md"><img src="https://img.shields.io/badge/lang-Deutsch-lightgrey" alt="German"></a>
+  <a href="https://github.com/codebeacon/codebeacon/blob/main/README.pt-BR.md"><img src="https://img.shields.io/badge/lang-Português_(BR)-brightgreen" alt="Portuguese (Brazil)"></a>
+</p>
+
+<h1 align="center">codebeacon</h1>
+
+<p align="center">
+  Source code AST analysis and AI context generation — unified multi-framework knowledge graph
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/codebeacon/"><img src="https://img.shields.io/pypi/v/codebeacon" alt="PyPI"></a>
+  <a href="https://pypi.org/project/codebeacon/"><img src="https://img.shields.io/pypi/pyversions/codebeacon" alt="Python"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License"></a>
+  <a href="https://github.com/codebeacon/codebeacon/stargazers"><img src="https://img.shields.io/github/stars/codebeacon/codebeacon" alt="GitHub Stars"></a>
+  <a href="https://github.com/codebeacon/codebeacon/commits/main"><img src="https://img.shields.io/github/last-commit/codebeacon/codebeacon" alt="Last Commit"></a>
+</p>
+
+---
+
+## Why codebeacon?
+
+Every time you open a new AI coding session, your assistant starts blind. It doesn't know your routes, your service layer, your entity model, or how your microservices call each other. You spend the first chunk of every session just getting the AI back up to speed — pasting files, explaining structure, re-establishing context.
+
+Existing tools solve this partially. Route analyzers map your controllers but miss service dependencies. Knowledge graph tools capture relationships but ignore your API surface. You end up running both, stitching output manually, and repeating it every time the codebase changes.
+
+**codebeacon unifies both approaches in a single CLI.** One command scans your entire codebase with tree-sitter AST parsing, resolves dependency injection across files, detects community clusters in your architecture, and writes a ready-to-use context map directly into `CLAUDE.md`, `.cursorrules`, and `AGENTS.md` — so your AI assistant walks into every session already knowing your codebase.
+
+---
+
+## Key Features
+
+- **Unified pipeline** — route/controller analysis + knowledge graph in one tool, no manual stitching
+- **17 frameworks, 9 languages** — Spring Boot, NestJS, Django, FastAPI, Rails, Express, React, Vue, Angular, Svelte, Gin, Laravel, Actix-Web, ASP.NET Core, Vapor, Ktor, and more
+- **Tree-sitter based** — structural AST parsing, not regex; all 17 language grammars included out of the box
+- **Two-pass DI resolution** — Pass 1 extracts local AST nodes; Pass 2 builds a global symbol table and resolves Interface → Implementation mappings that single-pass tools miss
+- **Wave merge architecture** — files processed in parallel chunks, results merged globally; handles large monorepos without memory blowouts
+- **Multiple output formats** — JSON knowledge graph, Markdown wiki, Obsidian vault, AI context maps, MCP server
+- **Community detection** — Leiden/Louvain clustering reveals your actual architectural boundaries
+- **Incremental cache** — SHA-256 based; only re-extracts files that changed since the last scan
+- **Zero configuration** — auto-detects frameworks and languages; generates `codebeacon.yaml` for repeat runs
+
+---
+
+## Quick Start
+
+```bash
+pip install codebeacon
+
+codebeacon scan .
+```
+
+That's it. codebeacon detects your project types, extracts routes/services/entities/components, builds a knowledge graph, and writes everything to `.codebeacon/`.
+
+For a multi-project workspace:
+
+```bash
+codebeacon scan /path/to/workspace   # auto-detects all projects, generates codebeacon.yaml
+codebeacon sync                      # subsequent runs via config
+```
+
+---
+
+## Supported Frameworks
+
+| Language | Frameworks |
+|----------|-----------|
+| Java / Kotlin | Spring Boot, Ktor |
+| Python | Django, FastAPI, Flask |
+| JavaScript / TypeScript | Express, NestJS, React, Vue, Angular, Svelte |
+| Go | Gin |
+| Ruby | Rails |
+| PHP | Laravel |
+| Rust | Actix-Web |
+| C# | ASP.NET Core |
+| Swift | Vapor |
+
+---
+
+## Architecture
+
+codebeacon runs a two-pass extraction pipeline:
+
+```
+[Config] → [Discover] → [Wave / Extract] → [Resolve] → [Filter] → [Enrich] → [Graph] → [Wiki] → [ContextMap] → [Export]
+                              │                  │           │          │
+                         Local AST           Symbol      Cross-lang  HTTP API
+                         per chunk           table       artifact    Shared DB
+                         (Pass 1)           matching    removal     entity edges
+                                            (Pass 2)
+```
+
+**Pass 1 — Wave extraction:** Files are processed in parallel chunks via `ThreadPoolExecutor`. Each file runs through five extractors: routes, services, entities, components, and dependencies. Results are cached by SHA-256 for incremental re-scans.
+
+**Pass 2 — Graph build:** All wave results are merged. A global symbol table resolves unresolved dependency injection references — mapping interfaces to implementations in the way Spring's implicit Bean wiring or TypeScript's injection tokens require. Filters remove build artifacts, spurious cross-language imports, and false cross-service edges.
+
+**Post-processing:** HTTP API edges connect frontend URL calls to matching backend routes. Community detection (Leiden → Louvain → connected components fallback) partitions the graph into architectural clusters. A structural report identifies god nodes, surprising cross-cluster connections, and hub files.
+
+---
+
+## Output Structure
+
+After a scan, everything lands in `.codebeacon/`:
+
+```
+.codebeacon/
+  beacon.json          ← full knowledge graph (node-link JSON, queryable)
+  REPORT.md            ← god nodes, surprising connections, hub files
+  CLAUDE.md            ← AI context map (also written to project root)
+  .cursorrules         ← Cursor IDE context
+  AGENTS.md            ← OpenAI Agents / Codex context
+  wiki/
+    index.md           ← global index (~200 tokens)
+    overview.md        ← platform stats + cross-project connections
+    routes.md          ← all routes table
+    cross-project/
+      connections.md   ← cross-service edges
+    <project>/
+      index.md
+      routes.md
+      controllers/<Name>.md
+      services/<Name>.md
+      entities/<Name>.md
+      components/<Name>.md
+  obsidian/            ← Obsidian vault (one note per graph node)
+```
+
+---
+
+## Installation Options
+
+```bash
+pip install codebeacon              # all 17 language grammars included
+pip install codebeacon[cluster]     # + Leiden community detection (graspologic)
+pip install --upgrade codebeacon    # upgrade to latest version with all dependencies
+```
+
+All language parsers (Java, Kotlin, Python, JavaScript, TypeScript, Go, Ruby, PHP, C#, Rust, Swift, HTML, Svelte) are bundled by default — no extra flags needed.
+
+---
+
+## CLI Reference
+
+```bash
+# Scan a project or workspace
+codebeacon scan <path> [options]
+codebeacon scan .                         # current directory
+codebeacon scan /workspace                # workspace root (multi-project)
+codebeacon scan . --update                # incremental: only re-extract changed files
+codebeacon scan . --wiki-only             # regenerate wiki without re-extracting
+codebeacon scan . --obsidian-dir <path>   # write Obsidian vault to custom location
+codebeacon scan . --semantic              # enable LLM semantic extraction
+codebeacon scan . --list-only             # detect frameworks only, don't extract
+
+# Config-driven mode
+codebeacon init [path]                    # auto-generate codebeacon.yaml
+codebeacon sync                           # run from codebeacon.yaml
+codebeacon sync --config <file>           # use a specific config file
+
+# Query the knowledge graph (coming soon)
+codebeacon query <term>                   # search nodes and edges
+codebeacon path <source> <target>         # shortest path between two nodes
+
+# Integrations
+codebeacon serve [--dir .codebeacon]      # start MCP server (stdio)
+codebeacon install                        # install Claude Code skill
+```
+
+---
+
+## Configuration
+
+Run `codebeacon init` to generate `codebeacon.yaml`, or write it manually:
+
+```yaml
+version: 1
+
+projects:
+  - name: api-server
+    path: ./api-server
+    type: spring-boot          # optional: auto-detected if omitted
+
+  - name: frontend
+    path: ./frontend
+    type: react
+
+output:
+  dir: .codebeacon
+  wiki: true
+  obsidian: true
+  graph_html: true
+  context_map:
+    targets: [CLAUDE.md, .cursorrules, AGENTS.md]
+
+wave:
+  auto: true
+  chunk_size: 300              # files per chunk
+  max_parallel: 5              # parallel threads
+
+semantic:
+  enabled: false               # override with --semantic flag
+```
+
+---
+
+## How It Compares
+
+| | codesight | graphify | **codebeacon** |
+|---|---|---|---|
+| Route / controller analysis | ✅ | ❌ | ✅ |
+| Service / DI graph | partial | ✅ | ✅ |
+| Interface → Impl resolution | ❌ | ❌ | ✅ |
+| Entity / ORM model extraction | ✅ | ❌ | ✅ |
+| Frontend component analysis | ✅ | ❌ | ✅ |
+| Community detection | ❌ | ✅ | ✅ |
+| Obsidian vault export | ❌ | ✅ | ✅ |
+| MCP server | ✅ | ❌ | ✅ |
+| AI context map (CLAUDE.md) | ✅ | ✅ | ✅ |
+| Multi-project workspace | partial | ❌ | ✅ |
+| Python-based | ❌ | ✅ | ✅ |
+
+codebeacon is not a replacement for either tool — it's the union of what both do, built around a shared extraction and graph layer.
+
+---
+
+## Benchmarks
+
+| Codebase | Stack | Files | Nodes | Edges | Communities | Scan time |
+|----------|-------|-------|-------|-------|-------------|-----------|
+| multi-service SaaS app | SvelteKit + Next.js + Spring Boot (3 projects) | 444 | 382 | 553 | 175 | ~12s |
+
+---
+
+## Privacy & Security
+
+All processing is local. Your source code never leaves your machine.
+
+- Tree-sitter AST parsing runs entirely in-process
+- No telemetry, no analytics, no network calls during normal operation
+- The `--semantic` flag (disabled by default) sends code excerpts to your configured LLM API — only enable it explicitly
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/codebeacon/codebeacon
+cd codebeacon
+pip install -e ".[dev,cluster]"
+pytest
+```
+
+The easiest entry point for adding new framework support is writing a tree-sitter query file in `codebeacon/extract/queries/`. See [`codebeacon/extract/queries/README.md`](codebeacon/extract/queries/README.md) for the full guide — it walks through grammar setup, `.scm` query syntax, capture naming conventions, and how to wire up a new extractor.
+
+Contributions welcome: new framework queries, language parsers, output formats, and benchmark datasets.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+## Acknowledgments
+
+Built on [tree-sitter](https://tree-sitter.github.io/tree-sitter/) for structural AST parsing, [NetworkX](https://networkx.org/) for graph operations, and [graspologic](https://microsoft.github.io/graspologic/) for Leiden community detection.
+
+Inspired by the complementary approaches of [codesight](https://github.com/Houseofmvps/codesight) and [graphify](https://github.com/safishamsi/graphify).

codebeacon-0.1.2.dist-info/RECORD

@@ -0,0 +1,59 @@
+codebeacon/__init__.py,sha256=YvuYzWnKtqBb-IqG8HAu-nhIYAsgj9Vmc_b9o7vO-js,22
+codebeacon/__main__.py,sha256=Jw8VAvcOZg6M1SD2UzL6lgCGMuZ6XK3f6qEuc-iVZQU,40
+codebeacon/cache.py,sha256=JtT3UfvfnPVlqxE8aNfbnme8v3AoGUn3F5ioidn6Xwc,4441
+codebeacon/cli.py,sha256=sI7_N0GtWNJ3c1ZvInPCWTDYEnuRmjphkedrILDLlG8,13995
+codebeacon/config.py,sha256=zchVUGYT1AtZEh5yX3Ck7mCZ1C1fMq7iS0mpicVqpL4,4238
+codebeacon/wave.py,sha256=ZywFn7C9AqdmdfgtXYIsMjEWUqx1GnGsGy98M-tF51k,10482
+codebeacon/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codebeacon/common/filters.py,sha256=YfmI-JliwfO78yOHt6kinYxP0qkubOYedqKFei8l7NY,5475
+codebeacon/common/symbols.py,sha256=B_ArKtUyKupZVsDaivih8DGTtEZoI19JbX5mqWVwW9A,4487
+codebeacon/common/types.py,sha256=xb6FlPnpcDKnKS49OH6hTLjIZ_V7w3PyTd_NLVwAn2c,3351
+codebeacon/contextmap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codebeacon/contextmap/generator.py,sha256=PU1VCLWNt4191ZF_sMhJhHd9VJClKKBEnYsKxu26Hw8,21579
+codebeacon/discover/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codebeacon/discover/detector.py,sha256=CRtGCtpy0EZCXtuyWwdnQAvYoiCk4ZrVjOt6bmA7MxQ,13858
+codebeacon/discover/scanner.py,sha256=WK-24ukvuxLbzQCaC_VXEokXEkQpn2wrjzOL_h4FOvI,4984
+codebeacon/export/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codebeacon/export/mcp.py,sha256=sW1LZZClaCDa3shf3HNQuEn2PnObdC_nmc002JtHMYc,18194
+codebeacon/export/obsidian.py,sha256=ohJvzcDvITeGJqQfwJnUujGVjgWr8xsKRT-dNAJPngU,28926
+codebeacon/extract/__init__.py,sha256=fNsS0fwWPcU-ydO9j-0xE8JxodNxerU82cgNiBhCVy0,884
+codebeacon/extract/base.py,sha256=Jvcnzta5yBFNho1LfNMpGUoiuzl-V7MCNnc-M-sD_vA,13428
+codebeacon/extract/components.py,sha256=LbKVS77CyxxeK19NF4AD_gWsdUeUfIbAIgxpas0yPfY,11574
+codebeacon/extract/dependencies.py,sha256=BlI6KXFySs5gwX1p9LGpalk5np6Ou-gDjLUocRGuZLE,4355
+codebeacon/extract/entities.py,sha256=K55PbgZ-QWYg5kRsLMtjPoYHk_coLvVZq1ZR8M29QU4,21296
+codebeacon/extract/routes.py,sha256=m0Vh4_vSD5JoKzUsJYON-QPZX75vBye-lsmSS073T1g,37278
+codebeacon/extract/semantic.py,sha256=UDyNOPwQvTEMM3UzwbYdrP_C1O0Vh5idR1aKI42wXLQ,10223
+codebeacon/extract/services.py,sha256=s8xR62cbAZCT_v3qdxWALaGDEV5rNMqoT92-wtTjMpQ,22585
+codebeacon/extract/queries/README.md,sha256=cLxO4n6FaUqJMtysQ2N3YFqrYlMWospb3DSJxqPRfFA,3548
+codebeacon/extract/queries/actix.scm,sha256=UAxVPkfhHZZzEwbgUwsQ_muQQVFY1m0fB0jc_16dSh0,4046
+codebeacon/extract/queries/angular.scm,sha256=RbVkLtQ8FFuKb8lXC_w4d9DTDWQhPxvB8SloM-RRcVM,4983
+codebeacon/extract/queries/aspnet.scm,sha256=f0ubY9qx7EI_FHonZj1RoNXR898A0oqslaTp1LTgHXM,5540
+codebeacon/extract/queries/django.scm,sha256=gwnarHH0EHGf8lrlV1Ocj5-DtY6TCMRwONLUVYZBL9U,4285
+codebeacon/extract/queries/express.scm,sha256=9P_Sv8RpxspH44Ibb3aAqgITWVi8c_k5-L4ml-2ckS0,3881
+codebeacon/extract/queries/fastapi.scm,sha256=Acq5CKkm6ZbcdaSOJH6Wt-O-r6WmbhBnqo9INehrhyg,4786
+codebeacon/extract/queries/flask.scm,sha256=J9eMl4_MGH1yXecm277xGZ-1ZA_ulDRFAfKANfXlrNU,3819
+codebeacon/extract/queries/gin.scm,sha256=nTmGWxc3M7CyZ-brc9lFio-ZR01mymzNNKgLdZfHyGQ,4716
+codebeacon/extract/queries/ktor.scm,sha256=w5NnUI2Yw6sz7QALfUIqXGcE4ECfFbNdu7RiVbgQ_4I,4902
+codebeacon/extract/queries/laravel.scm,sha256=v1YgXPz6RykkSlAFZaAMuz1XdsqKjUhPavkkybRlVuA,6025
+codebeacon/extract/queries/nestjs.scm,sha256=P4Zc6846k81t1wCIT-xiMQeUnyZZmr7QnJnebYskF0M,5648
+codebeacon/extract/queries/rails.scm,sha256=2ThcFtYV4J6M_xfaqRmKkmG0PFWCq01AHJWcPsejJOo,4066
+codebeacon/extract/queries/react.scm,sha256=SuYDiy3ScVuTEtOZXukYAKHWR2qSII9i46fdxtVVVMk,4068
+codebeacon/extract/queries/spring_boot.scm,sha256=CLOFLJzHiFqrSN2EdWg4_vLLpzXE3jMtPwtmqXiEN0s,7214
+codebeacon/extract/queries/svelte.scm,sha256=FcWTXkifZ_9jPhaBHdXVnqksW8nmiPaWjK48E2AZJLs,3053
+codebeacon/extract/queries/vapor.scm,sha256=vD5pKbuzP6Zwn1n6OQ1li3G3V8JLdbyZW1jCGSDRPs0,4361
+codebeacon/extract/queries/vue.scm,sha256=WC0il4m5u9Y2puUE9lG7mYwCP_a-03-iUk3_74Rb9VA,4119
+codebeacon/graph/__init__.py,sha256=ug1wEeheKYIO3bCjewSIJG1usuZNaoZ4h1UevQTY10M,64
+codebeacon/graph/analyze.py,sha256=3fZvbtSgLVG6aEKg5lsSr7-pGmH2o6FWJpAVTIizylY,8929
+codebeacon/graph/build.py,sha256=WGUBkRy4WnsfE8MBTqsuCGeJtXXXH43JGe4RjwMP3v0,10937
+codebeacon/graph/cluster.py,sha256=MoGP15Iw9kkUjImbO6n8ii1ni_iPmxYM6bW3MLkWstw,5104
+codebeacon/graph/enrich.py,sha256=CZIWMxBiaV4VtPiAdbO_G2L0li6yPlZFY36avn7cR0w,7376
+codebeacon/skill/SKILL.md,sha256=oNdQYO3o1dBwSHWB4smKD87u3C_MGMvSTGNxxAf8iy0,3957
+codebeacon/wiki/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codebeacon/wiki/generator.py,sha256=CVq7AjRFjGNQXVWJMrqMN_t9Fqk1mCBeoLJObbf41e4,14009
+codebeacon/wiki/index.py,sha256=Cxgg8TpgUyTaHA0t49AbAT5i_CtZLQRLfhdo09esURY,3397
+codebeacon/wiki/templates.py,sha256=3UaxMmGnON9Uk0l2bTvlC3yPMZ4MMiZOJGDkYg_pMOw,15883
+codebeacon-0.1.2.dist-info/METADATA,sha256=VnYu72GsfIuzSn-ql38xuJ1lN6NPGeGHQulB8khONqk,14065
+codebeacon-0.1.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+codebeacon-0.1.2.dist-info/entry_points.txt,sha256=PREJtJHtP-5peBsxynOAklCl9Yq_KHiDnkR1ruojxsQ,51
+codebeacon-0.1.2.dist-info/licenses/LICENSE,sha256=bjTdJsSZONg8LgvrDTRCHseKPiBXwCtYjkH7ytHyu-4,1080
+codebeacon-0.1.2.dist-info/RECORD,,

codebeacon-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

codebeacon-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codebeacon = codebeacon.cli:main

codebeacon-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 codebeacon contributors
+
+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.