From d3e927c1769ca7af7d8cad210a9e10655b75ed64 Mon Sep 17 00:00:00 2001 From: squid-protocol Date: Mon, 31 Aug 2026 16:15:39 -0400 Subject: [PATCH] README: link the Legacy Bridge docs chapter, engine pipeline source, and the constellation Part of the org-wide interlinking pass (canonical map: gitgalaxy docs/ecosystem.md, PR squid-protocol/gitgalaxy#2614): the showcase now points at the mechanism docs behind it (refraction controller, JPA entity mapping, agent tickets, batch harness), the pipeline source in the engine repo, and the sibling repos that scan/benchmark the same source codebases. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01PUfXMUECX4Vq1vqh9mMQqt --- README.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/README.md b/README.md index cbd03e2..2054204 100644 --- a/README.md +++ b/README.md @@ -37,5 +37,37 @@ We selected a diverse array of structural complexities for this showcase, avoidi 9. **`vscode_cobol`**: Edge-case syntax highlighting tool architecture. 10. **`fake_cobol_repo`**: Intentionally malformed or edge-case testing code. +## 📚 How the pipeline works + +The full mechanism behind these outputs is documented in the GitGalaxy docs site's **Legacy +Bridge** chapter: the [refraction controller](https://squid-protocol.github.io/gitgalaxy/05-01-legacy-refraction-controller) +(the deterministic COBOL→architecture mapping), [Spring Boot scaffolding](https://squid-protocol.github.io/gitgalaxy/05-02-spring-boot-scaffolding), +[entity & memory mapping](https://squid-protocol.github.io/gitgalaxy/05-03-entity-and-memory-mapping) +(`PIC`/`OCCURS`/`REDEFINES` → JPA), [API & service contracts](https://squid-protocol.github.io/gitgalaxy/05-04-api-and-service-contracts), +the [autonomous agent tickets](https://squid-protocol.github.io/gitgalaxy/05-05-autonomous-agent-tickets) +that populate `ai_agent_jobs/`, and the [batch test harness](https://squid-protocol.github.io/gitgalaxy/05-06-batch-test-harness) +that generated this whole repo. The source lives in the engine's +[`gitgalaxy/tools/cobol_to_java`](https://github.com/squid-protocol/gitgalaxy/tree/main/gitgalaxy/tools/cobol_to_java). + +Several of the source repos here (cics-genapp, cics-java-jcics-samples, gnucobol) also appear in +[gitgalaxy-raw-output](https://github.com/squid-protocol/gitgalaxy-raw-output) as unedited +analysis scans, and in the [language-crucible](https://github.com/squid-protocol/language-crucible) +COBOL/JCL benchmark corpus — the same codebases, seen by the analysis, benchmark, and +translation legs of the system. + +## The GitGalaxy constellation + +This repo is one strand of the web of repos that build, prove, and showcase +[GitGalaxy](https://github.com/squid-protocol/gitgalaxy): + +- [gitgalaxy](https://github.com/squid-protocol/gitgalaxy) — the engine (this repo showcases its `cobol_to_java` pipeline) +- **cobol_to_java_examples** — *you are here*: 10 auto-generated, compiling Spring Boot translations +- [gitgalaxy-raw-output](https://github.com/squid-protocol/gitgalaxy-raw-output) — unedited analysis scans of real repos, including several of this repo's sources +- [language-crucible](https://github.com/squid-protocol/language-crucible) — the pinned adversarial corpus (COBOL/JCL heavy) behind the engine's regression gate +- [keyword-rosetta](https://github.com/squid-protocol/keyword-rosetta) — one planted program in 46 languages, measuring cross-language measurement consistency +- [gitgalaxy-population-analyses](https://github.com/squid-protocol/gitgalaxy-population-analyses) — statistical analyses over the scan population +- [squid-telemetry](https://github.com/squid-protocol/squid-telemetry) — public distribution/adoption metrics +- Docs: [architecture & methodology site](https://squid-protocol.github.io/gitgalaxy/) · [Legacy Bridge chapter](https://squid-protocol.github.io/gitgalaxy/05-01-legacy-refraction-controller) · [Museum of Code](https://squid-protocol.github.io/gitgalaxy/museum-of-code/) · [gitgalaxy.io](https://gitgalaxy.io/) + --- *Generated automatically via the GitGalaxy Batch Test Harness.*