Skip to content

Deal commands: propose, win

The Deal Verbs propose, win as CLI commands, with inputs, result, refusals and an example.

Reference for Deal, one group of Deal commands.

Deal.propose

Propose sends a Deal’s buyer a Quote they accept to place an Order. Verb page.

Text
npx startup-builder do Deal.propose --json '<input>' [--try | --send | --do]

Emits Deal.proposed.

Inputs

InputTypeRequiredDescription
dealDealrequiredThe qualified Deal.
quoteQuoterequiredThe Quote to send.

Returns

OutputTypeRequiredDescription
dealDealrequiredThe Deal with its Quote out.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.
The record is not in a state that allows this Verb, so the call is refused.refusedRead the record, run the Verb that moves it to an allowed state, then retry.None.

Example

Terminal
npx startup-builder do Deal.propose --json '{"deal":"deal_NgACZ6DcII","quote":"qt_GZnH5OK100"}'

Deal.win

Win closes a Deal as won, which places its Order and makes the buyer a Customer. Verb page.

Text
npx startup-builder do Deal.win --json '<input>' [--try | --send | --do]

Emits Deal.won.

Inputs

InputTypeRequiredDescription
dealDealrequiredThe proposed Deal.

Returns

OutputTypeRequiredDescription
orderOrderrequiredThe placed Order.
dealDealrequiredThe Deal, now won.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.
The record is not in a state that allows this Verb, so the call is refused.refusedRead the record, run the Verb that moves it to an allowed state, then retry.None.

Example

Terminal
npx startup-builder do Deal.win --json '{"deal":"deal_NgACZ6DcII"}'