dark-matter-cli 0.1.0__tar.gz

dark_matter_cli-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,59 @@
+name: 🐛 Bug Report
+description: Report anomalous pipeline behavior or incorrect bloat mass calculations.
+title: "[BUG]: <brief description>"
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping map the unseen mass. Please provide as much telemetry as possible so we can accurately reproduce the anomaly in the local DAG.
+  - type: textarea
+    id: description
+    attributes:
+      label: Anomaly Description
+      description: A clear and concise description of the pipeline failure or mathematical error.
+      placeholder: When computing the transitive in-degree map, dark-matter encounters a KeyError...
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction Vector
+      description: The exact CLI invocation or state required to reproduce the behavior.
+      placeholder: |
+        1. Have package `X` installed via Homebrew
+        2. Execute `dark-matter --sort recursive --standard`
+        3. Observe pipeline termination
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you mathematically or programmatically expect the pipeline to output?
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Traceback / Output Logs
+      description: Paste any relevant stderr tracebacks or verbose CLI output.
+      render: python
+  - type: input
+    id: version
+    attributes:
+      label: Dark Matter Version
+      description: Output of `dark-matter --version`
+      placeholder: "0.1.0"
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System / Architecture
+      options:
+        - macOS (Apple Silicon / ARM64)
+        - macOS (Intel / x86_64)
+        - Linux (POSIX)
+    validations:
+      required: true

dark_matter_cli-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Theoretical or Mathematical Inquiries
+    url: https://github.com/jacksonfergusondev/dark-matter/issues
+    about: Unsure how the Fractional Attribution Model distributes package mass? Open a general issue.

dark_matter_cli-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,29 @@
+name: 🚀 Feature Request
+description: Propose a new metric, attribution model, or pipeline enhancement.
+title: "[FEAT]: <brief description>"
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Have an idea to improve the resolution of the cosmological storage mapping? Detail the theoretical model or structural enhancement below.
+  - type: textarea
+    id: problem
+    attributes:
+      label: The Problem
+      description: Is this request addressing a specific limitation or graph-ignorance in the current pipeline?
+      placeholder: The current fractional model does not account for...
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Detail the programmatic implementation or mathematical algorithm you'd like to see added.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Are there other algorithms, heuristics, or external tooling that could achieve a similar result?

dark_matter_cli-0.1.0/.github/renovate.json

@@ -0,0 +1,60 @@
+{
+    "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+    "extends": [
+        "config:best-practices",
+        ":semanticCommits",
+        ":prHourlyLimit2"
+    ],
+    "ignorePaths": [
+        "docs/**",
+        "scripts/**",
+        "src/**",
+        "tests/**"
+    ],
+    "schedule": [
+        "before 4am on monday"
+    ],
+    "internalChecksFilter": "strict",
+    "rebaseWhen": "conflicted",
+    "labels": [
+        "dependencies",
+        "chore"
+    ],
+    "vulnerabilityAlerts": {
+        "schedule": [
+            "at any time"
+        ]
+    },
+    "packageRules": [
+        {
+            "description": "Require a package to be 2 weeks old before updating, but exclude vulnerability remediation from this wait.",
+            "matchUpdateTypes": [
+                "major",
+                "minor",
+                "patch",
+                "pin",
+                "digest"
+            ],
+            "minimumReleaseAge": "2 weeks"
+        },
+        {
+            "description": "Group all python dev-dependencies (ruff, mypy, pytest) into one PR and automerge them.",
+            "matchFileNames": [
+                "pyproject.toml"
+            ],
+            "matchDepTypes": [
+                "dependency-groups"
+            ],
+            "groupName": "python-dev-tools",
+            "automerge": true
+        },
+        {
+            "description": "Group GitHub Actions updates and automerge them.",
+            "matchManagers": [
+                "github-actions"
+            ],
+            "groupName": "github-actions",
+            "automerge": true
+        }
+    ]
+}

dark_matter_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  lint:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+      with:
+        enable-cache: true
+        python-version: "3.12"
+
+    - name: Install dependencies
+      run: uv sync --only-group ci --locked
+
+    - name: Run Ruff Linter
+      run: uv run ruff check --output-format=github .
+
+    - name: Run Ruff Formatter
+      run: uv run ruff format --check --output-format=github .
+
+    - name: Lint Markdown with rumdl
+      run: uv run rumdl check --output-format github .
+
+    - name: Check Markdown formatting with rumdl
+      run: uv run rumdl fmt --check --output-format github .
+
+    - name: Type check with Mypy
+      run: uv run mypy .
+
+  test:
+    name: Test on ${{ matrix.os }} / Python ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.12", "3.13", "3.14"]
+
+    steps:
+    - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+      with:
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        uv sync --only-group ci --locked
+        uv pip install pytest-github-actions-annotate-failures
+
+    - name: Run tests
+      run: uv run pytest

dark_matter_cli-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build-n-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          python-version: "3.14"
+
+      - name: Build distribution
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+
+  sync-homebrew:
+    name: Delegate Homebrew Update
+    needs: build-n-publish
+    uses: JacksonFergusonDev/ci-cd-tooling/.github/workflows/update-homebrew.yml@9300b4398eaedd7f3b369614433b38680e42ef02 # main
+    with:
+      tag: ${{ github.ref_name }}
+      package_name: "protostar"
+      formula_path: "Formula/protostar.rb"
+    secrets:
+      TAP_GITHUB_TOKEN: ${{ secrets.TAP_GITHUB_TOKEN }}

dark_matter_cli-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+*~
+.DS_Store
+.coverage
+.direnv/
+.env
+.envrc.local
+.idea/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+.vscode/
+Thumbs.db
+__pycache__/
+coverage.xml
+htmlcov/

dark_matter_cli-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,108 @@
+default_install_hook_types:
+  - pre-commit
+  - commit-msg
+  - pre-push
+
+default_stages:
+  - pre-commit
+
+fail_fast: true
+
+repos:
+  # Generic hooks (configured to IGNORE Python)
+  - repo: builtin
+    hooks:
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: check-symlinks
+      - id: check-executables-have-shebangs
+      - id: trailing-whitespace
+        exclude: \.py$
+      - id: end-of-file-fixer
+        exclude: \.py$|\.gitkeep$
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+
+  # Local Python + Markdown Toolchain (Managed via uv.lock)
+  - repo: local
+    hooks:
+      - id: uv-lock-check
+        name: uv lock check
+        entry: uv lock --check
+        language: system
+        pass_filenames: false
+        files: ^(pyproject\.toml|uv\.lock)$
+
+      - id: ruff-check
+        name: ruff check
+        entry: uv run ruff check --fix
+        language: system
+        types: [python]
+        exclude: ^docs/
+        require_serial: true
+
+      - id: ruff-format
+        name: ruff format
+        entry: uv run ruff format
+        language: system
+        types: [python]
+        exclude: ^docs/
+        require_serial: true
+
+      - id: mypy
+        name: mypy
+        entry: uv run mypy
+        language: system
+        types: [python]
+        exclude: ^docs/
+        require_serial: true
+
+      - id: rumdl-check
+        name: rumdl check
+        entry: uv run rumdl check --fix
+        language: system
+        types: [markdown]
+        require_serial: true
+
+      - id: rumdl-fmt
+        name: rumdl fmt
+        entry: uv run rumdl fmt
+        language: system
+        types: [markdown]
+        require_serial: true
+
+      - id: pytest-unit
+        name: pytest unit tests
+        entry: uv run pytest
+        language: system
+        pass_filenames: false
+        stages: [pre-push]
+
+  # Check for accidental commits of secrets
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.30.1
+    hooks:
+      - id: gitleaks
+
+  # Commit message validation
+  - repo: https://github.com/Goldziher/gitfluff
+    rev: v0.8.0
+    hooks:
+      - id: gitfluff-lint
+        args: [--write]
+        stages: [commit-msg]
+
+  # Renovate config validation
+  - repo: https://github.com/renovatebot/pre-commit-hooks
+    rev: 44.24.3
+    hooks:
+      - id: renovate-config-validator
+        files: '.github/renovate.json'
+
+  # GitHub Actions workflow validation
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.12
+    hooks:
+      - id: actionlint

dark_matter_cli-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

dark_matter_cli-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,33 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project maintainer at **<jackson.ferguson0@gmail.com>**.
+All complaints will be reviewed and
+investigated promptly and fairly.

dark_matter_cli-0.1.0/LICENSE

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

dark_matter_cli-0.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.5
+Name: dark-matter-cli
+Version: 0.1.0
+Summary: A dependency-graph-aware storage profiler for Homebrew.
+Project-URL: Repository, https://github.com/jacksonfergusondev/dark-matter
+Project-URL: Issues, https://github.com/jacksonfergusondev/dark-matter/issues
+Project-URL: PyPI, https://pypi.org/project/dark-matter-cli/
+Author-email: Jackson Ferguson <jackson.ferguson0@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Jackson Ferguson
+        
+        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.
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Requires-Dist: pandas>=3.0.3
+Requires-Dist: requests>=2.34.0
+Requires-Dist: rich>=15.0.0
+Requires-Dist: typer>=0.25.1
+Description-Content-Type: text/markdown
+
+<!-- rumdl-disable-file first-line-heading -->
+<div align="center">
+
+# Dark Matter
+
+**A dependency-graph-aware storage profiler for Homebrew.**
+
+[![CI](https://img.shields.io/github/actions/workflow/status/JacksonFergusonDev/dark-matter/ci.yml?style=flat-square&color=white&labelColor=0A0A0A&label=CI)](https://github.com/JacksonFergusonDev/dark-matter/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.12+-white?style=flat-square&labelColor=0A0A0A)](https://www.python.org/downloads/)
+[![Ruff](https://img.shields.io/badge/style-ruff-white?style=flat-square&labelColor=0A0A0A)](https://github.com/astral-sh/ruff)
+[![Mypy](https://img.shields.io/badge/mypy-checked-white?style=flat-square&labelColor=0A0A0A)](https://mypy-lang.org/)
+[![prek](https://img.shields.io/badge/prek-enabled-white?style=flat-square&labelColor=black)](https://github.com/j178/prek)
+[![License](https://img.shields.io/badge/license-MIT-white?style=flat-square&labelColor=0A0A0A)](LICENSE)
+
+</div>
+
+## Why
+
+Homebrew flattens every dependency into a single `Cellar` directory. Tools like `du` or `ncdu` can tell you a formula takes up 500 MB, but they have no concept of *why* — whether that mass belongs to the formula itself or to a shared runtime pulled in by five other packages you installed for unrelated reasons.
+
+Dark Matter reconstructs the dependency graph Homebrew already knows about and uses it to answer a more useful question: for each package you explicitly installed, how much disk space does it actually cost you, once shared dependencies are fairly split across everything that depends on them?
+
+## How it works
+
+Dark Matter parses Homebrew's own JSON metadata (via `brew info --json=v2` or its local API cache), rebuilds the dependency DAG, and walks it to compute two figures per package:
+
+- **Core size** — the package's own on-disk footprint (or, in theoretical mode, its compressed bottle archive).
+- **Weighted recursive size** — the core size plus a *fair share* of every transitive dependency, where each shared dependency's cost is divided evenly across all the packages that depend on it.
+
+The ratio between the two — the **Bloat Ratio** — is the headline number. A low ratio means a package is mostly self-contained; a high ratio means most of its footprint belongs to shared infrastructure it happens to require.
+
+## Features
+
+- **Comprehensive analysis suite**
+  - `analyze` — measures what's actually on disk, using `brew info --json=v2 --installed` and direct filesystem traversal (`os.scandir`) for exact byte counts.
+  - `leaderboard` — a theoretical mode that ranks Homebrew's *entire* formula and cask catalog from the local API cache, without requiring anything to be installed.
+  - `inspect` & `compare` — targeted O(1) theoretical resolution for individual or grouped packages without resolving the entire ecosystem payload.
+  - `explain` — breaks down a target package's bloat by attributing fractional byte costs to each of its transitive dependencies.
+  - `export` — streams the underlying DataFrames to CSV or JSON for integration into external data pipelines.
+- **Fractional Attribution Model** — shared dependencies (`openssl`, `python`, etc.) are divided proportionally across all parent packages instead of being double-counted, giving an honest per-package cost.
+- **Daemon-free** — no background indexing, no persistent database. Every run is a fresh, on-demand computation.
+- **Typed and tested** — fully type-annotated (strict `mypy`), linted with `ruff`, and covered by a `pytest` suite exercising the DAG traversal, fractional math, and network resolution logic. CI runs the full suite on macOS and Ubuntu across Python 3.12 and 3.14.
+
+## A note on theoretical measurements
+
+`leaderboard`, `inspect`, `compare`, and `explain` rely on `Content-Length` headers from `ghcr.io` blob storage, which report *compressed* archive size, not the size a package occupies once unpacked to disk. The absolute numbers they report will therefore run lower than `analyze`'s physical measurements.
+
+The Bloat Ratio, however, stays meaningful. Since most bottles compress with similar algorithms (gzip or zstd), the compression factor $c$ appears in both the numerator and denominator and cancels out:
+
+$$R \approx \frac{c \cdot m_{recursive}}{c \cdot m_{core}} \approx \frac{m_{recursive}}{m_{core}}$$
+
+So while theoretical modes shouldn't be read as precise disk-space forecasts, they are a reliable way to evaluate relative bloat without installing anything.
+
+## Installation
+
+```bash
+git clone https://github.com/jacksonfergusondev/dark-matter.git
+cd dark-matter
+uv tool install --editable .
+```
+
+## Usage
+
+```bash
+# Analyze what's actually installed
+dark-matter analyze
+
+# Rank the entire Homebrew catalog by theoretical bloat
+dark-matter leaderboard
+
+# Evaluate a specific formula instantly
+dark-matter inspect uv
+
+# Break down the dependency bloat of a specific package
+dark-matter explain uv
+
+# Compare multiple packages side-by-side
+dark-matter compare uv poetry pdm
+
+# Export the entire graph to JSON for external analysis
+dark-matter export --format json > homebrew_bloat.json
+```
+
+All commands accept the global `--verbose` / `-v` flag for debug logging, and `--version` to print the installed version.
+
+### `analyze`
+
+| Flag | Default | Description |
+| --- | --- | --- |
+| `--sort` / `-s` | `ratio` | Sort by `ratio`, `core`, or `recursive` |
+| `--top` / `-n` | `20` | Number of packages to display |
+| `--fractional` / `--standard` | `--fractional` | Toggle the Fractional Attribution Model |
+
+### `leaderboard`
+
+| Flag | Default | Description |
+| --- | --- | --- |
+| `--sort` / `-s` | `ratio` | Sort by `ratio`, `core`, or `recursive` |
+| `--top` / `-n` | `20` | Number of packages to display |
+| `--arch` / `-a` | `arm64_tahoe` | Target bottle architecture |
+
+### `inspect`
+
+| Argument/Flag | Default | Description |
+| --- | --- | --- |
+| `[PACKAGE]` | **Required** | The target package to analyze |
+| `--source` / `-s` | `installed` | Data source to compute: `installed` or `catalog` |
+| `--arch` / `-a` | `arm64_tahoe` | Target bottle architecture |
+
+### `compare`
+
+| Argument/Flag | Default | Description |
+| --- | --- | --- |
+| `[PACKAGES]...` | **Required** | A space-separated list of packages to compare |
+| `--sort` / `-s` | `ratio` | Sort by `ratio`, `core`, or `recursive` |
+| `--source` / `-s` | `installed` | Data source to compute: `installed` or `catalog` |
+| `--arch` / `-a` | `arm64_tahoe` | Target bottle architecture |
+
+### `explain`
+
+| Argument/Flag | Default | Description |
+| --- | --- | --- |
+| `[PACKAGE]` | **Required** | The specific package to analyze |
+| `--source` / `-s` | `installed` | Data source to compute: `installed` or `catalog` |
+| `--arch` / `-a` | `arm64_tahoe` | Target bottle architecture |
+
+### `export`
+
+| Flag | Default | Description |
+| --- | --- | --- |
+| `--source` / `-s` | `installed` | Data source to compute: `installed` or `catalog` |
+| `--format` / `-f` | `csv` | Output format: `csv` or `json` |
+| `--arch` / `-a` | `arm64_tahoe` | Target bottle architecture (for `catalog` source) |
+
+## Development
+
+The project uses [`just`](https://github.com/casey/just) to wrap common tasks:
+
+```bash
+just format       # ruff format + fix
+just lint         # ruff + rumdl
+just typecheck    # mypy
+just test         # pytest
+just test-cov     # pytest with coverage report
+just ci           # the full pipeline CI runs, locally
+```
+
+## 📧 Contact
+
+[![GitHub](https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white)](https://github.com/JacksonFergusonDev)
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/jackson--ferguson/)
+[![Email](https://img.shields.io/badge/Email-D14836?style=for-the-badge&logo=gmail&logoColor=white)](mailto:jackson.ferguson0@gmail.com)
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.