Skip to content
ocx
install

Command ↔ method map: Package tier

Part 2 of 3 of Command ↔ method map.

Consumer surface: installing and running packages from $OCX_HOME, no project path.

ocx command SDK method Tier
ocx package install package.install T1
ocx package select package.select T1
ocx package uninstall package.uninstall T1
ocx package deselect package.deselect T1
ocx package env package.env T1
ocx package exec package.exec / exec_async / spawn / spawn_async T1
ocx package which package.which † T1
ocx package inspect package.inspect T1
ocx package description pull package.description_pull T1
ocx package deps package.deps T1
ocx package pull package.pull T1
ocx package create package.create T1, author flow
ocx package receipt package.receipt T1, author flow — 79 (no receipt) reads as None
ocx package test --script package.test T1, author flow — stable v1 JSON, report-then-fail ‡
ocx package test -- CMD Ocx.invoke prints the child’s raw stdout even under --format json; never parsed here
ocx package push package.push T1, author flow
ocx package description push package.description_push T1, author flow
ocx package sign package.sign T1, author flow
ocx package verify package.verify T1
ocx package attest package.attest T1, author flow
ocx package sbom package.sbom T1
ocx package copy package.copy T1, author flow
ocx package announce package.announce T1, author flow — --yank, --unyank, --fork, --out stay invoke-only
ocx package claim package.claim T1, author flow
ocx package cascade check package.cascade_check T1, report-then-fail ‡
ocx package cascade repair package.cascade_repair T1, author flow — report-then-fail ‡

† package which’s JSON is doc-flagged “breaking, pre-1.0” — typed, but not on ocx’s durable-anchor list. EnvReport’s four non-entry arrays carry the same flag.

‡ Report-then-fail: ocx prints the report and exits non-zero when it has a finding (package test exits 1 on a failed assertion, cascade * exits 65 on a stale or missing tag). The SDK tolerates that exit and hands the report back as a result — TestResult.passed, CascadeCheckReport.clean — because the finding is the answer. Only a non-zero exit with no report (an error envelope or nothing parseable) raises. Guard: tolerated_report.

Continues on Command ↔ method map: Config tier.