gitgalaxy 2.0.3__tar.gz → 2.0.5__tar.gz

{gitgalaxy-2.0.3/gitgalaxy.egg-info → gitgalaxy-2.0.5}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gitgalaxy
-Version: 2.0.3
+Version: 2.0.5
 Summary: An AST-free, zero-trust static analysis engine for mapping architectural risk, securing CI/CD pipelines, and modernizing legacy monoliths.
-Author: Joseph Michael Esquibel
+Author: Joe Esquibel
 Project-URL: Homepage, https://gitgalaxy.io
 Project-URL: Documentation, https://squid-protocol.github.io/gitgalaxy/
 Project-URL: Source, https://github.com/squid-protocol/gitgalaxy
@@ -16,7 +16,7 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
@@ -38,32 +38,36 @@ 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)](#)
 
-### **The blAST Engine: A custom heuristics-based AST-free Knowledge Graph Generator**
+### **AST-Free Static Analysis & Knowledge Graph Engine**
 
-The blAST (Bypassing LLMs and ASTs) engine is a custom-made knowledge graph engine that resolves repositories at the function level. It scores each function based on 50 unique metrics, rolls that data up to score the file, and finally summarizes the entire repository. 
+The blAST (Bypassing LLMs and ASTs) engine is a custom-made knowledge graph engine that resolves repositories at the function level. It scores each function based on 50 unique metrics, rolls that data up to score the file, and finally summarizes the entire repository.
 
-By utilizing a custom engine, we retain full control over the search space. We built it to be exceptionally fast, capable of assessing your entire repository without requiring compilable code—a fundamental limitation of standard Abstract Syntax Trees (ASTs). ASTs are great for finding missing commas and memory overflows, but they miss the forest for the trees when generating knowledge graphs. LLMs, on the other hand, suffer from hallucination during large context windows and yield probabilistic, fluctuating answers. 
+### Scanning Apollo-11 with the blAST Engine
 
-The blAST engine solves this. Because all programming languages utilize keywords and functions, our engine treats code files as text, scanning for these structural anchors to build a deterministic 3D knowledge graph. It seamlessly handles mid-file language switching, assesses the architectural ratio of test files to logic, and extracts invaluable project structure data that ASTs ignore. 
+![GitGalaxy CLI Scan](./docs/wiki/assets/apollo11_scan.gif)
+
+By utilizing a custom engine, we retain full control over the search space. We built it to be exceptionally fast, capable of assessing your entire repository without requiring compilable code—a fundamental limitation of standard Abstract Syntax Trees (ASTs). ASTs are great for finding missing commas and memory overflows, but they miss the forest for the trees when generating knowledge graphs. LLMs, on the other hand, suffer from hallucination during large context windows and yield probabilistic, fluctuating answers.
+
+The blAST engine solves this. Because all programming languages utilize keywords and functions, our engine treats code files as text, scanning for these structural anchors to build a deterministic 3D knowledge graph. It seamlessly handles mid-file language switching, assesses the architectural ratio of test files to logic, and extracts invaluable project structure data that ASTs ignore.
 
 Every assumption our system makes has been abstracted into over 300 tunable variables. Think of GitGalaxy as a highly calibrated telescope. You can query the number of active API network nodes, isolate unique external imports, or highlight functions exhibiting extreme cognitive load—all adjusted via custom whitelists and blacklists to eliminate false-positive fatigue. Field-tested on over 1,000 repositories spanning 50+ languages and 250+ extensions, the engine comes equipped with smart defaults ready for immediate deployment.
 
-**Core Technology**
+**Core Codebase Mapping Technology**
 * Bypasses LLMs and rigid ASTs.
 * Doesn't require code to compile (AST-free).
 * Produces full function-to-function call chains.
 * 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. 
+* 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))**
 
-**Extreme Velocity & Scale**
+**Enterprise Scale & Performance Metrics**
 * 100,000 LOC/sec code analysis.
 * 0.07 GB/sec raw log ingestion.
 * Full-system scans in minutes without data sampling.
 * 100% daily system coverage.
 
-**Scientific Claims & Validation**
+**Methodology & Comparative Benchmarks**
 GitGalaxy is backed by an academic-grade thesis detailing the equations powering the blAST engine.
 
 * **[Optimum Search Strategies Evolve](https://squid-protocol.github.io/gitgalaxy/03-01-claim-1-search-strategies/):** AST-free mapping. Outperforms rigid parsers and LLM context windows.
@@ -71,15 +75,14 @@ GitGalaxy is backed by an academic-grade thesis detailing the equations powering
 * **[All languages have keywords that roughly do the same thing, these can be grouped to make cross-language keyword maps](https://squid-protocol.github.io/gitgalaxy/03-03-claim-3-taxonomy-map/):** Standardizes 50+ languages into a single universal physical framework.
 * **[Cross-Language Comparisons of over 1000 repos](https://squid-protocol.github.io/gitgalaxy/03-04-claim-4-comparing-languages/):** Deterministic 1:1 benchmarking of distinct syntax architectures.
 * **[Universal File Archetypes by k-means clustering](https://squid-protocol.github.io/gitgalaxy/03-05-claim-5-file-archetypes/):** ML isolation of files into K-means clusters (e.g., "The God Nodes," "Declarative Glue").
-* **[Assessing the blAST engines cross-language capbility over 10 different DOOM ports](https://squid-protocol.github.io/gitgalaxy/03-07-claim-7-doom-comparisons/):** Comparative function analysis across 10 distinct DOOM source ports.
-* **Mainframe Proven:** Successful from-scratch translation of legacy COBOL monoliths to compiling Spring Boot architectures.
+* **[Mainframe Proven: 100% CI/CD Translation Success Rate](https://github.com/squid-protocol/gitgalaxy/tree/main/examples/ibm_cics_translation):** Flawless architectural translation of 27 distinct legacy COBOL repositories (including IBM CICS benchmark apps) into compiling Java Spring Boot environments.
 
-**Security & Deployment**
+**Data Privacy & On-Premise Deployment**
 * 100% air-gapped execution.
 * On-premise deployment with zero IP exfiltration risk.
 * Zero-trust processing model.
 
-**How to use**
+**Installation & Usage**
 * Python-based: `pip install gitgalaxy`
 * CLI execution
 * Outputs forensic JSONs (optimized for AI-agent summary reports) and a native SQLite3 database for robust querying and storage.
@@ -88,7 +91,7 @@ GitGalaxy is backed by an academic-grade thesis detailing the equations powering
 
 ---
 
-## Quickstart
+## Quickstart Guide
 
 ### 1. Install
 
@@ -107,39 +110,45 @@ galaxyscope /path/to/your/local/repo
 
 ---
 
-### [Project Overview](docs/wiki/01-project-overview.md)
+### [GitGalaxy Core Analysis Engine](docs/wiki/01-project-overview.md)
 The central blAST engine. It bypasses rigid ASTs using mathematical heuristics to map O(N) multi-dimensional relationships across 50+ languages, managing signal processing, spatial layout, and high-speed SQLite telemetry recording.
 
 
 
-## The GitGalaxy Ecosystem
+## Enterprise Codebase Tools & Use Cases
 
-GitGalaxy operates on a modular Hub-and-Spoke architecture. While the core engine provides the overarching physics and cartography, our specialized toolsets leverage that deterministic graph to execute enterprise-grade operations. The following toolsets provide novel heuristic solutions to several open problems in computing. 
+GitGalaxy operates on a modular Hub-and-Spoke architecture. While the core engine provides the overarching physics and cartography, our specialized toolsets leverage that deterministic graph to execute enterprise-grade operations. 
 
-### [Legacy Modernization: Converting Raw Cobol Repos to Java Spring Boots](gitgalaxy/tools/cobol_to_java/)
+### [Automated Legacy Migration: COBOL to Java Spring Boot](gitgalaxy/tools/cobol_to_java/)
 A deterministic, high-fidelity translation pipeline. It converts legacy COBOL into fully compiling, modern Spring Boot architectures, mapping memory exactly and scaffolding JPA entities, REST controllers, and Maven builds before utilizing AI to translate isolated business logic.
+* **Proven Metric:** Achieved a perfect 27/27 Maven compile success rate across a batch test of distinct legacy repos.
+* **Verify for Yourself:** [Inspect the raw outputs of the IBM CICS Application Translation here.](examples/ibm_cics_translation/)
 
-### [Legacy Modernization: Converting Raw Cobol Repos to cleaner Cobol Repos](gitgalaxy/tools/cobol_to_cobol/)
+![Java Forge & Batch Test](./docs/wiki/assets/java_forge_and_batch_test.gif)
+
+### [Mainframe Refactoring: COBOL & JCL Optimization](gitgalaxy/tools/cobol_to_cobol/)
 A mathematical x-ray suite for sanitizing mainframe monoliths. It safely neutralizes legacy lexical traps, extracts dead "Graveyard" memory, maps topological DAG execution orders, and generates Zero-Trust JCL configurations for modern cloud deployments.
+* **Proven Metric:** The Graveyard Reaper engine extracted over 6,700 lines of dead execution blocks and orphaned variables from the standard IBM CICS benchmark app in seconds.
 
-### [Supply Chain Security](gitgalaxy/tools/supply_chain_security/)
+### [Software Supply Chain Security & Pre-Commit Firewalls](gitgalaxy/tools/supply_chain_security/)
 Extreme-velocity pre-commit firewalls. Instead of trusting manifest files, it scans physical internals to block steganography, sub-atomic XOR decryption loops, homoglyph typosquatting, and exposed cryptographic vaults before they ever enter your CI/CD pipeline.
 
-### [Network Auditing](gitgalaxy/tools/network_auditing/)
+### [Zero-Trust SBOM Generation & Dependency Auditing](gitgalaxy/tools/compliance/)
+A Zero-Trust Software Bill of Materials (SBOM) generator. It refuses to blindly trust `package.json` or `requirements.txt` files, instead locating the physical dependencies on disk, mathematically verifying their entropy and linguistic identity, and generating strict CycloneDX 1.4 JSON reports.
+* **Proven Metric:** Successfully mapped and mathematically verified the physical internals of 170 unique Go modules inside the local Kubernetes repository.
+
+### [API Security & Shadow API Detection](gitgalaxy/tools/network_auditing/)
 A deterministic mapping tool that hunts undocumented vulnerabilities. It uses structural regex to find active physical routing logic (Express, Spring Boot, FastAPI) and applies set theory against official OpenAPI/Swagger documentation to isolate critical Shadow APIs and outdated Ghost APIs.
 
-### [Terabyte Log Scanning](gitgalaxy/tools/terabyte_log_scanning/)
+### [High-Speed PII Detection & Log Analysis](gitgalaxy/tools/terabyte_log_scanning/)
 Unindexed, tactical log analysis operating at 0.07 GB/sec. It streams massive database dumps to deterministically hunt and mask PII (Credit Cards, SSNs, AWS Keys) and uses static architecture maps to prove exact runtime execution frequencies with ASCII time-series histograms.
 
-### [Compliance Operations - SBOM Generators](gitgalaxy/tools/compliance/)
-A Zero-Trust Software Bill of Materials (SBOM) generator. It refuses to blindly trust `package.json` or `requirements.txt` files, instead locating the physical dependencies on disk, mathematically verifying their entropy and linguistic identity, and generating strict CycloneDX 1.4 JSON reports.
-
-### [AI Guardrails](gitgalaxy/tools/ai_guardrails/)
+### [AI Agent Guardrails & Codebase Protection](gitgalaxy/tools/ai_guardrails/)
 Specialized keyword sensors protecting both your application and your codebase. The AppSec Sensor detects weaponized LLM features (RCE funnels, exfiltration risks), while the Dev Agent Firewall evaluates token mass and blast radius to restrict autonomous coding agents from modifying dangerous over context token-draining files. Helps identify which files need to be chunked to reduce context overload.
 
-  ## The Web Viewer (Frictionless Dashboards)
+  ## Local Browser-Based 3D Codebase Visualization
 
-If you prefer visual analytics, we've built a non-numerical dashboard where each file represents a star, sized and colored according to specific risk metrics. 
+If you prefer visual analytics, we've built a non-numerical dashboard where each file represents a star, sized and colored according to specific risk metrics.
 
 Simply drag and drop your generated `your_repo_GPU_galaxy.json` file (or a `.zip` of your raw repository) directly into [GitGalaxy.io](https://gitgalaxy.io/). All rendering and scanning happens entirely in your browser's local memory.
 
@@ -147,7 +156,7 @@ Simply drag and drop your generated `your_repo_GPU_galaxy.json` file (or a `.zip
 
 ![GitGalaxy native SQLite3 database schema for AST-free enterprise codebase mapping and cybersecurity auditing](https://raw.githubusercontent.com/squid-protocol/gitgalaxy/main/docs/wiki/assets/sqlite_overview.png)
 
-## Zero-Trust Architecture
+## Zero-Trust Data Security
 
 Your code never leaves your machine. GitGalaxy performs 100% of its scanning and vectorization locally.
 

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/README.md

@@ -15,32 +15,36 @@
 [![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)](#)
 
-### **The blAST Engine: A custom heuristics-based AST-free Knowledge Graph Generator**
+### **AST-Free Static Analysis & Knowledge Graph Engine**
 
-The blAST (Bypassing LLMs and ASTs) engine is a custom-made knowledge graph engine that resolves repositories at the function level. It scores each function based on 50 unique metrics, rolls that data up to score the file, and finally summarizes the entire repository. 
+The blAST (Bypassing LLMs and ASTs) engine is a custom-made knowledge graph engine that resolves repositories at the function level. It scores each function based on 50 unique metrics, rolls that data up to score the file, and finally summarizes the entire repository.
 
-By utilizing a custom engine, we retain full control over the search space. We built it to be exceptionally fast, capable of assessing your entire repository without requiring compilable code—a fundamental limitation of standard Abstract Syntax Trees (ASTs). ASTs are great for finding missing commas and memory overflows, but they miss the forest for the trees when generating knowledge graphs. LLMs, on the other hand, suffer from hallucination during large context windows and yield probabilistic, fluctuating answers. 
+### Scanning Apollo-11 with the blAST Engine
 
-The blAST engine solves this. Because all programming languages utilize keywords and functions, our engine treats code files as text, scanning for these structural anchors to build a deterministic 3D knowledge graph. It seamlessly handles mid-file language switching, assesses the architectural ratio of test files to logic, and extracts invaluable project structure data that ASTs ignore. 
+![GitGalaxy CLI Scan](./docs/wiki/assets/apollo11_scan.gif)
+
+By utilizing a custom engine, we retain full control over the search space. We built it to be exceptionally fast, capable of assessing your entire repository without requiring compilable code—a fundamental limitation of standard Abstract Syntax Trees (ASTs). ASTs are great for finding missing commas and memory overflows, but they miss the forest for the trees when generating knowledge graphs. LLMs, on the other hand, suffer from hallucination during large context windows and yield probabilistic, fluctuating answers.
+
+The blAST engine solves this. Because all programming languages utilize keywords and functions, our engine treats code files as text, scanning for these structural anchors to build a deterministic 3D knowledge graph. It seamlessly handles mid-file language switching, assesses the architectural ratio of test files to logic, and extracts invaluable project structure data that ASTs ignore.
 
 Every assumption our system makes has been abstracted into over 300 tunable variables. Think of GitGalaxy as a highly calibrated telescope. You can query the number of active API network nodes, isolate unique external imports, or highlight functions exhibiting extreme cognitive load—all adjusted via custom whitelists and blacklists to eliminate false-positive fatigue. Field-tested on over 1,000 repositories spanning 50+ languages and 250+ extensions, the engine comes equipped with smart defaults ready for immediate deployment.
 
-**Core Technology**
+**Core Codebase Mapping Technology**
 * Bypasses LLMs and rigid ASTs.
 * Doesn't require code to compile (AST-free).
 * Produces full function-to-function call chains.
 * 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. 
+* 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))**
 
-**Extreme Velocity & Scale**
+**Enterprise Scale & Performance Metrics**
 * 100,000 LOC/sec code analysis.
 * 0.07 GB/sec raw log ingestion.
 * Full-system scans in minutes without data sampling.
 * 100% daily system coverage.
 
-**Scientific Claims & Validation**
+**Methodology & Comparative Benchmarks**
 GitGalaxy is backed by an academic-grade thesis detailing the equations powering the blAST engine.
 
 * **[Optimum Search Strategies Evolve](https://squid-protocol.github.io/gitgalaxy/03-01-claim-1-search-strategies/):** AST-free mapping. Outperforms rigid parsers and LLM context windows.
@@ -48,15 +52,14 @@ GitGalaxy is backed by an academic-grade thesis detailing the equations powering
 * **[All languages have keywords that roughly do the same thing, these can be grouped to make cross-language keyword maps](https://squid-protocol.github.io/gitgalaxy/03-03-claim-3-taxonomy-map/):** Standardizes 50+ languages into a single universal physical framework.
 * **[Cross-Language Comparisons of over 1000 repos](https://squid-protocol.github.io/gitgalaxy/03-04-claim-4-comparing-languages/):** Deterministic 1:1 benchmarking of distinct syntax architectures.
 * **[Universal File Archetypes by k-means clustering](https://squid-protocol.github.io/gitgalaxy/03-05-claim-5-file-archetypes/):** ML isolation of files into K-means clusters (e.g., "The God Nodes," "Declarative Glue").
-* **[Assessing the blAST engines cross-language capbility over 10 different DOOM ports](https://squid-protocol.github.io/gitgalaxy/03-07-claim-7-doom-comparisons/):** Comparative function analysis across 10 distinct DOOM source ports.
-* **Mainframe Proven:** Successful from-scratch translation of legacy COBOL monoliths to compiling Spring Boot architectures.
+* **[Mainframe Proven: 100% CI/CD Translation Success Rate](https://github.com/squid-protocol/gitgalaxy/tree/main/examples/ibm_cics_translation):** Flawless architectural translation of 27 distinct legacy COBOL repositories (including IBM CICS benchmark apps) into compiling Java Spring Boot environments.
 
-**Security & Deployment**
+**Data Privacy & On-Premise Deployment**
 * 100% air-gapped execution.
 * On-premise deployment with zero IP exfiltration risk.
 * Zero-trust processing model.
 
-**How to use**
+**Installation & Usage**
 * Python-based: `pip install gitgalaxy`
 * CLI execution
 * Outputs forensic JSONs (optimized for AI-agent summary reports) and a native SQLite3 database for robust querying and storage.
@@ -65,7 +68,7 @@ GitGalaxy is backed by an academic-grade thesis detailing the equations powering
 
 ---
 
-## Quickstart
+## Quickstart Guide
 
 ### 1. Install
 
@@ -84,39 +87,45 @@ galaxyscope /path/to/your/local/repo
 
 ---
 
-### [Project Overview](docs/wiki/01-project-overview.md)
+### [GitGalaxy Core Analysis Engine](docs/wiki/01-project-overview.md)
 The central blAST engine. It bypasses rigid ASTs using mathematical heuristics to map O(N) multi-dimensional relationships across 50+ languages, managing signal processing, spatial layout, and high-speed SQLite telemetry recording.
 
 
 
-## The GitGalaxy Ecosystem
+## Enterprise Codebase Tools & Use Cases
 
-GitGalaxy operates on a modular Hub-and-Spoke architecture. While the core engine provides the overarching physics and cartography, our specialized toolsets leverage that deterministic graph to execute enterprise-grade operations. The following toolsets provide novel heuristic solutions to several open problems in computing. 
+GitGalaxy operates on a modular Hub-and-Spoke architecture. While the core engine provides the overarching physics and cartography, our specialized toolsets leverage that deterministic graph to execute enterprise-grade operations. 
 
-### [Legacy Modernization: Converting Raw Cobol Repos to Java Spring Boots](gitgalaxy/tools/cobol_to_java/)
+### [Automated Legacy Migration: COBOL to Java Spring Boot](gitgalaxy/tools/cobol_to_java/)
 A deterministic, high-fidelity translation pipeline. It converts legacy COBOL into fully compiling, modern Spring Boot architectures, mapping memory exactly and scaffolding JPA entities, REST controllers, and Maven builds before utilizing AI to translate isolated business logic.
+* **Proven Metric:** Achieved a perfect 27/27 Maven compile success rate across a batch test of distinct legacy repos.
+* **Verify for Yourself:** [Inspect the raw outputs of the IBM CICS Application Translation here.](examples/ibm_cics_translation/)
 
-### [Legacy Modernization: Converting Raw Cobol Repos to cleaner Cobol Repos](gitgalaxy/tools/cobol_to_cobol/)
+![Java Forge & Batch Test](./docs/wiki/assets/java_forge_and_batch_test.gif)
+
+### [Mainframe Refactoring: COBOL & JCL Optimization](gitgalaxy/tools/cobol_to_cobol/)
 A mathematical x-ray suite for sanitizing mainframe monoliths. It safely neutralizes legacy lexical traps, extracts dead "Graveyard" memory, maps topological DAG execution orders, and generates Zero-Trust JCL configurations for modern cloud deployments.
+* **Proven Metric:** The Graveyard Reaper engine extracted over 6,700 lines of dead execution blocks and orphaned variables from the standard IBM CICS benchmark app in seconds.
 
-### [Supply Chain Security](gitgalaxy/tools/supply_chain_security/)
+### [Software Supply Chain Security & Pre-Commit Firewalls](gitgalaxy/tools/supply_chain_security/)
 Extreme-velocity pre-commit firewalls. Instead of trusting manifest files, it scans physical internals to block steganography, sub-atomic XOR decryption loops, homoglyph typosquatting, and exposed cryptographic vaults before they ever enter your CI/CD pipeline.
 
-### [Network Auditing](gitgalaxy/tools/network_auditing/)
+### [Zero-Trust SBOM Generation & Dependency Auditing](gitgalaxy/tools/compliance/)
+A Zero-Trust Software Bill of Materials (SBOM) generator. It refuses to blindly trust `package.json` or `requirements.txt` files, instead locating the physical dependencies on disk, mathematically verifying their entropy and linguistic identity, and generating strict CycloneDX 1.4 JSON reports.
+* **Proven Metric:** Successfully mapped and mathematically verified the physical internals of 170 unique Go modules inside the local Kubernetes repository.
+
+### [API Security & Shadow API Detection](gitgalaxy/tools/network_auditing/)
 A deterministic mapping tool that hunts undocumented vulnerabilities. It uses structural regex to find active physical routing logic (Express, Spring Boot, FastAPI) and applies set theory against official OpenAPI/Swagger documentation to isolate critical Shadow APIs and outdated Ghost APIs.
 
-### [Terabyte Log Scanning](gitgalaxy/tools/terabyte_log_scanning/)
+### [High-Speed PII Detection & Log Analysis](gitgalaxy/tools/terabyte_log_scanning/)
 Unindexed, tactical log analysis operating at 0.07 GB/sec. It streams massive database dumps to deterministically hunt and mask PII (Credit Cards, SSNs, AWS Keys) and uses static architecture maps to prove exact runtime execution frequencies with ASCII time-series histograms.
 
-### [Compliance Operations - SBOM Generators](gitgalaxy/tools/compliance/)
-A Zero-Trust Software Bill of Materials (SBOM) generator. It refuses to blindly trust `package.json` or `requirements.txt` files, instead locating the physical dependencies on disk, mathematically verifying their entropy and linguistic identity, and generating strict CycloneDX 1.4 JSON reports.
-
-### [AI Guardrails](gitgalaxy/tools/ai_guardrails/)
+### [AI Agent Guardrails & Codebase Protection](gitgalaxy/tools/ai_guardrails/)
 Specialized keyword sensors protecting both your application and your codebase. The AppSec Sensor detects weaponized LLM features (RCE funnels, exfiltration risks), while the Dev Agent Firewall evaluates token mass and blast radius to restrict autonomous coding agents from modifying dangerous over context token-draining files. Helps identify which files need to be chunked to reduce context overload.
 
-  ## The Web Viewer (Frictionless Dashboards)
+  ## Local Browser-Based 3D Codebase Visualization
 
-If you prefer visual analytics, we've built a non-numerical dashboard where each file represents a star, sized and colored according to specific risk metrics. 
+If you prefer visual analytics, we've built a non-numerical dashboard where each file represents a star, sized and colored according to specific risk metrics.
 
 Simply drag and drop your generated `your_repo_GPU_galaxy.json` file (or a `.zip` of your raw repository) directly into [GitGalaxy.io](https://gitgalaxy.io/). All rendering and scanning happens entirely in your browser's local memory.
 
@@ -124,7 +133,7 @@ Simply drag and drop your generated `your_repo_GPU_galaxy.json` file (or a `.zip
 
 ![GitGalaxy native SQLite3 database schema for AST-free enterprise codebase mapping and cybersecurity auditing](https://raw.githubusercontent.com/squid-protocol/gitgalaxy/main/docs/wiki/assets/sqlite_overview.png)
 
-## Zero-Trust Architecture
+## Zero-Trust Data Security
 
 Your code never leaves your machine. GitGalaxy performs 100% of its scanning and vectorization locally.
 

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/cobol_refractor_controller.py

@@ -13,15 +13,15 @@ from pathlib import Path
 from datetime import datetime
 
 # Import the core logic functions directly
-from tools.cobol_jcl_forge import analyze_cobol_intent, generate_zero_trust_jcl
-from tools.cobol_dag_architect import extract_lineage
-from tools.cobol_graveyard_finder import x_ray_dead_code
-from tools.cobol_schema_forge import forge_schemas
-from tools.cobol_microservice_slicer import slice_business_logic
-from tools.cobol_system_limits_reporter import scan_system_limits
-from tools.cobol_lexical_patcher import patch_lexical_traps
-from tools.cobol_jcl_auditor import audit_zero_trust_jcls
-from tools.cobol_agent_task_forge import forge_agent_jobs
+from gitgalaxy.tools.cobol_to_cobol.cobol_jcl_forge import analyze_cobol_intent, generate_zero_trust_jcl
+from gitgalaxy.tools.cobol_to_cobol.cobol_dag_architect import extract_lineage
+from gitgalaxy.tools.cobol_to_cobol.cobol_graveyard_finder import x_ray_dead_code
+from gitgalaxy.tools.cobol_to_cobol.cobol_schema_forge import forge_schemas
+from gitgalaxy.tools.cobol_to_cobol.cobol_microservice_slicer import slice_business_logic
+from gitgalaxy.tools.cobol_to_cobol.cobol_system_limits_reporter import scan_system_limits
+from gitgalaxy.tools.cobol_to_cobol.cobol_lexical_patcher import patch_lexical_traps
+from gitgalaxy.tools.cobol_to_cobol.cobol_jcl_auditor import audit_zero_trust_jcls
+from gitgalaxy.tools.cobol_to_cobol.cobol_agent_task_forge import forge_agent_jobs
 
 # ==============================================================================
 # THE SCALE SENSOR & HYBRID STATE MANAGER

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/cobol_to_java_controller.py

@@ -13,12 +13,12 @@ import shutil
 from pathlib import Path
 
 # Current Imports
-from tools.cobol_to_java_spring_forge import generate_java_entity
-from tools.cobol_to_java_api_contract_forge import generate_rest_controller
-from tools.cobol_to_java_agent_forge import generate_java_agent_ticket
-from tools.cobol_to_java_build_forge import generate_pom_xml, generate_application_yml, generate_main_class
-from tools.cobol_to_java_service_forge import generate_service_skeleton
-from tools.cobol_to_java_decoder_forge import generate_decoder_util
+from gitgalaxy.tools.cobol_to_java.cobol_to_java_spring_forge import generate_java_entity
+from gitgalaxy.tools.cobol_to_java.cobol_to_java_api_contract_forge import generate_rest_controller
+from gitgalaxy.tools.cobol_to_java.cobol_to_java_agent_forge import generate_java_agent_ticket
+from gitgalaxy.tools.cobol_to_java.cobol_to_java_build_forge import generate_pom_xml, generate_application_yml, generate_main_class
+from gitgalaxy.tools.cobol_to_java.cobol_to_java_service_forge import generate_service_skeleton
+from gitgalaxy.tools.cobol_to_java.cobol_to_java_decoder_forge import generate_decoder_util
 
 def build_spring_boot_scaffold(output_dir: Path, package_name: str) -> dict:
     """Creates the standard Spring Boot directory architecture."""

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/core/aperture.py

@@ -443,7 +443,7 @@ class ApertureFilter:
         
         return True
 
-    def _load_gitignore_patterns(self) -> list[str]:
+    def _load_gitignore_patterns(self) -> List[str]:
         """Reads local .gitignore files to identify Radio Noise."""
         patterns = []
         ignore_file = self.root / ".gitignore"

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/galaxyscope.py

@@ -75,7 +75,6 @@ def _init_worker(root_str: str, config: Dict[str, Any], ext_tally: Dict[str, int
     Force-warms pseudo-languages (plaintext/markdown) to kill the 'Plaintext Stutter'.
     This prevents [AUTO-HEAL] log spam and redundant regex compilation.
     """
-    global _worker_state
     
     logging.getLogger().setLevel(log_level)
     worker_logger = logging.getLogger("GalaxyScope.Worker")
@@ -139,7 +138,6 @@ def _init_worker(root_str: str, config: Dict[str, Any], ext_tally: Dict[str, int
 
 def _process_file_worker(rel_path: str) -> Dict[str, Any]:
     """Processes a single file path using the worker's cached hardware modules."""
-    global _worker_state
     
     # ---> START THE CLOCK FOR THE MICRO-PROFILER <---
     t_start = time.time()
@@ -271,12 +269,18 @@ def _process_file_worker(rel_path: str) -> Dict[str, Any]:
             observation["processing_time"] = time.time() - t_start
             return observation
 
-# =========================================================================
+        # =========================================================================
         # THE HARDWARE GUILLOTINE (GLOBAL ReDoS Protection)
         # =========================================================================
-        import signal # Explicit local import just in case global import was missed
-        signal.signal(signal.SIGALRM, redos_guillotine)
-        signal.alarm(15) # 15-second fuse for the ENTIRE analysis pipeline
+        import signal
+        import sys
+        
+        # Check if the operating system is not Windows
+        is_posix = sys.platform != "win32"
+        
+        if is_posix:
+            signal.signal(signal.SIGALRM, redos_guillotine)
+            signal.alarm(15) # 15-second fuse for POSIX systems
         
         try:
             # Phase 3: Linguistic Detector
@@ -408,7 +412,8 @@ def _process_file_worker(rel_path: str) -> Dict[str, Any]:
             return observation
         finally:
             # IMPORTANT: Defuse the bomb immediately upon success!
-            signal.alarm(0) 
+            if is_posix:
+                signal.alarm(0) 
         # =========================================================================
         
         data_payload = {
@@ -721,8 +726,8 @@ class Orchestrator:
                     logger.info(f"SQLITE: Generating repository-specific database -> {db_output}")
                     
                     self.db_recorder.record_mission(
-                        parsed_files=repository_graph,
-                        unparsable_files=total_unparsable,
+                        parsed_files=list(repository_graph) if repository_graph else [], # <--- PASS A COPY
+                        unparsable_files=list(total_unparsable) if total_unparsable else [], # <--- PASS A COPY
                         summary=summary,
                         session_meta=session_meta,
                         output_path=db_output
@@ -764,7 +769,13 @@ class Orchestrator:
                 
             # --- THE FINAL CALL TO ACTION (CLI BILLBOARD) ---
             print("\n" + "="*75)
-            print(" 🌌 READY FOR VISUALIZATION (100% LOCAL / ZERO UPLOAD)")
+            
+            # Windows command prompts crash on emojis, so we strip it for them
+            if sys.platform == "win32":
+                print(" READY FOR VISUALIZATION (100% LOCAL / ZERO UPLOAD)")
+            else:
+                print(" 🌌 READY FOR VISUALIZATION (100% LOCAL / ZERO UPLOAD)")
+                
             print("="*75)
             print(" 1. Open your browser to: \033[94m\033[4mhttps://gitgalaxy.io/\033[0m")
             print(f" 2. Drag and drop '{output_file}'")

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/physics/spectral_auditor.py

@@ -187,7 +187,7 @@ class SpectralAuditor:
         for lid, group in by_lang.items():
             if lid in ("undeterminable", "unknown"):
                 for s in group:
-                    singularity.append(self._format_for_singularity(s, "Already Dark Matter (Pre-Audit)"))
+                    unparsable_files.append(self._format_for_singularity(s, "Already Dark Matter (Pre-Audit)"))
                 self.logger.debug(f"[{lid}] Bypassed {len(group)} artifacts (already Dark Matter).")
                 continue
             

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/recorders/audit_recorder.py

@@ -13,7 +13,7 @@ import os
 import re
 from datetime import datetime
 from pathlib import Path
-from typing import Any
+from typing import Any, Dict, Tuple
 from gitgalaxy.standards import analysis_lens as config
 
 # ==============================================================================

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/recorders/llm_recorder.py

@@ -12,7 +12,7 @@ import logging
 import statistics
 from pathlib import Path
 from datetime import datetime
-from typing import List, Dict, Any, Optional
+from typing import List, Dict, Any, Optional, Tuple
 from gitgalaxy.standards import analysis_lens as config
 
 # ==============================================================================
@@ -45,7 +45,7 @@ class LLMRecorder:
         self.RISK_SCHEMA = schemas.get("RISK_SCHEMA", [])
         self.SIGNAL_SCHEMA = schemas.get("SIGNAL_SCHEMA", [])
 
-    def _parse_threat_score(self, star: Dict) -> tuple[float, str]:
+    def _parse_threat_score(self, star: Dict) -> Tuple[float, str]:
         """Safely extracts and converts the AI threat score string to a float."""
         score_str = star.get("telemetry", {}).get("domain_context", {}).get("AI Threat Score", "0.0%")
         try:

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/security/security_lens.py

@@ -131,10 +131,10 @@ class SecurityLens:
                 r'\b(?:import|from|require|include|require_once|fetch|XMLHttpRequest)\b'
                 r'[^\n]*?(?:[\u0400-\u04FF]|'       
                 r'[\u0370-\u03FF]|'                 
-                r'[\u1D400-\u1D7FF]|'               
+                r'[\U0001D400-\U0001D7FF]|'               
                 r'\u3164)',                         
                 re.I
-            ), 
+            ),
             
             # 10. THE VAULT DOOR (Credential & Secret Leaks)
             "private_info": re.compile(
@@ -374,32 +374,6 @@ class SecurityLens:
 
         return exposures
 
-        # 2. Logic Bomb / Sabotage Risk
-        sabotage_hits = aggregated_hits.get("graveyard", 0) + (aggregated_hits.get("danger", 0) * 1.5)
-        sabotage_density = sabotage_hits / loc_safe
-        if sabotage_density >= self.policy["logic_bomb_threshold"]:
-            exposures["Logic Bomb Risk"] = sabotage_density
-
-        # 3. Data Injection Risk
-        injection_hits = aggregated_hits.get("io", 0) + aggregated_hits.get("danger", 0) + aggregated_hits.get("flux", 0)
-        injection_density = injection_hits / loc_safe
-        if injection_density >= self.policy["injection_surface_threshold"]:
-            exposures["Data Injection Risk"] = injection_density
-
-        # 4. Memory Corruption Risk
-        memory_hits = aggregated_hits.get("memory_corruption", 0)
-        memory_density = memory_hits / loc_safe
-        if memory_density >= self.policy["memory_corruption_threshold"]:
-            exposures["Memory Corruption Risk"] = memory_density
-
-        # 5. Secrets Risk
-        secrets_hits = aggregated_hits.get("private_info", 0)
-        secrets_density = secrets_hits / loc_safe
-        if secrets_density >= self.policy["secrets_risk_threshold"]:
-            exposures["Secrets Leak Risk"] = secrets_density
-
-        return exposures
-
     def scan_binary(self, raw_bytes: bytes, ext: str) -> dict:
         """
         X-Rays binary chunks for embedded execution headers, magic byte mismatches, 

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/tools/compliance/sbom_generator.py

@@ -68,8 +68,52 @@ class UniversalManifestSlicer:
                         for line in block.splitlines():
                             line = line.strip()
                             if line and not line.startswith('#') and '=' in line:
+                                pkg_name = line.split('=')[0].strip()
                                 pkg_name = line.split('=')[0].strip()
                                 deps[pkg_name] = "latest" # Simplified version extraction
+                                
+            elif filename == "go.mod":
+                ecosystem = "golang"
+                with open(manifest_path, 'r', encoding='utf-8') as f:
+                    in_require_block = False
+                    for line in f:
+                        line = line.strip()
+                        if line.startswith('require ('):
+                            in_require_block = True
+                            continue
+                        if line == ')':
+                            in_require_block = False
+                            continue
+                        if in_require_block and line and not line.startswith('//'):
+                            parts = line.split()
+                            if len(parts) >= 2:
+                                deps[parts[0]] = parts[1]
+                        elif line.startswith('require ') and not in_require_block:
+                            parts = line.split()
+                            if len(parts) >= 3:
+                                deps[parts[1]] = parts[2]
+                                
+            elif filename == "Gemfile":
+                ecosystem = "rubygems"
+                with open(manifest_path, 'r', encoding='utf-8') as f:
+                    for line in f:
+                        line = line.strip()
+                        # Extract: gem 'nokogiri', '~> 1.11'
+                        if line.startswith("gem "):
+                            parts = line.split(',')
+                            pkg_name = parts[0].replace("gem", "").strip(" '\"")
+                            version = parts[1].strip(" '\"") if len(parts) > 1 else "latest"
+                            deps[pkg_name] = version
+
+            elif filename == "pom.xml":
+                ecosystem = "maven"
+                with open(manifest_path, 'r', encoding='utf-8') as f:
+                    content = f.read()
+                    # Extract artifactId and version from XML blocks
+                    deps_raw = re.findall(r'<dependency>.*?<artifactId>([^<]+)</artifactId>(?:.*?<version>([^<]+)</version>)?.*?</dependency>', content, re.DOTALL)
+                    for artifact, version in deps_raw:
+                        deps[artifact] = version if version else "latest"
+
         except Exception:
             pass
             
@@ -99,6 +143,29 @@ class UniversalManifestSlicer:
                             for d in dirs:
                                 if d.lower() == safe_pkg_name or d.lower().startswith(f"{safe_pkg_name}-"):
                                     return Path(root) / d
+                                    
+        elif ecosystem == "golang":
+            # Go packages are often vendored in the project's root 'vendor/' directory
+            target = target_path / 'vendor' / pkg_name
+            return target if target.exists() else None
+            
+        elif ecosystem == "rubygems":
+            # Ruby often vendors gems locally here
+            target = target_path / 'vendor' / 'bundle' 
+            if target.exists():
+                for root, dirs, _ in os.walk(target):
+                    if pkg_name in dirs: return Path(root) / pkg_name
+            return None
+            
+        elif ecosystem == "maven":
+            # Java local dependency pulls usually land here
+            target = target_path / 'target' / 'dependency'
+            if target.exists():
+                # Just verifying the jar/folder exists loosely
+                for file in target.iterdir():
+                    if pkg_name.lower() in file.name.lower(): return file
+            return None
+
         return None
 
 def main():
@@ -124,7 +191,7 @@ def main():
     total_verified = 0
     
     # 1. Harvest Manifests Universally
-    manifest_targets = ["package.json", "composer.json", "requirements.txt", "Cargo.toml"]
+    manifest_targets = ["package.json", "composer.json", "requirements.txt", "Cargo.toml", "go.mod", "Gemfile", "pom.xml"]
     found_manifests = [target_path / m for m in manifest_targets if (target_path / m).exists()]
     
     if not found_manifests:

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/tools/supply_chain_security/supply_chain_firewall.py

@@ -140,8 +140,8 @@ def main():
             loc = max(len(content.splitlines()), 1)
             sec_results = security.scan_content(content, loc)
             
-            # THE INERT DATA SHIELD
-            if ext in ['.json', '.md', '.txt', '.csv', '.yaml', '.yml', '.css', '.less']:
+            # THE INERT DATA SHIELD & MINIFIED BYPASS
+            if ext in ['.json', '.md', '.txt', '.csv', '.yaml', '.yml', '.css', '.less', '.h'] or '.d.ts' in file_path.name or '.min.' in file_path.name or '.umd.' in file_path.name:
                 for key in sec_results["counts"].keys():
                     sec_results["counts"][key] = 0
             

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy/tools/terabyte_log_scanning/terabyte_log_scanner.py

@@ -81,13 +81,21 @@ def main():
     keyword_patterns = {}
     for kw in search_targets:
         # Example: looking for "PGM=NAME" or "STARTED NAME"
-        pattern_str = fr"(?:PGM=|STARTED\s+){kw}"
+        pattern_str = fr"{kw}"
         keyword_patterns[kw] = re.compile(pattern_str.encode('utf-8'), re.IGNORECASE)
 
     ts_pattern = re.compile(br'(\d{4}-\d{2}-\d{2}[T\s]\d{2}|\b[A-Z][a-z]{2}\s+\d{1,2}\s\d{2})')
     histograms = {kw: defaultdict(int) for kw in search_targets}
 
-    # ... [Keep your existing file path setup and start_time logic here] ...
+    if args.out:
+        out_dir = Path(args.out).resolve()
+        out_dir.mkdir(parents=True, exist_ok=True)
+        results_path = out_dir / f"{target_path.stem}_results.txt"
+    else:
+        results_path = target_path.parent / f"{target_path.stem}_results.txt"
+        
+    start_time = time.time()
+    print(f"🚀 Scanning {target_path.name} for {len(search_targets)} keywords...")
     
     # 2. The Memory Shield
     with open(target_path, 'rb') as f_in, open(results_path, 'w', encoding='utf-8') as f_out:
@@ -103,7 +111,11 @@ def main():
 
     time_elapsed = time.time() - start_time
     
-    # ... [Keep your existing ASCII Histogram and Executive Summary printing here] ...
+    for kw, buckets in histograms.items():
+        draw_ascii_histogram(buckets, kw)
+        
+    print(f"\n✅ Scan completed in {time_elapsed:.2f} seconds.")
+    print(f"📄 Filtered results saved to: {results_path}")
 
     total_counts = {kw: sum(buckets.values()) for kw, buckets in histograms.items()}
 

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5/gitgalaxy.egg-info}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gitgalaxy
-Version: 2.0.3
+Version: 2.0.5
 Summary: An AST-free, zero-trust static analysis engine for mapping architectural risk, securing CI/CD pipelines, and modernizing legacy monoliths.
-Author: Joseph Michael Esquibel
+Author: Joe Esquibel
 Project-URL: Homepage, https://gitgalaxy.io
 Project-URL: Documentation, https://squid-protocol.github.io/gitgalaxy/
 Project-URL: Source, https://github.com/squid-protocol/gitgalaxy
@@ -16,7 +16,7 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
@@ -38,32 +38,36 @@ 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)](#)
 
-### **The blAST Engine: A custom heuristics-based AST-free Knowledge Graph Generator**
+### **AST-Free Static Analysis & Knowledge Graph Engine**
 
-The blAST (Bypassing LLMs and ASTs) engine is a custom-made knowledge graph engine that resolves repositories at the function level. It scores each function based on 50 unique metrics, rolls that data up to score the file, and finally summarizes the entire repository. 
+The blAST (Bypassing LLMs and ASTs) engine is a custom-made knowledge graph engine that resolves repositories at the function level. It scores each function based on 50 unique metrics, rolls that data up to score the file, and finally summarizes the entire repository.
 
-By utilizing a custom engine, we retain full control over the search space. We built it to be exceptionally fast, capable of assessing your entire repository without requiring compilable code—a fundamental limitation of standard Abstract Syntax Trees (ASTs). ASTs are great for finding missing commas and memory overflows, but they miss the forest for the trees when generating knowledge graphs. LLMs, on the other hand, suffer from hallucination during large context windows and yield probabilistic, fluctuating answers. 
+### Scanning Apollo-11 with the blAST Engine
 
-The blAST engine solves this. Because all programming languages utilize keywords and functions, our engine treats code files as text, scanning for these structural anchors to build a deterministic 3D knowledge graph. It seamlessly handles mid-file language switching, assesses the architectural ratio of test files to logic, and extracts invaluable project structure data that ASTs ignore. 
+![GitGalaxy CLI Scan](./docs/wiki/assets/apollo11_scan.gif)
+
+By utilizing a custom engine, we retain full control over the search space. We built it to be exceptionally fast, capable of assessing your entire repository without requiring compilable code—a fundamental limitation of standard Abstract Syntax Trees (ASTs). ASTs are great for finding missing commas and memory overflows, but they miss the forest for the trees when generating knowledge graphs. LLMs, on the other hand, suffer from hallucination during large context windows and yield probabilistic, fluctuating answers.
+
+The blAST engine solves this. Because all programming languages utilize keywords and functions, our engine treats code files as text, scanning for these structural anchors to build a deterministic 3D knowledge graph. It seamlessly handles mid-file language switching, assesses the architectural ratio of test files to logic, and extracts invaluable project structure data that ASTs ignore.
 
 Every assumption our system makes has been abstracted into over 300 tunable variables. Think of GitGalaxy as a highly calibrated telescope. You can query the number of active API network nodes, isolate unique external imports, or highlight functions exhibiting extreme cognitive load—all adjusted via custom whitelists and blacklists to eliminate false-positive fatigue. Field-tested on over 1,000 repositories spanning 50+ languages and 250+ extensions, the engine comes equipped with smart defaults ready for immediate deployment.
 
-**Core Technology**
+**Core Codebase Mapping Technology**
 * Bypasses LLMs and rigid ASTs.
 * Doesn't require code to compile (AST-free).
 * Produces full function-to-function call chains.
 * 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. 
+* 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))**
 
-**Extreme Velocity & Scale**
+**Enterprise Scale & Performance Metrics**
 * 100,000 LOC/sec code analysis.
 * 0.07 GB/sec raw log ingestion.
 * Full-system scans in minutes without data sampling.
 * 100% daily system coverage.
 
-**Scientific Claims & Validation**
+**Methodology & Comparative Benchmarks**
 GitGalaxy is backed by an academic-grade thesis detailing the equations powering the blAST engine.
 
 * **[Optimum Search Strategies Evolve](https://squid-protocol.github.io/gitgalaxy/03-01-claim-1-search-strategies/):** AST-free mapping. Outperforms rigid parsers and LLM context windows.
@@ -71,15 +75,14 @@ GitGalaxy is backed by an academic-grade thesis detailing the equations powering
 * **[All languages have keywords that roughly do the same thing, these can be grouped to make cross-language keyword maps](https://squid-protocol.github.io/gitgalaxy/03-03-claim-3-taxonomy-map/):** Standardizes 50+ languages into a single universal physical framework.
 * **[Cross-Language Comparisons of over 1000 repos](https://squid-protocol.github.io/gitgalaxy/03-04-claim-4-comparing-languages/):** Deterministic 1:1 benchmarking of distinct syntax architectures.
 * **[Universal File Archetypes by k-means clustering](https://squid-protocol.github.io/gitgalaxy/03-05-claim-5-file-archetypes/):** ML isolation of files into K-means clusters (e.g., "The God Nodes," "Declarative Glue").
-* **[Assessing the blAST engines cross-language capbility over 10 different DOOM ports](https://squid-protocol.github.io/gitgalaxy/03-07-claim-7-doom-comparisons/):** Comparative function analysis across 10 distinct DOOM source ports.
-* **Mainframe Proven:** Successful from-scratch translation of legacy COBOL monoliths to compiling Spring Boot architectures.
+* **[Mainframe Proven: 100% CI/CD Translation Success Rate](https://github.com/squid-protocol/gitgalaxy/tree/main/examples/ibm_cics_translation):** Flawless architectural translation of 27 distinct legacy COBOL repositories (including IBM CICS benchmark apps) into compiling Java Spring Boot environments.
 
-**Security & Deployment**
+**Data Privacy & On-Premise Deployment**
 * 100% air-gapped execution.
 * On-premise deployment with zero IP exfiltration risk.
 * Zero-trust processing model.
 
-**How to use**
+**Installation & Usage**
 * Python-based: `pip install gitgalaxy`
 * CLI execution
 * Outputs forensic JSONs (optimized for AI-agent summary reports) and a native SQLite3 database for robust querying and storage.
@@ -88,7 +91,7 @@ GitGalaxy is backed by an academic-grade thesis detailing the equations powering
 
 ---
 
-## Quickstart
+## Quickstart Guide
 
 ### 1. Install
 
@@ -107,39 +110,45 @@ galaxyscope /path/to/your/local/repo
 
 ---
 
-### [Project Overview](docs/wiki/01-project-overview.md)
+### [GitGalaxy Core Analysis Engine](docs/wiki/01-project-overview.md)
 The central blAST engine. It bypasses rigid ASTs using mathematical heuristics to map O(N) multi-dimensional relationships across 50+ languages, managing signal processing, spatial layout, and high-speed SQLite telemetry recording.
 
 
 
-## The GitGalaxy Ecosystem
+## Enterprise Codebase Tools & Use Cases
 
-GitGalaxy operates on a modular Hub-and-Spoke architecture. While the core engine provides the overarching physics and cartography, our specialized toolsets leverage that deterministic graph to execute enterprise-grade operations. The following toolsets provide novel heuristic solutions to several open problems in computing. 
+GitGalaxy operates on a modular Hub-and-Spoke architecture. While the core engine provides the overarching physics and cartography, our specialized toolsets leverage that deterministic graph to execute enterprise-grade operations. 
 
-### [Legacy Modernization: Converting Raw Cobol Repos to Java Spring Boots](gitgalaxy/tools/cobol_to_java/)
+### [Automated Legacy Migration: COBOL to Java Spring Boot](gitgalaxy/tools/cobol_to_java/)
 A deterministic, high-fidelity translation pipeline. It converts legacy COBOL into fully compiling, modern Spring Boot architectures, mapping memory exactly and scaffolding JPA entities, REST controllers, and Maven builds before utilizing AI to translate isolated business logic.
+* **Proven Metric:** Achieved a perfect 27/27 Maven compile success rate across a batch test of distinct legacy repos.
+* **Verify for Yourself:** [Inspect the raw outputs of the IBM CICS Application Translation here.](examples/ibm_cics_translation/)
 
-### [Legacy Modernization: Converting Raw Cobol Repos to cleaner Cobol Repos](gitgalaxy/tools/cobol_to_cobol/)
+![Java Forge & Batch Test](./docs/wiki/assets/java_forge_and_batch_test.gif)
+
+### [Mainframe Refactoring: COBOL & JCL Optimization](gitgalaxy/tools/cobol_to_cobol/)
 A mathematical x-ray suite for sanitizing mainframe monoliths. It safely neutralizes legacy lexical traps, extracts dead "Graveyard" memory, maps topological DAG execution orders, and generates Zero-Trust JCL configurations for modern cloud deployments.
+* **Proven Metric:** The Graveyard Reaper engine extracted over 6,700 lines of dead execution blocks and orphaned variables from the standard IBM CICS benchmark app in seconds.
 
-### [Supply Chain Security](gitgalaxy/tools/supply_chain_security/)
+### [Software Supply Chain Security & Pre-Commit Firewalls](gitgalaxy/tools/supply_chain_security/)
 Extreme-velocity pre-commit firewalls. Instead of trusting manifest files, it scans physical internals to block steganography, sub-atomic XOR decryption loops, homoglyph typosquatting, and exposed cryptographic vaults before they ever enter your CI/CD pipeline.
 
-### [Network Auditing](gitgalaxy/tools/network_auditing/)
+### [Zero-Trust SBOM Generation & Dependency Auditing](gitgalaxy/tools/compliance/)
+A Zero-Trust Software Bill of Materials (SBOM) generator. It refuses to blindly trust `package.json` or `requirements.txt` files, instead locating the physical dependencies on disk, mathematically verifying their entropy and linguistic identity, and generating strict CycloneDX 1.4 JSON reports.
+* **Proven Metric:** Successfully mapped and mathematically verified the physical internals of 170 unique Go modules inside the local Kubernetes repository.
+
+### [API Security & Shadow API Detection](gitgalaxy/tools/network_auditing/)
 A deterministic mapping tool that hunts undocumented vulnerabilities. It uses structural regex to find active physical routing logic (Express, Spring Boot, FastAPI) and applies set theory against official OpenAPI/Swagger documentation to isolate critical Shadow APIs and outdated Ghost APIs.
 
-### [Terabyte Log Scanning](gitgalaxy/tools/terabyte_log_scanning/)
+### [High-Speed PII Detection & Log Analysis](gitgalaxy/tools/terabyte_log_scanning/)
 Unindexed, tactical log analysis operating at 0.07 GB/sec. It streams massive database dumps to deterministically hunt and mask PII (Credit Cards, SSNs, AWS Keys) and uses static architecture maps to prove exact runtime execution frequencies with ASCII time-series histograms.
 
-### [Compliance Operations - SBOM Generators](gitgalaxy/tools/compliance/)
-A Zero-Trust Software Bill of Materials (SBOM) generator. It refuses to blindly trust `package.json` or `requirements.txt` files, instead locating the physical dependencies on disk, mathematically verifying their entropy and linguistic identity, and generating strict CycloneDX 1.4 JSON reports.
-
-### [AI Guardrails](gitgalaxy/tools/ai_guardrails/)
+### [AI Agent Guardrails & Codebase Protection](gitgalaxy/tools/ai_guardrails/)
 Specialized keyword sensors protecting both your application and your codebase. The AppSec Sensor detects weaponized LLM features (RCE funnels, exfiltration risks), while the Dev Agent Firewall evaluates token mass and blast radius to restrict autonomous coding agents from modifying dangerous over context token-draining files. Helps identify which files need to be chunked to reduce context overload.
 
-  ## The Web Viewer (Frictionless Dashboards)
+  ## Local Browser-Based 3D Codebase Visualization
 
-If you prefer visual analytics, we've built a non-numerical dashboard where each file represents a star, sized and colored according to specific risk metrics. 
+If you prefer visual analytics, we've built a non-numerical dashboard where each file represents a star, sized and colored according to specific risk metrics.
 
 Simply drag and drop your generated `your_repo_GPU_galaxy.json` file (or a `.zip` of your raw repository) directly into [GitGalaxy.io](https://gitgalaxy.io/). All rendering and scanning happens entirely in your browser's local memory.
 
@@ -147,7 +156,7 @@ Simply drag and drop your generated `your_repo_GPU_galaxy.json` file (or a `.zip
 
 ![GitGalaxy native SQLite3 database schema for AST-free enterprise codebase mapping and cybersecurity auditing](https://raw.githubusercontent.com/squid-protocol/gitgalaxy/main/docs/wiki/assets/sqlite_overview.png)
 
-## Zero-Trust Architecture
+## Zero-Trust Data Security
 
 Your code never leaves your machine. GitGalaxy performs 100% of its scanning and vectorization locally.
 

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/gitgalaxy.egg-info/SOURCES.txt

@@ -63,4 +63,5 @@ gitgalaxy/tools/supply_chain_security/binary_anomaly_detector.py
 gitgalaxy/tools/supply_chain_security/supply_chain_firewall.py
 gitgalaxy/tools/supply_chain_security/vault_sentinel.py
 gitgalaxy/tools/terabyte_log_scanning/pii_leak_hunter.py
-gitgalaxy/tools/terabyte_log_scanning/terabyte_log_scanner.py
+gitgalaxy/tools/terabyte_log_scanning/terabyte_log_scanner.py
+tests/test_galaxyscope.py

{gitgalaxy-2.0.3 → gitgalaxy-2.0.5}/pyproject.toml

@@ -4,15 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitgalaxy"
-version = "2.0.3"
+version = "2.0.5"
 authors = [
-  { name="Joseph Michael Esquibel" },
+  { name="Joe Esquibel" },
 ]
 description = "An AST-free, zero-trust static analysis engine for mapping architectural risk, securing CI/CD pipelines, and modernizing legacy monoliths."
 readme = "README.md"
-requires-python = ">=3.8"
-
-license-files = ["LICENSE"] 
+requires-python = ">=3.9"
 
 keywords = [
     "static-analysis", 

gitgalaxy-2.0.5/tests/test_galaxyscope.py

@@ -0,0 +1,61 @@
+import subprocess
+import json
+from pathlib import Path
+
+def test_galaxyscope_python_fixture(tmp_path):
+    """
+    Tests that GalaxyScope can parse a micro-repo (iwubi),
+    complete its mission, and trigger all 4 recorders successfully.
+    """
+    # 1. Dynamically get the absolute path to the GitGalaxy root
+    test_dir = Path(__file__).parent
+    project_root = test_dir.parent
+    
+    # 2. Build absolute paths for the script and the fixture
+    script_path = project_root / "gitgalaxy" / "galaxyscope.py"
+    fixture_path = test_dir / "fixtures" / "iwubi_frankenstein_test"
+    
+    # Force output to a temporary directory
+    output_dir = tmp_path / "test_run"
+
+    # 3. Pass the absolute paths to the subprocess
+    result = subprocess.run(
+        ["python", str(script_path), str(fixture_path), "--output", str(output_dir)],
+        capture_output=True,
+        text=True
+    )
+
+    # INVARIANT 1: CLI Exit Code & Billboard Output
+    assert result.returncode == 0, f"GalaxyScope crashed! Stderr: {result.stderr}"
+    assert "MISSION_SUCCESS" in result.stdout, "CLI did not print the success billboard."
+
+    # The engine uses the target folder name to build the filenames automatically
+    target_name = "iwubi_frankenstein_test"
+    
+    gpu_file = output_dir / f"{target_name}_galaxy_gpu.json"
+    audit_file = output_dir / f"{target_name}_galaxy_audit.json"
+    llm_file = output_dir / f"{target_name}_galaxy_llm.md"
+    db_file = output_dir / f"{target_name}_galaxy_master.db"
+
+    # INVARIANT 2: File Generation (Did all 4 recorders fire?)
+    assert gpu_file.exists(), f"GPU Recorder failed to output JSON at {gpu_file}"
+    assert audit_file.exists(), f"Audit Recorder failed to output JSON at {audit_file}"
+    assert llm_file.exists(), f"LLM Recorder failed to output Markdown at {llm_file}"
+    assert db_file.exists(), f"SQLite Recorder failed to output DB at {db_file}"
+
+    # INVARIANT 3: GPU Recorder Internals (Non-blank structural check)
+    with open(gpu_file, "r", encoding="utf-8") as f:
+        gpu_data = json.load(f)
+        assert "meta" in gpu_data, "GPU JSON missing 'meta' object"
+        assert "galaxy" in gpu_data, "GPU JSON missing 'galaxy' object"
+        assert len(gpu_data["galaxy"]["names"]) >= 1, "GPU Recorder found 0 files"
+        assert "iwubi.py" in gpu_data["galaxy"]["names"], "Failed to identify iwubi.py"
+
+    # INVARIANT 4: LLM Recorder Internals (Text check)
+    with open(llm_file, "r", encoding="utf-8") as f:
+        md_content = f.read()
+        assert "# ARCHITECTURAL_BRIEF" in md_content, "LLM Markdown missing main header"
+        assert "MACRO STATE" in md_content, "LLM Markdown missing MACRO STATE section"
+        
+    # INVARIANT 5: SQLite Database (Byte check)
+    assert db_file.stat().st_size > 1000, "SQLite database appears to be empty"