synapse-upload-workflowlisted

# Synapse Upload Workflow Core knowledge for uploading files to Synapse data collections. Covers local and cloud sources, single-path and multi-path modes, and Excel metadata integration. ## Interactive-First Principle This workflow is designed to be **fully interactive**. When the user invokes the upload with missing parameters (or no parameters at all), use `AskUserQuestion` to guide them through each step. Never fail or show usage text for missing arguments — always ask conversationally. Offer to list data collections from the API and show the default storage if the user doesn't know the IDs. Validate each input immediately and re-ask if invalid. ## Prerequisites Validation Before starting any upload workflow, ensure the `synapse` CLI is available and validate the environment. ### Finding synapse CLI ```bash # 1. Try the current shell first (venv may already be activated) synapse --version # 2. If not found, search for a venv directory in cwd ls -d *venv* .venv 2>/dev/null # Activate the first match, e.g.: source .venv/bin/activate ``` If no venv is found and `synapse` is not on PATH, guide the user to activate their environment or install: `uv pip install "synapse-sdk>=2026.1.39"` ### Assert version ```bash python3 -c " from importlib.metadata import version v = version('synapse-sdk') parts = [int(x) for x in v.split('.')[:3]] assert parts >= [2026, 1, 39], f'synapse-sdk {v} is too old, need >= 2026.1.39' print(f'synapse-sdk {v} OK') " ``` ### Validate environ