Cozystack Platform

@magistr/cozystack-platformv2026.08.19.1· 3d agoMODELS

01README

Cozystack platform management — install operator, deploy packages, manage apps/tenants, bootstrap CNI, and verify platform health

02Models1

@magistr/cozystack-platformv2026.08.19.1extensions/models/cozystack.ts

fn getOperatorStatus()

Check if Cozystack operator deployment exists and its rollout status

fn getFluxTenantsStatus()

Check flux-tenants deployment state (hostNetwork, tolerations)

fn getNodePodCIDRs()

Get current PodCIDR assignments on all nodes

fn getPlatformPackage()

Check if Platform Package CR exists and its status

fn listAppDefinitions()

List available application definitions (what can be deployed)

fn listApps(namespace: string)

List application instances in a namespace (tenant)

Argument	Type	Required	Description
namespace	string	yes	Namespace (tenant) to list apps in

fn getApp(namespace: string, kind: string, name: string)

Get a specific application instance

Argument	Type	Required	Description
namespace	string	yes	Namespace (tenant)
kind	string	yes	App kind (e.g. postgres, kubernetes, redis)
name	string	yes	App instance name

fn createApp(namespace: string, kind: string, name: string)

Create a Cozystack application (Kubernetes cluster, database, VM, etc.)

Argument	Type	Required	Description
namespace	string	yes	Namespace (tenant) to deploy in
kind	string	yes	App kind (e.g. Postgres, Kubernetes, Redis, VirtualMachine)
name	string	yes	Name for the app instance

fn deleteApp(namespace: string, kind: string, name: string)

Delete a Cozystack application instance

Argument	Type	Required	Description
namespace	string	yes	Namespace (tenant)
kind	string	yes	App kind (e.g. postgres, kubernetes)
name	string	yes	App instance name

fn listTenants()

List Cozystack tenants

fn createTenant(name: string)

Create a new Cozystack tenant

Argument	Type	Required	Description
name	string	yes	Tenant name

fn listPackages()

List installed Cozystack platform packages

fn listWorkloads()

List workloads and their resource usage across namespaces

fn getAppSecret(namespace: string, name: string)

Get credentials/secrets for an application (e.g. database passwords)

Argument	Type	Required	Description
namespace	string	yes	Namespace (tenant)
name	string	yes	Secret name (usually matches app name)

fn getTenantKubeconfig()

Get kubeconfig for a tenant (to access the tenant's Kubernetes API)

fn updateApp(namespace: string, kind: string, name: string)

Update an existing Cozystack application spec

Argument	Type	Required	Description
namespace	string	yes	Namespace (tenant)
kind	string	yes	App kind (e.g. postgres, kubernetes)
name	string	yes	App instance name

fn install()

Install Cozystack operator via Helm and apply platform ConfigMap (idempotent)

fn waitReady()

Wait for Cozystack operator deployment to be ready

fn applyPackage(host: string, podCIDR: string, podGateway: string, serviceCIDR: string, joinCIDR: string)

Create or update the Platform Package CR that triggers full platform deployment

Argument	Type	Required	Description
host	string	yes	Root host domain (e.g. cluster.example)
podCIDR	string	yes	Pod CIDR
podGateway	string	yes	Pod gateway
serviceCIDR	string	yes	Service CIDR
joinCIDR	string	yes	Join CIDR

fn patchFluxTenants()

Patch flux-tenants deployment with hostNetwork and tolerations for bootstrap (needed before CNI is ready)

fn assignPodCIDRs()

Assign PodCIDRs to nodes (needed for Cilium IPAM=kubernetes when allocate-node-cidrs=false)

fn listHelmReleases(readyOnly: boolean, notReadyOnly: boolean)

List HelmRelease status across all namespaces

Argument	Type	Required	Description
readyOnly	boolean	yes	Only show ready releases
notReadyOnly	boolean	yes	Only show not-ready releases

fn configurePlatform()

Idempotent platform configuration (enable ingress, monitoring, etcd on root tenant)

Resources

appDef(infinite)— Cozystack application definition

app(infinite)— Cozystack application instance

workload(infinite)— Cozystack workload status

package(infinite)— Cozystack platform package

tenant(infinite)— Cozystack tenant

result(infinite)— Operation result

secret(infinite)— Application secret (credentials)

03Previous Versions3

2026.07.16.2Jul 16, 2026

Release 2026.07.16.2 — align model versions with manifests

Maintenance release across the @magistr extensions. For most packages this carries no functional change: the only edit is the model's version: field, brought back in line with its manifest version so the published model type version and the package version no longer drift.

Functional changes in this release are limited to:

anime-cron: normalizeTitle now strips a ": subtitle" suffix and a trailing parenthesized year before comparison, fixing dedup false-misses where the torrent title carries a subtitle or year that the AniList romaji does not.
arckit: first publish. Standalone ArcKit port — a 12-phase architecture governance state machine with 65 bundled templates, driven by a bundled skill.

Also tracks three extensions (kaiten, observability-agent, music-library) that previously existed only as untracked working-tree directories, recovered from stashes.

Added 1, removed 1 models

2026.05.25.1May 25, 2026

Merge pull request #4 from umag/extensions/magistr-grade-a-workspace

extensions: stage 15 @magistr extensions as Grade A workspace dirs + wire CI

2026.03.13.1Mar 13, 2026

04Stats

100 / 100

Downloads

Archive size

22.1 KB

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://github.com/umag/swamp-workspace

05Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

06Labels

#cozystack #kubernetes #infrastructure #platform