Growth Nirvana Dataset Bundle Export
Purpose
Run the dataset bundle export end-to-end and return a consistent, auditable summary.
Required Workflow
- Resolve the target dataset with
search_datasets(prefer exactdisplayNamematch when multiple results exist). - Start an export with
create_dataset_bundle_exportusing:account_id: selfdataset_id- a unique
idempotency_key
- Poll with
get_dataset_bundle_exportuntilterminal: true. - If
status: success, capture:bundle_export_idjobIdfileNamebyteSizechecksumSha256downloadUrldownloadUrlExpiresAtstoragePath
- Download the zip into:
downloads/growth-nirvana/exports/<dataset_id>/<fileName>
- Verify checksum against
checksumSha256. - Extract into:
downloads/growth-nirvana/exports/<dataset_id>/unzipped/
- Validate expected artifacts:
manifest.json*.sqlfiles*.yamlor*.ymlfiles
Failure Handling
- If export fails, report exact terminal payload fields:
statuserrorMessagebundle_export_idjobId
- If error contains
Account bucket is not configured, instruct user to configure account bucket storage, then reruncreate_dataset_bundle_export. - If
downloadUrlis expired, rerunget_dataset_bundle_exportto refresh URL or create a new export.
Response Contract
Always return:
- Dataset name/id
- Export id and job id
- Final status
- Zip path
- Unzip path
- Manifest path
- SQL file count
- YAML/YML file count
- Checksum match (
true/false) - Any warnings or remediation steps
Additional Resources
- Real trial payload and paths: reference.md