syntax revamp

docs/ftp_plugin_tutorial.md

@@ -21,7 +21,7 @@ storage-style integration:
 - `selector()` turns folder rows into a follow-up table when the user runs `@N`.
 - `download()` and `download_url()` fetch FTP files into `download-file` output paths.
 - `resolve_pipe_result_download()` lets `@N | add-file -instance ...` materialize a remote FTP file first.
-- `upload()` lets `add-file -plugin ftp -instance <name> -path ...` push a local file to the configured FTP server.
+- `upload()` lets `add-file <local-file> -plugin ftp -instance <name>` push a local file to the configured FTP server.
 
 ## Example config
 
@@ -112,7 +112,7 @@ Why this works:
 Uploading uses the same plugin, through `add-file -plugin ftp -instance <name>`:
 
 ```powershell
-add-file -plugin ftp -instance archive -path C:\Media\report.pdf
+add-file C:\Media\report.pdf -plugin ftp -instance archive
 ```
 
 That sends the file to the selected instance's FTP `base_path` and returns the
@@ -148,5 +148,5 @@ search-file -plugin ftp -instance work "path:/incoming depth:2 *.pdf"
 @1
 @1 | download-file -path C:\Downloads
 @1 | add-file -instance tutorial
-add-file -plugin ftp -instance archive -path C:\Media\report.pdf
+add-file C:\Media\report.pdf -plugin ftp -instance archive
 ```

docs/scp_plugin_tutorial.md

@@ -15,7 +15,7 @@ The SCP plugin mirrors the FTP walkthrough, but on top of SSH:
 - plain `@N` on a folder drills into that directory
 - plain `@N` on a file runs `download-file -plugin scp -instance <name> -url ...`
 - `@N | add-file -instance ...` downloads first, then ingests the local temp file
-- `add-file -plugin scp -instance <name> -path ...` uploads a local file to the configured remote path
+- `add-file <local-file> -plugin scp -instance <name>` uploads a local file to the configured remote path
 
 ## Example config
 
@@ -102,7 +102,7 @@ Why this works:
 ## Upload flow
 
 ```powershell
-add-file -plugin scp -instance archive -path C:\Media\report.pdf
+add-file C:\Media\report.pdf -plugin scp -instance archive
 ```
 
 ## Implementation notes
@@ -120,5 +120,5 @@ search-file -plugin scp -instance work "path:/srv/files depth:2 *.zip"
 @1
 @1 | download-file -path C:\Downloads
 @1 | add-file -instance tutorial
-add-file -plugin scp -instance archive -path C:\Media\report.pdf
+add-file C:\Media\report.pdf -plugin scp -instance archive
 ```