gitgalaxy 2.0.2__tar.gz → 2.0.5__tar.gz

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

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gitgalaxy
-Version: 2.0.2
+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/README.md)
+### [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/README.md)
+![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/README.md)
+### [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/README.md)
+### [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/README.md)
+### [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/README.md)
-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/README.md)
+### [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.2 → 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/README.md)
+### [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/README.md)
+![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/README.md)
+### [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/README.md)
+### [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/README.md)
+### [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/README.md)
-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/README.md)
+### [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.2 → 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.2 → 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.2 → 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"