@oddington/cli 0.1.43 → 0.1.44

package/README.md

@@ -22,6 +22,29 @@ Run `os --help` or add `--help` to any command for the full command list.
 Commands print readable output by default. Add `--json` when another program
 will consume the result.
 
+Dropbox setup uses an offline OAuth URL and hidden one-time code entry:
+
+```sh
+os connection create dropbox --workspace example --name os-files
+os connection create dropbox --workspace example --name business --access full-dropbox --root "/Business"
+os connection list --workspace example --all
+os connection inspect --workspace example --id <returned-id>
+os connection test --workspace example --connection dropbox/business
+```
+
+The default is App Folder, privately available to Files. Full Dropbox requires a
+separate saved connection, OAuth application and grant, plus an explicit existing
+folder; setup and testing only read provider state. Neither create command selects
+File storage. Full Dropbox cannot be a File store. Its declared root is the base
+path trusted routines must use, not provider-enforced token containment. Routine
+Dropbox calls change provider data immediately, independently of publication.
+Disconnect prevents new delivery but does not revoke an already delivered token.
+The operator must register and configure separate App Folder and Full Dropbox
+applications on the OS service. The application mode is that verified backend
+registration, never an inference from Dropbox account namespace metadata.
+Missing Full Dropbox setup refuses only that setup path; it does not disable App
+Folder authorization.
+
 Sign-in and session operations use `https://auth.oddington.ai`. Connection
 management, repository targets, local app repository context, Dropbox authorization,
 remote File-storage configuration and Routine deployment use `https://api.oddington.ai`. These addresses are fixed; workspace