Developer platform

Build against one cloud contract.

Aarulya products integrate through versioned APIs, CLI and SDK contracts rather than vendor-specific infrastructure assumptions.

Hierarchy

Owner → Organization → Project → Service → Resource. Project is the primary isolation boundary for quota, IAM, usage and resources.

Desired state

Resources declare desired state. Reconcilers and runtime controllers perform deterministic plans, verification and recovery.

Authority

Owner capabilities use exact scopes. Public documentation never grants or exposes Owner Console authority.

Core API surfaces

These are current source-level cloud endpoints used by governed clients and the private Owner Console.

GET  /health/live
GET  /health/ready
GET  /v1/cloud/projects
GET  /v1/cloud/resources
POST /v1/cloud/resources
GET  /v1/cloud/projects/:projectId/quota
POST /v1/cloud/projects/:projectId/quota
GET  /v1/cloud/projects/:projectId/usage
GET  /v1/cloud/projects/:projectId/iam
POST /v1/cloud/projects/:projectId/iam
POST /v1/cloud/resources/:resourceId/desired-state

Private Owner UI development

The dependency-free Owner UI server uses a same-origin /api gateway; the configured private upstream remains server-side. This development command is not a public Console link or a production exposure instruction.

cd platform/aarulya-cloud
AARULYA_CLOUD_API_BASE=http://127.0.0.1:9080 \
AARULYA_CLOUD_UI_SURFACE=OWNER_PRIVATE \
node scripts/start-cloud-ui.mjs

# Default UI bind: http://127.0.0.1:8788
# Browser API path: /api
# Private upstream is not exposed in /ui-config.json.
# Owner capability stays in page memory only.