@oddington/cli 0.1.29 → 0.1.30

package/README.md

@@ -471,7 +471,26 @@ is required unless an authored item declares executable handlers. JSON input
 is validated before business work; its file/stdin path is transport, not input.
 Omitted input is `{}`. Each JSON value is bounded to 256 KiB.
 
-Before execution, the command names installed connections and explains that
+To execute the active deployed version on OS, use:
+
+```sh
+os routine run invoice-import --remote --input input.json
+os routine run invoice-import --remote --input - --json
+os routine cancel <run> --json
+```
+
+Remote start reads only worktree identity and business input. It neither uploads
+local source nor creates a local captured change set. It reports the accepted
+Run's `id`, `state` and inspection URL, then returns; disconnecting does not cancel
+the Run. OS-owned changes apply during execution and need no publish command.
+Uncertain acknowledgements retry the same start key and input. If recovery is
+still unavailable, output retains `startKey` and warns that OS may have accepted
+the action; repeating the command deliberately requests another Run. Cancellation
+resolves the Run through current workspace membership, works outside a checkout,
+and reports the recorded state while OS stops execution. Neither command accepts
+workspace, version, command, environment or authority overrides.
+
+Before local execution, the command names installed connections and explains that
 local filesystem changes, model calls and provider effects happen immediately.
 Only Record, File, Ask and Digest changes stay local for review. The child
 receives temporary installed authority, which is revoked when execution ends.