Description
Marketplace Management gives buyers and publishers a complete terminal workflow around discoverable Dots extensions and templates. dots marketplace maintains Marketplace-specific authentication, searches and reads listing metadata, installs and updates purchased products, lists purchases, and submits validated local listing records for publication.
The workflow is designed for operators and coding agents. It uses the same authenticated, company-scoped service contracts as the rest of Dots, so terminal or protocol convenience never creates a second source of truth. Inputs are validated before or at the route boundary, and outputs preserve identifiers and structured details needed for a reliable next step.
Selling Points
- Makes extension discovery and installation available to headless and scripted environments.
- Separates Marketplace identity from workspace API credentials where the trust domains differ.
- Lets publishers submit artifacts produced by the plugin workflow without manual payload construction.
- Provides purchase and update visibility for operational inventory.
- Keeps search, inspection, and install as explicit reviewable steps.
User Story
A buyer signs into the Marketplace, searches for a Dotabase template, inspects its metadata, installs it, and later checks for an update. A publisher can use the same CLI family to submit a validated listing generated by dots plugin publish. The result is a concrete, inspectable outcome that another person or automation can continue from without reconstructing hidden state.
Extension Surface
The surface is automatable: packages/cli/src/commands/marketplace.ts binds a closed buyer/publisher command set. Listings are pluggable products, but the Marketplace CLI does not accept third-party command registration. The rating reflects the most-open supported seam that is true for this capability, not a transitive implementation detail. The cited path is the operational proof: consumers can use the documented seam, while unsupported changes still require a core release.
Capabilities & Limits
- Capability: Marketplace login, logout, identity, search, and listing detail.
- Capability: Install, update, purchase inventory, and publication submission.
- Capability: Integration with plugin-produced template and SDK-plugin listing records.
- Limit: Publication remains subject to Marketplace validation and human review; a locally built artifact is not automatically approved or purchasable.
The limit is intentional product truth rather than missing documentation. Calls also remain subject to authentication, tenant selection, schema validation, and the permissions enforced by the authoritative service.
Implementation Map
packages/cli/src/commands/marketplace.tspackages/cli/src/commands/marketplace-client.tspackages/cli/src/commands/plugin.ts