Startup Template commands: extend, promote, upgrade
The Startup Template Verbs extend, promote, upgrade as CLI commands, with inputs, result, refusals and an example.
Reference for Startup Template, one group of Startup Template commands.
StartupTemplate.extend
Extend adds a Startup Template to a Startup’s bases, pinned to a Version, so the Startup inherits its definition. Verb page.
npx startup-builder do StartupTemplate.extend --json '<input>' [--try | --send | --do]Emits StartupTemplate.extended.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
startupTemplate | Startup Template | required | The Startup Template to inherit. |
startup | Startup | required | The Startup that extends it. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
startup | Startup | required | The Startup, with the Startup Template among its bases. |
startupTemplate | Startup Template | required | The Startup Template extended. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
| A clash between two bases until the Startup settles it | refused | Clear what the check names, then call it again. | None. |
Example
npx startup-builder do StartupTemplate.extend --json '{"startupTemplate":StartupTemplate.promote
Promote moves one Startup’s refinement into a Startup Template, so every Startup that extends it inherits the refinement. Verb page.
npx startup-builder do StartupTemplate.promote --json '<input>' [--try | --send | --do]Emits StartupTemplate.promoted.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
startupTemplate | Startup Template | required | The Startup Template that receives the refinement. |
startup | Startup | required | The Startup that holds the refinement. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
change | Change | required | The Change against the Startup Template. |
startupTemplate | Startup Template | required | The Startup Template that received the refinement. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
npx startup-builder do StartupTemplate.promote --json '{"startupTemplate":StartupTemplate.upgrade
Upgrade moves a Startup to a newer Version of a Startup Template it extends, through a Change it can review. Verb page.
npx startup-builder do StartupTemplate.upgrade --json '<input>' [--try | --send | --do]Emits StartupTemplate.upgraded.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
startupTemplate | Startup Template | required | The Startup Template to upgrade. |
startup | Startup | required | The Startup that extends it. |
version | Version | The target Version; the latest when absent. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
change | Change | required | The Change that moves the pin, with its three-way diff. |
startupTemplate | Startup Template | required | The Startup Template upgraded to. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
npx startup-builder do StartupTemplate.upgrade --json '{"startupTemplate":