Skip to content

Release#173

Merged
JEJodesty merged 63 commits into
mainfrom
release
Jun 26, 2026
Merged

Release#173
JEJodesty merged 63 commits into
mainfrom
release

Conversation

@JEJodesty

@JEJodesty JEJodesty commented Mar 10, 2026

Copy link
Copy Markdown
Collaborator

This is a major release PR that lands roughly two years of CATs development: the architectural quantum refactor (InfraFunction / Structure / Process / Plant), IPFS ingress/egress, CAR (Content-Addressable Router) test infrastructure, and project handoff to DynamicalSystemsGroup.
Two sub-PRs are merged into this release:


Commit groups

1. Core architecture (May 2024)

Early commits establish the CAT quantum decomposition:

Area Changes
Action plane Ingress/egress accessible with and without integration points; I/O writing
InfraFunction Composes Processor, Plant, and Infrastructure as separate sub-components
Structure InfraStructure sub-component; Plant-in-order lifted to Structure generalization
Network IPFS included as a class; REPL in mesh client; partial CID filtering for BOMs
Cleanup Removed legacy cod module; v4 milestone
Docs/examples Data product team examples, catalog, commit history, ACG/MAC logs; articles moved to wiki

2. CAR & Docker integration

Commit Summary
docker workd / car close Docker-based CAR workflow
works on macos 12.2.1 macOS compatibility fixes
plant in order lifted to structure generalization Structure layer generalization for Plant ordering

3. Infrastructure hardening (Sep 2024)

  • Codebase refactor across executor, network, node, and service layers
  • Docs updates (DEPS.md, DESIGN.md, DEMO.md, TEST.md)
  • Terraform/Docker: removed Kind cluster deletion from main.tf; pinned Docker to 27.1.1
  • Added Docker resource to infrastructure
  • Placeholder directories with .gitkeep

4. IPFS Ingress & Egress — merge of #172

Largest functional change in the release:

  • New cats/executor/ split into function and structure packages
  • New cats/network/clients/ and IPFS helpers (ipfs_client.py, ipfs_docker.py)
  • Removed legacy cats/io/input/, cats/network/cod.py, root-level main.tf / process.py
  • Relocated IaC and processing to data/input/ (Terraform, process.py, IPFS transport compose)
  • Expanded tests/verification_test.py for mesh verification
  • Added articles.md, car_demo.ipynb, deprecated legacy scripts under data/deprecated/
  • New cats/utils/ and cats/service/k8s/ modules

5. CAR support — merge of #174

Commit Summary
test contract Structure executor helpers, IPFS client layer, process.py refactor
Wire IPFS transport peers and cache volumes ipfs_connect_peers.sh, Kubo compose, cache bind mounts
Add pytest cleanup harness scripts/clean-test-data.sh, autouse conftest fixture
Drop redundant requirements.txt Dependencies consolidated into pyproject.toml
Stop tracking structure output artifacts .gitignore for generated CSVs; bulk removal from repo
Update maintainer contact email AUTHORS.txt email update
Credit DSG contributors Reorganized AUTHORS.txt and README acknowledgments

6. DSG project migration (Jun 2026)

  • Added Maintainers section and DynamicalSystemsGroup links in README.md and pyproject.toml
  • Updated .gitignore for new artifact paths
  • Synced with main via merge commit

Themes

1. Architectural quantum

Clear separation of InfraFunction, Structure (PaaS/IaC), Process (FaaS), and Plant (SaaS), with ingress/egress on the action plane.

2. IPFS data mesh

End-to-end IPFS ingress/egress via Docker nodes, host peering, and content-addressed BOM/CID handling.

3. Infrastructure as code

Terraform + Kind + Docker Compose under data/input/structure/, with lifecycle and cleanup improvements.

4. Test & repo hygiene

Pytest cleanup harness, removal of stale verification tests, stop tracking generated integration outputs.

5. Governance

Project URLs, maintainer attribution, and DSG contributor credits under the new org.

Notable file-level impact

Added / restructured Removed / deprecated
cats/executor/function/, cats/executor/structure/ cats/io/input/, cats/network/cod.py
cats/network/clients/, ipfs_client.py, ipfs_docker.py Root main.tf, process.py
data/input/ (Terraform, process, IPFS compose) requirements.txt
scripts/clean-test-data.sh, tests/conftest.py old_verification_test.py

Test plan

  • Install deps per updated docs/DEPS.md
  • Run CAT mesh verification (docs/TEST.md / tests/verification_test.py)
  • Demo flow per docs/DEMO.md
  • Confirm IPFS host ↔ Docker peer connectivity after structure provisioning
  • Verify Terraform/Kind cluster lifecycle on target platform (macOS tested on 12.2.1)

JEJodesty and others added 14 commits June 25, 2026 19:17
test(test): add scripts/clean-test-data.sh and session autouse
 conftest fixture;
 document cleanup in docs/TEST.md;
 remove deprecated old_verification_test.py
chore(deps): remove requirements.txt now covered by pyproject.toml
refactor(data): ignore data/testing/cat_* and structure/outputs/**;
 remove previously tracked integration output CSVs from the repo
docs(AUTHORS): update Joshua E. Jodesty maintainer email
docs(AUTHORS,README): reorganize maintainer and original-contributor
 sections with roles, emails, and GitHub profiles;
 add README Acknowledgments for DSG team and key contributions

Co-authored-by: David Sisson <davidfsol5@users.noreply.github.com>
Co-authored-by: Michael Zargham <mzargham@users.noreply.github.com>
CAR (Content-Addressable Router) support preparation
@JEJodesty JEJodesty self-assigned this Jun 26, 2026
@JEJodesty JEJodesty added documentation Improvements or additions to documentation testing Testing functionality System functionality labels Jun 26, 2026
@JEJodesty JEJodesty added this to the 2. CATs’ Node milestone Jun 26, 2026
chore(gitignore,data): reorganise .gitignore with section comments for
 IDE, Terraform, and data/ trees;
 commit .terraform.lock.hcl and update .gitkeep to list tracked
 data/input assets
refactor(scripts): replace clean_structure_outputs with
 clean_dir_contents for structure outputs
docs(test): add Session 0 ipfs daemon step and venv creation comment
chore(license): correct Dynamical Systems Group copyright spelling

@JEJodesty JEJodesty left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pytests pass

@JEJodesty JEJodesty merged commit f1e8360 into main Jun 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation functionality System functionality testing Testing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant