admin
hub_clone
Clone a dataset from a hub into a new local database.
strata clonewire hub_clone
Clones a dataset from a hub into a new local database directory. Resolution, download, verification, reconstitution, and origin recording run once behind this command; the session database is not touched. The destination directory must not exist or must be empty. When the hub URL is not given, the layered resolver selects it from the flag, environment, and config layers.
Status commands return a scalar or compact status payload and do not mutate database state.
To see the complete help for this command, run:
strata clone --help
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| dataset | string | yes | Dataset to clone. |
| dest | string | yes | Destination directory (must not exist, or be empty). |
| branch | string or null | no | Branch to fetch. Defaults to the dataset's default branch. |
| hub_url | string or null | no | Explicit hub URL; when absent the 5-layer resolver runs (flag, `STRATA_HUB_URL`, project config, global config). |
Returns
StatusResponse<HubClone>
- dataobject
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| invalid_argument.executor.hub_dataset | never | not_started |
| invalid_argument.executor.hub_branch | never | not_started |
| unsupported.executor.hub_feature_disabled | after_state_change | not_started |
| invalid_argument.executor.hub_url | never | not_started |
| failed_precondition.executor.hub_clone | never | not_started |
| unavailable.executor.hub_transport | same_request | not_started |