git-graphable 0.4.0__tar.gz → 0.6.0__tar.gz

{git_graphable-0.4.0 → git_graphable-0.6.0}/.github/workflows/ci.yml

@@ -34,8 +34,21 @@ jobs:
       - name: Run checks
         run: just check
 
+      - name: Generate Coverage Badge
+        run: |
+          if [ -f "htmlcov/index.html" ]; then
+            COVERAGE=$(grep -oP 'pc_cov">\d+%' htmlcov/index.html | head -1 | grep -oP '\d+')
+            echo "{\"schemaVersion\": 1, \"label\": \"coverage\", \"message\": \"$COVERAGE%\", \"color\": \"brightgreen\"}" > coverage.json
+          fi
+
       - name: Git Graph Reports
-        uses: ./.github/actions/git-graphable
+        uses: ./
         with:
           production_branch: 'main'
           output_dir: 'git-graph-reports'
+
+      - name: Copy Coverage to Reports
+        run: |
+          if [ -f "coverage.json" ]; then
+            cp coverage.json git-graph-reports/
+          fi

git_graphable-0.6.0/.github/workflows/pages.yml

@@ -0,0 +1,65 @@
+name: Deploy Demos to Pages
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Install just
+        uses: extractions/setup-just@v3
+
+      - name: Generate Demos
+        run: uv run python examples/publish_demos.py
+
+      - name: Generate Coverage Badge
+        run: |
+          just coverage
+          if [ -f "htmlcov/index.html" ]; then
+            COVERAGE=$(grep -oP 'pc_cov">\d+%' htmlcov/index.html | head -1 | grep -oP '\d+')
+            echo "{\"schemaVersion\": 1, \"label\": \"coverage\", \"message\": \"$COVERAGE%\", \"color\": \"brightgreen\"}" > demo-site/coverage.json
+          fi
+
+      - name: Generate Hygiene Badge
+        run: |
+          uv run git-graphable analyze . --bare --hygiene-output hygiene.json --output -
+          SCORE=$(grep -oP '"score": \d+' hygiene.json | grep -oP '\d+')
+          GRADE=$(grep -oP '"grade": "[^"]+"' hygiene.json | cut -d'"' -f4)
+          COLOR=$(grep -oP '"color": "[^"]+"' hygiene.json | cut -d'"' -f4)
+          echo "{\"schemaVersion\": 1, \"label\": \"hygiene\", \"message\": \"$SCORE% ($GRADE)\", \"color\": \"$COLOR\"}" > demo-site/hygiene_badge.json
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'demo-site'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

{git_graphable-0.4.0 → git_graphable-0.6.0}/.gitignore

@@ -39,6 +39,7 @@ pip-delete-this-directory.txt
 # Unit test / coverage reports
 htmlcov/
 htmlrep/
+report_output/
 .pytest_worker_jsons/
 .tox/
 .nox/
@@ -131,8 +132,7 @@ cython_debug/
 .DS_Store
 
 # Examples
+demo-site/
 examples/repos/
 examples/assets/
-
-# Temporary test assets
-test_pr.mmd
+graph.html

git_graphable-0.6.0/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.6.0] - 2026-03-06
+
+### Added
+- **Native GitLab Support**: Added support for GitLab Merge Requests and Issues using the `glab` CLI.
+- **Pull Request Provider Abstraction**: Introduced a new `PullRequestProvider` interface, decoupling PR status logic from GitHub.
+    - Added `GitHubPullRequestProvider` (default) using the `gh` CLI.
+    - Added `ScriptPullRequestProvider` for custom script-based PR status lookups.
+- **Configuration Trust Mechanism**: Introduced a security layer for local repository configurations.
+    - Added `--trust` CLI flag to explicitly trust automatically loaded `.git-graphable.toml` or `pyproject.toml` files.
+    - Users are now warned when executing custom scripts from untrusted configurations.
+- **Dynamic Project Badges**:
+    - Added automated generation of Shields.io-compatible JSON badges for **Git Hygiene** and **Code Coverage**.
+    - Updated `README.md` to display live status from GitHub Pages.
+    - Added `--hygiene-output <path>` to CLI for machine-readable (JSON) hygiene summaries.
+- **Improved Automatic Visualization**:
+    - Restored the behavior of automatically opening a graph if no output path is provided.
+    - Changed default automatic visualization export format from SVG to **PNG** for broader compatibility.
+- **Modular Architecture Refactor**: Substantially reorganized the codebase into specialized sub-packages for better maintainability:
+    - `src/git_graphable/prs/`: Modular PR providers.
+    - `src/git_graphable/issues/`: Modular issue tracker engines.
+    - `src/git_graphable/highlights/`: Specialized highlighting logic (visual, hygiene, external).
+    - `src/git_graphable/styling/`: Specialized styling logic per visualization engine.
+- **Enhanced Issue Scripting**: `ScriptIssueEngine` now supports robust JSON output from scripts (with legacy CSV fallback).
+- **Project Governance**: Added official **MIT License** to the repository.
+- **Reorganized Test Suite**: Refactored tests into a modular structure mirroring the source code, including a global `conftest.py` for shared fixtures.
+
+### Fixed
+- **Comprehensive Security Hardening**: 
+    - Protected against argument injection in `git clone`, `glab`, `gh`, and `git rev-list` commands using the `--` separator.
+    - Resolved potential path traversal and SSRF risks in Jira issue lookups by properly URL-encoding IDs.
+    - Corrected argument passing logic for `git log` limits.
+- **Mermaid Parser Reliability**: Fixed parsing errors in Mermaid graphs by substituting sensitive characters (brackets and parentheses) with visually similar full-width Unicode characters.
+- **CI Stability**: Fixed CI failures in GitHub Pages deployment by preventing automatic visualization triggers during badge generation.
+- **Naming Collisions**: Resolved pytest module collision issues by adding `__init__.py` files to test directories.
+- **Code Maintenance**: Updated `.gitignore` to prevent tracking of build artifacts and coverage data.
+
+
+## [0.5.0] - 2026-03-06
+
+### Added
+- **Interactive Demos**: Implemented `examples/publish_demos.py` to generate and host live HTML demos via GitHub Pages.
+- **Marketplace Preparation**: Moved `action.yml` to the root directory for GitHub Marketplace publishing and updated related documentation and CI workflows.
+
+### Fixed
+- **Squash Merge Detection**: Resolved a `KeyError` and `CycleError` in the logical merge visualization for squashed pull requests when local branch tips were present.
+
+## [0.4.0] - 2026-03-05
+
+### Added
+- **Interactive HTML Viewer**: New `--engine html` output that generates a self-contained interactive graph using Cytoscape.js.
+    - Includes searchable nodes and a details sidebar with live highlight toggling.
+    - Preserves all visual themes and highlighting styles.
+    - Lightweight and portable with zero local dependencies.
+- **Performance Optimizations**:
+    - **Parallel Log Parsing**: Parallelized `GitCommit` instantiation using `ProcessPoolExecutor` for large repositories.
+    - **Parallel Hygiene Scoring**: Concurrent execution of hygiene checks using `ThreadPoolExecutor` for faster report generation.
+- **Modular CLI Architecture**: 
+    - Split into `rich_cli` (Typer/Rich) and `bare_cli` (Argparse) for better environment support.
+    - Intelligent switcher logic in `cli.py` handles optional dependencies and fallbacks.
+- **New `init` Command**: Easily initialize a default `.git-graphable.toml` configuration file.
+- **Reusable GitHub Action**: Added a composite action in `.github/actions/git-graphable/` for automated reporting.
+- **Robust Distance/Divergence Highlights**: Enhanced visualization of branch distance and divergence with clearer legend labels.
+- **Remote URL Support**: Restored and improved ability to pass remote Git URLs (HTTPS/SSH) as the repository path.
+- **Comprehensive UI Testing**: Integrated Playwright for automated browser-based UI testing of the interactive graph.
+
+### Changed
+- **Command Renamed**: Renamed the primary command from `convert` to `analyze` for better semantic alignment.
+- **Decoupled Hygiene Scoring**: Scoring logic is now independent of visual highlighting options, allowing for more granular configuration.
+- **Template System Refactor**: Extracted large HTML/JS blocks into `src/git_graphable/templates.py` for improved maintainability.
+- **Removed PlantUML Support**: Support for PlantUML has been removed in favor of more customizable engines (Mermaid, D2, HTML).
+
+## [0.3.0] - 2026-03-05
+
+### Added
+- **Customizable Visual Styling**: Full override of node and edge styles (colors, widths, dash patterns) via CLI (`--style`) and TOML (`[git-graphable.theme]`).
+- **Configurable Hygiene Scoring**: Customization of hygiene penalties and caps via TOML (`[git-graphable.hygiene_weights]`).
+- **Advanced Issue Tracker Integration**:
+    - **Longevity Mismatch**: Detection of large time gaps between ticket creation and the first commit.
+    - **Collaboration Gaps**: Highlighting when the Git author doesn't match the Issue Tracker assignee.
+    - **Release Validation**: Verification that "Released" tickets are tagged in Git.
+- **New Documentation**: Added `STYLING.md` guide for visual customization.
+- **Engine Consistency**: Unified styling logic across Mermaid, D2, and Graphviz engines.
+
+### Changed
+- **CLI Refactor**: Migrated to a more robust Typer/Rich implementation with enhanced command-line options.
+- **Issue Engine**: Refactored `IssueTracker` to support richer metadata (assignees, timestamps).
+
+### Fixed
+- Fixed inconsistent color application in Mermaid graphs.
+- Improved cleanup of temporary files during image export.
+
+## [0.2.0] - 2026-03-04
+- Initial functional release with basic Git hygiene scoring and GitHub/Jira integration.

git_graphable-0.6.0/LICENSE

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

git_graphable-0.4.0/README.md → git_graphable-0.6.0/PKG-INFO

@@ -1,28 +1,51 @@
+Metadata-Version: 2.4
+Name: git-graphable
+Version: 0.6.0
+Summary: A powerful Git history visualizer and hygiene linter with CI gating.
+Project-URL: Homepage, https://github.com/TheTrueSCU/git-graphable
+Project-URL: Issues, https://github.com/TheTrueSCU/git-graphable/issues
+Project-URL: Repository, https://github.com/TheTrueSCU/git-graphable
+Author-email: Richard West <dopplereffect.us@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: analysis,automation,badges,ci,cytoscape,d2,devops,git,git-flow,github,github-actions,gitlab,graph,html,hygiene,interactive,jira,lint,mermaid,metrics,topology,visualization
+Requires-Python: >=3.13
+Requires-Dist: graphable>=0.6.0
+Provides-Extra: cli
+Requires-Dist: rich>=13.0.0; extra == 'cli'
+Requires-Dist: typer>=0.12.0; extra == 'cli'
+Description-Content-Type: text/markdown
+
 # Git Graphable
 
+[![CI](https://github.com/TheTrueSCU/git-graphable/actions/workflows/ci.yml/badge.svg)](https://github.com/TheTrueSCU/git-graphable/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Coverage](https://img.shields.io/endpoint?url=https://thetruescu.github.io/git-graphable/coverage.json)](https://thetruescu.github.io/git-graphable/)
+[![Hygiene](https://img.shields.io/endpoint?url=https://thetruescu.github.io/git-graphable/hygiene_badge.json)](https://thetruescu.github.io/git-graphable/)
+
+
 A powerful Python tool to convert Git commit history into beautiful, interactive flowcharts using the `graphable` library. Supporting Mermaid, D2, Graphviz, and HTML.
 
 ## Git Plugin Support
 When installed in your PATH, you can use this as a native Git plugin:
 ```bash
-git graphable .
+git graphable analyze .
 ```
 
+## 🚀 Live Interactive Demo
+Check out the tool in action with our **[Live Interactive Demos](https://thetruescu.github.io/git-graphable/)**. Explore different hygiene scenarios and toggle overlays in real-time.
+
+
 ## Features
 
 - **Multi-Engine Support**: Export to Mermaid (.mmd), D2 (.d2), Graphviz (.dot), or HTML (.html).
-- **Automatic Visualization**: Generates and opens an image (SVG/PNG) automatically if no output is specified.
+- **Automatic Visualization**: Generates and opens an image (PNG) automatically if no output is specified.
 - **Advanced Highlighting**: Visualize author patterns, topological distance, and specific merge paths.
-- **GitHub Integration**: Highlight commits based on pull request status (Merged, Open, Closed, Draft) using the `gh` CLI.
+- **VCS Integration**: Highlight commits based on pull request/merge request status using `gh` (GitHub) or `glab` (GitLab) CLIs.
 - **Hygiene Analysis**: Automatically detect WIP commits, direct pushes to protected branches, squashed PRs, back-merges, and contributor silos.
-- **Issue Tracker Integration**: Connect to Jira, GitHub Issues, or custom scripts to highlight status desyncs.
-- **Release & Assignment Validation**: Verify that "Released" tickets are actually tagged in Git and that commit authors match ticket assignees.
-- **Health Scoring**: Get a numeric "Hygiene Score" (0-100%) with a color-coded grade and detailed breakdown of workflow anti-patterns.
-- **Visual Customization**: Fully customize colors, widths, and line styles for nodes and edges. See [STYLING.md](STYLING.md).
-- **Configurable Penalties**: Fully customize the scoring logic by adjusting penalties and caps for each metric.
-- **CI Gating**: Use the `--check` flag to return a non-zero exit code if the hygiene score falls below a threshold (configurable via `--min-score`).
-- **Flexible Input**: Works with local repository paths or remote Git URLs.
-- **Dual CLI**: Modern Rich/Typer interface with a robust argparse fallback for bare environments.
+- **Issue Tracker Integration**: Connect to Jira, GitHub Issues, GitLab Issues, or custom scripts to highlight status desyncs.
+- **Security First**: Configuration trust mechanism ensures custom scripts only run from trusted sources (use `--trust` to authorize local configs).
+- **Dynamic Badges**: Host live Shields.io badges for Git Hygiene and Code Coverage on GitHub Pages.
 
 ## Installation
 
@@ -50,6 +73,7 @@ uv run git-graphable init
 
 # Simplify the graph (only show branches/tags)
 uv run git-graphable analyze . --simplify
+```
 
 ## GitHub Action
 
@@ -65,14 +89,37 @@ jobs:
           fetch-depth: 0 # Required to see full history
 
       - name: Generate Git Graph Reports
-        uses: TheTrueSCU/git-graphable/.github/actions/git-graphable@v0.4.0
+        uses: TheTrueSCU/git-graphable@v0.6.0
         with:
           production_branch: 'main'
           output_dir: 'reports'
 ```
 
+### Inputs
+
+The following inputs are available for the `git-graphable` action:
+
+*   **`path`**
+    *   Description: Path to the git repository
+    *   Required: `false`
+    *   Default: `'.'`
+*   **`production_branch`**
+    *   Description: The main production branch (e.g. main, master)
+    *   Required: `false`
+    *   Default: `'main'`
+*   **`issue_engine`**
+    *   Description: Issue tracker engine (github or jira)
+    *   Required: `false`
+*   **`github_token`**
+    *   Description: GitHub token for issue integration
+    *   Required: `false`
+    *   Default: `${{ github.token }}`
+*   **`output_dir`**
+    *   Description: Directory to save the generated reports
+    *   Required: `false`
+    *   Default: `'git-graph-reports'`
+
 The action generates a **simplified Mermaid summary** (for quick review) and a **full interactive HTML graph** (for deep-dive auditing), uploading them as workflow artifacts.
-```
 
 ## Highlighting Options
 
@@ -81,7 +128,7 @@ Git Graphable provides several ways to highlight commits and relationships. Mult
 | Option | Target | Effect | Conflicts With |
 | :--- | :--- | :--- | :--- |
 | `--highlight-authors` | **Fill** | Unique color per author | PR Status, Distance, Stale |
-| `--highlight-pr-status` | **Fill/Stroke**| Color by PR state (Merged=Purple, Open=Green) | Authors, Distance, Stale |
+| `--highlight-pr-status` | **Fill/Stroke**| Color by PR/MR state (Merged=Purple, Open=Green) | Authors, Distance, Stale |
 | `--highlight-distance-from` | **Fill** | Blue gradient fading by distance | Authors, PR Status, Stale |
 | `--highlight-stale` | **Fill** | Gradient white to red by age | Authors, PR Status, Distance |
 | `--highlight-path` | **Edge** | Thick Orange edge connecting nodes | None |

git_graphable-0.4.0/PKG-INFO → git_graphable-0.6.0/README.md

@@ -1,44 +1,33 @@
-Metadata-Version: 2.4
-Name: git-graphable
-Version: 0.4.0
-Summary: A powerful Git history visualizer and hygiene linter with CI gating.
-Project-URL: Homepage, https://github.com/TheTrueSCU/git-graphable
-Project-URL: Issues, https://github.com/TheTrueSCU/git-graphable/issues
-Project-URL: Repository, https://github.com/TheTrueSCU/git-graphable
-Author-email: Richard West <dopplereffect.us@gmail.com>
-Keywords: analysis,automation,ci,cytoscape,d2,git,git-flow,github,github-actions,graph,html,hygiene,interactive,lint,mermaid,topology,visualization
-Requires-Python: >=3.13
-Requires-Dist: graphable>=0.6.0
-Provides-Extra: cli
-Requires-Dist: rich>=13.0.0; extra == 'cli'
-Requires-Dist: typer>=0.12.0; extra == 'cli'
-Description-Content-Type: text/markdown
-
 # Git Graphable
 
+[![CI](https://github.com/TheTrueSCU/git-graphable/actions/workflows/ci.yml/badge.svg)](https://github.com/TheTrueSCU/git-graphable/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Coverage](https://img.shields.io/endpoint?url=https://thetruescu.github.io/git-graphable/coverage.json)](https://thetruescu.github.io/git-graphable/)
+[![Hygiene](https://img.shields.io/endpoint?url=https://thetruescu.github.io/git-graphable/hygiene_badge.json)](https://thetruescu.github.io/git-graphable/)
+
+
 A powerful Python tool to convert Git commit history into beautiful, interactive flowcharts using the `graphable` library. Supporting Mermaid, D2, Graphviz, and HTML.
 
 ## Git Plugin Support
 When installed in your PATH, you can use this as a native Git plugin:
 ```bash
-git graphable .
+git graphable analyze .
 ```
 
+## 🚀 Live Interactive Demo
+Check out the tool in action with our **[Live Interactive Demos](https://thetruescu.github.io/git-graphable/)**. Explore different hygiene scenarios and toggle overlays in real-time.
+
+
 ## Features
 
 - **Multi-Engine Support**: Export to Mermaid (.mmd), D2 (.d2), Graphviz (.dot), or HTML (.html).
-- **Automatic Visualization**: Generates and opens an image (SVG/PNG) automatically if no output is specified.
+- **Automatic Visualization**: Generates and opens an image (PNG) automatically if no output is specified.
 - **Advanced Highlighting**: Visualize author patterns, topological distance, and specific merge paths.
-- **GitHub Integration**: Highlight commits based on pull request status (Merged, Open, Closed, Draft) using the `gh` CLI.
+- **VCS Integration**: Highlight commits based on pull request/merge request status using `gh` (GitHub) or `glab` (GitLab) CLIs.
 - **Hygiene Analysis**: Automatically detect WIP commits, direct pushes to protected branches, squashed PRs, back-merges, and contributor silos.
-- **Issue Tracker Integration**: Connect to Jira, GitHub Issues, or custom scripts to highlight status desyncs.
-- **Release & Assignment Validation**: Verify that "Released" tickets are actually tagged in Git and that commit authors match ticket assignees.
-- **Health Scoring**: Get a numeric "Hygiene Score" (0-100%) with a color-coded grade and detailed breakdown of workflow anti-patterns.
-- **Visual Customization**: Fully customize colors, widths, and line styles for nodes and edges. See [STYLING.md](STYLING.md).
-- **Configurable Penalties**: Fully customize the scoring logic by adjusting penalties and caps for each metric.
-- **CI Gating**: Use the `--check` flag to return a non-zero exit code if the hygiene score falls below a threshold (configurable via `--min-score`).
-- **Flexible Input**: Works with local repository paths or remote Git URLs.
-- **Dual CLI**: Modern Rich/Typer interface with a robust argparse fallback for bare environments.
+- **Issue Tracker Integration**: Connect to Jira, GitHub Issues, GitLab Issues, or custom scripts to highlight status desyncs.
+- **Security First**: Configuration trust mechanism ensures custom scripts only run from trusted sources (use `--trust` to authorize local configs).
+- **Dynamic Badges**: Host live Shields.io badges for Git Hygiene and Code Coverage on GitHub Pages.
 
 ## Installation
 
@@ -66,6 +55,7 @@ uv run git-graphable init
 
 # Simplify the graph (only show branches/tags)
 uv run git-graphable analyze . --simplify
+```
 
 ## GitHub Action
 
@@ -81,14 +71,37 @@ jobs:
           fetch-depth: 0 # Required to see full history
 
       - name: Generate Git Graph Reports
-        uses: TheTrueSCU/git-graphable/.github/actions/git-graphable@v0.4.0
+        uses: TheTrueSCU/git-graphable@v0.6.0
         with:
           production_branch: 'main'
           output_dir: 'reports'
 ```
 
+### Inputs
+
+The following inputs are available for the `git-graphable` action:
+
+*   **`path`**
+    *   Description: Path to the git repository
+    *   Required: `false`
+    *   Default: `'.'`
+*   **`production_branch`**
+    *   Description: The main production branch (e.g. main, master)
+    *   Required: `false`
+    *   Default: `'main'`
+*   **`issue_engine`**
+    *   Description: Issue tracker engine (github or jira)
+    *   Required: `false`
+*   **`github_token`**
+    *   Description: GitHub token for issue integration
+    *   Required: `false`
+    *   Default: `${{ github.token }}`
+*   **`output_dir`**
+    *   Description: Directory to save the generated reports
+    *   Required: `false`
+    *   Default: `'git-graph-reports'`
+
 The action generates a **simplified Mermaid summary** (for quick review) and a **full interactive HTML graph** (for deep-dive auditing), uploading them as workflow artifacts.
-```
 
 ## Highlighting Options
 
@@ -97,7 +110,7 @@ Git Graphable provides several ways to highlight commits and relationships. Mult
 | Option | Target | Effect | Conflicts With |
 | :--- | :--- | :--- | :--- |
 | `--highlight-authors` | **Fill** | Unique color per author | PR Status, Distance, Stale |
-| `--highlight-pr-status` | **Fill/Stroke**| Color by PR state (Merged=Purple, Open=Green) | Authors, Distance, Stale |
+| `--highlight-pr-status` | **Fill/Stroke**| Color by PR/MR state (Merged=Purple, Open=Green) | Authors, Distance, Stale |
 | `--highlight-distance-from` | **Fill** | Blue gradient fading by distance | Authors, PR Status, Stale |
 | `--highlight-stale` | **Fill** | Gradient white to red by age | Authors, PR Status, Distance |
 | `--highlight-path` | **Edge** | Thick Orange edge connecting nodes | None |

{git_graphable-0.4.0 → git_graphable-0.6.0}/USAGE.md

@@ -50,7 +50,9 @@ Analyze git history and generate a graph. This is the default command; if no com
 * `--highlight-long-running`: Highlight long-running branches
 * `--long-running-days INTEGER`: Threshold in days for long-running branches
 * `--long-running-base TEXT`: Base branch for long-running analysis
-* `--highlight-pr-status`: Highlight commits based on GitHub PR status
+* `--highlight-pr-status`: Highlight commits based on PR status (GitHub or GitLab)
+* `--pr-provider [github|gitlab|script]`: Provider to fetch PR statuses (default: github)
+* `--pr-script TEXT`: Path to a script that returns PR data in JSON format
 * `--highlight-wip`: Highlight WIP/TODO commits
 * `--wip-keyword TEXT`: Additional keyword to trigger WIP highlighting
 * `--highlight-direct-pushes`: Highlight non-merge commits on protected branches
@@ -61,7 +63,7 @@ Analyze git history and generate a graph. This is the default command; if no com
 * `--silo-author-count INTEGER`: Author count threshold for silo detection
 * `--highlight-issue-inconsistencies`: Highlight mismatches between Git and Issue Tracker
 * `--issue-pattern TEXT`: Regex pattern to extract issue IDs
-* `--issue-engine [github|jira|script]`: Engine to fetch issue statuses
+* `--issue-engine [github|gitlab|jira|script]`: Engine to fetch issue statuses
 * `--jira-url TEXT`: Base URL for Jira instance
 * `--issue-script TEXT`: Shell command template for script engine
 * `--highlight-release-inconsistencies`: Highlight issues marked Released but not tagged
@@ -74,6 +76,8 @@ Analyze git history and generate a graph. This is the default command; if no com
 * `--check`: Exit with non-zero if hygiene score is below threshold
 * `--min-score INTEGER`: Minimum hygiene score required for --check
 * `--bare`: Force bare mode (no rich output)
+* `--hygiene-output TEXT`: Path to save hygiene summary as JSON.
+* `--trust`: Trust configuration files (.git-graphable.toml, pyproject.toml) found in the repository. Required to execute custom scripts from these sources.
 * `--help`: Show this message and exit.
 
 ---

{git_graphable-0.4.0/.github/actions/git-graphable → git_graphable-0.6.0}/action.yml

@@ -1,9 +1,9 @@
 name: 'Git Graphable'
-description: 'Generate interactive Git hygiene graphs and reports.'
+description: 'Analyze and visualize Git history hygiene with interactive graphs and reports.'
 author: 'TheTrueSCU'
 branding:
-  icon: 'activity'
-  color: 'blue'
+  icon: 'bar-chart'
+  color: 'green'
 
 inputs:
   path:
@@ -38,7 +38,8 @@ runs:
       shell: bash
       run: |
         # Prefer installing local source if we are in the git-graphable repo
-        ROOT_DIR="${{ github.action_path }}/../../.."
+        # github.action_path points to the root in this case
+        ROOT_DIR="${{ github.action_path }}"
         if [ -f "$ROOT_DIR/pyproject.toml" ] && grep -q "name = \"git-graphable\"" "$ROOT_DIR/pyproject.toml"; then
           echo "Installing git-graphable from local source: $ROOT_DIR"
           uv tool install "$ROOT_DIR"
@@ -51,15 +52,26 @@ runs:
       shell: bash
       run: mkdir -p ${{ inputs.output_dir }}
 
-    - name: Generate Simplified Graph (Mermaid)
+    - name: Generate Simplified Graph (Mermaid) and Hygiene Stats
       shell: bash
       run: |
-        ARGS="--production-branch ${{ inputs.production_branch }} --simplify --engine mermaid -o ${{ inputs.output_dir }}/summary.mmd"
+        ARGS="--production-branch ${{ inputs.production_branch }} --simplify --engine mermaid -o ${{ inputs.output_dir }}/summary.mmd --hygiene-output ${{ inputs.output_dir }}/hygiene.json"
         if [ -n "${{ inputs.issue_engine }}" ]; then ARGS="$ARGS --issue-engine ${{ inputs.issue_engine }}"; fi
         uv tool run git-graphable --bare ${{ inputs.path }} $ARGS
       env:
         GITHUB_TOKEN: ${{ inputs.github_token }}
 
+    - name: Generate Hygiene Badge Data
+      shell: bash
+      run: |
+        if [ -f "${{ inputs.output_dir }}/hygiene.json" ]; then
+          SCORE=$(grep -oP '"score": \d+' ${{ inputs.output_dir }}/hygiene.json | grep -oP '\d+')
+          GRADE=$(grep -oP '"grade": "[^"]+"' ${{ inputs.output_dir }}/hygiene.json | cut -d'"' -f4)
+          COLOR=$(grep -oP '"color": "[^"]+"' ${{ inputs.output_dir }}/hygiene.json | cut -d'"' -f4)
+          # Shields.io JSON endpoint format
+          echo "{\"schemaVersion\": 1, \"label\": \"hygiene\", \"message\": \"$SCORE% ($GRADE)\", \"color\": \"$COLOR\"}" > ${{ inputs.output_dir }}/hygiene_badge.json
+        fi
+
     - name: Generate Full Interactive Graph (HTML)
       shell: bash
       run: |

git_graphable-0.6.0/examples/index_template.html

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Git Graphable Demos</title>
+    <style>
+        body { font-family: sans-serif; line-height: 1.6; max-width: 800px; margin: 40px auto; padding: 0 20px; }
+        h1 { border-bottom: 2px solid #eee; padding-bottom: 10px; }
+        ul { list-style: none; padding: 0; }
+        li { margin-bottom: 10px; background: #f9f9f9; padding: 15px; border-radius: 8px; border: 1px solid #ddd; }
+        a { text-decoration: none; color: #007bff; font-weight: bold; font-size: 1.2em; }
+        a:hover { text-decoration: underline; }
+        .badge { display: inline-block; padding: 2px 8px; background: #eee; border-radius: 4px; font-size: 0.8em; margin-left: 10px; color: #666; }
+    </style>
+</head>
+<body>
+    <h1>Git Graphable Interactive Demos</h1>
+    <p>Select a scenario below to explore the interactive Git hygiene visualization.</p>
+    <ul>
+        $html_links
+    </ul>
+    <hr>
+    <p><a href="https://github.com/TheTrueSCU/git-graphable" style="font-size: 1em;">Back to GitHub Repository</a></p>
+</body>
+</html>