@iteraitive/platform-cli
v0.7.1
Published
Contextua-wired platform-operator CLI for scaffolding and maintaining first-party platform service code repositories. v0.7.1 fixes the hardcoded runtime version string missed in the 0.7.0 bundle (0.7.0 reported itself as 0.6.0). v0.7.0 added `platform-cli
Downloads
844
Maintainers
Readme
@iteraitive/platform-cli
Contextua platform-operator CLI for scaffolding and managing first-party platform service code repositories.
npm install -g @iteraitive/platform-cli
platform-cli --helpv0.1.0 bootstrap slice
Contextua is pre-launch. WorkOS tenants, App Registry, and the platform auth service don't exist yet — platform-cli itself scaffolds the auth service. v0.1.0 therefore works without any authentication or network code. See the monorepo README for the full v0.1.0 scope, DoD, and v0.2.0+ roadmap.
Verbs shipped in v0.1.0
Three verbs are real; seven are stubs that declare the full ADR 0118 §4.3 flag surface but exit 1 with a roadmap message pointing at the kickoff plan.
Real
platform-cli list [--workspace-root <path>] [--format text|json]— enumerates platform-product SDDs under one or more workspace roots.platform-cli add --archetype <name> --domain <d> --service <s> [--workspace-root <path>] [--description <text>] [--allow-existing]— scaffolds a platform service code repo as a sibling of the SDD and writes a schema-validorchestration/repo-config/{domain}/{service}.yamlentry back. Five archetypes:api-gateway,worker,bff,frontend,cron.platform-cli validate [--service <name>] [--workspace-root <path>]— local-only schema + archetype-metadata checks. Stability-class + pre-deploy validation land in v0.2.0 withdeploy.
Stubs
login, deploy, dev, upgrade, contracts, artifacts, catalog. Each one's flag surface is declared at the Commander level so --help shows the full framework shape; the action body prints a structured v0.1.0 roadmap message and exits 1.
Bootstrap self-verification
# 1. Clone the platform SDD (isolated working copy so the real repo stays clean)
git clone --depth 1 https://github.com/contextua-dev/contextua-platform /tmp/ctxp-bootstrap
# 2. Scaffold the auth service
platform-cli add \
--archetype api-gateway \
--domain identity \
--service identity-auth \
--workspace-root /tmp/ctxp-bootstrap
# 3. Validate
platform-cli validate --workspace-root /tmp/ctxp-bootstrap --service identity-authThis is the load-bearing DoD proof for v0.1.0 — the tool scaffolds the service it will eventually authenticate against.
