Skip to content

Runtime packaging, scratch/durable MinIO, and DDD domain docs - #200

Merged
JEJodesty merged 49 commits into
mainfrom
dev
Jul 30, 2026
Merged

Runtime packaging, scratch/durable MinIO, and DDD domain docs#200
JEJodesty merged 49 commits into
mainfrom
dev

Conversation

@JEJodesty

@JEJodesty JEJodesty commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Runtime/Node packaging,
  • Dual MinIO (scratch + durable Entity Relationship),
  • Rewritten README/DESIGN story around Action/Data Planes, DDD domains, and the Architectural Quantum.

Runtime and Node peer edge

  • Rename ServiceRuntime (cats/servicecats/runtime, singleton RUNTIME)
  • Thread runtime through Factory, Executor, Function, and Structure; retarget tests
  • Split cats/node.py into cats.node (app, cli, __main__); entrypoint python -m cats.node
  • Makefile / docs: node-up, node-down, and docs/NodeLifeCycle.md

Dual MinIO and durable Entity Relationship

  • Scratch MinIO (Structure lifetime: ILM + down -v) vs durable ER MinIO (Node lifetime)
  • Dual-config ObjectStore: promote_er / resolve_er / gc_er; scratch config rename for Ray landing
  • BOM correlators: durable_er_uri / durable_er_pointer; docs for consoles, STORAGE, INTEROP

Docs and architecture framing

  • README: Introduction / Means / Operations; BOM CID transport; Action Plane (SLA) vs Data Plane (OLA)
  • Product domain as DDD bounded context / architectural quanta; Domain Example moved to DESIGN.md
  • DESIGN.md: Minimal Federated Operating Model Function/Structure breakdown; CAS primer
  • Diagram refreshes (chaordic kernel, BOM activity, code2flow/pyreverse)

Tests

  • ObjectStore ER round-trip / GC / dual-MinIO snapshots
  • Node lifecycle CLI against cats.node package
  • Provenance suite keys updated for scratch/durable outputs

refactor(runtime,executor,factory,node): rename Service to Runtime
 and cats/service to cats/runtime; thread runtime through Factory,
 Executor, Function, and Structure;
refactor(cats): export RUNTIME instead of SERVICE;
chore(makefile): note Runtime.execute on execute-order;
test: retarget fixtures to runtime
docs(COMPONENTS,BOM,PLANTs,INTEROP,MinIO,STORAGE): describe Runtime
 as process-lifetime ambient; replace Service wording;
docs(CAS): add Content-Addressing primer linked from the README
docs(readme): lead with Introduction / Means / Operations and a
 Demonstration Orders section; collapse BOM/initiative concepts;
docs(images): add CATs_bom_activity_ag.jpeg and refresh
 CATs_chaordic_kernel.jpeg
refactor(node): replace cats/node.py with cats/node (app, cli,
 __main__); entrypoint is python -m cats.node;
chore(makefile,network,runtime): retarget lifecycle and comments;
test(node): import app/cli and scan the package tree
docs(readme,IPFS,STORAGE,DEMO,DEPS,DASHBOARDS,COMPONENTS): replace
 cats/node.py with python -m cats.node;
docs(readme): Factory step composes and produces the Executor
docs(images): update CATs_bom_activity_ag.jpeg
feat(infrastructure): provision scratch MinIO (Structure lifetime,
 ILM + down -v) and durable ER MinIO (Node lifetime, no volume wipe);
 replace minio_compose with scratch/durable compose files;
 expose scratch_* and durable_* Terraform outputs
feat(infrastructure): dual-config ObjectStore with promote_er,
 resolve_er, and gc_er; scratch config file rename;
refactor(plant): Ray landing reads object_store_scratch_config.json;
feat(executor): log durable_er_uri and durable_er_pointer;
test: cover ER round-trip, GC, and dual MinIO snapshots
docs(MinIO,STORAGE,DASHBOARDS,BOM,INTEROP): dual MinIO lifecycle,
 consoles, JobHandle scratch vs ER promote/gc-er, and BOM correlators
@JEJodesty JEJodesty self-assigned this Jul 28, 2026
@JEJodesty JEJodesty added documentation Improvements or additions to documentation enhancement New feature or request story Agile story testing Testing functionality System functionality labels Jul 28, 2026
@JEJodesty JEJodesty added this to the 2. CATs’ Node milestone Jul 28, 2026
JEJodesty added 14 commits July 27, 2026 22:01
feat(makefile): add node-down (node-stop then ipfs shutdown);
docs(NodeLifeCycle): extract ensure/start/stop/status/down reference;
docs(DEMO,TEST,IPFS,ENV,STORAGE): point lifecycle steps at
 NodeLifeCycle.md
docs(readme): retitle Computational Governance / AQ section;
 slim Get Started to Install, NodeLifeCycle, Demo, Test,
 Dashboards, and diagrams; tighten Quantum concepts
docs(images): update chaordic kernel, BOM activity, code2flow,
 and pyreverse PNGs;
chore(code2flow): regenerate cats_pkg.gv
JEJodesty added 26 commits July 29, 2026 11:18
docs(DESIGN): retitle as DDD Quantum Architecture principle;
 add Minimal Federated Operating Model Function/Structure
 breakdown; slim collaborative-value into Data Product Team
 example; fix CAT Kernel image alt text
docs(readme): expand BOM CID transport and Action Plane /
 Data Initiative collaboration; drop duplicated Quantum
 FOM Concepts (now in DESIGN); fix Get Started link markup
docs(readme): frame CAT Nodes as mesh peers; distinguish Action
 Plane (SLA stewardship) from Data Plane (OLA processing);
 nest Inter/Intra-Product collaboration under each plane
docs(readme): define Product domain as DDD bounded context
 and architectural quanta for Data Initiatives
docs(images): update CATs_bom_activity_ag.jpeg
docs(DESIGN): add Data Product Design Domains mesh example;
docs(readme): link architectural quanta to Domain Example;
 drop duplicated domain section from README
@JEJodesty JEJodesty changed the title Dev Runtime packaging, scratch/durable MinIO, and DDD domain docs Jul 30, 2026
@JEJodesty
JEJodesty merged commit c17bcb0 into main Jul 30, 2026
This was linked to issues Aug 6, 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 enhancement New feature or request functionality System functionality story Agile story testing Testing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

InfraStructure (IaaS) CAT Node

1 participant