Skip to content

feat(cluster): lift k3d-tmnl Alchemy stack into @gbg/cluster - #109

Merged
creatifcoding merged 6 commits into
feat/mantis-biomemetics-labfrom
cursor/lab-cluster-k3d-tmnl-f119
Aug 30, 2026
Merged

creatifcoding merged 6 commits into
feat/mantis-biomemetics-labfrom
cursor/lab-cluster-k3d-tmnl-f119

Conversation

@creatifcoding

@creatifcoding creatifcoding commented Aug 22, 2026 •

Copy link
Copy Markdown
Owner

Lift the mantis cluster roseleaf into @gbg/cluster. Mantis consumes and extends; it does not own the Alchemy composition root. k3d hosts applets. k3d-tmnl and tmnl.gbg.dev are names, not a claim that TMNL is the cluster.

@gbg/cluster (packages/cluster)

Lab Alchemy host plus the generalized Pepr CRD kit.

  • Kubernetes.providers() only. No AWS.providers(), EKS, GKE, AKS, or Cloudflare resources.
  • Kubernetes.KubeConfig({ context: "k3d-tmnl" }) with default kubeconfig resolution ($KUBECONFIG or ~/.kube/config). No host paths. Context string and API group tmnl.gbg.dev/v1alpha1 stay as names; this PR does not rename them.
  • Alchemy.localState() writes .alchemy/ in this package.
  • CRDs applied as Kubernetes.Manifest: LabImage, LabRegistry, LabWorkload, LabApplet.
  • Pattern: pepr-excellent-examples/pepr-operator. RegisterCRDs is an Apply helper, not a second Pepr module.
  • LabRegistry is in-cluster OCI only. Default image: ghcr.io/project-zot/zot-linux-amd64 (Zot). Never ECR/GCR/ACR.

No packages/k8s, no packages/lab-cluster, no second operator, no second flake. This PR does not invent packages/nexus.

@mantis/cluster

Consumes @gbg/cluster. Extends with:

  • Namespace procurement
  • LabApplet procurement in that namespace: five Start routes (/register, /buy, /receive, /need, /vendors), one shell, durable volume /data/pglite for the file-backed PGlite book. Image blank. Object only; not applied; not started. Mantis does not consume that volume.

No alchemy.run.ts. procurement/ is not in this PR. procurementbot owns that book.

Cosmo / NATS

Cosmo/WunderGraph home is @gbg/nexus (packages/nexus). Not tmnl. Not plexus. tmnl consumes nexus. This PR does not copy Cosmo Pepr/CRD sources out of tmnl. Catalog stays Postgres off-cluster; no catalog pod.

One NATS: Cosmo router EDFS and @tmnl/msh share the existing helm NATS at packages/tmnl/nix/modules/nats/values.yaml. No second NATS.

Cluster create stays the existing helper (k8s-cluster-create in packages/tmnl/nix/modules/k8s.nix). That is a helper path, not Cosmo's home.

CI

.github/workflows/mantis-cluster-ci.yml runs on pull_request (no master-only gate) for packages/cluster/** and projects/biomemetics/labs/mantis/cluster/**. Per package: npm install, typecheck, test. No deploy, no alchemy apply.

Checks

From packages/cluster:

npm install
npm test
npm run typecheck

From projects/biomemetics/labs/mantis/cluster:

npm install
npm test
npm run typecheck

Hold alchemy deploy. Hold merge.

Open in Web Open in Cursor 

@creatifcoding
creatifcoding marked this pull request as draft August 22, 2026 02:30
Land Kubernetes.KubeConfig({ context: "k3d-tmnl" }) under
projects/biomemetics/labs/mantis/cluster as @tmnl/mantis-cluster.
Not a packages/* @GBG project. State is Alchemy.localState() in the
roseleaf. No deploy.

Co-authored-by: digicoder <creatifcoding@users.noreply.github.com>
@cursor
cursor Bot force-pushed the cursor/lab-cluster-k3d-tmnl-f119 branch from 1990e0a to 9663616 Compare August 22, 2026 02:35
@cursor cursor Bot changed the title feat(lab-cluster): Alchemy v2 stack targeting k3d-tmnl feat(biomemetics): Alchemy v2 stack as mantis cluster roseleaf Aug 22, 2026
@cursor
cursor Bot changed the base branch from master to feat/mantis-biomemetics-lab August 22, 2026 02:35
cursoragent and others added 2 commits August 22, 2026 02:40
Rename to @mantis/cluster, switch to npm/vitest like PR 108's
procurement tree, and drop the parent-lab gitignore hook. Stack still
targets k3d-tmnl. procurement/ is untouched.

Co-authored-by: digicoder <creatifcoding@users.noreply.github.com>
Move the one Alchemy v2 stack and the generalized Pepr lab CRDs
(LabImage, LabRegistry, LabWorkload, LabApplet on tmnl.gbg.dev/v1alpha1)
into packages/cluster. Mantis consumes @gbg/cluster and extends with
Manifests; it no longer owns alchemy.run.ts.

Co-authored-by: digicoder <creatifcoding@users.noreply.github.com>
@cursor cursor Bot changed the title feat(biomemetics): Alchemy v2 stack as mantis cluster roseleaf feat(cluster): lift k3d-tmnl Alchemy stack into @gbg/cluster Aug 22, 2026
cursoragent and others added 3 commits August 27, 2026 02:55
Amend leftover Cosmo-in-tmnl text: Cosmo/WunderGraph home is @gbg/nexus.
Add pull_request CI for @gbg/cluster and @mantis/cluster (no deploy).
Export an unapplied procurement LabApplet object next to the Namespace.

Co-authored-by: digicoder <creatifcoding@users.noreply.github.com>
Frame @gbg/cluster as the gbg/lab host. k3d stays the runtime; k3d-tmnl
and tmnl.gbg.dev stay as coordinates. Cosmo home is @gbg/nexus; one NATS
is the existing helm chart. LabApplet object lists the five Start routes
and a PGlite volume. Not applied.

Co-authored-by: digicoder <creatifcoding@users.noreply.github.com>
Peel leftover TMNL-as-the-cluster copy. k3d-tmnl and tmnl.gbg.dev stay as
names. Cosmo/WunderGraph home stays @gbg/nexus.

Co-authored-by: digicoder <creatifcoding@users.noreply.github.com>
@creatifcoding
creatifcoding marked this pull request as ready for review August 30, 2026 01:56
@creatifcoding
creatifcoding merged commit a2efd4c into feat/mantis-biomemetics-lab Aug 30, 2026
2 checks passed
@creatifcoding
creatifcoding deleted the cursor/lab-cluster-k3d-tmnl-f119 branch August 30, 2026 01:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants