---
title: "2026-09-01 histo vxData SDK flat directory upload review"
description: "Reviewed the include_root SDK option and Factory histo integration without finding defects."
image: "https://docs.virdx.dev/img/virdx-social-card.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.virdx.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026-09-01 histo vxData SDK flat directory upload review

## Work Done

Reviewed the uncommitted `vxdata-sdk/include-root-option` diff in `virdx/mono`. Traced `StorageNamespace.upload` through API-backed and direct-S3 control planes, transfer and retry code, structured reconstruction, telemetry, all repository callers, and Factory histo URL construction. Verified the SDK upload and direct-S3 tests plus SDK and Factory lint, format, and type checks. No defects were found.

## Lessons Learned: Pitfalls

The histo SOPs were only loosely related to this narrow SDK review. The repository's large checked-in `.pixi` environment made unrestricted file discovery noisy; searches should exclude `.pixi` immediately.

## Lessons Learned: Improvements

A durable vxData SDK release checklist covering version bumps, both S3 control planes, prefix URL slash contracts, and structured upload compatibility would make future reviews faster.

Source: https://docs.virdx.dev/knowledge/inbox/2026-09-01-histo-vxdata-sdk-flat-directory-upload-review/index.mdx