codepulse-cli 0.1.0__tar.gz

codepulse_cli-0.1.0/.github/workflows/codepulse.yml

@@ -0,0 +1,52 @@
+name: CodePulse risk gate
+
+# Scores what each pull request changes against the repo's history and posts
+# the result as a sticky PR comment. Fails the check on HIGH risk.
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  risk:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # full history is required to build the risk map
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install CodePulse
+        run: pip install -e .
+
+      - name: Build risk comment
+        run: |
+          codepulse . --changed "origin/${{ github.base_ref }}" \
+            --format markdown > comment.md
+          cat comment.md
+
+      - name: Post sticky PR comment
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR: ${{ github.event.pull_request.number }}
+        run: |
+          # Update our previous comment if one exists, else create it.
+          id=$(gh api "repos/${{ github.repository }}/issues/$PR/comments" \
+                 --jq '.[] | select(.body | startswith("<!-- codepulse -->")) | .id' \
+               | head -1)
+          if [ -n "$id" ]; then
+            gh api --method PATCH \
+              "repos/${{ github.repository }}/issues/comments/$id" \
+              -f body="$(cat comment.md)" >/dev/null
+          else
+            gh pr comment "$PR" --body-file comment.md
+          fi
+
+      - name: Enforce risk gate
+        run: codepulse . --changed "origin/${{ github.base_ref }}" --fail-on HIGH

codepulse_cli-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,19 @@
+name: tests
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest -q

codepulse_cli-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+# CodePulse output
+codepulse-report.html
+*-report.html
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/

codepulse_cli-0.1.0/LICENSE

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

codepulse_cli-0.1.0/PKG-INFO

@@ -0,0 +1,227 @@
+Metadata-Version: 2.5
+Name: codepulse-cli
+Version: 0.1.0
+Summary: Reveal a codebase's health from its git history — hotspots, bus factor, hidden coupling, and a CI risk gate.
+Project-URL: Homepage, https://github.com/Mehouelley/codepulse
+Project-URL: Repository, https://github.com/Mehouelley/codepulse
+Project-URL: Issues, https://github.com/Mehouelley/codepulse/issues
+Author-email: Mehouelley <fabricemehouelley43@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: code-health,code-quality,devops,git,hotspots,static-analysis,technical-debt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🩺 CodePulse
+
+[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-CodePulse-2088FF?logo=github&logoColor=white)](https://github.com/marketplace/actions/codepulse-risk-gate)
+[![tests](https://github.com/Mehouelley/codepulse/actions/workflows/tests.yml/badge.svg)](https://github.com/Mehouelley/codepulse/actions/workflows/tests.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Zero dependencies](https://img.shields.io/badge/dependencies-none-brightgreen.svg)](pyproject.toml)
+
+**Reveal a codebase's health from its git history.**
+
+Linters read your code. CodePulse reads your code's *history* — and that reveals
+things no linter can see: where bugs are born, what knowledge lives in one
+person's head, and which files are secretly glued together.
+
+Because it works purely from git history, **CodePulse works on any language**,
+with **zero dependencies** beyond git and Python.
+
+---
+
+## Demo
+
+<!-- Render docs/demo.gif from demo.tape with `vhs demo.tape`, then:
+     ![demo](docs/demo.gif) -->
+
+```console
+$ codepulse . --badge
+Grade: B (83/100)
+  -2 bus factor (9 fichiers à auteur unique)
+  -15 pression hotspots en hausse
+![code health](https://img.shields.io/badge/code%20health-B%20(83)-green)
+
+$ codepulse . --changed origin/main
+🔴 Release risk: HIGH (100/100)
+   56 changed files · 2 high-risk
+   [100] crates/ui-egui/src/lib.rs  (hotspot majeur)
+   [ 70] crates/layout/src/para.rs  (zone active, auteur unique)
+   👥 Relecteurs suggérés: Valentin Klein (29/37 fichiers), Dmitrii Khlapov (22/37)
+
+$ codepulse . --who crates/ui-egui/src/canvas.rs
+crates/ui-egui/src/canvas.rs — 64 commits, 22 auteur(s), dernier changement 2026-10-12
+   45%   29 commits  Valentin Klein
+   11%    7 commits  Dmitrii Khlapov
+```
+
+> A recordable [`demo.tape`](demo.tape) (for [VHS](https://github.com/charmbracelet/vhs))
+> generates an animated `docs/demo.gif` of the above.
+
+---
+
+## What it shows
+
+| Signal | Question it answers |
+|---|---|
+| 🔥 **Hotspots** | *Where do I refactor first?* Files that are both complex and changed constantly — the birthplace of most bugs. |
+| 👥 **Bus factor** | *What breaks if someone leaves?* Files actively maintained by a single person. |
+| 🔗 **Hidden coupling** | *What really depends on what?* Files that almost always change together, even when the code doesn't show a link. |
+| 🏆 **Contributors** | Who is active across the analyzed window. |
+
+The result is a single self-contained **HTML dashboard** you can open anywhere
+or email to your team.
+
+---
+
+## Quick start
+
+```bash
+# From a git repository:
+python -m codepulse /path/to/repo --open
+
+# Common options:
+python -m codepulse . --since "6 months ago" --top 30 -o health.html
+```
+
+> Running from the source checkout? Prefix with `PYTHONPATH=src`, or install it:
+> `pip install -e .` then just run `codepulse`.
+
+### Options
+
+| Flag | Meaning |
+|---|---|
+| `repo` | Path to a git repository (default: current directory) |
+| `-o, --output` | Output HTML path (default: `codepulse-report.html`) |
+| `--since` | Only commits after a date, e.g. `"6 months ago"` |
+| `--max-count N` | Limit to the N most recent commits |
+| `--top N` | Rows per table (default: 20) |
+| `--open` | Open the report in a browser when done |
+| `--who PATH` | Show who knows a file best (from history) and exit |
+| `--badge` | Print a shields.io health-badge snippet and exit |
+| `--ignore GLOB` | Exclude paths matching a glob (repeatable) |
+
+---
+
+## Use in CI (the risk gate)
+
+CodePulse can score *only the files a change touches* against the repo's risk
+map, then set an exit code so your pipeline can warn or block.
+
+```bash
+# Score what this branch changed vs main; fail the job on HIGH risk.
+python -m codepulse . --changed origin/main --fail-on HIGH
+
+# Machine-readable output for dashboards / PR comments:
+python -m codepulse . --changed origin/main --format json
+```
+
+Output (JSON):
+
+```json
+{
+  "level": "HIGH",
+  "score": 100,
+  "high_risk_count": 1,
+  "files": [
+    { "path": "auth.py", "risk": 100, "commits": 6, "loc": 7,
+      "reasons": ["hotspot majeur", "auteur unique (Alice)"] }
+  ]
+}
+```
+
+### GitHub Action (two lines)
+
+Add CodePulse to any repository as a reusable Action — it scores each PR, posts
+a **sticky comment** (updated in place, never spammed), and fails the check on
+`HIGH` risk:
+
+```yaml
+name: CodePulse
+on: pull_request
+permissions:
+  contents: read
+  pull-requests: write
+jobs:
+  risk:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 } # full history is required
+      - uses: Mehouelley/codepulse@v0.1.0
+        with:
+          fail-on: HIGH # or MEDIUM / LOW / '' to never fail
+```
+
+The PR comment looks like:
+
+> 🩺 **CodePulse — Risque : 🔴 HIGH (100/100)**
+> 38 fichiers modifiés · 1 à risque élevé
+>
+> 👥 **Relecteurs suggérés** : Valentin Klein (29/37 fichiers), Dmitrii Khlapov (22/37)
+
+Prefer a plain workflow with no external action? One ships in
+[`.github/workflows/codepulse.yml`](.github/workflows/codepulse.yml) — copy it in as-is.
+
+**Why DevOps cares:** a release is roughly as risky as its riskiest file.
+Touching a well-known hotspot — or a file only one person understands — is
+exactly where change-failure-rate (a DORA metric) comes from. The gate makes
+that risk visible *before* merge, not after an incident.
+
+---
+
+## How it works
+
+1. Parses `git log --numstat` into commits and file changes (no merges).
+2. Accumulates per-file history: commit count, authors, size on disk.
+3. Derives the signals:
+   - **Hotspot score** = `commits × complexity`, where complexity estimates
+     decision points (branch keywords + boolean operators) — far better than
+     raw line count at telling "big but simple" from "dense and risky".
+   - **Bus factor risk** = files with ≥3 commits but exactly one author.
+   - **Coupling degree** = `commits-together / min(individual commits)`,
+     ignoring bulk commits that touch many files at once.
+
+Inspired by the "code as a crime scene" approach to software analysis, made
+simple enough to run in one command.
+
+---
+
+## Roadmap
+
+- [x] Risk gate: score a change set, JSON output, CI exit code
+- [x] Ignore globs / path filters for generated & data files
+- [x] Post the gate result as a sticky PR comment (GitHub Action)
+- [x] Trend over time (adaptive day/week/month buckets + hotspot-pressure verdict)
+- [x] Complexity-based hotspots (decision-point estimate instead of line count)
+- [x] Suggested PR reviewers from code ownership (in gate text/json/comment)
+- [x] `--who <file>` — who knows this code best
+- [x] `--badge` — shareable A–F health badge for your README
+- [x] Orphaned-code section — complex files nobody touches anymore
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+The suite covers the complexity estimator, git parsing, every analyzer, and an
+end-to-end run against a throwaway git repo. CI runs it on Python 3.10 and 3.12.
+
+## License
+
+MIT

codepulse_cli-0.1.0/README.md

@@ -0,0 +1,201 @@
+# 🩺 CodePulse
+
+[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-CodePulse-2088FF?logo=github&logoColor=white)](https://github.com/marketplace/actions/codepulse-risk-gate)
+[![tests](https://github.com/Mehouelley/codepulse/actions/workflows/tests.yml/badge.svg)](https://github.com/Mehouelley/codepulse/actions/workflows/tests.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Zero dependencies](https://img.shields.io/badge/dependencies-none-brightgreen.svg)](pyproject.toml)
+
+**Reveal a codebase's health from its git history.**
+
+Linters read your code. CodePulse reads your code's *history* — and that reveals
+things no linter can see: where bugs are born, what knowledge lives in one
+person's head, and which files are secretly glued together.
+
+Because it works purely from git history, **CodePulse works on any language**,
+with **zero dependencies** beyond git and Python.
+
+---
+
+## Demo
+
+<!-- Render docs/demo.gif from demo.tape with `vhs demo.tape`, then:
+     ![demo](docs/demo.gif) -->
+
+```console
+$ codepulse . --badge
+Grade: B (83/100)
+  -2 bus factor (9 fichiers à auteur unique)
+  -15 pression hotspots en hausse
+![code health](https://img.shields.io/badge/code%20health-B%20(83)-green)
+
+$ codepulse . --changed origin/main
+🔴 Release risk: HIGH (100/100)
+   56 changed files · 2 high-risk
+   [100] crates/ui-egui/src/lib.rs  (hotspot majeur)
+   [ 70] crates/layout/src/para.rs  (zone active, auteur unique)
+   👥 Relecteurs suggérés: Valentin Klein (29/37 fichiers), Dmitrii Khlapov (22/37)
+
+$ codepulse . --who crates/ui-egui/src/canvas.rs
+crates/ui-egui/src/canvas.rs — 64 commits, 22 auteur(s), dernier changement 2026-10-12
+   45%   29 commits  Valentin Klein
+   11%    7 commits  Dmitrii Khlapov
+```
+
+> A recordable [`demo.tape`](demo.tape) (for [VHS](https://github.com/charmbracelet/vhs))
+> generates an animated `docs/demo.gif` of the above.
+
+---
+
+## What it shows
+
+| Signal | Question it answers |
+|---|---|
+| 🔥 **Hotspots** | *Where do I refactor first?* Files that are both complex and changed constantly — the birthplace of most bugs. |
+| 👥 **Bus factor** | *What breaks if someone leaves?* Files actively maintained by a single person. |
+| 🔗 **Hidden coupling** | *What really depends on what?* Files that almost always change together, even when the code doesn't show a link. |
+| 🏆 **Contributors** | Who is active across the analyzed window. |
+
+The result is a single self-contained **HTML dashboard** you can open anywhere
+or email to your team.
+
+---
+
+## Quick start
+
+```bash
+# From a git repository:
+python -m codepulse /path/to/repo --open
+
+# Common options:
+python -m codepulse . --since "6 months ago" --top 30 -o health.html
+```
+
+> Running from the source checkout? Prefix with `PYTHONPATH=src`, or install it:
+> `pip install -e .` then just run `codepulse`.
+
+### Options
+
+| Flag | Meaning |
+|---|---|
+| `repo` | Path to a git repository (default: current directory) |
+| `-o, --output` | Output HTML path (default: `codepulse-report.html`) |
+| `--since` | Only commits after a date, e.g. `"6 months ago"` |
+| `--max-count N` | Limit to the N most recent commits |
+| `--top N` | Rows per table (default: 20) |
+| `--open` | Open the report in a browser when done |
+| `--who PATH` | Show who knows a file best (from history) and exit |
+| `--badge` | Print a shields.io health-badge snippet and exit |
+| `--ignore GLOB` | Exclude paths matching a glob (repeatable) |
+
+---
+
+## Use in CI (the risk gate)
+
+CodePulse can score *only the files a change touches* against the repo's risk
+map, then set an exit code so your pipeline can warn or block.
+
+```bash
+# Score what this branch changed vs main; fail the job on HIGH risk.
+python -m codepulse . --changed origin/main --fail-on HIGH
+
+# Machine-readable output for dashboards / PR comments:
+python -m codepulse . --changed origin/main --format json
+```
+
+Output (JSON):
+
+```json
+{
+  "level": "HIGH",
+  "score": 100,
+  "high_risk_count": 1,
+  "files": [
+    { "path": "auth.py", "risk": 100, "commits": 6, "loc": 7,
+      "reasons": ["hotspot majeur", "auteur unique (Alice)"] }
+  ]
+}
+```
+
+### GitHub Action (two lines)
+
+Add CodePulse to any repository as a reusable Action — it scores each PR, posts
+a **sticky comment** (updated in place, never spammed), and fails the check on
+`HIGH` risk:
+
+```yaml
+name: CodePulse
+on: pull_request
+permissions:
+  contents: read
+  pull-requests: write
+jobs:
+  risk:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 } # full history is required
+      - uses: Mehouelley/codepulse@v0.1.0
+        with:
+          fail-on: HIGH # or MEDIUM / LOW / '' to never fail
+```
+
+The PR comment looks like:
+
+> 🩺 **CodePulse — Risque : 🔴 HIGH (100/100)**
+> 38 fichiers modifiés · 1 à risque élevé
+>
+> 👥 **Relecteurs suggérés** : Valentin Klein (29/37 fichiers), Dmitrii Khlapov (22/37)
+
+Prefer a plain workflow with no external action? One ships in
+[`.github/workflows/codepulse.yml`](.github/workflows/codepulse.yml) — copy it in as-is.
+
+**Why DevOps cares:** a release is roughly as risky as its riskiest file.
+Touching a well-known hotspot — or a file only one person understands — is
+exactly where change-failure-rate (a DORA metric) comes from. The gate makes
+that risk visible *before* merge, not after an incident.
+
+---
+
+## How it works
+
+1. Parses `git log --numstat` into commits and file changes (no merges).
+2. Accumulates per-file history: commit count, authors, size on disk.
+3. Derives the signals:
+   - **Hotspot score** = `commits × complexity`, where complexity estimates
+     decision points (branch keywords + boolean operators) — far better than
+     raw line count at telling "big but simple" from "dense and risky".
+   - **Bus factor risk** = files with ≥3 commits but exactly one author.
+   - **Coupling degree** = `commits-together / min(individual commits)`,
+     ignoring bulk commits that touch many files at once.
+
+Inspired by the "code as a crime scene" approach to software analysis, made
+simple enough to run in one command.
+
+---
+
+## Roadmap
+
+- [x] Risk gate: score a change set, JSON output, CI exit code
+- [x] Ignore globs / path filters for generated & data files
+- [x] Post the gate result as a sticky PR comment (GitHub Action)
+- [x] Trend over time (adaptive day/week/month buckets + hotspot-pressure verdict)
+- [x] Complexity-based hotspots (decision-point estimate instead of line count)
+- [x] Suggested PR reviewers from code ownership (in gate text/json/comment)
+- [x] `--who <file>` — who knows this code best
+- [x] `--badge` — shareable A–F health badge for your README
+- [x] Orphaned-code section — complex files nobody touches anymore
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+The suite covers the complexity estimator, git parsing, every analyzer, and an
+end-to-end run against a throwaway git repo. CI runs it on Python 3.10 and 3.12.
+
+## License
+
+MIT

codepulse_cli-0.1.0/action.yml

@@ -0,0 +1,69 @@
+name: 'CodePulse Risk Gate'
+description: 'Score pull-request changes against your git history, comment the risk, and gate on it.'
+author: 'Mehouelley'
+
+branding:
+  icon: 'activity'
+  color: 'red'
+
+inputs:
+  path:
+    description: 'Path to the repository to analyze'
+    required: false
+    default: '.'
+  fail-on:
+    description: 'Fail the job when risk reaches this level (LOW|MEDIUM|HIGH). Leave empty to never fail.'
+    required: false
+    default: 'HIGH'
+  base-ref:
+    description: 'Base ref to diff against. Defaults to the PR base branch.'
+    required: false
+    default: ''
+  comment:
+    description: 'Post/update a sticky risk comment on the PR (true|false).'
+    required: false
+    default: 'true'
+
+runs:
+  using: 'composite'
+  steps:
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Install CodePulse
+      shell: bash
+      run: pip install "${{ github.action_path }}"
+
+    - name: Resolve base ref
+      id: base
+      shell: bash
+      run: |
+        base="${{ inputs.base-ref }}"
+        if [ -z "$base" ]; then base="origin/${{ github.base_ref }}"; fi
+        echo "ref=$base" >> "$GITHUB_OUTPUT"
+
+    - name: Comment risk on PR
+      if: ${{ inputs.comment == 'true' && github.event.pull_request.number }}
+      shell: bash
+      env:
+        GH_TOKEN: ${{ github.token }}
+        PR: ${{ github.event.pull_request.number }}
+        REPO: ${{ github.repository }}
+      run: |
+        codepulse "${{ inputs.path }}" --changed "${{ steps.base.outputs.ref }}" \
+          --format markdown > "$RUNNER_TEMP/codepulse.md"
+        cat "$RUNNER_TEMP/codepulse.md"
+        id=$(gh api "repos/$REPO/issues/$PR/comments" \
+               --jq '.[] | select(.body | startswith("<!-- codepulse -->")) | .id' | head -1)
+        if [ -n "$id" ]; then
+          gh api --method PATCH "repos/$REPO/issues/comments/$id" \
+            -f body="$(cat "$RUNNER_TEMP/codepulse.md")" >/dev/null
+        else
+          gh pr comment "$PR" --body-file "$RUNNER_TEMP/codepulse.md"
+        fi
+
+    - name: Enforce risk gate
+      if: ${{ inputs.fail-on != '' }}
+      shell: bash
+      run: codepulse "${{ inputs.path }}" --changed "${{ steps.base.outputs.ref }}" --fail-on "${{ inputs.fail-on }}"

codepulse_cli-0.1.0/demo.tape

@@ -0,0 +1,28 @@
+# CodePulse demo recording.
+#
+# Renders docs/demo.gif. Install VHS (https://github.com/charmbracelet/vhs),
+# then from a checkout of a repo WITH REAL HISTORY run:
+#
+#     vhs demo.tape
+#
+# (Run it inside a mature repo so hotspots/reviewers have data to show.)
+
+Output docs/demo.gif
+
+Set FontSize 16
+Set Width 1120
+Set Height 660
+Set Padding 20
+Set Theme "Dracula"
+
+Type "# 1. An A–F health badge for your README" Enter
+Type "codepulse . --badge" Sleep 500ms Enter
+Sleep 3s
+
+Type "# 2. Score what a pull request changes" Enter
+Type "codepulse . --changed HEAD~20" Sleep 500ms Enter
+Sleep 4s
+
+Type "# 3. Who knows this file best?" Enter
+Type "codepulse . --who src/codepulse/cli.py" Sleep 500ms Enter
+Sleep 4s

codepulse_cli-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "codepulse-cli"
+version = "0.1.0"
+description = "Reveal a codebase's health from its git history — hotspots, bus factor, hidden coupling, and a CI risk gate."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Mehouelley", email = "fabricemehouelley43@gmail.com" }]
+keywords = ["git", "code-health", "hotspots", "technical-debt", "static-analysis", "devops", "code-quality"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+
+[project.urls]
+Homepage = "https://github.com/Mehouelley/codepulse"
+Repository = "https://github.com/Mehouelley/codepulse"
+Issues = "https://github.com/Mehouelley/codepulse/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "build>=1.0", "twine>=5.0"]
+
+[project.scripts]
+codepulse = "codepulse.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codepulse"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

codepulse_cli-0.1.0/src/codepulse/__init__.py

@@ -0,0 +1,3 @@
+"""CodePulse — reveal a codebase's health from its git history."""
+
+__version__ = "0.1.0"

codepulse_cli-0.1.0/src/codepulse/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())