gitgalaxy 2.1.0__tar.gz → 2.2.1__tar.gz

gitgalaxy-2.2.1/.flake8

@@ -0,0 +1,3 @@
+[flake8]
+max-line-length = 120
+extend-ignore = E203, W503, E501, E741, W291, W293, F401, F841

gitgalaxy-2.2.1/CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# 🤝 Contributing to GitGalaxy
+
+First off, thank you for considering contributing to GitGalaxy! The blAST engine is a highly calibrated, deterministic mathematical instrument. Calibrating it across the vast ecosystem of open-source software requires a dedicated community of systems engineers.
+
+Whether you are reporting a taxonomic discrepancy, refining the parsing engine, or expanding the documentation, your input helps map the architectural physics of software more accurately.
+
+---
+
+## ⚙️ The blAST Philosophy (Physics over ASTs)
+
+Before diving in, please remember that GitGalaxy treats code as a physical structure governed by thermodynamic laws. The blAST engine evaluates structural logic, algorithmic complexity, and calculated **risk exposures**—not just rigid syntax. 
+
+Sometimes, what appears to be a traditional parsing error might actually be the blAST engine intentionally flagging a structural anomaly or a dense risk exposure. Please keep this in mind when reporting issues or proposing changes to the extraction heuristics.
+
+---
+
+## 🌐 Expanding the blAST Engine (Adding Languages)
+
+GitGalaxy uses an AST-free, mathematical heuristics engine to build a comparative lexical taxonomical map across all programming languages. We do not write traditional parsers; we map thermodynamic language physics using bounded regular expressions. 
+
+If you want to add native support for a new language (e.g., Lua, Haskell, or a proprietary DSL), do not start writing regex from scratch. We use a strict LLM-driven calibration protocol to guarantee ReDoS immunity. 
+
+**Please read the strict engine calibration guide here:** **[Architecting a New Language (Extending the blAST Engine)](gitgalaxy/standards/how_to_add_a_language.md)**
+
+---
+
+## 🔬 The Differential Scan (Our PR Protocol)
+
+We do not merge structural backend changes based solely on subjective code review. GitGalaxy operates at planetary scale, and every change to the parsing logic has cascading effects.
+
+When you submit a Pull Request that alters the blAST engine, your candidate changes will be subjected to a **Full Differential Scan**. 
+
+* **The Control + Variable Test:** We run your branch against our calibrated baseline of ~80 massive open-source repositories, **plus** the specific repository your PR is designed to address.
+* **Before and After:** We perform a strict mathematical comparison of the engine's output before and after your rule update across this entire dataset. This ensures your addition resolves the target discrepancy without degrading the established baseline or triggering Catastrophic Backtracking (ReDoS).
+* **The Metrics:** The output is assessed strictly on four vectors: **Accuracy, Speed, Utility, and Ethos.**
+* Only changes that are mathematically and practically *measurably better* across the broader ecosystem will be incorporated into the `main` branch.
+
+---
+
+## 🛠️ Submitting Pull Requests
+
+To ensure your contribution integrates smoothly into the Zero-Trust ecosystem:
+
+1. **Fork and Branch:** Create a feature branch from `main` (`git checkout -b feature/your-feature-name`).
+2. **Maintain the Contract:** Ensure that any backend changes to the CLI do not break the universal JSON schema contract expected by the frontend Observatory. 
+3. **Test Visually:** Run your newly generated `_galaxy.json` through either **[GitGalaxy.io](https://gitgalaxy.io)** or your local **Airgap Observatory** to verify that 3D WebGPU rendering and visual physics constraints remain intact. 
+4. **Document:** If you are adding new language phenotypes or altering the parsing logic, please update the [Language Lens](docs/wiki/02-05-language-lens.md) documentation in the wiki.
+5. **Submit:** Open a PR with a clear title. Explain the *why* behind your structural changes, not just the *what*. Be sure to include the link to the target repository so we can include it in the Differential Scan.
+
+---
+
+## 🐛 Reporting Discrepancies
+
+If the GalaxyScope CLI misidentifies a repository's structure or fails to parse a specific file phenotype, please use our **[Parsing Discrepancy Form](https://github.com/squid-protocol/gitgalaxy/issues/new/choose)**. 
+
+To help us reproduce the issue with quantitative precision, you will be asked to provide:
+* A direct link to the public repository being scanned.
+* The Observatory viewer you were using ([GitGalaxy.io](https://gitgalaxy.io) or Airgap Observatory).
+* A clear description of the expected vs. actual output.
+* The contents of your custom `gitgalaxy_config.py` file (if applicable).
+* Contact information for follow-up questions.
+
+---
+
+## 🛡️ Security Vulnerabilities
+
+If you discover a vulnerability within GitGalaxy itself (e.g., a way to bypass the local sandbox, a ReDoS vector, or an issue in the Airgap Observatory), **do not open a public issue.** Please reach out directly via the contact portal at [GitGalaxy.io](https://gitgalaxy.io) so the vulnerability can be patched securely before public disclosure.
+
+---
+
+## 📜 Licensing Reminder
+
+GitGalaxy is released under the **PolyForm Noncommercial License 1.0.0**. By contributing to this repository, you agree that your contributions will be licensed under these same terms. 
+
+*Note: This tool is free for research, education, testing, and hobby projects. Any commercial use or integration into commercial SaaS products or corporate CI/CD pipelines requires a separate commercial license.*

{gitgalaxy-2.1.0 → gitgalaxy-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitgalaxy
-Version: 2.1.0
+Version: 2.2.1
 Summary: An AST-free, LLM-free zero-trust static analysis engine for mapping architectural risk, securing CI/CD pipelines, and modernizing legacy monoliths.
 Author: Joe Esquibel
 Project-URL: Homepage, https://gitgalaxy.io
@@ -37,6 +37,8 @@ Dynamic: license-file
 
 [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-brightgreen.svg)](https://pypi.org/project/gitgalaxy/)
 [![Airgap Ready](https://img.shields.io/badge/Security-Airgap_Ready-teal.svg)](#)
+[![Downloads](https://static.pepy.tech/badge/gitgalaxy)](https://pepy.tech/project/gitgalaxy)
+[![GitHub stars](https://img.shields.io/github/stars/squid-protocol/gitgalaxy?style=social)](https://github.com/squid-protocol/gitgalaxy/stargazers)
 
 ### **AST-Free Static Analysis & Knowledge Graph Engine**
 
@@ -55,13 +57,15 @@ Every assumption our system makes has been abstracted into over 300 tunable vari
 **Core Codebase Mapping Technology**
 * Bypasses LLMs and rigid ASTs.
 * Doesn't require code to compile (AST-free).
-* Produces full function-to-function call chains.
+* Produces full network mapping via imports with generlized function calls per file.
 * Deterministically maps code by 60+ keyword regex profiles (Structural markers, I/O intents, state mutations).
 * Regex keyword profiles allow us to classify functions, files, classes, folders and repos.
 * Eliminates LLM architectural hallucinations and context window limits.
 * Scans 50+ languages, 250+ extensions, fully folder-aware. **([How to add a language in 1 minute and 1 prompt](gitgalaxy/standards/HOW_TO_ADD_LANGUAGE.md))**
 
 **Enterprise Scale & Performance Metrics**
+* **Active Pipeline Integration:** Over 11,000 PyPI downloads, driven heavily by automated CI/CD security sweeps and zero-trust DevSecOps workflows.
+* **Production Tested:** Backed by an active early-adopter community on GitHub driving real-world issue resolution, architectural forks, and continuous engine hardening.
 * 100,000 LOC/sec code analysis.
 * 0.07 GB/sec raw log ingestion.
 * Full-system scans in minutes without data sampling.
@@ -196,10 +200,22 @@ Your code never leaves your machine. GitGalaxy performs 100% of its scanning and
 * **Ephemeral Memory Processing:** Repositories are unpacked into a volatile memory buffer (RAM) and are automatically purged when the browser tab is closed.
 * **Privacy-by-Design:** Even when using the web-based viewer, the data remains behind the user's firewall at all times.
 
-## License & Copyright
+## ⚖️ Licensing & Usage
 
 Copyright (c) 2026 Joe Esquibel
 
-GitGalaxy is released under the PolyForm Noncommercial License 1.0.0. It is completely free for personal use, research, experiment, testing, and hobby projects. Use by educational or charitable organizations is also permitted.
+GitGalaxy is distributed under the **PolyForm Noncommercial License 1.0.0**. 
 
-Any commercial use or integration into commercial SaaS products or corporate CI/CD pipelines requires a separate commercial license. Please reach out via gitgalaxy.io to discuss commercial integration.
+### 🎓 Community Free Tier (Academic, Research, & Hobbyist)
+We are deeply committed to the open-source and academic communities. If you are using GitGalaxy for personal projects, academic research, or non-commercial development, the engine is 100% free to use.
+
+To suppress the commercial licensing delays in your terminal or personal CI/CD pipelines, simply set the following environment variable:
+
+```bash
+export GITGALAXY_LICENSE_KEY="COMMUNITY_FREE_TIER"
+```
+
+### 🏢 Commercial & Enterprise Use
+Running GitGalaxy in corporate environments, proprietary codebases, or commercial CI/CD pipelines requires an enterprise license. Unlicensed corporate pipelines will experience intentional execution friction, and attempting to use the Community Free Tier key in a corporate environment will trigger explicit non-compliance warnings in your audit logs.
+
+To acquire a zero-trust commercial key for your organization and ensure clean compliance logs, please contact: **joe@gitgalaxy.io**

{gitgalaxy-2.1.0 → gitgalaxy-2.2.1}/README.md

@@ -14,6 +14,8 @@
 
 [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-brightgreen.svg)](https://pypi.org/project/gitgalaxy/)
 [![Airgap Ready](https://img.shields.io/badge/Security-Airgap_Ready-teal.svg)](#)
+[![Downloads](https://static.pepy.tech/badge/gitgalaxy)](https://pepy.tech/project/gitgalaxy)
+[![GitHub stars](https://img.shields.io/github/stars/squid-protocol/gitgalaxy?style=social)](https://github.com/squid-protocol/gitgalaxy/stargazers)
 
 ### **AST-Free Static Analysis & Knowledge Graph Engine**
 
@@ -32,13 +34,15 @@ Every assumption our system makes has been abstracted into over 300 tunable vari
 **Core Codebase Mapping Technology**
 * Bypasses LLMs and rigid ASTs.
 * Doesn't require code to compile (AST-free).
-* Produces full function-to-function call chains.
+* Produces full network mapping via imports with generlized function calls per file.
 * Deterministically maps code by 60+ keyword regex profiles (Structural markers, I/O intents, state mutations).
 * Regex keyword profiles allow us to classify functions, files, classes, folders and repos.
 * Eliminates LLM architectural hallucinations and context window limits.
 * Scans 50+ languages, 250+ extensions, fully folder-aware. **([How to add a language in 1 minute and 1 prompt](gitgalaxy/standards/HOW_TO_ADD_LANGUAGE.md))**
 
 **Enterprise Scale & Performance Metrics**
+* **Active Pipeline Integration:** Over 11,000 PyPI downloads, driven heavily by automated CI/CD security sweeps and zero-trust DevSecOps workflows.
+* **Production Tested:** Backed by an active early-adopter community on GitHub driving real-world issue resolution, architectural forks, and continuous engine hardening.
 * 100,000 LOC/sec code analysis.
 * 0.07 GB/sec raw log ingestion.
 * Full-system scans in minutes without data sampling.
@@ -173,10 +177,22 @@ Your code never leaves your machine. GitGalaxy performs 100% of its scanning and
 * **Ephemeral Memory Processing:** Repositories are unpacked into a volatile memory buffer (RAM) and are automatically purged when the browser tab is closed.
 * **Privacy-by-Design:** Even when using the web-based viewer, the data remains behind the user's firewall at all times.
 
-## License & Copyright
+## ⚖️ Licensing & Usage
 
 Copyright (c) 2026 Joe Esquibel
 
-GitGalaxy is released under the PolyForm Noncommercial License 1.0.0. It is completely free for personal use, research, experiment, testing, and hobby projects. Use by educational or charitable organizations is also permitted.
+GitGalaxy is distributed under the **PolyForm Noncommercial License 1.0.0**. 
 
-Any commercial use or integration into commercial SaaS products or corporate CI/CD pipelines requires a separate commercial license. Please reach out via gitgalaxy.io to discuss commercial integration.
+### 🎓 Community Free Tier (Academic, Research, & Hobbyist)
+We are deeply committed to the open-source and academic communities. If you are using GitGalaxy for personal projects, academic research, or non-commercial development, the engine is 100% free to use.
+
+To suppress the commercial licensing delays in your terminal or personal CI/CD pipelines, simply set the following environment variable:
+
+```bash
+export GITGALAXY_LICENSE_KEY="COMMUNITY_FREE_TIER"
+```
+
+### 🏢 Commercial & Enterprise Use
+Running GitGalaxy in corporate environments, proprietary codebases, or commercial CI/CD pipelines requires an enterprise license. Unlicensed corporate pipelines will experience intentional execution friction, and attempting to use the Community Free Tier key in a corporate environment will trigger explicit non-compliance warnings in your audit logs.
+
+To acquire a zero-trust commercial key for your organization and ensure clean compliance logs, please contact: **joe@gitgalaxy.io**

gitgalaxy-2.2.1/cure_dead_ends.py

@@ -0,0 +1,51 @@
+import os
+from pathlib import Path
+
+
+def cure_dead_ends(wiki_dir="docs/wiki"):
+    """
+    Sweeps the wiki directory and appends a 'Back to Master Index' footer
+    to every markdown file, calculating the correct relative path.
+    """
+    wiki_root = Path(wiki_dir).resolve()
+
+    if not wiki_root.exists():
+        print(f"❌ Error: Could not find directory {wiki_dir}")
+        return
+
+    md_files = list(wiki_root.rglob("*.md"))
+    cured_count = 0
+
+    print(f"🩺 Scanning {len(md_files)} wiki files for Dead Ends...")
+
+    for file_path in md_files:
+        # We don't want the index linking to itself
+        if file_path.name.lower() == "index.md":
+            continue
+
+        # Calculate how many directories up we need to go to hit the root index.md
+        rel_to_root = os.path.relpath(wiki_root, file_path.parent)
+        index_path = Path(rel_to_root) / "index.md"
+
+        # Format the relative path safely for web/markdown
+        clean_index_path = index_path.as_posix()
+
+        footer = f"\n\n---\n\n**[⬅️ Back to Master Index]({clean_index_path})**\n"
+
+        try:
+            content = file_path.read_text(encoding="utf-8")
+
+            # Prevent double-injection if you run the script twice
+            if "[⬅️ Back to Master Index]" not in content:
+                with open(file_path, "a", encoding="utf-8") as f:
+                    f.write(footer)
+                cured_count += 1
+
+        except Exception as e:
+            print(f"⚠️ Failed to patch {file_path.name}: {e}")
+
+    print(f"✅ Success! Cured {cured_count} dead ends.")
+
+
+if __name__ == "__main__":
+    cure_dead_ends()

{gitgalaxy-2.1.0 → gitgalaxy-2.2.1}/gitgalaxy/README.md

@@ -52,7 +52,12 @@ From the **root directory** of the repository, run:
 pip install -e .
 ```
 
-Once installed, you can trigger the main orchestrator globally from your terminal. This command runs the full [Data Pipeline](https://squid-protocol.github.io/gitgalaxy/02-01-pipeline-overview/) and outputs the final artifact.
+**Important:** GitGalaxy contains an embedded commercial licensing guardrail. To prevent a 5-second execution delay while testing your code locally, you must export the Community Free Tier key into your development environment before running the orchestrator:
+```bash
+export GITGALAXY_LICENSE_KEY="COMMUNITY_FREE_TIER"
+```
+
+Once installed and the key is set, you can trigger the main orchestrator globally from your terminal. This command runs the full [Data Pipeline](https://squid-protocol.github.io/gitgalaxy/02-01-pipeline-overview/) and outputs the final artifact.
 ```bash
 galaxyscope /path/to/test/repo --debug
 ```